プロセス インスタンスを取得

UiPath.Oracle.IntegrationCloud.Process.Activities.GetProcessInstancesActivity

[プロセス インスタンスを取得] アクティビティは、Oracle Integration の Retrieve Process Instance List API を使用して、指定したフィルター パラメーター ([割り当てフィルター]、[設定後]、[優先度]、[プロセス名]、[更新後]) に一致するすべてのプロセスを取得します。

取得操作が完了すると、アクティビティは該当するプロセスを DataTable オブジェクト ([プロセス]) に、API 呼び出しのステータス ([ステータス]) と応答メッセージ ([応答メッセージ]) と共に出力します。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 「セットアップ」の手順を完了します。
2. プロジェクトに [Oracle プロセス スコープ ] アクティビティを追加します。
3. [Oracle プロセス スコープ] アクティビティ内に [プロセス インスタンスを取得] アクティビティを追加します。
4. [フィルター] 入力プロパティに値を入力します。
5. [出力] セクションのプロパティ用に DataTable 変数および String 変数を作成して入力します。
6. アクティビティを実行します。

   • 入力したプロパティは、 Retrieve Process Instance List API に渡されます。

   • API は、出力プロパティ変数に DataTable と String の値を返します。

     

プロパティ

共通

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

フィルター

• 割り当てのフィルター - ユーザーまたはグループの割り当てに従ってプロセスをフィルター処理します。ドロップダウン リストから項目を選択します。5つのオプションがあります。
  • My_And_Group - 自分が属するグループ内の、自分を含む任意のユーザーに割り当てられているプロセス インスタンスが表示されます。
  • 所有者 - 自身が所有者であるプロセス インスタンスが表示されます。
  • レビュー担当者 - 自分がレビュー担当者であるプロセス インスタンスが表示されます。
  • 管理者 - 管理者ユーザーのすべてのプロセス インスタンスを表示します。
  • すべて - 管理者コンテキスト ユーザーのフィルター処理はありません。自分が非管理者用に作成したすべてのプロセス インスタンスを表示します。
• 指定日時より後に作成日 - 指定した日付より後に作成されたプロセス インスタンスを返します。DateTime または DateTime の変数を入力します。
• 優先度 - 取得するプロセスの優先度です。Int32 または Int32 の変数を入力します。1 (最高) から 5 (最低) までの値を入力します。
• プロセス名 - 返すプロセス インスタンスの名前です。このフィールドでは、 Strings 変数または String 変数のみがサポートされています。
• 指定日時より後に更新 - 指定した日付より後に更新されたプロセス インスタンスを返します。DateTime または DateTime の変数を入力します。

その他

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

ページネーション

• 制限 - 取得するプロセス インスタンスの最大数です。Int32 または Int 32 の変数を入力します。特定のプロセスを取得する必要があるが、そのアクティビティの プロセス ID がない場合は、この値を 1 に設定して プロセス名 を入力すると、 DataTable オブジェクトで返される結果をさらに制限できます。
  • DataTableからプロセス ID を抽出して変数に変換し、他のアクティビティで使用するには、以下のプロパティに関する注意事項をご覧ください。
• オフセット - 応答のオフセット値です。Int32 または Int32の変数を入力します。

出力

• レコード数が多い - レコード数が [ 制限 ] プロパティで指定した数を超えた場合に通知する Boolean 値です。このフィールドでは Boolean 変数のみがサポートされています。
• プロセスのインスタンス - フィルターのプロパティ値に一致するプロセスのインスタンスです。DataTable変数を入力します。
  • には、後続のアクティビティ (例:[プロセスの添付ファイルを取得]、[ プロセスのコメントを追加]) で入力変数として使用できるDataTable 値を含む [ プロセス ID] 列が含まれます。Int32
  • たとえば、プロセス ID のInt32変数を作成するには、[代入] アクティビティを使用して値を Int32.Parse(processes.行 (0) です。Item("ProcessId").ToString) (「processes」は、このプロパティ用に作成するDataTable変数です。以下の例を参照)。
• 応答メッセージ - API 応答メッセージです。このフィールドでは String 変数のみがサポートされています。
• ステータス - 要求のステータスです。String変数を入力します。指定できる値は Success または Failure です。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。