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:

Se você precisar de instruções sobre como criar um cenário, consulte Criar um cenário Adobe Workfront Fusion.

Para obter informações sobre módulos, consulte Módulos em Adobe Workfront Fusion.

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

Você deve ter o seguinte acesso para usar a funcionalidade neste artigo:

Adobe Workfront plano*
Pro ou superior
Adobe Workfront licença*
Plano, Trabalho
Adobe Workfront Fusion licença**

Requisito de licença atual: nenhum requisito de licença Workfront Fusion.

Ou

Requisito de licença herdada: Workfront Fusion para Automação e Integração do Trabalho

Produto

Requisito atual do produto: se você tiver o Plano Adobe Workfront da Select ou da Prime, sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo. Workfront Fusion está incluído no plano Workfront do Ultimate.

Ou

Requisito de produto herdado: sua organização deve comprar o Adobe Workfront Fusion e o Adobe Workfront para usar a funcionalidade descrita neste artigo.

Para saber que plano, tipo de licença ou acesso você tem, contate o administrador do Workfront.

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.

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.

Salesforce módulos e seus campos

Triggers

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.

Conexão
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.
Tipo
Selecione o tipo de registro Salesforce que você deseja que o módulo assista.
Campos de Registro
Selecione os campos que você deseja que o módulo assista. Os campos disponíveis dependem do tipo de registro.
Contagem máxima de registros
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.
Observar
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.

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 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 chamado "Configuração" no canto superior direito da conta Salesforce. Na página de configuração Salesforce, localize a barra "Localização Rápida/Pesquisa" no lado esquerdo. Procure por "Regras de Fluxo de Trabalho."

  2. Clique em Regras de fluxo de trabalho.

  3. Na página Regras de Fluxo de Trabalho exibida, clique em Nova Regra e selecione o tipo de objeto ao qual a regra será aplicada (como "Oportunidade" se você estiver monitorando atualizações para registros de Oportunidade).

  4. Clique em Avançar.

  5. Defina um nome de regra, critérios de avaliação e critérios de regra, em seguida, clique em Salvar e Avançar.

  6. Clique em Concluído.

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

  8. Na lista suspensa Adicionar Ação de Fluxo de Trabalho, selecione Nova Mensagem de Saída.

  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 Salvar.

    O campo URL do Ponto de Extremidade contém a URL fornecida na Salesforce Mensagem de Saída em Workfront Fusion.

  10. Configure um cenário que comece com o evento Mensagem de Saída.

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

  12. Retorne à página Regras de Fluxo de Trabalho, localize a regra recém-criada e clique em Ativar.

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 Adicionar 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

Tipo de Registro
Selecione o tipo de registro Salesforce que você deseja que o módulo veja para mensagens de saída.
Campos
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.

Assistir a um campo

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

Conexão
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.
Tipo de Registro
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 o Field History ativado na configuração Salesforce. Para obter mais informações, consulte Rastreamento do histórico do campo na documentação Salesforce.
Campo
Selecione os campos que você deseja que o módulo observe para alterações.
Limite
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.

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.

Conexão
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.
Tipo de Registro
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.
Selecionar campos a serem mapeados

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.

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.

Conexão
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.
Tipo de Registro
Selecione o tipo de registro Salesforce que você deseja que o módulo execute [action].read.
Campos de Registro
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>

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.

Conexão
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.
Tipo de Registro
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>

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.

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 em Adobe Workfront Fusion.

Conexão
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.

Método
Cabeçalhos
Adicione os cabeçalhos da solicitação na forma de um objeto JSON padrão. Por exemplo, {"Content-type":"application/json"}. O Workfront Fusion adiciona os cabeçalhos de autorização para você.
Cadeia de Consulta
Adicione a consulta da chamada à API na forma de um objeto JSON padrão. Por exemplo: {"name":"something-urgent"}
Corpo

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.

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 Pacote > Corpo > registros.
No nosso exemplo, 6 usuários foram retornados:

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.

Conexão
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.
Tipo de Carregamento
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.
Pasta
Selecione a pasta que contém o arquivo a ser carregado pelo módulo.
Arquivo Source
Selecione um arquivo de origem de um módulo anterior ou mapeie o nome e os dados do arquivo de origem.

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.

Conexão
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.
Tipo de Download

Especifique o tipo de arquivo que deseja baixar da Salesforce.

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

ID /

ID de Anexo /

ID do Documento de Conteúdo

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>

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.

Conexão
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.
Tipo de Registro
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.
Selecionar campos a serem mapeados

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.

Pesquisas

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.

Conexão
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.
Tipo de Pesquisa

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

  • Simples

  • Usando SOSL (Salesforce Object Search Language)

  • Usando SOQL (Salesforce Object Query Language)

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

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 Contagem máxima de registros. Se você não definir um limite, o Fusion inserirá o valor LIMIT = Contagem máxima de registros.

Contagem máxima de registros
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.

Pesquisa

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

Conexão
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
Tipo
Selecione o tipo de objeto que deseja pesquisar.
Pesquisar critérios
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.
Saídas
Selecione os campos que deseja incluir na saída do módulo.
Conjunto de resultados
Selecione se você deseja que o módulo retorne Todos os registros correspondentes ou somente o Primeiro registro correspondente.
Máximo
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
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43