Documentação Workfront Adobe Workfront Fusion

Salesforce módulos

Last update: Wed Feb 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:

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:

Salesforce

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

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:

Em qualquer módulo Salesforce, clique em Add 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
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.

Clique em Continue para salvar a conexão e retornar ao módulo.

Acionadores

Watch a field
Watch for Records
Watch Outbound Messages

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:

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".
Clique em Workflow Rules.
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).
Clique em Next.
Defina um nome de regra, critérios de avaliação e critérios de regra, em seguida, clique em Save e Next.
Clique em Done.
Na regra de Fluxo de Trabalho recém-criada, clique em Edit.
Na lista suspensa Add Workflow Action, selecione New Outbound Message.
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.
Configure um cenário que comece com o evento Outbound Message.
Clique no ícone </> na parte inferior direita e copie a URL fornecida.
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
Custom API Call
Delete a Record
Download Attachment/Document
Read a Record
Upload Attachment/Document
Carregar arquivo

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.

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.

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.

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.

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:

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.

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.

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.

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.

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.

Search

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