proyectos de soluciones de uip

Sintaxis y opciones para `proyectos de solución de UIP`, que gestiona los proyectos enumerados en un manifiesto de solución `.uipx`, además de la publicación y sincronización de proyectos en la nube.

uip solution projects los proyectos enumerados dentro de un manifiesto de solución .uipx : procesos RPA, pruebas, agentes, flujos de Maestro, proyectos de casos y BPMN, aplicaciones codificadas, funciones, flujos de trabajo de API y otros tipos de proyectos construibles. Una biblioteca no es un proyecto : publícala por sí misma y luego adjúntala a uip solution resources add --source remote --kind Library.

Nota:

Este grupo se documentó anteriormente como project (singular). La forma singular sigue funcionando (se mantiene registrada como un alias oculto y obsoleto para la retrocompatibilidad), pero projects es canónico en el futuro.

Subcomando	Propósito
add	Registra una carpeta de proyecto que ya viva dentro del directorio de la solución.
import	Copia una carpeta de proyecto externo en el directorio de la solución y luego regístrala.
remove	Cancela el registro de un proyecto de .uipx (no elimina archivos en el disco).
list	Enumera los proyectos registrados en el .uipxlocal.
publish	Publicar un proyecto de solución en la nube como paquete de soluciones.
resync	Sincroniza o restablece un proyecto de solución en la nube .

add, import, remove y list operan solo en archivos locales, no se requiere autenticación. publish y resync operan en un proyecto de solución en la nube y requieren una sesión activa.

Sinopsis

uip solution projects add <project-path> [solutionFile]
uip solution projects import <source> [--solutionFile <path>]
uip solution projects remove <project-path> [solutionFile]
uip solution projects list [--solution-folder <path>]
uip solution projects publish --project-name <name> --package-name <name> --package-version <version> [--folder-name <name>] [--description <text>] [--release-notes <text>] [-t <tenant-name>]
uip solution projects resync [project-name] [--project-name <name>] [--sync-option <Sync|Reset>] [-t <tenant-name>]

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

Comportamiento común (añadir/importar/eliminar)

• La carpeta del proyecto de destino debe contener un descriptor project.uiproj, heredado project.json o uipath.json . El comando detecta automáticamente cuál.
• Cuando se omite [solutionFile] , el comando busca hacia arriba desde la ruta del proyecto (o el directorio actual, para import) el .uipx más cercano. Si no se encuentra ninguno, o si hay varios archivos .uipx en la misma carpeta, el comando falla y sale con 1.
• Se genera un Id único (UUID) para cada entrada de proyecto añadida al manifiesto.

---

Añadir

Registra una carpeta de proyecto que ya resida dentro del directorio de la solución. La ruta relativa de la carpeta del proyecto se .uipx en y se aprovisiona una entrada coincidente en el creador de recursos interno de la solución.

Argumentos

• <project-path> obligatorio) : ruta a la carpeta del proyecto. Debe contener project.uiproj, project.json o uipath.json.
• (opcional) : ruta al manifiesto .uipx [solutionFile] Si se omite, el .uipx más cercano se encuentra subiendo desde <project-path>.

Ejemplos

uip solution projects add ./my-solution/my-project ./my-solution/my-solution.uipx

# Auto-detect the .uipx
uip solution projects add ./my-solution/my-project

Forma de datos (--json de salida)

{
  "Code": "ProjectAdd",
  "Data": {
    "Status": "Added successfully",
    "Project": "my-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Modos de fallo

• El proyecto está fuera de la carpeta de la solución. El comando rechaza la adición con un projects import a, que copia los proyectos externos.
• El proyecto ya está registrado. Sale con 1 y un mensaje que nombra la ruta del proyecto existente.

---

import

Copia una carpeta de proyecto externo en el directorio de la solución (conservando su nombre de carpeta) y, a continuación, regístrala en .uipx. Utilízalo cuando el proyecto que deseas incluir no esté ya en la raíz de la solución.

Argumentos

• <source> obligatorio) : ruta a la carpeta del proyecto externo a importar. Debe ser un directorio que contenga project.uiproj, project.json o uipath.json. Este es un argumento posicional, no un marcador : documentos anteriores en esta página lo mostraban como --source <path>, lo cual es incorrecto.

Opciones

Largo	Valor	Predeterminado	Descripción
--solutionFile	Ruta	más cercano .uipx por encima del directorio actual	Ruta al manifiesto de la solución .uipx.

Ejemplos

uip solution projects import ./external-project \
  --solutionFile ./my-solution/my-solution.uipx

# From inside the solution directory (auto-detect .uipx)
cd ./my-solution
uip solution projects import ../shared-library

Forma de datos (--json de salida)

{
  "Code": "ProjectImport",
  "Data": {
    "Status": "Imported successfully",
    "Project": "external-project/project.uiproj",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Modos de fallo y reversión

• La carpeta de destino ya existe. El comando se niega a sobrescribir; cambia el nombre de la carpeta de origen o elimina primero el destino existente.
• El proyecto ya está en el manifiesto .uipx . Rechazado antes de que se copie cualquier archivo.
• El paso de copiar, escribir o del creador falla. El comando se revierte: el directorio copiado se elimina y .uipx se restaura a su contenido original.

---

remove

Cancela el registro de un proyecto del manifiesto de la solución .uipx y elimina su entrada del creador de recursos interno. Los archivos del disco no se eliminan. Se niega a eliminar el último proyecto de una solución (un Projects[] vacío solo es válido inmediatamente después de init): la única excepción es un proyecto de un tipo no compatible, que siempre puede eliminarse para desbloquear pack.

Argumentos

• <project-path> obligatorio) : ruta a la carpeta del proyecto a eliminar. Debe estar registrado actualmente en .uipx.
• (opcional) : ruta al manifiesto .uipx [solutionFile] El valor predeterminado es el .uipx más cercano encontrado al subir desde <project-path>.

Ejemplos

uip solution projects remove ./my-solution/my-project ./my-solution/my-solution.uipx

Forma de datos (--json de salida)

{
  "Code": "ProjectRemove",
  "Data": {
    "Status": "Removed successfully",
    "Project": "my-project",
    "Solution": "/workspace/my-solution/my-solution.uipx"
  }
}

Modos de fallo

• El proyecto está fuera de la carpeta de la solución. La ruta relativa no debe comenzar con ...
• El proyecto no está en el manifiesto. Sale con 1 y la ruta relativa utilizada para buscar.
• El proyecto es el único que queda en la solución. Rechazado a menos que sea de un tipo de proyecto no compatible.

---

Lista

Enumera los proyectos registrados en el manifiesto de la solución local .uipx. Solo lee metadatos en disco, sin llamada de backend.

Opciones

Largo	Valor	Predeterminado	Descripción
--solution-folder	Ruta	directorio actual	Ruta a la carpeta raíz de la solución.

Ejemplos

uip solution projects list

Forma de datos (--json de salida)

{
  "Code": "SolutionProjectsList",
  "Data": [
    {
      "Name": "MyProject",
      "Type": "Process",
      "Id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "ProjectRelativePath": "MyProject/project.uiproj",
      "ProjectFilePath": "/workspace/my-solution/MyProject/project.uiproj"
    }
  ]
}

---

Publicar

Publica un proyecto de solución en la nube (uno que ya viva en Automation Cloud, no un proyecto .uipx local) como paquete de solución y espera a que se complete la operación de publicación.

Opciones

Largo	Valor	Predeterminado	Descripción
--project-name	text	—	Obligatorio. Nombre del proyecto de solución en la nube que se publicará.
--package-name	text	—	Obligatorio. Nombre del paquete de soluciones que se va a crear.
--package-version	text	—	Obligatorio. Versión del paquete de soluciones que se va a crear.
--folder-name	text	—	Nombre de la carpeta raíz que se almacenará en el paquete de soluciones.
--description	text	—	Descripción del paquete de soluciones.
--release-notes	text	—	Notas de la versión del paquete de soluciones.
-t, --tenant	name	sesión predeterminada	tenant.
--timeout	segundos	360	Tiempo de espera de sondeo de publicación.
--poll-interval	ms	5000	Milisegundos entre las encuestas de estado de publicación.
--login-validity	minutos	10	Minutos mínimos antes de la caducidad del token para desencadenar una actualización.

Ejemplos

uip solution projects publish --project-name MyProject \
  --package-name my-package --package-version 1.0.0 \
  --folder-name MySolution

Forma de datos (--json de salida)

{
  "Code": "SolutionProjectPublish",
  "Data": {
    "ProjectName": "MyProject",
    "PackageName": "my-package",
    "PackageVersion": "1.0.0",
    "Status": "Completed"
  }
}

---

Resincronizar

Sincronice o restablezca un proyecto de solución en la nube y espere a que se complete la operación. Sync reconcilia el proyecto con su origen; Reset descarta los cambios en la nube local.

Argumentos

• [project-name] opcional) : nombre del proyecto de solución en la nube para sincronizar. También se puede proporcionar con --project-name; proporcionar a ambos valores diferentes es un error.

Opciones

Largo	Valor	Predeterminado	Descripción
--project-name	text	—	Nombre del proyecto de solución en la nube para sincronizar (alternativa al argumento posicional).
--sync-option	Sync | Reset	Sync	Qué operación de sincronización ejecutar.
-t, --tenant	name	sesión predeterminada	tenant.
--timeout	segundos	360	Tiempo de espera de sondeo de sincronización.
--poll-interval	ms	5000	Milisegundos entre encuestas de estado de sincronización.
--login-validity	minutos	10	Minutos mínimos antes de la caducidad del token para desencadenar una actualización.

Ejemplos

uip solution projects resync --project-name MyProject --sync-option Sync

# Positional form, reset instead of sync
uip solution projects resync MyProject --sync-option Reset

Forma de datos (--json de salida)

{
  "Code": "SolutionProjectResync",
  "Data": {
    "ProjectName": "MyProject",
    "Status": "Successful",
    "SyncOption": "Sync",
    "SyncErrors": []
  }
}

En caso de fallo, Instructions enumera cada error de sincronización por nombre de servicio y claves de recurso afectadas.

---

Comandos relacionados

• uip solution init : aplica andamios a la solución antes de añadir proyectos.
• uip solution resources refresh — volver a sincronizar los recursos después de editar las vinculaciones del proyecto.
• uip solution pack — empaqueta la solución una vez finalizada su lista de proyectos.

Ver también

• Tu primer proceso : ejemplo de extremo a extremo.
• Información generaluip solution .