Você está aqui:
Passe dados de um OmniScript para um FlexCard integrado
Para preencher campos de dados e realizar ações em um FlexCard integrado a um OmniScript, você pode passar dados do JSON de dados de um OmniScript para o FlexCard. Integre um FlexCard a um OmniScript com o elemento Componente da Web Lightning personalizado.
Há três maneiras de passar dados do OmniScript para o FlexCard integrado:
Opções |
Descrição |
|---|---|
Passe um conjunto de registros |
Use a variável de contexto global de registros para mapear dados do OmniScript do LWC para um FlexCard integrado. |
Passe o recordId |
Passe a variável de contexto global recordId do OmniScript do LWC para o FlexCard. |
Passar um objeto pai |
Passe um objeto Pai contendo atributos pais para o FlexCard do OmniScript do LWC. O OmniScript é o pai do FlexCard integrado. A variável de contexto global Pai, como {Parent.Id}, deve ser usada no FlexCard em que o campo de mesclagem é suportado. |
Para atualizar o FlexCard sempre que os dados do OmniScript passados mudarem, adicione um Nome da propriedade de listen-os-data-change e uma Fonte da propriedade de verdade às propriedades do elemento LWC personalizado do OmniScript para o FlexCard.
- Mapear dados de um OmniScript do LWC para um FlexCard integrado
Depois de integrar um FlexCard em um OmniScript do LWC, mapeie registros do OmniScript para campos de dados no FlexCard. Por exemplo, preencha uma lista de FlexCards de uma matriz em um OmniScript. Nesse cenário, o FlexCard usa dados do OmniScript em vez de sua própria fonte de dados. - Passe o RecordId de um OmniScript para executar uma consulta em um FlexCard
Passe a variável de contexto recordId de um OmniScript do LWC para um FlexCard integrado para executar uma consulta no FlexCard. A consulta retorna os dados que preenchem os campos e ações de dados do FlexCard. - Passe um objeto pai de um OmniScript do LWC para executar uma consulta em um FlexCard
Passe um objeto pai do OmniScript do LWC para o FlexCard. O OmniScript do LWC é o pai do FlexCard integrado. A variável de contexto Pai deve ser usada no FlexCard em que campos de mesclagem são suportados, como {Parent.Id}.
Mapear dados de um OmniScript do LWC para um FlexCard integrado
Depois de integrar um FlexCard em um OmniScript do LWC, mapeie registros do OmniScript para campos de dados no FlexCard. Por exemplo, preencha uma lista de FlexCards de uma matriz em um OmniScript. Nesse cenário, o FlexCard usa dados do OmniScript em vez de sua própria fonte de dados.
Os campos de dados no OmniScript do LWC devem existir no FlexCard mesmo que os valores estejam vazios. Por exemplo, se o JSON de dados do OmniScript tiver campos ID, Nome, Email e Telefone, esses nomes de campo deverão existir mesmo que o valor de Email ou qualquer outro campo esteja vazio na fonte de dados do FlexCard integrado.
- Na sua organização, acesse a guia FlexCards e clique em uma versão de um FlexCard para abrir o Designer de FlexCard. Ou crie um novo FlexCard. Consulte Criar um FlexCard.
-
No painel Configuração, selecione e configure a fonte de dados com os campos de dados que você deseja que o OmniScript mapeie.
Por exemplo, se a sua fonte de dados for um Mapeador de dados do OmniStudio que recebe uma lista de Contas, confirme se os campos de Saída do Mapeador de dados selecionados incluem os campos para os quais o JSON de dados do OmniScript é mapeado. Se o JSON de dados do OmniScript tiver um campo Nome, a Saída do Mapeador de dados deverá ter o mesmo, e assim por diante.
- Clique em Salvar e buscar.
- No painel Criar, adicione elementos como Campos, Tabelas de dados etc. à tela. Consulte Adicionar elementos a um FlexCard.
- No painel Configuração, marque Suporte OmniScript.
- Clique em Ativar.
- Integre seu FlexCard a um OmniScript do LWC com o elemento personalizado do LWC no Designer de OmniScript do LWC.
- Na seção Propriedades do componente da Web Lightning personalizado do painel Propriedades, adicione dados pai como o Nome da propriedade e defina o valor de Origem da propriedade como true.
- Clique em + Adicionar nova propriedade.
-
Insira registros como o Nome da propriedade e, no campo Fonte da propriedade, insira o objeto no JSON de dados que lista registros que são mapeados para os registros no FlexCard. Insira o objeto como um campo de mesclagem usando a sintaxe de campo de mesclagem do OmniScript, como
%objectname%.Por exemplo, se sua lista de registros estiver armazenada em um objeto JSON chamado accounts, insira %accounts%.Para evitar problemas de carregamento do Flexcard, não use a sintaxe do campo de mesclagem para fazer referência a um LWC personalizado. Por exemplo, se o nome do LWC for customlwc1, não use %customlwc1%. - Clique em Ativar.
- Clique em Visualizar para visualizar o FlexCard dentro do Omniscript do LWC.
Passe o RecordId de um OmniScript para executar uma consulta em um FlexCard
Passe a variável de contexto recordId de um OmniScript do LWC para um FlexCard integrado para executar uma consulta no FlexCard. A consulta retorna os dados que preenchem os campos e ações de dados do FlexCard.
Por exemplo, se o FlexCard tiver um Mapeador de dados do OmniStudio que obtenha Casos de conta, os campos e ações serão atualizados com base no valor do recordId definido no JSON de dados do OmniScript do LWC. Se você usar o campo de mesclagem {recordId} em seu FlexCard, como em uma consulta SOQL ou um elemento Texto, os dados que dependem desse campo de mesclagem também serão atualizados com base no recordId proveniente do JSON de dados do OmniScript do LWC.
- Na sua organização, acesse a guia FlexCards e clique em uma versão de um FlexCard para abrir o Designer de FlexCard. Ou crie um novo FlexCard. Consulte Criar um FlexCard.
- Configure sua fonte de dados se ainda não tiver feito isso. Consulte Configurar uma fonte de dados em um FlexCard.
- Adicione elementos de dados, como Campos, Ações etc., do painel Criar à tela. Consulte Adicionar elementos a um FlexCard.
- No painel Configuração, marque Suporte OmniScript.
- Clique em Ativar.
- Integre seu FlexCard a um OmniScript do LWC com o elemento personalizado do LWC no Designer de OmniScript do LWC. Consulte FlexCards integrados em um OmniScript.
-
Na seção Propriedades do componente da Web Lightning personalizado do painel Propriedades, adicione record-id como o Nome da propriedade.
Nota
Como o Nome da propriedade é um atributo HTML, ele deve ser escrito em um caso kebab, com palavras separadas por um traço. Consulte Nomes de propriedade e atributo.
-
Defina a Property Source para um nó JSON que contenha um recordId. Use a sintaxe do campo de mesclagem do OmniScript, como
%nodename%, para inserir o nó como um campo de mesclagem.Por exemplo, se seu recordId for armazenado em um nó JSON chamado ContextId, insira %ContextId%.Para evitar problemas de carregamento do Flexcard, não use a sintaxe do campo de mesclagem para fazer referência a um LWC personalizado. Por exemplo, se o nome do LWC for customlwc1, não use %customlwc1%. - Clique em Ativar.
- Clique em Visualizar para visualizar o FlexCard dentro do OmniScript.
Passe um objeto pai de um OmniScript do LWC para executar uma consulta em um FlexCard
Passe um objeto pai do OmniScript do LWC para o FlexCard. O OmniScript do LWC é o pai do FlexCard integrado. A variável de contexto Pai deve ser usada no FlexCard em que campos de mesclagem são suportados, como {Parent.Id}.
O objeto pai no JSON de dados do OmniScript pode ter qualquer nome, desde que seja um objeto com campos que correspondam ao nome do atributo pai que você deseja que o OmniScript procure no FlexCard. Por exemplo, o nome do objeto JSON pode ser pai ou conta, como "parent" : {"Id" : "1234567"} ou "account" : {"Id" : "1234567"}.
- Na sua organização, acesse a guia FlexCards e clique em uma versão de um FlexCard para abrir o Designer de FlexCard. Ou crie um novo FlexCard. Consulte Criar um FlexCard.
- Configure sua fonte de dados se ainda não tiver feito a Etapa 1. Consulte Configurar uma fonte de dados em um FlexCard.
- Adicione elementos de dados, como Campos, Tabelas de dados etc., do painel Criar à Tela.
- Adicione um campo de mesclagem {Parent}, como {Parent.Id}, no FlexCard em que campos de mesclagem são suportados, como em uma consulta SOQL, um elemento de Texto, um Parâmetro de entrada e assim por diante.
- No painel Configuração, marque Suporte OmniScript.
- Clique em Ativar.
- Integre seu FlexCard a um OmniScript do LWC com o elemento personalizado do LWC no Designer de OmniScript do LWC. Consulte FlexCards integrados em um OmniScript.
-
Na seção Propriedades personalizadas do componente da Web Lightning do painel Propriedades, adicione atributo pai como o Nome da propriedade e defina a Fonte da propriedade como o objeto JSON pai que contém atributos pai. Use a sintaxe do campo de mesclagem do OmniScript, como
%objectname%, para inserir o nó como um campo de mesclagem.Por exemplo, se o objeto pai for armazenado em um objeto JSON chamado account, insira %account%.Para evitar problemas de carregamento do Flexcard, não use a sintaxe do campo de mesclagem para fazer referência a um LWC personalizado. Por exemplo, se o nome do LWC for customlwc1, não use %customlwc1%. - Clique em Ativar.
- Clique em Visualizar para visualizar o FlexCard dentro do OmniScript.
