Configurar mensagens de saída com endpoints HTTP hospedados no Jitterbit Design Studio

Introdução

Este padrão de design de integração configura um Salesforce regra de workflow que envia uma mensagem de saída para um Endpoint HTTP hospedado quando um objeto é alterado (neste exemplo, o objeto Conta). Um projeto do Design Studio processa a mensagem de saída do Salesforce, mapeia os dados do objeto e os salva em um banco de dados. Os Endpoints HTTP hospedados podem ser usados apenas com agentes privados.

Para configurar este padrão, siga estas seções na ordem:

• Parte 1: No Design Studio, crie uma nova operação e copie a URL do serviço web hospedado.
• Parte 2: No Salesforce, configure uma regra de workflow para enviar uma mensagem de saída para o URL do serviço Web quando um objeto for alterado e baixe o arquivo WSDL que define a mensagem.
• Parte 3: No Design Studio, expanda a nova operação para receber e confirmar a mensagem de saída do Salesforce e mapear e armazenar os valores alterados em um banco de dados.
• Parte 4: Retorne ao Salesforce para ativar a mensagem de saída e teste o padrão de design de integração concluído.

Parte 1: URL do endpoint do serviço web do Design Studio

1. Crie um novo projeto do Design Studio.

2. Na lista de itens do projeto à esquerda, clique com o botão direito do mouse em Operações e selecione Nova Operação.

3. Na caixa de diálogo Selecionar tipo, selecione Serviço Web hospedado e clique em Continuar.
4. Na janela Nova operação, defina o nome da nova operação como Aceitar solicitação do Salesforce.
5. Clique na seta para baixo ao lado do nome da operação e selecione Exibir URL do serviço Web hospedado.

6. Na caixa de diálogo URL do serviço Web hospedado, no campo Servidor, insira o nome do host ou endereço IP onde seu agente privado está sendo executado (123.456.789.001 neste exemplo).

   

   Nota

   Se o agente estiver sendo executado atrás de um firewall, você deverá configurar um túnel ou proxy de acesso público e abrir a porta HTTP 46908 (ou 46909 para HTTPS).

7. Clique em Copiar para a área de transferência para salvar o URL da Parte 2 e clique em Fechar.

8. Na janela Nova Operação, clique em Salvar.

   A operação incompleta Aceitar solicitação do Salesforce:

   

Parte 2: Configurar uma regra de workflow do Salesforce e baixar o arquivo WSDL

1. No Salesforce, selecione Configuração > Ferramentas da plataforma > Automação de processos > Regras de Workflow.

2. Na página Regras de Workflow, clique no botão Nova Regra (destacado na imagem abaixo). Se a caixa de diálogo Experimentar no Flow Builder abrir, clique em Continuar com as Regras de Workflow.

   

3. Na página Nova regra de Workflow, clique no menu Objeto, selecione Conta e clique em Avançar.

   

4. Na página Conta, insira os valores a seguir e clique em Salvar e Avançar:

   • Nome da regra: Nome de sua escolha.
   • Descrição: (Opcional) Uma descrição para esta regra.
   • Critérios de avaliação: Criado e sempre editado.
   • Critérios da regra: Clique em Executar esta regra se e selecione Fórmula for avaliada como verdadeira.
   • No campo de fórmula, insira true.

   

5. Na página Editar regra, clique em Adicionar ação de Workflow e selecione Nova mensagem de saída (destacada na imagem abaixo).

   

6. 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: Cole a URL do serviço web hospedado copiada em Parte 1.
   • 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.

   

7. Na página Editar regra, clique em Concluído.

   

8. Na página Regra de Workflow, na seção Ações imediatas de Workflow, clique no link de descrição da mensagem de saída (destacado na imagem abaixo).

   

9. 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).

   

10. 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 alterar a extensão do arquivo de .xml para .wsdl após o download.

Parte 3: Operações do Design Studio

Definir um método de serviço web

1. No projeto Design Studio iniciado em Parte 1, nos itens do projeto à esquerda, clique com o botão direito em Métodos de serviço da Web e selecione Novo método de serviço da Web.

2. Na janela Novo Método de Serviço Web, selecione Selecionar um Arquivo WSDL Local, clique em Procurar, selecione o arquivo WSDL baixado anteriormente, clique em Avançar > e aguarde a validação do arquivo.

   

3. Na etapa Operação, clique em Avançar >.

   

4. Na etapa Detalhes, clique em Concluir.

   

5. Feche a janela Novo Método de Serviço Web.

   

Definir uma chamada de serviço web

1. Na janela de operação Aceitar solicitação do Salesforce, clique duas vezes na atividade Chamada de serviço da Web.

2. Na caixa de diálogo Selecionar chamada de serviço Web, selecione Novo método de serviço Web e clique em OK.

   

3. Clique duas vezes na atividade de transformação final e clique em Criar nova Transformação.

4. Na janela Nova Transformação, defina valores para os seguintes itens e clique em Concluir:

   • Nome: Salesforce Response.
   • Fonte: (Nenhuma)

5. Na janela de transformação Resposta do Salesforce, expanda todos os nós de destino até que o elemento [EV?] Ack (Boolean)estiver visível, clique duas vezes nele.

   

6. Na janela Construtor de Fórmulas, edite o script para corresponder ao seguinte e clique em OK para fechar o editor de script:

   <trans>
   true
   </trans>
   

   

7. Na janela de transformação Resposta do Salesforce, clique em Salvar e feche a janela.

   

8. Clique duas vezes na atividade de transformação do meio e clique em Criar nova Transformação.

9. Na janela Nova Transformação, defina valores para os seguintes itens e clique em Avançar >:

   • Nome: Solicitação do Salesforce
   • Destino: Texto

   

10. Na etapa Destino, clique em Definições de Formato de Arquivo Disponíveis e selecione Criar Novo.

11. Defina os valores para os seguintes itens e clique em Criar Manualmente.

    • Nome: Formato de Solicitação do Salesforce
    • Selecione o Tipo de Documento: Documento de Texto Simples
    • Selecione o Formato do Documento: Delimitado por Caracteres

    

12. Na seção Definir Propriedades do Segmento, clique no botão Novo para criar um novo campo.

13. Em Nome do Campo, insira Em Branco e clique em Concluir.

    

14. Feche a janela de transformação Solicitação do Salesforce.

    A operação incompleta Aceitar solicitação do Salesforce:

    

Defina a origem da 'Solicitação de entrada'

1. Na lista de itens do projeto à esquerda, clique com o botão direito do mouse em Fontes e selecione Nova Fonte.

2. Na caixa de diálogo Selecionar Tipo, selecione Armazenamento Temporário e clique em Continuar.

3. Na janela Nova Fonte, insira os valores para o seguinte:

   • Nome: Solicitação de Entrada
   • Obter Arquivos: IncomingRequest[fileGUID].xml

   

4. Clique em Salvar e feche a janela.

5. Na lista de itens do projeto à esquerda, clique com o botão direito do mouse na nova origem da Solicitação de Entrada e selecione Copiar para Novo Destino.

6. Na janela de destino da Solicitação de Entrada, clique em Salvar e feche a janela.

   

7. Na janela da operação Aceitar solicitação do Salesforce, clique duas vezes na transformação Solicitação do Salesforce.

8. Na janela de transformação Solicitação do Salesforce, clique duas vezes no campo Em branco na árvore de destino.

   

9. Na janela Construtor de Fórmulas, edite a fórmula para corresponder ao seguinte e clique em OK para fechar o editor de script:

   <trans>
   $fileGUID=GUID();
   WriteFile("<TAG>Targets/Incoming Request</TAG>", GetXmlString([root$], true]));
   </trans>
   

   

10. Na janela de transformação Solicitação do Salesforce, clique em Salvar e feche a janela.

    

Crie a operação 'Upsert Database'

1. Na janela de operação Aceitar solicitação do Salesforce, selecione a seta para baixo ao lado do nome da operação e selecione Em caso de sucesso > Operação > Criar nova operação.

2. Na caixa de diálogo Selecionar tipo, selecione Transformação e clique em Continuar.

3. Defina o nome da nova operação como Upsert Database.

   

4. Na operaçãoUpsert Database, clique duas vezes em Source.

5. Na janela Selecionar fonte, selecione Solicitação de entrada e clique em OK.

   

6. Na operaçãoUpsert Database, clique duas vezes em Target.

7. Na janela Selecionar destino, clique em Criar novo destino.

8. Na janela Novo destino, defina valores para o seguinte, clique em Testar conexão e feche a janela Banco de dados:

   • Nome: Banco de Dados
   • Tipo: Banco de dados
   • Parâmetros de conexão: Defina os parâmetros para o seu banco de dados. (Uma conexão com um servidor PostgreSQL é mostrada neste exemplo.)

   

9. Na operaçãoUpsert Database, clique duas vezes em Transformação.

10. Na janela Selecionar Transformação, selecione Criar nova Transformação.

11. Na janela Nova Transformação, insira valores para os seguintes itens e clique em Avançar >:

    • Nome: Salesforce para Banco de Dados
    • Fonte: Solicitação de serviço da Web hospedado

    

12. Na etapa Fonte, clique em Avançar >.

    

13. Na etapa ALVO, clique em Baixar Lista de Tabelas. Selecione a tabela do banco de dados de destino, clique na seta para a direita para movê-la para a lista Tabelas Selecionadas e clique em Avançar >.

    

14. Na etapa Destino, clique em Concluir.

    

15. Na janela de transformação Salesforce para Banco de Dados, expanda as árvores de origem e destino, mapeie os campos arrastando e soltando, clique em Salvar e feche a janela de transformação.

    

16. Na janela de operação Aceitar solicitação do Salesforce, clique em Salvar.

    

17. No menu principal, selecione Ações > Implantar. Na caixa de diálogo Implantar, em Selecionar um Tipo de Implantação, selecione Tudo e clique em Implantar.

Parte 4: Atualizar URL do endpoint do Salesforce e ativar

1. No Salesforce, selecione Configuração > Ferramentas da plataforma > Automação de processos > Regras de Workflow.

2. Na página Todas as regras de Workflow, clique em Ativar para sua mensagem de saída (destacada 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.