UIP Maestro ケース レジストリ

「uip Maestro Case Registry」を使用して、アクティビティ、トリガー、コネクタ、その他のオートメーション リソースの Maestro Case Management レジストリを参照して検索します。

uip maestro case registry はケース管理レジストリを参照して検索します。ケース 管理レジストリ は、ケース定義がタスクをワイヤリングできるオートメーション リソース (プロセス、エージェント、API、フロー、コネクタのアクティビティ/トリガー、アクション アプリ、任意で進行中のソリューション独自のリソース) のローカルにキャッシュされたカタログです。セッションごとに 1 回レジストリをプルし、ケースの作成中に識別子でリソースを検索または取得します。

uip maestro case サブシステム全体と、レジストリ リソースがタスクの作成にどのようにフィードされるかについては、「概要」をご覧ください。

概要

uip maestro case registry pull [-f, --force] [-s, --solution-id <solutionId>]
uip maestro case registry search [keyword] [-t, --type <type>] [-f, --filter <filter>] [--local]
uip maestro case registry list [--local]
uip maestro case registry get <identifier> [-t, --type <type>] [--connection-id <id>] [--local]
uip maestro case registry get-connector -t, --type <type> --activity-type-id <id>
uip maestro case registry get-connection -t, --type <type> --activity-type-id <id>

一般的なワークフロー:

1. uip maestro case registry pull — 完全なリソース レジストリを取得してキャッシュします (セッションごとに 1 回実行)。
2. uip maestro case registry search <keyword> — リソースを検索します。
3. uip maestro case registry get <identifier> — 完全なスキーマを調べます。
4. uip maestro case registry get <identifier> --output-filter "Node.inputDefinition.fields" — 入力フィールドのみを抽出します。

概念

• リソースの種類 — レジストリには、 agent、 process、 api、 processOrchestration、 caseManagement、 flow、 action-apps、 solutionの 17 種類のリソースに加えて、カタログ ソース別に分割された 9 つの typecache-* コネクタ インデックス ファイル (typecache-activities、 typecache-triggers、 typecache-packages、およびそれぞれの -external-automation-*/-external-agent-* のバリアント) がインデックス化されています。基になるカタログがばらばらになっているため、個別のキャッシュファイルとして保持されます — それらをマージすると、各プルで前の型のエントリが上書きされます。
• --local モード — search、list、および get は、テナント全体のキャッシュではなく、ソリューション内の兄弟プロジェクト リソースのみを検索する--localを受け入れます。現在のディレクトリまたはその 2 つの親ディレクトリのいずれかに .uipx ファイルが必要です。 get --local の識別子は、兄弟のリソース キーまたは .uipx プロジェクト ID です。
• solutionリソース — solution のリソースの種類は、 が指定された場合にのみキャッシュされますpull --solution-id <id>。最初にプルせずに--type solutionを検索/取得すると、最初に実行するようにpull --solution-id明示的なヒントが返されます。
• コネクタのエンリッチメント — get可能な場合は、ライブ コネクタ メタデータ (エントリのuiPathActivityTypeIdで検索) を使用して、typecache-activities/typecache-triggers一致を自動的にエンリッチします。--connection-id渡して、コネクション固有のカスタム フィールドのメタデータを取得します。このエンリッチメントは、ルックアップが失敗した場合にサイレントにスキップされます (エラーではありません)。
• get-connector / get-connection — ローカルの TypeCache インデックスのみに対する下位レベルの検索を行います (一般リソース キャッシュを除く): get-connector 1 つのコネクタ アクティビティ/トリガー エントリとそのコネクタ構成を で解決します--activity-type-id。get-connection は同じ検索を実行し、コネクタで利用可能なコネクションを Integration Service から取得します。

UIP Maestro ケース レジストリのプル

すべての種類のリソースを取得してキャッシュするすべての種類を並列で実行し、失敗した種類も含めて種類ごとの内訳を報告します。

オプション

Short	長押し	値 (Value)	説明
-f	--force	フラグ	キャッシュを無視し、すべての種類のリソースを再取得します。
-s	--solution-id <solutionId>	string	また、特定のソリューション独自のリソース ( solution リソースの種類) をプルしてキャッシュします。

例

uip maestro case registry pull

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

{
  "Result": "Success",
  "Code": "PullResourcesSuccess",
  "Data": {
    "TotalNodesCount": 128,
    "FromCache": false,
    "ResourceTypes": [
      {
        "Type": "typecache-activities",
        "NodesCount": 80,
        "FromCache": false,
        "AgeMinutes": null,
        "CacheWritten": true,
        "Info": null
      }
    ],
    "Errors": null
  }
}

Result は、1 つ以上のリソースの種類のプルに失敗した場合に "PartialSuccess, N failed" されます ( "Success"は Errors されません)。その後、失敗した各型とそのエラー メッセージが一覧表示されます。正常にプルされた型はキャッシュされ、 ResourceTypesに反映されます。

UIP Maestro ケース レジストリの検索

キャッシュされたリソースをキーワードフィルターやフィールド フィルターで検索します。少なくとも 1 つ [keyword] または --filter が必要です。

引数

名前	Required	目的
[keyword]	いいえ*	検索するフリーテキスト キーワードです。

* [keyword]、 --filter、またはその両方を指定する必要があります。両方を省略すると、検索の前に失敗します。

オプション

Short	長押し	値 (Value)	説明
-t	--type <type>	ENUM	検索するリソースの種類を 1 つに制限します。検索可能な型の 1 つ — 全 17 種類のリストについては 「概念 」をご覧ください ( RESOURCE_TYPES すべての値はここで有効です)。
-f	--filter <filter>	string	フィールド フィルター: field=value または field:operator=value、複数のフィールド フィルターをコンマ区切りで指定します (例:name:contains=Apple,category=Pipelines)。フィールド: name、 title、 description、 category、 connectorKey。演算子: equals、 contains、 in、 startsWith、 endsWith。
—	--local	フラグ	ソリューション内の兄弟リソースのみを検索します。「 概念」をご覧ください。

例

uip maestro case registry search invoice

uip maestro case registry search --filter "name:contains=Apple,category=Pipelines"

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

{
  "Result": "Success",
  "Code": "ResourceSearchSuccess",
  "Data": {
    "Keyword": "invoice",
    "Filters": null,
    "Type": null,
    "Local": false,
    "ResultCount": 1,
    "Resources": [
      {
        "resourceType": "typecache-activities",
        "resource": {
          "name": "InvoiceParser",
          "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001"
        }
      }
    ],
    "FailedTypes": null,
    "Hint": null
  }
}

Hint は、特に が結果をゼロ --type solution 返し、 --local が合格しなかった場合に (省略されるのではなく) 入力されます。 registry pull --solution-id <id>を指定します。 FailedTypes 、検索中にエラーが発生したリソースの種類が一覧表示されます (成功した型には部分的な結果が返されます)。

UIP Maestro ケース レジストリのリスト

キャッシュされたすべてのリソースを種類別にグループ化して一覧表示します。ネットワークにヒットしません — 最後にキャッシュされた pull を反映します。 pull 最初に (またはもう一度) 実行して更新します。

オプション

長押し	値 (Value)	説明
--local	フラグ	テナント全体のキャッシュではなく、ソリューション内の兄弟リソースのみを一覧表示します。「 概念」をご覧ください。

例

uip maestro case registry list

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

{
  "Result": "Success",
  "Code": "ResourceListSuccess",
  "Data": {
    "ResourcesCount": 128,
    "Local": false,
    "ResourceTypes": [
      { "Type": "typecache-activities", "Count": 80 },
      { "Type": "typecache-triggers", "Count": 48 }
    ],
    "resources": []
  }
}

--local ソリューションを解決し、そのリソースツリーを直接スキャンします(キャッシュは関与しません)。見つからないソリューション ( .uipx が見つからない) は、空のリストではなくクリーン エラーとして報告されます。

UIP Maestro ケース レジストリ Get

識別子で 1 つ以上の完全なリソース レコードを取得します。

引数

名前	Required	目的
<identifier>	○	リソースの entityKey (プロセス様型) または id (アクション アプリ) — 「 概念」で各種類の ID フィールドを確認します。--localでは、兄弟プロジェクトのリソース キーまたは.uipxプロジェクト ID を使用します。

オプション

Short	長押し	値 (Value)	説明
-t	--type <type>	ENUM	ルックアップを 1 つのリソースの種類 ( search --typeと同じセット) に制限します。
—	--connection-id <id>	string	コネクタ固有の Integration Service フィールドのメタデータ (カスタム フィールド) のコネクション ID。typecache-*アクティビティとトリガーの一致にのみ適用されます。
—	--local	フラグ	テナントのキャッシュではなく、ソリューション内の兄弟リソースを使用して解決します。「 概念」をご覧ください。

例

uip maestro case registry get a1b2c3d4-0000-0000-0000-000000000001

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

{
  "Result": "Success",
  "Code": "ResourceGetSuccess",
  "Data": {
    "MatchCount": 1,
    "Local": false,
    "Resources": [
      {
        "ResourceType": "typecache-activities",
        "Resource": {
          "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001",
          "name": "InvoiceParser"
        }
      }
    ]
  }
}

0 の一致は失敗 (Code-less エラー応答) であり、空の成功ではありません。エラーの Instructions はモードによって異なります。 --local が見逃す場合は、 で兄弟のリソース キーまたはプロジェクト ID を再確認する必要があります registry list --local。 --type solution ミスは、最初に pull --solution-id を実行することを提案します。それ以外のものは「リソースが見つかりませんでした」と報告するだけです。

UIP Maestro ケース レジストリ get-connector

一般的なリソース検索をバイパスして、単一のコネクタ アクティビティ/トリガー エントリ (およびそのコネクタ構成) をローカルの TypeCache インデックスから直接検索します。

オプション

Short	長押し	値 (Value)	Required	説明
-t	--type <type>	ENUM	○	TypeCache 検索するインデックスです。 typecache-activities、 typecache-triggers、 typecache-external-automation-activities、 typecache-external-automation-triggers、 typecache-external-agent-activities、または typecache-external-agent-triggersです。
—	--activity-type-id <id>	string	○	検索する uiPathActivityTypeId です。

例

uip maestro case registry get-connector --type typecache-activities --activity-type-id a1b2c3d4-0000-0000-0000-000000000001

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

{
  "Result": "Success",
  "Code": "ConnectorGetSuccess",
  "Data": {
    "Entry": {
      "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001",
      "name": "InvoiceParser"
    },
    "Config": { "connectorKey": "uipath-connector-a" }
  }
}

UIP Maestro ケース レジストリ get-connection

コネクタ アクティビティ/トリガーを検索し ( get-connectorと同じルックアップ)、利用可能な Integration Service のコネクションを取得します。

オプション

Short	長押し	値 (Value)	Required	説明
-t	--type <type>	ENUM	○	get-connectorと同じ TypeCache インデックスの選択肢。
—	--activity-type-id <id>	string	○	検索する uiPathActivityTypeId です。

例

uip maestro case registry get-connection --type typecache-activities --activity-type-id a1b2c3d4-0000-0000-0000-000000000001

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

{
  "Result": "Success",
  "Code": "ConnectionGetSuccess",
  "Data": {
    "Entry": { "uiPathActivityTypeId": "a1b2c3d4-0000-0000-0000-000000000001" },
    "Config": { "connectorKey": "uipath-connector-a" },
    "Connections": [
      { "id": "b2c3d4e5-0000-0000-0000-000000000001", "name": "Default" }
    ]
  }
}

タスクの入力を変数にバインドする

ケース管理の JSON スキーマ ファイルを直接編集することで、タスクの入力をリテラル値/式または別のタスクの出力に関連付けます。フィールド参照: ドット区切りの <field-path> (<input-name>[.<key1>[.<key2>...]] でのタスクの入力です。ドットは直接 input.value されません。各ドット セグメントは 1 つのプロパティ レベルを横断します。例:コネクタ アクティビティの入れ子になった要求本文の body.body.body) は、リテラル文字列、プレフィックスが許可された式 (=vars.、 =bindings.、 =js:、 =metadata.、 =datafabric.、 =orchestrator.JobAttachments、 =response、 =result、 =Error、 =jsonString:)、あるいは別のタスクの出力を取得する場合に生成された=vars.<id>式のいずれかを取ります。caseplan.jsonのタスクの入力を直接編集してこれらのいずれかを設定し、 を実行しますuip maestro case validate <file>。

関連

• UIP Maestro のケース — 概要とケース管理サブシステムの残りの部分

参照

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