Variáveis e Editor de expressão

Use o seletor de ajustes ao lado de um campo de entrada do painel Propriedades para alternar entre texto, variáveis e expressões.

Mode	Use quando
Variável	Você deseja fazer referência a uma variável ou valor de saída de elemento existente
Editor de expressão	Você precisa escrever uma lógica complexa (JavaScript)
Editor JSON	Sua entrada ou saída é uma carga do JSON estruturada
Seletor de data e hora	Você precisa definir um valor de data ou hora específico
Data Fabric	Você deseja fazer referência a uma propriedade de uma entidade do Data Fabric

Use o Construtor de texto para fornecer entradas de texto de forma livre

Variáveis

Use Variáveis para configurar propriedades do elemento e passar valores entre seus elementos, automações, agentes, tarefas de aplicativos e conexões. As saídas dos elementos estão automaticamente disponíveis como variáveis ao longo do processo.

Abra o painel de seleção de Variável para selecionar uma variável, argumento ou propriedade. Forneça e teste valores usando o botão Teste no canto superior direito do painel Validar expressão.

Os valores de entrada de teste verificam a precisão da expressão e garantem que ela produza a saída esperada com base nas entradas fornecidas.

Dica:

O seletor de variáveis inclui saídas de tarefas dentro de subprocessos recolhidos.

Você pode fazer referência a variáveis de subprocesso diretamente, independentemente de o subprocesso ser exibido em visualização recolhida ou expandida, facilitando o trabalho com designs de processos modulares.

Observação:

Quando você renomeia uma variável, seu ID subjacente é atualizado para corresponder ao novo nome. As expressões que faziam referência ao ID antigo não funcionarão mais após uma renomeação.

Use a caixa de diálogo Corrigir variáveis para identificar e atualizar referências quebradas em todo o processo.

Editor de expressão

Use o Editor de expressões para escrever expressões mais complexas para configurar as propriedades do elemento. Ele apresenta a conclusão de código inteligente para variáveis, argumentos, métodos, propriedades, objetos ou palavras-chave.

Ctrl + Space para ver a lista de opções disponíveis ao escrever expressões.

Use a barra de texto na parte inferior do Editor de expressão para descrever sua expressão e obter ajuda instantânea do Autopilot.

O Maestro valida expressões e mostra um aviso de sintaxe inválida ou referências de variáveis não definidas, tanto quando você salva a expressão quanto durante a execução. Se uma mensagem de aviso aparecer, abra o Editor de expressão e corrija a sintaxe ou atualize a referência da variável.

AVISO:

As expressões em C# estao obsoletas. Migre para expressões em JavaScript.

Para obter orientação sobre migração, consulte Transição de expressões de C# para expressões JavaScript.

Editor JSON

Comece adicionando um objeto JSON bruto na visualização Variáveis para definir sua carga de entrada. Depois de adicionar, mude para o editor JSON para explorar e interagir com os dados em um formato estruturado.

Esta visualização organiza automaticamente objetos e arrays aninhados, permitindo que você inspecione, expanda e faça referência a valores com facilidade. Use-a para validar o formato de dados, mapear campos para expressões ou fornecer entradas para componentes subsequentes com clareza e precisão.

Seletor de data e hora

Use o seletor de data e hora para capturar detalhes de agendamento específicos dentro do seu fluxo de automação. Esse componente permite definir valores de data e hora em um formato padronizado.

Use-a para marcar a data/hora de envios, definir prazos ou agendar atividades downstream. Insira valores manualmente ou use os controles de calendário e relógio para uma seleção rápida, garantindo a consistência e reduzindo erros de formatação.

Editor do Data Fabric

Para configurar a integração de dados, abra o editor do Data Fabric, escolha uma Entidade e especifique uma Correspondência de registros usando um identificador exclusivo e, em seguida, selecione um Campo para recuperar ou atualizar. Essas entradas determinam o escopo da interação de dados dentro do processo.

Consulta de entidades do Data Fabric por valor de campo

Use a sintaxe de prefixo qes: para procurar uma entidade Data Fabric por valor de campo em vez de por ID de registro interno:

datafabric.EntityName["qes:FieldName=Value"].FieldToRead

Por exemplo: datafabric.LoanApplicationCase["qes:CaseId=HL-999"].LoanAmount

Use essa sintaxe quando souber o valor de um campo significativo para os negócios, mas não tiver o ID de registro interno. A sintaxe qes: é oferece suporte apenas ao operador de igualdade.

Gravação de saídas de atividades de volta no Data Fabric

As saídas de atividade podem ter como destino uma entidade DataFabric diretamente, usando a sintaxe de atributo target:

target="=datafabric.EntityName[...]"

Quando uma atividade é concluída, o Maestro grava automaticamente o valor de saída de volta na entidade, sem quaisquer etapas de configuração adicionais.