Carga de la solución UIP

Sintaxis y opciones para `carga de solución de UIP`, que agrupa una solución local y la envía a Studio Web para su edición basada en navegador.

uip solution upload una solución local a UiPath Studio Web para la edición basada en el navegador. Empaqueta la solución en un archivo .uis interno, la envía a Studio Web y (en caso de éxito) imprime una URL que puedes abrir directamente en el diseñador.

A diferencia de uip solution pack + uip solution publish, que producen un .zip implementable para Orchestrator, upload se dirige a la superficie de creación interactiva de Studio Web . Utilízalo cuando quieras seguir editando una solución de forma colaborativa en el navegador.

Si la solución ya existe en Studio Web (coincide con SolutionId dentro de su .uipx), la carga sobrescribe la copia existente; de lo contrario, se importa como una nueva solución y el ID devuelto se vuelve a escribir en el .uipx local para que las cargas posteriores se actualicen en su lugar.

Sinopsis

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

El comando respeta las opciones globales y devuelve los códigos de salida estándar.

Argumentos

• <solutionPath> (requerido) — Uno de:
  • Un directorio de soluciones que contiene un manifiesto .uipx (el más común).
  • Un archivo.uipx (el comando resuelve el directorio que lo contiene).
  • Un archivo.uis (un archivo de solución preempaquetado; cargado tal cual para compatibilidad con versiones anteriores).

Opciones

• --force — Omite la comprobación de existencia y sobrescribe la solución de Studio Web nombrada por el SolutionId incluido directamente. Normalmente no es necesario: una carga sobrescribe una solución en la nube existente por sí misma. Falla si esa solución no existe. Sin efecto cuando no se incluye SolutionId (un archivo .uis sin uno): la carga se importa como nueva.
• --no-snapshot — No grabes una versión restaurable previa a la sobrescritura de la solución en la nube antes de reemplazar su contenido. Los cambios realizados en Studio Web desde la última carga se pierden; los archivos locales no se ven afectados. No tiene efecto cuando la carga importa una nueva solución.
• --login-validity <minutes> — Minutos mínimos antes de la caducidad del token para desencadenar una actualización. El valor predeterminado es 10.

Ejemplos

Mínimo

uip solution upload ./my-solution

Cargar un archivo.uipx específico

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

Sobrescribir sin una instantánea restaurable

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

Creación de scripts: abre la URL del diseñador devuelta

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

Forma de datos (--json de salida)

Studio Web no tiene solución con el SolutionId incluido, por lo que se importa como nuevo y el .uipx local se actualiza con el ID asignado:

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

La solución ya existe en Studio Web, por lo que se sobrescribe en su lugar, con los contenidos reemplazados grabados primero como una versión restaurable:

{
  "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" en una primera carga, "Overwritten" cuando ya existía una solución con SolutionId en Studio Web.
• SolutionId : la identidad asignada por Studio Web (en la primera carga) o coincidente (en la sobrescritura). También se vuelve a escribir en el .uipx local para que el siguiente upload actualice la misma solución.
• DesignerUrl: URL lista para abrir para el primer proyecto de la solución, con ámbito previo a la solución. null/ausente cuando Studio Web no devuelve un ID de proyecto.
• LocalSolutionIdUpdated: presente solo cuando se volvió a escribir un SolutionId nuevo en el .uipx local (Path, From, To). Ausente cuando se sobrescribe en el lugar o cuando la fuente de carga no tenía una identificación anterior para reescribir.
• SnapshotCreated: presente y true solo en una sobrescritura que registró una versión restaurable previa a la sobrescritura (es decir no aprobado --no-snapshot). Ausente en una nueva importación, ya que no hay nada que capturar.
• Response — carga útil de respuesta de Studio Web sin procesar. Útil para depurar; no forma parte de un contrato estable.

Efectos secundarios

• Sincronización de vinculaciones. Antes de cargar, upload vuelve a escanear bindings_v2.json de cada proyecto y concilia las declaraciones de recursos de la solución, equivalente a ejecutar uip solution resources refresh.
• La conexión se sobrescribe. Después de la carga, cualquier sobrescritura de conexión detectada en el directorio resources/solution_folder/connection/ de la solución se parchea en Studio Web en la carpeta Espacio de trabajo personal del usuario autenticado. Los fallos aquí se registran como advertencias y no fallan el comando.
• Reescritura de SolutionId. En una nueva carga, el ID de solución devuelto reemplaza (o rellena) el campo SolutionId en el .uipx local.

Comandos relacionados

• uip solution pack + uip solution publish — alternativa de proceso de implementación a upload.
• uip solution delete — elimina una solución de Studio Web por su SolutionId.
• uip solution init : aplica andamios a una solución antes de cargarla.

Ver también

• Autenticación : upload requiere una sesión activa.
• Información generaluip solution .