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

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

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 - 親プロセスの実行場所に関係なく、ピクチャ イン ピクチャ セッション内で子プロセスが開始します。

Argument messages

The activity reports the state of its Arguments dictionary in the info box. None of these messages removes an argument you configured: Refresh arguments either imports the arguments the invoked workflow declares or leaves the dictionary as it is and says why.

The one case where it can still write an incomplete set is the behavior on Studio 25.10 or older, described in the note at the end of this section.

• "The arguments could not be read from the invoked target, so they were left unchanged." - Shown when you select Refresh arguments and the workflow file is missing, its path resolves outside the project, its .xaml cannot be parsed, or the read fails for another reason. While you edit the activity, this case reports nothing.
• "The invoked target declares arguments that cannot be imported (for example, a missing name or type, or a duplicate name), so the arguments were left unchanged. Fix the target's arguments and refresh again." - Shown when you select Refresh arguments. The import is refused as a whole rather than writing only the arguments that could be built.
• "The arguments could not be updated in the workflow, so they were left unchanged. See the logs for details." - Shown when you select Refresh arguments if the invoked workflow was read but the dictionary could not be written back. Nothing is lost.
• "The invoked target declares no arguments. For safety the following are not removed automatically:" followed by the argument names. - Shown both when you refresh and while you edit. The listed arguments are kept deliberately, and you can remove them manually if the invoked workflow no longer uses them.
• "The following argument(s) are missing or misconfigured:" followed by the argument names. - Shown while you edit, when the invoked workflow declares arguments the activity does not have, or has with a different type or direction. Selecting Refresh arguments resolves it.
• "The following arguments are extra:" followed by the argument names. - Shown while you edit, when everything the invoked workflow declares is already configured and the activity carries further arguments on top of it.
• "The following argument(s) are missing or misconfigured:" followed by the argument names, then "N argument(s) are extra." - Shown while you edit, when the previous two cases apply at once, which is what pointing the activity at a different workflow produces. The missing arguments are named, the extra ones only counted.

The messages that list argument names show at most three, then append "and N other(s)".

注:

On Studio 25.10 or older, a workflow whose .xaml cannot be parsed is not always reported as a read failure: Studio drops only the declarations whose types it could not resolve and returns the rest.

If every declaration was affected, the read comes back empty, the message says the workflow declares no arguments, and the configured arguments are kept. If only some were affected, the read looks complete, Refresh arguments imports the shortened set, and the affected arguments are not preserved.