ação Executar SOQL no Salesforce

Para buscar seus dados Salesforce para informações específicas, execute o comando SOQL (Salesforce Object Query Language, linguagem de consulta de objeto do Salesforce) a partir do Automation 360 utilizando a ação SOQL de execução do Salesforce.

O SOQL é semelhante à SQL (Structured Query Language, linguagem de consulta estruturada), mas é adaptado para dados da Salesforce. Para mais informações sobre o SOQL, veja Executar SOQL no Salesforce.

Para obter informações específicas dos dados da Salesforce, execute uma consulta a partir de Automation 360.

Para enviar uma consulta SOQL ao Salesforce, utilizando o Executar SOQLação, execute as seguintes etapas:
Nota: Certifique-se de estar autenticado antes de chamar qualquer ação do Salesforce. Para obter mais informações sobre autenticação, consulte ação Autenticação do Salesforce.

Procedimento

  1. No painel Ações, selecione Salesforce > Executar SOQL e coloque-a na tela.
    Salesforce Executar ação SOQL
  2. Insira os seguintes campos:
    1. Digite a Consulta SOQL para executar, por exemplo, Selecione Status De Caso Onde Id = '5004W000026rD4HQAU'..
      Nota: Para Objetos personalizados do Salesforce, você deverá fornecer o Nome da API em vez do Nome de exibição do objeto. Por exemplo, informe o Nome da API: AAIRPA__Salesforce_Connection__c e não o que está exibido nome: Conexão da força de vendas”. Para obter mais informações sobre como encontrar o nome da API, consulte https://help.salesforce.com/s/articleView?id=000327123&type=1.
    2. Selecione uma das seguintes opções:
      • Se você quiser incluir os registros excluídos, selecione Sim.
      • Se você não quiser incluir os registros excluídos, selecione Não.
    3. Digite Padrão como o nome da sessão.
    4. Salve o resultado em uma variável. Por exemplo, todos os campos dos registros podem ser armazenados em uma lista (Lista_SOQL)
  3. Verifique se você pode executar o bot em modo Debug com um ponto de parada definido para uma ação ao lado do SOQL de execução. Por exemplo, na amostra fornecida anteriormente, há uma Caixa de mensagensação. Abra a variável List_SOQL para visualizar os resultados.
    Salesforce verifica a ação SOQL de execução
    Todo o conjunto de resultados é retornado como uma resposta SOQL de execução do Salesforce e não há limitação ao número de registros retornados.
    Nota: A resposta pode ter um alto volume de dados que pode degradar o desempenho da sua automação.
    Nota: A saída é recuperada como uma lista do tipo Dicionário. Para ler um registro individual (linha) nessa lista, é necessário percorrer todos os itens do dicionário usando a ação Loop e ler ou extrair os registros (linhas) individualmente. Por exemplo, a saída de obter vários registros é salva na variável list_of_records_any. Se a variável contiver cinco registros, cada registro será passado para a ação de loop para ser processado um de cada vez.Ação de loop para obter vários registros