Automatización
La Automatización es un aspecto omnipresente de la plataforma LogicalDOC y representa la forma en que puede programar las cosas utilizando un simple lenguaje de scripting. A veces desearás que LogicalDOC ejecute tu propia lógica cuando ocurre algo especial durante un flujo de trabajo o en reacción a eventos específicos ocurridos dentro del repositorio: con la Automatización puedes inyectar tu propio algoritmo para tomar las acciones apropiadas automáticamente. Muchos objetos admiten Automatización y le permiten definir scripts personalizados de Automatización (carpetas, flujos de trabajo, correos electrónicos, etc.)
Para utilizar esta función, debe tener un mínimo de conocimientos de programación. Por favor, mire la guía Sintaxis de la Automatización para familiarizarse con la sintaxis. También puede ver los Ejemplos de Automatización.
En el script de automatización puede hacer referencia a las siguientes variables(algunas dispobibles solamente en ciertos contextos):
| CONTEXTO DE AUTOMATIZACIÓN: GENERAL | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| nl | String | representa la nueva línea |
| product | String | nombre del producto |
| locale | Locale | locale actual |
| CURRENT_DATE | Date | fecha actual |
| tenantId | long | identificador del tenant |
| dictionary | Map | mapa con todas las variables (nombre_variable > valor) |
| keys | Set | conjunto de todas las claves en el diccionario |
| parameters | Map | mapa con todos los parámetros de invocación de la rutina (nombre_parámetro> valor) |
| parametersnames | Set | conjunto de todos los nombres de los parámetros de invocación de la rutina |
| systemDictionary | Map | Un mapa transitorio y de todo el sistema útil para almacenar datos entre ejecuciones de automatización |
| log | LogTool | da acceso al registro del sistema |
| I18N | I18NTool | handles the translations |
| DateTool | AutomationDateTool | manipulación y formateo de fechas |
| NumberTool | AutomationNumberTool | formatea un número usando el formato dado |
| CollectionTool | CollectionTool | métodos de utilidad para trabajar con colecciones |
| RegexTool | RegexTool | funciones para manipular expresiones regulares |
| DocTool | DocTool | maneja documentos y recursos relacionados |
| FolderTool | FolderTool | maneja carpetas y recursos relacionados |
| ClassTool | ClassTool | crea nuevas instancias de la clase dada |
| SystemTool | SystemTool | funciones para interactuar con el sistema operativo |
| MailTool | MailTool | funciones para enviar correos electrónicos |
| BarcodeTool | BarcodeTool | clase para extraer el contenido del código de barras de los documentos |
| StampTool | StampTool | aplica sellos en documentos |
| SignTool | SignTool | firma digitalmente un documento con el certificado digital del usuario |
| AutomationTool | AutomationTool | ejecuta una rutina de automatización en el mismo proceso de ejecución o en uno nuevo |
| ContextTool | ContextTool | métodos para acceder al contexto de la Aplicación |
| SplitTool | SplitTool | permite la división de un PDF en segmentos usando diferentes políticas |
| SecurityTool | SecurityTool | maneja algunas operaciones relacionadas con la seguridad |
| WorkflowTool | WorkflowTool | métodos para manejar flujos de trabajo e interactuar con ellos |
| WebsocketTool | WebsocketTool | funciones de utilidad para interactuar con la interfaz de usuario |
| UserTool | UserTool | métodos de utilidad para manejar algunas operaciones relacionadas con el usuario |
| SearchTool | SearchTool | métodos de utilidad para hacer búsquedas |
| FormTool | FormTool | métodos de utilidad para manejar formularios |
| ReportTool | ReportTool | métodos de utilidad para ejecutar informes personalizados |
| CalendarTool | CalendarTool | métodos de utilidad para manejar los eventos del calendario |
| StringTool | StringTool | herramienta para tratar con cadenas de texto |
| CONTEXTO DE AUTOMATIZACIÓN: FLUJO DE TRABAJO | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| candidates | User | lista de usuarios candidatos de la tarea actual |
| documents | Document | lista de los documentos adjuntos |
| document | Document | primer elemento de la lista documents |
| task | Task | la tarea actual |
| taskName | String | nombre de la tarea actual |
| initiator | User | el usuario que inició el flujo de trabajo |
| workflow | String | nombre del flujo de trabajo |
| processId | String | identificador del proceso actual |
| definitionId | String | identificador de la definición del proceso |
| actions | List | lista de posibles acciones(transiciones) declaradas para la tarea actual |
| action | String | nombre de la acción(transición) actual, solo disponible dentro de la transición |
| assignee | User | usuario asignado a la tarea actual |
| CONTEXTO DE AUTOMATIZACIÓN: ID PERSONALIZADO / AUTO NOMBRAMIENTO / CARPETA AUTOMÁTICA | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| document | el documento que se guarda actualmente | |
| set here the value to replace in the scheme's token | ||
| CONTEXTO DE AUTOMATIZACIÓN: ACCIONES PERSONALIZADAS | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| user | User | el usuario actualmente conectado |
| session | la sesión actual | |
| document | el documento seleccionado | |
| documents | los documentos seleccionados | |
| folder | la carpeta seleccionada | |
| folders | las carpetas seleccionadas | |
| CONTEXTO DE AUTOMATIZACIÓN: IMPORTACIÓN EMAIL | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| el correo electrónico que se importa | ||
| account | la cuenta desde la que se importa el correo electrónico | |
| message | la representación del mensaje devuelta por el servidor de correo | |
| document | el documento que se utilizará para guardar el correo electrónico en el repositorio | |
| documents | lista de documentos que se utilizarán para guardar el correo electrónico y sus archivos adjuntos en el repositorio | |
| CONTEXTO DE AUTOMATIZACIÓN: OCR ZONAL | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| document | el documento procesado | |
| sample | el texto extraído de la zona | |
| value | el objeto de valor (String, Date, Decimal ...) convertido de la muestra | |
| zone | la zona que se está procesando, use zone.value si desea cambiar el valor que se guardará en el documento | |
| CONTEXTO DE AUTOMATIZACIÓN: AUTENTICACIÓN EXTERNA | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| ldapUser | el usuario siendo autenticado | |
| CONTEXTO DE AUTOMATIZACIÓN: FORMULARIOS WEB | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| form | el formulario que se está procesando | |
| template | la plantilla asociada al formulario | |
| sender | User | el usuario remitente |
| responder | dirección de correo electrónico del respondedor | |
| title | el título del formulario web | |
| description | descripción del formulario web | |
| footer | el pie de página del formulario web | |
| message | cuerpo del mensaje de correo electrónico | |
| prefilled | Map | un mapa que contiene respuestas precargadas (usado al invitar a personas) |
| CONTEXTO DE AUTOMATIZACIÓN: SELLOS | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| stamp | el sello que se aplica | |
| user | El usuario que aplica el sello | |
| document | El documento que se estampa | |
| parameters | mapa con todos los parámetros ingresados por el usuario (nombre del parámetro> valor) | |
| parametersnames | conjunto de todos los nombres de los parámetros ingresados | |
| page | Integer | número de página actual |
| DATE | fecha actual formateada usando la configuración regional del usuario | |
| TIMESTAMP | marca de tiempo actual formateada con la configuración regional del usuario | |
| AUTOMATION CONTEXT: VALIDACIÓN | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| object | ExtensibleObject | el objeto bajo validación, por ejemplo un Document o un Folder |
| event | History | el evento actual |
| errors | mapa de cuerdas. Clave es el nombre del atributo, Valor es la descripción del error | |
| attributeName | nombre del atributo actual que se está validando (solo disponible en el validador de atributo) | |
| attribute | Attribute | el atributo actual que se está validando (solo disponible en el validador de atributos) |
| value | valor del atributo actual que se está validando (solo disponible en el validador de atributo) | |
| error | ValidationError | mantiene la descripción del error del atributo actual que se está validando (solo disponible en el validador de atributo) |
| AUTOMATION CONTEXT: INICIALIZACIÓN | ||
|---|---|---|
| Variable | Clase Java | Descripción |
| object | ExtensibleObject | el objeto bajo inicialización, por ejemplo un Document o un Folder |
| event | History | el evento actual |
| attributeName | nombre del atributo actual que se está inicializando | |
| attribute | Attribute | el atributo actual que se está inicializando |