Pacote de fluxo uip Maestro

Sintaxe e opções para o "uip Maestro Flow Pack", que empacota um diretório de projeto de fluxo em um ".nupkg" para a publicação do Orchestrator.

uip maestro flow pack empacota um diretório de projeto de fluxo em um arquivo .nupkg pronto para ser publicado no Orchestrator.

Resumo

uip maestro flow pack <projectPath> <outputPath> [-n <name>] [-v <version>] [--author <author>] [--description <text>] [--repository-url <url>] [--repository-commit <sha>] [--repository-branch <branch>] [--repository-type <type>] [--release-notes <text>] [--project-url <url>]

Recebe opções globais. Os códigos de saída seguem o contrato padrão.

Argumentos

• <projectPath> (obrigatório) — caminho para o diretório do projeto de fluxo (deve conter project.uiproj e pelo menos um arquivo .flow ).
• <outputPath> (necessário) — diretório de saída onde o .nupkg será escrito. Criado se não existir.

Opções

• -n, --name <name> nome do pacote. O padrão é o nome da pasta do projeto.
• -v, --version <version> — versão do pacote. O padrão é 1.0.0.

Opções de metadados de pacote (compartilhadas entre comandos de pacote)

Opção	Description
--author <author>	Autor do pacote.
--description <text>	Descrição do pacote.
--repository-url <url>	URL do repositório de origem, registrado no pacote para rastreabilidade.
--repository-commit <sha>	Hash de confirmação do repositório de origem.
--repository-branch <branch>	Ramificação do repositório de origem.
--repository-type <type>	Tipo de repositório de origem. O padrão é git quando --repository-url está definido.
--release-notes <text>	Notas de versão para o pacote.
--project-url <url>	URL da ideia do Automation Hub.

Exemplos

# Pack with defaults (name = folder, version = 1.0.0)
uip maestro flow pack ./invoice-flow ./dist

# Pack with an explicit version
uip maestro flow pack ./invoice-flow ./dist --version 1.2.0

# Override the package name
uip maestro flow pack ./invoice-flow ./dist --name Invoicing.Flow --version 1.2.0

Formato dos dados (--output json)

{
  "Code": "FlowPack",
  "Data": {
    "Package": "invoice-flow.1.2.0.nupkg",
    "Output": "./dist/invoice-flow.1.2.0.nupkg"
  }
}

Problema conhecido — Pacote de soluções

Quando um projeto de fluxo é adicionado a uma solução (uip solution projects add) e empacotado com uip solution pack, o .nupkg resultante dentro do zip da solução pode não conter arquivos críticos (.bpmn, .flow, entry-points.json, bindings_v2.json).

A causa raiz é um auxiliar copyFiles() não recursivo no @uipath/tool-flow publicado — ele ignora silenciosamente os subdiretórios content/ e flow_files/ . uip maestro flow pack usa uma cópia recursiva e não é afetado.

Solução alternativa: use uip maestro flow pack diretamente para produzir arquivos .nupkg implantáveis até que o pipeline da solução seja corrigido.

Veja também

• uip maestro flow init — estruturar o projeto primeiro
• uip maestro flow validate — validar antes do empacotamento
• Visão geral do fluxo