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.

NOTE
  • 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

Expanda para visualizar os requisitos de acesso para a funcionalidade neste artigo.

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:

  • Selecionar ou pacote do Prime Workfront: sua organização deve comprar o Adobe Workfront Fusion.
  • Pacote do Ultimate Workfront: o Workfront Fusion está incluído.

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 Adobe Workfront Fusion licenças, consulte Adobe Workfront Fusion licenças.

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:

URL base
{{connection.instanceUrl}}
Versão da API
v62.0
Tag da API
v1.15.14

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:

  1. Em qualquer módulo Salesforce, clique em Add ao lado da caixa Conexão.

  2. 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
    Connection name Insira um nome para a nova conexão.
    Environment Selecione se estão se conectando a um ambiente de produção ou não produção.
    Type Selecione se você está se conectando a uma conta de serviço ou a uma conta pessoal.
    Client ID Insira a ID do cliente do Salesforce.
    Client Secret Insira o segredo do cliente do Salesforce.
    Sandbox Ative essa opção se esse for um ambiente de sandbox.
    API Version Insira a versão da API do Salesforce que deseja usar. A versão padrão é 62.0.
  3. Clique em Continue para salvar a conexão e retornar ao módulo.

Salesforce módulos e seus campos

Acionadores

Watch a field

Este módulo de acionador inicia um cenário quando um campo é atualizado em Salesforce.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Record Type
Selecione o tipo de registro que contém o campo que o módulo deve observar. Você deve escolher um tipo de registro que tenha Field History ativado na configuração de Salesforce. Para obter mais informações, consulte Rastreamento do histórico do campo na documentação Salesforce.
Field
Selecione os campos que você deseja que o módulo observe para alterações.
Limit
Insira ou mapeie o número máximo de campos que você deseja que o módulo retorne durante cada ciclo de execução de cenário.

Watch for Records

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Type
Selecione o tipo de registro Salesforce que você deseja que o módulo assista.
Record Fields
Selecione os campos que você deseja que o módulo assista. Os campos disponíveis dependem do tipo de registro.
Maximal count of records
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.
Watch
Determine se deseja que o cenário observe somente os novos registros do tipo selecionado ou os novos registros do tipo selecionado e todas as outras alterações nos registros desse tipo.

Watch Outbound Messages

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 algumas configurações adicionais:

  1. Vá para a página de configuração Salesforce.

    Para acessar a página de configuração, localize e clique no botão rotulado "Setup" no canto superior direito da conta Salesforce. Na página de configuração Salesforce, localize a barra "Quick Find / Search" no lado esquerdo. Pesquisar por "Workflow Rules".

  2. Clique em Workflow Rules.

  3. Na página Workflow Rules exibida, clique em New Rule e selecione o tipo de objeto ao qual a regra será aplicada (como "Opportunity", se você estiver monitorando atualizações para registros de Oportunidade).

  4. Clique em Next.

  5. Defina um nome de regra, critérios de avaliação e critérios de regra, em seguida, clique em Save e Next.

  6. Clique em Done.

  7. Na regra de Fluxo de Trabalho recém-criada, clique em Edit.

  8. Na lista suspensa Add Workflow Action, selecione New Outbound Message.

  9. Especifique o nome, a descrição, a URL do Ponto de Extremidade e os campos que deseja incluir na nova mensagem de saída e clique em Save.

    O campo Endpoint URL contém a URL fornecida em Salesforce Outbound Message em Workfront Fusion.

  10. Configure um cenário que comece com o evento Outbound Message.

  11. Clique no ícone </> na parte inferior direita e copie a URL fornecida.

  12. Retorne à página Workflow Rules, localize a regra recém-criada e clique em Activate.

Ao configurar esse módulo, os campos a seguir são exibidos.

Webhook

Selecione o webhook que deseja usar para assistir mensagens de saída. Para adicionar um webhook, clique em Add e insira o nome e a conexão do webhook.

Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas

Record Type
Selecione o tipo de registro Salesforce que você deseja que o módulo veja para mensagens de saída.
Fields
Selecione os campos que você deseja que o módulo observe para mensagens de saída. Os campos disponíveis dependem do tipo de registro.

Ações

Create a Record

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Record Type
Selecione o tipo de registro Salesforce que você deseja que o módulo crie. Os campos ficam disponíveis com base no tipo de registro selecionado no campo Record Type. Esses campos são baseados na API Salesforce.
Select fields to map

Selecione os campos que você deseja que o módulo configure ao criar o novo registro. Os campos obrigatórios estão no topo da lista.

Os campos selecionados são abertos abaixo deste campo. Agora é possível inserir valores nesses campos.

Custom API Call

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:

  • Status Code (número): isso indica o sucesso ou a falha de sua solicitação HTTP. Esses são códigos padrão que você pode pesquisar na Internet.

  • Headers (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.

  • Body (objeto): dependendo da solicitação HTTP escolhida ao configurar o módulo, talvez você receba 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.

Selecione o método de solicitação HTTP necessário para configurar a chamada de API. Para obter mais informações, consulte Métodos de solicitação HTTP.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
URL

Insira um caminho relativo a <Instance URL>/services/data/v46.0/.

Para obter a lista de pontos de extremidade disponíveis, consulte o Guia do Desenvolvedor da API REST do Salesforce.

Method
Headers
Adicione os cabeçalhos da solicitação no formulário de um objeto JSON padrão. Por exemplo, {"Content-type":"application/json"}. O Workfront Fusion adiciona os cabeçalhos de autorização para você.
Query String
Adicione a consulta da chamada à API na forma de um objeto JSON padrão. Por exemplo: {"name":"something-urgent"}
Body

Adicione o conteúdo do corpo para a chamada à API na forma de um objeto JSON padrão.

Nota:

Ao usar instruções condicionais como if em seu JSON, coloque as aspas fora da instrução condicional.

Delete a Record

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Record Type
Selecione o tipo de registro Salesforce que você deseja que o módulo exclua.
ID

Insira ou mapeie a ID Salesforce exclusiva do registro que você deseja que o módulo exclua.

Para obter a ID, abra o objeto Salesforce no navegador e copie o texto no final da URL após a última barra (/). Por exemplo: https://eu5.salesforce.com/<object ID>

Download Attachment/Document

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Type of Download

Especifique o tipo de arquivo que deseja baixar da Salesforce.

  • Attachment
  • Document
  • ContentDocument (Este é um documento que foi carregado para uma biblioteca em Saleforce CRM Content ou Salesforce Files.)

ID /

Attachment ID /

ContentDocument ID

Insira ou mapeie a ID Salesforce exclusiva do registro que você deseja que o módulo baixe.

Para obter a ID, abra o objeto Salesforce no navegador e copie o texto no final da URL após a última barra (/). Por exemplo: https://eu5.salesforce.com/<object ID>

Read a Record

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Record Type
Selecione o tipo de registro Salesforce que você deseja que o módulo execute [action].read.
Record Fields
Selecione os campos que você deseja que o módulo leia. Você deve selecionar pelo menos um campo.
ID

Insira ou mapeie a ID Salesforce exclusiva do registro que você deseja que o módulo leia.

Para obter a ID, abra o objeto Salesforce no navegador e copie o texto no final da URL após a última barra (/). Por exemplo: https://eu5.salesforce.com/<object ID>

INFO
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 Bundle> Body >records.
No nosso exemplo, 6 usuários foram retornados:
Correspondências para a pesquisa

Update a Record

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
ID
Insira ou mapeie a ID do registro que você deseja atualizar.
Record Type
Selecione o tipo de registro Salesforce que você deseja que o módulo atualize. Os campos ficam disponíveis com base no tipo de registro selecionado no campo Tipo de registro. Esses campos são baseados na API Salesforce.
Select fields to map

Selecione os campos que você deseja que o módulo configure ao criar o novo registro. Os campos obrigatórios estão no topo da lista.

Os campos selecionados são abertos abaixo deste campo. Agora é possível inserir valores nesses campos.

Upload Attachment/Document

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Type of Upload
Selecione se você deseja que o módulo carregue um anexo ou um documento.
ID
Insira ou mapeie a ID do objeto para o qual você deseja fazer upload de um anexo.
Folder
Selecione a pasta que contém o arquivo a ser carregado pelo módulo.
Source File
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.

Carregar arquivo

Esse módulo de ação faz upload de um único arquivo para o Salesforce.

Pesquisas

Search with Query

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.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o​ Adobe Workfront Fusion - Instruções básicas
Source file
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.
Document linking
Selecione se deseja aplicar um link de documento de conteúdo.
linkedEntityId
Se estiver usando a vinculação de documentos, insira ou mapeie a ID do objeto vinculado.
ShareType

Se estiver usando a vinculação de documentos, selecione permissões para o arquivo.

  • Permissão do visualizador

    O usuário pode visualizar o arquivo.

  • Permissão do colaborador

    O usuário pode visualizar e editar o arquivo.

  • Permissões inferidas

    As permissões se baseiam nas permissões do usuário para o registro relacionado, como uma biblioteca.

Visibility

Se estiver usando a vinculação de documentos, insira ou mapeie a visibilidade do documento.

  • AllUsers

    Disponível para todos os usuários com permissões

  • UsuáriosInternos

    Disponível para usuários internos com permissões.

  • UsuáriosCompartilhados

    Disponível para usuários que podem ver o feed no qual o arquivo é postado.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o Adobe Workfront Fusion - Instruções básicas.
Search Type

Selecione o tipo de pesquisa que deseja que o módulo execute:

  • Simple

  • Using SOSL (Salesforce Object Search Language)

  • Using SOQL (Salesforce Object Query Language)

Type
Se você selecionou o tipo de pesquisa Simples, escolha o tipo de registro Salesforce que deseja que o módulo procure.
Query / SOSL Query / SOQL Query

Informe a consulta pela qual deseja pesquisar.

Para obter mais informações sobre SOSL, consulte Salesforce Object Search Language (SOSL) na documentação de Salesforce.

Para obter mais informações sobre SOQL, consulte Salesforce Object Query Language (SOQL) na documentação de Salesforce.

Observação: observe que o valor do parâmetro RETURNING influencia a saída do módulo. Se você usar LIMIT, Fusion ignorará as configurações no campo Maximal count of records. Se você não definir um limite, o Fusion inserirá o valor LIMIT = Maximal count of records.

Maximal count of records
Insira ou mapeie o número máximo de registros que deseja que o módulo retorne durante cada ciclo de execução de cenário.

Este módulo de ação recupera todos os registros que atendem a um determinado critério.

Connection
Para obter instruções sobre como conectar sua conta do Salesforce ao Workfront Fusion, consulte Criar uma conexão com o​ Adobe Workfront Fusion - Instruções básicas
Type
Selecione o tipo de objeto que deseja pesquisar.
Search criteria
Selecione o campo pelo qual deseja pesquisar, o operador que deseja usar na consulta e o valor que está procurando no campo. Você pode conectar consultas usando AND ou OR.
Outputs
Selecione os campos que deseja incluir na saída do módulo.
Result set
Selecione se você deseja que o módulo retorne Todos os registros correspondentes ou somente o Primeiro registro correspondente.
Maximal
Insira ou mapeie o número máximo de registros que você deseja que o módulo recupere durante cada ciclo de execução de cenário.
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3