Documento del Proceso de Diseño (PDD)#
El Documento de Diseño de Proceso (PDD) es una plantilla para documentar procesos automatizados en Sherpa Designer.
El PDD se genera al hacer clic en el botón "Documentar..." en el menú "Proyecto".
La plantilla PDD se carga automáticamente en Sherpa Designer en el campo "Plantilla PDD" y no se modifica durante el proceso de generación del documento.
El PDD está destinado a describir los procesos actuales (AS IS) y los procesos objetivos (TO BE), así como parámetros y configuraciones.
- AS IS en la plantilla contiene un esquema y una descripción del proceso manual o parcialmente automatizado actual. Se registran los pasos reales, aplicaciones, roles de los empleados y cuellos de botella para su análisis antes de la robotización.
- TO BE incluye un esquema con el proceso automatizado (bloques de Sherpa Designer, secuencia de acciones, número de pasos) y refleja el proceso final con integraciones de Sherpa Orchestrator y estadísticas de bloques.
- Los parámetros incluyen tablas que contienen datos destinados a ser transferidos entre bloques y esquemas JSON.
- Las configuraciones incluyen: credenciales, banderas, estadísticas sobre el funcionamiento de los bloques y su interacción, datos de Sherpa Orchestrator y registro.
Estructura de la plantilla#
La plantilla incluye secciones con tablas e imágenes de esquemas:
- Propósito del documento — la sección define el objetivo del PDD (documentación estandarizada de procesos RPA de Sherpa RPA para la transferencia de conocimientos entre desarrolladores, analistas y partes interesadas).
- Control del documento — la sección permite rastrear cada cambio en el documento.
Contiene información sobre:
2.1. Historial de cambios — tabla con columnas "Fecha", "Versión", "Descripción breve de cambios", "Autor", "Rol". Registra la evolución del documento para auditoría y control.
 (1).png)
2.2. Personas de contacto — tabla que contiene una lista de responsables: "Nombre completo", "Rol", "Correo electrónico", lo que simplifica la comunicación sobre el proyecto.
 (1).png)
- Glosario — tabla para registrar términos, sus abreviaturas y definiciones, que permite estandarizar la terminología dentro del proyecto.
 (1).png)
- Información general sobre el proceso — tabla con métricas clave y características para evaluar la efectividad de la robotización.
 (1).png)
- Descripción del proceso AS IS — sección que proporciona información sobre el proceso actual antes de la automatización.
5.1. Información general — descripción del proceso actual con bloques e integraciones.
5.2. Esquema de alto nivel del proceso AS IS — imagen (650px) que muestra el esquema del proceso actual.
5.3. Descripción de los pasos del proceso AS IS — tabla con detalles de los pasos del proceso actual, acciones de los usuarios y software utilizado.
 (1).png)
- Descripción del proceso TO BE — sección que proporciona información sobre el proceso automatizado.
6.1. Descripción general del proceso robotizado — descripción del proceso optimizado con bloques e integraciones.
6.2. Esquema de alto nivel del proceso TO BE — imagen (650px) que muestra el esquema del proceso automatizado.
 (1).png)
- Entorno y sistemas de TI interactuantes — tabla que describe los sistemas involucrados en el proceso: nombres de los sistemas, inicios de sesión y contraseñas para el acceso del robot, así como servicios externos y bloques correspondientes de Sherpa Designer: nombres de los servicios, nombres de los bloques de automatización, paletas.
 (1).png)
- Datos de entrada — tabla que describe los parámetros que llegan al robot para realizar tareas dentro del proceso, así como el lugar de almacenamiento de datos y un ejemplo del archivo que los contiene.
 (1).png)
- Datos de salida (Informes de trabajo de los robots) — tabla que describe los parámetros que se generan como resultado del trabajo del robot y se transmiten en forma de informes del proceso, así como el lugar de almacenamiento de datos y un ejemplo del archivo que los contiene.
.png)
- Estructura de carpetas del proyecto — tabla que describe la estructura de carpetas del proyecto.
.png)
- Diagramas del proyecto — dos tablas, la primera de las cuales describe los diagramas clave en el proceso presentado, y la segunda describe cada diagrama por separado, así como la cantidad de bloques diferentes que lo componen.
.png)
- Estadísticas de bloques — tabla que contiene datos sobre la cantidad de ejecuciones de bloques de Sherpa Designer involucrados en este proceso.
.png)
- Bibliotecas dependientes — tabla que contiene datos sobre las bibliotecas utilizadas por el robot en el proceso de su trabajo, así como su lenguaje y propósito.
.png)
- Trabajo con el Orquestador — sección que contiene información sobre la configuración de colas, activos, horarios de Sherpa Orchestrator.
14.1. Lista de colas utilizadas en el proyecto — tabla que describe la configuración de las colas de Sherpa Orchestrator para cada bloque del robot.
.png)
14.2. Activos. Variables de Orchestrator (Assets) — subsección en la que se registra la vinculación de bloques de Sherpa Designer a activos de Sherpa Orchestrator.
14.3. Credenciales — tabla que describe las credenciales que utiliza el robot para interactuar con Sherpa Orchestrator.
.png)
14.4. Otras variables — tabla que describe las variables que utiliza el robot en el proceso (al trabajar con Sherpa Orchestrator).
.png)
- Registro — sección en la que se documentan todos los puntos de registro del robot Sherpa RPA para monitoreo, depuración y auditoría.
15.1. Registro NLog — configuración nlog.config.xml, que contiene rutas de logs. Define la rotación y niveles (Info, Error, Debug) del registro de archivos.
15.2. Puntos de registro local — tabla que describe los bloques, al ejecutar el robot localmente, que recopilan datos sobre los diagramas y los errores que surgen en ellos.
.png)
15.3. Puntos de registro en Orquestador — tabla que describe los bloques, al registrar en Sherpa Orchestrator, que recopilan datos sobre los diagramas y los errores que surgen en ellos. También incluye capturas de pantalla y niveles de mensajes salientes.
.png)
- Inicios de sesión y contraseñas para los sistemas — tabla que presenta todos los inicios de sesión y contraseñas necesarios para acceder a los sistemas y servicios utilizados en el proceso de trabajo del robot.
.png)
Modo de operación del robot — tabla que describe los horarios y configuraciones de inicio del robot en Sherpa Orchestrator.
.png)
Errores durante la operación del robot — en esta sección se presentan descripciones de errores que son procesados por el robot o son fallos del sistema, lo que permite entender el algoritmo de acciones ante diversos incidentes.
18.1. Procesados por los robots (incorporados en la lógica del proceso) — tabla que describe el comportamiento del usuario ante fallos incorporados en la lógica del proceso.
.png)
18.2. Fallos del sistema y otros errores — tabla que describe el comportamiento del usuario ante fallos del sistema.
.png)
Generación de PDD#
Información detallada sobre la generación del documento está disponible en el siguiente enlace: