Caso de uso use-case
O caso de uso abaixo mostra como chamar o workflow com parâmetros dentro dos workflows.
O objetivo é acionar um workflow a partir de uma chamada à API com parâmetros externos. Esse fluxo de trabalho carregará dados em seu banco de dados a partir de um arquivo e criará um público-alvo associado. Depois que o público-alvo for criado, um segundo workflow será acionado para enviar uma mensagem personalizada com os parâmetros externos definidos na chamada de API.
Para executar esse caso de uso, é necessário executar as ações abaixo:
- Fazer uma chamada de API para acionar o Workflow 1 com parâmetros externos. Consulte Etapa 1: configuração da chamada de API.
- Fluxo de trabalho de compilação 1: o workflow transferirá um arquivo e o carregará no banco de dados. Em seguida, ele testará se os dados estão vazios ou não e eventualmente salvará os perfis em um público-alvo. Por fim, ele acionará o Workflow 2. Consulte Etapa 2: configuração do workflow 1.
- Fluxo de trabalho de compilação 2: o fluxo de trabalho lerá o público-alvo criado no Fluxo de trabalho 1 e enviará uma mensagem personalizada para os perfis, com um código de segmento personalizado com os parâmetros. Consulte Etapa 3: configuração do workflow 2.
Pré-requisitos prerequisites
Antes de configurar os workflows, é necessário criar o Workflow 1 e 2 com um External signal atividade em cada um deles. Dessa forma, você poderá direcionar essas atividades de sinal ao chamar os workflows.
Etapa 1: configuração da chamada de API step-1--configuring-the-api-call
Faça uma chamada de API para acionar o Fluxo de trabalho 1 com parâmetros. Para obter mais informações sobre a sintaxe de chamada da API, consulte a Documentação das APIs REST do Campaign Standard.
No nosso caso, queremos chamar o workflow com os parâmetros abaixo:
- fileToTarget: o nome do arquivo que queremos importar para o banco de dados.
- descDesc: a descrição que queremos exibir no delivery do desconto.
-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/<TRIGGER_URL>
-H 'Authorization: Bearer <ACCESS_TOKEN>'
-H 'Cache-Control: no-cache'
-H 'X-Api-Key: <API_KEY>'
-H 'Content-Type: application/json;charset=utf-8'
-H 'Content-Length:79'
-i
-d {
-d "source:":"API",
-d "parameters":{
-d "fileToTarget":"profile.txt",
-d "discountDesc":"Running shoes"
-d }
Etapa 2: configuração do workflow 1 step-2--configuring-workflow-1
O fluxo de trabalho 1 será criado conforme abaixo:
- External signal activity: onde os parâmetros externos devem ser declarados para serem usados no workflow.
- Transfer file atividade: importa o arquivo com o nome definido nos parâmetros.
- Load file atividade: carrega dados do arquivo importado no banco de dados.
- Update data Atividade: inserir ou atualizar o banco de dados com dados do arquivo importado.
- Test activity: verifica se há dados importados.
- Save audience Atividade: se o arquivo contiver dados, salva os perfis em um público-alvo.
- End activity Atividade: chama o Workflow 2 com os parâmetros que você deseja usar dentro dele.
Siga as etapas abaixo para configurar o workflow:
-
Declarar os parâmetros que foram definidos na chamada à API. Para fazer isso, abra a variável External signal e, em seguida, adicione os nomes e tipos dos parâmetros.
-
Adicionar um Transfer file atividade para importar dados para o banco de dados.Para fazer isso, arraste e solte a atividade, abra-a e selecione a Protocol guia.
-
Selecione o Use a dynamic file path e, em seguida, use a fileToTarget como o arquivo a ser transferido:
code language-none $(vars/@fileToTarget)
-
Carregue os dados do arquivo no banco de dados.
Para fazer isso, arraste e solte uma Load file atividade no workflow e, em seguida, configure-a de acordo com suas necessidades.
-
Insira e atualize o banco de dados com os dados do arquivo importado.
Para fazer isso, arraste e solte um Update data e selecione a Identification para adicionar um critério de reconciliação (neste caso, o email campo).
-
Selecione o Fields to update e especifique os campos que serão atualizados no banco de dados (neste caso, o firstname e email campos).
-
Verifique se os dados foram recuperados do arquivo. Para fazer isso, arraste e solte uma Test atividade no workflow e, em seguida, clique na guia Add an element botão para adicionar uma condição.
-
Nomeie e defina a condição. Em nosso caso, queremos testar se a transição de saída contém dados com a sintaxe abaixo:
code language-none $long(vars/@recCount)>0
-
Se os dados forem recuperados, salve-os em um público-alvo. Para fazer isso, adicione um Save audience atividade para o O público alvo não está vazio e, em seguida, abra-a.
-
Selecione o Use a dynamic label e, em seguida, use a fileToTarget como o rótulo do público-alvo:
code language-none $(vars/@fileToTarget)
-
Arraste e solte um End atividade que chamará o Fluxo de trabalho 2 com parâmetros, e depois o abrirá.
-
Selecione o External signal e especifique o workflow a ser acionado e a atividade de sinal associada.
-
Defina os parâmetros que deseja usar no Workflow 2 e seus valores associados.
Em nosso caso, queremos transmitir os parâmetros originalmente definidos na chamada de API (fileToTarget e descDesc), e um adicional segmentCode com um valor constante ("desconto de 20%").
O fluxo de trabalho 1 está configurado, agora é possível criar o Fluxo de trabalho 2. Para obter mais informações, consulte esta seção.
Etapa 3: configuração do workflow 2 step-3--configuring-workflow-2
O fluxo de trabalho 2 será criado conforme abaixo:
- External signal activity: onde os parâmetros devem ser declarados para serem usados no workflow.
- Read audience Atividade: lê o público-alvo salvo no Fluxo de trabalho 1.
- Email delivery atividade: envia uma mensagem recorrente ao público-alvo direcionado, personalizada com parâmetros.
Siga as etapas abaixo para configurar o workflow:
-
Declare os parâmetros que foram definidos no Workflow 1.
Para fazer isso, abra a variável External signal e adicione o nome e o tipo de cada parâmetro definido na variável End atividade do Workflow 1.
-
Use o público que foi salvo no Fluxo de trabalho 1. Para fazer isso, arraste e solte uma Read audience atividade no workflow e, em seguida, abra-a.
-
Selecione o Use a dynamic audience e, em seguida, use a fileToTarget como o nome do público-alvo a ser lido:
code language-none $(vars/@fileToTarget)
-
Nomeie a transição de saída de acordo com o segmentCode parâmetro.
Para fazer isso, selecione a variável Transition e, em seguida, Use a dynamic segment code opção.
-
Use o segmentCode como o nome da transição de saída:
code language-none $(vars/@segmentCode)
-
Arraste e solte um Email delivery atividade para enviar uma mensagem ao público-alvo.
-
Identifique os parâmetros a serem usados na mensagem para personalizá-la com o descDesc parâmetro. Para fazer isso, abra as opções avançadas da atividade e adicione o nome e o valor do parâmetro.
-
Agora você pode configurar a mensagem. Abra a atividade e selecione Recurring email.
-
Selecione o template a ser usado e defina as propriedades do email de acordo com suas necessidades.
-
Use o descDesc como um campo de personalização. Para fazer isso, selecione-o na lista de campos de personalização.
-
Agora você pode concluir a configuração da mensagem e enviá-la como de costume.
Execução de workflows executing-the-workflows
Depois que os workflows forem criados, você poderá executá-los. Verifique se os dois workflows foram iniciados antes de executar a chamada de API.