Salesforce

O conetor do Salesforce permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do Salesforce.

Versões suportadas

O conector requer a API Web Services. A API Web Services é suportada nativamente pelas edições Enterprise, Unlimited e Developer do Salesforce. A API Web Services pode ser ativada na Professional Edition mediante um custo adicional entrando em contacto com a Salesforce. O conetor usa por predefinição a versão 56.0 da API Salesforce.

Antes de começar

No seu projeto do Google Cloud, faça as seguintes tarefas:

  • Certifique-se de que a conetividade de rede está configurada. Para obter informações sobre padrões de rede, consulte o artigo Conetividade de rede.
  • Conceda a função IAM roles/connectors.admin ao utilizador que está a configurar o conetor.
  • Conceda as seguintes funções de IAM à conta de serviço que quer usar para o conector:
    • roles/secretmanager.viewer
    • roles/secretmanager.secretAccessor

    Se não tiver uma conta de serviço, tem de criar uma. O conector e a conta de serviço têm de pertencer ao mesmo projeto.

  • Ative os seguintes serviços:
    • secretmanager.googleapis.com (Secret Manager API)
    • connectors.googleapis.com (API Connectors)

    Para saber como ativar serviços, consulte o artigo Ativar serviços. Se estes serviços ou autorizações não tiverem sido ativados anteriormente para o seu projeto, é-lhe pedido que os ative quando configurar o conector.

Configure o conetor

Uma associação é específica de uma origem de dados. Isto significa que, se tiver muitas origens de dados, tem de criar uma associação separada para cada origem de dados. Para criar uma associação, faça o seguinte:

  1. Na Cloud Console, aceda à página Integration Connectors > Ligações e, de seguida, selecione ou crie um projeto do Google Cloud.

    Aceda à página Ligações

  2. Clique em + Criar novo para abrir a página Criar associação.
  3. Na secção Localização, selecione uma localização na lista Região e, de seguida, clique em Seguinte.

    Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Selecione Salesforce na lista de conetores.
    2. Selecione uma versão do conetor na lista Versão do conetor.
    3. No campo Nome da associação, introduza um nome para a instância de associação. O nome da associação pode conter letras minúsculas, números ou hífenes. O nome tem de começar com uma letra e terminar com uma letra ou um número, e não pode exceder os 49 carateres.
    4. Opcionalmente, introduza uma Descrição para a instância de associação.
    5. Opcionalmente, ative o Registo na nuvem e, em seguida, selecione um nível de registo. Por predefinição, o nível do registo está definido como Error.
    6. No campo Conta de serviço, selecione uma conta que tenha as funções necessárias.
    7. (Opcional) Configure as definições do nó de associação.
      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.
    8. (Opcional) Para configurar um servidor proxy para a ligação, selecione Usar proxy e introduza os detalhes do proxy.
      • Esquema de autenticação de proxy: selecione o tipo de autenticação para autenticar com o servidor proxy. Os seguintes tipos de autenticação são suportados:
        • Básica: autenticação HTTP básica.
        • Resumo: autenticação HTTP de resumo.
      • Utilizador do proxy: um nome de utilizador a ser usado para autenticação com o servidor proxy.
      • Palavra-passe do proxy: o segredo do Secret Manager da palavra-passe do utilizador.
      • Tipo de SSL do proxy: o tipo de SSL a usar quando se liga ao servidor proxy. Os seguintes tipos de autenticação são suportados:
        • Automático: predefinição. Se o URL for um URL HTTPS, é usada a opção Túnel. Se o URL for um URL HTTP, é usada a opção NUNCA.
        • Sempre: a ligação está sempre ativada com SSL.
        • Nunca: a ligação não tem o SSL ativado.
        • Túnel: a ligação é feita através de um proxy de túnel. O servidor proxy abre uma ligação ao anfitrião remoto e o tráfego flui em ambas as direções através do proxy.
      • Na secção Servidor proxy, introduza os detalhes do servidor proxy.
        1. Clique em + Adicionar destino.
        2. Selecione um Tipo de destino.
          • Endereço do anfitrião: especifique o nome do anfitrião ou o endereço IP do destino.

            Se quiser estabelecer uma ligação privada ao seu sistema de back-end, faça o seguinte:
    9. Opcionalmente, clique em + ADICIONAR ETIQUETA para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
    10. Clicar em Seguinte.
  5. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação e clique em Seguinte.

    6. No campo Tipo de destino, selecione o tipo pretendido.

    • Para especificar o nome de anfitrião ou o endereço IP de destino, selecione Endereço do anfitrião e introduza o endereço no campo Anfitrião 1.
    • Para estabelecer uma ligação privada, selecione Anexo do ponto final e escolha o anexo necessário na lista Anexo do ponto final.

    Se quiser estabelecer uma ligação pública aos seus sistemas de back-end com segurança adicional, pode considerar configurar endereços IP estáticos de saída para as suas ligações e, em seguida, configurar as regras da firewall para permitir apenas os endereços IP estáticos específicos.

  6. Na secção Autenticação, introduza os detalhes de autenticação.
    1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

      Os seguintes tipos de autenticação são suportados pela ligação do Salesforce:

      • OAuth 2.0 – Código de autorização
      • OAuth 2.0 – JWT bearer
      • OAuth 2.0 – Credenciais de cliente
      • Nome de utilizador e palavra-passe

      2. Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

    2. Clicar em Seguinte.
  7. Reveja os detalhes da ligação e da autenticação e, de seguida, clique em Criar.

Configure a autenticação

Introduza os detalhes com base na autenticação que quer usar.

  • OAuth 2.0 – Código de autorização
    • ID de cliente: o ID de cliente usado para pedir tokens de acesso.
    • Âmbitos: uma lista separada por vírgulas dos âmbitos pretendidos.
    • Segredo do cliente: o segredo do cliente usado para pedir tokens de acesso.
    • Versão do Secret: a versão do segredo do cliente.
    • URL de autorização: o URL de autorização gerado quando cria o cliente.
  • OAUTH 2.0 - JWT bearer
    • Chave do consumidor da app associada: a chave do consumidor fornecida pelo Salesforce para a app associada que criou.
    • Nome de utilizador: o nome de utilizador associado à app ligada que criou.
    • Chave privada: segredo do Secret Manager que contém o conteúdo do ficheiro de chave privada. A chave privada tem de corresponder à chave pública/certificado fornecido à Salesforce.
    • Versão do Secret: a versão da chave privada.

    Para mais informações, consulte o artigo Crie uma ligação do Salesforce através do JWT.

  • OAuth 2.0 – Credenciais de cliente
    • ID de cliente: o ID de cliente da app que criou.
    • Segredo do cliente: segredo do Secret Manager que contém o segredo do cliente para a app associada que criou.
    • Versão do Secret: a versão do segredo do cliente.
  • Nome de utilizador e palavra-passe
    • Nome de utilizador: o nome de utilizador do Salesforce a usar para a ligação.
    • Palavra-passe: o Secret do Secret Manager que contém a palavra-passe associada ao nome de utilizador do Salesforce.
    • Token de segurança: segredo do Secret Manager que contém um código alfanumérico sensível a maiúsculas e minúsculas fornecido pelo Salesforce para o utilizador.
    • Versão do Secret: a versão do Secret do Secret Manager.

Exemplos de configuração de ligação

Esta secção apresenta os valores de exemplo para os vários campos que configura quando cria a associação.

Tipo de ligação com nome de utilizador e palavra-passe

Nome do campo Detalhes
Localização us-central1
Conetor salesforce
Versão do conetor 1
Nome da ligação google-cloud-salesforce-conn
Ative o Cloud Logging Sim
Nível de registo Erro
Conta de serviço SERVICEACCOUNT_NAME@developer.gserviceaccount.com
Nível de verbosidade 5
Número mínimo de nós 2
Número máximo de nós 50
Tipo de destino Morada do anfitrião
Anfitrião 1 https://login.salesforce.com.
Nome de utilizador NOME DE UTILIZADOR
Palavra-passe PASSWORD
Versão do Secret 1
Token de segurança zrph####53HCM6D1ZdW####
Versão do Secret 1

Nova autorização para o código de autorização

Se estiver a usar o tipo de autenticação Authorization code e tiver feito alterações de configuração na sua aplicação Salesforce de back-end, tem de autorizar novamente a ligação ao Salesforce. Para autorizar novamente uma associação, siga estes passos:

  1. Clique na associação necessária na página Associações.

    É apresentada a página de detalhes da associação.

  2. Clique em Editar para editar os detalhes da associação.
  3. Valide os detalhes de OAuth 2.0 – Código de autorização na secção Autenticação.

    Se necessário, faça as alterações necessárias.

  4. Clique em Guardar. Esta ação direciona para a página de detalhes da associação.
  5. Clique em Editar autorização na secção Autenticação. É apresentado o painel Autorizar.
  6. Clique em Autorizar.

    Se a autorização for bem-sucedida, o estado da ligação é definido como Ativo na página Ligações.

Instale a app associada OAuth 2.0

Como parte de uma melhoria de segurança, o Salesforce requer agora que todas as apps associadas que usam a autenticação OAuth 2.0 sejam instaladas. Isto aplica-se a associações novas e existentes. Esta alteração significa que a sua associação existente pode deixar de funcionar, a menos que a app associada esteja instalada no Salesforce. Navegue para a página Utilização do OAuth de apps associadas na sua conta do Salesforce e instale a app. Para mais informações, consulte o artigo Alteração das restrições de utilização de apps associadas.

Use a ligação do Salesforce numa integração

Depois de criar a ligação, esta fica disponível no Apigee Integration e no Application Integration. Pode usar a ligação numa integração através da tarefa Conectores.

  • Para compreender como criar e usar a tarefa Connectors no Apigee Integration, consulte o artigo Tarefa Connectors.
  • Para compreender como criar e usar a tarefa Connectors na integração de aplicações, consulte o artigo Tarefa Connectors.

Ações

Este conetor permite-lhe realizar operações de inserção, eliminação, atualização e leitura em dados do Salesforce. Para executar consultas SQL personalizadas, o conector fornece a ação Executar consulta personalizada.

Para criar uma consulta personalizada, siga estes passos:

  1. Siga as instruções detalhadas para adicionar uma tarefa de conetores.
  2. Quando configurar a tarefa do conetor, no tipo de ação que quer realizar, selecione Ações.
  3. Na lista Ação, selecione Executar consulta personalizada e, de seguida, clique em Concluído.

    Imagem que mostra a ação execute-custom-query Imagem que mostra a ação execute-custom-query

  4. Expanda a secção Entrada de tarefas e, de seguida, faça o seguinte:
    1. No campo Tempo limite após, introduza o número de segundos a aguardar até que a consulta seja executada.

      Valor predefinido: 180 segundos.

    2. No campo Número máximo de linhas, introduza o número máximo de linhas a devolver da base de dados.

      Valor predefinido: 25.

    3. Para atualizar a consulta personalizada, clique em Editar script personalizado. É apresentada a caixa de diálogo Editor de scripts.

      imagem a mostrar custom-sql-query imagem a mostrar custom-sql-query

    4. Na caixa de diálogo Editor de scripts, introduza a consulta SQL e clique em Guardar.

      Pode usar um ponto de interrogação (?) numa declaração SQL para representar um único parâmetro que tem de ser especificado na lista de parâmetros de consulta. Por exemplo, a seguinte consulta SQL seleciona todas as linhas da tabela Employees que correspondem aos valores especificados para a coluna LastName: 

      SELECT * FROM Employees where LastName=?

    5. Se usou pontos de interrogação na sua consulta SQL, tem de adicionar o parâmetro clicando em + Adicionar nome do parâmetro para cada ponto de interrogação. Durante a execução da integração, estes parâmetros substituem os pontos de interrogação (?) na consulta SQL sequencialmente. Por exemplo, se adicionou três pontos de interrogação (?), tem de adicionar três parâmetros por ordem de sequência.

      imagem que mostra add-query-param imagem que mostra add-query-param

      Para adicionar parâmetros de consulta, faça o seguinte:

      1. Na lista Tipo, selecione o tipo de dados do parâmetro.
      2. No campo Valor, introduza o valor do parâmetro.
      3. Para adicionar vários parâmetros, clique em + Adicionar parâmetro de consulta.

      6. A ação Executar consulta personalizada não suporta variáveis de matriz.

O conector do Salesforce não suporta valores parametrizados para a cláusula OFFSET e não pode ser substituído dinamicamente através de parâmetros de consulta. No entanto, os parâmetros de consulta são suportados na cláusula WHERE.

Esta secção apresenta as ações suportadas pelo conetor do Salesforce. Para compreender como configurar as ações, consulte os exemplos de ações.

Ação CreateJobv2

Use esta ação para criar uma tarefa.

Parâmetros de entrada da ação CreateJobV2

Nome do parâmetro Tipo de dados Obrigatória Descrição
ObjectName String Sim O nome do objeto a usar para a tarefa, como Account, Campaign, Event, etc.
Consulta String Não A consulta a ser realizada.
Ação String Sim Tipo de ação a usar na tarefa. Os valores válidos são "insert", "delete", "update", "upsert" ou "query".
ExternalIdColumn String Não O campo de ID externo no objeto que está a ser atualizado. Isto é necessário para operações de inserção/atualização. Os valores dos campos também têm de existir nos dados de empregos CSV.
ColumnDelimiter String Não O delimitador de colunas usado para dados de tarefas CSV. O valor predefinido é COMMA. Os valores válidos são "BACKQUOTE", "CARET", "COMMA", "PIPE", "SEMICOLON" e "TAB".
LineEnding String Não O final de linha usado para dados de tarefas CSV, que marca o fim de uma linha de dados. A predefinição é LF. Os valores válidos são "LF" e "CRLF".
MultiPartRequest Booleano Não Ative esta funcionalidade apenas se os dados no ficheiro CSV não excederem 20 000 carateres. Também tem de especificar o caminho do ficheiro CSV.
CSVFilePath String Não Especifica o caminho do seu ficheiro CSV.

Por exemplo, para saber como configurar a ação CreateJobV2, consulte os exemplos.

Ação UploadJobDataV2

Use esta ação para carregar um ficheiro de tarefas no formato CSV para o Salesforce.

Parâmetros de entrada da ação UploadJobDataV2

Nome do parâmetro Tipo de dados Obrigatória Descrição
ContentUrl String Não O URL a usar para pedidos de "Carregar dados de emprego" para este emprego. Só é válido se a tarefa estiver no estado Aberto.
CSVFilePath String Não Especifique o caminho do seu ficheiro CSV.
Conteúdo String Sim O conteúdo do ficheiro CSV como um InputStream. Apenas deve ser fornecido se CSVFilePath estiver vazio.

Para ver um exemplo de como configurar a ação UploadJobDataV2, consulte Exemplos.

Ação CreateBatch

Esta ação cria um lote do Salesforce.

Parâmetros de entrada da ação CreateBatch

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True ID da tarefa à qual o lote está a ser adicionado.
Agregar String True O agregado de objetos que estão a ser adicionados. Especifica a consulta a usar se estiver a executar uma consulta em lote.
ContentType String True O tipo de conteúdo do trabalho. Seguem-se os valores válidos: CSV, XML, ZIP_CSV e ZIP_XML. Defina o valor como CSV se executar uma consulta em lote. O valor predefinido é XML.

Parâmetros de saída da ação CreateBatch

Por exemplo, para saber como configurar a ação CreateBatch, consulte os exemplos.

Ação CreateJob

Esta ação adiciona uma entrada de objeto do Salesforce.

Parâmetros de entrada da ação CreateJob

Nome do parâmetro Tipo de dados Obrigatória Descrição
ObjectName String True Nome do objeto a usar para a tarefa
Ação String True Tipo de ação a usar na tarefa.

Parâmetros de saída da ação CreateJob

Por exemplo, para saber como configurar a ação CreateJob, consulte os exemplos.

Ação GetBatch

Esta ação obtém informações sobre um lote do Salesforce.

Parâmetros de entrada da ação GetBatch

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True ID da tarefa à qual o lote está associado.
BatchId String True ID do lote que está a ser obtido.

Parâmetros de saída da ação GetBatch

Por exemplo, para saber como configurar a ação GetBatch, consulte os exemplos.

Ação GetJob

Esta ação recebe informações sobre uma tarefa do Salesforce.

Parâmetros de entrada da ação GetJob

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True ID da tarefa que está a ser obtida.

Parâmetros de saída da ação GetJob

Por exemplo, para saber como configurar a ação GetJob, consulte os exemplos.

Ação UploadAttachment

Esta ação carrega um anexo e associa-o a uma entidade no Salesforce.

Parâmetros de entrada da ação UploadAttachment

Nome do parâmetro Tipo de dados Obrigatória Descrição
ObjectId String True O ID do objeto ao qual associar o documento carregado.
FileName String True O nome do anexo.
Base64Data String True A string de dados a usar como conteúdo do ficheiro.

Parâmetros de saída da ação UploadAttachment

Para ver um exemplo de como configurar a ação UploadAttachment, consulte Exemplos.

Ação GetBatchResults

Esta ação obtém os resultados de um lote do Salesforce.

Parâmetros de entrada da ação GetBatchResults

Nome do parâmetro Tipo de dados Obrigatória Descrição
JobId String True ID da tarefa à qual o lote está associado.
BatchId String True ID do lote que está a ser obtido.
ContentType String True O tipo de conteúdo do trabalho.

Parâmetros de saída da ação GetBatchResults

Para ver um exemplo de como configurar a ação GetBatchResults, consulte Exemplos.

Exemplos de ações

Exemplo: CreateJobV2

Este exemplo cria uma tarefa.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateJobV2 e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conectores, clique em connectorInputPayload e, em seguida, tem de introduzir um valor semelhante ao seguinte no campo Default Value: 
     {
  "ObjectName": "Contact",
  "Action": "insert"
 }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CREATEJOBV2connectorOutputPayload

     
  [{
  "ID": "750dM000005HjdnQAC",
  "State": "Open",
  "JobType": null,
  "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches",
  "ContentType": "CSV",
  "CreatedDate": "2024-08-07T09:16:16.000+0000",
  "CreatedById": "005dM0000061WSFQA2",
  "ConcurrencyMode": "Parallel",
  "SystemModStamp": "2024-08-07T09:16:16.000+0000"
  }]

Exemplo: UploadJobDataV2

Este exemplo carrega um ficheiro de tarefas para o Salesforce.

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UploadJobDataV2 e, de seguida, clique em Concluído.
  3. Na secção Entrada da tarefa da tarefa Conetores, clique em connectorInputPayload e, de seguida, introduza um valor semelhante ao seguinte no campo Default Value: 
     {
  "Content":   "FirstName,LastName,Email,MobilePhone,External_Id__c\\nGinelle,Merioth,gmerioth0@example.com,851-555-8435,4d13cac0-2c11-48e9-891d-49ee9508a6c7\\nDalli,Tumilson,dtumilson1@example.com,881-555-6742,38bcb24b-247f-498b-9502-c98995a1e04b\\nRobbin,Purveys,rpurveys2@example.com,732-555-6909,35d96c7a-3856-4809-8c49-35ddb9fa7dd9\\nLothaire,Ivanchenkov,livanchenkov3@example.com,144-555-1959,75f63f26-6f4a-406f-a9f4-807f4a8a7b51",
  "ContentUrl": "services/data/v43.0/jobs/ingest/750dM000005HjdnQAC/batches"
 }

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UploadJobDataV2connectorOutputPayload

     
  [{
  "Uploaded": "true"
  }]

Exemplo: CreateBatch

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateBatch e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
"JobId": "750dL000007EipxQAC",
"Aggregate": "\n    Walter\n    White\n  \n  \n    Rob\n    Brown\n  \n",
"ContentType": "XML"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CreateBatchconnectorOutputPayload

     
[{
  "ID": "751dL000003ziC5QAI",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-03T04:48:53.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Queued",
  "StateMessage": null,
  "SystemModstamp": "2024-09-03T04:48:53.000Z",
  "TotalProcessingTime": "0"
}]

Exemplo: CreateJob

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CreateJob e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "ObjectName": "Campaign",
  "Action": "insert"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:CreateJobconnectorOutputPayload

     
 [{
  "ID": "750dL000007GgD7QAK",
  "JobID": "750dL000007GgD7QAK",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-03T05:31:41.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "0",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "0",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-03T05:31:41.000Z",
  "TotalProcessingTime": "0"
}]

Exemplo: GetBatch

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetBatch e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "BatchId": "751dL000003yKlJQAU",
  "JobId": "750dL000007EipxQAC"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:GetBatchconnectorOutputPayload

     
[{
  "ID": "751dL000003yKlJQAU",
  "JobID": "750dL000007EipxQAC",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "CreatedDate": "2024-09-02T11:44:15.000Z",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "State": "Failed",
  "StateMessage": "InvalidBatch : Failed to parse XML. Unexpected XML element 'sObject' found at  START_TAG seen ... @1:9 it should be 'sObjects'",
  "SystemModstamp": "2024-09-02T11:44:15.000Z",
  "TotalProcessingTime": "0"
}]

Exemplo: GetJob

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetJob e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "JobId": "750dL000007EipxQAC"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:GetJobconnectorOutputPayload

     
[{
  "ID": "750dL000007EipxQAC",
  "JobID": "750dL000007EipxQAC",
  "ObjectName": "Campaign",
  "Operation": "insert",
  "ApiVersion": "56.0",
  "ApexProcessingTime": "0",
  "ApiActiveProcessingTime": "0",
  "AssignmentRuleId": null,
  "ConcurrencyMode": "Parallel",
  "ContentType": "XML",
  "CreatedById": "005dL000007CalFQAS",
  "CreatedDate": "2024-09-02T11:17:42.000Z",
  "ExternalIdFieldName": null,
  "NumberBatchesCompleted": "0",
  "NumberBatchesQueued": "0",
  "NumberBatchesFailed": "2",
  "NumberBatchesInProgress": "0",
  "NumberBatchesTotal": "2",
  "NumberRecordsFailed": "0",
  "NumberRecordsProcessed": "0",
  "NumberRetries": "0",
  "State": "Open",
  "SystemModStamp": "2024-09-02T11:17:42.000Z",
  "TotalProcessingTime": "0"
}]

Exemplo: UploadAttachment

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação UploadAttachment e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "ObjectId": "001dL00000SC6j7QAD",
  "FileName": "My files/salesforce/con.csv",
  "Base64Data": "Y29ubmVjdG9ycyBpcyBiYWNr"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:UploadAttachmentconnectorOutputPayload

     
[{
  "Id": "00PdL000000EJUDUA4"
}]

Exemplo: GetBatchResults

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação GetBatchResults e, de seguida, clique em Concluído.
  3. Na secção Mapeamento de dados Open Data Mapping Editor e, de seguida, introduza um valor semelhante ao seguinte no campo Input: 
    {
  "BatchId": "751dL000004D17FQAS",
  "JobId": "750dL000007XKUhQAO",
  "ContentType": "XML"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta da tarefa terá um valor semelhante ao seguinte:GetBatchResultsconnectorOutputPayload

     
[{
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}, {
  "ID": null,
  "Created": "false",
  "Success": "false",
  "Errors_Fields": "LastName",
  "Errors_Message": "Account: bad field names on insert/update call: FirstName, LastName",
  "Errors_StatusCode": "INVALID_FIELD_FOR_INSERT_UPDATE"
}]

Exemplos de operações de entidades

Esta secção mostra como realizar algumas das operações de entidades neste conector.

Exemplo: criar um anexo

    A criação de anexos de entidades cria apenas um anexo sem um ficheiro de conteúdo. Para adicionar um ficheiro, temos de executar a ação UploadAttachment fornecendo um contexto de ficheiro na entrada.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Anexo na lista Entity.
  3. Selecione a operação Create e, de seguida, clique em Concluído.
  4. Na secção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e, de seguida, introduza um valor semelhante ao seguinte em field: 
    {
  "Name": "New Attachment",
  "Description": "New created attachment",
  "ParentId": "001dL00000SC6j7QAD",
  "Body": "Body"
}

  5. A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

    {
  "Id": "00PdL000000EJKXUA4"
}

Exemplo: atualize um anexo

    O anexo de atualização da entidade apenas atualiza o nome ou a descrição do anexo. Para adicionar um ficheiro, temos de executar a ação UploadAttachment fornecendo um contexto de ficheiro na entrada.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Anexo na lista Entity.
  3. Selecione a operação Update e, de seguida, clique em Concluído.
  4. Defina o ID da entidade para atualizar um anexo. Para definir o ID da entidade, na secção Mapeador de dados de Tarefas, clique em EntityID e, em seguida, introduza 00PdL000000EJKXUA4 no campo indicado.
  5. Na secção Mapeador de dados da Tarefa, clique no editor OpenDataMapping e, de seguida, introduza um valor semelhante ao seguinte em field: 
    {
  "Name": "New Attachment",
  "Description": "New updated attachment",
  "Body": "Body"
}

    6. Em alternativa, em vez de especificar o entityId, também pode definir o filterClause como 00PdL000000EJKXUA4.

  6. A execução deste exemplo devolve uma resposta semelhante à seguinte na variável de saída connectorOutputPayload da tarefa do conetor:

    {
  "Id": "00PdL000000EJKXUA4"
}

Limitações do sistema

O conetor do Salesforce pode processar um máximo de 28 transações por segundo, por nó e limita todas as transações que excedam este limite. Por predefinição, os Integration Connectors atribuem 2 nós (para uma melhor disponibilidade) a uma ligação.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Crie ligações com o Terraform

Pode usar o recurso do Terraform para criar uma nova associação.

Para saber como aplicar ou remover uma configuração do Terraform, consulte os comandos básicos do Terraform.

Para ver um modelo do Terraform de exemplo para a criação de ligações, consulte o modelo de exemplo.

Quando criar esta associação através do Terraform, tem de definir as seguintes variáveis no ficheiro de configuração do Terraform:

Nome do parâmetro Tipo de dados Obrigatória Descrição
proxy_enabled BOOLEAN Falso Selecione esta caixa de verificação para configurar um servidor proxy para a ligação.
proxy_auth_scheme ENUM Falso O tipo de autenticação a usar para autenticar no proxy ProxyServer. Os valores suportados são: BASIC, DIGEST, NONE
proxy_user STRING Falso Um nome de utilizador a ser usado para autenticar no proxy ProxyServer.
proxy_password SECRET Falso Uma palavra-passe a usar para autenticar no proxy ProxyServer.
proxy_ssltype ENUM Falso O tipo de SSL a usar quando se liga ao proxy ProxyServer. Os valores suportados são: AUTO, ALWAYS, NEVER, TUNNEL

Obtenha ajuda da comunidade do Google Cloud

Pode publicar as suas perguntas e discutir este conector na comunidade do Google Cloud nos Fóruns do Cloud.

O que se segue?