Referência da Etapa do fluxo de trabalho workflow-step-reference

Os modelos de fluxo de trabalho consistem em uma série de etapas de vários tipos. De acordo com o tipo, essas etapas podem ser configuradas e estendidas com parâmetros e scripts para fornecer a funcionalidade e o controle necessários.

Propriedades da etapa step-properties

Cada componente da etapa tem uma caixa de diálogo Propriedades da Etapa que permite definir e editar as propriedades necessárias.

Propriedades da etapa - Guia Comum step-properties-common-tab

Uma combinação das seguintes propriedades está disponível para a maioria dos componentes da etapa do fluxo de trabalho, na guia Comum da caixa de diálogo de propriedades:

Propriedades da etapa - guia Usuário/Grupo step-properties-user-group-tab

As seguintes propriedades estão disponíveis para muitos componentes da etapa do fluxo de trabalho, na guia Usuário/Grupo da caixa de diálogo de propriedades:

Divisão E and-split

A AND Split cria uma divisão no fluxo de trabalho, depois da qual ambas as ramificações estão ativas. Adicione etapas do fluxo de trabalho a cada ramificação, conforme necessário. Essa etapa permite introduzir vários caminhos de processamento no fluxo de trabalho. Por exemplo, é possível permitir que determinadas etapas de revisão ocorram em paralelo, economizando tempo.

E Dividir - Configuração and-split-configuration

Para configurar a divisão:

Etapa do contêiner container-step

Uma etapa do contêiner inicia outro modelo de fluxo de trabalho que é executado como um fluxo de trabalho secundário.

Esse contêiner pode permitir que você reutilize modelos de fluxo de trabalho para implementar sequências comuns de etapas. Por exemplo, um modelo de fluxo de trabalho de tradução pode ser usado em vários fluxos de trabalho de edição.

Etapa do contêiner - Configuração container-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Etapa Ir para goto-step

A Etapa Ir para permite que você especifique a próxima etapa a ser executada no modelo de fluxo de trabalho. Você pode especificar uma definição de regra, um script externo ou um script ECMA como a expressão de roteamento para avaliar a próxima etapa do modelo de workflow.

A Etapa Ir para permite implementar estruturas avançadas de roteamento em seus modelos de fluxo de trabalho. Por exemplo, para implementar um loop, a Etapa Ir para pode ser definida para executar uma etapa anterior no fluxo de trabalho, com a expressão de roteamento avaliando uma condição de loop.

Etapa Ir para - Configuração goto-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Simulação de um loop for simulating-a-for-loop

A simulação de um "loop for" requer que você mantenha uma contagem do número de iterações de loop que ocorreram:

Por exemplo, para implementar um fluxo de trabalho que execute uma ação em vários nós JCR, você pode usar um contador de loop como um índice para os nós. Para manter a contagem, armazene um valor integer no mapa de dados da instância de fluxo de trabalho. Para incrementar a contagem e comparar a contagem aos critérios de saída, use o script da Etapa Ir para.

function check(){
   var count=0;
   var keyname="loopcount"
   try{
      if (workflowData.getMetaDataMap().containsKey(keyname)){
        log.info("goto script: found loopcount key");
        count= parseInt(workflowData.getMetaDataMap().get(keyname))+1;
      }

     workflowData.getMetaDataMap().put(keyname,count);

     }catch(err) {
         log.info(err.message);
         return false;
    }
   if (parseInt(count) <7){
       return true;
   } else {
      return false;
   }
}

Simulação de um loop for usando a Definição de regra simulateforloop

Você também pode simular um loop for usando a Definição de Regra como a expressão de roteamento. Crie uma variável count do tipo de dados Long. Use Expression como modo de mapeamento na etapa Set Variable para definir o valor da variável count como count + 1 em cada execução da etapa Set Variable.

Na Etapa Ir para, use Set Variable como a Etapa de Destino e count < 5 como a expressão de roteamento.

A etapa Definir Variável é executada repetidamente, incrementando o valor da variável count em 1 em cada execução até que o valor atinja 5.

OU dividir or-split

A OU Split cria uma divisão no fluxo de trabalho, depois da qual apenas uma ramificação fica ativa. Essa etapa permite introduzir caminhos de processamento condicional no fluxo de trabalho. Adicione etapas do fluxo de trabalho a cada ramificação, conforme necessário.

OU Split - Configuração or-split-configuration

Para configurar a divisão:

Etapas e seletores do participante participant-steps-and-choosers

Etapa do participante participant-step

Uma Etapa de participante permite que você atribua a propriedade de uma ação específica. O fluxo de trabalho continua somente quando o usuário confirma manualmente a etapa. Esse workflow é usado quando você deseja que alguém atue no workflow. Por exemplo, uma etapa de revisão.

Embora não esteja diretamente relacionada, a autorização do usuário deve ser considerada ao atribuir uma ação; o usuário deve ter acesso à página que é a carga do fluxo de trabalho.

Etapa do participante - Configuração participant-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Etapa do participante do diálogo dialog-participant-step

Use uma Etapa do participante da caixa de diálogo para coletar informações do usuário ao qual foi atribuído o item de trabalho. Essa etapa é útil para coletar pequenas quantidades de dados que são usados posteriormente no fluxo de trabalho.

Ao concluir a etapa, a caixa de diálogo Concluir Item de Trabalho contém os campos que você define na caixa de diálogo. Os dados coletados nos campos são armazenados em nós da carga do fluxo de trabalho. As etapas subsequentes do fluxo de trabalho podem ler o valor no repositório.

Para configurar a etapa, especifique o grupo ou usuário ao qual atribuir o item de trabalho e o caminho para a caixa de diálogo.

Etapa do participante da caixa de diálogo - Configuração dialog-participant-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Etapa do participante da caixa de diálogo - Criação de uma caixa de diálogo dialog-participant-step-creating-a-dialog

Para criar uma caixa de diálogo, você deve criar a caixa de diálogo:

Etapa do participante do diálogo - Armazenamento de dados na carga dialog-participant-step-storing-data-in-the-payload

Você pode armazenar dados do widget na carga do fluxo de trabalho ou nos metadados do item de trabalho. O formato da propriedade name do nó do widget determina onde os dados são armazenados.

Etapa do participante do diálogo - Definição do diálogo dialog-participant-step-dialog-definition

Etapa dinâmica do participante dynamic-participant-step

O componente Etapa Dinâmica de Participante é semelhante à Etapa de Participante, com a diferença de que o participante é selecionado automaticamente em tempo de execução.

Para configurar a etapa, selecione um Seletor de Participantes que identifique o participante ao qual atribuir o item de trabalho, juntamente com uma caixa de diálogo.

Etapa dinâmica do participante - Configuração dynamic-participant-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Etapa dinâmica do participante - Desenvolvendo o seletor de participantes dynamic-participant-step-developing-the-participant-chooser

Você cria o seletor de participantes. Portanto, é possível usar qualquer lógica ou critério de seleção. Por exemplo, seu seletor de participantes pode selecionar o usuário (dentro de um grupo) que tem menos itens de trabalho. Você pode criar qualquer número de seletores de participantes para usar com instâncias diferentes do componente Etapa dinâmica de participante em seus modelos de fluxo de trabalho.

Crie um serviço OSGi ou um ECMAScript que selecione um usuário ao qual atribuir o item de trabalho.

Etapa dinâmica do participante - Exemplo de serviço do seletor de participantes dynamic-participant-step-example-participant-chooser-service

A seguinte classe Java™ implementa a interface ParticipantStepChooser. A classe retorna o nome do participante que iniciou o workflow. O código usa a mesma lógica que o script de exemplo (initiator-participant-chooser.ecma) usa.

A anotação @Property define o valor do campo SERVICE_PROPERTY_LABEL como Workflow Initiator Participant Chooser.

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.osgi.framework.Constants;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import com.adobe.granite.workflow.WorkflowException;
import com.adobe.granite.workflow.WorkflowSession;
import com.adobe.granite.workflow.exec.ParticipantStepChooser;
import com.adobe.granite.workflow.exec.WorkItem;
import com.adobe.granite.workflow.metadata.MetaDataMap;

@Component
@Service
@Properties({
        @Property(name = Constants.SERVICE_DESCRIPTION, value = "An example implementation of a dynamic participant chooser."),
        @Property(name = ParticipantStepChooser.SERVICE_PROPERTY_LABEL, value = "Workflow Initiator Participant Chooser (service)") })
public class InitiatorParticipantChooser implements ParticipantStepChooser {

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public String getParticipant(WorkItem arg0, WorkflowSession arg1,
   MetaDataMap arg2) throws WorkflowException {

  String initiator = arg0.getWorkflow().getInitiator();
  logger.info("Assigning Dynamic Participant Step work item to {}",initiator);

  return initiator;
 }
}

Na caixa de diálogo de propriedades Etapa Dinâmica de Participante, a lista Seletor de Participante inclui o item Workflow Initiator Participant Chooser (script), que representa este serviço.

Quando o modelo de fluxo de trabalho é iniciado, o log indica a ID do usuário que iniciou o fluxo de trabalho e a quem foi atribuído o item de trabalho. Neste exemplo, o usuário admin iniciou o fluxo de trabalho.

13.09.2015 15:48:53.037 *INFO* [10.176.129.223 [1347565733037] POST /etc/workflow/instances HTTP/1.1] com.adobe.example.InitiatorParticipantChooser Assigning Dynamic Participant Step work item to admin

Etapa de participante do formulário form-participant-step

A Etapa de participante do formulário apresenta um formulário quando o item de trabalho é aberto. Quando o usuário preenche e envia o formulário, os dados do campo são armazenados nos nós da carga do fluxo de trabalho.

Para configurar a etapa, especifique o grupo ou usuário ao qual atribuir o item de trabalho e o caminho para o formulário.

Etapa de participante do formulário - Configuração form-participant-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Etapa de participante do formulário - Criação do formulário form-participant-step-creating-the-form

Crie um formulário para usar com uma Etapa de participante do formulário como de costume. No entanto, os formulários para uma Etapa de participante do formulário devem ter as seguintes configurações:

Os requisitos do fluxo de trabalho determinam onde você deve armazenar os dados de campo. Por exemplo, dados de campo podem ser usados para configurar as propriedades do conteúdo da página. O seguinte valor de uma propriedade Nome do Elemento armazena dados de campo como o valor da propriedade redirectTarget do nó jcr:content:

./jcr:content/redirectTarget

No exemplo a seguir, os dados do campo são usados como conteúdo de um componente Texto na página de carga:

./jcr:content/par/text_3/text

O primeiro exemplo pode ser usado para qualquer página que o componente cq:Page renderize. O segundo exemplo só pode ser usado quando a página de carga inclui um componente Texto com ID text_3.

O formulário pode estar localizado em qualquer lugar no repositório, no entanto, os usuários do fluxo de trabalho devem estar autorizados a ler o formulário.

Seletor de participante aleatório random-participant-chooser

A etapa Seletor de Participante Aleatório é um seletor de participante que atribui o item de trabalho gerado a um usuário selecionado aleatoriamente de uma lista.

Seletor de participante aleatório - Configuração random-participant-chooser-configuration

Para configurar a etapa, edite e use as seguintes guias:

Seletor do participante iniciador do fluxo de trabalho workflow-initiator-participant-chooser

A etapa Seletor de Participante Iniciador do Fluxo de Trabalho é um seletor de participantes que atribui o item de trabalho gerado ao usuário que iniciou o fluxo de trabalho. Não há propriedades a serem configuradas diferentes das propriedades Common.

Seletor do participante iniciador do fluxo de trabalho - Configuração workflow-initiator-participant-chooser-configuration

Para configurar a etapa, edite usando as seguintes guias:

Etapa do processo process-step

Uma Etapa do processo executa um ECMAScript ou chama um serviço OSGi para executar o processamento automático.

Etapa do processo - Configuração process-step-configuration

Para configurar a etapa, edite e use as seguintes guias:

Definir variável set-variable

A etapa Definir variável permite definir o valor de uma variável e a ordem na qual os valores são definidos. A variável é definida na ordem em que os mapeamentos de variável são listados na etapa Definir variável.

Definir variável - Configuração setvariable

Para configurar a etapa, edite e use as seguintes guias: