Referencia del proceso de flujo de trabajo

AEM proporciona varios pasos de proceso que se pueden utilizar para crear modelos de flujo de trabajo. También se pueden agregar pasos de proceso personalizados para tareas que no están cubiertas por los pasos integrados (consulte Creación de modelos de flujo de trabajo).

Características del proceso

Para cada paso del proceso, se describen las siguientes características.

Clase Java o Ruta ECMA

Los pasos del proceso se definen mediante una clase Java o un ECMAScript.

• Para los procesos de clase Java, se proporciona el nombre de clase completo.
• Para los procesos ECMAScript se proporciona la ruta al script.

Carga útil

La carga útil es la entidad sobre la que actúa una instancia de flujo de trabajo. La carga útil se selecciona implícitamente mediante el contexto dentro del cual se inicia una instancia de flujo de trabajo.

Por ejemplo, si se aplica un flujo de trabajo a una página AEM P, P se pasa de un paso a otro a medida que avanza el flujo de trabajo, y cada paso actúa de forma opcional sobre P de alguna manera.

En el caso más común, la carga útil es un nodo JCR en el repositorio (por ejemplo, una página AEM o un recurso). Una carga útil de Nodo JCR se pasa como una cadena que es una ruta JCR o un identificador JCR (UUID). En algunos casos, la carga útil puede ser una propiedad JCR (pasada como una ruta JCR), una URL, un objeto binario o un objeto Java genérico. Los pasos de proceso individuales que sí actúan en la carga útil generalmente esperan una carga útil de un tipo determinado o actúan de forma diferente según el tipo de carga útil. Para cada proceso descrito a continuación, se describe el tipo de carga útil esperado, si existe.

Argumentos

Algunos procesos de flujo de trabajo aceptan argumentos especificados por el administrador al configurar el paso de flujo de trabajo.

Los argumentos se introducen como una sola cadena en la propiedad Process Arguments del panel Properties del editor de flujo de trabajo. Para cada proceso descrito a continuación, el formato de la cadena del argumento se describe en una gramática EBNF simple. Por ejemplo, lo siguiente indica que la cadena de argumento consta de uno o más pares delimitados por comas, donde cada par consta de un nombre (que es una cadena) y un valor, separados por dos puntos:

    args := name '::' value [',' name '::' value]*
    name := /* A string */
    value := /* A string */

Tiempo de espera

Después de este periodo de tiempo de espera, el paso del flujo de trabajo ya no funciona. Algunos procesos de flujo de trabajo respetan el tiempo de espera, mientras que para otros no se aplica y se ignora.

Permisos

La sesión pasada a WorkflowProcess está respaldada por el usuario de servicio para el servicio de proceso de flujo de trabajo, que tiene los siguientes permisos en la raíz del repositorio:

• jcr:read
• rep:write
• jcr:versionManagement
• jcr:lockManagement
• crx:replicate

Si ese conjunto de permisos no es suficiente para la implementación WorkflowProcess, debe utilizar una sesión con los permisos necesarios.

La manera recomendada de hacerlo es utilizar un usuario de servicio creado con el subconjunto de permisos necesario, pero mínimo, de permisos necesarios.

Procesos de control de flujo de trabajo

Los siguientes procesos no realizan ninguna acción sobre el contenido. Sirven para controlar el comportamiento del propio flujo de trabajo.

AbsoluteTimeAutoAdvancer (Absolute Time Auto Advancer)

El proceso AbsoluteTimeAutoAdvancer (Absolute Time Auto Advancer) se comporta de manera idéntica a AutoAdvancer, excepto que se agota el tiempo de espera en una fecha y hora determinadas, en lugar de hacerlo después de un periodo de tiempo determinado.

• Clase Java: com.adobe.granite.workflow.console.timeout.autoadvance.AbsoluteTimeAutoAdvancer
• Carga útil: Ninguno.
• Argumentos: Ninguno.
• Tiempo de espera: El proceso agota el tiempo de espera al alcanzar la hora y la fecha establecidas.

AutoAdvancer (Auto Advancer)

El proceso AutoAdvancer avanza automáticamente el flujo de trabajo al paso siguiente. Si hay más de un posible paso siguiente (por ejemplo, si hay una división OR), este proceso avanzará en el flujo de trabajo a lo largo de la ruta predeterminada, si se ha especificado una, de lo contrario el flujo de trabajo no se avanzado.

• Clase Java: com.adobe.granite.workflow.console.timeout.autoadvance.AutoAdvancer

• Carga útil: Ninguno.

• Argumentos: Ninguno.

• Tiempo de espera: El tiempo de espera del proceso se agota después de establecer el tiempo de espera.

ProcessAssembler (Process Assembler)

El proceso ProcessAssembler ejecuta varios subprocesos secuencialmente en un solo paso del flujo de trabajo. Para utilizar ProcessAssembler, cree un solo paso de este tipo en el flujo de trabajo y establezca sus argumentos para indicar los nombres y argumentos de los subprocesos que desea ejecutar.

• Clase Java: com.day.cq.workflow.impl.process.ProcessAssembler

• Carga útil: Un recurso DAM, AEM página o ninguna carga útil (depende de los requisitos de los subprocesos).

• Argumentos:

        args := arg [',' arg]
        arg := processname ['::' processargs]
        processname := /* A fully qualified Java Class or absolute
        repository path to an ECMAScript */
        processargs := processarg [';' processarg]*
        processarg := '[' nobracketprocessarg ']' | nobracketprocessarg
        nobracketprocessarg := listitem [':' listitem]*
        listitem := /* A string */

• Tiempo de espera: Respetado.

Por ejemplo:

• Extraiga los metadatos del recurso.
• Cree tres miniaturas de los tres tamaños especificados.
• Cree una imagen JPEG a partir del recurso, suponiendo que el recurso no sea originalmente un GIF ni un PNG (en cuyo caso no se crea ningún JPEG).
• Establezca la fecha de la última modificación en el recurso.

com.day.cq.dam.core.process.ExtractMetadataProcess,
    com.day.cq.dam.core.process.CreateThumbnailProcess::[140:100];[48:48];[319:319:false],
    com.day.cq.dam.core.process.CreateWebEnabledImageProcess::dimension:1280:1280;mimetype:image/jpeg,
    com.day.cq.dam.core.process.AssetSetLastModifiedProcess

Procesos básicos

Los siguientes procesos realizan tareas sencillas o sirven de ejemplos.

delete

Se elimina el elemento de la ruta dada.

• Ruta de ECMAScript: /libs/workflow/scripts/delete.ecma

• Carga útil: Ruta de JCR

• Argumentos: Ninguna

• Tiempo de espera: Ignorado

noop

Este es el proceso nulo. No realiza ninguna operación, pero registra un mensaje de depuración.

• Ruta de ECMAScript: /libs/workflow/scripts/noop.ecma

• Carga útil: Ninguna

• Argumentos: Ninguna

• Tiempo de espera: Ignorado

rule-false

Se trata de un proceso nulo que devuelve false en el método check().

• Ruta de ECMAScript: /libs/workflow/scripts/rule-false.ecma

• Carga útil: Ninguna

• Argumentos: Ninguna

• Tiempo de espera: Ignorado

ejemplo

Este es un proceso ECMAScript de muestra.

• Ruta de ECMAScript: /libs/workflow/scripts/sample.ecma

• Carga útil: Ninguna

• Argumentos: Ninguna

• Tiempo de espera: Ignorado

urlcaller

Se trata de un proceso de flujo de trabajo sencillo que llama a la URL dada. Normalmente, la URL será una referencia a un JSP (u otro servlet equivalente) que realiza una tarea sencilla. Este proceso debe utilizarse únicamente durante el desarrollo y las demostraciones y no en un entorno de producción. Los argumentos especifican la dirección URL, el inicio de sesión y la contraseña.

• Ruta de ECMAScript: /libs/workflow/scripts/urlcaller.ecma

• Carga útil: Ninguna

• Argumentos:

        args := url [',' login ',' password]
        url := /* The URL to be called */
        login := /* The login to access the URL */
        password := /* The password to access the URL */

Por ejemplo: http://localhost:4502/my.jsp, mylogin, mypassword

• Tiempo de espera: Ignorado

LockProcess

Bloquea la carga útil del flujo de trabajo.

• Clase Java: com.day.cq.workflow.impl.process.LockProcess

• Carga útil: JCR_PATH y JCR_UUID

• Argumentos: ninguno

• Tiempo de espera: ignorado

El paso no tiene ningún efecto en las siguientes circunstancias:

• La carga útil ya está bloqueada
• El nodo de carga útil no contiene un nodo secundario jcr:content

DesbloquearProcess

Desbloquea la carga útil del flujo de trabajo.

• Clase Java: com.day.cq.workflow.impl.process.UnlockProcess

• Carga útil: JCR_PATH y JCR_UUID

• Argumentos: ninguno

• Tiempo de espera: ignorado

El paso no tiene ningún efecto en las siguientes circunstancias:

• La carga útil ya está desbloqueada
• El nodo de carga útil no contiene un nodo secundario jcr:content

Procesos de versiones

El siguiente proceso realiza una tarea relacionada con la versión.

CreateVersionProcess

Crea una nueva versión de la carga útil del flujo de trabajo (AEM página o recurso DAM).

• Clase Java: com.day.cq.wcm.workflow.process.CreateVersionProcess

• Carga útil: Una ruta JCR o UUID que hace referencia a una página o a un recurso DAM

• Argumentos: Ninguna

• Tiempo de espera: Respetado