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

You can publish projects from Studio or from the command line. To update dependencies for multiple projects and publish them all at once, use the Project Dependencies Mass Update Tool.

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.

   • In the Version section, review the Current Version of your project, and type a New Version if needed. Check the Is Prerelease box to mark the version as alpha. Please note that this automatically changes the project’s version schema to semantic. When publishing a new version of the file locally, make sure that the custom location does not already include a file with the same proposed version number. For more details about project versioning, check the About Automation Projects page.

   • 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 si se utiliza un archivo local para una biblioteca publicada en Orchestrator o en una fuente que no admite iconos incrustados. En este caso, especifica el icono utilizando 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 separadores 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):

     • Orchestrator Tenant Processes Feed, Orchestrator Personal Workspace Feed and, if a first-level folder with a separate package feed or one if its subfolders is selected from the folders menu in the Studio status bar, the feed for that folder hierarchy. These options are available if Studio is connected to Orchestrator. The Orchestrator Personal Workspace Feed is available only if your user has the Personal Workspace feature enabled in 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:

   • *(For libraries only)*Activities Root Category - enter a name for the category under which the reusable component will be listed in the Activities panel.

   • Incluir orígenes: selecciona esta opción para empaquetar todos los orígenes .xaml dentro del paquete publicado, incluidos los flujos de trabajo que se hayan convertido en privados anteriormente. Para bibliotecas Windows heredadas, los archivos se guardan en el archivo de conjunto generado y en la carpeta lib\net45 en el archivo .nupkg. Para bibliotecas y procesos en Windows y multiplataforma, los archivos se guardan en la carpeta content en el archivo .nupkg.

   • *(For Windows-legacy libraries only)*Compile activities expressions - select this option to compile and package all activities expressions. This results in an improved execution time.

   • (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:

     To find out what might prevent a library from being published successfully, read about the limitations when publishing libraries.

     

7. Haz clic en Siguiente para avanzar a la pestaña Firma de certificado o Publicar para publicar el proyecto.

8. (Optional) In the Certificate Signing tab, add a local Certificate Path next to the Certificate box. Furthermore, add the Certificate Password and an optional certificate Timestamper if needed. For more details, check out the Signing Packages page.

   

   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 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 se deben desempaquetar. 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 predeterminada es C:\Program Files\UiPath\Studio.
• Para instalaciones por usuario, la ruta predeterminada 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. OrchestratorFolderHierarchy - If a first-level folder with a separate package feed or one if its subfolders is selected from the folders menu in the Studio status bar, the feed for that folder hierarchy. Not available for publishing libraries or templates.
-f, --feed	The custom URL for publishing the project. This can also be a custom local directory, similar to the path in the Publish options tab in 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".

For more information about the CommandLine.exe utility, see Mass Update Command Line Parameters.