アプリ タスクを作成

UiPath.Persistence.Activities.UserAction.CreateUserAction

説明

Action Center にアプリ タスクを作成します。アクションのプロパティはアプリ内にアクション コントロールを追加することで作成され、入力フィールドを定義します。Apps 側では Action Center でタスクを表示するためのビジュアル インターフェイスが提供されます。

注:

アプリ タスクは、v2022.10 以降の Studio で使用できます。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

Windows での設定

デザイナー パネル

• タイトル - 作成するアクションのタイトルです。このフィールドは、文字列と String 型変数のみをサポートします。
• 優先度 - アクションの優先度レベルを UiPath.Persistence.Activities.Model.Task.TaskPriority型の引数として入力します。TaskPriority Enum 値を使用して、引数の既定値パラメーターを設定します。使用できるオプションは、[ TaskPriority.Low]、[ TaskPriority.Medium]、[ TaskPriority.High]、[ TaskPriority.Critical] です。
• Apps - Studio の使用時に組織およびテナントの Apps インスタンス内に作成およびデプロイしたアクション アプリを選択します。 アクション アプリを選択すると、アクションのプロパティがアクティビティのプロパティとしてアクセスできるようになります。変数を作成し、それに応じて各フィールドに変数を入力します。 アクション アプリを更新すると、[アクション定義名] フィールドの横に [更新] プロパティが表示されます。このプロパティを使用して、最新の変更でアクティビティを更新できます。
  注:

  [ アプリ ] ドロップダウンには、デプロイ済みでアクションがあるアプリのみが表示されます。

• Orchestrator フォルダー パス - タスクを作成する対象であり、対応するアプリをデプロイした Orchestrator フォルダーのパスです。フォルダー パスは、先ほど選択したパブリック アプリがデプロイされた場所のパスと同じにする必要があります。このフィールドは、[Apps] ドロップダウン リストからオプションを選択すると、選択したアプリがデプロイされているフォルダーと一致するように自動的に入力されます。一度設定されたフィールドは読み取り専用になり、変更できません。

プロパティ パネル

入力

• TaskCatalog - タスクアイテムのオプションの事業分類です。このフィールドは、文字列と String 型変数のみをサポートします。
  重要:

  アクションを作成する前に、 アクション カタログ が存在していることを確認してください。そうしないと、アクションの作成は失敗し、「タスク カタログ (action_catalog_name] は存在しません。エラー コード: 2451)」というメッセージが表示されます。

• ラベル - 入力されたラベルはロボットによってアクションに追加され、後でフィルター処理できます。このフィールドでは文字列の値のみがサポートされ、命名の制限があります。
  注:

  永続性アクティビティを使用してアクションに自動的にラベル付けできるようにするには、ワークフローを実行するロボット アカウントにタグの表示、作成、削除の権限が必要です。

その他

• タイムアウト (ミリ秒) - エラーがスローされる前にアクティビティが実行されるまで待機する時間 (ミリ秒単位) を指定します。既定値は 30000 ミリ秒 (30 秒) です。

出力

• タスク オブジェクト (出力) - アクションの作成後に Orchestrator から UserActionData オブジェクトとして返されるタスク オブジェクトです。このオブジェクトは、[アプリ タスク完了まで待機し再開] アクティビティに渡すことで、アクションが完了するまで、ワークフローの実行を一時停止することができます。

アクショナブルな通知

注:

現在、アクショナブルな通知をサポートする通知チャネルは Outlook だけです。

前提条件: アクショナブルな通知を期待どおりに動作させるには、以下が必要です。

• Studio のオートメーションがリンクされているテナント内の Integration Service で Microsoft Outlook 365 コネクションを有効化します。
• アクショナブルな通知に割り当てられたユーザーが [アクションが割り当てられました。] 通知イベントに登録していることを確認します。

タスクの担当者に通常のメールではなくアクショナブルな通知を送信する場合、アクティビティの [プロパティ] パネルで [ アクショナブルな通知 ] を有効化します。

操作可能な通知を有効にするには、次の手順を実行します。

1. アクティビティの [プロパティ] パネルで、[その他のオプションを表示] を選択します。

2. [アクショナブルな通知] を展開し、トグル ボタンを使用してオプションを有効化します。

3. アクショナブルな通知に使用する目的のチャンネルを選択します。

4. 必要に応じて、新しいタスク フィールドやアクショナブルなボタンを追加して、通知の内容を設定します。

   

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

デザイナー パネル

• タイトル - 作成するアクションのタイトルです。このフィールドは、文字列と String 型変数のみをサポートします。
• 優先度 - アクションの優先度レベルを UiPath.Persistence.Activities.Model.Task.TaskPriority型の引数として入力します。TaskPriority Enum 値を使用して、引数の既定値パラメーターを設定します。使用できるオプションは、[ TaskPriority.Low]、[ TaskPriority.Medium]、[ TaskPriority.High]、[ TaskPriority.Critical] です。
• Apps - Studio の使用時に組織およびテナントの Apps インスタンス内に作成およびデプロイしたアクション アプリを選択します。アクション アプリを選択すると、アクションのプロパティがアクティビティのプロパティとしてアクセスできるようになります。変数を作成し、それに応じて各フィールドに値を入力します。アクション アプリを更新すると、[アクション定義名] フィールドの横に [更新] プロパティが表示されます。このプロパティを使用して、最新の変更でアクティビティを更新できます。
  • アクティビティが Studio Web のソリューションの一部である場合は、+ [+ リソース] を選択して、自動生成されたアクション アプリにアクセスします。ここで、アクション スキーマを確立し、アプリを設定できます。
  注:

  [ アプリ ] ドロップダウン リストには、デプロイ済みでアクションがあるアプリのみが表示されます。ただし、Studio Web 内のソリューションの一部であるワークフローの場合は、そのソリューションのローカル アクション アプリがまだデプロイされていない場合でも、[ アプリ ] ドロップダウン リストには表示されます。

• Orchestrator フォルダー パス - タスクを作成する対象であり、対応するアプリをデプロイした Orchestrator フォルダーのパスです。フォルダー パスは、先ほど選択したパブリック アプリがデプロイされた場所のパスと同じにする必要があります。このフィールドは、[Apps] ドロップダウン リストからオプションを選択すると、選択したアプリがデプロイされているフォルダーと一致するように自動的に入力されます。一度設定されたフィールドは読み取り専用になり、変更できません。

プロパティ パネル

入力

• TaskCatalog - タスクアイテムのオプションの事業分類です。このフィールドは、文字列と String 型変数のみをサポートします。
  重要:

  アクションを作成する前に、 アクション カタログ が存在していることを確認してください。そうしないと、アクションの作成は失敗し、「タスク カタログ (action_catalog_name] は存在しません。エラー コード: 2451)」というメッセージが表示されます。

• ラベル - 入力されたラベルはロボットによってアクションに追加され、後でフィルター処理できます。このフィールドでは文字列の値のみがサポートされ、命名の制限があります。
  注:

  永続性アクティビティを使用してアクションに自動的にラベル付けできるようにするには、ワークフローを実行するロボット アカウントにタグの表示、作成、削除の権限が必要です。

その他

• タイムアウト (ミリ秒) - エラーがスローされる前にアクティビティが実行されるまで待機する時間 (ミリ秒単位) を指定します。既定値は 30000 ミリ秒 (30 秒) です。

出力

• タスク オブジェクト (出力) - アクションの作成後に Orchestrator から UserActionData オブジェクトとして返されるタスク オブジェクトです。このオブジェクトは、[アプリ タスク完了まで待機し再開] アクティビティに渡すことで、アクションが完了するまで、ワークフローの実行を一時停止することができます。

アクショナブルな通知

注:

現在、アクショナブルな通知をサポートする通知チャネルは Outlook だけです。

前提条件: アクショナブルな通知を期待どおりに動作させるには、以下が必要です。

• Studio のオートメーションがリンクされているテナント内の Integration Service で Microsoft Outlook 365 コネクションを有効化します。
• アクショナブルな通知に割り当てられたユーザーが [アクションが割り当てられました。] 通知イベントに登録していることを確認します。

タスクの担当者に通常のメールではなくアクショナブルな通知を送信する場合、アクティビティの [プロパティ] パネルで [ アクショナブルな通知 ] を有効化します。

操作可能な通知を有効にするには、次の手順を実行します。

1. アクティビティの [プロパティ] パネルで、[その他のオプションを表示] を選択します。

2. [アクショナブルな通知] を展開し、トグル ボタンを使用してオプションを有効化します。

3. アクショナブルな通知に使用する目的のチャンネルを選択します。

4. 必要に応じて、新しいタスク フィールドやアクショナブルなボタンを追加して、通知の内容を設定します。