Consulte os conetores suportados para a solução Application Integration.

Ouvir o tópico do Cloud Pub/Sub e enviar um email

Saiba como criar uma integração de exemplo com a integração de aplicações e o acionador do Cloud Pub/Sub. Os passos seguintes descrevem como configurar o acionador, as tarefas, as variáveis e os mapeamentos de dados necessários para executar uma integração completa.

Vista geral

Neste início rápido, vai criar uma integração com um acionador do Cloud Pub/Sub para ouvir um tópico do Pub/Sub existente que recebe leituras de temperatura em graus Kelvin de um dispositivo de IOT. Em seguida, pode usar a tarefa Mapeamento de dados para transformar a mensagem do Pub/Sub em graus Celsius e enviar o valor num email.

Antes de começar

Atribua as seguintes funções de gestão de identidade e de acesso (IAM) ao agente do serviço de integração de aplicações ([e-mail]) no seu Google Cloud projeto:

• Editor do Pub/Sub
• Application Integration Invoker

  Para mais informações sobre a atribuição de funções de IAM, consulte o artigo Funções e autorizações de IAM.

Configure o ambiente

Crie um novo tópico do Cloud Pub/Sub

Este guia de início rápido pressupõe que tem um tópico do Pub/Sub que recebe leituras de temperatura em graus Kelvin de um dispositivo de IOT. Não é necessário ter o tópico ligado a um dispositivo. Este início rápido testa a capacidade de a integração ouvir o tópico e realizar tarefas quando acionada.

Para criar um tópico de amostra para os fins deste início rápido:

1. Aceda à página de tópicos do Pub/Sub na Cloud Console.

   Aceda à página de tópicos do Pub/Sub

2. Clique em Criar um tópico.
3. No campo ID do tópico, indique um nome de tópico exclusivo. Por exemplo, temperaturesensor
4. Clique em Guardar.

Nota: não tem de criar uma subscrição para que o acionador funcione. A integração de aplicações cria automaticamente uma subscrição para um tópico quando publica a integração, e pode ver todas as suas subscrições na página de subscrição do Pub/Sub.

A partir da versão de 1 de dezembro de 2023, vai receber faturação pelas suas subscrições de acordo com as tarifas de faturação do Pub/Sub. As subscrições para o seu acionador do Cloud Pub/Sub existente continuam a funcionar como antes e não são faturadas. No entanto, se atualizar o tópico de um acionador do Cloud Pub/Sub existente, a faturação do Pub/Sub é aplicada ao acionador do Cloud Pub/Sub atualizado.

Crie uma nova integração

Para criar uma nova integração, siga estes passos:

1. Na Google Cloud Console, aceda à página Integração de aplicações.

   Aceda à solução Application Integration

2. Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
3. Clique em Criar integração.
4. Introduza um nome e uma descrição na caixa de diálogo Criar integração. Por exemplo, my-test-integration.
   Nota: os nomes das integrações têm de cumprir os seguintes requisitos:

   • Os nomes têm de começar e terminar com letras ou números.
   • Os nomes não podem conter espaços nem mais do que um travessão ou um caráter de sublinhado seguido.
5. Selecione uma região para a integração.
   Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
6. Clique em Criar para abrir o editor de integração.

Adicione um acionador do Cloud Pub/Sub

Para adicionar um acionador do Cloud Pub/Sub à integração, siga os passos abaixo:

1. No editor de integração, selecione Acionadores para apresentar uma lista de acionadores disponíveis.
2. Clique e coloque o elemento Acionador do Cloud Pub/Sub no criador.

Configure um acionador do Cloud Pub/Sub

Clique no elemento Acionador do Cloud Pub/Sub no editor de integração para ver o painel de configuração do acionador.

Especifique o tópico que o acionador deve ouvir no campo Tópico do Pub/Sub no seguinte formato:

projects/PROJECT_ID/topics/TOPIC_ID

where:

• PROJECT_ID é o projeto do Google Cloud onde o seu tópico é criado.
• TOPIC_ID é o ID do tópico do Cloud Pub/Sub que criou em Antes de começar.

Por exemplo, se o seu projeto se chamar my-project e tiver dado o nome temperaturesensor ao seu tópico, introduza:

projects/my-project/topics/temperaturesensor.

Para ver todos os tópicos disponíveis no seu projeto do Google Cloud, consulte a coluna Nome do tópico em Tópicos.

O painel de configuração do acionador do Cloud Pub/Sub preenche automaticamente o campo Saída do acionador com uma variável para conter a mensagem do Pub/Sub.

Adicione e configure a tarefa de mapeamento de dados

Para configurar a tarefa Mapeamento de dados:

1. Selecione Tarefas para apresentar uma lista de tarefas disponíveis.
2. Clique e coloque o elemento Mapeamento de dados no editor de integração.
3. Clique na tarefa Mapeamento de dados no criador para abrir o painel de configuração da tarefa.
4. Clique em Abrir editor de mapeamento de dados.

   O editor de mapeamento de dados permite-lhe mapear variáveis de entrada para as variáveis de saída desejadas, através das funções de transformação disponíveis. A saída fica, então, disponível como uma variável para qualquer outra tarefa de integração ou acionador. Para mais detalhes sobre a transmissão de dados como variáveis, consulte o artigo Usar variáveis na integração de aplicações.

   Para este início rápido, siga estes passos para criar um mapeamento usando o CloudPubSubMessage como entrada:

   1. Expanda a variável JSON CloudPubSubMessage na lista Variáveis e arraste a variável CloudPubSubMessage.data para a primeira linha Entrada.
   2. Clique em + (Adicionar uma função) junto à variável CloudPubSubMessage.data para ver a lista pendente de funções disponíveis.
   3. Selecione TO_DOUBLE() para converter o valor CloudPubSubMessage.data num tipo de dados double.
   4. Clique novamente em + (Adicionar uma função) para selecionar e encadear a função SUBTRACT.
   5. Introduza 273.15 como o valor da função SUBTRACT. Isto serve para converter a temperatura em Kelvin para graus Celsius.
   6. Clique na primeira linha da coluna Saída para criar uma nova variável de saída que contenha o valor dos dados transformados. Preencha os seguintes campos:
      • Nome: introduza TempInCelsius.
      • Selecione Usar como resultado da integração.
      • Clique em Criar para criar a variável e fechar o painel. A nova variável TempInCelsius aparece na lista Variáveis.
   7. Arraste a variável TempInCelsius da lista Variáveis para a segunda linha na coluna Entrada.
   8. Clique em + (Adicionar uma função) na variável TempInCelsius para ver a lista pendente de funções disponíveis.
   9. Clique em TO_STRING() para transformar o tipo de dados da variável de double para string.
   10. Clique na segunda linha da coluna Saída para criar uma nova variável que contenha o valor dos dados transformados. Preencha os seguintes campos:
       • Nome: introduza TempInCelsiusString.
       • Valor predefinido em branco: selecione String vazia.
       • Selecione a caixa de verificação Usar como resultado da integração.
       • Clique em Criar para criar a variável e fechar o painel. A nova variável aparece na lista de variáveis no lado esquerdo do editor de mapeamento de dados.
   11. Feche o editor de mapeamento de dados assim que o mapeamento estiver concluído. As alterações são guardadas automaticamente.

Adicione e configure a tarefa Enviar email

Para configurar a tarefa Enviar email:

1. Selecione Tarefas no editor de integração para apresentar a lista de tarefas disponíveis.
2. Clique e coloque o elemento Enviar email no editor de integração.
3. Clique no elemento Enviar email no criador para abrir o painel de configuração da tarefa. Defina as seguintes propriedades:
   • Para destinatários: introduza o seu endereço de email. Vai usar este email para confirmar a conclusão bem-sucedida da integração.
   • Assunto: introduza Temperature in Celsius.
   • Corpo em texto simples: selecione a variável TempInCelsiusString criada anteriormente na tarefa Mapeamento de dados.
   • As restantes opções podem ser deixadas na configuração predefinida.
   As alterações às propriedades são guardadas automaticamente.

Adicione as ligações de extremidade necessárias

Uma aresta é uma ligação entre dois elementos numa integração. A ligação indica a direção do fluxo de controlo de um elemento(tarefa ou acionador) para outro. Para mais informações sobre arestas, consulte o artigo Arestas.

1. Adicione uma ligação de aresta do elemento Acionador do Cloud Pub/Sub ao elemento Mapeamento de dados passando o cursor do rato sobre um ponto de controlo no elemento Acionador do Cloud Pub/Sub e, de seguida, clicando e arrastando uma linha para um ponto de controlo no elemento de tarefa Mapeamento de dados. Esta aresta denota o fluxo de controlo da tarefa Acionador do Cloud Pub/Sub para a tarefa Mapeamento de dados.
2. Adicione uma ligação de aresta do elemento Mapeamento de dados ao elemento Enviar email passando o cursor do rato sobre um ponto de controlo no elemento Mapeamento de dados e, de seguida, clicando e arrastando uma linha para um ponto de controlo no elemento de tarefa Enviar email. Esta aresta denota o fluxo de controlo da tarefa Mapeamento de dados para a tarefa Enviar email.

A associação concluída deve aparecer conforme mostrado na figura abaixo:

Publique a integração

Para publicar a integração, clique em Publicar na barra de ferramentas do editor de integração.

Após publicar com êxito a integração, pode ver e inspecionar os registos de execução da integração publicada. Para ver os registos, clique em Ver registos de execução desta integração. É apresentada a página Registos de execução.

Teste a integração através do Cloud Pub/Sub

Para testar a nova integração a partir da página de tópicos do Pub/Sub, siga estes passos:

1. Aceda à página de tópicos do Pub/Sub na Cloud Console.

   Aceda à página de tópicos do Pub/Sub

2. Pesquise e, em seguida, selecione o tópico temperaturesensor que criou.
3. Na página de detalhes do tópico, clique em + Publicar mensagem para abrir o painel de configuração Publicar mensagem.
4. No campo Corpo da mensagem, introduza 307.15.

   A criação desta mensagem simula a publicação de uma leitura de temperatura em Kelvin recebida pelo Pub/Sub de um dispositivo de IOT.

5. Clique em Publicar para publicar a mensagem no tópico e acionar a integração.

Após a conclusão com êxito, a integração envia um email com a temperatura Kelvin convertida em graus Celsius para o endereço de email especificado na tarefa Enviar email. Confirme a receção do email no seu cliente de email.

O email enviado pela integração deve ter um corpo da mensagem com o valor 34.

Além de validar o conteúdo do email, pode inspecionar os registos para ver o estado e a carga útil de uma determinada integração. Para ver registos:

1. No editor de integração, clique em Ver registos de execução desta integração. É apresentada a página Registos de execução. Para mais informações sobre os registos de execução, consulte o artigo Veja os registos de execução da integração.
2. Na página Registos de execução, pode ver detalhes sobre cada tentativa de executar uma integração. Cada entrada inclui detalhes da tentativa de execução, incluindo:
   • Nome da integração
   • ID de execução
   • Estado
   • Hora de início
   • Duração
   • Versão da integração
   • ID do acionador
3. Clique na seta de expansão (>) junto à integração executada para ver uma lista expandida de tarefas e variáveis na integração, juntamente com o estado das tarefas e os payloads das variáveis.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.