Descripción general del creador de expresiones

El creador de expresiones está formado por dos áreas:

  • Paleta permite seleccionar campos para insertarlos en la expresión.
  • Editor permite componer la expresión.

creador de expresiones con la paleta a la izquierda y el editor a la derecha

Acceso al creador de expresiones

Puede acceder al creador de expresiones de dos modos:

  • Modo de solo lectura: le permite ver la lógica de expresión sin realizar ningún cambio. En el modo de solo lectura, puede copiar o descargar la expresión, capturarla como texto o probarla, pero no puede editarla.
  • Modo de edición: le permite crear y editar la expresión. En el modo de edición, puede realizar todas las funciones enumeradas a continuación en la sección Barra de herramientas del creador de expresiones.

Puede acceder al creador de expresiones en cualquiera de estos modos haciendo clic en el botón Definir expresión botón de definir expresión en un contexto en el que se aplica la lógica empresarial (por ejemplo, en una propiedad derivada). El modo en el que se abra el creador de expresiones depende del modo en el que estaba en el inspector desde el que ha accedido al creador de expresiones. Si estaba en el modo de edición en el inspector, el creador de expresiones se abre en el modo de edición. Si no estaba en el modo de edición en el inspector, el creador de expresiones se abre en el modo de solo lectura.

Barra de herramientas del creador de expresiones

La barra de herramientas del creador de expresiones le permite realizar funciones como copiar y pegar términos de expresión, cargar expresiones desde un archivo y probar sus expresiones. Están disponibles las siguientes funciones:

Terminología

El conocimiento de los siguientes conceptos es de gran utilidad cuando se utiliza el creador de expresiones:

  • Una expresión consta de una o más líneas de lógica denominadas sentencias.
  • Las sentencias son instrucciones discretas que controlan la lógica de una expresión. Hay tres tipos de sentencias:
    • Las sentencias return devuelven un valor.
    • Las sentencias If especifican una lista de sentencias que se deben realizar si la condición es true. Puede agregar sentencias Else y Else If a las sentencias If para ampliar la condición.
    • Los comentarios le permiten anotar porciones de la expresión (por ejemplo, para identificar dónde se ha realizado una modificación). Estos son solo informativos y no se evalúan cuando se ejecuta la expresión.

  • Los términos de la expresión están formados por objetos y operadores que se evalúan en un valor. En este ejemplo, una expresión deriva el valor de una propiedad de alias mediante la concatenación del nombre del nodo seguido de un guion y la descripción del nodo a continuación:


    devolución de concatenación de nombre de nodo con guion y descripción principal de propiedades de nodo

    Esta expresión tiene tres términos de expresión (además de un marcador de posición opcional para agregar una cuarta), cada uno de ellos indicados por el icono término de expresión:

    • Node.name.concat(
    • - (guion)
    • Node.properties.Core.Description

    Los términos de expresión se indican con fondo de color amarillo en el creador de expresiones, y cada término de expresión se puede mover o suprimir en la sentencia. También puede copiar y pegar términos de expresión dentro de una expresión. Consulte Copiado y pegado en expresiones.

  • Los objetos son elementos de la expresión que representan valores. Cada objeto tiene un tipo de dato que determina qué objetos, métodos y atributos adicionales están disponibles para ese objeto. Por ejemplo, si se selecciona el objeto sourceNode en una expresión, el creador de expresiones mostrará solo los campos que sean aplicables al tipo de datos de nodo, como dimension o name. Consulte Tipos de datos para términos de expresiones.

    Después de seleccionar un objeto en una expresión, puede delimitar aún más la expresión mediante la selección de atributos y métodos para ese objeto.

    • Los atributos describen un aspecto de un objeto. Por ejemplo, el objeto dimension tienen un atributo denominado name.
    • Los métodos realizan acciones en un objeto. Por ejemplo, el método concat concatena cadenas, y el método length devuelve la longitud de una cadena. Algunos métodos tienen argumentos, que son parámetros de entrada para el método. Una etiqueta describe la entrada necesaria (por ejemplo, Valor de cadena).
  • Los operadores realizan comparaciones lógicas en una expresión. El creador de expresiones admite los operadores AND y OR.
  • Los literales son valores constantes que se introducen manualmente en una expresión. Por ejemplo, en las sentencias If Account.Type = E, return Expense, tanto "E" como "Expense" son literales.

Veamos un ejemplo de una expresión que le ayudará a familiarizarse con la terminología:


expresión que indica que si FCGL_Account Type es E, se devuelve Expense; de lo contario, se devuelve Non-Expense

Se trata de una expresión sobre un conversor de tipo de nodo que realiza una asignación entre una dimensión de cuenta de Corporate Planning y una dimensión de cuenta de General Ledger de Financials Cloud. La expresión se lee como se indica a continuación:

Para la propiedad PLN.Variance Reporting, si la propiedad de nodo de origen FCGL.Account Type es igual a "E", se devuelve "Expense". De lo contrario, se devuelve "Non-Expense".

Esta expresión de la captura de pantalla contiene los siguientes elementos:

  1. Tres sentencias:
    • Si FCGL.Account Type es igual a "E"
    • Se devuelve "Expense"
    • Se devuelve "Non-Expense"

    Nota:

    Al crear la expresión, no es necesario agregar una sentencia Else If. Cuando se ejecuta la expresión, si la sentencia IF no es true, la lógica se mueve hacia la siguiente sentencia. Consulte Creación de expresiones.
  2. Cuatro términos de expresión:
    • FCGL.Account Type es igual a
    • "E"
    • "Expense"
    • "Non-Expense"
  3. Un objeto: sourceNode.
  4. Dos atributos: FCGL.Account Type y las propiedades.
  5. Un método: es igual a.
  6. Tres literales: E, Expense, Non-Expense.