Usar para cada tarefa de loop

Aviso: o Application Integration já está disponível para seu projeto do Google Cloud. Agora é possível usar a Apigee Integration e o Application Integration no mesmo projeto do Google Cloud. Saiba mais

Neste tutorial, mostramos como usar a tarefa "Para cada loop" na concatenação de strings. Neste tutorial, você criará duas integrações. uma integração principal e uma subintegração. A integração principal passa por uma matriz String e, para cada elemento na matriz, chama a subintegração que faz a concatenação. A saída depois de executar a integração principal é uma string concatenada.

Para concluir este tutorial, execute as seguintes tarefas:

• Crie a integração principal
• Criar variáveis na integração principal
• Criar a subintegração
• Criar variáveis na subintegração
• Configurar a subintegração
• Configurar e executar a integração principal

Criar a integração principal

Para criar uma nova integração, execute as seguintes etapas:

1. Acesse a IU da Apigee e faça login.
2. Selecione a organização usando o menu suspenso no canto superior esquerdo da IU.
3. Clique em Desenvolver > Integrações.
4. Clique em CRIAR NOVA.
5. Digite um nome e uma descrição na caixa de diálogo Criar integração.
   Observação: os nomes de integração precisam atender aos seguintes requisitos:

   • Os nomes precisam começar e terminar com letras ou números.
   • Os nomes não podem conter espaços ou mais de um traço ou sublinhado em uma linha.
6. Selecione uma Região para a integração na lista de regiões compatíveis.
7. Clique em Criar para abrir o designer de integração.
8. No designer de integração, clique em +Adicionar uma tarefa/gatilho > Acionador > Acionador da API.
9. Arraste o elemento Gatilho da API para o designer de integração.
10. Clique em +Adicionar uma tarefa/acionador > Tarefas > Para cada loop.
11. Arraste o elemento Para cada loop até o designer de integração.
12. Adicione uma conexão (borda) do elemento API Trigger ao elemento "Para cada loop":
    1. Clique no ícone Fork anexado à lateral do elemento gatilho da API.
    2. Ainda mantendo o ponteiro do mouse pressionado, arraste-o para uma região dentro do elemento Para cada loop.
    3. Solte o ponteiro do mouse.

Criar variáveis na integração principal

Crie as seguintes variáveis na integração principal:

• WordArray: uma matriz de strings. Os valores da matriz são enviados para a subintegração para concatenação.
• TempString: uma variável de string temporária.

Para criar o papel, execute as etapas a seguir:

1. Na integração principal, clique em VAR na barra de menus.
2. Clique em Adicionar.
3. Na caixa de diálogo Criar variável, defina as seguintes propriedades:
   • Nome: insira WordArray.
   • Tipo de dados: selecione String Array
   • Valor padrão: insira Hello, World, Apigee, Integrations
4. Clique em Criar.
5. Clique em Adicionar.
6. Na caixa de diálogo Criar variável, defina as seguintes propriedades:
   • Nome: insira TempString.
   • Tipo de dados: selecione String
7. Clique em Criar.
8. Clique em OK para fechar a caixa de diálogo Variáveis.

Criar a subintegração

Agora, crie uma subintegração (nova integração) que concatena a string.

Para criar a integração, execute estas etapas:

1. Na IU da Apigee, clique em Develop > Integrations.
2. Clique em CRIAR NOVA.
3. Digite um nome e uma descrição para a integração e clique em Create.
4. No designer de integração, clique em +Adicionar uma tarefa/gatilho > Acionador > Acionador da API.
5. Arraste o elemento Gatilho da API para o designer de integração.
6. Clique em +Adicionar uma tarefa/gatilho > Tarefas > Mapeamento de dados.
7. Arraste o elemento Mapeamento de dados para o designer de integração.
8. Adicione uma conexão (borda) do elemento gatilho da API ao elemento do mapeamento de dados.

Criar variáveis na subintegração

Crie as seguintes variáveis na subintegração:

• SubIntegrationInput: uma variável de entrada da integração. Quando a subintegração é executada, essa variável contém um valor da variável WordArray da integração principal.
• SubIntegrationOutput: uma variável de saída da integração. Quando a subintegração conclui uma execução, essa variável tem a string concatenada.
• SubIntegrationAnteriorValue: uma variável de entrada para manter a string concatenada intermitente para cada loop. Esse valor para essa variável é transmitido da integração principal.

Para criar um cluster, siga estas etapas:

1. Na integração principal, clique em VAR na barra de menus.
2. Clique em Adicionar.
3. Na caixa de diálogo Criar variável, defina as seguintes propriedades:
   • Nome: insira VARIABLE_NAME.
   • Tipo de dados: selecione String
4. Especifique se a variável é uma entrada ou uma variável de saída:
   • Se você estiver criando a variável SubIntegrationInput ou SubIntegrationAnteriorValue, selecione Usar como entrada para integração.
   • Se você estiver criando a variável SubIntegrationOutput, selecione Usar como saída da integração.
5. Clique em Criar.

Repita as etapas para criar cada variável na subintegração.

Configurar a subintegração

Para configurar a subintegração, execute as seguintes etapas:

1. Clique no elemento Data Mapping para visualizar o painel de configuração.
2. Clique em .
3. No Editor de mapeamento de dados:
   1. Arraste a variável SubIntegrationPreviousValue para a coluna Input.
   2. Na variável SubIntegrationAnteriorValue, clique em Adicionar função e selecione CONCAT.
   3. Arraste a variável SubIntegrationInput para a função CONCAT.
   4. Arraste a variável SubIntegrationOutput para a coluna Saída.
4. Feche o Editor de mapeamento de dados.
5. Clique em Publicar.

Configurar e executar a integração principal

Volte para a integração principal e configure-a para chamar a subintegração.

Para configurar a integração principal, siga estas etapas:

1. Abra a integração principal no designer de integração.
2. Clique no elemento Para cada loop para visualizar o painel de configuração da tarefa.
3. Defina as seguintes propriedades no painel de configuração:
   • Listar a iterar: selecione WordArray.
   • ID do acionador da API: insira o ID do gatilho da subintegração. Você pode obter o valor do ID do acionador no elemento Acionador da API da subintegração.
   • Nome da integração: insira o nome da sua subintegração.
   • Mapeamento de subintegração do elemento de iteração: selecione SubIntegrationInput.
   • Mapeamento de modificação de parâmetros de resposta:
     • NoSaída de subintegração a ser mapeada lista suspensa, selecione SubIntegrationOutput.
     • Na lista suspensa Variável de integração a ser modificada, selecione TempString.
   • Mapear entradas de subintegração adicionais:
     • Na lista suspensa Variável de integração a ser mapeada, selecione TempString.
     • Na lista suspensa Entrada de subintegração a ser mapeada, selecione SubIntegrationAnteriorValue.
4. Clique em Publicar.

Se a integração principal e a subintegração forem executadas com êxito, na caixa de diálogo de resumo da execução, será possível ver a string concatenada HelloWorldApigeeIntegrations na variável TempString.