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 gerencia os pacotes de automação (artefatos .nupkg) carregados em um feed do Orchestrator. list, get e entry-points têm o escopo de tenant e não precisam de contexto de pasta; versions, upload e download também aceitam --folder-path/--folder-key para segmentar um feed com escopo de pasta em vez do feed do tenant. Use uip or processes para vincular um pacote a uma pasta como um processo executável. Os pacotes empacotados com --output-type Library pertencem a uip or libraries em vez disso.

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	Exclua uma versão de pacote do 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	Segmente um feed com escopo de pasta por caminho em vez do feed do tenant.
—	--folder-key	GUID	Feed do tenant	Segmente um feed com escopo de pasta por chave em vez do feed do tenant.
—	--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

Carregue um pacote de processo .nupkg no feed. Após o upload, associe-a a uma pasta com uip or processes create. Um pacote empacotado com --output-type Library é rejeitado antes do upload — use uip or libraries upload ou --force para colocá-lo no feed de processos de qualquer maneira.

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	Carregue para um feed com escopo de pasta por caminho em vez do feed do tenant.
—	--folder-key	GUID	Feed do tenant	Carregue para um feed com escopo de pasta por chave em vez do feed do tenant.
—	--force	Bandeira	false	Carregue um pacote de biblioteca no feed de processos de qualquer maneira.

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"
    }
  ]
}

exclusão de uip ou pacotes

Exclua uma versão de pacote do feed de processos do Orchestrator. A exclusão de um pacote ao qual um processo está associado deixa esse processo sem uma versão para executar.

Argumentos

Name	Required	Finalidade
<key>	sim	Chave da versão do pacote (formato PackageId:Version, por exemplo, MyProcess:1.0.0). Use packages list ou packages versions para encontrá-lo.

Opções

Short	Long	Valor	Padrão	Description
—	--feed-id	GUID	Feed do tenant	Excluir de um feed específico.
—	--folder-path	Path	Feed do tenant	Excluir de um feed com escopo de pasta por caminho em vez do feed do tenant.
—	--folder-key	GUID	Feed do tenant	Excluir de um feed com escopo de pasta por chave em vez do feed do tenant.
-y	--yes	Bandeira	—	Obrigatório. Confirme esta operação irreversível — a CLI nunca solicita.

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 está sempre presente — uma string vazia significa o feed do tenant. Uma exclusão com escopo de pasta adiciona FolderKey e FolderPath a 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	Segmente um feed com escopo de pasta por caminho em vez do feed do tenant.
—	--folder-key	GUID	Feed do tenant	Segmente um feed com escopo de pasta por chave em vez do feed do tenant.
-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.