Ir para o conteúdo

Configurar o Salesforce Connect para consumir uma API OData do Jitterbit Design Studio no Jitterbit API Manager

Introdução

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

Pré-requisitos

  1. Sua organização Salesforce deve estar provisionada para acessar os módulos do Salesforce Connect, incluindo fontes de dados externas e objetos externos.
  2. Crie um novo projeto no Design Studio.
  3. Crie uma entidade Jitterbit no Design Studio.
  4. Crie uma operação de entidade API no Design Studio.
  5. Configuração da API OData no API Manager.

Criar uma fonte de dados externa e um objeto externo no Salesforce

  1. Faça login na sua organização Salesforce. Dentro do painel no lado esquerdo da página, role para baixo até Build, selecione Develop e selecione Fontes de Dados Externas. 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:

    attachment

  2. Clique no botão Nova Fonte de Dados Externa:

    attachment

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

    • Fonte de Dados Externa: Insira o Nome da API OData no campo Fonte de Dados Externa.

    • Nome: Pressione a tecla Tab. O campo Nome é preenchido automaticamente com o nome da API OData. A Fonte de Dados Externa da API e o Nome podem ser os mesmos.

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

      Nota

      O Harmony atualmente suporta apenas OData 2.0.

    • URL: Insira ou cole a URL completa da sua API OData no campo URL. (Na página APIs no API Manager, passe o mouse sobre o bloco da API e clique no link Copiar URL.)

      Nota

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

    • Objetos Externos Graváveis:

      • Marque esta caixa se desejar permitir que o Salesforce POST, PUT, DELETE ou MERGE dados na fonte SAP ou no banco de dados usando a API OData. Nesse caso, várias operações serão atribuídas à API, que são atribuídas a um ou mais desses métodos.
      • Deixe esta caixa desmarcada para acesso somente leitura. Nesse caso, o método de operação na API 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 desejar 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 por Senha foi selecionada 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:

    attachment

  4. A página Validar Fonte de Dados Externa exibe:

    attachment

    • 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:

    attachment

    • A seção Objetos Externos exibe o novo Objeto Externo que você criou.
    • 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 suporta 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 informações adicionais sobre objetos externos do Salesforce.

Criar uma nova guia personalizada no Salesforce

  1. Dentro do painel no lado esquerdo da página, role para baixo até Criar, selecione Criar e selecione Guias:

    attachment

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

    attachment

  3. Nova Guia de Objeto Personalizado, Passo 1 de 3:

    attachment

    • 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 popup contendo opções de estilo. Selecione um estilo de guia no popup.
    • Descrição: Insira uma breve descrição do objeto externo.
    • Clique em Próximo.

  4. Nova Aba de Objeto Personalizado, Etapa 2 de 3:

    attachment

    • Personalize a Visibilidade da Aba com Perfis conforme desejado. Neste exemplo, a Visibilidade da Aba está definida como Padrão Ativado para todos os Perfis.
    • Clique em Próximo.

  5. Nova Aba de Objeto Personalizado, Etapa 3 de 3:

    attachment

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

  6. Clique em Início na barra de ferramentas superior:

    attachment

    • 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 abas.
    • 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á configurada para exibir todos os clientes onde País = EUA:

    attachment

    • Os dados são recuperados em tempo real e não estão sendo armazenados no Salesforce.
    • É possível aprofundar para mais detalhes ou alterar filtros conforme necessário.
    • Jitterbit API Manager continuará a atender as solicitações em tempo real e trabalhará em conjunto com o Salesforce Connect para fornecer acesso aos dados.

Recursos adicionais do Salesforce Connect

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