Acerca de los proyectos de automatización

UiPath Studio allows you to create two types of standalone automation projects: process or library. Processes can incorporate all types of workflows, sequence, flowchart, state machine and global exception handler, while the global exception handler isn't available for libraries. Moreover, libraries can be added as dependencies to automation processes.

Al iniciar un nuevo proceso en Studio se crea una carpeta con su nombre personalizado en la ubicación seleccionada. Los proyectos se guardan en el directorio %USERPROFILE%\Documents\UiPath de forma predeterminada, a menos que se cambie esta ubicación de forma manual.

La carpeta de proyecto incluye de forma predeterminada los siguientes archivos y subcarpetas:

• Archivos
  • Main.xaml - Created by default to hold your main workflow. In addition, all the other automation XAML files you add to the project are stored in the project folder. Optionally, you can set a different file as main. All the files must be linked through the Invoke Workflow File activity to the file set as main or to a file marked as an entry point to the project. In the case of test projects created in Studio Pro, a TestCase.xaml file is created by default instead of Main.xaml.
  • project.json: contiene información sobre su proyecto de automatización.
• Subcarpetas

  • .entities: contiene datos sobre entidades importadas de Data Service, si se utiliza alguna en el proyecto.

  • .local: contiene datos en caché local para el proyecto.

  • .objects: contiene datos relacionados con elementos añadidos al Repositorio de objetos, si se utiliza alguno en el proyecto.

  • .screenshots: contiene capturas de pantalla informativas generadas en actividades de automatización de la IU, si se utiliza alguna en el proyecto.

  • .settings: contiene configuraciones de proyectos de actividad utilizadas en tiempo de ejecución.

  • .tmh: contiene datos relacionados con casos de prueba, si se utiliza alguno en el proyecto.

    Nota:

    Los proyectos creados con versiones de Studio más recientes podrían no funcionar con versiones anteriores de Studio. Más información sobre Compatibilidad con versiones anteriores y posteriores.

    No puedes utilizar los siguientes caracteres en los nombres de archivo ", <, >, |, :, *, ?, \, /,;. Estos caracteres proceden de restricciones de Microsoft Windows y de otras restricciones de caracteres especiales.

Configurar el idioma del proyecto

Los proyectos creados en los perfiles de Studio y StudioX utilizan el lenguaje VB.NET para las expresiones.

En el perfil de Studio Pro al crear un nuevo proyecto se puede elegir entre VB o C#.El lenguaje elegido de forma predeterminada es VB, pero se puede establecer C# como lenguaje predeterminado para nuevos proyectos yendo a Inicio (Vista de Backstage de Studio) > Configuración > Diseño. Tenga en cuenta que los proyectos en C# solo se pueden abrir desde el perfil de Studio Pro.

No se admite el uso de expresiones de VB y C# en el mismo proyecto. Tampoco se admite el uso de expresiones de VB en flujos de trabajo de C# y viceversa. Al copiar y pegar actividades de otros proyectos, invocar o importar flujos de trabajo, asegúrese de usar el mismo lenguaje que en su proyecto.

Puede instalar bibliotecas de C# como dependencias en proyectos de VB y viceversa.No obstante, no se podrá acceder a los valores predeterminados para argumentos del proyecto de biblioteca que usan expresiones específicas de lenguaje desde el proyecto donde se instala la biblioteca.

Limitaciones de C#

• La implementación actual de C# se basa en el compilador de C# que utiliza la versión 5 de C#, por lo que el acceso está limitado a características más recientes como asignación de uso combinado, operador condicional null, operador de uso combinado de null, interpolación de cadena y otros.
• Los proyectos que contienen expresiones con incrementos no son válidos.
• Las expresiones que contienen el operador nameof() se marcan como no válidas y no se permiten con la implementación de C# actual.
• Las expresiones que contienen llamadas a métodos con argumentos opcionales deben incluir valores para los argumentos opcionales.
• El tiempo de diseño y el rendimiento en tiempo de ejecución de los proyectos de C# son inferiores en comparación con VB.NET. Cuando el rendimiento en tiempo de ejecución sea esencial, se recomienda usar VB.NET en lugar de C#.

Establecer la versión del proyecto

Versionado semántico

El esquema de control de versiones semántico tiene el formato Mayor.Menor.Parche[-Sufijo], donde:

• Mayor es la versión principal.
• Menor es la versión secundaria.
• Parche es la versión de parche.
• -Sufijo (opcional) es un guion seguido por una serie de identificadores separados por punto que sigue inmediatamente a la versión de parche.Esto indica una versión preliminar.

Los identificadores deben estar formados solo por caracteres alfanuméricos ASCII y guiones, y no deben estar vacíos. Los identificadores numéricos no deben incluir ceros a la izquierda. Además, los metadatos de compilación pueden indicarse mediante un signo más y una serie de identificadores separados por puntos inmediatamente después de la versión del parche o prelanzamiento, por ejemplo 1.0.0-alpha+1.

Al crear un nuevo proceso o biblioteca, el esquema de versión predeterminado es semántico. Se puede cambiar desde la ventana Publicar simplemente añadiendo un dígito adicional al número de versión. La versión de semántica del proyecto también puede modificarse en el archivo project.json. El número de parche 0 se añade automáticamente a los proyectos con el número de versión major.minor.

Control de versiones heredadas

El número de versión heredada generado para el proyecto tiene el formato M.m.bbb.rrrr. donde:

• M es la versión principal.
• m es la versión secundaria.
• bbbb es la versión de compilación.
• rrrr es la versión de revisión.

Las versiones principales y secundarias pueden modificarse también en el archivo project.json, mientras las versiones de compilación y revisión se generan según un algoritmo, el valor de la versión de compilación es el número de días transcurridos desde el 01-01-2000. El valor de la revisión es el número de segundos que transcurre desde el día actual hasta el momento del lanzamiento de la versión. El resultado se divide entre 2, de modo que el número máximo de la revisión no exceda de 65535.

El número de versión sugerido en la ventana Publicar se genera en función del esquema de versiones anteriores del proyecto, mientras que la fecha y la marca de tiempo actuales se tienen en cuenta para los proyectos que utilizan el esquema de versiones de 4 dígitos.

Gestionar proyectos

El panel Proyecto te permite ver el contenido del proyecto actual, añadir carpetas, abrir la ubicación del archivo, gestionar dependencias y ajustar la configuración del proyecto.

Copiar y pegar archivos desde el Explorador de archivos directamente en el panel Proyecto. Lo mismo puede hacerse mediante arrastrar y soltar en uno o varios archivos, incluidos los flujos de trabajo de .xaml. Con los atajos Ctrl + C y Ctrl + V también puedes copiar un archivo y duplicarlo en cualquier lugar del árbol.

Opción	Descripción
Expandir todo	Expande todos los nodos de proyecto de automatización.
Contraer todo	Contrae todos los nodos del proyecto de automatización.
Actualizar	Actualiza el proyecto.
Mostrar todos los archivos	Muestra todos los archivos que pertenecen al proyecto de automatización, incluido el project.json.
Explorador de archivos	Abre la ubicación del proyecto en la máquina.
Configuración del proyecto	Abre la ventana Configuración del proyecto para los procesos o las bibliotecas.
Quitar capturas de pantalla no utilizadas	Elimina las capturas de pantalla que no se utilicen al ejecutar el proyecto de automatización.

Menú contextual para proyectos

Haz clic con el botón derecho en cualquier lugar del panel Proyecto para abrir el menú contextual con las opciones descritas en la tabla siguiente. Hay disponible un subconjunto diferente de opciones en función de la parte del panel en la que haces clic con el botón derecho, el tipo de proyecto y si el proyecto se añade al control de origen.

Opción	Descripción
Abrir carpeta de proyectos	Abre la carpeta local que contiene el proyecto.
Configuración del proyecto	Abre la ventana Configuración del proyecto para ajustar las preferencias del proyecto.
Añadir	Opens a list of items that can be added to the project: folder, sequence, flowchart, state machine or global handler.
Importar flujos de trabajo	Importa los archivos .xaml al proyecto y añade Importado al nombre del archivo si coincide con el nombre del archivo principal.
Importar archivos	Abre la ventana Explorador de archivos para importar varios archivos al proyecto.
Añadir a control de origen	Adds the current project to source control using Git Init, Copy to Git, Add to TFS, or Add to SVN options. Please note that this option is only visible when right-clicking the project node. When a project is added to source control, additional options are available in the context menu. See the options for GIT and the options for SVN and TFS.
Abrir	Abre los archivos seleccionados con el programa predeterminado.
Abrir la ubicación del archivo	Abre la carpeta local que contiene el archivo.
Cambiar nombre	Permite cambiar el nombre del archivo o la carpeta seleccionados y abre la ventana Cambiar nombre del elemento. Se cambiará el nombre de todas las ocurrencias del elemento.
Eliminar	Elimina el elemento seleccionado solo de la máquina local.
Seleccionar para comparar	Selecciona el archivo actual para la comparación.
Comparar con seleccionados	Compares the current file with the previously selected file using Compare Files.
Buscar referencias	Finds all references to the file in the project. The results are displayed in the Find References panel.
Depurar archivo	Depura el archivo .xaml seleccionado.
Establecer como principal	Establece el archivo seleccionado .xaml como Principal en la definición del proyecto, lo que significa que la ejecución del proyecto se inicia con ese archivo. Solo puede haber un archivo Principal en el proyecto. El nombre del archivo establecido como principal aparece en negrita en el panel Proyecto.
Propiedades	Abre la ventana Propiedades de la biblioteca para añadir información sobre herramientas y un Enlace de ayuda.
Establecer como controlador global	Establece el archivo .xaml como el Controlador global de excepciones para el proyecto. Esto se aplica a un flujo de trabajo por proyecto/proceso.
Quitar controlador	Elimina la etiqueta Controlador de excepciones global del archivo .xaml.
Habilitar punto de entrada	Marks the selected workflow file as an entry point for the process, making it possible to select it as the workflow to run first when using the Invoke Process and Run Parallel Process activities in other processes. When a file is marked as an entry point, an arrow is displayed on the icon next to the file name . Al habilitar un archivo que se omite de la publicación como un punto de entrada, se establece el archivo como publicable. Esta opción no está disponible para los archivos de caso de prueba. Esta opción no está disponible en los proyectos de biblioteca.
Deshabilitar punto de entrada	Ya no marca el archivo de flujo de trabajo seleccionado como un punto de entrada para el proceso. Esta opción no está disponible para el archivo de flujo de trabajo que está establecido como principal.
Ignorar desde la publicación	Marca uno o más archivos seleccionados como excluidos de la publicación. When a file is ignored from publishing, the icon next to the file name turns gray . Al ignorar un archivo marcado como un punto de entrada desde la publicación, se deshabilita el punto de entrada. In a library project, a file that is ignored from publishing is included in the package, but no reusable component is created and made available in the Activities panel in projects where the library is installed as a dependency.
Establecer como publicable	Marca uno o más archivos seleccionados que están excluidos de la publicación como publicables.

Opciones del menú contextual para GIT

En los proyectos añadidos a los repositorios GIT, se muestra un icono junto a cada archivo del panel Proyecto para indicar el estado del archivo:

El archivo se sincroniza con el repositorio.

El archivo se ha modificado.

El archivo se ha añadido.

Right-click a file or project node in the Project panel to open the GIT-specific context menu for Managing Projects with GIT.

Opción	Descripción
Confirmar	Confirma los cambios actuales en el repositorio de GIT local.
Insertar	Envía la versión actual al repositorio remoto.
Incorporar (cambio de base)	Extrae archivos remotos y reorganiza la base de la rama actual.
Administrar ramas	Abre la ventana GIT con opciones para gestionar las ramas actualmente añadidas.
Mostrar cambios	Abre la ventana Diferencia de archivos para comparar los cambios entre la versión local y la versión remota del archivo.
Mostrar historial	Abre la ventana Mostrar historial para comparar dos versiones del mismo archivo.
Deshacer	Abre la ventana Deshacer cambios pendientes si el archivo no se ha asignado ni enviado al repositorio remoto.

Opciones del menú contextual para SVN y TFS

En los proyectos añadidos a los repositorios SVN o TFS, se muestra un icono junto a cada archivo del panel Proyecto para indicar el estado del archivo:

El archivo no se extrae para su edición.

El archivo se ha extraído para su edición.

El archivo se ha modificado.

El archivo se ha añadido.

Right-click a file or project node in the Project panel to open the context menu with options specific to managing projects with TFS or SVN.

Opción	Descripción
Abrir	Abre el archivo .xaml seleccionado en el panel Diseñador, en modo de solo de lectura si no se ha comprobado para edición desde el repositorio TFS/SVN.
Cambiar nombre	Te permite cambiar el nombre del archivo o la carpeta seleccionados y abre la ventana Cambiar nombre del elemento. Al comprobar el nombre del archivo .xaml renombrado, la versión anteriormente modificada también debe comprobarse.
Eliminar	Elimina el elemento seleccionado solo de tu máquina local. La última versión comprobada del archivo aún está disponible en el repositorio TFS/SVN.
Extraer para editar	Marca el archivo o la carpeta seleccionados como bloqueados para su edición. Al extraer un archivo, lo bloquea en el servidor para que nadie más pueda editarlo.
Finalizar la edición	Coloca el archivo project.json en el repositorio junto con los cambios y un mensaje de confirmación.
Añadir	Carga el elemento seleccionado al servidor TFS/SVN. Esta opción no está disponible, si se ha cargado el elemento previamente en el servidor.
Obtener la última versión	Descarga la versión más reciente del elemento seleccionado desde el repositorio TFS/SVN.
Mostrar cambios...	Abre el Diferencia de archivos para comparar los cambios entre el archivo versionado y el asignado localmente.
Proteger	Muestra la ventana Proteger cambios y te permite cargar el elemento seleccionado en el servidor como la versión más reciente. Es necesario guardar el archivo .xaml antes de cargarlo. Una vez que se registra, el archivo pasa a ser de solo lectura en Studio.
Deshacer	Muestra la ventana Deshacer cambios pendientes y te permite revertir los cambios realizados en el proyecto, ya sea revirtiendo los archivos modificados a estados anteriores o no versionados o recuperando los archivos eliminados de la máquina local. Los cambios no pueden revertirse después de registrarse el archivo.
Iniciar	Ejecuta el flujo de trabajo seleccionado, incluso si no se ha extraído ni añadido al repositorio.
Establecer como principal	Establece el archivo .xaml seleccionado como el principal del proyecto. El primer archivo .xaml creado se establece como principal de forma predeterminada.

Ajustar la configuración del proyecto

Se puede establecer una serie de configuraciones individuales para cada proyecto de automatización en el que estés trabajando. Dicha configuración está disponible en la ventana Configuración del proyecto, que se puede abrir haciendo clic en en el panel Proyecto.

Descripción del campo para la ventana Configuración

Campo	Descripción
Nombre	Cambia el nombre del proyecto. Dichos nombres pueden contener espacios en blanco. Al nombrar proyectos, ten en cuenta que los espacios en blanco se eliminan en el momento de la publicación. Este campo acepta hasta 128 caracteres.
Descripción	Cambia la descripción del proyecto. Este campo acepta hasta 500 caracteres.
Deshabilitar pausa	Habilita o impide que los usuarios pausen los procesos en la bandeja del Robot. Establécelo en Sí si al pausar el proceso durante la ejecución se bloquea. Por ejemplo, si una actividad del flujo de trabajo utiliza la propiedad Timeout, al pausar la ejecución podría hacer que el tiempo de espera caduque, rompiendo así la ejecución.
Se inicia en segundo plano	Set to Yes to turn the project in a Background Process and allow it to run in the background concurrently with other processes, as long as it does not use UI interaction.
Compatible con persistencia	Set to Yes to turn the project in an Orchestration Process.
Compatible con PiP	Set to Yes to indicate that the project was tested using Picture in Picture. If set to No, the option to use this feature is not available for the process.
Comienza en PiP	Establécelo en Sí para indicar que el proceso debe ejecutarse de forma predeterminada con la característica Imagen de imagen.
Experiencia de diseño moderna	Set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Haz clic en Aceptar y los cambios se hacen visibles en el panel Proyecto y el archivo project.json.

Check out the Configuring Activity Project Settings page to read about how to adjust activity properties at project level.

Nota:

Ten en cuenta que siempre que desees copiar un gran número de actividades de una secuencia a otra, se recomienda desplazarse hacia abajo hasta la parte inferior del panel Diseñador previamente. Esto se debe a una limitación de Windows Workflow Foundation.

Acerca del archivo Project.Json

Project.json es un archivo generado automáticamente que se crea para cada archivo .xaml marcado como Principal en la carpeta del proyecto.

The file holds varied information, including project dependencies, or web services loaded in libraries. For more information about web services in libraries, check out the Loading Web Services in Libraries page.

Nota:

Manually editing the project.json file should be attempted for troubleshooting scenarios only, as it may lead to severe consequences and loss of support. As of 2018.2, you should specify a project.json file when running your project from the UiRobot.exe (command line) client.

Los parámetros contenidos en el archivo Project.json se describen en la siguiente tabla.

Parámetro	Descripción
name	El título del proyecto de automatización. Se proporciona en Studio al crear un nuevo proceso o biblioteca.
description	La descripción del proyecto. Se proporciona en el campo Descripción en Studio cuando se crea un nuevo proyecto.
main	El punto de entrada del proyecto de automatización. Consiste en un archivo .xaml. El nombre por defecto es "Main.xaml". Se muestra tanto como el título del panel del Diseñador como en el panel Propiedades en Studio. Si quieres ejecutar un proyecto diferente, cambia el valor de este parámetro por el nombre del archivo .xaml que se va a procesar. If your automation project contains multiple files, each of them should be linked to the Main.xaml file through the Invoke Workflow File activity. This is especially useful when the project is published to Orchestrator and sent to a Robot, as the Robot executes only the file provided in this parameter.
dependencies	Los paquetes de actividades utilizados para crear el proyecto de automatización y sus versiones. La lista se actualiza cada vez que se agrega o se elimina una dependencia del proyecto o cuando se cambia una versión de paquete. Los números de versión se componen de las siguientes partes, en orden: mayor, menor, compilación y revisión. El valor de la compilación es el número de días que transcurrió desde 01.01.2000. El valor de revisión es el número de segundos desde la fecha de publicación, empezando a las 5:00, GMT.
webServices	namespace: el nombre del servicio proporcionado en la ventana Añadir nuevo servicio para bibliotecas. serviceDocument: la ruta al archivo .xml o .json que contiene metadatos para el servicio SOAP o Swagger. El archivo se usa cuando el servicio se repara y debe versionarse como parte del proyecto. webDocumentUri: la ruta del archivo o enlace al recurso de Swagger o SOAP (siempre que el servicio se cree en la ventana Añadir nuevo servicio). uniqueReference: una referencia necesaria para versionar el servicio.
entitiesStores	serviceDocument: la ruta al archivo de entidades local. tenantName: el tenant en el que reside el servicio de datos. namespace: el espacio de nombres bajo el que se importan las entidades (el espacio de nombres del proyecto). uniqueReference: una referencia necesaria para versionar el servicio.
schemaVersion	La versión del archivo project.json.
studioVersion	La versión de Studio utilizada para crear el proyecto de automatización.
projectVersion	La versión utilizada al publicar este proyecto en una fuente. Representa el conjunto de la ventana Publicar.
runtimeOptions	isPausable: si la pausa está habilitada para el proceso requiresUserInteraction: si el proceso es un proceso de larga ejecución. supportsPersistence: si el proceso admite persistencia, excludedLoggedData - Contains keywords that can be added to the name of an activity to prevent variable and argument values from being logged at the Verbose level. That can also be achieved by selecting the Private checkbox of any activity. Read more about the protection of sensitive information here. readyForPiP: si el proceso está marcado como PiP. startsInPiP: si el proceso está configurado para iniciarse en PiP.
designOptions	projectProfile: el perfil de Studio utilizado cuando se creó el proyecto, ya sea Business (StudioX) o Desarrollo. outputType Muestra el tipo de proyecto, ya sea Proceso, Biblioteca o Pruebas. libraryOptions includeOriginalXaml: si se incluyen archivos del flujo de trabajo original en el archivo .nupkg resultante. privateWorkflows: el nombre completo de los archivos .xaml privados contenidos en la biblioteca. processOptions ignoredFiles: lista de archivos de flujo de trabajo RPA ignorados al publicar. fileInfoCollection: contiene la siguiente información para cada archivo de caso de prueba en el proceso): editingStatus (Publishable o InProgress), testCaseId y fileName. modernBehavior: si el proceso está configurado para usar la Experiencia de diseño moderno.
arguments	Contiene la siguiente información para cada argumento input y output definido en el archivo de flujo de trabajo que se establece como Principal: name, type y required si tiene un valor predeterminado (hasDefault). La Información de los argumentos se añade solo al archivo del paquete .nupkg después de publicar.
expressionLanguage	El idioma establecido para el proceso (VisualBasic o CSharp).
entryPoints	Contiene la siguiente información para cada archivo marcado como punto de entrada al proceso filePath, uniqueId. y la siguiente información para cada argumento input y output en el archivo: name, type, si es required, y si tiene un valor predeterminado (hasDefault). La Información de los argumentos se añade solo al archivo del paquete .nupkg después de publicar.
isTemplate	Si el proyecto es una plantilla.
templateProjectData	Contiene la siguiente información para proyectos de plantilla: defaultProjectDescription: la descripción del proyecto predeterminada para procesos basados en la plantilla. defaultProjectName: el nombre del proyecto predeterminado para procesos basados en la plantilla.

Lo que sigue es un ejemplo del contenido de un archivo project.json incluido en un paquete publicado desde Studio.

{
  "name": "UI-40028",
  "description": "Blank Process",
  "main": "Flowchart.xaml",
  "dependencies": {
    "UiPath.Excel.Activities": "[2.9.3]",
    "UiPath.Mail.Activities": "[1.9.3]",
    "UiPath.System.Activities": "[20.10.1]",
    "UiPath.UIAutomation.Activities": "[20.10.6]"
  },
  "webServices": [],
  "entitiesStores": [],
  "schemaVersion": "4.0",
  "studioVersion": "20.10.2.0",
  "projectVersion": "1.0.1",
  "runtimeOptions": {
    "autoDispose": false,
    "isPausable": true,
    "requiresUserInteraction": true,
    "supportsPersistence": false,
    "excludedLoggedData": [
      "Private:*",
      "<em>password</em>"
    ],
    "executionType": "Workflow",
    "readyForPiP": false,
    "startsInPiP": false
  },
  "designOptions": {
    "projectProfile": "Developement",
    "outputType": "Process",
    "libraryOptions": {
      "includeOriginalXaml": false,
      "privateWorkflows": []
    },
    "processOptions": {
      "ignoredFiles": []
    },
    "fileInfoCollection": [],
    "modernBehavior": false
  },
  "arguments": {
    "input": [
      {
        "name": "argument1",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      },
      {
        "name": "argument2",
        "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
        "required": false,
        "hasDefault": false
      }
    ],
    "output": []
  },
  "expressionLanguage": "VisualBasic",
  "entryPoints": [
    {
      "filePath": "Main.xaml",
      "uniqueId": "5289efb0-f8bc-42f3-8cf4-0caa3a7d1915",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    },
    {
      "filePath": "Flowchart.xaml",
      "uniqueId": "d0904ba0-506e-437d-979c-b9da4325faad",
      "input": [
        {
          "name": "argument1",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        },
        {
          "name": "argument2",
          "type": "System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089",
          "required": false,
          "hasDefault": false
        }
      ],
      "output": []
    }
  ],
  "isTemplate": false,
  "templateProjectData": {},
  "publishData": {}
}