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
VariableClase JavaDescripción
nlrepresenta la nueva línea
productnombre del producto
localelocale actual
CURRENT_DATEfecha actual
tenantIdidentificador del tenant
dictionarymapa con todas las variables (nombre_variable > valor)
keysconjunto de todas las claves en el diccionario
parametersmapa con todos los parámetros de invocación de la rutina (nombre_parámetro> valor)
parametersnamesconjunto de todos los nombres de los parámetros de invocación de la rutina
systemDictionaryUn mapa transitorio y de todo el sistema útil para almacenar datos entre ejecuciones de automatización
logLogToolda acceso al registro del sistema
I18NI18NToolhandles the translations
DateToolAutomationDateToolmanipulación y formateo de fechas
NumberToolAutomationNumberToolformatea un número usando el formato dado
CollectionToolCollectionToolmétodos de utilidad para trabajar con colecciones
RegexToolRegexToolfunciones para manipular expresiones regulares
DocToolDocToolmaneja documentos y recursos relacionados
FolderToolFolderToolmaneja carpetas y recursos relacionados
ClassToolClassToolcrea nuevas instancias de la clase dada
SystemToolSystemToolfunciones para interactuar con el sistema operativo
MailToolMailToolfunciones para enviar correos electrónicos
BarcodeToolBarcodeToolclase para extraer el contenido del código de barras de los documentos
StampToolStampToolaplica sellos en documentos
SignToolSignToolfirma digitalmente un documento con el certificado digital del usuario
AutomationToolAutomationToolejecuta una rutina de automatización en el mismo proceso de ejecución o en uno nuevo
ContextToolContextToolmétodos para acceder al contexto de la Aplicación
SplitToolSplitToolpermite la división de un PDF en segmentos usando diferentes políticas
SecurityToolSecurityToolmaneja algunas operaciones relacionadas con la seguridad
WorkflowToolWorkflowToolmétodos para manejar flujos de trabajo e interactuar con ellos
WebsocketToolWebsocketToolfunciones de utilidad para interactuar con la interfaz de usuario
UserToolUserToolmétodos de utilidad para manejar algunas operaciones relacionadas con el usuario
SearchToolSearchToolmétodos de utilidad para hacer búsquedas
FormToolFormToolmétodos de utilidad para manejar formularios
ReportToolReportToolmétodos de utilidad para ejecutar informes personalizados
CalendarToolCalendarToolmétodos de utilidad para manejar los eventos del calendario

CONTEXTO DE AUTOMATIZACIÓN: EVENTOS
VariableClase JavaDescripción
eventHistoryel evento actual
documentDocumentel documento asociado al evento actual (si lo hay)
folderFolderla carpeta asociada con el evento actual (si existe)

CONTEXTO DE AUTOMATIZACIÓN: FLUJO DE TRABAJO
VariableClase JavaDescripción
candidatesUserlista de usuarios candidatos de la tarea actual
documentsDocumentlista de los documentos adjuntos
documentDocumentprimer elemento de la lista documents
taskla tarea actual
taskNamenombre de la tarea actual
initiatorUserel usuario que inició el flujo de trabajo
workflownombre del flujo de trabajo
processIdidentificador del proceso actual
definitionIdidentificador de la definición del proceso
actionslista de posibles acciones(transiciones) declaradas para la tarea actual
actionnombre de la acción(transición) actual, solo disponible dentro de la transición
assigneeusuario asignado a la tarea actual

CONTEXTO DE AUTOMATIZACIÓN: ID PERSONALIZADO / AUTO NOMBRAMIENTO / CARPETA AUTOMÁTICA
VariableClase JavaDescripción
documentDocumentel documento que se guarda actualmente

CONTEXTO DE AUTOMATIZACIÓN: MENSAJE DE BIENVENIDA
VariableClase JavaDescripción
userUserel usuario actualmente conectado
sessionSessionla sesión actual

CONTEXTO DE AUTOMATIZACIÓN: DASHLETS
VariableClase JavaDescripción
userUserel usuario actualmente conectado
sessionSessionla sesión actual
dashletDashletel objeto dashlet

CONTEXTO DE AUTOMATIZACIÓN: ACCIONES PERSONALIZADAS
VariableClase JavaDescripción
userUserel usuario actualmente conectado
sessionSessionla sesión actual
documentDocumentel documento seleccionado
documentsDocumentlos documentos seleccionados
folderFolderla carpeta seleccionada

CONTEXTO DE AUTOMATIZACIÓN: IMPORTACIÓN EMAIL
VariableClase JavaDescripción
emailEMailel correo electrónico que se importa
accountEmailAccountla cuenta desde la que se importa el correo electrónico
messagela representación del mensaje devuelta por el servidor de correo
documentDocumentel documento que se utilizará para guardar el correo electrónico en el repositorio
documentsDocumentlista 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
VariableClase JavaDescripción
documentDocumentel documento procesado
sampleel texto extraído de la zona
valueel objeto de valor (String, Date, Decimal ...) convertido de la muestra
zoneZonela 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
VariableClase JavaDescripción
ldapUserLDAPUserel usuario siendo autenticado

CONTEXTO DE AUTOMATIZACIÓN: NUEVO DISPOSITIVO
VariableClase JavaDescripción
userUserel usuario actualmente conectado
deviceDeviceel dispositivo utilizado para iniciar sesión
clientClientel cliente remoto conectado a la plataforma
eventHistoryel evento de inicio de sesión

CONTEXTO DE AUTOMATIZACIÓN: FORMULARIOS
VariableClase JavaDescripción
formFormel formulario que se está procesando
documentDocumentel documento que contiene los metadatos

CONTEXTO DE AUTOMATIZACIÓN: FORMULARIOS WEB
VariableClase JavaDescripción
formFormel formulario que se está procesando
templateTemplatela plantilla asociada al formulario
senderUserel usuario remitente
responderdirección de correo electrónico del respondedor
titleel título del formulario web
descriptiondescripción del formulario web
footerel pie de página del formulario web
messagecuerpo del mensaje de correo electrónico
prefilledMapun mapa que contiene respuestas precargadas (usado al invitar a personas)

CONTEXTO DE AUTOMATIZACIÓN: BRANDING
VariableClase JavaDescripción
brandingBrandingel objeto que representa el branding
requestla solicitud HTTP que se está procesando
requestPathla ruta invocada por el cliente
userUserel usuario actualmente conectado
sessionSessionla sesión actual

CONTEXTO DE AUTOMATIZACIÓN: SPLITTING
VariableClase JavaDescripción
segmententero que representa el segmento actual
documentDocumentthe currently splitted document
eventHistoryel evento de split
policyla política de división elegida
expressionla expresión usada para dividir

CONTEXTO DE AUTOMATIZACIÓN: FIRMA DIGITAL
VariableClase JavaDescripción
documentDocumentel documento a firmar
reasonel motivo especificado para la firma
userUserel usuario que firma

CONTEXTO DE AUTOMATIZACIÓN: SELLOS
VariableClase JavaDescripción
stampStampel sello que se aplica
userUserEl usuario que aplica el sello
documentDocumentEl documento que se estampa
parametersmapa con todos los parámetros ingresados por el usuario (nombre del parámetro> valor)
parametersnamesconjunto de todos los nombres de los parámetros ingresados
pageIntegernúmero de página actual
DATEfecha actual formateada usando la configuración regional del usuario
TIMESTAMPmarca de tiempo actual formateada con la configuración regional del usuario
CONTEXTO DE AUTOMATIZACIÓN: CALENDARIO
VariableClase JavaDescripción
eventEventel evento en el calendario
reminderReminderel recordatorio actual

AUTOMATION CONTEXT: VALIDACIÓN
VariableClase JavaDescripción
objectExtensibleObjectel objeto bajo validación, por ejemplo un Document o un Folder
eventHistoryel evento actual
errorsmapa de cuerdas. Clave es el nombre del atributo, Valor es la descripción del error
attributeNamenombre del atributo actual que se está validando (solo disponible en el validador de atributo)
attributeAttributeel atributo actual que se está validando (solo disponible en el validador de atributos)
valuevalor del atributo actual que se está validando (solo disponible en el validador de atributo)
errorValidationErrormantiene la descripción del error del atributo actual que se está validando (solo disponible en el validador de atributo)

CONTEXTO DE AUTOMATIZACIÓN: ENVIAR CORREO
VariableClase JavaDescripción
senderUserel usuario que envía el mensaje de correo electrónico
documentDocumentprimer documento adjunto
documentsDocumentcolección de documentos adjuntos