Estándares para contenido de calidad

Identifying the use case

El caso de uso ideal para una automatización lista para usar son los procesos de automatización atendida que permiten a cada empleado de una organización o departamento beneficiarse de esa automatización.

Antes de poner a cero en un caso de uso particular, el desarrollador debe preguntar:

• si permitiría a los empleados delegar tareas que hacen cada día en su robot, como programar reuniones, investigar y ejecutar informes, o analizar, gestionar y mantener datos.
• si les daría a los empleados un fácil acceso a la automatización.

Un ejemplo típico de dicho proceso son los casos de uso relacionados con la productividad del trabajo en los que un empleado puede activar un robot atendido usando el Assistant que le enviará rápidamente un formulario con respecto a los asistentes a la reunión, la descripción y las limitaciones de tiempo. El robot toma esta información y compara automáticamente las opciones entre los invitados y los calendarios de la sala de reuniones. Las opciones de día, hora y sala de la reunión se presentan para la validación final por parte del usuario y, cuando se confirma, el robot envía invitaciones a la reunión.

Recommendations for high business value

• Se recomienda encarecidamente un caso de uso que pueda ejecutarse con software de propósito general, como MS Office, Adobe Acrobat Reader, Google Chrome, etc., ya que si funciona con software que se utiliza poco .
• Si la automatización demanda una necesidad inusualmente alta de formación para configurarla o usarla, sería un problema para el Citizen Developer ejecutarla incluso una vez. Hay muchas posibilidades de que otra categoría, como Actividad personalizada, Solución o Herramientas, sea potencialmente más adecuada para desarrollar dicho caso.
• El caso de uso debe ser universal y escalable. Por ejemplo, considere una automatización lista para usar que realiza el inicio de sesión automático para las aplicaciones de uso diario. Habrá una ventaja limitada si el ámbito se mantiene restringido a solo una o dos aplicaciones. Por lo tanto, debe proporcionar inicio de sesión automático para más aplicaciones o debe haber espacio para agregar más aplicaciones.

Developing the automation

Como regla general, los procesos de automatización atendida pueden ejecutarse con Assistant. Estos procesos deben diseñarse para que sean pequeños, fragmentados y puedan ejecutarse con supervisión humana.

The naming of the ready-to-go automation

• Al desarrollar el proceso para una automatización lista para usar a través de UiPath Studio, el "Nombre" y la "Descripción" del proyecto son de suma importancia. Cada automatización lista para usar:

  1. Debe tener un "nombre" empezando con una palabra de acción o un verbo. Debe ser descriptivo para que sea fácil para los usuarios entender el valor de inmediato.

  2. Debe tener una "Descripción" relevante y concisa de la funcionalidad.

  3. Mientras se desarrolla la automatización, el "Nombre" y la "Descripción" pueden introducirse a través del asistente "Configuración de Proyecto" en UiPath Studio, como se muestra a continuación.

     

     Importante:

     Para que un listado se publique en UiPath Marketplace, debe incluir en la Descripción del listado todos los detalles sobre los productos de UiPath que se utilizan en la automatización o que son compatibles con su automatización, y el papel que desempeñan.

     Los socios no podrán incluir los nombres de terceros o aplicaciones de terceros u otros productos de terceros en el texto de su listado o descripción del producto en UiPath Marketplace sin la autorización expresa del tercero.

Configuration and startup

En la primera ejecución, la automatización lista para usar debe mostrar una pantalla de "Información de inicio" que sugiere a los usuarios qué esperar de esta automatización, menciona cualquier requisito previo antes de ejecutar la automatización y proporciona instrucciones de uso.

• Algunos procesos de automatización atendida se ejecutan de la misma manera para todos, es decir, cuando el usuario hace clic en Iniciar en el Asistente, los pasos predefinidos se llevan a cabo sin ninguna variación. Pero en otros casos, la forma en que se ejecuta un proceso depende de parámetros que son únicos para el usuario o el contexto, como la dirección de correo electrónico, la ubicación de la carpeta o la cadena de un mensaje. En tales casos, el proceso debe ser creado por el desarrollador en UiPath Studio con argumentos o campos de entrada personalizables.
• Los detalles de configuración que generalmente no cambian para los usuarios de una máquina donde se ejecuta la automatización lista para usar, por ejemplo El servidor de correo electrónico, el puerto, la ruta del archivo, etc. deben estar disponibles como argumentos para Assistant en la pantalla "Mostrar detalles del proceso".
• UiPath Assistant solo puede mostrar los siguientes tipos de argumentos en la pantalla "Mostrar detalles del proceso"; por lo tanto, si es necesario pasar cualquier otro tipo como argumento, se puede usar un formulario para este propósito:
  • Int32: introduce un número.
  • Cadena: introduce texto.
  • Booleano: selecciona o borra una casilla de verificación.
  • DateTime: elige una fecha o hora.
• El flujo de trabajo no debe exponer ni registrar contraseñas.

Providing the status of the execution

El estado provisional de ejecución de la automatización lista para usar debe transmitirse en la pantalla a través de avisos, cuadros de mensaje de cierre automático o paneles en la esquina de la pantalla. Esta ventana debe permanecer en la parte superior de la pantalla mientras la automatización está en curso. Debe proporcionar mensajes de actualización cortos o una barra de progreso al usuario que interactúa con el asistente.

• Implementa el manejo de excepciones para que los usuarios reciban mensajes significativos cuando se produzcan errores.

• Si el resultado de la ejecución es un texto de salida, debe mostrarse en un cuadro de mensaje o formulario al usuario final como una cadena copiable.

  • For instance, the following listing [Shorten my URL link

    • RPA Component | UiPath Marketplace](https://marketplace.uipath.com/listings/2853) generates the output that can be copied for further use.

      

• Consider another listing Get a full path to my file - RPA Component | UiPath Marketplace. All output file paths are readable and copiable.

  

Publishing the process

Todas las automatizaciones listas para usar para Assistant deben publicarse como un paquete NuGet en UiPath Studio, ya que UiPath Assistant solo puede consumir paquetes NuGet.

Mejores prácticas

El paquete NuGet debe contener los siguientes metadatos:

• Etiquetas: estas son las etiquetas relevantes que indican la categoría / funcionalidad de la automatización.
• URL de licencia: especifica la URL de la licencia según el tipo de licencia que hayas seleccionado para tu automatización.
• Se debe marcar la marca de verificación de aceptación de la licencia.
• The name of the NuGet package should use the following convention: CompanyName.. If you are not affiliated with any company, you should use the following convention: .
• La versión de NuGet comienza a partir de 0.0. Cada cambio realizado antes de la publicación aumenta su índice "decimal". Por ejemplo, cuando publicamos la primera versión o una nueva versión de NuGet, la consideramos una actualización MAYOR, por lo que se convierte en la 1.0.
• El nombre de la etiqueta de Uipath no debe estar presente en el ID / dlls.
• Si el contenido está localizado, se debe especificar "Idiomas", incluso si el campo está marcado como Opcional.
• In case there is a need to edit the metadata after publishing the automation to a NuGet, then it can be done using NuGet Package Explorer.
• A user guide document containing the necessary information to run the automation should be provided. Here is a sample user guide template that can be downloaded and updated with the relevant information.
• A video demo showing the execution of the automation with UiPath Studio or UiPath Assistant should be provided. The guidelines for creating the video can be found on this page.

Testing the NuGet with Assistant

Para probar si un proceso desarrollado con UiPath Studio es compatible con UiPath Assistant, el primer paso es instalar el paquete NuGet de ese proceso en UiPath Assistant.

• Para instalar o actualizar el paquete NuGet desde la fuente de Orchestrator, el robot debe estar conectado a Orchestrator.

• Una vez que el paquete NuGet se ha instalado correctamente, el siguiente paso es configurar los campos de entrada personalizables.

• Si el proceso se desarrolla en UiPath Studio con algún argumento, los parámetros deben proporcionarse en los campos de entrada personalizables en UiPath Assistant. Se puede acceder a estos campos en el Asistente haciendo clic en "Mostrar detalles del proceso" en el menú de tres puntos del proceso correspondiente.

• Los valores proporcionados a estos campos se pueden guardar para que se utilicen estos valores la próxima vez que se ejecute la automatización.