「すべてのオブジェクトを取得」アクティビティーを使用して、Insightly からオブジェクトの詳細をフェッチします。
このタスクについて
Insightly インスタンスですべてのオブジェクト詳細を取得するには、このタスクを使用します。このアクティビティーの呼び出しは、同期呼び出しです。同期呼び出しでは、入力データが処理のためにアクティビティーに送信され、オーケストレーションに応答が返信されます。
手順
- 「オーケストレーション」セクションを右クリックし、新規オーケストレーションを選択します。
- 新しく作成した Insightly エンドポイントをオーケストレーションにドラッグし、「すべてのオブジェクトを取得」アクティビティーを選択します。 「すべてのオブジェクトを取得」アクティビティーがオーケストレーションに追加されます。
アクティビティーを選択します。 Insightly すべてのオブジェクトを取得「チェックリスト」が表示されます。
- 「チェックリスト」で、「構成」をクリックします。
- 「参照」をクリックして、オブジェクト・タイプを選択します。 「Insightly の表示」ウィンドウが表示されます。
- 「Insightly の表示」では、オブジェクト・タイプ・リストからオブジェクト・タイプを選択できます。「OK」をクリックします。
- 「チェックリスト」から「入力のマップ」を選択します。
「すべてのオブジェクトを取得」アクティビティーの選択したオブジェクトから生成された XML スキーマが、「アクティビティーへ」パネルの request 入力パラメーターの下にノードとして表示されます。
- 「チェックリスト」で「再試行」をクリックします。 デフォルト設定を確認して、必要な変更を行います。
- オーケストレーション変数とアクティビティーの入力パラメーターとの間のマップを作成します。
注: 入力構造の必須エレメントの値は、実行時に指定されている必要があります。 この値は、エレメントのデフォルト値を指定するか、エレメントを入力ノードにリンクすることによって指定できます。 実行時に必須エレメントの値が指定されていないと、アクティビティーは Web 管理コンソールから報告された例外をスローします。 実行時にオプションの入力パラメーターの値が指定されていなくても、実行時に例外はスローされません。
- 「チェックリスト」から「出力のマップ」を選択します。
アクティビティーの応答保持のために生成された XML スキーマが、「アクティビティーから」パネルの response 出力パラメーターの下にノードとして表示されます。
- 出力パラメーターとオーケストレーション変数との間のマップを作成します。
照会パラメーター
「すべてのオブジェクトを取得」の照会パラメーターを以下に示します。
表 1. すべての「すべてのオブジェクトを取得」の一般的な照会パラメーターフィールド名 |
説明 |
top (n) |
上位 n 個のレコードのみをフェッチします。 |
skip (n) |
最初の n 個のレコードをスキップし、残りのレコードをフェッチします。 |
filter |
パラメーター (field_name、operator、および value) に基づいて特定のレコード (複数可) をフェッチします。 |
field_name |
フィルタリングに使用される標準のフィールド名を指定します。 |
operator |
適用する演算子。(例えば、有効な演算子には eq、ne、gt、lt などがあります。) |
value |
フィールドの値。この値に基づいて、結果が表示されます。 |
orderby |
フィールド名と順序を定義することで、応答を昇順または降順で表示できます。 |
field_name |
フィールドを順番に表示するために使用される標準のフィールド名。 |
order |
順序は、ASC または DESC です。 |
タスクの結果
Insightly「すべてのオブジェクトを取得」アクティビティーを構成しました。
注: このアクティビティーへの入力として、複数のオブジェクトを追加することができます。 入力として複数のオブジェクトを追加するには、「入力のマップ」の「アクティビティーへ」ペインでオブジェクトを右クリックし、「オカレンスの展開」を選択します。