Personalização de um workflow com parâmetros externos

Depois que o fluxo de trabalho é acionado, os parâmetros são assimilados nas variáveis de eventos e podem ser usados para personalizar as atividades do fluxo de trabalho.

Eles podem, por exemplo, ser usados para definir qual público-alvo ler na atividade Read audience , o nome do arquivo a ser transferido na atividade Transfer file etc. (consulte esta página).

Uso de variáveis de eventos

As variáveis de eventos são usadas em uma expressão que deve respeitar a Sintaxe padrão.

A sintaxe para usar variáveis de eventos deve seguir o formato abaixo e usar o nome do parâmetro que foi definido na atividade External signal (consulte Declaração dos parâmetros na atividade de sinal externo):

$(vars/@parameterName)

Nessa sintaxe, a função $ retorna o tipo de dados string. Se quiser especificar outro tipo de dados, use as seguintes funções:

  • $long: número inteiro.
  • $float: número decimal.
  • $boolean: true/false.
  • $datetime: timestamp.

Ao usar uma variável em uma atividade, a interface fornece ajuda para chamá-la.

  • : selecione a variável events entre todas as variáveis disponíveis no workflow.

  • : editar expressões que combinam variáveis e funções (consulte esta página).

    Esta lista fornece funções que permitem fazer uma filtragem complexa. Essas funções são detalhadas em this section.

    Além disso, você pode usar as funções abaixo, que estão disponíveis em todas as atividades que permitem usar variáveis de eventos após chamar um workflow com parâmetros externos (consulte esta seção):

    Nome Descrição Sintaxe
    EndWith Indica se uma string (primeiro parâmetro) termina com uma string específica (segundo parâmetro). EndWith(<Cadeia de caracteres>,<Cadeia de caracteres>)
    startWith Indica se uma string (primeiro parâmetro) começa com uma string específica (segundo parâmetro). startWith(<Cadeia de caracteres>,<Cadeia de caracteres>)
    Extract Retorna os primeiros caracteres de uma string usando um separador. Extract(<Cadeia de caracteres>,<Separador>)
    ExtractRight Retorna os últimos caracteres de uma string usando um separador. ExtractRight(<Cadeia de caracteres>,<Separador>)
    DateFormat Formata uma data usando o formato especificado no segundo parâmetro (por exemplo: '%4Y%2M%2D') DateFormat(<Data>,<Formato>)
    FileName Retorna o nome de um caminho de arquivo. FileName(<Cadeia de caracteres>)
    FileExt Retorna a extensão de um caminho de arquivo. FileExt(<Cadeia de caracteres>)
    GetOption Retorna o valor da função especificada. GetOption(<optionName>)
    IsNull Indica se uma string ou uma data é nula. IsNull(<Cadeia de caracteres/data>)
    UrlUtf8Encode Codifica um URL em UTF8. UrlUtf8Encode(<Cadeia De Caracteres>)

Personalização de atividades com variáveis de eventos

As variáveis de Eventos podem ser usadas para personalizar várias atividades, listadas na seção abaixo. Para obter mais informações sobre como chamar uma variável de uma atividade, consulte esta seção.

Read audience atividade : defina o público-alvo com base nas variáveis de eventos. Para obter mais informações sobre como usar a atividade, consulte esta seção.

Test atividade : crie condições com base nas variáveis de eventos. Para obter mais informações sobre como usar a atividade, consulte esta seção.

Transfer file atividade : personalize o arquivo a ser transferido com base nas variáveis de eventos. Para obter mais informações sobre como usar a atividade, consulte esta seção.

Query atividade : parâmetros podem ser referenciados em uma query usando expressões que combinam variáveis e funções de eventos. Para fazer isso, adicione uma regra e clique no link Advanced mode para acessar a janela de edição de expressão (consulte Advanced expression editing).

Para obter mais informações sobre como usar a atividade, consulte esta seção.

Channels atividades: personalize deliveries com base em variáveis de eventos.

OBSERVAÇÃO

Os valores dos parâmetros de delivery são recuperados toda vez que o delivery for preparado.

A preparação de deliveries recorrentes é baseada no período de agregação do delivery. Por exemplo, se o período de agregação for "por dia", o delivery será repreparado apenas uma vez por dia. Se o valor de um parâmetro de delivery for modificado durante o dia, ele não será atualizado no delivery, pois já foi preparado uma vez.

Se você planeja chamar o workflow várias vezes por dia, use a opção No aggregation para que os parâmetros de delivery sejam atualizados toda vez. Para obter mais informações sobre configuração de deliveries recorrentes, consulte esta seção.

Para personalizar um delivery com base nas variáveis de eventos, primeiro declare na atividade de delivery as variáveis que deseja usar:

  1. Selecione a atividade e clique no botão para acessar as configurações.

  2. Selecione a guia General e adicione as variáveis de eventos que estarão disponíveis como campos de personalização no delivery.

  3. Clique no botão Confirm.

As variáveis de eventos declaradas agora estão disponíveis na lista de campos de personalização. Você pode usá-los no delivery para executar as ações abaixo:

  • Defina o nome do template a ser usado para o delivery.

    OBSERVAÇÃO

    Essa ação está disponível somente para deliveries recorrentes.

  • Personalize o delivery: ao selecionar um campo de personalização para configurar um delivery, as variáveis de eventos ficam disponíveis no elemento Workflow parameters . Você pode usá-los como qualquer campo de personalização, por exemplo, para definir o assunto do delivery, o remetente etc.

    A personalização de delivery é detalhada em this section.

Códigos de segmento: defina o código do segmento com base nas variáveis de eventos.

OBSERVAÇÃO

Essa ação pode ser executada de qualquer atividade que permite definir um código de segmento como, por exemplo, Query ou Segmentation atividades.

Rótulo do delivery: defina o rótulo do delivery com base nas variáveis de eventos.

Nesta página