Contenido

Estructura de tu Solution Accelerator

Tu Solution Accelerator debe ajustarse a la siguiente estructura de carpetas para mantener una experiencia coherente en todos los Solution Accelerators. Puede incluir cuatro carpetas:

1. Deployment (If the user experience is Attended, such as Test Data Management, this might not be included)
2. Documentación
3. Bibliotecas (si el proceso no incluye ninguna biblioteca, es posible que no se incluya)
4. Procesos

Aunque ciertos elementos son coherentes en cada Solution Accelerator (como la estructura de carpetas), tu Solution Accelerator puede verse influido por el caso de uso específico y los productos UiPath utilizados en Solution Accelerator. En la siguiente tabla se describen los elementos coherentes dentro de cada Solution Accelerator:

Implementación	Documentación	Librerías	Procesos
Detalles del activo Detalles de la cola Paquete de gestión de soluciones Cualquier archivo NUPKG de la biblioteca Cualquier actividad personalizada adicional	Solution Accelerator: descripción general del acelerador Solution Accelerator: guía de implementación Solution Accelerator: documentación técnica Diseño de soluciones de alto nivel (.pdf y archivo de edición original como .vsdx) Diseño detallado de la solución (.pdf y archivo de edición original como .vsdx)	Subcarpetas individuales para cada biblioteca	Subcarpetas individuales para cada proceso

2. Carpeta de implementación

a. Detalles del activo

Assets represent shared variables or credentials that can be used in different automation projects across a Solution Accelerator. Asset Details is a Microsoft Excel Workbook file (.xlsx) that is compatible with Orchestrator Manager, a tool that leverages Orchestrator’s API to manipulate entities. This workbook enables users to easily see and add assets which are used throughout your Solution Accelerator.

As per the example below this workbook is expected to have two sheets: Create to create Text, Bool, and Integer assets and Create Credential to create credential assets. The headers needed and order of headers for each sheet, along with the information inside each row, are defined in the tables below.

N/D	N/D	N/D	N/D	N/D	N/D	N/D	N/D	N/D
Folder Name1	Asset Name1	Description1	Scope1	Robot Name or User's Username1	Type1	Value1	Asset ID2	Result2
Procesamiento de órdenes de compra	Dispatcher_PurchaseOrdersEmailsSourceAccount	El buzón donde se encuentran los correos electrónicos de documentos de órdenes de compra que necesitamos procesar.	Global	N/D	Texto	PARA REEMPLAZAR CON UN VALOR ESPECÍFICO	N/D	N/D

¹0 Column receives input from the operation – such as names, types, and values of Assets to be created.

¹1 Column used by Orchestrator Manager to write data retrieved from Orchestrator, such as the IDs of created assets. Values here will be overwritten upon the next Create / Create Credential operation.

Crear

Folder Name 1	Asset Name 1	Description 1	Scope 1	Robot Name 1 or User's Username 1	Type 1	Value 1	Asset ID 2	Result 2
Al especificar los nombres de las subcarpetas de las carpetas modernas, es necesario introducir el nombre completo de la carpeta principal, incluidos sus antecesores, separados por el carácter de barra diagonal (/). Ejemplo: si una Carpeta moderna llamada "GrupoDeTrabajo1" es una subcarpeta de una Carpeta moderna llamada "DepartamentoA", entonces el nombre completo del GrupoDeTrabajo1 es "DepartamentoA/GrupoDeTrabajo1".	El nombre del activo. El nombre debe tener un máximo de 256 caracteres.	Descripción del activo. La descripción debe tener un máximo de 250 caracteres.	El campo Ámbito tiene un número fijo de valores posibles, según los ámbitos de activos disponibles en Orchestrator: Global Robot (solo disponible en Carpetas clásicas) Usuario (solo disponible en Carpetas modernas).	Al crear activos por robot, utiliza el campo Nombre del robot o Nombre de usuario del usuario para especificar el nombre del robot que debe tener acceso al valor del activo que se está definiendo. El robot debe estar en la misma carpeta que el activo por robot creado. Los valores para varios robots deben especificarse en filas independientes con el mismo nombre de carpeta, nombre de activo, ámbito y tipo.	El campo Tipo tiene un número fijo de valores posibles, según los tipos de activos disponibles en Orchestrator: Texto Booleano Entero	El valor del activo. Si los valores de los activos deben ser definidos por el usuario, deben escribirse como "PARA REEMPLAZAR POR UN VALOR ESPECÍFICO". Este campo debe tener: un máximo de 1 000 000 de caracteres para los tipos de texto un valor entre 2147483648 y 2147483648 para tipos enteros un valor de VERDADERO o FALSO para los tipos Bool.	El ID del activo creado si el activo se crea correctamente.	El resultado de la creación del activo: correcto o fallido.

¹2 Column receives input from the operation – such as names, types, and values of Assets to be created.

¹3 Column used by Orchestrator Manager to write data retrieved from Orchestrator, such as the IDs of created assets. Values here will be overwritten upon the next Create / Create Credential operation.

Crear credencial

Folder Name 1	Asset Name 1	Description 1	Scope 1	Robot Name or User's Username 1	Username 1	Password 1	Asset ID 2	Result 2
Al especificar los nombres de las subcarpetas de las carpetas modernas, es necesario introducir el nombre completo de la carpeta principal, incluidos sus antecesores, separados por el carácter de barra diagonal (/). Ejemplo: si una Carpeta moderna llamada "GrupoDeTrabajo1" es una subcarpeta de una Carpeta moderna llamada "DepartamentoA", entonces el nombre completo de "GrupoDeTrabajo1" es "DepartamentoA/GrupoDeTrabajo1".	El nombre del activo. El nombre debe tener un máximo de 256 caracteres.	Descripción del activo. La descripción debe tener un máximo de 250 caracteres.	El campo Ámbito tiene un número fijo de valores posibles, según los ámbitos de activos disponibles en Orchestrator: Global Robot (solo disponible en Carpetas clásicas) Usuario (solo disponible en Carpetas modernas).	Al crear activos por robot, utiliza el campo Nombre del robot o Nombre de usuario del usuario para especificar el nombre del robot que debe tener acceso al valor del activo que se está definiendo. El robot debe estar en la misma carpeta que el activo por robot creado. Los valores para varios robots deben especificarse en filas independientes con el mismo nombre de carpeta, nombre de activo, ámbito y tipo.	El campo de nombre de usuario. Como lo proporcionan los usuarios finales, este campo siempre debe contener "PARA REEMPLAZAR POR UN VALOR ESPECÍFICO" en cada fila.	El campo de contraseña. Como lo proporcionan los usuarios finales, este campo siempre debe contener "PARA REEMPLAZAR POR UN VALOR ESPECÍFICO" en cada fila.	El ID del activo creado si el activo se crea correctamente.	El resultado de la creación del activo: correcto o fallido.

¹4 Column receives input from the operation – such as names, types, and values of Assets to be created.

¹5 Column used by Orchestrator Manager to write data retrieved from Orchestrator, such as the IDs of created assets. Values here will be overwritten upon the next Create / Create Credential operation.

b. Detalles de la cola

A queue is a container that enables you to hold an unlimited number of items. Queue items can store multiple types of data, such as invoice information or customer details. Queues enable you to create large automation projects, such as Solution Accelerators, underlined by complex logic.

Queue Details is a Microsoft Excel Workbook file (.xlsx) that is compatible with Orchestrator Manager, a tool that leverages Orchestrator’s API to manipulate entities. This workbook enables users to easily see and add queues which are used throughout your Solution Accelerator

As per the example below this workbook is expected to have one sheet: Create to create all queues. The headers needed and order of headers for the sheet, along with the information inside each row, are defined in the table below. Orange header columns receive input from the operation – such as names, description, and max number of retries of queues to be created. Gray header columns are used by Orchestrator Manager to write data retrieved from Orchestrator, such as the IDs of created queues. Values here will be overwritten upon the next Create operation.

N/D	N/D	N/D	N/D	N/D	N/D	N/D	N/D
Nombre de la carpeta	Nombre de cola	Descripción	Unique Reference	Auto Retry	Max # of Retries	ID de activo	Resultado
When specifying names of subfolders of Modern Folders, it is necessary to input the complete name of the parent Folder, including its ancestors, separated by the forward slash character (/). Example: if a Modern Folder called “WorkGroup1” is a subfolder of a Modern Folder called “DepartmentA”, then the complete name of WorkGroup1 is “DepartmentA/WorkGroup1”.	The name of the Queue. The name cannot have any whitespace. The name must have a maximum of 50 characters.	Description of the Queue. The description must have a maximum of 250 characters.	Enforces transactions to have references which are unique. Must be either Yes or No.	Enables a transaction item within the Queue that fails with a system exception to be automatically retried. Must be either Yes or No.	The Maximum Number of Retries for a transaction item within the Queue. Must be at least 1 if Auto Retry is Yes. Can be an Integer between 1 and 50.	El ID de la cola creada si la cola se crea correctamente.	El resultado de la creación de la cola: éxito o fracaso.

c. Paquete de gestión de soluciones

A Solution Accelerator is a bundle of multiple components (processes, assets, queues, etc.) developed on the UiPath platform, that work together to automate a business use case. UiPath Solutions Management provides an out-of-the-box means to manage the lifecycle of Solution Accelerator components once built. This set of capabilities comes into play once development is finished for your Solution Accelerator, and you want to easily promote its components to a new environment.

Solutions Management allows you to conveniently package these components into a single file within the Orchestrator environment the Solution Accelerator was developed on. For a guide on how to create a Solution Management Package, please see the Creating a solution project.

Algunos requisitos y consideraciones al crear un paquete de gestión de soluciones para tu acelerador de soluciones:

• Cualquier Activo que sea Credencial debe contener un campo Nombre de usuario y Contraseña que tengan valores de "PARA REEMPLAZAR POR UN VALOR ESPECÍFICO", ya que estos son proporcionados por los usuarios finales.
• Cualquier activo que sea específico del usuario final, como las direcciones de correo electrónico de destino o las URL del entorno, también debe tener valores de "PARA REEMPLAZAR POR UN VALOR ESPECÍFICO".
• La convención de nomenclatura para el Zip de gestión de soluciones debe ser "Solution Accelerator Name 1.0.0" donde Solution Accelerator Name es el nombre del Solution Accelerator y donde 1.0.0 es la versión del proyecto de solución para el zip de Solution Management.
• Todos los depósitos de almacenamiento y desencadenadores se incluirán en el zip de gestión de soluciones. Los Depósitos de almacenamiento y los Desencadenadores no se pueden incluir en las implementaciones manuales y se debe indicar que se crearán manualmente en la documentación de la Guía de implementación.
• Processes should NOT be included within the Solution Management zip. Processes are expected to not work immediately without modification for environment and procedure specific enhancements to a Solution Accelerator.
• Si se espera que una biblioteca personalizada se modifique pase lo que pase, no debe incluirse en el paquete de gestión de soluciones, ya que no funcionará de inmediato sin modificaciones.

d. Archivos NUPKG de biblioteca

A library is a project which contains one or more workflows that can be reused as activities in other projects. This enables your Solution Accelerator to use common code throughout each individual process. For information on creating a library, see the Creating a Library section in the library documentation. For information about development standards on creating a library for Solution Accelerators, please see the library development section. A library is saved as NUPKG file when published and can be installed as a dependency from Package Manager. You can either publish a library to a local folder or publish and download from the NuGet package feed to retrieve the relevant NUPKG file.

Importante:

Si una biblioteca reutilizable está diseñada para funcionar sin necesidad de ninguna modificación, inclúyela en la carpeta Implementación.

If the library is expected to be modified to correctly work within the project, it’s expected to not be included in the Deployment folder and the Deployment Guide should make it clear that the library needs to be modified, published, and dependencies updated in any project using that library. If a reusable library is published separately on a feed, such as the UiPath Solution Accelerators Generic Reusables, you do not need to include the NUPKG file.

e. Cualquier actividad personalizada adicional

You can create your own custom activities that can be used in UiPath Studio projects. To use custom activities that are created, you must install the NuGet package that contains it in the Solution Accelerator project(s) by accessing Package Manager from UiPath Studio and installing the NUPKG. That NuGet package should be created upon finishing the custom activity. The NUPKG can be included within the Deployment folder of the Solution Accelerator.

3. Documentación

La estructura de la documentación debe seguir las siguientes directrices:

• Solution Accelerator: descripción general del acelerador
• Solution Accelerator: guía de implementación
• Solution Accelerator: documentación técnica
• Diseño de soluciones de alto nivel (.pdf y archivo de edición original como .vsdx)
• Diseño detallado de la solución (.pdf y archivo de edición original como .vsdx)

4. Bibliotecas

A UiPath Library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager. A Library can only be developed using a Library type of project. Any reusable UI components should also be implemented within a Library using Object Repository. Any Data Service entity should be imported within a Library so the same reference / namespace can be used throughout the entire Solution Accelerator by importing a Library. By importing the within a Library, namespaces will not be conflicting throughout different Processes.

Una biblioteca tiene los siguientes requisitos:

Tipo de proyecto	Proyectos de biblioteca
Tamaño del proceso y convención de nomenclatura del flujo de trabajo	XAML pequeños y bien definidos Denominación: utiliza una denominación "Escribir en mayúsculas cada palabra" (espacios intermedios) y no PascalCase. Si se prefiere PascalCase para los flujos de trabajo, la convención "Poner en mayúscula cada palabra" (restaurar los espacios al nombre de la actividad) aún se puede realizar a través del campo "Mostrar nombre" del "Diseño de la actividad" (haz clic con el botón derecho en la opción de menú Flujo de trabajo en el Explorador de proyectos ).
Anotaciones	Añadir anotaciones ancladas en cada archivo de flujo de trabajo como descargo de responsabilidad/explicación Anotar actividades con una explicación descriptiva adecuada
Convención de denominación de variables	Lower Camel Case (e.g., firstName, lastName, myOrganizationStructure )
Convención de denominación de argumentos	Arguments should be named using the PascalCase standard. The name of the arguments should NOT contain in_/out_/io_ prefix because those arguments will appear as properties when the Library is being created. Deben existir anotaciones para cada argumento, ya que esto se muestra cuando se utiliza una actividad de Biblioteca
Resultados del argumento	Un flujo de trabajo de biblioteca debe hacer lo que se describe en el nombre del flujo de trabajo Un flujo de trabajo debe analizar cualquier resultado de API o GUI y devolver el resultado de datos específico
Comentarios	Agregue comentarios para aumentar la legibilidad de los proyectos de la biblioteca
Entidad de Data Service	Las entidades de Data Service pueden importarse dentro de una biblioteca. El espacio de nombres debe ser el nombre de la entidad. Las operaciones de Data Service pueden ocurrir en una biblioteca para mejorar la reutilización de la entidad en todo el Solution Accelerator.
Manejo de excepciones	Los errores dentro de una biblioteca deben lanzarse como excepciones en lugar de señalarse mediante argumentos de salida. Confirme el resultado de un componente de biblioteca al final comprobando si se ha producido la acción deseada y lanzando una excepción si no es así.

5. Procesos

A process is a UiPath project developed using the process design option that can be executed by a UiPath Robot. Any new Process project should be either a Cross Platform Project or a Windows Project. Windows – Legacy uses an older version of the.NET Framework and will no longer be an option for new projects in the near future. Data Service Entities should not be imported within a Process. Importing within an individual process can cause conflicting namespaces throughout a Solution Accelerator.

Un proceso tiene los siguientes requisitos:

Tipo de proyecto	Proyectos Windows Proyectos multiplataforma
Tamaño del proceso	Procesos pequeños y bien delimitados
Anotaciones	Añade anotaciones ancladas en cada archivo de flujo de trabajo como descargo de responsabilidad/explicación. El formato típico describe cuál es el propósito del flujo de trabajo junto con una explicación de cada argumento para enviar, enviar y enviar/salir Anotar actividades con una explicación descriptiva adecuada
Convención de denominación de variables	Keeping a consistent variable naming convention throughout an automation process is important for readability and clarity El estándar típico que siguen los desarrolladores de UiPath es Minúscula Camel (por ejemplo, firstName, myFirstName, lastName, myOrganizationStructure)
Convención de denominación de argumentos	Lower Camel Case with a prefix stating the argument type as either in, out, or in/out, such as in_defaultTimeout, in_fileName, out_textResult, io_retryNumber . Las anotaciones deben existir para cada argumento, ya que se muestran cuando se invoca un flujo de trabajo
Comentarios	Agregue actividades de comentarios en los lugares adecuados para resaltar áreas de configuración/donde la lógica debe cambiarse en función de los escenarios del cliente
Entidad de Data Service	Las entidades de Data Service no deben importarse dentro de un proceso. Una entidad de Data Service debe importarse dentro de una biblioteca común para evitar conflictos de espacios de nombres. Las operaciones de Data Service pueden ocurrir en un proceso con un espacio de nombres que se importa desde una biblioteca.
Capas	Capa de aplicación (se puede utilizar API o Automatización de IU para una aplicación específica, sin embargo, esto queda a discreción del desarrollador) Capa de lógica empresarial/capa de implementación