Extensão do Salesforce

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. info

Versão: 2.0.2

Acessar dados na sua conta do Salesforce. Inserir, atualizar, recuperar e consultar dados.

Este conteúdo fornece uma referência para configurar e usar essa extensão.

Pré-requisitos

Este conteúdo fornece uma referência para configurar e usar essa extensão. Antes de usar a extensão de um proxy de API com a política ExtensionCallout, você precisa:

1. Crie uma chave privada ou um par de certificação RSA x509.

   Você vai usar a chave privada (.key) como credenciais ao configurar a extensão. Você vai usar o arquivo de certificado (.crt) ao criar um app conectado que dará à extensão acesso ao Salesforce.

   openssl req -x509 -sha256 -nodes -days 36500 -newkey rsa:2048 -keyout salesforce.key -out salesforce.crt
   
   

2. Configure um app conectado.

   Um app conectado do Salesforce dá acesso à extensão do Salesforce. Consulte as instruções para configurar o app.

3. Receba o token do cliente para o app conectado. A extensão vai usar isso ao autenticar com o app.

   1. Na configuração do Salesforce, no painel de navegação à esquerda, acesse Apps > Gerenciador de apps.
   2. Na lista, localize o app conectado que você criou.
   3. No menu suspenso à direita na linha do aplicativo, clique em Visualizar.
   4. Em API (Enable OAuth Settings), localize a Chave do consumidor e copie o valor dela para um lugar seguro. Ele será usado ao configurar a extensão.

Configurar um app conectado para acesso pela extensão

Antes que a extensão do Salesforce possa acessar o Salesforce, crie um app conectado do Salesforce para que a extensão possa se conectar a ele.

No Salesforce, um app conectado oferece uma maneira para aplicativos externos se conectarem ao Salesforce por APIs.

Para configurar um app conectado

1. Faça login no Salesforce.
2. Clique no ícone de engrenagem no canto superior direito e em Configuração.
3. No painel de navegação à esquerda, expanda Apps > App Manager.
4. Na página App Manager, clique em Novo app conectado.
5. Em Informações básicas, preencha os campos obrigatórios. Os valores são para contabilidade e não são usados pela extensão.
6. Em API (ativar configurações do OAuth), marque a caixa de seleção Ativar configurações do OAuth.
7. Embora não seja usada pela extensão, digite um URL de callback. É possível usar http://localhost/ ou outro host marcador de posição.
8. Marque a caixa de seleção Usar assinaturas digitais.
9. Em Usar assinaturas digitais, clique em Escolher arquivo para localizar e fazer upload do salesforce.crt gerado anteriormente.
10. Na seção Escopos OAuth selecionados, adicione o seguinte para que eles fiquem em Escopos OAuth selecionados:
    • Acessar e gerenciar seus dados (API)
    • Faça solicitações em seu nome a qualquer momento (refresh_token, offline_access)
11. Clique em Salvar. Se houver erros, talvez seja necessário gerar e fazer upload do arquivo salesforce.crt novamente.
12. Na página do app resultante, clique em Gerenciar.
13. Na página do App Manager do app que você acabou de criar, clique em Editar políticas.
14. Em Políticas do OAuth, clique no menu suspenso Usuários permitidos e em Os usuários aprovados pelo administrador são pré-autorizados.
15. Clique em Salvar.
16. Na página do app, em Perfis, clique em Gerenciar perfis.

17. Na página Atribuição de perfil de aplicativo, marque as caixas de seleção dos perfis de usuário que podem usar o aplicativo.

    Selecione um perfil que corresponda ao usuário cujo nome de usuário será usado ao configurar a extensão. Verifique também se pelo menos os usuários administradores do sistema têm acesso a esse aplicativo.

    É possível ver a configuração do perfil do usuário no Salesforce. Na área Configuração, expanda Usuários > Usuários, localize o usuário que a extensão vai representar e encontre o perfil dele na coluna Perfil.

18. Clique em Salvar.

Sobre o Salesforce

O Salesforce é uma plataforma de gestão de relacionamento com o cliente (CRM). A gestão de relacionamento com o cliente ajuda as empresas a entender as necessidades dos clientes e resolver problemas gerenciando melhor as informações do cliente e as interações. Tudo isso em uma única plataforma acessível em qualquer computador ou dispositivo.

Ações

insert

Insira registros como tipos sObject.

<Action>insert</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "records":[ records-to-insert ],
  "allOrNone": true | false
}]]></Input>

<Action>insert</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "records":[
    { "Name": "MyAccountName" }
  ],
  "allOrNone": true
}]]></Input>

Parâmetros de solicitação

Resposta

Uma matriz results com resultados da operação de inserção.

{
  results: [
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

update

Atualizar registros do Salesforce.

<Action>update</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "records": [ records-to-update ],
  "allOrNone": true | false
}]]></Input>

<Action>update</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "records":[
    {
      "id":"0011U00000LQ76KQAT",
      "Name": "MyNewAccountName"
    }
  ],
  "allOrNone": true
}]]></Input>

Parâmetros de solicitação

Resposta

Uma matriz results que contém resultados da atualização.

{
  results: [
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

recuperar

Recupere registros como sObjects pelos IDs deles. Retorna todos os campos do tipo sObject.

<Action>retrieve</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "ids":[ IDs-of-records-to-retrieve ]
}]]></Input>

<Action>retrieve</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "ids":["0011U00000LQ76KQAT"]
}]]></Input>

Parâmetros de solicitação

Resposta

Uma matriz records de sObjects representados como JSON. Todas as propriedades dos objetos são incluídas no JSON, mesmo que o valor da propriedade seja nulo.

{
  records: [
    { sobject-json },
    { sobject-json }
  ]
}

querySOQL

Consulte o Salesforce.com usando a Linguagem de consulta de objetos do Salesforce (SOQL).

<Action>querySOQL</Action>
<Input><![CDATA[{
  "soql": soql-query-statement
}]]></Input>

<Action>querySOQL</Action>
<Input><![CDATA[{
  "soql": "SELECT Id, Name FROM Account"
}]]></Input>

Parâmetros de solicitação

Resposta

Resultados da consulta.

{
  totalSize: 2,
  records: [
    {
      attributes: { attributes-of-record },
      Id: '0011U00000LQ76KQAT',
      Name: 'AccountName1'
    },
    {
      attributes: { attributes-of-record },
      Id: '0011U00000LQ76LQAT',
      Name: 'AccountName2'
    }
  ],
  done: true
}

list

Lista registros do Salesforce.com. Retorna todos os campos do tipo sObject especificado.

<Action>list</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "limit": max-number-of-records,
  "offset": record-index-at-which-to-begin-response-set
}]]></Input>

<Action>list</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "limit": 1000,
  "offset": 0
}]]></Input>

Parâmetros de solicitação

Resposta

Uma matriz records que contém sObjects listados como JSON.

{
  records: [
    { sobject-json },
    { sobject-json }
  ]
}

del

Exclui registros com os IDs especificados.

<Action>del</Action>
<Input><![CDATA[{
  "sobject": records-sObject-type,
  "ids":[ IDs-of-records-to-retrieve ]
}]]></Input>

<Action>del</Action>
<Input><![CDATA[{
  "sobject": "Account",
  "ids":["0011U00000LQ76KQAT"]
}]]></Input>

Parâmetros de solicitação

Resposta

Uma matriz results que contém os resultados da operação.

{
  results:[
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

getAccessToken

Receba o token de acesso à API do Salesforce.com. Pode ser usado para consultar APIs REST.

<Action>getAccessToken</Action>
<Input><![CDATA[{}]]></Input>

Parâmetros de solicitação

Nenhum.

Resposta

O token de acesso em JSON.

{
  "accessToken":"00D1U0000014m3hqswvoM22I5GTw9EJrztlZ8eSSka88Q",
  "scope":"api",
  "instanceUrl": "https://na85.salesforce.com",
  "id": "https://login.salesforce.com/id/00D1U0004564mutUAA/0051U43214qecVQAQ",
  "tokenType": "Bearer"
}

Referência de configuração

Use o seguinte ao configurar e implantar essa extensão para uso em proxies de API.

Propriedades comuns de extensão

As propriedades a seguir estão presentes para cada extensão.

Propriedades deste pacote de extensão

Especifique valores para as seguintes propriedades de configuração específicas dessa extensão.