Como Trabalhar com Variáveis

As variáveis permitem que você armazene a lógica de negócios como valores nomeados em uma expressão.

O uso de variáveis pode aprimorar suas expressões de várias maneiras:

  • Elas simplificam o desenvolvimento de expressões, permitindo armazenar termos de expressão longos para que você possa reutilizá-los rapidamente.
  • Elas melhoram a legibilidade de uma expressão usando nomes de variáveis mais curtos para representar blocos maiores de lógica de expressão.
  • Elas podem melhorar o desempenho do cálculo, permitindo que os dados do nó sejam recuperados uma vez ao definir o valor da variável e, em seguida, acessando o valor da variável em cache em outras partes da expressão. Isso é particularmente eficaz quando você está avaliando um grande conjunto de nós várias vezes em uma expressão.

Dois tipos de variáveis estão disponíveis no Oracle Fusion Cloud Enterprise Data Management:

  • Variáveis globais são definidas no nível superior da expressão e podem ser usadas em qualquer lugar da expressão.
  • Variáveis locais são definidas em uma instrução IF específica e podem ser usadas somente nessa instrução específica. Elas podem ser úteis para a lógica condicional em sua expressão.

Você pode usar variáveis em qualquer contexto de expressão, como para derivar valores de propriedade, criar validações personalizadas e criar filtros de extração.

Definição de Variáveis

Sua localização no criador de expressão determina o tipo de variável que você define. Se você estiver no nível superior da expressão, a variável será definida como uma variável global e poderá ser usada em qualquer lugar da expressão. Se você estiver dentro de uma instrução IF, a variável será definida como uma variável local e só poderá ser usada nessa instrução IF. O procedimento para definir uma variável é o mesmo entre os dois tipos.

  1. Execute uma ação:
    • Na seção Instruções da paleta, arraste Definir Expressão até o editor.
    • Clique em Inserir Instrução Ícone Inserir Instrução e selecione Definir Variável.
  2. Na caixa de diálogo Definir Variável:
    • Insira um nome para a variável.
    • Selecione o tipo de dados variável. Os seguintes tipos de dados são suportados para variáveis:
      • Booliano
      • Data
      • Flutuante
      • Inteiro
      • Nó
      • String
      • Lista de Strings
      • Timestamp
    • Clique em OK.

    A variável é criada e exibida na seção Variáveis da paleta.

    Note:

    A seção Variáveis lista todas as variáveis globais e locais. Lembre-se de que você só pode arrastar variáveis locais até as instruções em que elas são definidas.

Uso de Variáveis em Expressões

Depois de definir uma variável, você poderá usá-la em uma instrução ou em um método de expressão.

  • Na seção Variáveis da paleta, arraste a variável até um termo de expressão em uma instrução (como IF ou RETURN) ou até um método.
  • Em uma instrução ou método, clique em Escolher Termo de Expressão escolher termo de expressão e use o menu Variáveis para selecionar a variável a ser inserida.

Você pode selecionar variáveis globais em qualquer lugar na expressão. Você só pode selecionar variáveis locais com o contexto da instrução IF em que elas foram definidas. Para os dois tipos de variáveis, você só poderá usar uma variável depois de defini-la no editor.

Atribuição de Valores a Variáveis

É possível atribuir um valor a uma variável em uma expressão. Por exemplo, você pode definir uma variável global varDesc para recuperar a propriedade Descrição de um nó. Em seguida, em uma instrução IF, você pode adicionar uma lógica que informa se o país do nó é Estados Unidos e se o valor atribuído da variável é a propriedade Description - US do nó.

Para atribuir um valor a uma variável:

  1. Insira a variável à qual você deseja atribuir um valor.
  2. Clique em Inserir Instrução Ícone Inserir Instrução e selecione Atribuir Variável.
  3. Selecione a variável à qual deseja atribuir um valor e, em seguida, use o menu de expressão ou o menu de pontos para alterar o valor da variável, conforme desejado. Você pode atribuir um valor literal, outra expressão ou outra variável ao valor da variável.

Como Renomear e Remover Variáveis

  • Para renomear uma variável, clique em Ações de Instrução Ícone Ações de Instrução, selecione Renomear e informe um novo nome.
  • Para remover uma variável, clique em Ações de Instrução Ícone Ações de Instrução e selecione Remover.