UIP ou pacotes

Sintaxe e opções para "uip or package", que gerencia artefatos de automação ".nupkg" carregados para um feed do Orchestrator.

uip or packages manages the automation packages (.nupkg artifacts) uploaded to an Orchestrator feed. list, get, and entry-points are tenant-scoped and need no folder context; versions, upload, and download additionally accept --folder-path/--folder-key to target a folder-scoped feed instead of the tenant feed. Use uip or processes to bind a package to a folder as a runnable process. Packages packed with --output-type Library belong to uip or libraries instead.

Resumo

uip or packages <verb> [options]

Verbo

Texto	Finalidade
list	Listar pacotes no feed.
get	Busca uma versão de pacote por chave.
versions	Lista todas as versões de um pacote.
entry-points	Listar pontos de entrada do fluxo de trabalho (com esquemas de entrada/saída) para uma versão do pacote.
upload	Carregue um .nupkg no feed.
delete	Delete a package version from the feed.
download	Baixe um .nupkg a partir do feed.

lista de uip ou pacotes

Listar pacotes no feed. Retorna a chave da versão do pacote (formato PackageId:Version), título, versão e metadados.

Opções

Short	Long	Valor	Padrão	Description
-s	--search	text	—	Pesquise pacotes por nome.
—	--feed-id	GUID	Feed do tenant	Segmente um feed específico. feeds list para descobrir IDs.
—	--all-fields	Bandeira	desativada	Retorna a carga útil da API completa.
-l	--limit	Número	50	Tamanho da página
—	--offset	Número	0	Ignorar contagem.
—	--sort-by	Campo	Id desc	Classificação OData.

Exemplos

uip or packages list
uip or packages list --search Invoice --limit 20
uip or packages list --output-filter 'Data[].{id:Id, v:Version}'

Formato dos dados (--output json)

{
  "Code": "PackageList",
  "Data": [
    {
      "Key": "InvoiceProcessing:1.0.2",
      "Title": "InvoiceProcessing",
      "Version": "1.0.2",
      "Description": "",
      "IsLatestVersion": true,
      "IsActive": true,
      "PackageType": "Process",
      "TargetFramework": "Windows",
      "Authors": "Finance Team",
      "Published": "2025-04-10T08:00:00Z",
      "Id": "InvoiceProcessing"
    }
  ],
  "Pagination": { "Returned": 1, "Limit": 50, "Offset": 0, "HasMore": false }
}

uip ou pacotes obter

Busca uma versão específica do pacote. O formato da chave é PackageId:Version.

Argumentos

Name	Required	Finalidade
<key>	sim	Chave da versão do pacote (por exemplo, MyProcess:1.0.0).

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Segmente um feed específico.
—	--all-fields	Bandeira	desativada	Retorna a carga útil da API completa.

Exemplos

uip or packages get InvoiceProcessing:1.0.2
uip or packages get InvoiceProcessing:1.0.2 --all-fields
uip or packages get InvoiceProcessing:1.0.2 --output-filter 'Data.ReleaseNotes'

Formato dos dados (--output json)

{
  "Code": "PackageGet",
  "Data": {
    "Key": "InvoiceProcessing:1.0.2",
    "Title": "InvoiceProcessing",
    "Version": "1.0.2",
    "Description": "Processes vendor invoices",
    "IsLatestVersion": true,
    "IsActive": true,
    "PackageType": "Process",
    "TargetFramework": "Windows",
    "Authors": "Finance Team",
    "Published": "2025-04-10T08:00:00Z",
    "ReleaseNotes": "Fix amount rounding bug",
    "Id": "InvoiceProcessing"
  }
}

versões do uip ou dos pacotes

Lista todas as versões de um pacote. Use isso antes de chamar processes create --package-version.

Argumentos

Name	Required	Finalidade
<package-id>	sim	ID do pacote (por exemplo, MyProcess).

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Segmente um feed específico.
—	--folder-path	Path	Feed do tenant	Target a folder-scoped feed by path instead of the tenant feed.
—	--folder-key	GUID	Feed do tenant	Target a folder-scoped feed by key instead of the tenant feed.
—	--all-fields	Bandeira	desativada	Retorna a carga útil da API completa em vez do resumo selecionado.
-l	--limit	Número	50	Tamanho da página
—	--offset	Número	0	Ignorar contagem.
—	--sort-by	Campo	Id desc	Classificação OData.

Exemplos

uip or packages versions InvoiceProcessing
uip or packages versions InvoiceProcessing --limit 5
uip or packages versions InvoiceProcessing \
    --output-filter 'Data[?IsLatestVersion].Version | [0]'

# From a folder-scoped feed instead of the tenant feed
uip or packages versions InvoiceProcessing --folder-path "Shared"

Formato dos dados (--output json)

{
  "Code": "PackageVersionList",
  "Data": [
    {
      "Key": "InvoiceProcessing:1.0.2",
      "Title": "InvoiceProcessing",
      "Version": "1.0.2",
      "Description": "",
      "IsLatestVersion": true,
      "IsActive": true,
      "PackageType": "Process",
      "TargetFramework": "Windows",
      "Authors": "Finance Team",
      "Published": "2025-04-10T08:00:00Z",
      "Id": "InvoiceProcessing"
    }
  ]
}

pontos de entrada de uip ou pacotes

Listar pontos de entrada do fluxo de trabalho para uma versão do pacote, incluindo esquemas de argumentos de entrada/saída. Use o caminho do ponto de entrada com processes create --entry-point para pacotes com vários pontos de entrada.

Argumentos

Name	Required	Finalidade
<key>	sim	Chave da versão do pacote (por exemplo, MyProcess:1.0.0).

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Segmente um feed específico.

Exemplos

uip or packages entry-points InvoiceProcessing:1.0.2
uip or packages entry-points InvoiceProcessing:1.0.2 \
    --output-filter 'Data[].Path'
uip or packages entry-points InvoiceProcessing:1.0.2 --output table

Formato dos dados (--output json)

{
  "Code": "PackageEntryPoints",
  "Data": [
    {
      "UniqueId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Path": "Main.xaml",
      "DisplayName": "Main",
      "InputArguments": "{\"invoicePath\":\"String\"}",
      "OutputArguments": "{\"result\":\"String\"}"
    }
  ]
}

upload de uip ou pacotes

Upload a process .nupkg package to the feed. After upload, bind it to a folder with uip or processes create. A package packed with --output-type Library is rejected before upload — use uip or libraries upload, or --force to put it in the processes feed anyway.

Argumentos

Name	Required	Finalidade
<file>	sim	O caminho para o arquivo .nupkg.

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Carregue para um feed específico.
—	--folder-path	Path	Feed do tenant	Upload to a folder-scoped feed by path instead of the tenant feed.
—	--folder-key	GUID	Feed do tenant	Upload to a folder-scoped feed by key instead of the tenant feed.
—	--force	Bandeira	false	Upload a library package to the processes feed anyway.

Exemplos

uip or packages upload ./InvoiceProcessing.1.0.3.nupkg
uip or packages upload ./dist/MyProcess.2.0.0.nupkg --feed-id a1b2c3d4-0000-0000-0000-000000000001
uip or packages upload ./InvoiceProcessing.1.0.3.nupkg --output-filter 'Data[0].body'

# Upload to a folder-scoped feed instead of the tenant feed
uip or packages upload ./InvoiceProcessing.1.0.3.nupkg --folder-path "Shared"

Formato dos dados (--output json)

{
  "Code": "PackageUploaded",
  "Data": [
    {
      "key": "InvoiceProcessing.1.0.3.nupkg",
      "status": "Created",
      "body": "InvoiceProcessing:1.0.3"
    }
  ]
}

uip or packages delete

Delete a package version from the Orchestrator processes feed. Deleting a package a process is bound to leaves that process without a version to run.

Argumentos

Name	Required	Finalidade
<key>	sim	Package version key (format PackageId:Version, for example MyProcess:1.0.0). Use packages list or packages versions to find it.

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Delete from a specific feed.
—	--folder-path	Path	Feed do tenant	Delete from a folder-scoped feed by path instead of the tenant feed.
—	--folder-key	GUID	Feed do tenant	Delete from a folder-scoped feed by key instead of the tenant feed.
-y	--yes	Bandeira	—	Required. Confirm this irreversible operation — the CLI never prompts.

Exemplos

uip or packages delete InvoiceProcessing:1.0.3 --yes

Formato dos dados (--output json)

{
  "Code": "PackageDeleted",
  "Data": {
    "Key": "InvoiceProcessing:1.0.3",
    "FeedId": "",
    "Status": "Package deleted"
  }
}

FeedId is always present — an empty string means the tenant feed. A folder-scoped delete adds FolderKey and FolderPath to Data.

Download do uipath ou dos pacotes

Baixe um .nupkg a partir do feed. Requer --destination.

Argumentos

Name	Required	Finalidade
<key>	sim	Chave da versão do pacote (por exemplo, MyProcess:1.0.0).

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Segmente um feed específico.
—	--folder-path	Path	Feed do tenant	Target a folder-scoped feed by path instead of the tenant feed.
—	--folder-key	GUID	Feed do tenant	Target a folder-scoped feed by key instead of the tenant feed.
-d	--destination	Path	necessário	Onde salvar o .nupkg baixado.

Exemplos

uip or packages download InvoiceProcessing:1.0.2 \
    --destination ./InvoiceProcessing.1.0.2.nupkg

uip or packages download InvoiceProcessing:1.0.2 -d /tmp/ip.nupkg \
    --feed-id a1b2c3d4-0000-0000-0000-000000000001

uip or packages download InvoiceProcessing:1.0.2 -d ./ip.nupkg \
    --output-filter 'Data.SavedTo'

Formato dos dados (--output json)

{
  "Code": "PackageDownloaded",
  "Data": {
    "Key": "InvoiceProcessing:1.0.2",
    "SavedTo": "./InvoiceProcessing.1.0.2.nupkg",
    "Size": "512000 bytes"
  }
}

Códigos de saída

Consulte Códigos de saída. Nenhuma substituição específica do verbo.

Comandos relacionados

• uip or processes — associe um pacote a uma pasta como um processo.
• uip or feeds — descubra IDs de feed disponíveis.
• uip or jobs — especialmente jobs start, que usa a chave de processo (não a chave do pacote) de processes list.

Veja também

• Opções globais.