Registrar um serviço externo

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

  • Definir uma credencial nomeada para seu serviço Web externo.
  • Adicionar um serviço Web externo usando um esquema fornecido.
  • Explicar como as ações do Serviço Externo se relacionam com a definição de esquema que você usa.

Começando pelo começo: credenciais nomeadas e acesso do ponto de extremidade

Antes de entrarmos no mundo dos Serviços externos, temos alguns pré-requisitos para concluir. Na unidade anterior, abordamos esquemas e o que constitui um válido e com suporte pelos Serviços externos. Além de um esquema com suporte, precisamos de uma maneira simples de proteger nossos serviços Web externos e nossa organização do Salesforce. Para essa tarefa, podemos usar credenciais nomeadas para autenticar nossos callouts de ponto de extremidade. 

Em um projeto típico, o provedor de serviços da Web externo forneceria os elementos de uma credencial nomeada. Esses elementos incluem a URL de um ponto de extremidade de callout e seus parâmetros de autenticação obrigatórios. Na última unidade, dissemos que os esquemas contêm as informações do ponto final e os parâmetros de autenticação para os serviços da Web da API baseada em REST. Vamos usar essas informações para definir uma credencial nomeada para nossa organização. Vá em frente e tente fazer isso em seu Trailhead Playground.
  1. Em Configuração, insira Credenciais nomeadas na caixa Busca rápida e selecione Credenciais nomeadas.
  2. Clique em Nova credencial nomeada.
  3. Em Rótulo, use Banco.
  4. Em URL, use https://th-external-services.herokuapp.com
  5. Deixe os outros campos como estão e clique em Salvar.
Você encontrará mais recursos sobre autenticação e credenciais nomeadas no final desta unidade.

Usar o assistente de serviços externos para registrar seu serviço Web externo

Agora, vamos registrar o serviço. Como temos um esquema válido (um exemplo de mundo real também definiria o protocolo de autenticação na credencial nomeada), essa parte é simples. Adicionar nosso serviço externo do Acme Bank aos Serviços externos informa ao Salesforce como ele vai interagir.  

  1. Em Configuração, insira Serviços externos na caixa Busca rápida e selecione Serviços externos.
  2. Clique em Adicionar um serviço externo.
  3. Como Nome do serviço externo, insira BankService (sem espaço).
  4. Em Selecionar uma credencial nomeada, selecione Banco.
  5. Selecione URL relativo do esquema de serviço e insira /accounts/Schema. A URL completa de nosso provedor de serviço está localizada aqui: https://th-external-services.herokuapp.com/accounts/schema.
  6. Clique em Salvar e avançar.
  7. Selecione Operações.
  8. Clique em Avançar. Dê uma olhada nas ações dos Serviços externos e, quando estiver pronto, clique em Concluído.

Uma lista de suas ações dos Serviços externos aparece. Use a barra de rolagem para visualizar todas elas.

Agora, essas ações estão disponíveis para você no Flow Builder. Criaremos um fluxo simples na próxima unidade e mostraremos como encontrar as ações na paleta de fluxo. Por enquanto, vejamos o método getAccount e alguns de seus parâmetros.

  • O método getAccount recupera informações da conta.
  • O parâmetro accountName especifica a conta.
  • Existem vários parâmetros de saída para o método getAccount também. Os códigos, como 200, se correlacionam a códigos de resposta específicos definidos no esquema. Você também pode ver essas definições bem formatadas no Editor do Swagger quando valida o esquema.
Se você está nos acompanhando desde a unidade um, já abordamos as quatro primeiras etapas abordadas nessa unidade:
  1. Um provedor de serviços externos, como um banco, compartilha sua especificação de esquema da API baseada em REST: Recebemos essa informação do nosso banco fictício.
  2. Com base na especificação, o provedor de serviços (como o nosso exemplo de serviço de crédito) ou um desenvolvedor (ou até mesmo você) cria uma definição de esquema baseada em JSON que descreve a API: Embora não tenhamos criado esse esquema por conta própria, analisamos os elementos de um esquema e os requisitos para que ele tenha suporte. Quando você trabalha com serviços externos, você ou seu desenvolvedor podem definir o esquema necessário para seu caso de uso.
  3. Um administrador do Salesforce cria declarativamente uma credencial nomeada para autenticar no ponto de extremidade do serviço usando a URL fornecida pelo provedor de serviços externos: Definimos nossa credencial nomeada, https://th-external-services.herokuapp.com.
  4. Um administrador do Salesforce registra declarativamente o serviço, e usa a definição de esquema e a credencial nomeada durante o processo de registro: Acabamos de registrar nosso primeiro serviço externo e analisamos as ações no assistente.

Continue a aprender de graça!
Inscreva-se em uma conta para continuar.
O que você ganha com isso?
  • Receba recomendações personalizadas para suas metas de carreira
  • Pratique suas habilidades com desafios práticos e testes
  • Monitore e compartilhe seu progresso com os empregadores
  • Conecte-se a orientação e oportunidades de carreira