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 comothis.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 yJOURNAL_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 oUSD ). |
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 elTimeper
tp no se encuentra dentro delTimeper
|