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.

Overwrite or import

Before uploading, the command checks whether Studio Web holds a solution with the SolutionId from the .uipx (or from the .uis archive):

• 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.

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 — Skip the existence check and overwrite the Studio Web solution named by the bundled SolutionId directly. An upload overwrites an existing cloud solution without it. Fails if that solution does not exist. No effect when no SolutionId is bundled (a .uis archive without one): the upload imports as new.
• --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 "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 — present and true only on an overwrite that recorded a restorable pre-overwrite version (that is, without --no-snapshot). Absent on a fresh import and with --no-snapshot.
• Response — carga útil de respuesta de Studio Web sin procesar. Útil para depurar; no forma parte de un contrato estable.

Efectos secundarios

• Resource preparation. For a solution directory or .uipx file, upload prepares the solution's resources the same way as uip solution pack: it syncs each project's bindings_v2.json into the solution's resource declarations, as uip solution resources refresh does, and writes what each project contributes onto its resources. An error that a project's tool reports fails the upload. A .uis file is uploaded as-is, without this step.
• 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

When bundling a solution directory, upload always leaves out .venv, node_modules, __pycache__, .git, .local, and .flow-sdk folders, and dotenv files (.env, .env.local, .env.production, and 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 fallo

• A project uses a project.json manifest that Studio Web does not accept. Refused with invalid_argument. Convert the listed project to a project.uiproj manifest before uploading. uip solution pack and uip solution publish accept 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.

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 .