Acerca de la publicación de proyectos de automatización

Publicar un proyecto de automatización implica archivar la carpeta del proyecto de forma que esta se pueda enviar a Robots y ejecutarse después.

De forma predeterminada, todos los archivos de la carpeta del proyecto se publicarán excepto los casos de prueba. Si quieres evitar que un archivo en concreto se incluya en el paquete publicado, haz clic con el botón secundario en él en el panel Proyecto y luego selecciona Ignorar desde la publicación (no disponible para los archivos de flujo de trabajo en proyectos de biblioteca). En el caso de las bibliotecas, para evitar que un archivo de flujo de trabajo aparezca como componente reutilizable en el panel Actividades cuando la biblioteca publicada se instale en un proyecto, haz clic con el botón secundario en el panel Proyecto y luego selecciona Convertir en privado.

Puedes publicar proyectos de automatización en Orchestrator, una fuente personalizada de NuGet o localmente. Después de publicar en Orchestrator, el proyecto archivado se muestra en la página Paquetes y puedes crear un proceso que se distribuya en Robots. Cuando publiques un proceso de automatización en el Espacio de trabajo personal de Orchestrator o publiques casos de prueba, se crea un proceso automáticamente si no existe ninguno y los procesos existentes se actualizan automáticamente a la versión más reciente publicada.

Además, los proyectos de automatización pueden publicarse en una fuente personalizada de NuGet con la opción para añadir también una clave API si la fuente requiere autenticación.

La publicación de proyectos localmente requiere que proporciones una ruta de la máquina local, diferente a la ubicación en la que se publican los paquetes de procesos. Desde aquí, puedes enviar manualmente los paquetes a los Robots, para que puedan ejecutarse. La ubicación local predeterminada de la publicación es %ProgramData%\UiPath\Packages.

Para publicar un proyecto, los archivos project.json y design.json en la carpeta de proyecto no deben estar en una ubicación de solo lectura (por ejemplo, si el proyecto está bajo control de origen, los archivos deben comprobarse para su edición).

Puedes publicar proyectos desde Studio o desde la línea de comandos. Para actualizar las dependencias para varios proyectos y publicarlos todos a la vez, utiliza la Herramienta de actualización masiva de dependencias del proyecto.

Nota: otras aplicaciones de software pueden interferir con el proceso de publicación si las carpetas que comienzan con un punto (.) están ocultas y, por lo tanto, se ignoran al publicar.

Publicar proyectos desde Studio

Para publicar un proyecto, selecciona Publicar en la cinta de la pestaña Diseño de Studio.

Para publicar un proyecto de automatización:

1. Crea un proyecto nuevo en Studio.
2. En la pestaña de cinta de Diseño, haz clic en Publicar. Se abre la ventana Publicar. Ten en cuenta que la barra de título de la ventana cambia en función del contexto:
   • Proceso de publicación al publicar un proceso;
   • Publicar biblioteca al publicar un proyecto de biblioteca;
   • Publicar biblioteca de IU al publicar un proyecto de biblioteca de IU;
   • Publicar casos de prueba al publicar casos de prueba.
   • Publicar plantillas al publicar plantillas.
3. En la pestaña Propiedades del paquete:
   • Introduce un nombre para el paquete. La lista desplegable contiene hasta 5 de los nombres más recientes de los paquetes que has publicado con anterioridad.
   • En la sección Versión, consulta la Versión actual del proyecto y escribe una Nueva versión si es necesario. Marca la casilla Es versión preliminar para marcar la versión como alpha. Ten en cuenta que esto cambia automáticamente el esquema de la versión del proyecto a semántico. Al publicar una nueva versión del archivo localmente, asegúrate de que la ubicación personalizada no incluye ya un archivo con el mismo número de versión propuesto. Para más detalles sobre las versiones de los proyectos, consulta la página Sobre proyectos de automatización.
   • De forma opcional, utiliza la opción Icono de proyecto para definir un icono personalizado para el proyecto. Puedes buscar y seleccionar un archivo, o introducir una ruta o URL pública a un archivo jpeg, jpg o png, de hasta 1 MB de tamaño.

     Una vez publicado el proyecto, el icono se muestra de la siguiente manera:

     • En el caso de los procesos, en el Asistente junto al nombre del proceso, lo que facilita su identificación en la lista de procesos.
     • Para las plantillas, junto a la plantilla en Inicio (vista Backstage de Studio) > Plantillas.

     • Para las bibliotecas, junto al paquete en la sección Gestionar paquetes en Studio.

       Nota: El icono no es visible en Gestionar paquetes cuando se utiliza un archivo local para una biblioteca publicada en Orchestrator o en una fuente que no admite iconos integrados. En este caso, especifica el icono mediante una URL.
   • En la casilla Etiquetas del proyecto puedes añadir una o más etiquetas al proyecto, ya sea creando nuevas o reutilizando etiquetas ya definidas en Orchestrator. Hay dos tipos de etiquetas: etiquetas y propiedades (pares de valor clave). Las etiquetas se incluyen en el paquete publicado y ayudan a describir y categorizar los proyectos. Por ejemplo, pueden hacer referencia a la aplicación automatizada (una etiqueta Excel) o el departamento (una propiedad department:accounting de valor clave).
     Cuando comienzas a escribir, se sugieren coincidencias posibles de las etiquetas ya definidas y puedes reutilizar una seleccionándola del listado de coincidencias. Para una coincidencia de propiedad, la clave seguida del caracter :(dos puntos) aparece en pantalla primero, y los valores asociados aparecen una vez que selecciones la clave. Para añadir una nueva etiqueta una vez introduzcas el nombre, haz clic en la entrada con el signo más junto al nombre. Separar las strings con el carácter : (dos puntos) te permite añadir propiedades, mientras que las entradas que no contenga un : añaden etiquetas.
     Las etiquetas y las propiedades clave/valor tienen un límite de 256 caracteres. Los nombres de etiquetas no pueden contener estos caracteres: <, >, %, &, \, ?, /, :.

     Las etiquetas del proyecto se pueden aplicar automáticamente a los procesos en Orchestrator. Para obtener más información sobre el uso de etiquetas, consulta Organizar recursos con etiquetas en la guía de Orchestrator.

   • En el cuadro de texto Notas de versión, introduce los detalles sobre la versión y otra información pertinente. Las notas de la versión de los proyectos publicados pueden verse en la sección Paquetes de Orchestrator. Ten en cuenta que el campo Notas de la versión admite un máximo de 10 000 caracteres.

     
     

     

     
     
4. Haz clic en Siguiente.

   Si estás publicando una plantilla, la pestaña Información de plantilla se abre a continuación (paso 5). De lo contrario, continúa con el paso 6.

5. (Solo para las plantillas) En la pestaña Información de plantilla, proporciona la siguiente información y luego haz clic en Siguiente:
   • Nombre: el nombre de la plantilla.
   • Descripción: la descripción de la plantilla de la pestaña Plantillas.

   • Nombre del proyecto predeterminado: el nombre del proyecto predeterminado al crear un proyecto nuevo utilizando esta plantilla.

     Nota: evita utilizar signos de puntuación, caracteres de separación y caracteres no permitidos en los nombres de archivos. Estos caracteres pueden eliminarse del nombre predeterminado al utilizar la plantilla.

   • Descripción del proyecto predeterminado: la descripción del proyecto predeterminado al crear un proyecto nuevo utilizando esta plantilla.

     
     

     

     
     
6. En la pestaña Opciones de publicación, selecciona el lugar en el que deseas publicar el proyecto. Las opciones disponibles dependen del tipo de proyecto que estés publicando:

   • Para procesos (incluidos los proyectos de StudioX):

     • Fuente deprocesos de tenant de Orchestrator, Fuente del espacio de trabajo personal de Orchestrator y, si se selecciona una carpeta de primer nivel con una fuente de paquetes independiente o sus subcarpetas en el menú de carpetas en la barra de estado de Studio, la fuente de esa jerarquía de carpetas. Estas opciones están disponibles si Studio está conectado a Orchestrator. La fuente del espacio de trabajo personal de Orchestrator solo está disponible si tu usuario tiene la característica de espacio de trabajo personal activada en Orchestrator.

       Si se selecciona en Studio el Espacio de trabajo personal o una carpeta de una jerarquía con una fuente de paquetes independiente, la fuente de esa carpeta es la opción predeterminada. De lo contrario, la fuente del tenant es la opción predeterminada. Si ya publicaste un proyecto en la sesión actual, la última ubicación de publicación utilizada será la selección predeterminada hasta que cierres Studio o cambies la carpeta de Orchestrator desde la barra de estado de Studio.

     • Asistente (Valores predeterminados del Robot): ubicación predeterminada del paquete para el Robot y el Asistente, C:\ProgramData\UiPath\Packages. Los proyectos publicados aquí se muestran automáticamente en el Asistente. La opción no está disponible si Studio está conectado a Orchestrator.
     • Personaliza una URL de la fuente de NuGet personalizada o una carpeta local. La adición de una Clave API es opcional.

   • Para los casos de prueba:

     • Las mismas opciones que están disponibles para los procesos, con la excepción de la fuente de espacio de trabajo personal de Orchestrator.

   • Para las bibliotecas y las bibliotecas de IU:

     • Fuente de bibliotecas de tenant de Orchestrator o Fuente de bibliotecas compartidas de Orchestrator: disponible si Studio está conectado con Orchestrator. La opción disponible depende de si la fuente de las bibliotecas de tenant está habilitada en Orchestrator.
     • Personaliza una URL de la fuente de NuGet personalizada o una carpeta local. La adición de una Clave API es opcional.

   • Para las plantillas:

     • Fuente de bibliotecas de tenant de Orchestrator o Fuente de bibliotecas compartidas de Orchestrator: disponible si Studio está conectado con Orchestrator. La opción disponible depende de si la fuente de las bibliotecas de tenant está habilitada en Orchestrator.
     • Local: la ubicación para publicar las plantillas localmente, por defecto: C:\Users\User\Documents\UiPath\.templates.

     • Personaliza una URL de la fuente de NuGet personalizada o una carpeta local. La adición de una Clave API es opcional.

   Si publicas una biblioteca o cualquier proyecto con la compatibilidad de Windows o multiplataforma que no sea una plantilla, habrá configuraciones adicionales disponibles en la pestaña Opciones de publicación en Configuración de compilación:

   • (solo para las bibliotecas) Categoría raíz de actividades: introduce un nombre para la categoría con la que se muestra el componente reutilizable en el panel Actividades.
   • (Solo para las bibliotecas de Windows) Compilar las expresiones de las actividades: selecciona esta opción para compilar y empaquetar todas las expresiones de las actividades. Esta acción mejora el tiempo de ejecución.

   • (Para Windows - solo bibliotecas heredadas) Listo para ejecutar: selecciona esta opción para optimizar los conjuntos generados para una compilación JIT más rápida en tiempo de ejecución.

     Nota: para descubrir qué puede impedir que una biblioteca se publique correctamente, lee sobre las limitaciones a la hora de publicar bibliotecas.
     
     

     

     
     
7. Haz clic en Siguiente para avanzar a la pestaña Firma de certificado o Publicar para publicar el proyecto.
8. (Opcional) En la pestaña Firma de certificado , agrega una Ruta de certificado local junto al cuadro Certificado . Además, añade la Contraseña del certificado y una marca de tiempo de certificado opcional si es necesario. Para obtener más información, consulta la página de firma de paquetes .
   
   

   

   
   

   Nota: Actualmente, se aceptan las extensiones de certificado.pfx y.p12 para la firma de proyectos.
9. Haz clic en Publicar. Se creará así un archivo NUPKG y se cargará en Orchestrator, la fuente NuGet personalizada, o se guardará en el directorio local. En el caso de las bibliotecas, si la opción Configuración del proyecto Separar dependencias de Runtime está habilitada, se crean dos archivos NUPKG: un archivo es el paquete de tiempo de diseño utilizado en Studio y el otro archivo es el paquete de tiempo de ejecución utilizado por el UiPath Robot al ejecutar la automatización. En función del proyecto, el paquete contendrá lo siguiente:
   • Para proyectos de plantilla y procesos con la compatibilidad Windows (heredado), los archivos de origen del proyecto.
   • Para bibliotecas y proyectos con la compatibilidad de Windows o multiplataforma, archivos DLL compilados.
10. Si el proyecto se publica con éxito, se muestra el cuadro de diálogo Info y el proyecto se copia en la ubicación NuGet establecida en el parámetro NuGetServerUrl, del archivo UiPath.settings.

Aparece el cuadro de diálogo de Información:

• El nombre con el que se publicó el paquete.
• El número de versión en la que se publicó el paquete;
• La ubicación donde se publicó el proyecto si se publicó localmente o en el Almacén predeterminado de los Robots. Haz clic en la ruta para ir al paquete, excepto si la ubicación de publicación era Orchestrator.
• La opción Detalles que amplía una lista con los nombres de los archivos del proyecto que se han publicado.

• La opción Copiar en el portapapeles.

  
  

  

  
  

Información añadida durante la publicación, como la ubicación de la publicación se mantiene en la ventana, para que pueda utilizarse para acciones posteriores realizadas para el mismo tipo de proyecto. Cada vez que haces clic en Publicar se crea una nueva versión del proyecto y se envía a la fuente de paquetes. La publicación en una fuente segura puede ser autenticada a través de la Clave del Robot, las credenciales de Orchestrator, la autenticación de Windows o la clave API.

Importante: Los proyectos publicados no deben desempaquetarse. Para realizar cualquier cambio, abre el archivo .xaml inicial en Studio, realiza los cambios y luego publica el proyecto de nuevo.

Publicar proyectos desde la línea de comandos

Puedes publicar proyectos utilizando el comando UiPath.Studio.CommandLine.exe.

UiPath.Studio.CommandLine.exe está disponible en la carpeta de instalación:

• Para instalaciones por máquina, la ruta por defecto es C:\Program Files\UiPath\Studio\.
• Para instalaciones por usuario, la ruta por defecto es %localappdata%\Programs\UiPath\Studio\.

Los siguientes argumentos están disponibles para el comando de publicación:

Argumento	Descripción
-p, --project-path	La ruta al project.json que va a publicarse. El argumento es obligatorio.
-g, --target	Dónde publicar el proyecto: Personalizado: la URL personalizada o la carpeta local. Define la ubicación mediante el argumento -f, --feed. UiPath Robot: ubicación de publicación predeterminada para el UiPath Robot, si no está conectado a Orchestrator. No disponible para publicar bibliotecas o plantillas. TenantDeOrchestrator: fuente de procesos de tenant de Orchestrator (para procesos y casos de prueba) o fuente de las bibliotecas de Orchestrator (para bibliotecas y plantillas). CarpetaPersonalOrchestrator: Fuente del espacio de trabajo personal de Orchestrator. No disponible para publicar bibliotecas, plantillas o casos de prueba. JerarquíaDeCarpetasDeOrchestrator: si se selecciona una carpeta de primer nivel con una fuente de paquetes independiente o una de sus subcarpetas en el menú de carpetas de la barra de estado de Studio, aparecerá la fuente para esa jerarquía de carpetas. No disponible para publicar bibliotecas o plantillas.
-f, --feed	La URL personalizada para publicar el proyecto. También puede ser un directorio local personalizado, similar a la ruta de la pestaña Opciones de publicación de Studio.
-a, --api-key	La clave API para publicar el proyecto. Este argumento puede utilizarse para un destino personalizado.
-i, --icon	Ruta al icono personalizado para el paquete.
-n, --notes	Las notas de la versión que contienen cambios introducidos en el proyecto.
-v, --new-version	La nueva versión para el proyecto. Si no se proporciona, la versión se incrementa automáticamente.
-t, --timeout	Especifica el valor de tiempo de espera para la publicación de proyectos. El tiempo de espera predeterminado es de 30 segundos. Esta configuración solo se aplica a la duración de la transferencia del paquete a Orchestrator.
--cer-path	La ruta local al certificado para la firma de paquetes.
--cer-password	La contraseña del certificado.
--timestamper-url	La dirección URL al marcador de tiempo.
--incl-all-feeds	No necesario.
--help	Ver los argumentos disponibles para cada comando.
--version	Comprueba la versión de UiPath.Studio.CommandLine.exe.

Por ejemplo:

• El siguiente comando publica el proceso de muestra a la fuente de procesos del tenant de Orchestrator:

  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target OrchestratorTenant --notes "Corregidos un par de errores".

• El siguiente comando publica el mismo proceso en una carpeta local:

  UiPath.Studio.CommandLine.exe publish --project-path "C:\Users\username\Documents\UiPath\Sample\project.json" --target Custom --feed "C:\sers\usernameDesktop\myfeed" --notes "Corregidos un par de errores".

Para obtener más información sobre la utilidad CommandLine.exe, consulta Parámetros de línea de comandos de actualización masiva.