Enviar registros de objetos alterados do Salesforce para um banco de dados por meio do fluxo do Salesforce usando o Jitterbit Integration Studio e o API Manager

Introdução

Este padrão de design de integração configura um fluxo do Salesforce que envia uma mensagem de saída para um API Manager API quando um objeto é alterado (neste exemplo, o objeto Conta). Um projeto do Integration Studio processa a mensagem de saída do Salesforce, mapeia os dados do objeto e os salva em um banco de dados.

Para configurar esse padrão, siga estas seções em ordem:

• Parte 1: No Salesforce, configure uma mensagem de saída e um fluxo para chamá-lo quando um objeto for alterado e baixe o arquivo WSDL que define a mensagem.
• Parte 2: No Integration Studio, configure uma cadeia de operação para receber a mensagem de saída do Salesforce e armazenar os valores mapeados em um banco de dados.
• Parte 3: No API Manager, configure uma API como um endpoint para o Salesforce.
• Parte 4: Retorne ao Salesforce para ativar o fluxo e teste o padrão de design de integração concluído.

Parte 1: Fluxo do Salesforce e arquivo WSDL

1. No Salesforce, selecione Configuração > Ferramentas da plataforma > Automação de processos > Ações de Workflow > Mensagens de saída.

2. Clique no botão Nova mensagem de saída (destacado na imagem abaixo).

   

3. Na página Nova Mensagem de Saída, clique no menu Objeto, selecione Conta e clique em Avançar.

   

4. Na página Nova mensagem de saída, insira os valores a seguir e clique em Salvar:

   • Nome: Nome de sua escolha.
   • Nome exclusivo: Este nome é gerado automaticamente com base no valor de Nome e nas regras de nomenclatura do campo.
   • Descrição: (Opcional) Uma descrição para esta mensagem de saída.
   • URL do Endpoint: example.com. Este URL temporário será atualizado posteriormente.
   • Usuário para envio: Insira o usuário que envia a mensagem. O valor padrão é o seu nome de usuário do Salesforce.
   • Componente protegido: Não selecionado.
   • ID da sessão de envio: Não selecionado.
   • Campos da conta para enviar: Selecione os campos do objeto a serem enviados. Neste exemplo, apenas Nome e Telefone estão selecionados. O campo ID é selecionado automaticamente, pois é o campo-chave do objeto.

   

5. Na página Detalhes da mensagem de saída do Workflow da mensagem, clique no link Clique para WSDL na linha rotulada WSDL do Endpoint (destacado na imagem abaixo).

   

6. Um arquivo XML é aberto em uma nova janela do navegador. Salve o arquivo com um .wsdl extensão. Dependendo do seu sistema operacional, pode ser necessário definir a extensão do arquivo após o download.

7. Na janela do navegador Salesforce, selecione Configuração > Ferramentas da plataforma > Automação de processos > Fluxos.

8. Na página Fluxos, clique no botão Novo Fluxo (destacado na imagem abaixo).

   

9. Na caixa de diálogo Novo fluxo do Flow Builder, selecione a aba Núcleo, selecione Fluxo acionado por registro e clique em Criar.

   

10. Na caixa de diálogo Configurar Início, insira os valores para os seguintes itens e clique em Concluído:

    • Selecionar Objeto: No campo Objeto, insira Conta.
    • Configurar Gatilho: Em Acionar o Fluxo Quando, selecione Um Registro For Criado ou Atualizado.
    • Definir Condições de Entrada: Em Requisitos de Condição, deixe o valor como Nenhum.
    • Otimizar o Fluxo Para: Selecione Ações e Registros Relacionados.

    

11. Na página Flow Builder, passe o mouse sobre o nó entre Início e Fim (indicado por uma seta vermelha na imagem abaixo) e clique em Adicionar Elemento.

    

12. Na caixa de diálogo Adicionar Elemento, selecione Ação.

    

13. Na caixa de diálogo Nova Ação, selecione a categoria Mensagem de Saída.

    

14. Clique na barra de pesquisa Ação e selecione sua mensagem de saída. Insira os valores para os seguintes itens e clique em Concluído:

    • Rótulo: Insira um rótulo para a ação.
    • Nome da API: Este nome é gerado automaticamente com base no valor de Rótulo e nas regras de nomenclatura do campo.
    • Descrição: (Opcional) Insira uma descrição para esta ação.

    

15. Na página Flow Builder, clique em Salvar.

    

16. Na caixa de diálogo Salvar o fluxo, insira valores para os seguintes itens e clique em Salvar:

    • Rótulo do fluxo: Insira um rótulo para o fluxo.
    • Nome da API de fluxo: Este nome é gerado automaticamente com base no valor de Rótulo de fluxo e nas regras de nomenclatura do campo.
    • Descrição: (Opcional) Insira uma descrição para este fluxo.

    

Parte 2: Operações do Integration Studio

Defina a operação 'Mensagem de saída do Salesforce '

1. Crie um novo projeto do Integration Studio.

2. Arraste uma atividade de solicitação SOAP da paleta de componentes de design e solte-o em uma operação vazia na quadro de design.

3. Defina o nome da operação como Salesforce Outbound Message.
4. Clique duas vezes na instância da atividade Solicitação SOAP na operação para abrir sua tela de configuração.
5. Na etapa 1, selecione Carregar arquivo, clique em Procurar, selecione o arquivo WSDL baixado anteriormente e clique em Carregar.
6. Clique em Porta e selecione Notificação (a única opção). Os campos restantes serão preenchidos automaticamente e não precisarão de edição adicional.

7. Clique em Avançar.

   

8. Na etapa 2, clique em Concluído.

   

9. Adicione uma nova transformação à direita da atividade Solicitação SOAP.

10. Para o esquema de destino, clique em Espelhar esquema de origem.
11. Clique em Automapear correspondências exatas ou mapear manualmente campos de origem para destino.

12. No esquema de destino, clique em Editar esquema, defina o nome do esquema como Upsert Schema e clique em Salvar alterações.

    

13. Feche a transformação para retornar ao workflow.

    

14. Na categoria Conectores da paleta de componentes, localize e clique no conector Variável.

15. Deixe os nomes da conexão e das variáveis com seus padrões e clique em Salvar alterações.
16. Arraste uma Atividade de gravação de variável da paleta de componentes e solte-o na operação Salesforce Outbound Message, à direita da transformação.
17. Clique duas vezes na atividade Escrever.

18. Na etapa 1, selecione Sim, usar esquema salvo, clique em Esquemas salvos, selecione Inserir novo esquema e clique em Avançar.

    

19. Na etapa 2, clique em Concluído.

    

    A operação Mensagem de saída do Salesforce:

    

Defina a operação ' Salesforce Response'

1. Arraste uma atividade de resposta SOAP da paleta de componentes e solte-o em uma operação vazia na quadro de design.
2. Defina o nome da operação como Salesforce Response.
3. Clique duas vezes na atividade Resposta SOAP.

4. Na etapa 1, selecione Selecionar existente, selecione o arquivo WSDL carregado anteriormente e clique em Avançar.

   

5. Na etapa 2, clique em Concluído.

   

6. Adicione uma nova transformação à esquerda da atividade SOAP Response na operação Salesforce Response.

7. Adicione um valor personalizado para o campo Ack com o valor true e feche a transformação para retornar ao workflow.

   

   A operação Salesforce Response:

   

Defina a operação 'Database Upsert'

1. Arraste uma Atividade de leitura de variável da paleta de componentes e solte-o em uma operação vazia na quadro de design.
2. Defina o nome da operação como Database Upsert.
3. Clique duas vezes na atividade Ler.

4. Na etapa 1, selecione Sim, usar esquema salvo, clique em Esquemas salvos, selecione Inserir novo esquema e clique em Avançar.

   

5. Na etapa 2, clique em Concluído.

   

6. Configure uma Conexão com o Banco de Dados para o seu banco de dados de destino e clique em Salvar alterações. (Uma conexão com um servidor PostgreSQL é mostrada neste exemplo.)

   

7. Arraste uma atividade Database Upsert da paleta de componentes e solte-a na operaçãoDatabase Upsert, à direita da atividade Read.

8. Clique duas vezes na atividade Upsert.

9. Na etapa 1, clique em Atualizar, selecione a tabela do banco de dados de destino e clique em Avançar.

   

10. Na etapa 2, selecione as colunas a serem atualizadas e clique em Avançar.

    

11. Na etapa 3, clique em Concluído.

    

12. Na operaçãoDatabase Upsert, adicione uma nova transformação entre as atividades Read e Upsert.

13. Mapear manualmente campos de objeto de origem do Salesforce para colunas de banco de dados de destino e, em seguida, feche a transformação para retornar ao workflow.

    

    A operaçãoDatabase Upsert:

    

Ações de operação e implantação

1. Abra a tela de configurações para a operação Mensagem de saída do Salesforce.
2. Selecione a aba Ações e defina os seguintes valores de campo:
   • Condição: Em caso de sucesso.
   • Ação: Executar operação.
   • Operação: Resposta do Salesforce.

3. Clique em + Adicionar ação e feche a tela de configurações da operação.

   

4. Abra a tela de configurações para a operação Salesforce Response.

5. Selecione a aba Ações e defina os seguintes valores de campo:
   • Condição: Em caso de sucesso.
   • Ação: Executar operação.
   • Operação: Upsert do banco de dados.

6. Clique em + Adicionar ação e feche a tela de configurações da operação.

   

   O projeto concluído, antes da implantação:

   

7. Implantar o projeto.

Parte 3: API do API Manager

1. No API Manager, selecione APIs e clique em Nova API.

2. Na etapa 1 da página Publicar nova API, insira valores para os seguintes itens e clique em Avançar:

   • Nome da API: Insira um nome para a API.

   • Ambiente: Selecione o ambiente onde o projeto do Integration Studio foi implantado.

   • Raiz do serviço: Deixe o valor inicial derivado do nome da API.

   • Número da versão: (Opcional) Insira um número de versão da API.

   • Descrição: (Opcional) Insira uma descrição para esta API.

   

3. Na etapa 2, selecione API customizada como Tipo de Serviço e clique em Adicionar Serviço de API. Para o novo serviço de API, insira os seguintes valores nos campos a seguir, clique em Salvar e, em seguida, em Avançar:

   • Método de Solicitação: Use o menu para selecionar o método de solicitação POST para o serviço de API. Por padrão, o método de solicitação é definido como GET.

   • Nome do serviço: Insira um nome de serviço.

   • Na aba Operação, selecione estes valores:

     • Atribuir projeto: No menu, selecione seu projeto do Integration Studio.

     • Atribuir operação(ões):

       • Operação: Selecione a operação Mensagem de saída do Salesforce.

       • Tipo de resposta: Selecione Meta final como o tipo de resposta.

   

4. Na etapa 3, clique em Ignorar esta etapa.

5. Na etapa 4, clique em Salvar e publicar.

   

6. Na caixa de diálogo intitulada Tudo pronto, sua API está ativa!, clique em Copiar URL e depois em Descartar.

Parte 4: Atualizar URL do endpoint do Salesforce e ativar o fluxo

1. No Salesforce, selecione Configuração > Ferramentas da plataforma > Automação de processos > Ações de Workflow > Mensagens de saída.
2. Na página Mensagens de saída, clique em Editar para sua mensagem de saída.

3. Substitua o conteúdo do campo URL do Endpoint (destacado na imagem abaixo) pelo URL copiado no final da seção anterior e clique em Salvar.

   

4. Selecione Configuração > Ferramentas da Plataforma > Automação de Processos > Fluxos.

5. Clique no rótulo do fluxo da entrada Fluxo Jitterbit (destacado na imagem abaixo).

   

6. Na página Flow Builder, clique no botão Ativar (destacado na imagem abaixo).

   

Teste a integração

Para testar esse padrão de design de integração, siga estas etapas:

1. No Salesforce, abra o aplicativo Serviço e selecione a aba Contas.
2. Edite um contato da conta e salve-o.
3. Efetue login no seu banco de dados e consultar a tabela de destino.