レコードを検索

UiPath.SuccessFactors.Activities.SuccessFactorsSearchRecordsActivity

[ レコードを検索] アクティビティは、 SAP SuccessFactors OData API を使用して、設定した OData クエリ パラメーターに基づいて一連のレコードを取得します。

レコードを取得した後、アクティビティはクエリの結果を DataTable 型オブジェクト ([結果]) に、要求のステータス (成功/失敗情報) を ResponseStatus オブジェクト ([応答ステータス]) に出力します。 どちらの出力も、後続のアクティビティ (条件付きロジックなど) の入力変数として使用できます。

動作のしくみ

以下の手順は、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [ SuccessFactors スコープ] アクティビティを追加します。
3. [ SuccessFactors スコープ] アクティビティ内に [ レコードを検索 ] アクティビティを追加します。
4. [ レコードを検索 ] アクティビティの [ 設定 ] ボタンをクリックします ( オブジェクト ウィザードが開きます)。
5. 取得する オブジェクト を選択し、[ 入力] セクションのプロパティ値を入力します。
6. DataTable、および [出力] セクションのプロパティの ResponseStatus 型変数を作成し、入力します。
   • 入力したプロパティ値は、SAP SuccessFactors OData API に渡されます。
   • API は、出力プロパティ変数に DataTable と ResponseStatus の値を返します。

アクティビティの本体

[レコードを検索] の プロパティ値を入力したり [クエリ] の 入力値をテストしたりするには、[ 設定 ] ボタンをクリックして オブジェクト ウィザード を使用します。

オブジェクト ウィザードの詳細については、「 ビジネス アクティビティのフレームワーク 」のページをご覧ください。

• オブジェクト - 取得する SuccessFactors オブジェクトの型です。 オブジェクト ウィザード を使用してオブジェクトを選択するか、有効な String または String 変数を入力します。 オブジェクト ウィザード を使用してオブジェクトを選択している場合は、選択内容を変更するときにもオブジェクト ウィザードを使用する必要があります。オブジェクト ウィザードを使用せずに変更した場合、アクティビティの実行は失敗として処理されます。
• 上限 数 - 返される項目の最大数です。 Int32 または Int32 型変数を入力します。
• スキップ - スキップ する項目の数です。 Int32 または Int32 型変数を入力します。
• 検索 - クエリ パラメーターです。 String または String 型変数を入力します。 [検索 ] パラメーター の詳細については、「 検索レコードを使用 する」をご覧ください。
• フィルター - 使用するフィルターです。 String または String 型変数を入力します。 Filter パラメーターの高度な使用に関する詳細は、「 レコードを検索を使用 する」をご覧ください。
• 追加のクエリ パラメーター - その他の oData クエリ パラメーターです。 String または String 型変数を入力します (例:sysparm_limit=5 または優先度 2)。

プロパティ

共通

• 表示名 - アクティビティの表示名です。 このフィールドでは Strings 型または String 型変数のみがサポートされます。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

出力

• 応答ステータス - 要求のステータスです (成功/失敗に関する情報)。 ResponseStatus 型変数を入力します (UiPath.BAF.Models.ResponseStatus)。 ResponseStatus オブジェクトには、他のアクティビティで使用できる 3 つのプロパティが含まれています。
  • Success - Boolean - API 要求が成功したかどうかを示します。
  • ErrorCode - String - API 要求が成功しなかった場合の応答エラーです (Success=False)。
  • Message - String - エラー メッセージです。
• 結果 - クエリの結果です。 DataTable 型変数を入力します。