UiPath Documentation
uipath-cli
latest
false
Guia do usuário da UiPath CLI
Importante :
Este conteúdo foi traduzido com auxílio de tradução automática. A localização de um conteúdo recém-publicado pode levar de 1 a 2 semanas para ficar disponível.

upload de solução uip

Sintaxe e opções para o "upload de solução uip", que agrupa uma solução local e a envia para o Studio Web para edição no navegador.

uip solution upload carrega uma solução local no UiPath Studio Web para edição no navegador. Ele agrupa a solução em um arquivo .uis interno, a envia para o Studio Web e (em caso de sucesso) imprime um URL que você pode abrir diretamente no designer.

Ao contrário de uip solution pack + uip solution publish, que produzem um .zip implantável para o Orchestrator, upload tem como alvo a superfície de criação do Studio Web . Use isso quando você quiser continuar editando uma solução de forma colaborativa no navegador.

Substituir ou importar​

Antes de fazer o upload, o comando verifica se o Studio Web contém uma solução com o SolutionId do .uipx (ou do arquivo .uis ):

  • The solution exists. It is overwritten in place. The replaced contents are first recorded as a restorable version, unless you pass --no-snapshot. Data.Action is Overwritten.
  • The solution does not exist. The upload is imported as a new solution, and the ID that Studio Web assigns is written back into the local .uipx so the next upload overwrites the same solution. Data.Action is Imported.

--force a verificação de existência e sobrescreve diretamente. Se o Studio Web não tiver solução com esse SolutionId, o comando falhará com not_found e não carregará nada; execute novamente sem --force para importar como novo.

Resumo​

uip solution upload <solutionPath> [--force] [--no-snapshot] [--login-validity <minutes>]
uip solution upload <solutionPath> [--force] [--no-snapshot] [--login-validity <minutes>]

O comando honra as opções globais e retorna os códigos de saída padrão.

Argumentos​

  • <solutionPath> (necessário) — Um de:
    • Um diretório de solução que contém um manifesto .uipx (mais comum).
    • Um arquivo.uipx (o comando resolve o diretório que o contém).
    • Um arquivo.uis (um arquivo de solução pré-incluído; carregado como está para compatibilidade com versões anteriores).

Opções​

  • — --force a verificação de existência e substitua a solução do Studio Web nomeada pelo SolutionId incluído diretamente. Um upload substitui uma solução de nuvem existente sem ele. Falha se essa solução não existir. Nenhum efeito quando nenhum SolutionId está agrupado (um arquivo .uis sem um): o upload é importado como novo.
  • --no-snapshot — Não registre uma versão pré-substituída restaure da solução de nuvem antes de substituir seu conteúdo. As alterações feitas no Studio Web desde o último upload são perdidas; locais não são afetados. Nenhum efeito quando o upload importa uma nova solução.
  • --login-validity <minutes> Minutos mínimos antes da expiração do token para disparar uma atualização. O padrão é 10.

Exemplos​

Mínimo​

uip solution upload ./my-solution
uip solution upload ./my-solution

Carregar um arquivo.uipx específico​

uip solution upload ./workspace/my-solution/my-solution.uipx
uip solution upload ./workspace/my-solution/my-solution.uipx

Substituir sem um instantâneo restaurável​

uip solution upload ./my-solution --no-snapshot
uip solution upload ./my-solution --no-snapshot

Scripting — abra o URL do designer retornado​

URL=$(uip solution upload ./my-solution --output-filter "DesignerUrl" --output plain)
open "$URL"   # macOS
URL=$(uip solution upload ./my-solution --output-filter "DesignerUrl" --output plain)
open "$URL"   # macOS

Formato dos dados (--output json)​

O Studio Web não tem solução com o SolutionId incluído, portanto, ele é importado como novo, e o .uipx local é atualizado com o ID atribuído:

{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Imported",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "LocalSolutionIdUpdated": {
      "Path": "/workspace/my-solution/my-solution.uipx",
      "From": "00000000-0000-0000-0000-0000000000ff",
      "To": "a1b2c3d4-0000-0000-0000-000000000001"
    },
    "Response": { }
  }
}
{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Imported",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "LocalSolutionIdUpdated": {
      "Path": "/workspace/my-solution/my-solution.uipx",
      "From": "00000000-0000-0000-0000-0000000000ff",
      "To": "a1b2c3d4-0000-0000-0000-000000000001"
    },
    "Response": { }
  }
}

A solução já existe no Studio Web, portanto, foi substituída no local, com o conteúdo substituído gravado primeiro como uma versão restaurável:

{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Overwritten",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "SnapshotCreated": true,
    "Response": { }
  }
}
{
  "Code": "SolutionUpload",
  "Data": {
    "Status": "Uploaded successfully",
    "Action": "Overwritten",
    "SolutionId": "a1b2c3d4-0000-0000-0000-000000000001",
    "DesignerUrl": "https://cloud.uipath.com/myorg/mytenant/studio_/designer/p1?solutionId=a1b2c3d4-0000-0000-0000-000000000001",
    "SnapshotCreated": true,
    "Response": { }
  }
}
  • Action — "Imported" em um primeiro upload, "Overwritten" quando uma solução com isso SolutionId já existia no Studio Web.
  • SolutionId — a identidade que o Studio Web atribuiu (no primeiro upload) ou correspondeu (na substituição). Também gravado de volta no .uipx local, para que o próximo upload atualize a mesma solução.
  • DesignerUrl — URL pronta para abrir para o primeiro projeto na solução, pré-com escopo para a solução. null/absent quando o Studio Web não retorna um ID de projeto.
  • LocalSolutionIdUpdated — presente apenas quando um SolutionId novo foi escrito de volta no local .uipx (Path, From, To). Ausente ao substituir no local ou quando a origem de carregamento não tinha ID anterior para regravar.
  • SnapshotCreated — presente e true apenas em uma substituição que registrou uma versão pré-substituição restaurável (ou seja, sem --no-snapshot). Ausente em uma nova importação e com --no-snapshot.
  • Response carga de resposta bruta do Studio Web. Útil para depuração; não faz parte de um contrato estável.

efeitos colaterais​

  • Preparação de recursos. Para um diretório de solução ou arquivo .uipx , upload prepara os recursos da solução da mesma forma que uip solution pack: ele sincroniza bindings_v2.json de cada projeto nas declarações de recursos da solução, como uip solution resources refresh faz, e escreve o que cada projeto contribui em seus recursos. Um erro que a ferramenta de um projeto relata falha no upload. Um arquivo .uis é carregado como está, sem essa etapa.
  • Write-back do IdDaSolução. Em uma importação, o ID da solução retornado substitui (ou preenche) o campo SolutionId no local .uipx.

Files left out of the bundle​

Ao agrupar um diretório de soluções, upload sempre deixa de fora as pastas .venv, node_modules, __pycache__, .git, .local e .flow-sdk , e os arquivos dotenv (.env, .env.local, .env.production e similar).

Para excluir mais arquivos, adicione um arquivo .uipignore na raiz da solução, em uma pasta do projeto ou em ambos. A sintaxe é gitignore: um padrão por linha, # para comentários, global como *.log, caminhos ancorados como /dist, um / ao final para diretórios apenas e ! para incluir novamente. Os padrões em .uipignore um projeto correspondem a essa pasta do projeto e se aplicam apenas a ela. Um .uipignore ilegível é ignorado com um aviso.

Um padrão que deixaria de fora o manifesto de um projeto listado no .uipx (por exemplo, *.uiproj ou o nome da pasta do projeto) é recusado: o comando falha com invalid_argument e nomeia o projeto. Remova ou restrinja o padrão ou remova o projeto da solução com uip solution projects remove e, em seguida, carregue novamente.

Modos de falha​

  • Um projeto usa um manifesto project.json que o Studio Web não aceita. Recusado com invalid_argument. Converta o projeto listado em um manifesto project.uiproj antes de carregá-lo. uip solution pack e uip solution publish aceitam project.json.
  • A .uipignore pattern drops a listed project. Refused with invalid_argument, as described in Files left out of the bundle.
  • --force com um SolutionId que o Studio Web não contém. Recusado com not_found; nada será carregado.

Veja também​

Esta página foi útil?

Conectar

Precisa de ajuda? Suporte(opens in new window)

Quer aprender? Academia UiPath(opens in new window)

Tem perguntas? Fórum do UiPath(opens in new window)

Fique por dentro das novidades