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.

Overwrite or import​

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 skips the existence check and overwrites directly. If Studio Web has no solution with that SolutionId, the command fails with not_found and uploads nothing; re-run without --force to import as new.

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.
  • SolutionId write-back. On an import, the returned solution ID replaces (or populates) the SolutionId field in the 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).

To leave out more files, add a .uipignore file at the solution root, in a project folder, or both. The syntax is gitignore: one pattern per line, # for comments, globs such as *.log, anchored paths such as /dist, a trailing / for directories only, and ! to re-include. Patterns in a project's .uipignore match relative to that project folder and apply only to it. An unreadable .uipignore is skipped with a warning.

A pattern that would leave out the manifest of a project listed in the .uipx (for example *.uiproj, or the project's folder name) is refused: the command fails with invalid_argument and names the project. Remove or narrow the pattern, or remove the project from the solution with uip solution projects remove, then upload again.

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 with a SolutionId that Studio Web does not hold. Refused with not_found; nothing is uploaded.

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