プロセスを管理する

パッケージをリンクし、プロセスの設定を行うことで、Orchestrator フォルダー内にプロセスを作成してデプロイできます。

プロセスをデプロイする

注:

プロセスを作成するには、パッケージに対する [表示] 権限とプロセスに対する [表示] および [作成] 権限が必要です。

1. プロセスをデプロイするフォルダーで [オートメーション] > [プロセス] に移動します。[プロセス] ウィンドウが表示されます。

2. [ 追加] を選択します。[ プロセスを追加 ] ウィンドウが表示されます。

3. Select a package from the Package Source Name drop-down or Select the upload area below to upload a new package. The latest version of the package is automatically selected. If the package version has tags that are not applied to the process, a New tags have been found notification window is displayed informing you about the number of tags.

4. On the New tags have been found window, select Add and continue if you want to apply package tags to the process or Select Don't add if you do not want to apply package tags to the process.

   図 1. [新しいタグが見つかりました] ウィンドウ

   

5. [パッケージのバージョン] ドロップダウンから、使用するパッケージのバージョンを選択します。パッケージに入力引数または出力引数がある場合は、[ランタイム引数] セクションに表示されます。

6. [ エントリ ポイント ] ドロップダウンからエントリ ポイントを選択します。既定では、メインの Studio として設定された .xaml が選択されます。引数ビューが更新され、選択したワークフローの引数が表示されます。ランタイム引数について詳しくは、こちらをご覧ください。

   注:

   • 2020 年 7 月より前にパブリッシュされたパッケージの場合、Orchestrator はメイン エントリ ポイントを特定できないため、既定ではエントリ ポイントは選択されていません。ドロップダウンから手動でエントリ ポイントを選択する必要があります。
   • プロセスで複数のエントリ ポイントがサポートされない場合、Orchestrator では [エントリ ポイント] ドロップダウンに [既定] と表示され、フィールドは無効化されています。

7. パッケージに入力引数がある場合、引数の表で値を指定できます。対応するエントリの [編集] をクリックして、引数を編集します。

8. Once you are done with the changes, Select Next. The Package Requirements window is displayed.

   [パッケージ要件] タブでは、基になるワークフローの設計で使用された、ジョブの実行を成功させるために必要なオブジェクトを識別できます。

   パッケージ要件の管理方法について詳しくは、「パッケージ要件を管理する」をご覧ください。

9. Once you have handled the package requirements, Select Next. The Additional Settings window is displayed.

10. [表示名] フィールドに、プロセスについて記載、表示、監視しているすべてのページで表示される名前を追加します。空欄のままにすると、代わりにパッケージ名が使われます。

11. Enter a Description for the process. We recommend adding a description, especially when there are many processes deployed to Orchestrator.

12. [ タグ] セクションでプロセス タグを管理します。必要な権限があれば、基になるパッケージから継承されたタグを確認したり、新しいタグを追加したり、既存のタグを削除したりできます。詳しくは 、「タグを使用してリソースを整理 する」をご覧ください。

13. [ 保持ポリシー ] セクションで、このプロセスに関連付けられたジョブが削除されるタイミングに関するルールを作成します。詳細については、「 プロセスのデータ保持ポリシー 」をご覧ください。

14. [ジョブの優先度] ドロップダウンから、プロセスの実行優先度を選択します。

15. ジョブの実行中に発生すると考えられる問題の修正方法につき、提案やデバッグ情報を受け取るには [Healing Agent を有効化] トグルをオンにします。また、[Healing Agent の自己修復を有効化] オプションを選択することで、Healing Agent 自身でジョブ実行の問題を修正できるようにすることができます。既定では、[Healing Agent を有効化] オプションは有効化され、[Healing Agent の自己修復を有効化] オプションは無効化されています。Healing Agent とその機能の詳細については Healing Agent のドキュメントを参照してください。

16. このプロセスを Assistant から表示しない場合は、[有人プロセスを実行するユーザーに対してプロセスを非表示] オプションをオンにします。このオプションを有効化すると、[プロセスを UiPath Assistant から停止できないようにする] オプションは非アクティブになります。

    注:

    これは、バージョン 2023.10+ の Assistant と Robot でのみ機能します。

17. UiPath Assistant からのプロセス終了を制限するには、[プロセスは UiPath Assistant から停止できません。] のオプションをオンにします。

18. ロボット エージェントの起動時にこのプロセスを自動的に起動するように設定するには、[プロセスを自動的に起動] オプションをオンにします。

19. Switch on the Job Recording option and choose the Enter of desired job recording. The execution is recorded and available for download as execution media.

    注:

    [記録機能を有効化] オプションが表示されない場合は、以下の項目をご確認ください。

    • Enterprise または Enterprise 無料トライアルのライセンスに最近アップグレードした場合は、移行が完了するまで数日お待ちください。その後、このオプションが利用可能になります。
    • アカウントに実行メディアの表示権限が割り当てられている必要があります。

    [ビデオ] では、以下の録画オプションから選択できます。

    • 失敗したジョブを記録して保存: 失敗したジョブを記録して保存します。

    • 失敗したキューのトランザクションを記録して保存: 失敗したキュー アイテムを記録して保存します。

    • すべてのジョブを記録: すべてのジョブを記録して保存します。

      [スクリーンショット] を選択する場合は、[スケーリング]、[頻度]、[期間] のオプションを必要に応じて設定します。

フィールド	説明
スケーリング	Enables you to set the scaling of the screenshots in percent. The maximum value is 100. By default, this field is set to 100.
頻度	Enables you to configure the time interval between screenshots, in milliseconds. The minimum value is 250. By default, this field is set to 500.
Duration	レコーディングの開始に失敗するまでの時間を設定できます (単位: 秒)。最大値は 120 です。既定では、このフィールドは 40 に設定されます。

20. (任意。クロスプラットフォーム プロセスでのみ利用可能) Automation Suite ロボットを使用してこのプロセスを実行する場合は、使用するマシン サイズのオプションを選択します。

    オプション	詳細	ロボット ユニット (RU) の消費量
    自動	既定の設定です。概要レベルのプロセス依存関係に基づいて、最適なマシン サイズを選択します。	マシンのサイズによって異なります。
    小	1 GB (0.5 CPU まで) ほとんどの無人プロセスに使用できます。	1 RU/分
    標準	2 GB (~1 CPU) UI Automation を使用する無人プロセス向けです。	2 RU/分
    中	4 GB (2 CPU まで) リモート デバッグなど、やや複雑な無人プロセスに使用します。	4 RU/分
    大	10 GB (~6 CPU) アクティビティを含むプロセスのような、負荷の大きいプロセスに使用します。	10 RU/分

    重要:

    選択したマシンのサイズが小さすぎる場合プロセスは完了せずにタイムアウトしますが、そのマシンが実行されている間はロボット ユニットが消費されます。

エージェントをデプロイする

注:

プロセスを作成するには、パッケージに対する [表示] 権限とプロセスに対する [表示] および [作成] 権限が必要です。

1. プロセスをデプロイするフォルダーで [オートメーション] > [プロセス] に移動します。[プロセス] ウィンドウが表示されます。

2. [ 追加] を選択します。[ プロセスを追加 ] ウィンドウが表示されます。

3. Select a package from the Package Source Name drop-down. To display only agent-Enter packages, use the Filter types filter next to the drop-down and select Agent. You can also use the upload area to upload a new package. The latest version of the package is automatically selected.

4. パッケージ バージョンに、プロセスに適用されていないタグがある場合、[新しいタグが見つかりました] という通知ウィンドウが開き、タグの数に関する情報が表示されます。[新しいタグが見つかりました] ウィンドウで、プロセスにパッケージ タグを適用する場合は [追加して続行] を選択し、プロセスにパッケージ タグを適用しない場合は [追加しない] を選択します。

5. [パッケージのバージョン] ドロップダウンから、使用するパッケージのバージョンを選択します。

6. コード化されたエージェントの環境変数を指定するには [環境の構成] テキスト フィールドを使用します。ユーザー インターフェイスでは、コード化されたエージェントは (Agent - <プログラミング言語>) の形式で表示されます。

   [環境の構成] フィールドを使用すると、次のいずれかの方法で API キーなどのシークレットを参照できます。

   • 次の例のように、[環境の構成] フィールドに直接シークレット値を入力します。

     SECRET=Abc@123
     

     今後、プロセスを編集するときに、シークレット値の代わりにアスタリスクを表示することで、シークレットのセキュリティを強化できます。この動作を有効にするには、シークレット キーの名前の末尾を次のいずれかの文字列にします。

     • ACCESS_KEY
     • API_KEY
     • AUTH
     • CREDENTIALS
     • PASSWORD
     • PRIVATE_KEY
     • SECRET
     • SESSION
     • TOKENシークレット値を更新するには、アスタリスクを削除して新しい文字列を入力します。

   • 次の例のように、エージェントと同じフォルダーにある Secret タイプのアセットを参照します。

     MySecret=%ASSETS/SECRET%
     

     注:

     • Typing =% after the secret key displays an ASSETS/ autocompletion suggestion.

Accepting the suggestion displays a drop-down list of assets from which you can select the desired item. * You cannot retrieve secrets from external credential stores when using a disconnected credential proxy. ::: 7. If the package has input or output arguments, the arguments are displayed in the Runtime Arguments section, under the Input and Output tabs.

Edit the arguments as necessary.

引数と、基になる JSON スキーマのビューを切り替えるには、[JSON スキーマ] を選択します。

図 2. JSON スキーマ

8. When you are done with the changes, Select Next. The Package Requirements page is displayed.

   [パッケージ要件] ページでは、基になるワークフローの設計で使用された、ジョブの実行を成功させるために必要なリソースを識別できます。

   Agents の概念は Orchestrator のパッケージ要件に次のようにマッピングされることに注意してください。

   Agents の概念	Orchestrator のパッケージ要件
   エスカレーション	アプリ
   ツール	コネクションまたはプロセス
   Context	インデックス

   パッケージ要件に含まれるリソースの既定のバインドを変更するには、対応する [上書き] ボタンを使用します。この機能を使用すると、次のリソースの種類を対象として、フォルダーをまたがってリソースを選択できます。

   • アプリ

   • バケット

   • ビジネス ルール

   • インデックス

   • プロセス

   • キュー

     パッケージ要件の管理方法に関する一般的な情報については、「 パッケージ要件を管理する」をご覧ください。

9. Once you have configured the package requirements, Select Next. The Additional Settings window is displayed.

10. [表示名] フィールドに、プロセスについて記載、表示、監視しているすべてのページで表示される名前を追加します。空欄のままにすると、代わりにパッケージ名が使われます。

11. Enter a Description for the process. We recommend adding a description, especially when there are many processes deployed to Orchestrator.

12. [ タグ] セクションでプロセス タグを管理します。必要な権限があれば、基になるパッケージから継承されたタグを確認したり、新しいタグを追加したり、既存のタグを削除したりできます。詳しくは 、「タグを使用してリソースを整理 する」をご覧ください。

13. [ 保持ポリシー ] セクションで、プロセスに関連付けられた完了したジョブと未完了のジョブを削除およびアーカイブするためのポリシーを定義します。詳細については、「 プロセスのデータ保持ポリシー 」をご覧ください。

14. [ 実行のオプション ] セクションで、[ エージェント メモリ ] トグルを有効化し、エージェントで情報を保持できるようにします。これにより、エージェントは過去のインタラクションから学習し、取得した知識を将来のタスクに適用できます。

    注:

    後でエージェントを編集する際にこのトグルを無効化しても、エージェントのメモリはクリアされません。後でこのトグルを再度有効化すると、無効化する前に取得されたエージェント メモリが再び使用可能になります。

プロセスの設定を編集する

表示名、説明、ジョブの優先度のほか、[記録機能を有効化]、[プロセスを自動的に開始]、[プロセスは UiPath Assistant から停止できません。] のオプションは、プロセスのデプロイ後も [プロセスの設定] ウィンドウで変更できます。

1. For the desired process, Select More Actions > Process Settings. The Process Settings window is displayed.
2. Change the desired option, and Select Update to save the changes.
   注:

   • 既定では、プロセスと関連付けのあるジョブが実行中または保留中である場合でも、プロセスを編集できます。次のことを考慮してください。
   • 変更されたプロセスと関連付けられた実行中のジョブでは、元のバージョンのプロセスが使用されます。
   • 新規作成されたジョブでは、または同じジョブが新規にトリガーされたときには、新しいバージョンが使用されます。
   • 変更されたプロセスと関連付けられた保留中のジョブでは、更新されたバージョンが使用されます。

   • [オートメーション] > [ログ] ページの [プロセス] フィルターでは、プロセスに指定された最新の名前を検索します。古いプロセス名で記録されたログは、これ以降フィルター処理できません。

パッケージ バージョンを管理する

重要:

• パッケージの初回パブリッシュ時には、Studio で定義されたメインのエントリ ポイントが、Orchestrator の現在のエントリ ポイントとしても設定されます。
• 新しいパッケージ バージョンをパブリッシュする際、新しいバージョンに現在のエントリ ポイントが存在する場合、現在のエントリ ポイントは保持されます。存在しない場合、Studio で定義されたメインのエントリ ポイントが、既定で現在のエントリ ポイントに設定されます。
• 初期エントリ ポイントがないパッケージ バージョンに切り替えると、Studio で定義されたメインのエントリ ポイントが既定で使用されます。現在のエントリ ポイントが新しいバージョンにも存在する場合、アップグレード時に現在のエントリ ポイントは保持されます。
• 外部フィードからパッケージをアップロードしてプロセスを更新するには、/odata/Processes/UiPath.Server.Configuration.OData.SetArguments エンドポイントを使用します。プロセスの引数が新しいパッケージの引数と同じであることを、ユーザー側で確認する必要があります。Orchestrator は外部フィードのパッケージに対して検証を実行しないためです。 プロセスのパッケージ バージョンを管理するには、プロセスに関する [表示] 権限と [編集] 権限、そしてパッケージ/フォルダー パッケージに関する [表示] 権限が必要です。

フォルダー内のプロセスを更新する

プロセスで使用できるバージョンが複数ある場合は、プロセスの作成または編集時に、どのバージョンを使用するかを [パッケージ バージョン] ドロップダウンから選択できます。

1. [ その他のアクション ] > [編集] を選択します。[ プロセスを編集 ] ウィンドウが表示されます。
2. On the Package Versions drop-down, select the specific package version you want to use or Select Rollback to return to the previously used version.

[プロセスを編集] ウィンドウにアクセスせずに、プロセスを最新バージョンに簡単にアップグレードするには、次の手順を実行します。

1. 目的のプロセスについて、[その他のアクション] > [最新バージョンにアップグレード] を選択します。[最新バージョンにアップグレード] ボタンは、既に最新のパッケージ バージョンを使用しているプロセスでは読み取り専用になります。
2. 表示された確認ウィンドウで [確認] を選択します。選択したプロセスは最新バージョンに更新され、それに伴ってアイコンも更新されます。何らかの理由でプロセスが更新されなかった場合には、エラー メッセージが表示されます。

フォルダー内の複数のプロセスを更新する

フォルダー内の複数のプロセスを、利用可能な最新のバージョンに更新できます。

1. [プロセス] ページで最新のパッケージ バージョンに更新するプロセスを選択します。
2. [ 最新を使用] を選択します。[ 最新を使用 ] ボタンは、選択したプロセスのうち、利用可能な最新のパッケージ バージョンを使用していないプロセスが 1 つ以上含まれている場合にのみ有効化されます。選択範囲に、利用可能な最新のパッケージ バージョンを使用するプロセスが含まれている場合、このボタンは無効化されます。
3. 表示された確認ウィンドウで [確認] を選択します。選択したプロセスは最新バージョンに更新され、それに伴ってアイコンも更新されます。何らかの理由でプロセスが更新されなかった場合には、エラー メッセージが表示されます。

フォルダー間でプロセスを更新する

パッケージ レベルでは、複数のフォルダー/サブフォルダーのプロセスを一度に更新できます。選択したパッケージに関連付けられたプロセスがすべて検索されて表示されるため、そのうちのどれを提供されている最新バージョンのパッケージに更新するかを選択できます。検索は、次のようにフィードごとに実行されます。

• テナント フィード - Orchestrator は、そのテナント フィードを使用するすべてのフォルダー/サブフォルダー内で、選択したパッケージに関連付けられたプロセスをすべて検索します。[パッケージ] ページ ([テナント] コンテキスト > [パッケージ] タブ) で確認できます。
• フォルダー フィード - Orchestrator は、その特定のフォルダー フィード内 (サブフォルダーを含む) で、選択されたパッケージに関連付けられたプロセスをすべて検索します。次の場所で確認してください: [フォルダー パッケージ] ページ ([フォルダー] コンテキスト > [オートメーション] タブ > [フォルダー パッケージ] タブ)

アップグレードのプロセスは、テナント フィードとフォルダー フィードのどちらのレベルでも同様です。現在のコンテキストに応じて上記の場所に移動してから、次の手順を実行します。

1. Select the packages for upgrading and Select Upgrade available processes to latest versions. The Upgrade multiple processes window is opened displaying a list with all processes not employing the latest version of a package. The following information is displayed on the Upgrade multiple processes window:

   1. パッケージの名前

   2. パッケージの最新バージョン

   3. 最新パッケージ バージョンを使用していないプロセスの数

   4. プロセスの名前、現在のパッケージ バージョン、それらが保存されているフォルダー/サブフォルダーのパス

      図 3. フォルダー フィードに存在するパッケージを使用するプロセスのアップグレード

      

      図 4. テナント フィードに存在するパッケージを使用するプロセスのアップグレード

   

2. For each package select the processes that you would like to upgrade. When done, Select Upgrade. Selected processes are bulk updated with the latest version of their packages.

入力引数の値を管理する

プロセスに 1 つ以上の入力引数がある場合、プロセス レベルでこれらの値を編集できます。

1. プロセスについて、[その他のアクション] を選択し、[編集] を選択します。[プロセスを編集] ウィンドウが表示されます。
2. [ランタイム引数] セクションの [入力] に、引数の適切な値を入力します。
3. 手順 2 を必要に応じて繰り返します。
4. [ 更新] を選択します。入力引数の値が保存されます。値の入力方法については、「 入力および出力引数について」をご覧ください。

プロセスを監視する

目的のプロセスの [その他のアクション] > [プロセスを監視] ボタンをクリックして、そのプロセスに関連する [監視] ページを表示します。[プロセスを監視] ボタンは [プロセス] ページに表示されるため、ここから監視ページにアクセスするには、プロセスの表示権限も必要になります。

または、[プロセスの概要] ウィジェットから選択することもできます ([監視] > [ジョブ])。

ユーザーがプロセスを監視するには、ジョブおよび監視に関して表示権限を持っている必要があります。さらに、[監視] > [ジョブ] ページの [エラーフィード] ウィジェットでエラーを無効化するには、監視に関する編集権限が必要です。ページをロボット グループ別にフィルター処理するには、ロボット グループに関する表示権限が必要です。

プロセスにタグを追加する

注:

プロセスに既存のタグを追加するには、プロセスに対する [編集] 権限とタグに対する [表示] 権限が必要です。 プロセスに新しいタグを追加するには、プロセスに対する [編集] 権限とタグに対する [作成] 権限が必要です。タグに対する [作成] 権限がない場合、Orchestrator で新しいタグを追加することはできますが、保存することはできません。

注:

• 各プロセスには、最大 100 万個のキー/値のペアを設定できます。
• ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
• タグ名に使用できない文字は、<、>、%、&、\、?、/、: です。

プロセスへのタグの適用は、プロセスの作成時または既存のプロセスの編集時に行うことができます。プロセスの編集時にプロセスにタグを追加するには、次の手順に従います。

1. From the Processes page, Select More Actions > Edit next to the desired process. The process is opened for editing.
2. [ラベル] フィールドで、ラベル名の入力を開始します。既存のラベルを選択するか、新しいラベルを作成することができます。
3. On the Properties (key-value pairs) field, Select Add new.
4. 新しいキーと値を追加します。既存のキーまたは値を選択するか、新しいキーまたは値を作成することができます。
5. When done, Select Update. Your process is updated and the newly created tags, if any, become available for other objects.

プロセスからタグを削除する

プロセスからタグを削除するには、以下の手順に従います。

1. From the Processes page, Select More Actions > Edit next to the desired process. The process is opened for editing.
2. On the Labels field, Select the X adjacent to the name of the label to remove it. The label is removed.
3. On the Properties (key-value pairs) field, Select the X adjacent to the keys and/or values to remove them. The keys and/or values are removed.
4. To delete a key/value pair Select the Remove icon corresponding to that entry. The key/value pair is removed.
5. When done, Select Update. Your processes is updated and tags are removed.

プロセスを削除する

プロセスを削除するには、プロセス の表示 および 削除 権限と、パッケージ の表示 権限がユーザーに割り当てられている必要があります。「ロールについて」で詳細を確認してください。

1. [プロセス] ページで、目的のプロセスを選択します。
2. Select the Remove button. The process is deleted from the Processes page and the database. Please note that deleting a process is not going to delete the package from Orchestrator, but only its association with the environment/folder.

または、1 つのプロセスのみを削除する場合は、対応する [削除] ボタンをクリックします。

関連付けられたトリガーのあるプロセスを削除する場合、有効か無効かに関係なく、これらも同様に削除されます。

注:

アクティブなジョブと関連付けられている（ステータスが [保留中]、[実行中]、[停止中] または [終了中] のいずれかになっているジョブ）場合は、プロセスを削除することはできません。