uip or processes

「uip or processes」の構文とオプション - Orchestrator内の実行可能なプロセスへのパッケージのフォルダー バインドを管理します。

uip or processes は、パッケージの実行可能なフォルダーへのバインド (Orchestrator の内部では「リリース」) を管理します。プロセスは、uip or jobs startが目標とするものです。パッケージは、基になる.nupkg成果物です (uip or packagesを参照)。

概要

uip or processes <verb> [options]

動詞

動詞	目的
list	フォルダー内のプロセスのリストを取得します。
get	引数スキーマと保持期間を含むキーで 1 つのプロセスを取得する
resources	プロセスに必要なパッケージ リソース (キュー、アセット、バケット、コネクション) を一覧表示します。
version-history	プロセスのパッケージバージョンの履歴を時系列で一覧表示します。
create	パッケージを新しいプロセスとしてフォルダーにバインドします。
update-version	1 つ以上のプロセスを最新の (または特定の) パッケージ バージョンにバンプします。
update (エイリアス edit)	プロセスの設定を更新します (選択したフィールドにセマンティクスをパッチします)。
delete	プロセスをキーで削除します (パッケージは削除されません)。
rollback	プロセスを以前のパッケージ バージョンにロールバックします。

uip or processes list

フォルダー内のプロセスのリストを取得します。--folder-path または --folder-keyが必要です。プロセス キー (GUID)、名前、バージョン、および基本メタデータを返します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	—	パスによるターゲット フォルダー
—	--folder-key	GUID	—	キーによるターゲット フォルダー。
—	--all-folders	フラグ	無効	テナント全体のコンポーネント。--folder-path/--folder-keyと相互に排他的です。
-n	--name	text	—	プロセス名に一致する値を含む。
—	--process-type	ENUM	—	Process、 Agent、 Flow、 TestAutomationProcess、 WebApp、 Api、 MCPServer、 BusinessRules、 CaseManagement、 Function。
—	--all-fields	フラグ	無効	完全な API ペイロードを返します。
-l	--limit	Number	50	ページ サイズ
—	--offset	Number	0	カウントをスキップします。
—	--sort-by	フィールド	Id desc	OData の並べ替え。

例

uip or processes list --folder-path "Shared"
uip or processes list --folder-path "Shared" --process-type Agent
uip or processes list --folder-path "Shared" \
    --output-filter 'Data[].{key:Key, name:Name, v:ProcessVersion}'

# Tenant-wide audit across every folder
uip or processes list --all-folders --name "Invoice"

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

{
  "Code": "ProcessList",
  "Data": [
    {
      "Key": "c3d4e5f6-0000-0000-0000-000000000001",
      "Name": "InvoiceProcessing",
      "ProcessKey": "InvoiceProcessing",
      "ProcessVersion": "1.0.2",
      "Description": "",
      "IsLatestVersion": true,
      "RetentionPeriod": 30,
      "RetentionAction": "Delete"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}

FolderId は、 --all-folders が使用されている場合にのみ各行に追加されます。

uip or processes get

GUID キーで 1 つのプロセスを取得します。バージョン、エントリ ポイント、入力/出力引数のスキーマ、プロセスの種類、および設定を返します。フォルダー コンテキストは不要 — キーはフォルダーをまたいで解決されます。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。[ processes list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--all-fields	フラグ	無効	完全な API ペイロードを返します。

例

uip or processes get c3d4e5f6-0000-0000-0000-000000000001
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 --all-fields
uip or processes get c3d4e5f6-0000-0000-0000-000000000001 \
    --output-filter 'Data.InputArguments'

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

{
  "Code": "ProcessGet",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000001",
    "Name": "InvoiceProcessing",
    "ProcessKey": "InvoiceProcessing",
    "ProcessVersion": "1.0.2",
    "Description": "Processes vendor invoices",
    "IsLatestVersion": true,
    "ProcessType": "Process",
    "EntryPointPath": "Main.xaml",
    "InputArguments": "{\"invoicePath\":\"String\"}",
    "FolderKey": "a1b2c3d4-0000-0000-0000-000000000001",
    "FolderPath": "Shared",
    "AutoUpdate": false,
    "TargetFramework": "Windows",
    "JobPriority": "Normal",
    "SpecificPriorityValue": 50,
    "RetentionPeriod": 30,
    "RetentionAction": "Delete",
    "StaleRetentionPeriod": 0,
    "StaleRetentionAction": "None",
    "HiddenForAttendedUser": false,
    "AutoCreateConnectedTriggers": false
  }
}

UIP またはプロセス リソース

プロセスで参照されているパッケージ リソース (キュー、アセット、バケット、コネクション、その他のパッケージ要件) を一覧表示します。プロセスのフォルダーを自動的に解決します。フォルダー フラグは必要ありません。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。[ processes list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--all-fields	フラグ	無効	選定された概要ではなく、完全な API ペイロードを返します。

例

uip or processes resources c3d4e5f6-0000-0000-0000-000000000001
uip or processes resources c3d4e5f6-0000-0000-0000-000000000001 --all-fields

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

{
  "Code": "ProcessResources",
  "Data": [
    {
      "ResourceType": "Queue",
      "ResourceName": "InvoiceQueue",
      "FolderPath": "Shared",
      "ValidationResult": "Success",
      "ValidationError": "",
      "IsOverwritable": true,
      "ResourceKey": "InvoiceQueue",
      "ResourceId": "123456",
      "Id": 0
    }
  ]
}

uip またはプロセスのバージョン履歴

プロセスに関連付けられたパッケージとバージョンの履歴を時系列で一覧表示します。フォルダーは任意です。指定しない場合は、プロセス キーから推論されます。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--folder-key	GUID	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--all-fields	フラグ	無効	選定された概要ではなく、完全な API ペイロードを返します。

例

uip or processes version-history c3d4e5f6-0000-0000-0000-000000000001

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

{
  "Code": "ProcessVersionHistory",
  "Data": [
    {
      "Version": "1.0.0",
      "CreatedAt": "2024-01-10T08:30:00.000Z",
      "ReleaseName": "InvoiceProcessing",
      "ReleaseId": 101,
      "Id": 1001
    },
    {
      "Version": "1.0.2",
      "CreatedAt": "2024-01-15T09:45:00.000Z",
      "ReleaseName": "InvoiceProcessing",
      "ReleaseId": 101,
      "Id": 1002
    }
  ]
}

uip or processes create

パッケージをプロセスとしてフォルダーにバインドします。--folder-path または --folder-key 個と、3 つの必須パッケージ オプションが必要です。パッケージ キーには [ uip or packages list ] を使用し、利用可能なバージョンには [ uip or packages versions ] を使用します。

オプション

Required

Short	長押し	値 (Value)	既定 (Default)	説明
—	--name	text	—	フォルダー内のプロセス名。
—	--package-key	text	—	パッケージ キー (packages listPackageId) です。
—	--package-version	version	—	パッケージ バージョン (例: 1.0.0

ID とスコープ

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	—	パスによるターゲット フォルダー
—	--folder-key	GUID	—	キーによるターゲット フォルダー。

プロセスの設定

Short	長押し	値 (Value)	既定 (Default)	説明
—	--description	text	—	プロセスの説明。
—	--entry-point	パス	—	エントリ ポイントのワークフロー パス (マルチエントリ ポイント パッケージの場合)
—	--input-arguments	JSON	—	既定の入力引数は JSON です。
—	--job-priority	ENUM	—	Low、 Normal、 Highです。--specific-priorityと相互に排他的です。
—	--specific-priority	1–100	—	優先度の数値。--job-priorityと相互に排他的です。
—	--robot-size	ENUM	—	Cloud ロボットのサイズ: Small、Standard、Medium、Large
—	--tags	CSV	—	コンマ区切りのタグ名。
—	--environment-variables	text	—	改行で区切られた KEY=VALUE ペアとしての環境変数 (JSON ではない)、例:$'FOO=bar\nBAZ=qux'です。
—	--auto-update / --no-auto-update	フラグ	—	最新のパッケージ バージョンへの自動更新を有効化/無効化します。
—	--hidden-for-attended / --visible-for-attended	フラグ	—	有人オートメーションのユーザーに表示しないでほしい相互に排他的です。
—	--auto-create-triggers / --no-auto-create-triggers	フラグ	—	デプロイ時に接続トリガーを自動作成

retention

Short	長押し	値 (Value)	既定 (Default)	説明
—	--retention-period	日(1〜180)	30	ジョブの保持期間。
—	--retention-action	ENUM	Delete	Delete、 Archive、または Noneのいずれかです。
—	--retention-bucket	バケット ID	—	ストレージ バケット ID。--retention-action Archive時に必須です。
—	--stale-retention-period	日	—	古いジョブの保持期間。
—	--stale-retention-action	ENUM	—	Delete、 Archive、または Noneのいずれかです。

例

uip or processes create --folder-path "Shared" \
    --name "InvoiceProcessing" \
    --package-key InvoiceProcessing --package-version 1.0.2

uip or processes create --folder-path "Production/EU" \
    --name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
    --job-priority High --auto-update --tags "finance,eu"

uip or processes create --folder-path "Shared" \
    --name "InvoiceProcessing" --package-key InvoiceProcessing --package-version 1.0.2 \
    --output-filter 'Data.Key'

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

{
  "Code": "ProcessCreated",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000010",
    "Name": "InvoiceProcessing",
    "ProcessKey": "InvoiceProcessing",
    "ProcessVersion": "1.0.2",
    "Description": "",
    "IsLatestVersion": true,
    "RetentionPeriod": 30,
    "RetentionAction": "Delete"
  }
}

uip or processes update-version

1 つ以上のプロセスを最新のパッケージ バージョンに更新するか、 --package-versionを使用して特定のバージョンに更新します。フォルダーは任意です — 指定しない場合は、最初のプロセス キーから推論されます。

• 1 つのキー + --package-version →なし、最新に更新 (単一の API 呼び出し)。
• 1 つのキー + --package-version → つのバージョンへの更新 (単一の API 呼び出し)。
• 複数のキー + --package-version →なし、最新の状態に一括更新。
• 複数のキー + --package-version →拒否 (検証エラー)

実行中のジョブは影響を受けません。更新されたバージョンを使用するのは新しいジョブのみです。

引数

名前	Required	目的
<process-keys...>	○	1 つ以上のプロセス キー (GUID)。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--folder-key	GUID	推論	自動検出をスキップしてこのフォルダーを使用します。
—	--package-version	version	—	特定のバージョン。単一のキーでのみ有効です。

例

uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001

uip or processes update-version c3d4e5f6-0000-0000-0000-000000000001 \
    --package-version 1.0.3

uip or processes update-version \
    c3d4e5f6-0000-0000-0000-000000000001 \
    c3d4e5f6-0000-0000-0000-000000000002 \
    --output-filter 'Data.Version'

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

シングルキー:

{
  "Code": "ProcessVersionUpdated",
  "Data": { "ProcessKey": "c3d4e5f6-…-000001", "Version": "latest" }
}

一括処理は、ProcessKeys、Version、および API からエコーされた Result オブジェクトを含むCode: "ProcessVersionsUpdated"を返します。

UIP またはプロセスの更新

プロセスの設定をキーで更新する。現在の値を読み込み、指定された PATCH フィールドを適用して保存します。指定したフィールドのみが変更されます。CLI で省略されたフィールドは、現在の状態から保持されます。フォルダー フラグは不要です。このキーはクロスフォルダーを解決します。

edit はこの動詞の登録済みエイリアスです。 uip or processes edit と同じように機能します uip or processes updateです。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。

オプション

processes create つの必須パッケージ オプションとスコープ フラグ以外はフィールドと同じです。相互排除ルールと検証ルールが一致している create (--job-priority と --specific-priorityの比較、 --hidden-for-attended と --visible-for-attended、保持期間 Archive --retention-bucket)。

Short	長押し	値 (Value)	既定 (Default)	説明
-n	--name	text	—	新しい表示名。
-d	--description	text	—	新しい説明。
—	--entry-point	パス	—	新しいエントリ ポイント パス。
—	--input-arguments	JSON	—	既定の入力引数です。
—	--environment-variables	text	—	改行で区切られた KEY=VALUE ペア (JSON ではない)。''を渡すとクリアされます。
—	--job-priority	ENUM	—	Low、 Normal、 Highです。
—	--specific-priority	1–100	—	優先度の数値。
—	--auto-update / --no-auto-update	フラグ	—	自動更新を切り替えます。
—	--hidden-for-attended / --visible-for-attended	フラグ	—	有人シナリオの表示。
—	--auto-create-triggers / --no-auto-create-triggers	フラグ	—	接続トリガーによる自動作成
—	--healing-agent / --no-healing-agent	フラグ	—	このプロセスで Healing Agent (Autopilot for Robots) を有効化または無効化します。有効化すると、今後のジョブで既定で使用されます。テナント レベルの Autopilot がすでにオンになっている必要があります。
—	--retention-period	日(1〜180)	—	ジョブの保持期間。
—	--retention-action	ENUM	—	Delete、 Archive、 Noneです。
—	--retention-bucket	バケット ID	—	--retention-action Archive時に必須です。
—	--stale-retention-period	日	—	古いジョブの保持期間。
—	--stale-retention-action	ENUM	—	Delete、 Archive、 Noneです。

例

uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
    --description "Monthly invoice batch"

uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
    --job-priority High --retention-period 60

uip or processes update c3d4e5f6-0000-0000-0000-000000000001 \
    --auto-update --output-filter 'Data.Status'

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

{
  "Code": "ProcessUpdated",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000001",
    "Name": "InvoiceProcessing",
    "Status": "Updated successfully"
  }
}

UIP またはプロセス 削除

キーによるプロセスのバインドを削除します。これにより、リリースのバインドがそのフォルダーから削除されます。基になるパッケージは削除 されません 。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。[ processes list] で検索します。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-y	--yes	フラグ	—	必須。この元に戻せない操作を確認します。CLI はプロンプトを表示しません。

例

uip or processes delete c3d4e5f6-0000-0000-0000-000000000001 --yes

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

{
  "Code": "ProcessDeleted",
  "Data": {
    "Key": "c3d4e5f6-0000-0000-0000-000000000001",
    "Name": "InvoiceProcessing",
    "ProcessKey": "InvoiceProcessing",
    "Status": "Deleted successfully"
  }
}

uip or processes rollback

プロセスを以前のパッケージ バージョンにロールバックします。フォルダーは任意です — 指定しない場合は、プロセス キーから推測されます。

引数

名前	Required	目的
<process-key>	○	プロセス キー (GUID)。

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	推論	自動検出をスキップします。
—	--folder-key	GUID	推論	自動検出をスキップします。

例

uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
    --folder-path "Shared"
uip or processes rollback c3d4e5f6-0000-0000-0000-000000000001 \
    --output-filter 'Data.Status'

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

{
  "Code": "ProcessRolledBack",
  "Data": {
    "ProcessKey": "c3d4e5f6-0000-0000-0000-000000000001",
    "Status": "Rolled back to previous version"
  }
}

終了コード

「終了コード」を参照してください。標準の検証エラーを超える動詞固有のオーバーライドはありません。

関連コマンド

• uip or packages — processes createを呼び出す前に、パッケージキー ( 、packages list)、 バージョン ( 、packages versions)、およびエントリポイント (packages entry-points) を検索します。
• uip or jobs — 特に jobs startはプロセス キーを受け取ります。
• uip or folders — バインドする前にターゲット フォルダーを作成または検索します。

参照

• グローバル オプション。
• セッション。