kintoneSubtableGet - kintoneのサブテーブルからの入力
kintoneからサブテーブルのレコードを取得します。kintoneビルダーを使って、kintoneのアプリ一覧やフィールド定義を取得します。詳細については下記トピック「kintoneビルダーの使い方」を参照してください。
■ストリーム情報
| 入力 | フォーマット | すべて |
|---|---|---|
| 接続数 | 無制限 | |
| 説明 | 入力ストリームは使用せず、すべて無視します。 | |
| 出力 | フォーマット | Record |
| 説明 | 指定したサブテーブルから取得したレコードを、出力ストリームのフィールド定義に従ってレコード形式で出力します。 |
■コンポーネントプロパティ
| 名前 | プロパティ型 | マッピング | 説明 | ||||||
|---|---|---|---|---|---|---|---|---|---|
| コネクション名 | connection | - | 接続先のkintoneを指定します。コネクションペインまたは管理コンソールにて作成されたkintone接続名を選択します。 | ||||||
| アプリID | int | 入力＆出力 | アプリIDを指定します。 | ||||||
| レコード番号 | string | 入力＆出力 |
取得するサブテーブルの親のレコードのレコード番号を指定します。 レコード番号はkintoneGetコンポーネントで取得することができます。 |
||||||
| サブテーブル名 | string | 出力 | サブテーブル名を指定します。 | ||||||
| ループを開始 | loopProcess | - |
|
||||||
| レコードが無い場合エラー | boolean | - |
結果のレコード件数が0件だった場合にエラーを発生させるかどうかを選択します。
|
■ループ処理
ループを開始が「はい」の場合、 このコンポーネントがループの起点となって結果セットのレコードを1レコードずつ出力します。
■トランザクション処理
| コミット | 何もしません。 |
|---|---|
| ロールバック | 何もしません。 |
■エラー処理
| タイプ | パラ メータ | エラー処理フロー へのストリーム | エラー コード | 説明 |
|---|---|---|---|---|
| 汎用 | なし | コンポーネントの入力ストリーム | 1 | 不正なレコード番号が指定された場合。 |
| 2 | 親レコードが見つからなかった場合。 | |||
| 3 | フィールドの値の型変換に失敗した場合。 | |||
| レコードが無い | なし | コンポーネントの入力ストリーム | 4 | レコードが0件の場合。 |
| APIエラー | なし | コンポーネントの入力ストリーム | 201 | APIの実行でエラーコードを受け取った場合。 |
■kintoneビルダーの使い方
kintoneビルダーは、プロパティとストリームを設定するための専用ツールです。kintoneビルダーを使うと、簡単な操作で以下のようなことができます。
- kintoneコネクションの作成、編集
- kintoneから取得したアプリ一覧から読み込むアプリ、サブテーブル、フィールドを指定
●kintoneビルダーを起動する
以下のいずれかの操作でkintoneビルダーを起動します。
- kintoneSubtableGetコンポーネントをダブルクリック
- kintoneSubtableGetコンポーネントを右クリックして表示されるメニューから「kintoneビルダー」をクリック
●kintoneビルダーの画面
- (1)画面上部：接続先を表示する領域
- (2)画面左：アプリ一覧を表示する領域
- (3)画面中央：サブテーブル一覧を表示する領域
- (4)画面右：サブテーブルのフィールド一覧を表示する領域
●コネクションを作成する
(1)の接続先プルダウンリストから「新規kintoneコネクション」を選択します。 「新規コネクション作成」ダイアログが表示されるので、接続先の情報を入力して「保存」をクリックします。
●コネクションを編集する
(1)の接続先プルダウンリストから編集するコネクションを選択して、「編集」をクリックします。 コネクションダイアログが表示されるので、編集を行い「保存」をクリックします。
●コネクションを指定する
(1)の接続先プルダウンリストから使用するコネクションを選択します。(2)に指定した接続先のアプリの一覧が表示されます。
●読み込むサブテーブルのフィールドを指定する
(2)のアプリ一覧からアプリを選択すると(3)に選択したアプリのサブテーブル一覧が表示されます。 (3)のサブテーブル一覧からサブテーブルを選択すると(4)に選択したサブテーブルのフィールド一覧が表示されます。 フィールド一覧でフィールド名の左にあるチェックボックスをオンにします。指定したフィールドを取り消すには、チェックボックスをオフにします。