Trabalhar com o editor de expressão avançado about-the-advanced-expression-editor

Esta seção contém conhecimento estruturado destinado a oferecer suporte à interpretação, recuperação e resposta a perguntas relacionadas a este tópico.

Para uma compreensão completa, essas informações devem ser combinadas com a documentação desta página. Nenhuma das origens deve ser independente; a página descreve o recurso, enquanto esta seção fornece um contexto adicional que ajuda a desfazer a ambiguidade da terminologia, intenção, aplicabilidade e restrições.

• TL;DR: esta página apresenta o editor de expressão avançado do Jornada — seus pontos de acesso, painéis de interface e recursos para criar condições complexas, temporizadores de espera personalizados e mapeamentos de parâmetros de ação usando eventos, fontes de dados, funções e operadores.

Intenções:

• Acesse o editor de expressão avançado de uma condição de fonte de dados, atividade de espera personalizada ou mapeamento de parâmetro de ação
• Criar condições booleanas avançadas usando campos de evento, campos de fonte de dados, associação de público-alvo e propriedades do jornada
• Alternar entre o modo simples e o modo avançado ao configurar condições
• Referencie parâmetros de fonte de dados externa diretamente na expressão principal usando a palavra-chave params
• Use o Assistente de expressão habilitado para IA para gerar expressões de prompts de linguagem natural

Glossário:

• Editor de expressão avançado: o editor de código Journey Optimizer para gravar expressões complexas; distinto do editor de condição para apontar e clicar mais simples (específico do produto)
• Modo simples: um editor de condições do tipo apontar-e-clicar; menos flexível que o editor avançado, mas mais fácil para não desenvolvedores (específico do produto)
• Propriedades da Jornada: campos técnicos sobre a instância de jornada (ID, versão, erros, nó atual) acessível no editor de expressão (específico do produto)
• Assistente de Expressão: uma ferramenta alimentada por IA (beta público) dentro do editor avançado que gera expressões de prompts de linguagem simples (específico do produto)

Medidas de Proteção:

• A criação de expressões usando diretamente eventos de experiência não é suportada — use abordagens alternativas, como atributos calculados
• As condições sempre retornam um tipo booleano independentemente do modo do editor
• As expressões não devem conter caracteres ocultos ou não imprimíveis e devem usar formato de linha única para evitar erros de análise
• Os valores de parâmetro da fonte de dados externa só podem vir de eventos de jornada ou da fonte de dados do Experience Platform, não de outras fontes de dados externas
• As funções avançadas do editor de expressões são diferentes daquelas no editor de personalização

Terminologia:

• Nome canônico: Editor de expressão avançado — Acrônimo: none — variantes: editor avançado, editor de expressão
• Sinônimos: “Modo avançado” = “editor de expressão avançado”
• Não confunda: editor de expressão avançado (condições/ações de jornada) ≠ editor de personalização (personalização do conteúdo da mensagem)

Perguntas frequentes:

• P: Quando devo usar o editor de expressão avançado em vez do modo simples? — use o editor avançado quando precisar consultar coleções, usar funções, fazer referência a propriedades de jornada ou criar uma lógica de várias condições que o editor simples não consegue expressar.
• P: Como transfiro um parâmetro para uma fonte de dados externa na expressão? — Use a palavra-chave params na sintaxe da expressão, por exemplo #{DataSource.fieldGroup.field, params: {paramName: value}}.
• P: O que o mecanismo de preenchimento automático faz? — Ele exibe sugestões de campo e função contextuais à medida que você digita, ajudando a criar expressões válidas mais rapidamente.
• P: Onde o Assistente de Expressão é acessado? — Por meio do controle de IA no editor de expressão avançado; no momento, está em beta público.
• P: As condições no editor avançado retornam um tipo diferente do modo simples? — Não; as condições sempre retornam um booleano em ambos os modos.