En esta sección se encuentra el listado detallado de las instrucciones necesarias para crear DPS (Data Point Structures). Si no puede ver el grupo de opciones Datapoint en el plug-in de Excel XBRL, siga los siguientes pasos:
- Diríjase a la configuración de opciones adicionales del plug-in
- Habilite las instrucciones DataPoint.
Puede encontrar información sobre el resto de instrucciones en la guia de ayuda del generador de taxonomías.
DPCONCEPTS
La instrucción DPCONCEPTS se utiliza para especificar todas las definiciones de conceptos desde una Tabla Data Point Concepts Table hasta el Esquema de la Taxonomía.
La instrucción DPCONCEPTS debe enmarcarse dentro de un bloque BOT – EOT. Solamente serán creados los elementos cuyo prefijo en la segunda columna coincidan con el prefijo de la taxonomía declarada en las instrucciones BOT – EOT. Cualquier otro concepto será ignorado.
La instrucción DPCONCEPTS tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
3 | Sí | Coordenada a la Tabla de Data Point Concepts. El formato de la tabla se define más abajo. | Coordenada |
4 | Sí | Valor Booleano que sirve de filtro sobre la séptima columna de la Tabla Data Point Concepts (la séptima columna es llamada Common). Cuando este valor es verdadero solo las filas con contenido no vacío en la columna Common son procesadas. Cuando este valor es falso, solamente las filas con contenido vacío en la columna Common son procesadas. | Booleano |
Ejemplo:
Build | param1 | param2 | param3 | param4 |
DPCONCEPTS | AI!C2 | true |
Puede insertar la instrucción DPCONCEPTS utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Datapoint y pulse sobre el botón DP-Concepts
|
Formato de la Tabla Data Point Structure Concepts
Item-type | Prefix | Name | ID | Period | Data-type | Common |
Explicit dimension | dim | SZ | dim_SZ | duration | String |
- Item-type: Es el token que define el grupo de sustitución de un elemento. El QName del grupo de sustitución se debe encontrar definido en una tabla «Name to Qualified Name«. Para más información sobre esta tabla consulte la instrucción NAME2QNAME. Dos valores especiales son reconocidos por la herramienta con la finalidad de permitir el uso de la instrucción DPDIM y aplicar condiciones adicionales de prueba a los elementos declarados:
- “Explicit dimension”: Identifica la declaración de una Dimensión Explícita de acuerdo a la especificación de XBRL Dimensions 1.0.
- “Typed dimension”: Identifica la declaración de una Dimensión Tipada de acuerdo a la especificación de XBRL Dimensions 1.0.
- Prefix: Es el prefijo identifica a que taxonomía pertenece el concepto. Solamente se crearan conceptos cuyo prefijo corresponda con el de una taxonomía definida en un bloque BOT– EOT.
- Name: Es el nombre local del concepto. Si el nombre de concepto ya existe, la definición será ignorada.
- ID: Es un identificador de menos de 255 caracteres. Normalmente este id es resultado de concatenar el prefijo con un subrayado y el nombre local. Los ID son solo importantes para permitir trabajar a otras especificaciones. Los ID deben ser únicos en el fichero donde son usados.
- Period: Tiene valor “instant” o “duration” e indica la naturaleza del concepto respecto al tiempo. Consulte la especificación XBRL 2.1 para obtener información acerca de Periodo.
- Data-Type: Es el token que indica el tipo de dato. El auténtico tipo de dato se encuentra en la tabla Name to Qualified Name.
- Common: Puede ser vacío o no vacío. Esta columna sirve como filtro para permitir a las instrucciones DPCONCEPTS y DPDIM procesar la misma tabla.
DPDIM
La instrucción DPDIM es parte de Data Point Structure. Esta instrucción se utiliza para definir dimensiones en un esquema de la taxonomía. Puede ser usada tanto en Dimensiones Explicitas como en Dimensiones Tipadas.
La instrucción DPDIM tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
3 | Sí | Coordenada a la Tabla de Data Point Concepts. | Coordenada |
4 | Sí | Valor Booleano que sirve de filtro sobre la séptima columna de la Tabla Data Point Concepts (la séptima columna es llamada Common). Cuando este valor es verdadero solo las filas con contenido no vacío en la columna Common son procesadas. Cuando este valor es falso, solamente las filas con contenido vacío en la columna Common son procesadas. | Booleano |
Ejemplo:
Build | param1 | param2 | param3 | param4 |
DPDIM | AI!C2 | true |
El formato de la tabla Data Point Concepts es el mismo utilizado por la instrucción DPCONCEPTS. Consulte la instrucción DPCONCEPTS para más información.
La herramienta comprobará otras condiciones adicionales con el fin de asegurar que el concepto definido es una dimensión que se ajusta a la especificación XBRL.
Puede insertar la instrucción DPDIM utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Datapoint y pulse sobre el botón DP-Dimensions
|
DPDOM
La instrucción DPDOM se utiliza para definir dominios de dimensión para una dimensión o dominio de acuerdo a Data Point Structure. La instrucción DPDOM no puede ser una instrucción raíz (debe estar siempre encapsulada en una taxonomía o en un linkbase).
Si la instrucción DPDOM está encapsulada dentro de un bloque BOL – EOL el nuevo enlace extendido de definición será añadido a ese contenedor de linkbase.
Si la instrucción DPDOM está encapsulada dentro de un bloque BOT – EOT entonces se creara un nuevo linkbase embebido y el enlace extendido de definición será añadido a ese linkbase.
La instrucción DPDOM tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | Sí | La URI del rol o una coordenada apuntando la URI del rol definida para el enlace extendido de Definiciones. Es decir, donde los recursos de linkbases y relaciones serán creados. | URI, URL o Coordenada |
2 | No | Nombre asignado al dominio. Este nombre puede ser usado más adelante por la instrucción DPTABLE. Este parámetro es opcional. Si está presente su valor debe ser único para toda la hoja de Excel que esta siendo procesada. Esto se debe a que dos dominios no pueden tener el mismo nombre. | Cadena |
3 | Sí | Coordenada donde la Tabla Data Point Domain está definida. | Coordenada |
4 | Sí | Coordenada de la tabla de conceptos. El formato de la tabla de conceptos se explica en este mismo manual en la sección “Tablas de Conceptos” | Tabla de Conceptos |
5 | Sí | Coordenada a la tabla de resolución de número de conceptos. El formato de la tabla de resolución número de concepto se muestra a continuación. Según le especificación de Dimensiones 1.0, el valor del atributo orden en la relación de definición no tiene ningún significado. | Coordenada |
Puede insertar la instrucción DPDOM utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Datapoint y pulse sobre el botón DP-Domain La ventana de parámetros que se abre es la siguiente:
|
Formato Tabla Data Point Domain
Esta tabla consiste en una sola columna. Esta columna define la membresía del dominio usando sangrado en las celdas Excel.
Ejemplo:
Related to minimum reserve |
Reserve base |
Deduction |
Standard deduction |
Specific deduction |
Exempt from minimum reserves |
En este caso, el elemento de dimensión es el primero de la tabla. Todos los elementos con un nivel de sangrado son miembros del elemento raíz “Related to minimum reserve”. Los elementos con dos niveles de sangrado son miembros de dominio “Deduction”.
El texto en las etiquetas no se usa con ningún propósito, solamente se usan los diferentes niveles de sangrado.
El recorrido principal sobre la tabla de dominios está definido en el parámetro numero 4 (La Tabla de Conceptos). Debe existir una correspondencia línea a línea entre los números de la Tabla de Conceptos y la tabla Data Point Domain.
La relación definida podría tener un atributo orden. El valor de este atributo se obtiene del parámetro 5 de la instrucción. Debe existir una correspondencia línea a línea entre los números de la tabla de Conceptos y la tabla de orden.
Formato Tabla de Resolución
La tabla de resolución de números de conceptos consiste en una única columna. Esta columna contiene el número para cada uno de los elementos de la tabla de conceptos.
Ejemplo:
Number |
1 |
2 |
3 |
end |
Esta tabla asigna el número 1 al primer elemento de la tabla de conceptos; el número 2 al elemento siguiente, etc. El elemento “end” dentro de la tabla indica que no existen más elementos dentro de la tabla de números.
DPTABLE
La instrucción DPTABLE debe existir dentro de un bloque de instrucciones BOL – EOL. No puede ser una instrucción raíz. Esta instrucción construye un hipercubo de acuerdo a la especificación XBRL Dimensions 1.0. Esto es, juntando los dominios definidos en instrucciones previas.
La instrucción DPTABLE tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | Sí | La URI del rol o una coordenada apuntando donde la URI del rol esté ya definida. Este es el enlace extendido de definición donde el hipercubo y los dominios serán definidos. | URL, URI o Coordenada |
2 | Sí | Puede ser o bien el valor “scenario” o el valor “segment” indicando el lugar donde se espera que el contenido de la dimensión sea reportado en un documento instancia. Esto se ajusta a la definición del atributo xbrldt:contextElement en la especificación Dimensions 1.0 | Token |
3 | Sí | Valor Booleana que indica si el hipercubo será abierto o cerrado. Esto se ajusta a la definición del atributo en la especificación Dimensions 1.0 | Booleano |
4 | Sí | Referencia de Concepto apuntando a la definición del elemento principal. Este es el concepto de la taxonomía para el cual se definirán dimensiones en el hipercubo. Este elemento será enlazado con el hipercubo usando un arco de rol de tipo ALL. | Referencia de Concepto |
5 | Sí | Referencia de Concepto apuntando a la definición del hipercubo donde la dimensión será adjuntada. | Referencia de Concepto |
6 | Sí | Lista de nombres de dominio separados por coma. Todos ellos serán añadidos como dimensiones en la definición del hipercubo en el parámetro 5 para el elemento principal indicado en el parámetro 4. | Cadena |
7 | No | La URI del rol o una coordenada apuntando donde la URI del rol esté ya definida. Este es el enlace extendido donde se definirán la relaciones del hipercubo-dimensiones. | URL, URI o Coordenada |
Ejemplo:
Build: | param1 | param2 | param3 | Param4 | Param5 | Param6 |
DPTABLE | http://www.xbrl.org/2003/role/link | scenario | TRUE | CONCEPTS!B8 | CONCEPTS!B20 | domCount,domProd |
Puede insertar la instrucción DPTABLE utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Datapoint y pulse sobre el botón Datapoint La ventana de parámetros que se abre es la siguiente:
|
DPNOTTABLE
La instrucción DPNOTTABLE funciona exactamente igual que DPTABLE pero el elemento principal indicado en el argumento 4 será enlazado con el hipercubo usando un arco de rol de tipo NOT ALL.
Puede insertar la instrucción DPNOTTABLE utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Datapoint y pulse sobre el botón Excl. D Pt. La ventana de parámetros que se abre es la siguiente:
|
BODPTABLE
La instrucción BODPTABLE indica el principio de una tabla Data Point. La instrucción BODPTABLE debe ser cerrada por la instrucción EODPTABLE. Entre ambas instrucciones puede haber un conjunto de instrucciones DPHEAD, DPROW y DPCOLUMN definiendo el contenido de la tabla.
La instrucción BODPTABLE tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | Sí | El ID de la tabla. Este ID puede ser usado en la columna padre de tablas que describan el contenido de instrucciones DPHEAD, DPROW o DPCOLUMN. | Token |
Ejemplo:
Build: | param1 |
BODPTABLE | t01 |
La instrucción BODPTABLE debe existir dentro de un bloque de instrucciones BOGENLINK – EOGENLINK.
DPHEAD, DPROW y DPCOLUMN
Estas instrucciones son similares:
- DPROW define una fila de una tabla Data Point (eje X). La información en este eje es principalmente valores de items primarios. También pueden ser valores en dimensiones que definen la ruptura con la dimensión principal.
- DPCOLUMN define una columna de una tabla Data Point (eje Y). La información en este eje es normalmente un conjunto de dimensiones y de valores de dimensiones.
- DPHEAD define la cabecera de una tabla Data Point (eje Z). La información en este eje es generalmente el periodo aplicable a todos los elementos en la tabla. También puede ser el elemento principal, en caso de que sea siempre el mismo (muy común en Data Point Modeling).
Estas instrucciones definen recursos en la jerarquía en arbol de los ejes de la tabla de recursos. Esta jerarquía define la prioridad con que los elementos son asignados. Cuando la misma dimensión/aspecto es aplicado en:
- Nodos del mismo árbol: Entonces los nodos hoja tiene prioridad sobre los nodos raíz.
- Diferentes ejes: Entonces el eje Y tiene prioridad sobre el eje X. El eje X la tiene sobre el eje Z.
Estas instrucciones tienen los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | Sí | ID. Este ID puede ser utilizado por la columna “padre” de otra instrucción DPHEAD/DPCOLUMN/DPROW que sea hija de esta instrucción. El ID sirve además para definir etiquetas genéricas para este recurso. | Token |
2 | Sí | Orden. El valor de orden del elemento. Cuando un nodo padre tiene múltiples hijos este valor definirá el orden de cada columna. | Número |
3 | Sí | Abstracto: si el valor del parámetro es falso, la columna, DEBE tener un valor. Si es verdadero, no se podrán introducir valores en esta columna. | Booleano |
4 | No | Nombre: Referencia de Concepto que apunta al elemento principal asignado en esta instrucción. | Referencia de Concepto |
5 | No | Instante: Puede tener el valor “end” (fecha de fin de periodo) o “start” (fecha de comienzo). El valor por defecto es “end”. | Token |
6 | No | Desplazamiento: Es el número de días de desplazamiento respecto a las fechas de inicio y fin, que se aplicará a la fecha de entorno de los hechos. El valor por defecto es cero. | Entero |
7 | No | Pares de Dimensión y Valor: Es una lista de pares de valores (unidos por ‘=’) separados por comas. Une una Referencia de Concepto de dimensión con una Referencia de Concepto de valor para esa dimensión. Todos los pares dimensión/valor definidos serán asignado al recurso al nivel definido por el árbol. | ReferenciadeConcepto= ReferenciadeConcepto [,…] |
8 | Sí | Padre: Este es el ID del recurso padre. El valor del recurso padre DEBE existir siempre. Puede ser el ID de otro elemento DPHEAD/DPCOLUMN/DPROW o el ID de BODPTABLE. | Token |
9 | No | Alineación: Puede ser el valor “right” o el valor “left”. Este valor indica donde va la columna padre en relación a las columnas hijas (cuando la columna no es abstracta). Por defecto el valor es “right”. | Token |
10 | No | Título: Indica si la columna (o fila) es solamente un título. Si es título, la columna o fila completa no tendrá valores de entrada. El texto asignado al recurso usando una etiqueta genérica actuará como título de la columnas hijas. | Booleano |
Ejemplo:
Build: | param1 | param2 | param3 | param4 | p5 | p6 | param7 | p8 | p9 | p10 |
DPHEAD | Ac193 | 0 | false | BASE!D3 | RS!D2=RS!D3,AT!D2=AT!D5 | t01 |
EODPTABLE
La instrucción EODPTABLE cierra la definición que ha sido abierta por la instrucción BODPTABLE. Es durante el procesado de esta instrucción cuando los recursos son creados en el linkbase.
Esta instrucción no tiene parámetros.
