Variáveis em fluxos de trabalho de AEM

Última atualização: 4 de fevereiro de 2025
  • Aplica-se a:
  • Experience Manager 6.5

Criado para:

  • Desenvolvedor

Uma variável em um modelo de fluxo de trabalho é uma maneira de armazenar um valor com base em seu tipo de dados. Em seguida, você pode usar o nome da variável em qualquer etapa do fluxo de trabalho para recuperar o valor armazenado na variável. Você também pode usar nomes de variáveis para definir expressões para tomar decisões de roteamento.

Em modelos de fluxo de trabalho AEM, é possível:

  • Crie uma variável de um tipo de dados com base no tipo de informações que você deseja armazenar nela.
  • Defina um valor para a variável usando a etapa de fluxo de trabalho Definir Variável.
  • Use a variável nas etapas de fluxo de trabalho OR Split e Goto AEM para que você possa definir uma expressão para tomar decisões de roteamento. Também é possível usar variáveis em todas as etapas do fluxo de trabalho do AEM Forms.

O vídeo a seguir demonstra como criar, definir e usar variáveis em modelos de fluxo de trabalho de AEM:

As variáveis são uma extensão da interface MetaDataMap. Você pode usar MetaDataMap no ECMAScript para acessar metadados salvos usando variáveis.

Criar uma variável

Você cria variáveis usando a seção Variáveis disponível no sidekick do modelo de fluxo de trabalho. As variáveis de fluxo de trabalho do AEM são compatíveis com os seguintes tipos de dados:

  • Tipos de dados primitivos: Long, Double, Boolean, Date e String
  • Tipos de dados complexos: XML e JSON
NOTE
Os fluxos de trabalho são compatíveis apenas com o formato ISO8601 para variáveis do tipo Date.

Para obter outros tipos de dados complexos disponíveis em fluxos de trabalho do AEM Forms, consulte Variáveis em fluxos de trabalho do AEM Forms. Use o tipo de dados ArrayList para criar coleções de variáveis. Você pode criar uma variável ArrayList para todos os tipos de dados primitivos e complexos. Por exemplo, crie uma variável ArrayList e selecione String como subtipo para armazenar vários valores de string usando a variável.

Para criar uma variável,

  1. Em uma instância do AEM, navegue até Ferramentas > Fluxo de trabalho > Modelos.

  2. Selecione Criar e especifique o título e um nome opcional para o modelo de fluxo de trabalho. Selecione o modelo e selecione Editar.

  3. Selecione o ícone de variáveis disponível no sidekick do modelo de fluxo de trabalho e selecione Adicionar variável.

    Adicionar variável

  4. Na caixa de diálogo Adicionar variável, especifique o nome e selecione o tipo da variável.

  5. Selecione o tipo de dados na lista suspensa Tipo e especifique os seguintes valores:

    • Tipo de dados primitivo - Especifique um valor padrão opcional para a variável.
    • JSON ou XML - especifique um caminho de esquema JSON ou XML opcional. O sistema valida o caminho do esquema enquanto mapeia e armazena as propriedades disponíveis nesse esquema para outra variável.
    • Modelo de dados de formulário - especifique um caminho de Modelo de dados de formulário.
    • ArrayList - Especifique um subtipo para a coleção.

  6. Especifique uma descrição opcional para a variável e selecione Ícone Salvar indicado por uma marca de seleção dentro de uma caixa. para salvar as alterações. A variável é exibida na lista disponível no painel esquerdo.

Ao criar variáveis, considere as seguintes práticas:

  • Crie quantas variáveis um fluxo de trabalho exigir. No entanto, para conservar recursos do banco de dados, use o número mínimo de variáveis necessárias e reutilize variáveis quando possível.
  • As variáveis fazem distinção entre maiúsculas e minúsculas. Certifique-se de fazer referência a variáveis usando a mesma capitalização no fluxo de trabalho.
  • Evite usar caracteres especiais no nome da variável

Definir uma variável

Você pode usar a etapa Definir variável para 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.

As alterações nos valores da variável afetam somente a instância do processo na qual a alteração ocorre. Por exemplo, quando um workflow é iniciado e os dados variáveis são alterados, as alterações afetam somente essa instância do workflow. As alterações não afetam outras instâncias do fluxo de trabalho que foram iniciadas anteriormente ou são iniciadas posteriormente.

Dependendo do tipo de dados da variável, você pode usar as seguintes opções para definir o valor de uma variável:

  • Literal: Use a opção quando você souber o valor exato a ser especificado.
  • Expressão: use a opção quando o valor a ser usado for calculado com base em uma expressão. A expressão é criada no editor de expressão fornecido.
  • Anotação JSON Dot: Use a opção para recuperar um valor de uma variável do tipo JSON ou FDM.
  • XPATH: Use a opção para recuperar um valor de uma variável do tipo XML.
  • Relativo à carga: use a opção quando o valor a ser salvo na variável estiver disponível em um caminho relativo à carga.
  • Caminho absoluto: Use a opção quando o valor a ser salvo na variável estiver disponível em um caminho absoluto.

Você também pode atualizar elementos específicos de uma variável do tipo JSON ou XML usando a notação JSON DOT ou XPATH.