Construtor de expressões

Use o construtor de expressões para criar expressões simples ou complexas de maneira simplificada.

Ao criar uma automação, no painel de propriedades da ação, para algumas ações que permitem o acesso a variáveis, você pode inserir um valor ou clicar em Inserir um valor no campo de propriedade para criar o tipo de expressão que deseja criar.

Benefícios

  • O assistente do construtor de expressões fácil de usar ajuda você a criar expressões complexas de forma mais rápida e precisa, economizando tempo valioso.
  • O processo de criar expressões fica mais intuitivo e autoexplicativo. Você pode definir ou editar com facilidade o valor de uma variável com a lista de referência integrada de métodos correspondentes para escolher.
  • Você pode visualizar a expressão e, se a expressão que você construiu for inválida, verá um ícone de erro exibido na visualização. Isso ajuda você a validar e verificar a sintaxe da sua expressão para garantir que ela será executada sem erros.

Recursos

O construtor de expressões oferece os seguintes recursos:
  • Oferece suporte mais avançado às propriedades (Por nome, índice ou método): Quando você usa uma variável como uma lista, dicionário ou gravação, pode acessar o valor pelo nome ou número de índice específico, ou usando métodos aplicáveis (por exemplo, método listGet para listas, método DictionaryToString para dicionários) para determinar o índice de forma dinâmica.
    • Nome: uma chave usada como um identificador único associado a um valor.
    • Índice: um índice se refere a dados que apontam para um local específico na tabela, gravação, lista, e assim por diante.
    • Método: métodos são funções que são chamadas em objetos. Eles desempenham um papel crucial na modificação ou acesso às propriedades do objeto.

    Exemplo: $Inventory_Stock_2025[4]{"\"Manufacturing date\""}$

    Propriedades compatíveis

  • Suporte para adicionar expressões com argumentos: Quando você seleciona um método com base no tipo de variável, pode inserir parâmetros/argumentos para ele. Um argumento é o valor real que é passado para o método quando ele é chamado.

    Exemplo, Variável = $Employee_Data_2025$

    Método: String maiúscula-Maiúscula (Converte a string no índice 0 para maiúscula).

    Nova expressão: $Employee_Data_2025[0].String:uppercase$

    Neste caso, String:uppercase é um método do objeto string que retorna a versão em maiúsculas da string.

    Como adicionar expressões com argumentos

  • Capacidade de criar expressões aninhadas: Você pode criar uma expressão para nome, índice ou método que contenha outras expressões dentro dela. Criar expressões aninhadas torna expressões complexas mais fáceis de ler, editar e depurar.

    Exemplo: $listOfDates[0].Datetime.get[0].Number:toString$

    Capacidade de criar expressões aninhadas

  • Como retomar a partir da expressão destacada: ao selecionar toda a expressão na caixa de texto da propriedade e clicar em (x), você abre o construtor de expressões. Aqui, toda a expressão é segregada por variável, método e argumento, dando a você o controle total para criar uma expressão ou atualizar os valores existentes conforme suas necessidades.

    Exemplo: Você seleciona a expressão $Dictionary_Var(name)$ e clica no (x), na janela do construtor de expressões. Ele mostra a expressão que você selecionou. Selecione Método e escolha String trim-Trim para cortar os espaços da string. A nova expressão que você criará será $Dictionary_Var{name}.String:trim$.

    Como retomar a partir da expressão destacada

Como criar expressões

A tabela a seguir explica as maneiras de criar expressões.
Opção Descrição
Inserir a expressão manualmente Quando você cria uma automação no Editor de bot, pode inserir manualmente uma expressão no campo de propriedades da ação, o que permite variáveis como entrada.

Quando você insere uma variável, o sistema sugere uma lista de variáveis definidas pelo sistema e pelo usuário. Esta lista é filtrada com base no texto que você digita, orientando você na criação de sua automação.

Após inserir ou selecionar uma variável, você pode escolher os métodos correspondentes ao digitar um ponto (.) após o nome da variável. Este recurso permite que você insira uma combinação de texto estático e variáveis, aumentando a flexibilidade na criação da sua automação.

Quando você insere uma expressão e, se a expressão não for válida, o erro é destacado com a mensagem de erro relevante, o que ajuda você a identificar e corrigir com rapidez quaisquer erros.

Como usar o construtor de expressões

Como alternativa ao método acima, como desenvolvedor, você pode criar uma expressão usando o construtor de expressões. Pressione F2 ou clique no ícone (x) para inserir um valor na caixa de texto da propriedade.

Quando você abre o construtor de expressões, ele apresenta uma variedade de componentes para escolher, incluindo variáveis (tanto definidas pelo sistema quanto pelo usuário) e valores globais. Essa flexibilidade permite que você crie expressões que atendam às suas necessidades específicas.

Ao selecionar uma variável, o sistema fornece uma lista de métodos e argumentos correspondentes. Esta orientação garante que você possa fazer escolhas informadas ao criar sua expressão, melhorando a qualidade do seu trabalho.

Depois de selecionar as variáveis e os métodos, você pode visualizar a expressão que criou e um ícone de erro será exibido se a expressão não for válida. Além disso, você pode selecionar variáveis e métodos de forma iterativa para criar uma expressão. Essa capacidade dá a você controle total sobre a criação da sua expressão, permitindo refiná-la até que atenda aos seus requisitos específicos.