Saltar al contenido principal
Adaptive Planning
Última actualización: 2023-06-23
Referencia: notación de puntos para propiedades

Referencia: notación de puntos para propiedades

De manera similar a las referencias a objetos en los lenguajes de programación, puede usar la
notación de puntos
en las fórmulas. La notación de puntos es especialmente útil en fórmulas con
IFF
porque permite que la fórmula varíe en función de la ubicación actual. A modo de ejemplo, la siguiente fórmula calcula una métrica de manera diferente en una versión de cifras reales que en una versión de plan:
Ejemplo: la fórmula calcula una métrica de una manera en las cifras reales y de otra en las versiones de plan:
IFF(this.Version.IsActuals, ACCT.ActualsValue, ACCT.PlanValue)
Ejemplo: en el caso de los navegadores que utilizan comas para los decimales:
IFF(this.Version.IsActuals; ACCT.ActualsValue; ACCT.PlanValue)
Las fórmulas que utilizan propiedades de notación de puntos para hacer referencia a valores de dimensión, valores de atributo y niveles deben hacerlo mediante un código para evitar la ambigüedad cuando coinciden los nombres. Si cambia el código para un valor de dimensión, un valor de atributo o un nivel, actualice sus fórmulas para que coincidan con ese código.

Operandos

La sintaxis de expresión de operando utiliza la expresión estandarizada
this
para indicar la ubicación actual de una celda.
Propiedad
Descripción
this.Version
Devuelve un objeto de versión, que se puede combinar con un punto adicional (
.
) propiedades como
this.Version.Name
. Consulte la sección Tipos de objeto a continuación.
this.Level
Devuelve un objeto de nivel, que se puede combinar con un punto adicional (
.
) propiedades.
this.Account
Devuelve un objeto de cuenta, cuando se puede combinar con un punto adicional (
.
) propiedades.
this.
dimension_name
Devuelve el valor de dimensión de la celda actual en la dimensión especificada. Si la celda actual no tiene ningún valor para la dimensión especificada, devuelve un objeto vacío (en blanco). Solo se puede acceder a esta propiedad si la dimensión tiene un nombre que es un identificador legal (no comienza con un dígito y consta solo de letras, números y guiones bajos). Las dimensiones con nombres que no son identificadores (como aquellas con más de una palabra en su nombre) no se pueden recuperar en una fórmula.
this.
attribute_name
Devuelve el valor de atributo de la celda actual en el atributo especificado. Si la celda actual no tiene ningún valor para el atributo especificado, devuelve un objeto vacío. Solo se puede acceder a esta propiedad si el atributo tiene un nombre que sea un identificador legal (no comienza con un dígito y consta solo de letras, números y guiones bajos). Los atributos con nombres que no son identificadores (como aquellos con más de una palabra en su nombre) no se pueden recuperar en una fórmula.
this.<stratum_code>
Devuelve el
Timeperiod
del tipo de estrato solicitado que contiene la coordenada temporal de la celda actual. Si los estratos solicitados están por debajo (más detallados que) del estado de la celda actual, esta función devuelve el
primer
Timeperiod
de ese estrato que se encuentra en el ámbito del estrato de la celda actual.

Tipos de objeto

Los tipos de datos representan objetos, lo que permite que la "notación de puntos" acceda a las propiedades de esos objetos. Las propiedades de objeto disponibles son:

Versión

Hace referencia a varias propiedades de la versión actual en un
IF
declaración
Ejemplo:
IF (this.Version.Name = "Budget 2018", x, y)
Ejemplo: en el caso de los navegadores que utilizan comas para los decimales:
IF (this.Version.Name = "Budget 2018"; x; y)
Propiedad
Descripción
Version.Name
Devuelve la cadena que representa el nombre de la versión. Si se superpone una celda de cifras reales a una versión de plan, la versión de cifras reales se considera la versión de la celda.
Version.ShortName
Devuelve la cadena que representa el nombre corto de la versión.
Version.Description
Devuelve la cadena que representa la descripción de la versión.
Version.Type
Devuelve una cadena que representa el tipo de versión, tal como se muestra en el
exportVersions
API Devuelve uno de los siguientes valores:
PLANNING, ACTUALS, VERSION_FOLDER, JOURNAL_ENTRY
.
Version.StartDate
Devuelve un valor de fecha que representa el primer día del periodo que marca el inicio de la versión.
Version.EndDate
Devuelve un valor de fecha que representa el último día del periodo que marca el final de la versión.
Version.PositionOf
Devuelve el orden relativo del periodo proporcionado dentro del marco temporal completo de la versión. La secuencia inicial comienza con 0 (y no 1) y el número de orden puede ser negativo si el periodo es anterior al inicio de la versión. Esta función también funciona con un periodo que se prolongue más allá del fin de la versión.
Version.IsActuals
Devuelve un valor booleano que indica si esta versión es una versión de cifras reales o no (esto incluye tipos
ACTUALS
,
SUBACTUALS
y
JOURNAL_ENTRY
).
Version.IsGroup
Devuelve un valor booleano que indica si esta versión es un grupo de versiones (y no una versión que contiene datos).
Version.IsParent
Devuelve un valor booleano que indica si esta versión tiene versiones secundarias.
Version.Parent
Devuelve la versión principal de esta versión.

Nivel

Hace referencia a varias propiedades del nivel actual en un
IF
declaración
Ejemplo:
IF (this.Level.Name = "Sales", x, y)
Ejemplo: en el caso de los navegadores que utilizan comas para los decimales:
IF (this.Level.Name = "Sales"; x; y)
Propiedad
Descripción
Level.Code
Devuelve la cadena que representa el código del nivel.
Level.Name
Devuelve la cadena que representa el nombre del nivel.
Level.ShortName
Devuelve la cadena que representa el nombre corto del nivel.
Level.InWorkflow
Devuelve un valor booleano que indica si el nivel está incluido en el flujo de trabajo. Para las instancias que tienen el flujo de trabajo desactivado, es falso en todos los niveles.
Level.IsElimination
Devuelve un valor booleano que indica si el nivel es un nivel de eliminación. Para las instancias que no tienen la función de eliminaciones, es falso en todos los niveles.
Level.IsTradingPartner
Devuelve un valor booleano que indica si el nivel es de socio comercial de eliminación. Para las instancias que no tienen la función de eliminaciones, es falso en todos los niveles.
Level.Currency
Devuelve la cadena que representa el código de moneda ISO del nivel (por ejemplo,
EUR
o
USD
).
Level.Parent
Devuelve el código de nivel que es el principal de este nivel o el objeto de nivel especial "nulo" si este nivel no tiene ningún principal (el nivel raíz).
Level.IsLeaf
Devuelve un valor booleano que indica si el nivel es un nivel de hoja o no (es decir, esta propiedad resulta verdadera si el nivel no tiene elementos secundarios).

Cuenta

Hace referencia a las distintas propiedades (
no al valor
) de la cuenta corriente en una
IF
declaración
Ejemplo:
IF (this.Account.IFRS_Category.Name = "Assets", 1, 0)
Ejemplo: en los navegadores que utilizan comas como decimales:
IF (this.Account.IFRS_Category.Name = "Assets"; 1; 0)
Propiedad
Descripción
Account.Code
Devuelve la cadena que representa el código de la cuenta.
Account.Name
Devuelve la cadena que representa el nombre de la cuenta.
Account.ShortName
Devuelve la cadena que representa el nombre corto de la cuenta.
Account.Description
Devuelve la cadena que representa la descripción de la cuenta.
Account.Parent
Devuelve una cuenta que es la principal de esta cuenta o el objeto de cuenta especial "nulo" si esta cuenta no tiene ninguna principal (una cuenta raíz).
Account.<
attribute_name
>
Devuelve un objeto de valor de dimensión asociado al atributo especificado. Solo se puede acceder a esta propiedad si el atributo tiene un nombre que sea un identificador legal (no comienza con un dígito y consta solo de letras, números y guiones bajos). Los atributos con nombres que no son identificadores (como aquellos con más de una palabra en su nombre) no se pueden recuperar en una fórmula.
Account.isCredit
Devuelve un valor booleano si la cuenta tiene unTipo de saldo deCRÉDITO o no. Tenga en cuenta que algunas cuentas (por ejemplo, las cuentas de métrica) no serán de Debe ni de Haber.
Account.isDebit
Devuelve un valor booleano si la cuenta tiene unTipo de saldo deDEBE o no. Tenga en cuenta que algunas cuentas (por ejemplo, las cuentas de métrica) no serán de Debe ni de Haber.

Dimensiones y atributos

Propiedad
Descripción
DimensionValue
.Code
Devuelve la cadena que representa el código del valor de dimensión en la dimensión especificada.
Ejemplo:
IF (this.Region.Code = "East01", 1, 0)
DimensionValue
.Name
Devuelve la cadena que representa el nombre del valor de dimensión en la dimensión especificada.
Ejemplo:
IF (this.Region.Name = "East", 1, 0)
DimensionValue
.ShortName
Devuelve la cadena que representa el nombre corto del valor de dimensión.
DimensionValue
.Description
Devuelve la cadena que representa la descripción del valor de dimensión.
DimensionValue
.Parent
Devuelve el valor de dimensión que es el principal de este valor o el objeto vacío especial si este valor no tiene ningún principal en la dimensión (por ejemplo, el "principal" es la raíz de la propia dimensión).
Ejemplo:
this.DimensionValue.Parent.Name
devolvería el nombre del elemento principal para este valor de dimensión.
DimensionValue
.IsLeaf
Devuelve un valor booleano que indica si el valor de dimensión en la dimensión especificada es un valor de hoja en esa dimensión.
DimensionValue
.<
attribute_code
>
Devuelve el código de valor del atributo especificado (que corresponde al valor de dimensión).
DimensionValue
.<
attribute_name
>
Devuelve el valor del atributo especificado (que corresponde al valor de dimensión).
AttributeValue
.Code
Devuelve la cadena que representa el código de valor de atributo.
AttributeValue
.Name
Devuelve la cadena que representa el nombre del valor de atributo.
AttributeValue
.ShortName
Devuelve la cadena que representa el nombre corto del valor de atributo.
AttributeValue
.Description
Devuelve la cadena que representa la descripción del valor del atributo.
AttributeValue
.Parent
Devuelve el código de valor de atributo que es el principal de este valor o el objeto vacío especial si este valor no tiene ningún principal en la dimensión (por ejemplo, el "principal" es la raíz de la propia dimensión).
AttributeValue
.IsLeaf
Devuelve un valor booleano para indicar si el valor de atributo en el atributo especificado es un valor de hoja en ese atributo.

Periodo

Un periodo representa un periodo concreto de cualquier estrato del calendario configurado. Los tipos de datos de periodo no se pueden comparar con ningún otro tipo de datos.
Ejemplos:
IF (this.Month.NumberOfDays > 30, 1, 0) IF (this.Year.PositionOf (this.Month) > 6, "Past sixth month", "Not") IF (this.Quarter.PositionOf (this.Week) = 1, "First week of qtr", "Not")
Propiedad
Descripción
Timeper
.Code
Devuelve el código del periodo. Esto coincidirá con la forma en que se hace referencia al periodo en los discriminantes de tiempo.
Timeper
.NumberOfDays
Devuelve el número total de días del periodo, incluido.
Ejemplo:
IF (this.Month.NumberOfDays > 30, 1, 0)
Timeper
.Parent
Devuelve el periodo que contiene el periodo actual y es un estrato más alto (menos detallado) en el continuo de estratos. Si no hay un estrato superior, devuelve el periodo actual.
Timeper
.StartDate
Devuelve una fecha que representa el primer día del periodo (igual que
Version.StartDate).
Timeper
.EndDate
Devuelve una fecha que representa el último día del periodo (igual que
Version.EndDate).
Timeper
.PositionOf(tp)
Devuelve un número entero que representa la posición del periodo (
tp
) dentro del periodo de origen (en relación con los demás miembros de su estrato). Devoluciones
0
si el periodo temporal especificado (
tp
) no es un estrato más pequeño que el
Timeper
especificado, o si
tp
no se encuentra dentro del
Timeper
especificado.