Para interagir com dados dentro do Salesforce® como parte de uma cadeia, adicione uma etapa com um comando de conexão do Salesforce. Por exemplo:
- Carregar, extrair e excluir dados por meio de SOQL e operações em massa
- Criar e gerenciar objetos do Salesforce
- Atualizar e criar registros
Para habilitar esses comandos, primeiro um administrador de TI cria um conector do Salesforce. O conector interage com todas as versões do Salesforce Sales Cloud - Salesforce Essentials®, Lightning® Professional, Lightning Enterprise e Lightning Unlimited - por meio da API REST.
Exclusão em massa
Para excluir um grande volume de registros com base em um arquivo de valores separados por vírgula (CSV), use o comando Bulk delete.
Observação: Se houver falha na exclusão de um registro, o comando retornará um CSV listando os números de linha dos registros com falha, juntamente com o motivo da falha. Você pode usar a ramificação para executar ações quando o comando falhar ou carregar as falhas no Google® Drive para análise posterior.
Propriedades
| Propriedade |
Detalhes |
| Modo de simultaneidade |
Selecione se deseja processar os registros ao mesmo tempo ou sequencialmente.
- Para processar registros ao mesmo tempo, selecione Paralelo.
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões com o banco de dados pode fazer com que o trabalho falhe no modo Paralelo. No entanto, o modo Serial pode resultar em tempos de processamento muito mais longos. |
| Nome do SObjeto |
Digite o tipo de SObjeto no qual você deseja executar a operação. |
| Arquivo de entrada |
Digite o arquivo que contém os registros a serem excluídos. |
| Formato do arquivo |
Selecione se O arquivo de entrada é CSV, JSON ou XML. |
| Tamanho do lote |
Insira o número de registros a serem processados por lote. Recomendamos que você deixe o padrão. |
| Aguardar a conclusão |
Para sondar o Salesforce e só passar para o próximo comando quando todos os registros forem processados, marque essa caixa. Para acionar o comando e passar imediatamente para a próxima etapa, desmarque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Registro de erros de exclusão em massa |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Inserção em massa
Para inserir um grande volume de registros com base em um arquivo CSV, use o comando Bulk insert.
Observação: Se houver falha na inserção de um registro, o comando retornará um CSV listando os números de linha dos registros com falha, juntamente com o motivo da falha. Você pode usar a ramificação para executar ações quando o comando falhar ou carregar as falhas no Google® Drive para análise posterior.
Propriedades
| Propriedade |
Detalhes |
| Modo de simultaneidade |
Selecione se deseja processar os registros ao mesmo tempo ou sequencialmente.
- Para processar registros ao mesmo tempo, selecione Paralelo.
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões com o banco de dados pode fazer com que o trabalho falhe no modo Paralelo. No entanto, o modo Serial pode resultar em tempos de processamento muito mais longos. |
| Nome do SObjeto |
Digite o tipo de SObjeto no qual você deseja executar a operação. |
| Arquivo de entrada |
Insira o arquivo que contém os registros a serem inseridos. |
| Formato do arquivo |
Selecione se O arquivo de entrada é CSV, JSON ou XML. |
| Tamanho do lote |
Insira o número de registros a serem processados por lote. Recomendamos que você deixe o padrão. |
| Aguardar a conclusão |
Para sondar o Salesforce e só passar para o próximo comando quando todos os registros forem processados, marque essa caixa. Para acionar o comando e passar imediatamente para a próxima etapa, desmarque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Registro de erros de inserção em massa |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Consulta em massa
Para consultar um grande volume de registros, use o comando Bulk query.
Propriedades
| Propriedade |
Detalhes |
| Modo de simultaneidade |
Selecione se deseja processar os registros ao mesmo tempo ou sequencialmente.
- Para processar registros ao mesmo tempo, selecione Paralelo.
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões com o banco de dados pode fazer com que o trabalho falhe no modo Paralelo. No entanto, o modo Serial pode resultar em tempos de processamento muito mais longos. |
| Nome do SObjeto |
Digite o tipo de SObject no qual você deseja executar a operação. |
| Consulta SOQL |
Digite a consulta SOQL a ser executada. |
Saídas
| Saída |
Tipo de saída |
| Resultados da consulta em massa CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Atualização em massa
Para atualizar um grande volume de registros, use o comando Bulk update.
Observação: Se houver falha na atualização de um registro, o comando retornará um CSV listando os números de linha dos registros com falha, juntamente com o motivo da falha. Você pode usar a ramificação para executar ações quando o comando falhar ou carregar as falhas no Google® Drive para análise posterior.
Propriedades
| Propriedade |
Detalhes |
| Modo de simultaneidade |
Selecione se deseja processar os registros ao mesmo tempo ou sequencialmente.
- Para processar registros ao mesmo tempo, selecione Paralelo.
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões com o banco de dados pode fazer com que o trabalho falhe no modo Paralelo. No entanto, o modo Serial pode resultar em tempos de processamento muito mais longos. |
| Nome do SObjeto |
Digite o tipo de SObjeto no qual você deseja executar a operação. |
| Arquivo de entrada |
Insira o arquivo que contém os registros a serem atualizados. |
| Formato do arquivo |
Selecione se O arquivo de entrada é CSV, JSON ou XML. |
| Tamanho do lote |
Insira o número de registros a serem processados por lote. Recomendamos que você deixe o padrão. |
| Aguardar a conclusão |
Para sondar o Salesforce e só passar para o próximo comando quando todos os registros forem processados, marque essa caixa. Para acionar o comando e passar imediatamente para a próxima etapa, desmarque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Registro de erros de atualização em massa |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Bulk upsert
Para executar um upsert - para atualizar registros existentes ou criar novos registros com base em uma ID externa - em um grande volume de registros, use o comando Bulk upsert.
Observação: Se houver falha na inserção de um registro, o comando retornará um CSV listando os números de linha dos registros com falha, juntamente com o motivo da falha. Você pode usar a ramificação para executar ações quando o comando falhar ou carregar as falhas no Google® Drive para análise posterior.
Propriedades
| Propriedade |
Detalhes |
| Modo de simultaneidade |
Selecione se deseja processar os registros ao mesmo tempo ou sequencialmente.
- Para processar registros ao mesmo tempo, selecione Paralelo.
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões com o banco de dados pode fazer com que o trabalho falhe no modo Paralelo. No entanto, o modo Serial pode resultar em tempos de processamento muito mais longos. |
| Nome do SObjeto |
Digite o tipo de SObjeto no qual você deseja executar a operação. |
| Arquivo de entrada |
Insira o arquivo que contém os registros a serem inseridos. |
| Formato do arquivo |
Selecione se O arquivo de entrada é CSV, JSON ou XML. |
| Tamanho do lote |
Insira o número de registros a serem processados por lote. Recomendamos que você deixe o padrão. |
| Aguardar a conclusão |
Para sondar o Salesforce e só passar para o próximo comando quando todos os registros forem processados, marque essa caixa. Para acionar o comando e passar imediatamente para a próxima etapa, desmarque essa caixa. |
| ID externo |
Para identificar se um registro já existe ou precisa ser criado, insira o campo de ID externo necessário para o objeto envolvido na inserção. |
Saídas
| Saída |
Tipo de saída |
| Registro de erros de upsert em massa |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Criar registro
Para criar um novo registro no Salesforce, use o comando Create record.
Propriedades
| Propriedade |
Detalhes |
| Nome |
Digite o nome do objeto SObject para criar o registro. |
| Campos |
Insira os campos de registro a serem atualizados, no formato FIELD_NAME:VALUE. |
Saídas
| Saída |
Tipo de saída |
| ID do novo registro |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Excluir registro
Para excluir um registro no Salesforce com base em seu ID, use o comando Delete record.
Propriedades
| Propriedade |
Detalhes |
| ID |
Digite o ID do registro a ser excluído. Se a ID for desconhecida, digite uma ID externa no formato EXTERNAL_ID_NAME:VALUE, como Name:John. |
| Nome |
Digite o nome do SObjeto no qual você deseja excluir o registro. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Baixar relatório
Para fazer download de um relatório personalizado como um arquivo de valores separados por vírgula (CSV), use o comando Download report.
Propriedades
| Propriedade |
Detalhes |
| ID do relatório |
Digite o ID do relatório personalizado a ser baixado. |
Saídas
| Saída |
Tipo de saída |
| Relatório personalizado CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Obter metadados do objeto
Para recuperar os campos e metadados associados a um objeto do Salesforce, use o comando Get object metadata.
Propriedades
| Propriedade |
Detalhes |
| Objeto |
Digite o nome do objeto para o qual você deseja recuperar os metadados. |
Saídas
| Saída |
Tipo de saída |
| Metadados do objeto |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Obter registro
Para recuperar um registro do Salesforce com base em seu ID, use o comando Get record.
Propriedades
| Propriedade |
Detalhes |
| ID |
Digite o ID do registro a ser recuperado. |
| Nome |
Digite o nome do SObjeto no qual você deseja recuperar o registro. |
| Campos |
Insira os campos do relatório a serem incluídos (opcional). |
Saídas
| Saída |
Tipo de saída |
| Obter registro JSON |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Listar logins
Para listar logins no ambiente do Salesforce, use o comando Listar logins.
Propriedades
Nenhum
Saídas
| Saída |
Tipo de saída |
| Listar logins CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Listar objetos
Para listar SObjetos do Salesforce, use o comando List objects.
Propriedades
Nenhum
Saídas
| Saída |
Tipo de saída |
| Listar objetos CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Relatórios de listagem
Para listar relatórios do Salesforce, use o comando List reports.
Propriedades
Nenhum
Saídas
| Saída |
Tipo de saída |
| Listar relatórios CSV |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Consulta SOQL
Para executar uma consulta SOQL e gerar seus resultados como um arquivo CSV, use o comando SOQL query.
Observação: A sintaxe do SOQL é muito semelhante à do SQL. O comando SOQL Query pode extrair grandes volumes de dados e retornar conjuntos de dados de 1 milhão ou mais de registros por vez. Se o comando falhar porque a consulta está incorreta ou faz referência a objetos que não existem, as saídas do comando notificarão você.
Propriedades
| Propriedade |
Detalhes |
| Consulta |
Digite a consulta SOQL a ser executada. |
| Comando de consulta |
Selecione se deseja incluir registros excluídos.
- Para excluir registros excluídos, selecione Query (Consulta).
- Para incluir registros excluídos, selecione QueryAll.
|
Saídas
| Saída |
Tipo de saída |
| Saída da consulta SOQL |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
SObjeto - criar
Para criar um novo SObject no Salesforce, use o comando SOjbect- create.
Propriedades
| Propriedade |
Detalhes |
| Nome |
Digite o nome do novo SObject. Para indicar que esse é um objeto personalizado, o Salesforce anexa automaticamente __c. |
| Campos |
Insira os campos de registro a serem criados, no formato FIELD_NAME:TYPE, em que TYPE corresponde a um tipo de campo do Salesforce. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
SObject - delete
Para excluir SObjetos no Salesforce, use o comando SObject - delete.
Propriedades
| Propriedade |
Detalhes |
| Nome |
Digite o nome dos SObjetos a serem criados. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
Atualizar registro
Para atualizar os valores de campo de um registro no Salesforce, use o comando Update record.
Propriedades
| Propriedade |
Detalhes |
| ID |
Digite o ID do registro a ser atualizado. |
| Nome |
Digite o nome do SObject para atualizar o registro. |
| Campos |
Insira os campos de registro a serem atualizados, no formato FIELD_NAME:VALUE. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Falha geral |
<!--## Recipes
### Extract Data from Salesforce to Anaplan
To extract data from Salesforce as a CSV file and upload it directly to Anaplan®:
1. Create the chain:
1. In **Chains**, click **Add**.
2. Enter a unique name to identify the chain.
3. Click **Save**.
2. To execute a SOQL query to extract data from Salesforce as the first step of the chain:
3. Click **Add a command**.
4. Select **Salesforce**, **SOQL Query**.
4. Select the Salesforce connector.
5. Enter the query and its parameters.
6. Click **Save**.
3. To load the CSV output into Anaplan as the second step:
1. Click **Add a command**, and in **Run Condition**, select Success.
2. Select **Anaplan**, **Upload file**.
3. Select the Anaplan connector.
4. Enter the properties of the command. For **Source File**, select **SOQL Query Output**.
5. Click **Save**.
4. Click **Publish**.
-->