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, um administrador de TI primeiro 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 Parallel (Paralelo).
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões de 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 objeto |
Digite o tipo de objeto para 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 pesquisar 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 Parallel (Paralelo).
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões de 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 objeto |
Digite o tipo de objeto para executar a operação. |
| Arquivo de entrada |
Digite 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 pesquisar 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 Parallel (Paralelo).
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões de 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 objeto |
Digite o tipo de objeto para executar a operação. |
| Consulta SOQL |
Digite a consulta SOQL a ser executada. |
Saídas
| Saída |
Tipo de saída |
| CSV de resultados de consultas em massa |
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 Parallel (Paralelo).
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões de 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 objeto |
Digite o tipo de objeto para executar a operação. |
| Arquivo de entrada |
Digite 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 pesquisar 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 |
Inserção em massa
Para realizar uma 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 um registro não conseguir fazer o upsert, 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 Parallel (Paralelo).
- Para processar registros sequencialmente, selecione Serial.
Observação: Para um trabalho muito grande, selecione Serial, pois o volume de conexões de 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 objeto |
Digite o tipo de objeto para executar a operação. |
| Arquivo de entrada |
Digite 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 pesquisar 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 externa |
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 SObjeto 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, insira uma ID externa no formato EXTERNAL_ID_NAME:VALUE, como Name:John. |
| Nome |
Digite o nome do objeto para 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 deseja recuperar 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 para recuperar o registro. |
| Campos |
Digite 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 os logins no ambiente do Salesforce, use o comando List 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 objetos do Salesforce, use o comando List objects .
Propriedades
Nenhum
Saídas
| Saída |
Tipo de saída |
| Lista de 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 |
| Relatórios de listagem 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 registros de uma só 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 o notificarão.
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 de 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 objeto no Salesforce, use um 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 |
SObjeto - excluir
Para excluir SObjetos no Salesforce, use um 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 um comando Update record .
Propriedades
| Propriedade |
Detalhes |
| ID |
Digite o ID do registro a ser atualizado. |
| Nome |
Digite o nome do SObjeto 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**.
-->