Salesforce módulos
Em um cenário do Adobe Workfront Fusion, é possível automatizar fluxos de trabalho que usam o Salesforce, bem como conectá-lo a vários aplicativos e serviços de terceiros.
Para obter uma introdução ao vídeo sobre o conector do Salesforce, consulte:
Para obter instruções sobre como criar um cenário, consulte os artigos em Criar cenários: índice do artigo.
Para obter informações sobre módulos, consulte os artigos em Módulos: índice do artigo.
- Nem todas as edições de Salesforce têm acesso à API. Para obter detalhes, consulte as informações sobre Salesforce edições com acesso à API no site da Comunidade Salesforce.
- Para obter informações sobre erros específicos retornados da API Salesforce, consulte os documentos da API Salesforce. Você também pode verificar o status da API Salesforce em busca de possíveis interrupções de serviço.
Requisitos de acesso
Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacote do Adobe Workfront | Qualquer |
| Licença do Adobe Workfront |
Novo: Padrão Ou Atual: trabalho ou superior |
| Licença do Adobe Workfront Fusion** |
Atual: nenhum requisito de licença do Workfront Fusion Ou Herdados: Automação e integração do Workfront Fusion for Work |
| Produto |
Novo menu:
Ou Atual: sua organização deve comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações nesta tabela, consulte Requisitos de acesso na documentação.
Para obter informações sobre licenças do Adobe Workfront Fusion, consulte licenças do Adobe Workfront Fusion.
Pré-requisitos
Para usar módulos Salesforce, você deve ter uma conta Salesforce.
Informações da API do Salesforce
O conector do Salesforce usa o seguinte:
Sobre a pesquisa de Salesforce objetos
Ao pesquisar objetos, você pode inserir palavras de pesquisa individuais ou criar uma consulta mais complexa usando curingas e operadores:
- Use o curinga asterisco (*) como substituto para zero ou mais caracteres. Por exemplo, uma pesquisa por Ca* encontra itens que começam com Ca
- Usar um curinga de ponto de interrogação (?) como um substituto para um caractere único. Por exemplo, uma pesquisa por João encontra itens com o termo João ou João, mas não João
- Use o operador de aspas (" ") para encontrar uma correspondência exata de frase. Por exemplo: "reunião de segunda-feira"
Para obter mais informações sobre as possibilidades de pesquisa, consulte a documentação do desenvolvedor do Salesforce sobre SOQL e SOSL.
Criar uma conexão com Salesforce
Para criar uma conexão para seus módulos do Salesforce:
-
Em qualquer módulo Salesforce, clique em Adicionar ao lado da caixa Conexão.
-
Preencha os seguintes campos:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Nome da Conexão Insira um nome para a nova conexão. Ambiente Selecione se estão se conectando a um ambiente de produção ou não produção. Tipo Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal. ID do Cliente Insira a ID do cliente do Salesforce. Segredo do Cliente Insira o segredo do cliente do Salesforce. Sandbox Ative essa opção se esse for um ambiente de sandbox. Versão da API Insira a versão da API do Salesforce que deseja usar. A versão padrão é 62.0. -
Clique em Continuar para salvar a conexão e retornar ao módulo.
Salesforce módulos e seus campos
Acionadores
Assistir a um campo
Este módulo de acionador inicia um cenário quando um campo é atualizado em Salesforce.
Observar por Registros
Esse módulo de acionamento executa um cenário quando um registro em um objeto é criado ou atualizado. O módulo retorna todos os campos padrão associados ao registro ou aos registros, juntamente com quaisquer campos e valores personalizados que a conexão acesse. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Observar Mensagens de Saída
Esse módulo de acionamento executa um cenário quando alguém envia uma mensagem. O módulo retorna todos os campos padrão associados ao registro ou aos registros, juntamente com quaisquer campos e valores personalizados que a conexão acesse. Você pode mapear essas informações em módulos subsequentes no cenário.
Este módulo requer configuração extra. Deve haver um Fluxo configurado para mensagens de saída.
- Para obter instruções sobre Fluxos no Salesforce, consulte Automatizar Tarefas com Fluxos na documentação do Salesforce.
- Para obter informações sobre como configurar uma mensagem de saída no Salesforce, consulte Enviar uma mensagem de saída do seu fluxo acionado por registro, na documentação do Salesforce
Ao configurar esse módulo, os campos a seguir são exibidos.
Ações
Criar um Registro
Este módulo de ação cria um novo registro em um objeto.
O módulo permite selecionar quais dos campos do objeto estão disponíveis no módulo. Isso reduz o número de campos que você deve percorrer ao configurar o módulo.
O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Chamada de API personalizada
Este módulo de ação permite fazer uma chamada autenticada personalizada para a API Salesforce. Dessa forma, você pode criar uma automação de fluxo de dados que não pode ser realizada pelos outros módulos do Salesforce.
O módulo retorna o seguinte:
-
Código de Status (número): indica o sucesso ou a falha da sua solicitação HTTP. Esses são códigos padrão que você pode pesquisar na Internet.
-
Cabeçalhos (objeto): um contexto mais detalhado para o código de resposta/status que não está relacionado ao corpo de saída. Nem todos os cabeçalhos que aparecem em um cabeçalho de resposta são cabeçalhos de resposta, portanto, alguns podem não ser úteis para você.
Os cabeçalhos de resposta dependem da solicitação HTTP escolhida ao configurar o módulo.
-
Corpo (objeto): dependendo da solicitação HTTP escolhida ao configurar o módulo, você poderá receber alguns dados de volta. Estes dados, como os dados de uma solicitação GET, estão contidos neste objeto.
Ao configurar esse módulo, os campos a seguir são exibidos.
Insira um caminho relativo a <Instance URL>/services/data/v62.0/.
Para obter a lista de pontos de extremidade disponíveis, consulte o Guia do Desenvolvedor da API REST do Salesforce.
{"Content-type":"application/json"}. O Workfront Fusion adiciona os cabeçalhos de autorização para você.{"name":"something-urgent"}Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.
Observação:
Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.
Exemplo: a chamada de API a seguir retorna a lista de todos os usuários da sua conta Salesforce:
-
URL:
query -
Método: GET
-
Cadeia de Caracteres de Consulta:
-
Chave:
q -
Valor:
SELECT Id, Name, CreatedDate, LastModifiedDate FROM User LIMIT 10
Correspondências da pesquisa podem ser encontradas na Saída do módulo em Pacote > Corpo > registros.
No nosso exemplo, 6 usuários foram retornados:
Excluir um Registro
Este módulo de ação exclui um registro existente em um objeto.
Especifique a ID do registro.
O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Baixar Anexo/Documento
Este módulo de ação baixa um documento ou anexo de um registro.
Especifique a ID do registro e o tipo de download desejado.
O módulo retorna a ID do anexo ou documento e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acesse. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Ler um Registro
Este módulo de ação lê dados de um único objeto em Salesforce.
Especifique a ID do registro.
O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Atualizar um Registro
Este módulo de ação edita um registro em um objeto.
O módulo permite selecionar quais dos campos do objeto estão disponíveis no módulo. Isso reduz o número de campos que você deve percorrer ao configurar o módulo.
O módulo retorna a ID do registro e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acessa. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Carregar Anexo/Documento
Esse módulo de ação faz upload de um arquivo e o anexa a um registro especificado por você ou faz upload de um documento.
O módulo retorna a ID do anexo ou documento e quaisquer campos associados, juntamente com quaisquer campos e valores personalizados que a conexão acesse. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.
Carregar arquivo
Esse módulo de ação faz upload de um único arquivo para o Salesforce.
Pesquisas
Pesquisa
Este módulo de ação recupera todos os registros que atendem a um determinado critério.
Pesquisar com a consulta
Este módulo de pesquisa procura registros em um objeto em Salesforce que correspondam à consulta de pesquisa especificada. Você pode mapear essas informações em módulos subsequentes no cenário.
Ao configurar esse módulo, os campos a seguir são exibidos.