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 um Propriedades da etapa caixa de diálogo 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, no 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 de etapa do fluxo de trabalho, no Usuário/Grupo da caixa de diálogo de propriedades:

Divisão E and-split

A variável E dividir cria uma divisão no fluxo de trabalho, depois da qual ambas as ramificações ficam 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 variável Etapa Ir para permite especificar a próxima etapa a ser executada no modelo de workflow. 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 variável Etapa Ir para permite implementar estruturas avançadas de roteamento em seus modelos de workflow. Por exemplo, para implementar um loop, a variável Etapa Ir para pode ser definido para executar uma etapa anterior no workflow, 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 integer no mapa de dados da instância do workflow. Para incrementar a contagem e comparar a contagem aos critérios de saída, use o script do 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. Criar um count variável do tipo de dados Long. Uso Expressão como o modo de mapeamento na variável Definir variável etapa para definir o valor de count variável para count + 1 em cada execução do Definir variável etapa.

No Etapa Ir para, use Definir variável como o Etapa do Target e contagem < 5 como a expressão de roteamento.

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

OU dividir or-split

A variável OU dividir 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

A Etapa do participante permite atribuir propriedade para 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 um Etapa do participante do diálogo para coletar informações do usuário atribuído ao 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 variável Item de trabalho concluído 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 do name A propriedade 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

A variável Etapa dinâmica do participante é semelhante a Etapa do 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 identifica 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 da Etapa dinâmica do 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 ParticipantStepChooser interface. 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 variável @Property A anotação define o valor do SERVICE_PROPERTY_LABEL campo para 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;
 }
}

No Etapa dinâmica do participante caixa de diálogo de propriedades, a caixa Seletor de participantes a lista inclui o item Workflow Initiator Participant Chooser (script), que representa esse 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, a variável admin usuário 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 variável Etapa do 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 do participante do formulário normalmente. 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 um Nome do elemento A propriedade armazena dados de campo como o valor da variável redirectTarget propriedade do jcr:content nó:

./jcr:content/redirectTarget

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

./jcr:content/par/text_3/text

O primeiro exemplo pode ser usado para qualquer página que cq:Page componente é renderizado. O segundo exemplo só pode ser usado quando a página de carga inclui um Texto componente com uma ID de 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 variável Seletor de participante aleatório etapa é um seletor de participantes 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 variável Seletor do participante iniciador do fluxo de trabalho a etapa é um seletor de participantes que atribui o item de trabalho gerado ao usuário que iniciou o fluxo de trabalho. Não há propriedades para configurar diferentes de Comum propriedades.

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

A Etapa do processo O 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: