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.

Se a solução já existir no Studio Web (correspondente pelo SolutionId dentro de seu .uipx), o upload substituirá a cópia existente; caso contrário, ele será importado como uma nova solução e o ID retornado será gravado de volta no .uipx local, para que os carregamentos subsequentes sejam atualizados no local.

Resumo

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 — Ignore a verificação de existência e substitua a solução do Studio Web nomeada pelo incluído SolutionId diretamente. Normalmente não necessário — um upload substitui uma solução de nuvem existente por conta própria. 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

Carregar um arquivo.uipx específico

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

Substituir sem um instantâneo restaurável

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

Scripting — abra o URL do designer retornado

URL=$(uip solution upload ./my-solution --output-filter "Data.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": { }
  }
}

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": { }
  }
}

• 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 não aprovado --no-snapshot). Ausente em uma nova importação, pois não há nada para capturar instantâneo.
• Response carga de resposta bruta do Studio Web. Útil para depuração; não faz parte de um contrato estável.

efeitos colaterais

• As associações sincronizam-se. Antes de carregar, upload verifica novamente bindings_v2.json de cada projeto e reconcilia as declarações de recurso da solução, equivalente à execução de uip solution resources refresh.
• Conexão substituições. Após o upload, quaisquer substituições de conexão detectadas no diretório resources/solution_folder/connection/ da solução são corrigidas no Studio Web para a pasta Espaço de Trabalho Pessoal do usuário autenticado. As falhas aqui são registradas como avisos e não causam falhas no comando.
• Write-back do IdDaSolução. Em um novo upload, o ID da solução retornado substitui (ou preenche) o campo SolutionId no .uipx local.

Comandos relacionados

• uip solution pack + uip solution publish — pipeline de implantação alternativo para upload.
• uip solution delete — remova uma solução do Studio Web por seu SolutionId.
• uip solution init — estrutura uma solução antes de carregá-la.

Veja também

• Autenticação — upload requer uma sessão ativa.
• uip solution visão geral.