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.
Pré-requisitos
- Sua organização Salesforce deve ser provisionada para acessar os módulos do Salesforce Connect, incluindo fontes de dados externas e objetos externos.
- Criar um novo projeto em Design Studio.
- Criar uma entidade Jitterbit em Design Studio.
- Criar uma operação de entidade API em Design Studio.
- Configuração do Serviço OData em API Manager.
Crie uma Fonte de Dados Externa e um Objeto Externo no Salesforce¶
-
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:
-
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.
-
-
Role para baixo até a seção Autenticação. Clique no botão Validar e sincronizar:
-
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.
-
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¶
-
No painel do lado esquerdo da página, role para baixo até Build, selecione Create e selecione Tabs:
-
Role para baixo até a seção Guias de objetos personalizados e clique em Novo para criar uma nova aba no Salesforce:
-
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.
-
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.
-
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.
-
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.
-
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: