validação de fluxo do uip Maestro

Sintaxe e opções para o "uip Maestro flow validate", que valida um arquivo ".flow" em relação ao esquema e políticas de governança opcionais.

uip maestro flow validate valida um arquivo .flow em relação ao esquema de fluxo com verificações estrutural de campos cruzados. Uma aprovação --governance opcional também valida nós de agente em relação às políticas de governança de sua organização.

Resumo

uip maestro flow validate <flowFile> [--governance] [--strict-bindings] [--strict-expressions]

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

Argumentos

• <flowFile> (necessário) — caminho para o arquivo .flow ou um diretório do projeto contendo um.

Opções

• --governance validem também nós de agente em relação às políticas de governança da organização. Requer uip login; a CLI busca enforcements e o modelNames permitido da plataforma antes de executar a verificação. Se a busca falhar, o comando falhará — omita --governance para ignorar as verificações de política.
• --strict-bindings — falha na validação quando um nó HTTP gerenciado (core.action.http.v2) carrega um rótulo em forma de conector, mas nenhuma vinculação do Integration Service. Padrão: somente warning — omitir este sinalizador ainda executa a verificação, apenas não gera falha na compilação.
• --strict-expressions — falham na validação quando uma expressão ou corpo de script tem um erro de tipo, de acordo com o mesmo verificador de expressões que a tela usa. Padrão: somente alerta. Essa verificação com acesso de CI sempre é executada; o sinalizador controla apenas se suas descobertas são fatais.

Comportamento

• A validação de esquema é executada localmente e não requer login.
• As verificações estruturados garantem que as referências entre nós, bordas, associações, variáveis e definições sejam consistentes.
• Com --governance, qualquer nó de agente cuja configuração (modelo, ferramentas, políticas) entre em conflito com as aplicações buscadas é sinalizado.

Exemplos

# Structural validation only (no login required)
uip maestro flow validate invoice-flow.flow

# Full validation including governance policy for agent nodes
uip maestro flow validate invoice-flow.flow --governance

Formato dos dados (--output json)

No sucesso:

{
  "Code": "FlowValidate",
  "Data": {
    "File": "invoice-flow.flow",
    "Status": "Valid"
  }
}

Na falha de validação, o comando sai de diferente de zero e retorna um resultado Failure com detalhes de erro em Message / Instructions.

Observação:

A forma exata da carga de falha (lista por erro, caminhos, IDs de regras) pode evoluir com versões. Para scripts que analisam os detalhes da falha programaticamente, execute uma validação conhecida uma vez com --output json para capturar a forma atual e fixar @uipath/cli no CI.

Veja também

• uip maestro flow debug — validação dinâmica por meio do Studio Web
• uip maestro flow pack — empacotar um projeto validado
• Visão geral do fluxo