UIP Maestro のケース タスク

「uip maestro case tasks」の構文とオプション。ケース管理の定義の JSON ファイル内のステージ内のタスクと、ケース管理の定義 JSON ファイル、およびケース管理を手動で作成するための JSON フィールド参照を読み取って強化します。

タスクは、ケース管理定義のステージ内の作業単位です (プロセスの実行、エージェントの呼び出し、API ワークフロー、RPA ジョブ、人間によるアクション アイテム、タイマーの待機、コネクタ アクティビティ、受信コネクタ イベントの待機)。タスク エントリは、ケース定義の JSON ファイル内のステージのレーン内に存在します ( stages と task-entry-conditions 操作で使用するファイル構造は同じです)。 uip maestro case tasks はそれらを読み取って強化します。

タスクが実行可能になったときにゲートするエントリ ルールについては、「 uip maestro case task-entry-conditions」をご覧ください。ケース管理の全体的な概念モデルについては、「 uip maestro case」をご覧ください。

概念

• レーン — ステージ内のタスクは、並列レーンにグループ化されます (インデックス 0、 1、 2、...)。同じレーンのタスクは順番に実行され、異なるレーンのタスクは並列に実行されます。lane は、タスクを手動で作成する場合、既定で 0 に設定されます。
• タスクの種類 — process、 action、 agent、 api-workflow、 rpa、 external-agent、 wait-for-timer、 wait-for-connector、 execute-connector-activity、 case-managementのいずれかです。コネクタでサポートされる型 (execute-connector-activity、 wait-for-connector) は、他のタイプとは異なるフィールド形状を使用します (以下を参照)。
• 強化 — いくつかのタスクの種類では、Studio Web で入力/出力スキーマとバインドのメタデータ (プロセスの実際の入出力コントラクト、コネクタ アクティビティのフィールド スキーマ) をプラットフォームから取得する必要があります。tasks enrich と tasks describe は、そのメタデータの検索コマンドであり、タスクの JSON に何を書き込むべきかを手動で作成する前に発見するのに役立ちます。

概要

uip maestro case tasks get <file> <stage-id> <task-id>
uip maestro case tasks enrich --type <type> --id <id> [--element-id <id>]
uip maestro case tasks describe --type <type> --id <id> [--connection-id <id>]

タスクの JSON フィールド

タスクは、 caseplan.jsonのステージ レーン配列で手動で追加、編集、削除してから、 で検証 uip maestro case validate。フィールド参照:

コネクタ以外のタスク — タスクの種類: process、 action、 agent、 api-workflow、 rpa、 external-agent、 wait-for-timer、 case-management (以下のコネクタで動作する種類は別々です)。フィールド: displayName、name (プロセス/ワークフロー名)、folderPath、lane (並列レーン インデックス、既定0)、shouldRunOnlyOnce、description、isRequiredaction型のみ: taskTitle、priority (Low|Medium|High|Critical、既定値は Medium)、recipient (メール、assignmentCriteria も userに設定) です。強化されたタスク (プラットフォームから検索されたバインド/入力/出力) はさらに安定した elementId と enriched: true を運びます。手書きする前に、 tasks enrich を使用してそのペイロードを取得します。

コネクタを利用するタスク — タスクの種類は execute-connector-activity (アクティビティ) または wait-for-connector (トリガー) で、TypeCache uiPathActivityTypeId とコネクション ID で識別されます。Intsvc.ActivityExecution (アクティビティ) または Intsvc.WaitForEvent (トリガー) のserviceTypeを持ちます。入力値: 入力名 (body、 pathParameters、 queryParameters) をキーに設定するアクティビティの場合。トリガーの場合、 body の値はイベント フィルター パラメーターになります (値から filters.expression が生成されます。例:(project == 'PROJ' && issuetype == 'Bug')) に移動し、 queryParams/parametersも設定します。タスクを手書きで作成する前に、 tasks describe を使用して実際の入力名と完全なエンリッチメント ペイロードを確認します。

タスクの更新 — 同じ displayName/name/folderPath/shouldRunOnlyOnce/description/isRequired フィールドを既存のタスク オブジェクトにマージします (記載されていないフィールドでは現在の値が保持されます)。name/folderPath は、data ブロックのないwait-for-timer タスクには影響しません。

タスクの削除 — ステージのレーン配列からそのエントリを直接削除します。車線が空になった場合は、車線を完全に落とします。

手動編集を行ったら、 を実行します uip maestro case validate。

UIP Maestro ケース タスクは Get

ステージから 1 つのタスクを出力します。

引数

名前	Required	目的
<file>	○	ケース管理の JSON ファイルへのパスです。
<stage-id>	○	タスクを含むステージの ID です。
<task-id>	○	取得するタスクの ID です。

例

uip maestro case tasks get case.json Stage_1 ta1b2c3d

データシェイプ(--output json)

{
  "Code": "TaskFound",
  "Data": {
    "StageId": "Stage_1",
    "Lane": 0,
    "Index": 0,
    "Task": { "id": "ta1b2c3d", "type": "process", "displayName": "Process invoice" }
  }
}

UIP Maestro のケース タスクの強化

ファイルに書き込むことなく、タスクの種類の実際の入出力スキーマとバインドをプラットフォームから検索する。--helpに表示されます。

注:

これを使用して、ファイルにコミットする前に tasks add --task-type-id 生成される内容をプレビューします。特にコネクタ アクティビティ/トリガーの場合は、代わりに tasks describe を使用してください。enrich では、他の強化可能な種類 (process、 agent、 rpa、 action、 api-workflow、 case-management、 flow-processなど) もカバーしています。

オプション

長押し	値 (Value)	Required	説明
--type <type>	エンリッチ可能な型の 1 つ	○	タスクの種類。
--id <id>	string	○	タスクの一意の ID です (種類により entityKey またはアクション アプリ ID)。
--element-id <id>	string	×	変数のバインドのスコープとなる要素 ID。

例

uip maestro case tasks enrich --type process --id a1b2c3d4-0000-0000-0000-000000000001

データシェイプ(--output json)

{
  "Code": "TaskEnriched",
  "Data": {
    "name": "InvoiceProcess",
    "folderPath": "Shared",
    "inputs": [],
    "outputs": []
  }
}

Dataの正確な形状は --type (プラットフォームからの生のエンリッチメント ペイロードであり、1 つの固定スキーマに正規化されていません) によって異なります。

UIP Maestro のケース タスクの説明

バインド検出のためにタスクの種類の入出力メタデータを記述します。これは、検索コマンドの中で最も幅広い型を網羅しています (enrichがサポートするすべての機能に加えて、connector-activity、connector-trigger、external-workflow、external-agentを追加)。--helpに表示されます。

オプション

長押し	値 (Value)	Required	説明
--type <type>	記述可能なタイプの1つ	○	タスクの種類 — 上記のリストをご覧ください。
--id <id>	string	○	タスクの一意の ID (entityKey またはアクション アプリ ID)。
--connection-id <id>	UUID	条件付き	connector-activity、connector-trigger、external-workflow、external-agent に必要です。これらの型でコマンドを省略すると、明示的なエラーが発生してすぐに失敗します。他のタイプには使用されません。

external-workflow と external-agent は connector-activity と同じように記述しますが (同じ Integration Service のエンリッチメント パイプライン、同じ --connection-id 要件)、型 ID を別の TypeCache インデックスに対して解決します。これは、Studio Web によって別のカタログから提供されるためです。

例

uip maestro case tasks describe --type connector-activity \
  --id a1b2c3d4-0000-0000-0000-000000000001 \
  --connection-id b2c3d4e5-0000-0000-0000-000000000001

データシェイプ(--output json)

{
  "Code": "TaskDescribed",
  "Data": {
    "inputs": [{ "name": "body", "body": {} }],
    "outputs": [{ "name": "response" }]
  }
}

enrichmentフィールドは、基になる検索が返す場合にのみ含まれます。

関連

• UIP Maestro のケース — 概念と完全なサブシステム ディレクトリ
• UIP Maestro の場合 task-entry-conditions — タスクが実行可能になったときにゲートするルール。
• UIP: Maestro、ケース、ケース、ステージ — タスクが存在するステージです。

参照

• Maestro ツールの概要
• グローバル オプション
• 終了コード