Parámetros de línea de comandos de actualización masiva

La Actualización masiva de dependencias del proyecto de la interfaz de línea de comandos del usuario se puede utilizar para actualizar en masa los archivos project.json pertenecientes a múltiples proyectos de automatización. Permite añadir o eliminar dependencias, cambiar las versiones de paquete y las reglas de tiempo de ejecución, y firmar procesos o bibliotecas antes de publicarlos.

Ten en cuenta que al utilizar la Herramienta de actualización masiva de dependencias del proyecto aceptas de forma implícita los términos de licencia de cada versión del paquete que actualizas.

Nota:

La interfaz de usuario de línea de comandos Actualización masiva de dependencias del proyecto está disponible para Studio Enterprise Edition a partir de Studio v2018.4.4.

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

• Para las instalaciones por máquina, la ruta predeterminada es C:\Program Files\UiPath\Studio\.

• Para las instalaciones por usuario, la ruta predeterminada es %localappdata%\Programs\UiPath\Studio.

  

Algunos comandos pueden no estar disponibles dependiendo de los sistemas de control de origen a los que Studio esté conectado (GIT, SVN o TFS). Para ver los argumentos específicos de cada comando, simplemente usa --help. Utiliza --version para comprobar la versión de UiPath.Studio.CommandLine.exe.

Las combinaciones de múltiples comandos se pueden usar en una única línea de comandos. Además, determinados argumentos no necesitan repetirse en la misma línea de comandos, por ejemplo, r, --repository cuando se usa con svn login y svn checkout.

Nota:

Antes de usar la interfaz de usuario de línea de comandos Actualización masiva de dependencias del proyecto con TFS, asegúrate de que los proyectos que quieres actualizar estén desconectados de TFS para el usuario actual.

Se recomienda guardar y cerrar proyectos de Studio antes de realizar cambios usando la Herramienta de actualización masiva de dependencias de proyecto.

Comandos para actualizar archivos locales

• list: Encuentra y muestra las rutas a los archivos project.json almacenados en un directorio determinado. También se pueden enumerar proyectos desde una unidad de red local. Los siguientes argumentos se deben utilizar con el comando list:

  Argumento	Descripción
  -d, --directory	El directorio que almacena los archivos que quieres enumerar. Usa los argumentos -u, --user y -p, --pass para los directorios remotos protegidos con contraseña.

  Nota:

  Si el argumento --directory no se usa con el comando list, se muestran las rutas de todos los archivos project.json del directorio de trabajo actual.

• manage: administra el proyecto especificado. Ten en cuenta que se pueden añadir o eliminar múltiples dependencias y reglas siempre que estén separadas por espacios en blanco. Los siguientes argumentos se deben utilizar con el comando manage:

Argumento	Descripción
-a, --add-ref	Agrega o actualiza la regla de dependencia y de tiempo de ejecución al archivo project.json. ”dependencyname|version|runtimerule” = añade o actualiza la versión de dependencia y la regla del runtime. ”dependencyname|prereleaseversion|runtimerule” = añade la versión de dependencia preliminar y la regla del runtime especificada.
r, --rem-ref	Elimina las dependencias especificadas del archivo project.json. "dependencyname": la dependencia que se eliminará del proyecto, independientemente de su versión. "dependencyname|version": elimina la dependencia con esta versión concreta, independientemente de si es una versión preliminar.
-p, --project-path	La ruta del archivo project.json.

Nota:

La sintaxis de las reglas de tiempo de ejecución es lowest para la Versión más baja aplicable, y strict para la versión Estricta. Si no se indica ninguno de estos parámetros, se aplica de forma predeterminada la Versión más baja aplicable.

Por ejemplo, el comando siguiente manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" cambia la versión del paquete a 2.6.2 y la regla de tiempo de ejecución a la Versión más baja aplicable.

• publish: publica el proyecto junto con los cambios en las dependencias. Los siguientes argumentos se deben utilizar con el comando publish:

Argumento	Descripción
-p, --project-path	La ruta a project.json para su publicación. El argumento es obligatorio.
-g, --target	Dónde publicar el proyecto: Custom: la URL personalizada o la carpeta local. Define la ubicación mediante el argumento -f, --feed. Robot - Ubicación de publicación predeterminada para el Robot, si no está conectado a Orchestrator. No disponible para publicar bibliotecas o plantillas. OrchestratorTenant: fuente de procesos de tenant de Orchestrator (para procesos y casos de prueba) o fuente de las bibliotecas de Orchestrator (para bibliotecas y plantillas). OrchestratorPersonalFolder - Fuente del espacio de trabajo personal de Orchestrator. No disponible para publicar bibliotecas, plantillas o casos de prueba. OrchestratorFolderHierarchy: si una carpeta de primer nivel con una fuente de paquetes independiente o una de sus subcarpetas se selecciona en el menú de carpetas en la barra de estado de Studio, la fuente para esa jerarquía de carpetas. No disponible para publicar bibliotecas o plantillas.
-f, --feed	La dirección URL personalizada para publicar el proyecto. Esto 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.
-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.
--version-update-type	Especifica cómo incrementa la versión del proyecto: IncrementOnly: la versión del proyecto se incrementa automáticamente. ForcePrerelease: la versión del proyecto se incrementa y se marca como versión previa con un sufijo especificado, independientemente de su versión actual. Si no se establece un sufijo con el argumento, el sufijo predeterminado es --prerelease-suffixalpha. ForceRelease: la versión del proyecto aumenta y se marca como lista para lanzamiento, independientemente de su versión actual.
--prerelease-suffix	Especifica el sufijo que se utilizará cuando --version-update-type se establezca en ForcePrerelease .

Nota:

Actualmente se aceptan las extensiones de certificado .pfx y .p12 para la firma de proyectos. Para obtener más detalles, consulta la página Firma de paquetes.

Elaborando un poco más el ejemplo anterior, el siguiente comando actualiza el paquete UiPath.Excel.Activities a la versión 2.6.2, cambia la regla de tiempo de ejecución a Versión más baja aplicable, añade notas de versión y una nueva versión y publica el proyecto en una ubicación personalizada:

manage --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --add-ref "UiPath.Excel.Activities|2.6.2|lowest" publish --project-path "C:\Users\username\Documents\UiPath\BlankProcess\project.json" --target Custom --feed "C:\Users\username\Desktop\myfeed" --notes "Changes were made to the Excel package" --new-version "1.0.2".

Comandos del analizador de flujo de trabajo

Los parámetros de línea de comandos se pueden usar para analizar los archivos o proyectos comparándolos con un conjunto de reglas.

• analyze: analiza todo el proyecto. Requiere la ruta al archivo project.json.

• analyze-file: analiza un único archivo. Requiere la ruta al archivo .xaml.

  Argumento	Descripción
  -p, --project-path	Para analizar un archivo, proporciona la ruta al archivo .xaml. Para analizar el proyecto completo, especifica la ruta al archivo project.json.
  -c, --config-path	La ruta del archivo RuleConfig.json. Especifica esta ruta solo si el archivo de configuración de la regla no se encuentra en la ubicación predeterminada (%LocalAppData%\UiPath\Rules).

Consulta la página Acerca del Analizador de flujo de trabajo para obtener más información sobre cómo analizar archivos/proyectos y configurar reglas utilizando parámetros de línea de comandos.

Comandos específicos de GIT

• git clone = Clonar un repositorio en un nuevo directorio.
  Nota:

  Antes de ejecutar UiPath.Studio.CommandLine.exe git clone, asegúrate de que las credenciales para el repositorio ya están almacenadas en el Administrador de credenciales de Windows. De lo contrario, se produce un error de autenticación.

los siguientes argumentos se deben utilizar con el comando git clone:

Argumento	Descripción
r, --repository	La dirección/URL del repositorio que almacena los proyectos que quieres modificar. El argumento es obligatorio.
-d, --directory	El directorio de trabajo. Si no se especifica, se utiliza el directorio de entorno actual.

• git commit = Guardar cambios en el repositorio. los siguientes argumentos se deben utilizar con el comando git commit:

  Argumento	Descripción
  -m, --message	Escribe un mensaje de confirmación para detallar los cambios realizados en los proyectos. El mensaje de confirmación es obligatorio.
  -p, --push	Sube los cambios al repositorio remoto.
  -d, --directory	El directorio de trabajo. Si no se especifica, se utiliza el directorio de entorno actual.
  -f, --files	Las rutas de los archivos que quieres editar. Las rutas deben ser relativas al directorio de trabajo y separadas por punto y coma.

Comandos específicos de SVN

• svn login = Usa credenciales para iniciar sesión en un repositorio SVN determinado. Los siguientes argumentos se deben utilizar con el comando svn login:

  Argumento	Descripción
  r, --repository	La dirección/URL del repositorio que almacena los proyectos que quieres modificar. El argumento es obligatorio.
  -p, --password	La contraseña necesaria para la autenticación en el repositorio SVN.
  -s, --password-stdin	Lee la contraseña de autenticación desde STDIN (entrada estándar). Se te pedirá que escribas la contraseña del repositorio deseado.
  u, --user	El nombre de usuario requerido para la autenticación.

• svn checkout = Comprueba proyectos desde un repositorio SVN. Los siguientes argumentos se deben utilizar con el comando svn checkout:

  Argumento	Descripción
  -d, --directory	La carpeta de verificación de destino para los archivos. El argumento es obligatorio.
  -r, --repository	La dirección del repositorio que almacena los archivos que quieres comprobar. El argumento es obligatorio.

• svn edit = Desbloquea uno o varios proyectos y los hace disponibles para editar. Los siguientes argumentos se deben utilizar con el comando svn edit:

  Argumento	Descripción
  -f, --files	Las rutas de los archivos que quieres editar. Las rutas deben ser relativas al directorio de trabajo y separadas por punto y coma. El argumento es obligatorio.
  -d, --directory	El directorio de trabajo que contiene los archivos de trabajo que quieres editar. Si no se especifica un directorio de trabajo se usa el directorio del entorno actual.

• svn checkin = Comprueba los cambios hechos en los proyectos de automatización. Los siguientes argumentos se deben utilizar con el comando svn checkin:

  Argumento	Descripción
  -m, --message	Escribe un mensaje de confirmación para detallar los cambios realizados en los proyectos. El mensaje de confirmación es obligatorio.
  -d, --directory	El directorio de trabajo en el que se están comprobando los proyectos. Si no se especifica un directorio de trabajo se usa el directorio del entorno actual.
  -f, --files	Las rutas de los archivos que has editado. Las rutas deben ser relativas al directorio de trabajo y separadas por punto y coma.

Comandos específicos de TFS

• tfs login = Usa credenciales para iniciar sesión en un repositorio TFS determinado. Los siguientes argumentos se deben utilizar con el comando tfs login:

Argumento	Descripción
-t, --type	El método de inicio de sesión para el repositorio TFS: ntlm = autenticación mediante LAN Manager de NT en un repositorio TFS local. token = autenticación usando un token de acceso personal habilitado en el repositorio TFS. basic = autenticación básica en un repositorio TFS seguro.
-p, --password	The password required for authentication to the TFS repository.
-s, --password-stdin	Lee la contraseña de autenticación desde STDIN (entrada estándar). Se te pedirá que escribas la contraseña del repositorio deseado.
u, --user	El nombre de usuario requerido para la autenticación.
-c, --collection	Hace referencia a la URI de la colección. El argumento es obligatorio.

• tfs checkout = Comprueba proyectos desde un repositorio TFS. Los siguientes argumentos se deben utilizar con el comando tfs checkout:

  Argumento	Descripción
  -c, --collection	Especifica la URI de la colección.
  -d, --directory	La carpeta de verificación de destino para los archivos. El argumento es obligatorio.
  -r, --remotedir	La ruta del directorio del proyecto, relativa a la raíz de la colección. Comienza con $/ y va precedido por la URI de la colección.

• tfs edit: Desbloquea uno o varios proyectos hace que estén disponibles para editar. Los siguientes argumentos se deben utilizar con el comando tfs edit:

  Argumento	Descripción
  -f, --files	Las rutas de los archivos que quieres editar. Las rutas deben ser relativas al directorio de trabajo y separadas por punto y coma.
  -d, --directory	El directorio de trabajo que contiene los archivos de trabajo que quieres editar. Si no se especifica un directorio de trabajo se usa el directorio del entorno actual.

• tfs checkin: Comprueba los cambios hechos en los proyectos de automatización. Los siguientes argumentos se deben utilizar con el comando tfs checkin:

  Argumento	Descripción
  -m, --message	Escribe un mensaje de confirmación para detallar los cambios realizados en los proyectos. El mensaje de confirmación es obligatorio.
  -d, --directory	El directorio de trabajo en el que se están comprobando los proyectos. Si no se especifica un directorio de trabajo se usa el directorio del entorno actual.
  -f, --files	Las rutas de los archivos que has editado. Las rutas deben ser relativas al directorio de trabajo y separadas por punto y coma.

Actualizar antiguos proyectos de automatización

Al instalar una dependencia usando la interfaz de usuario de línea de comandos en proyectos de automatización creados en una versión de Studio anterior a la v2018.3, ten en cuenta las siguientes particularidades:

• Si el proyecto no se publicó y, en consecuencia, no tiene ninguna dependencia instalada, el proceso de migración interviene e instala los paquetes predeterminados, detallados en la página Administrar dependencias.
• Si el proyecto se creó y publicó con una versión de Studio anterior a la v2018.3, el paquete UiPath.Core.Activities se ha migrado a UiPath.System.Activities y UiPath.UIAutomation.Activities.