Loading
Usar fórmulas em mapeadores de dados do OmniStudio

Você está aqui:

  1. Ajuda do Salesforce
  2. Documentação
  3. OmniStudio

Usar fórmulas em mapeadores de dados do OmniStudio

Para adicionar dados à saída de um Data Mapper, defina fórmulas. Vários tipos de Mapeadores de dados (extrair, transformar e carregar) oferecem suporte a fórmulas. Quando você define uma fórmula, mapeia sua saída para o JSON de saída (para extrações e transformações) ou campo de objeto do Salesforce (para carregamentos).

Para obter detalhes sobre os operadores e funções que podem ser usados em fórmulas, consulte Fórmulas e funções do OmniStudio.

Nota
Nota

Se um nome de variável contiver espaços ou caracteres não alfanuméricos, coloque o nome da variável entre aspas duplas e o preceda com var: nas fórmulas. Por exemplo, se o nome do nó JSON for Primary Guardian, especifique-o em fórmulas como var:"Primary Guardian".

Se o nome de um campo personalizado incluir caracteres especiais, às vezes você não poderá fazer referência ao campo em uma fórmula.

No tempo de execução padrão do OmniStudio, inserir a fórmula de consulta incorreta para Mapeadores de dados retorna nulo, mas não exibe logs de erro. Se você receber uma resposta nula de uma consulta, atualize a consulta.

  1. Na página Interface do Data Mapper, vá para a guia Fórmulas.
  2. Clique em Adicionar fórmula. Uma fórmula vazia é adicionada à lista.
  3. No campo Fórmula, especifique a lógica desejada. Por exemplo, para determinar o preço total dos itens adquiridos por um cliente, insira uma fórmula como:

    SUM(Products:Price)

    Você também pode usar a notação de relacionamento em fórmulas para fazer referência a campos em um objeto pai. Consulte Notação de relacionamento versus várias etapas de extração.

  4. No campo Caminho de resultado da fórmula, especifique um nó JSON no qual armazenar o resultado da fórmula.
  5. Mapeie o resultado para a saída final.
    • Para um Mapeador de dados de extração, na guia Saída, mapeie o resultado da fórmula para a estrutura de saída. Use um vírgula (:) para delimitar os níveis nos caminhos de entrada e saída em mapeamentos.
    • Para um Transformar mapeador de dados, na guia Transformações, mapeie o resultado da fórmula para a estrutura de saída. Use um vírgula (:) para delimitar os níveis nos caminhos de entrada e saída em mapeamentos.
    • Para um mapeador de dados de carregamento, para cada sObject que você deseja atualizar, na guia Campos, mapeie o resultado da fórmula para o campo que deseja atualizar.
  6. Carregar: Para cada sObject que você deseja atualizar, vá para sua guia Campos e mapeie o resultado da fórmula para o campo específico que você deseja atualizar.

Crie um exemplo de mapeador de dados do OmniStudio com uma fórmula

O exemplo a seguir aceita uma lista de preços e usa uma fórmula para calcular o preço total.

Para criar essa Transformação do mapeador de dados, execute estas etapas:

  1. Vá para a guia Designer do Mapeador de dados do OmniStudio e clique em Novo. O diálogo Criar é exibido.
  2. Especifique um nome para o Mapeador de dados e defina suas configurações da seguinte maneira:
    • Tipo de interface: Transformar
    • Tipo de entrada: JSON
    • Tipo de saída: JSON
  3. Clique em Salvar. A página Interface do mapeador de dados é exibida.
  4. Vá para a guia Fórmulas e clique em Adicionar fórmula.
  5. No campo Fórmula, insira SUM(Produtos:Preço).
  6. No campo Caminho de resultado da fórmula, insira TotalPrice.
  7. Na guia Transformações, expanda o painel JSON de entrada e cole esta estrutura JSON nela: 
    {
    "CustomerName": "Bob Smith",
    "Products": [
        {
            "Name": "iPhone",
            "Price": 600
        },
        {
            "Name": "iPhone Case",
            "Price": 30
        },
        {
            "Name": "Ear Buds",
            "Price": 200
        }
    ]
}
  8. Expanda o painel Saída JSON esperada e cole esta estrutura JSON nela: 
    {
    "CustomerName": "Bob Smith",
    "TotalPrice": 830,
    "Products": [
        {
            "Name": "iPhone",
            "Price": 600
        },
        {
            "Name": "iPhone Case",
            "Price": 30
        },
        {
            "Name": "Ear Buds",
            "Price": 200
        }
    ]
}
  9. Clique em Correspondência rápida. Na janela Correspondência rápida, clique em Correspondência automática e depois em Salvar.
  10. Na guia Visualização, clique em Executar.

    Se você tiver criado o exemplo corretamente, a estrutura JSON no painel Resposta corresponderá à Saída JSON esperada, exceto para a ordem dos nós de nível superior.

  11. No painel Entrada, altere um ou mais dos preços e clique em Executar novamente.

    Observe como o valor de TotalPrice muda.

 
Carregando
Salesforce Help | Article