uip or queue-roi

Syntax and options for `uip or queue-roi`, which manages the Business ROI configuration of an Orchestrator queue.

uip or queue-roi manages the Business ROI configuration of a queue: the manual time a human spends per item, the item volume, the employee cost, and the cost per item. Each queue has at most one ROI configuration. For the same configuration on a process, refer to uip or process-roi.

For the cross-resource conventions (auth, folder scoping, key types, output envelope), refer to the uip or overview.

注:

Every verb needs the OR.BusinessValue scope on the login, the BusinessValue folder permission that matches the verb (View, Create, Edit, or Delete), and the Business ROI feature enabled on the tenant.

概要

uip or queue-roi get     <queue> [--folder-path <path> | --folder-key <key>]
uip or queue-roi create  <queue> --manual-time <number> [value options] [--disabled] [--folder-path <path> | --folder-key <key>]
uip or queue-roi update  <queue> [value options] [--no-volume] [--no-employee-cost] [--no-cost-per-item] [--enabled | --disabled] [--folder-path <path> | --folder-key <key>]
uip or queue-roi delete  <queue> --yes [--folder-path <path> | --folder-key <key>]

動詞

動詞	目的
get	Get the ROI configuration of a queue. Reports Configured: false when none exists.
create	Create the ROI configuration of a queue. Fails when one exists.
update	Update the ROI configuration of a queue. Values you do not pass keep their current setting.
delete	Delete the ROI configuration of a queue.

引数

Every verb takes the same positional argument.

名前	Required	目的
<queue>	○	Queue name or key (GUID). A name needs --folder-path or --folder-key when it exists in more than one folder you can see. Find queues with uip or queues list.

フォルダーのオプション

Every verb accepts these options. They scope a name lookup and are not needed for a key.

Short	長押し	値 (Value)	既定 (Default)	説明
—	--folder-path	パス	—	Folder path the queue name is looked up in (for example, Shared).
—	--folder-key	GUID	—	Folder key the queue name is looked up in.

uip or queue-roi get

Get the ROI configuration of a queue. When the queue has no ROI configuration, the command succeeds with Configured: false.

例

uip or queue-roi get InvoiceQueue --folder-path Shared
uip or queue-roi get a1b2c3d4-0000-0000-0000-000000000010
uip or queue-roi get a1b2c3d4-0000-0000-0000-000000000010 \
    --output-filter 'Configured'

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

{
  "Code": "QueueRoiGet",
  "Data": {
    "QueueKey": "a1b2c3d4-0000-0000-0000-000000000010",
    "QueueName": "InvoiceQueue",
    "Folder": "Shared",
    "Configured": true,
    "Key": "e5f6a7b8-0000-0000-0000-000000000001",
    "Enabled": true,
    "ManualTimePerItem": 12,
    "ManualTimeUnit": "Minutes",
    "ProcessVolume": 4000,
    "ProcessVolumePeriod": "Month",
    "EmployeeCost": 65000,
    "EmployeeCostPeriod": "Annual",
    "ManualCostPerItem": null,
    "Currency": "Usd"
  }
}

A queue with no ROI configuration returns only QueueKey, QueueName, Folder, and Configured: false.

フィールド	説明
Key	Key of the ROI configuration.
Enabled	Whether ROI tracking is on for the queue.
ManualTimePerItem / ManualTimeUnit	Manual time a human spends per item, and its unit.
ProcessVolume / ProcessVolumePeriod	Items processed per period. null when not set.
EmployeeCost / EmployeeCostPeriod	Fully loaded employee cost, in USD, over the period. null when not set.
ManualCostPerItem	Manual cost per item, in USD. null when not set, in which case the Orchestrator UI computes it from the other values.
Currency	Currency of the cost values.

uip or queue-roi create

Create the ROI configuration of a queue. Requires --manual-time. Fails when the queue already has an ROI configuration; use update to change it.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
—	--manual-time	whole number, 0 or more	必須	Manual time a human spends per item, in --time-unit.
—	--time-unit	SecondsMinutes、Hours	Minutes	Unit of --manual-time.
—	--volume	whole number, 0 or more	—	Items processed per --volume-period.
—	--volume-period	Day、Week、Month、Year	Month when --volume is set	Period --volume is measured over. Requires --volume.
—	--employee-cost	number, 0 or more, up to 4 decimals	—	Fully loaded cost of the employee doing the work, in USD, over --cost-period.
—	--cost-period	Annual, Hourly	Annual when --employee-cost is set	Period --employee-cost is expressed over. Requires --employee-cost.
—	--cost-per-item	number, 0 or more, up to 4 decimals	—	Manual cost per item, in USD. When omitted, the Orchestrator UI computes it from the other values.
—	--disabled	フラグ	無効	Create the configuration with ROI tracking off (the UI's "not applicable").

Orchestrator applies upper limits configured on the tenant. By default, the limits are 10,000 for --manual-time, 10,000,000 for --volume and --employee-cost, and 100,000 for --cost-per-item.

例

uip or queue-roi create InvoiceQueue --folder-path Shared --manual-time 12

uip or queue-roi create a1b2c3d4-0000-0000-0000-000000000010 \
    --manual-time 12 --time-unit Minutes \
    --volume 4000 --volume-period Month \
    --employee-cost 65000 --cost-period Annual

uip or queue-roi create a1b2c3d4-0000-0000-0000-000000000010 \
    --manual-time 0 --disabled --output-filter 'Key'

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

Code: "QueueRoiCreated", with the same Data fields as get.

uip or queue-roi update

Update the ROI configuration of a queue. Values you do not pass keep their current setting. Pass at least one value option, --enabled, --disabled, or a --no-* option. Fails with ErrorCode: "not_found" when the queue has no ROI configuration; use create first.

オプション

update accepts the value options of create, all optional and without defaults. When you set --volume or --employee-cost without a period, the stored period is kept, or the create default is used when none is stored. It also accepts:

Short	長押し	値 (Value)	既定 (Default)	説明
—	--no-volume	フラグ	—	Clear the stored volume and its period.
—	--no-employee-cost	フラグ	—	Clear the stored employee cost and its period.
—	--no-cost-per-item	フラグ	—	Clear the manual cost per item, so the Orchestrator UI computes it again.
—	--enabled	フラグ	—	Turn ROI tracking on. Mutually exclusive with --disabled.
—	--disabled	フラグ	—	Turn ROI tracking off. Mutually exclusive with --enabled.

例

uip or queue-roi update InvoiceQueue --folder-path Shared --volume 5000

uip or queue-roi update a1b2c3d4-0000-0000-0000-000000000010 \
    --employee-cost 45 --cost-period Hourly --no-cost-per-item

uip or queue-roi update a1b2c3d4-0000-0000-0000-000000000010 \
    --disabled --output-filter 'Enabled'

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

Code: "QueueRoiUpdated", with the same Data fields as get.

uip or queue-roi delete

Delete the ROI configuration of a queue. Requires -y, --yes — the CLI never prompts for destructive operations.

オプション

Short	長押し	値 (Value)	既定 (Default)	説明
-y	--yes	フラグ	—	Required. Confirms the deletion.

例

uip or queue-roi delete a1b2c3d4-0000-0000-0000-000000000010 --yes

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

{
  "Code": "QueueRoiDeleted",
  "Data": {
    "QueueKey": "a1b2c3d4-0000-0000-0000-000000000010",
    "QueueName": "InvoiceQueue",
    "Folder": "Shared",
    "Status": "Deleted"
  }
}

終了コード

Refer to Exit codes for the shared contract. Verb-specific behavior:

• update exits 3 (ValidationError) when no value option is passed.
• create and update exit 3 when --volume-period is passed without --volume, when --cost-period is passed without --employee-cost, or when --enabled and --disabled are both passed.
• update exits 1 with ErrorCode: "not_found" when the queue has no ROI configuration.
• delete exits 1 if -y, --yes is omitted.

関連コマンド

• uip or queues — find queue names and keys.
• uip or process-roi — the Business ROI configuration of a process.

参照

• uip orの概要—すべてのuip or動詞に共通する規則。