UiPath Documentation
studio
2020.10
false
Guía de usuario de Studio
Importante :
La localización de contenidos recién publicados puede tardar entre una y dos semanas en estar disponible.

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. De forma predeterminada, la ruta de la versión de instalador de Windows (.msi) de Studio es C:\Program Files (x86)\UiPath\Studio\.

La ruta predeterminada para Studio instalado usando el instalador de Community Edition (.exe) es la siguiente. %LocalAppData%\UiPath\[Studio_version]\.

Algunos comandos pueden no estar disponibles dependiendo del sistema de control de origen al que esté conectado Studio (SVN o TFS). Para ver los argumentos específicos de cada comando usa simplemente --help. Usa --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:

    ArgumentoDescripción
    -d, --directoryEl 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.

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

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

    Nota:

    Currently .pfx and .p12 certificate extensions are accepted for signing projects. For more details, check out the Signing Packages page.

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.

    ArgumentoDescripción
    -p, --project-pathPara analizar un archivo, proporciona la ruta al archivo .xaml. Para analizar el proyecto completo, especifica la ruta al archivo project.json.

Read the About Workflow Analyzer page to find out more about how to analyze files/projects and configure rules using command-line parameters.

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:

    ArgumentoDescripción
    r, --repositoryLa dirección/URL del repositorio que almacena los proyectos que quieres modificar. El argumento es obligatorio.
    -p, --passwordLa contraseña necesaria para la autenticación en el repositorio SVN.
    -s, --password-stdinLee la contraseña de autenticación desde STDIN (entrada estándar). Se te pedirá que escribas la contraseña del repositorio deseado.
    u, --userEl 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:

    ArgumentoDescripción
    -d, --directoryLa carpeta de verificación de destino para los archivos. El argumento es obligatorio.
    -r, --repositoryLa 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:

    ArgumentoDescripción
    -f, --filesLas 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, --directoryEl 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:

    ArgumentoDescripción
    -m, --messageEscribe un mensaje de confirmación para detallar los cambios realizados en los proyectos. El mensaje de confirmación es obligatorio.
    -d, --directoryEl 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, --filesLas 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

    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.

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

    ArgumentoDescripción
    -c, --collectionEspecifica la URI de la colección.
    -d, --directoryLa carpeta de verificación de destino para los archivos. El argumento es obligatorio.
    -r, --remotedirLa 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:

    ArgumentoDescripción
    -f, --filesLas rutas de los archivos que quieres editar. Las rutas deben ser relativas al directorio de trabajo y separadas por punto y coma.
    -d, --directoryEl 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:

    ArgumentoDescripción
    -m, --messageEscribe un mensaje de confirmación para detallar los cambios realizados en los proyectos. El mensaje de confirmación es obligatorio.
    -d, --directoryEl 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, --filesLas 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:

  • If the project was not published and consequently, it doesn’t have any installed dependencies, the migration process steps in and installs the default packages, detailed in the Managing Dependencies page.
  • 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.

¿Te ha resultado útil esta página?

Conectar

¿Necesita ayuda? Soporte

¿Quiere aprender? UiPath Academy

¿Tiene alguna pregunta? Foro de UiPath

Manténgase actualizado