ワークフロー ファイルを呼び出し

[ワークフロー ファイルを呼び出し] アクティビティ。指定したワークフローを同期的に呼び出します。任意で、入力引数のリストを引き渡すこともできます。

UiPath.Core.Activities.InvokeWorkflowFile

説明

指定したワークフローを同期的に呼び出します。任意で、入力引数のリストを引き渡すこともできます。

注:

• ワークフローからインポートした引数は、名前とデータ型が同じである既存の変数と自動的に照合されます。
• シリアル化できないデータ型は、分離されたワークフロー間で渡すことはできません (例:UI ブラウザー、UI 要素など)。
• PowerShell アクセスを制限するウイルス対策ポリシーにより、PowerShell 関連のアクティビティの使用が妨げられる場合があります。たとえば、McAfee Endpoint Security でルール ID 6151 が有効化されている場合、[ワークフロー ファイルを呼び出し] と [Power Shell を呼び出し] を使用することはできません。
• カスタム ログ フィールドを追加する、呼び出されたワークフローを実行すると、そのログ フィールドは親ワークフローの設定に戻ります。

重要:

• 分離されていない [ワークフロー ファイルを呼び出し] アクティビティに IN 引数を渡すと、参照が渡されたかのように機能します。つまり、呼び出されたワークフロー内のオブジェクトに変更を加えると、メイン ワークフローのオブジェクトが変更されます。
• ワークフローを呼び出す際は、永続性アクティビティが含まれていないことを確認してください。これらのアクティビティは、メイン ワークフローでのみ使用してください。
• トリガー ワークフロー、つまりトリガー アクティビティで始まるワークフローを呼び出すと、引数が予期せず自動的にインポートされる可能性があります。

このアクティビティ本体の [ワークフローを開く] ボタンを使用することで、[ワークフロー ファイル名] プロパティで参照しているワークフローを現在のプロジェクトで開くことができます。

注:

タイトルにドット (.) を含む .xaml ファイルを呼び出すと、必ず、ドットまでのすべてのテキスト (ドットを含む) がアンダースコア (_) で置き換えられます。

プロジェクトの対応 OS

Windows - レガシ | Windows | クロスプラットフォーム

Windows、クロスプラットフォームでの設定

• ワークフロー ファイル名 - 呼び出される .xaml ファイルのファイル パスです。このファイル パスは、現在のプロジェクト フォルダーへの相対パスです。このフィールドで使用できるのは、文字列と String 型変数のみです。文字列はすべて引用符で囲む必要があります。ワークフローを同じプロジェクトの別のタブで開くには、フィールドの右側にある [ワークフローを開く] を選択します。
• 引数 - 既定のオプションです。Arguments ディクショナリを開きます。ここで、呼び出されたワークフローの引数を確認できます。フィールドの右側にある [式を使用] を選択することで、変数を定義して引数のディクショナリを保持することもできます。こうすると、[引数] フィールドが引数とする変数に変換されます。ワークフローの引数の最新のリストを取得するには、フィールドの右側にある [引数を更新します。] を選択します。
  重要:

  Arguments ディクショナリ内で空のままの入力引数は、そのデータ型に応じて渡される方法は異なります。

  • 参照型 ( String、 DataTable、任意のクラスなど) は nullとして渡されるため、呼び出されるワークフローはその引数に対して宣言された既定値を使用します。
  • 値の型 ( Boolean、 Int32、 DateTimeなど) は nullできないため、呼び出されるワークフローで宣言された既定値ではなく、空の型を既定の型 (False、 0、 01/01/0001 00:00:00など) として渡します。
  ヒント:

  値型の引数が空のままにしたときに呼び出されるワークフローの既定値にフォールバックするようにするため、呼び出されるワークフローでその引数を null 許容型 (例: Nullable(Of Boolean)) として宣言できます。

• 引数とする変数 - [引数] フィールドの [式を使用] オプションを選択するとアクティブ化されます。定義済みの変数を使用することも、新しい変数を作成することもできます。新しい変数を作成するには、VB の式を使用するか、プロンプトを使用して Autopilot に VB の式を生成するように指示できます。この変数を使用して、呼び出されるワークフローの引数のディクショナリを格納します。[引数] オプションに戻すには、フィールドの右側にある [静的な名前を使用] を選択します。引数のリストを開いて属性を編集するには、[引数] フィールド ボックスを選択します。
  注:

  • 引数とする変数の値が実行時に null である場合、このアクティビティは引数のプロパティにフォールバックします。
  • [引数] プロパティと [引数とする変数] プロパティを切り替えると、以前の値が表示されます。
  • [式エディター] を閉じると、引数とする変数の値は失われます。

その他のプロパティ

共通

• タイムアウト - 呼び出したワークフローの実行を待機する時間を指定します。この時間が経過すると、例外がスローされ、ワークフローは中断されます。このフィールドでは TimeSpan 型変数のみがサポートされています。既定ではこのフィールドは空白です。
• エラー発生時に実行を継続 - アクティビティでエラーが発生した場合でも、オートメーションを継続するかどうかを指定します。このフィールドでは Boolean 値 (True、False) のみがサポートされています。既定値は False です。そのため、フィールドが空白でエラーが発生すると、プロジェクトの実行が停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
  注:

  このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True である場合、プロジェクトの実行時にエラーが捕捉されません。

オプション

• ターゲット セッション (Windows プロジェクト専用) - ワークフローを開始するセッションを指定します。親とは異なるセッションで開始できるのは独立したワークフローのみです。したがって、必ず [分離] プロパティを True に設定してください。以下のいずれかのオプションから選択できます。
  • Current - 子プロセスが親プロセスと同じセッション内に開きます。
  • Main - 親プロセスの実行場所に関係なく、メイン セッション内で子プロセスが開始します。
  • Picture in Picture - 親プロセスの実行場所に関係なく、ピクチャ イン ピクチャ セッション内で子プロセスが開始します。
• 分離 - True を選択すると、呼び出したワークフローは別の Windows プロセスで実行されます。これにより、メインのワークフローから挙動が不安定なワークフローを切り離します。既定では False です。
• 管理者特権 (Windows プロジェクトおよび Windows - レガシ プロジェクトでサポート) - True を選択すると、親プロセスを管理者特権で、分離された子プロセスを中プラスの整合性で実行されます。[ 分離] が True に設定されている場合にのみ有効になり、ロボットで UIPATH_MEDIUMPLUS_INVOKE 環境変数を有効化する必要があります。それ以外の場合、設定は無視されます。既定では False です。

ログ

• 開始時のログ - 呼び出したリソースの開始時に自動でログに記録する情報の種類を指定します。
• 終了時のログ - 呼び出したリソースの終了時に自動でログに記録する情報の種類祖指定します。
• ログ レベル - [開始時のログ] および [終了時のログ] によって生成されたメッセージに適用するログ レベルを指定します。
  重要:

  [ 開始時のログ ] と [終了時のログ ] の既定値を設定するには、 UiPath Studio の >[プロジェクト設定] > [システム] > [ワークフロー ファイルを呼び出し] に移動します。ここで指定した値はプロジェクト全体に適用されます。

Windows - レガシでの設定

デザイナー パネル

アクティビティの本体には、次のプロパティがあります。

• ワークフロー ファイル名 - 呼び出される .xaml ファイルのファイル パスです。このファイル パスは、現在のプロジェクト フォルダーへの相対パスです。このフィールドで使用できるのは、文字列と String 型変数のみです。String 型変数がサポートされています。文字列はすべて引用符で囲む必要があります。
• 引数のインポート -[引数] パネルを開きます。このパネルには、[ワークフロー ファイル名] プロパティで参照されたワークフローのすべての引数が表示されます。このパネルでは、方向コントロールを使用するか、[ 削除 ] ボタンを使用して引数を再編成することにより、呼び出されたワークフローからインポートする引数を選択できます。[OK] をクリックすると、変更が保存されます。
  注:

  • パネルで引数を作成すると、呼び出されたワークフローのデータと一致しないため、引数が破棄されます。
  • パネルでは、引数名は大文字と小文字が区別されます。

パネルを閉じると、ボタンの横のカウンターに、インポート用に選択された引数の数が表示されます。カウンターは、次のように色分けされています。

• オレンジ - 選択した引数と、呼び出されたワークフローに存在する引数との間に不一致がある場合。
• グレー - 選択した引数が呼び出されたワークフローで見つかった場合。

• ワークフローを開く - 呼び出されるワークフローを、同じプロジェクトの別のタブで開けるようにします。

プロパティ パネル

共通

• エラー発生時に実行を継続 - して、フィールドが空白であり、エラーが返された場合、プロジェクトの実行は停止されます。値が True に設定されている場合、エラーが発生したとしても、プロジェクトの実行は続行されます。アクティビティでエラーが発生した場合でもオートメーションの実行を継続するかどうかを指定します。このフィールドで使用できるのは Boolean 値 (true、false) のみです。既定値は false であるため、このフィールドが空白の場合にエラーが発生すると、プロジェクトの実行は停止します。値を True に設定すると、プロジェクトの実行はエラーに関係なく継続されます。
  注:

  このアクティビティが [トライ キャッチ] に含まれていて、[エラー発生時に実行を継続] プロパティの値が True の場合、プロジェクトの実行時にエラーはキャッチされません。

• 表示名 - アクティビティの表示名です。
• Timeout - エラーがスローされる前の、アクティビティが実行するのを待機する時間を指定します。 このフィールドは、TimeSpan 変数のみをサポートします。 既定値ではこのフィールドは空です。

入力

• 引数 - 呼び出し時にアプリケーションに渡すことができるパラメーターです。
• 引数とする変数 - ディクショナリを使用してワークフローに動的に渡すことができるパラメーターです。
• 分離 - このチェック ボックスをオンにした場合、呼び出したワークフローは別の Windows プロセスで実行されます。これにより、メインのワークフローから挙動が不安定なワークフローを切り離します。
• 昇格 - このチェック ボックスをオンにすると、分離された子プロセスは MediumPlus の整合性で実行され、親プロセスは昇格されません。[ 分離 ] が選択されている場合にのみ有効で、ロボットが UIPATH_MEDIUMPLUS_INVOKE 環境変数を有効化する必要があります。それ以外の場合、設定は無視されます。
• ワークフロー ファイル名 - 呼び出される .xaml ファイルのファイル パスです。このファイル パスは、現在のプロジェクト フォルダーへの相対パスです。このフィールドで使用できるのは、文字列と String 型変数のみです。String 型変数がサポートされています。文字列はすべて引用符で囲む必要があります。
  注:

  v2021.10 以前のロボットを使用している場合、分離されたワークフローではビジネス例外はサポートされておらず、すべての例外がシステム例外として返されます。

ログ

• 開始時のログ - 呼び出したリソースの開始時に自動でログに記録する情報の種類を指定します。
• 終了時のログ - 呼び出したリソースの終了時に自動でログに記録する情報の種類祖指定します。
• ログ レベル - [開始時のログ] および [終了時のログ] によって生成されたメッセージに適用するログ レベルを指定します。

重要:

[ 開始時のログ ] と [終了時のログ ] の既定値を設定するには、 UiPath Studio の >[プロジェクト設定] > [システム] > [ワークフロー ファイルを呼び出し] に移動します。ここで指定した値はプロジェクト全体に適用されます。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。
• ターゲット セッション (Windows プロジェクト専用) - ワークフローを開始するセッションを指定します。親とは異なるセッションで開始できるのは独立したワークフローのみです。したがって、必ず [分離] プロパティを True に設定してください。以下のいずれかのオプションから選択できます。
  • Current - 子プロセスが親プロセスと同じセッション内に開きます。
  • Main - 親プロセスの実行場所に関係なく、メイン セッション内で子プロセスが開始します。
  • Picture in Picture - 親プロセスの実行場所に関係なく、ピクチャ イン ピクチャ セッション内で子プロセスが開始します。

引数のメッセージ

このアクティビティは、情報ボックスの Arguments ディクショナリの状態を報告します。以下のメッセージでは、設定した引数は削除されません。 引数を更新すると 、呼び出されるワークフローが宣言した引数をインポートするか、ディクショナリをそのままにしてその理由を示します。

いまだに不完全なセットを書き込む可能性があるケースの 1 つは、このセクションの最後にある注で説明されている 25.10 以前の Studio での動作です。

• 「引数は呼び出されたターゲットから読み取ることができなかったため、変更されずに残されました。」- [ 引数を更新 ] を選択した場合にワークフロー ファイルが見つからない場合に表示される解析できないか、別の理由で読み取りが失敗します。アクティビティの編集中は、このケースでは何も報告されません。
• 「呼び出されたターゲットは、インポートできない引数 (名前や型が欠落している、名前が重複しているなど) を宣言しているため、引数は変更されずに残されました。ターゲットの引数を修正して、もう一度更新してください。」- [ 引数を更新] を選択すると表示されます。インポートは、構築できる引数だけを記述するのではなく、全体として拒否されます。
• 「引数をワークフロー内で更新できなかったため、変更されずに放置されました。詳しくはログをご覧ください。 - [ 引数を更新 ] を選択すると、呼び出されたワークフローが読み取られたものの、ディクショナリを書き戻せなかった場合に表示されます。何も失われません。
• 「呼び出されたターゲットは引数を宣言しません。安全のため、以下は自動的には削除されません。」とその後に引数名が続きます。- 更新時と編集時の両方に表示されます。リストされている引数は意図的に保持され、呼び出されるワークフローで使用されなくなった場合は手動で削除できます。
• 「次の引数が見つからないか、設定ミスです。」と引数名を示します。- 編集中、呼び出されるワークフローが、アクティビティにない引数、または異なる型または方向の引数を宣言している場合に表示されます。[ 引数を更新 ] を選択すると解決します。
• 「次の引数は追加です。」の後に引数名が続きます。- 編集中、呼び出されるワークフローで宣言されているすべての項目がすでに設定済みであり、その上にさらに引数が含まれる場合に表示されます。
• 「次の引数が見つからないか、設定ミスです。」という引数名が続き、その後に「N 個の引数が追加されています。」- 編集中に、前の 2 つのケースが同時に適用されている場合に表示されます。アクティビティが別のワークフローをポイントすると結果が表示されます。不足している引数には名前が付けられ、余分な引数のみがカウントされます。

引数名をリストしたメッセージには、最大で 3 つが表示され、その後に「and N other(s)」が追加されます。

注:

v25.10 以前の Studio では、.xaml のワークフローCannot be parsed は、必ずしも読み取り失敗として報告されるとは限りません。Studio は、解決できなかった型の宣言のみを削除し、残りを返します。

すべての宣言が影響を受けた場合、読み取りは空に戻り、ワークフローが引数を宣言していないことを示すメッセージが表示されます。設定された引数は保持されます。一部だけが影響を受けた場合、読み取りは完了したように見え、 引数を更新 すると短縮セットがインポートされます。影響を受ける引数は保持されません。