Configurar o Salesforce Connect para Consumir uma API de Serviço OData¶

Introdução¶

Esta página descreve como instalar e configurar o Salesforce Connect (anteriormente Salesforce Lightning Connect) para consumir com segurança uma API de Serviço OData e exibir os dados em tempo real. O exemplo mostrado irá expor e exibir dados de uma fonte SAP usando o protocolo OData 2.0.

Crie uma Fonte de Dados Externa e um Objeto Externo no Salesforce¶

1. Faça login em sua organização Salesforce. No painel do lado esquerdo da página, role para baixo até Build, selecione Develop e selecione External Data Sources. Você precisará de acesso a esses recursos para configurar o Salesforce Connect. Se você não tiver acesso a esses recursos, entre em contato com seu representante do Salesforce:

   

2. Clique no botão Nova fonte de dados externa:

   

   • Os campos obrigatórios exibem uma barra vertical vermelha à esquerda do campo.

   • Fonte de dados externa: Insira o Nome da API do Serviço OData no campo Fonte de dados externa.

   • Nome: Pressione a tecla Tab. O campo Nome é preenchido automaticamente com o nome da API do Serviço OData. A API Fonte de dados externa e Nome podem ser iguais.

   • Tipo: Clique no campo Tipo e selecione Salesforce Connect: OData 2.0 na lista suspensa.

     Nota

     Atualmente, o Harmony suporta apenas OData 2.0.

   • URL: Insira ou cole o URL completo da sua API do Serviço OData no campo URL. (Na página Minhas APIs página em API Manager, passe o mouse sobre o ficha da API e clique no link Copiar URL.)

     Nota

     Certifique-se de que o URL comece com HTTPS (e não HTTP). Se você estiver usando um URL HTTP, os dados não serão protegidos quando solicitados e enviados de volta ao Salesforce.

   • Objetos externos graváveis:

     • Marque esta caixa se quiser permitir que o Salesforce faça POST, PUT, DELETE ou MERGE dados no SAP ou na origem do banco de dados usando a API do Serviço OData. Nesse caso, múltiplas operações serão atribuídas à API às quais são atribuídos um ou mais desses métodos.
     • Deixe esta caixa desmarcada para acesso somente leitura. Neste caso, o método de operação na API do Serviço OData deve ser definido como GET.

   • Tipo de identidade: Clique neste campo e selecione Principal Nomeado na lista suspensa se você tiver perfis atribuídos à API e se quiser usar um nome central para todos os seus Usuários do Salesforce.

   • Protocolo de autenticação: Clique neste campo e selecione o Protocolo de autenticação apropriado na lista suspensa com base no perfil de segurança atribuído à API.

     • Campos adicionais são exibidos dependendo do protocolo selecionado.
     • No exemplo mostrado acima, Autenticação de senha foi selecionado e os campos Nome de usuário e Senha foram exibidos. Insira o Nome de usuário e a Senha apropriados.

   • Clique em Salvar.

3. Role para baixo até a seção Autenticação. Clique no botão Validar e sincronizar:

   

4. A página Validar fonte de dados externa exibe:

   

   • Clique na caixa de seleção apropriada para selecionar o Nome da tabela. Neste exemplo, Clientes foi selecionado.
   • Clique no botão Sincronizar para verificar a URL, validar se o formato é aceitável e criar automaticamente um novo Objeto Externo no Salesforce.

5. Role para baixo até a seção Autenticação:

   

   • A seção Objetos Externos exibe o novo Objeto Externo que você criou.
   • Os objetos externos do Salesforce são semelhantes a outros objetos personalizados, exceto que os dados não são armazenados no Salesforce. Os dados são recuperados em tempo real da fonte de dados. O objeto externo oferece suporte a APIs e outras personalizações. Ao usar um objeto externo, lembre-se de sempre fornecer um filtro para refinar os dados.
   • Consulte a documentação do Salesforce Definir objetos externos para obter informações adicionais sobre objetos externos do Salesforce.

Crie uma Nova Guia Personalizada no Salesforce¶

1. No painel do lado esquerdo da página, role para baixo até Build, selecione Create e selecione Tabs:

   

2. Role para baixo até a seção Guias de objetos personalizados e clique em Novo para criar uma nova aba no Salesforce:

   

3. Nova guia de objeto personalizado, etapa 1 de 3:

   

   • Objeto: Clique no campo Objeto e selecione o novo objeto externo que você criou na lista suspensa. Neste exemplo, Clientes foi selecionado.
   • Estilo da guia: Clique no campo Estilo da guia para exibir um pop-up contendo opções de estilo. Selecione um estilo de aba no pop-up.
   • Descrição: Insira uma breve descrição do objeto externo.
   • Clique em Avançar.

4. Nova guia de objeto personalizado, etapa 2 de 3:

   

   • Personalize a visibilidade da guia com perfis conforme desejado. Neste exemplo, Visibilidade da guia está definida como Padrão ativado para todos os perfis.
   • Clique em Avançar.

5. Nova guia de objeto personalizado, etapa 3 de 3:

   

   • Selecione Aplicativos personalizados para os quais a nova aba personalizada estará disponível clicando nas caixas de seleção associadas. Todos os aplicativos estão incluídos no exemplo acima.
   • Clique em Salvar.

6. Clique em Home na barra de ferramentas superior:

   

   • Se sua nova aba não for exibida automaticamente, clique no sinal de mais no lado direito da barra de ferramentas para listar todas as guias.
   • Clique na nova aba que você criou (neste exemplo Clientes).
   • Clique em Criar Nova Visualização
   • Personalize a Visualização conforme desejado. Insira um Nome para a visualização.
   • Clique em Salvar.

7. No exemplo mostrado na imagem abaixo, a visualização Clientes nos EUA está definida para exibir todos os clientes onde País = EUA:

   

   • Os dados são recuperados em tempo real e não são armazenados no Salesforce.
   • Você pode detalhar mais detalhes ou alterar os filtros conforme necessário.
   • API Manager Harmony continuará atendendo às solicitações em tempo real e trabalhando em conjunto com o Salesforce Connect para fornecer acesso aos dados.

Recursos Adicionais do Salesforce Connect¶

Estes recursos da documentação do Salesforce podem ser úteis:

• Salesforce Connect
• Configurar o Salesforce Connect
• Acessar dados externos com o Salesforce Connect
• Trabalhar com fontes de dados externas
• Definir objetos externos