Listado de Instrucciones Básicas del DTS Definition Language

En esta sección se encuentra el listado detallado de todas las instrucciones básicas del DTS Definition Language. Puede encontrar información sobre el resto de instrucciones en Listado de Instrucciones Bajo Nivel del DTS Definition Language.

END

La instrucción END indica el final del proceso de generación de la taxonomía. Normalmente esta será la última instrucción de la hoja de instrucciones.

La instrucción END finaliza la fase 3 del proceso de generación del DTS. Esta instrucción no tiene parámetros

VERSION

La instrucción VERSION tiene los siguientes parámetros:

Ejemplo:

El valor por defecto para la versión si no se indica lo contrario es 1.

Este documento pondrá de manifiesto los casos en que la generación de la taxonomía pueda producir resultados distintos dependiendo de si la versión utilizada es la versión 1 o la versión 2.

Otros valores que no sean 1 o 2 pueden ocasionar resultados impredecibles y no deseados.

Se espera que todas las hojas de Excel sigan una única versión, por esta razón no se espera encontrar múltiples ocurrencias de la instrucción VERSION en un juego de instrucciones de definición del DTS. El caso habitual es tener exclusivamente una instrucción VERSION al principio del juego de instrucciones de definición del DTS.

BOT

BOT son las siglas para Beginning Of Taxonomy, lo que quiere decir Principio De Taxonomía. Esta instrucción indica la creación de una nueva taxonomía en el DTS. La instrucción BOT esta emparejada con la instrucción EOT (Fin De Taxonomía, mirar EOT más abajo) que indica el fin de la taxonomía. De esta forma las instrucciones incluidas dentro de un bloque definido por las instrucciones BOT y EOT definen el contenido del esquema de la taxonomía.

Es un error incluir una segunda instrucción BOT sin haber cerrado previamente el bloque con su correspondiente instrucción EOT. Por lo tanto las instrucciones BOT no pueden ser anidadas.

La instrucción BOT tiene los siguientes parámetros:

Ejemplo:

BOL

BOL son las siglas para Beginning Of Linkbase, lo que quiere decir Principio De Linkbase. Esta instrucción indica la creación de un nuevo linkbase. La instrucción BOT está emparejada con la instrucción EOL (Fin De Linkbase, mirar EOL más abajo). De esta forma las instrucciones incluidas dentro de un bloque definido por las instrucciones BOL y EOL definen el contenido para el linkbase.

Si la instrucción BOL está anidada dentro de un bloque de instrucciones BOT y EOT, y contiene un parámetro URI, entonces el linkbase será referenciado por la taxonomía que la envuelve usando un elemento link:linkbaseRef .

Si la instrucción BOL está anidada dentro de un bloque de instrucciones BOT y EOT, y no contiene un parámetro URI, entonces el linkbase será embebido dentro de la taxonomía padre.

Si la instrucción BOL está definida fuera de un bloque de instrucciones BOT y EOT entonces debe tener obligatoriamente el parámetro URI y el linkbase podrá ser referenciado en la taxonomía usando la instrucción REF (mirar la instrucción REF más adelante).

Es un error incluir una segunda instrucción BOL sin haber cerrado previamente el bloque con su correspondiente instrucción EOL. Por lo tanto las instrucciones BOL no pueden ser anidadas.

La instrucción BOL tiene los siguientes parámetros:

Ejemplo:

LOAD

La instrucción LOAD se ejecuta durante la fase 2 y realiza la carga de esquemas y taxonomías relevantes, por lo que esta instrucción no produce ninguna salida durante la fase 3 (fase de generación del DTS). La instrucción LOAD asegura que la hoja de Excel puede ser usada para producir una extensión de una taxonomía existente.

Una vez que la instrucción LOAD es ejecutada en la fase 2 todas la definiciones de conceptos, etiquetas, metadatos, hipercubos y recursos definidos en la taxonomía cargada son incorporados al modelo de información del DTS. Esto significa que una referencia a un concepto creada usando el prefijo de la taxonomía y el nombre de un elemento de una taxonomía cargada no requiere nada más para ser usado en un linkbase de presentación o de cálculo definido en el modelo de información de la hoja Excel. Observará que muchas de las instrucciones de este manual usan referencias a conceptos, y particularmente en linkbases de presentación se usarán referencias a etiquetas y conceptos.

La instrucción LOAD tiene los siguientes parámetros:

Ejemplo:

En el ejemplo anterior se carga la taxonomía IFRS 2006 desde una carpeta llamada ifrs.

NAME2QNAME

La instrucción NAME2QNAME define una tabla donde una simple cadena de texto se asigna a un QName (Qualified Name). Un QName consiste en el emparejamiento de una URI de espacio de nombres y un nombre local. Por ejemplo, un usuario de negocios encontrará más sencillo decir que el tipo de un elemento es “string” cuando, de hecho, durante el proceso de generación de la taxonomía, el tipo requerido es xbrli:stringItemType, siendo xbrli el prefijo que corresponde a la URI de espacio de nombres http://www.xbrl.org/2003/instance.

La instrucción NAME2QNAME tiene los siguientes parámetros:

Ejemplo:

La tabla de correspondencias debe tener el siguiente formato:

La celda marcada en verde oliva es donde el parámetro 3 de la instrucción NAME2QNAME debe apuntar. Las cabeceras de las tablas no se usan.

La primera columna contiene el nombre que servirá de clave asignada al QName. Instrucciones posteriores podrán usar esta cadena de texto para referirse al QName.

La segunda columna contiene el prefijo que debe ser resuelto en un espacio de nombres. Utilice la instrucción NAMEDEF antes de instrucción NAME2QNAME si quiere crear QNames que no se refieran a cualquiera de los esquemas creados o ya cargados en la taxonomía.

La tercera columna contiene el nombre local. Esta es la tercera parte requerida en la definición de un QName.

CONCEPTS

La instrucción CONCEPTS especifica, en el esquema que contiene la instrucción, un conjunto de definiciones de concepto (items o tuplas) y definición de elementos XML. La instrucción CONCEPTS debe estar siempre anidada dentro de un bloque de instrucciones BOT y EOT.

La instrucción CONCEPTS tiene los siguientes parámetros:

Bajo la versión 1: La tabla de conceptos debe tener la siguiente estructura:

Bajo la versión 2: La tabla de conceptos debe tener la siguiente estructura:

El contenido de cada una de las columnas se explica más abajo.

La celda marcada en color verde oliva es la celda apuntada por el contenido del parámetro 4.

Aunque nos estamos refiriendo a las columnas por el nombre de las mismas, las cabeceras de las tablas no son relevantes para TaxonomyBuilder y no son usadas, lo que sí es importante es el orden en el cual están definidas las columnas. Este orden esta señalado en las tablas para las diferentes versiones (versión 1 y versión 2) mostrado con anterioridad.

Prefix: Esta columna debe rellenarse siempre y debe ser igual al prefijo de la taxonomía definido en le instrucción BOT salvo para la última fila de la tabla que debe tener la expresión end. Esta expresión es reconocida como el final de la tabla de conceptos, y ningún otro concepto más será añadido a la taxonomía por debajo de la fila que contenga la expresión end en la columna de prefijo.

Name: Este es el nuevo nombre del concepto, esto es, la etiqueta para el nombre del elemento

Id: el identificador del concepto o elemento. Por norma general será la concatenación del prefijo más un carácter de subrayado más el nombre del concepto. No es un error si una definición de elemento XML no contiene un Id, pero una definición de concepto sin un Id no podrá tener relaciones.

Type: Este es el tipo del concepto definido como un QName usando el patrón prefix:typeName para definiciones de elementos de tipo simple (elementos XBRL y Conceptos XML) o bien es definido como una Coordenada de hoja para tipos complejos (Tuplas XBRL y Conceptos XML). El tipo también puedes ser un simple typeName sin necesidad de que tenga prefijo. El token typeName debe existir como una entrada en la tabla de Qnames. Revise la documentación en referencia a la instrucción NAME2QNAME para obtener más detalles.

Todos los tipos XBRL son permitidos al igual que los tipos globales que también los son. Usar tipos propios puede requerir definirlos primero en un esquema propio y añadir necesariamente la instrucción IMPORT en algún lugar de la hoja de instrucciones de generación del DTS. Dado que los esquemas importados son cargados durante la segunda fase los tipos de datos definidos estarán disponibles durante la ejecución de la instrucción CONCEPTS. En cualquier caso, una instrucción IMPORT es necesaria en la definición del esquema de cualquier taxonomía que defina conceptos que usen tipos de datos propios.

Sg: Este es el grupo de sustitución de los conceptos. Para conceptos XBRL debe ser o bien xbrli:item o bien xbrli:tuple. Para elementos usados como contenido de recursos en un linkbase de recursos este debe ser link:part y para elementos XML planos este puede ser cualquier definición de concepto que ya exista, o incluso esta columna podría dejarse en blanco si el grupo de sustitución no es necesario.

Balance: Para definiciones de conceptos XBRL esta columna se puede dejar en blanco o puede contener las cadenas de texto “debit” o “credit”.

Period: Para definiciones de ítems de conceptos XBRL esta columna debe contener la cadena “instant” o la cadena “duration”. Para cualquier otra definición de elemento esta columna puede dejarse en blanco.

Abstract: Este es el valor del atributo abstracto (Abstract) en la definición de elementos. Son valores válidos las cadenas “false”, “true” o ningún valor en la celda. Si no existe ningún valor, el elemento no tendrá el atributo abstracto y seremos notificados mediante un mensaje de aviso.

Nillable: Este es el valor del atributo Nillable en la definición de elementos. Son valores válidos las cadenas “false”, “true” o ningún valor de celda. Si no existe ningún valor, el elemento no tendrá el atributo Nillable y seremos notificados mediante un mensaje de aviso.

Attributes: Esta es la coordenada a la Tabla de Atributos que el nuevo concepto contendrá una vez que se ha generado.

La Tabla de Atributos debe tener la siguiente estructura:

Cada concepto puede tener un número diferente de atributos.

El contenido de cada columna en la tabla se explica a continuación:

Prefix: Este es el atributo prefijo. El prefijo debe ser un prefijo existente asociado o bien con un esquema de taxonomía o bien con un espacio de nombres (Consulte la instrucción NAMEDEF y la instrucción BOT)

Attribute name: Es el nombre local del atributo.

Data type: Este es el tipo de dato del atributo. Tipos de dato válidos son: QName, Date, String y Number. Cualquier otro tipo de dato será considerado como cadena y se generará un aviso.

Value: Este es el valor del atributo. El usuario es libre de usar fórmulas Excel para generar el valor de la celda.

Creando Tuplas XBRL

Las tuplas requieren dos cosas: la definición del concepto en la Tabla de Conceptos y el tipo de datos de la tupla que normalmente es una definición de tipos de datos complejos. TaxonomyBuilder soporta la definición de tipos de datos complejos locales en Excel.

El enlace entre la definición de conceptos y la definición de tipos complejos se realiza en la tabla de conceptos, especificando una coordenada en la columna tipo. La coordenada debe apuntar a la celda superior derecha de la tabla (sin tener en cuenta la cabecera). En el siguiente ejemplo está la celda que contiene la cadena “sequence” en la columna Composition.

El modelo de Contenido de definiciones de tupla se documenta en la siguiente tabla con la estructura:

Siendo el contenido de cada una de las columnas:

Composition: Esta columna contiene los tokens y el estilo de sangrado para especificar la estructura del contenido de tipo complejo.

Tokens: Los tokens que admite esta columna son “sequence”, “choice”, “all” (para elementos en la raíz de la jerarquía) y “element” (para nodos anidados dentro de un nodo padre).

Style: La herramienta reconoce automáticamente el nivel de sangrado de una celda con el fin de obtener los elementos que pertenecen al elemento padre. En el ejemplo anterior la fila número 2 es el nodo raíz, las cuatro filas siguientes son hijas del primer elemento “sequence” y las dos últimas filas son a su vez hijas del elemento “choice”. Es válido incrementar o decrementar el nivel de sangrado de acuerdo a las necesidades del modelado. La posición de la fila (posición relativa) es también respetada en la creación del modelo de contenido.

Prefix: Este es el prefijo del concepto cuando la composición (Composition) es un token del tipo “element”. El prefijo debe ser seleccionado de entre alguno de los prefijos que ya están definidos en el DTS.

Name: Este es el nombre del concepto cuando el token es del tipo “element”. El nombre debe ser seleccionado de entre alguno de los que ya están definidos en el DTS.

Cuando una tupla contiene otra tupla, la tupla contenida (tupla hija) debe ser definida antes de que sea referenciada por la tupla contenedora (tupla padre). La única excepción a esta regla se da cuando una tupla contiene una auto referencia, referencia a si misma como contenido. Esto es también válido para la definición del modelo de contenido y se permite por la herramienta.

minOccurs: Es un número natural que indica el número mínimo de ocurrencias que el elemento puede aparecer anidado en su elemento padre.

maxOccurs: Es un número natural que indica el número máximo de ocurrencias que el elemento puede aparecer anidado en su elemento padre, también puede utilizarse la cadena literal “unbounded” para indicar que no hay un numero máximo de ocurrencias.

NAMEDEF

Esta instrucción define un nuevo espacio de nombres y de prefijos para su uso posterior.

Si la instrucción NAMEDEF está encapsulada dentro de un bloque BOL – EOL, el nuevo espacio de nombres creado será añadido al fichero linkbase que se esta construyendo y estará disponible para su uso posterior por parte de los elementos de ese linkbase.

Si la instrucción NAMEDEF está encapsulada dentro de un bloque BOT – EOT, el nuevo espacio de nombres creado será añadido al fichero de la taxonomía que se esta construyendo y estará disponible para la creación de atributos por parte de los nuevos conceptos definidos en la taxonomía.

Si la instrucción NAMEDEF no está encapsulada dentro de un bloque BOT – EOT o dentro de un bloque BOL – EOL, entonces la definición del espacio de nombres en global y estará disponible en todos los ficheros creados dentro del Modelo de Información. Si el espacio de nombres es usado muy frecuentemente dentro de un fichero sería más recomendable utilizar espacios de nombres definidos a nivel de bloque. Espacios de nombre globales puedes producir declaraciones de espacios de nombre muy farragosas para los elementos debido a que cada vez que el espacio de nombre es usado se declara también a nivel del elemento.

La instrucción NAMEDEF tiene los siguientes parámetros:

Ejemplo:

IMPORT

La instrucción IMPORT añade un esquema importado a la taxonomía actual. Esta instrucción debe ser anidada dentro de un bloque de instrucciones BOT – EOT.

La instrucción IMPORT tiene los siguientes parámetros:

Ejemplo:

Nótese que en el ejemplo anterior la importación de la taxonomía IFRS 2006 se ha llevado a cabo desde una carpeta llamada ifrs.

Las sentencias de importación pueden ser añadidas a la taxonomía automáticamente en ciertas circunstancias, por ejemplo cuando un tipo de datos externo es usado en la definición de un concepto o cuando un concepto se encuentra en el grupo de sustitución de otro concepto en el DTS. En estos casos la instrucción IMPORT es implícitamente añadida a la taxonomía sin la necesidad de indicarlo explícitamente en el DTS aunque añadirlo explícitamente debe ser considerado como una buena práctica.

INCLUDE

La instrucción INCLUDE añade un esquema incluido a la taxonomía actual. Esta instrucción puede ser anidada dentro de un bloque de instrucciones BOT – EOT.

La instrucción INCLUDE tiene los siguientes parámetros:

Ejemplo:

En caso de dudas sobre cuando debe usarse la instrucción IMPORT o la instrucción INCLUDE, la regla es usar IMPORT. Una inclusión requiere que la taxonomía referenciada no debe tener espacio de nombres o en su caso debe ser el mismo que el de la taxonomía base. La taxonomía donde exista una unstrucción INCLUDE puede modificar los conceptos definidos en el esquema que se ha incluido.

ROLE

La instrucción ROLE crea un nuevo tipo rol de acuerdo a las especificaciones XBRL 2.1.

La instrucción ROLE tiene los siguientes parámetros:

Ejemplo:

ARCROLE

La instrucción ARCROLE crea un nuevo tipo arco de rol de acuerdo a la especificación XBRL 2.1.

La instrucción ARCROLE tiene los siguientes parámetros:

Ejemplo:

LABELLINK

La instrucción LABELLINK crea un enlace extendido de etiquetas siguiendo la especificación XBRL 2.1 dentro de un contenedor de linkbase.

Si la instrucción LABELLINK está encapsulada dentro de un bloque de instrucciones BOL – EOL entonces el nuevo enlace extendido de etiquetas se añadirá al contenedor del linkbase.

Si la instrucción LABELLINK está encapsulada dentro de un bloque de instrucciones BOT – EOT entonces un nuevo linkbase embebido será creado y el enlace extendido de etiquetas será añadido a este linkbase.

La instrucción LABELLINK no puede ser una instrucción raíz (debe estar siempre encapsulada en una taxonomía o linkbase).

La instrucción LABELLINK ha de seguir los siguientes parámetros:

Ejemplo:

El formato de la tabla de etiquetas es solamente una columna indicando la etiqueta para el correspondiente concepto en la tabla de conceptos. El proceso de asignar una etiqueta a un concepto empieza en las coordenadas indicadas para las tablas de conceptos y etiquetas. Cada vez que un concepto es asignado a una etiqueta tanto la posición de la tabla de conceptos como la de la tabla de etiquetas avanzan a la fila siguiente.

PRESLINK

La instrucción PRESLINK crea un enlace extendido de presentación siguiendo la especificación XBRL 2.1 dentro de un contenedor de linkbase.

Si la instrucción PRESLINK está encapsulada dentro de un bloque de instrucciones BOL – EOL entonces el nuevo enlace extendido de presentación se añadirá al contenedor del linkbase.

Si la instrucción PRESLINK está encapsulada dentro de un bloque de instrucciones BOT – EOT entonces un nuevo linkbase embebido será creado y el enlace extendido de presentación será añadido a ese linkbase.

La instrucción PRESLINK no puede ser una instrucción raíz (debe estar siempre encapsulada en una taxonomía o linkbase).

La instrucción PRESLINK tiene los siguientes parámetros:

Ejemplo:

El formato de la tabla de presentación es solo una tabla de una única columna como esta:

Desde esta columna se usara la siguiente información:

Sangrado: Se utiliza el sangrado para indicar una relación padre-hijo de los distintos elementos que componen la tabla. Los elementos con menor sangrado son los padres de los elementos con mayor nivel de sangrado. El sangrado debe empezar con un desplazamiento 0 (es decir el elemento raíz no tiene sangrado) e irse incrementando gradualmente en 1. Gracias a los distintos niveles de sangrado se puede identificar si los elementos son padres o hijos (o ambas cosas) de otros elementos.

Texto: Utilizado para obtener el valor del atributo preferredLabel en los arcos de presentación. El texto usado en la generación de enlaces extendido de presentación es cualquier etiqueta válida para el concepto indicado en la tabla de conceptos. Si eI texto no se corresponde con ninguna etiqueta para el concepto en uso entonces la herramienta generara un AVISO para indicar le existencia de una posible inconsistencia. El texto usado en esta tabla puede estar en cualquier idioma para el cual el concepto tenga etiquetas, esto quiere decir que puede ser mejor poner instrucciones LABELLINK antes de que se ejecute la instrucción PRESLINK.

Color: Se utiliza para cambiar la etiqueta de rol preferida desde un rol regular a un rol negado. Si el color del texto es ROJO, quiere decir que se utilizará un rol negado. Cuando el color sea cualquier otro, se usará un rol regular.

El formato de la tabla de orden de relaciones es solamente una columna con valores de números tal y como se muestra a continuación:

El número en esta columna será usado por el atributo orden de cada relación de presentación. Estos números también pueden ser usados por la instrucción CALCLINK que se explica a continuación.

CALCLINK

La instrucción CALCLINK crea un enlace extendido de cálculo siguiendo la especificación XBRL 2.1 dentro de un contenedor de linkbase.

Si la instrucción CALCLINK está encapsulada dentro de un bloque de instrucciones BOL – EOL entonces el nuevo enlace extendido de cálculo se añadirá al contenedor del linkbase.

Si la instrucción CALCLINK está encapsulada dentro de un bloque de instrucciones BOT – EOT entonces un nuevo linkbase embebido será creado y el enlace extendido de cálculo será añadido a ese linkbase.

La instrucción CALCLINK no puede ser una instrucción raíz (Debe estar siempre encapsulada en una taxonomía o linkbase).

La instrucción CALCLINK tiene los siguientes parámetros:

Ejemplo:

EL formato de la tabla de cálculo es una sola columna que contiene una ecuación que se corresponde con el siguiente patrón:

conceptNumer = [-+][*mult]conceptNumber [ más partes de conceptNumer ]

Por ejemplo:

10=6+7-8-9

Número de concepto 10 es igual al número de concepto 6 más número de concepto 7 menos número de concepto 8 menos número de concepto 9

O

20=+3*5+2*8

Número de concepto 20 es igual a 3 veces el numero de concepto 5 más 2 veces el número de concepto 8.

La ecuación puede aparecer en cualquier celda no solo en la celda donde exista el elemento el lado izquierdo del signo igual.

Los números de conceptos son reconocidos usando la tabla de resolución de números de conceptos.

La tabla de resolución de números de conceptos consiste en una única columna con números para cada uno de los conceptos de la tabla de conceptos

Ejemplo:

Esta tabla asigna el número 1 al primer elemento existente en la tabla de conceptos, el número 2 al elemento siguiente de la tabla de conceptos, etc. El elemento “end” dentro de la tabla indica que no existen más elementos dentro de la tabla de número de conceptos y se utiliza comúnmente para reconocer donde termia el procesado de la instrucción CALCLINK (u otra instrucción que utilice esta tabla).

Este mecanismo permite a los autores de taxonomías reutilizar la tabla de conceptos con los enlaces extendidos de presentación junto con la tabla de orden durante la generación o el cálculo de un enlace extendido.

DOMAINDEF

La instrucción DOMAINDEF permite a los diseñadores de taxonomías crear subdominios con nombre de miembros de un dominio completo, que pueden ser usados más adelante durante el desarrollo de taxonomías dimensionales.

Se permite el uso de la instrucción DOMAINDEF para definir subdominios con nombre de un dominio completo.

La instrucción DOMAINDEF tiene los siguientes parámetros:

Ejemplo:

El formato de la tabla de miembros de un dominio completo es una tabla de 4 columnas que contiene la siguiente información:

Ejemplo de tabla de miembros de un dominio completo:

Number: Es el valor del atributo orden de la relación del miembro del dominio que va a ser definida. Tenga en cuenta que la especificación XBRL no indica a la industria como usar el valor del atributo orden en una relación de esta naturaleza (relaciones de definición) por lo que pueden existir inconsistencias en el uso de este valor en las diversas herramientas existentes en el mercado.

Prefix: Es el prefijo del concepto tal y como se utiliza en la tabla de conceptos. El elemento “end” indica la finalización de la tabla de miembros de dominio completo.

Name: Esta es una columna para el nombre del concepto. El texto debe coincidir con el nombre del elemento. El sangrado se usa para definir la jerarquía de los miembros del dominio, tal y como se representa habitualmente, donde un elemento con menor nivel de sangrado es padre de los elementos con mayor nivel de sangrado.

Def: El termino “yes” en esta columna indica que ese dominio que será el miembro por defecto. El valor por defecto es global para la dimensión por lo que solamente uno de estos elementos debería tener marcada la opción por defecto.

Usable: La opción por defecto es “yes”, un valor “no” en esta columna indicará que el miembro no es utilizable mientras sea parte de la jerarquía de los miembros de dominio.

El formato para la tabla de definición de subdominios consiste en una única columna como esta:

Una celda en blanco para el valor indica que el concepto en la tabla de dominios completos no es un mimbro, mientras que cualquier otro valor de la celda indicará que el concepto es un miembro del subdominio.

Las filas en la tabla de dominios completos y en la tabla de definición de subdominios se incrementan de manera sincronizada.

DOMAIN

(Desde TaxonomyBuilder versión 2.6.9), disponible en versión 1 and versión 2

La instrucción DOMAIN permite al usuario crear estructuras de miembros de dominio que reflejen la jerarquía en los enlaces extendidos de presentación. EL nuevo dominio creado tendrá un nombre que será usado más adelante junto con la instrucción DIMLINK.

Aviso: La instrucción DOMAIN no permite especificar el valor para el dominio y no permite definir la característica ‘usable/no usable’ de la relación miembro de dominio. Todos los miembros de dominio tendrán siempre la característica usable a valor verdadero (usable=true). Aunque, la especificación XBRL no asigna ningún valor especial al significado al valor del atributo orden en la relación de miembro de dominio, esta herramienta permite especificar al usuario un valor en el atributo orden pero cualquier otra herramienta del mercado puede no manejar este valor de una forma consistente.

La instrucción DOMAIN tiene los siguientes parámetros:

Ejemplo:

TYPEDDOMAIN

La instrucción TYPEDDOMAIN define un nombre de dominio para una definición de dimensión. La instrucción TYPEDDOMAIN no genera directamente ninguna salida en el DTS en construcción. Esta instrucción solamente asigna un subdominio con nombre a la definición de la dimensión de tal manera que este nombre puede ser usado más adelante por otras instrucciones (como por ejemplo DPTABLE y DIMLINK) que utilicen subdominios con nombre como parámetros.

La instrucción TYPEDDOMAIN tiene los siguientes parámetros:

Ejemplo:

El elemento utilizado en el parámetro 3, en la referencia de concepto, DEBE satisfacer las condiciones especificadas en la especificación Dimensiones 1.0. Esto quiere decir que DEBE ser una definición de concepto abstracto, en el grupo de sustitución xbrldt:dimensionItem y DEBE tener un atributo llamado xbrldt:typedDomainRef apuntando a la definición del contenido de la dimensión. Se generará un error si alguna de estas condiciones no se satisfacen.

DIMLINK

La instrucción DIMLINK define dimensiones para definiciones de XBRL Item Concept de acuerdo a la especificación de XBRL Dimensions 1.0

Si la ejecución de la instrucción DIMLINK requiere crear nuevos conceptos automáticamente en el DTS (conceptos de hipercubo) entonces la instrucción DIMLINK debe aparecer dentro de un bloque de sentencias BOT – EOT y el parámetro prefijo (parámetro 2) debe coincidir con el prefijo indicado por la instrucción BOT.

La definición de dimensiones para la definición de conceptos XRBL se ha inspirado en las ideas de Matrix Schema desarrollado por el banco de Italia durante el proceso de creación de las taxonomías COREP.

La instrucción DIMLINK tiene los siguientes parámetros:

Ejemplo:

El formato de la tabla de definición de dimensiones es una tabla con número extensible de columnas con la siguiente estructura:

La coordenada usada por la instrucción DIMLINK ha sido resaltada en color verde oliva.

La columna hacia donde apunta la Coordenada es la columna para el indicador Abierto/Cerrado. El valor de la columna puede ser “O” para la generación del hipercubo “Abierta” o “C” para la generación del hipercubo “Cerrada”. Una celda en blanco en esta columna indica que el concepto no tiene hipercubos definidos en el enlace extendido definido.

Si la columna siguiente a la columna a Abierto/Cerrado contiene un elemento de definición de dimensión en el formato empleado en el ejemplo (el prefijo va dos filas hacia arriba y una columna a la derecha de la coordenada) entonces esta columna será utilizada para esa dimensión.

Si la siguiente columna a una columna de dimensión contiene una definición de un elemento de dimensión en el formato indicado en el ejemplo (el nombre del prefijo y el nombre del concepto están al mismo nivel de la definición de dimensión previa) entonces esa columna será usada para esa dimensión.

No existen restricciones en el número de dimensiones que pueden ser definidas.

La existencia de una columna de dimensión no fuerza a un hipercubo a contener esa dimensión. Los hipercubos son creados si existe una “O” o una “C” en el indicador Abierto/Cerrado. Entonces para cada celda en la que haya una referencia a un dominio o el nombre de un dominio se añadirá una nueva dimensión al hipercubo. Las celdas en blanco no incluirán esta dimensión en la generación del hipercubo.

Los mismos hipercubos no se crearán dos veces. Esto quiere decir que si dos conceptos tienen el mismo indicador Abierto/Cerrado y la mima dimensión y además el mismo dominio para cada dimensión entonces el mismo hipercubo será enlazado automáticamente a la definición del concepto.

La referencia del dominio es el contenido de la misma celda que está en la misma columna de la dimensión y en la misma fila para un concepto. El valor de la celda puede ser tanto un subdominio con nombre creado por la instrucción DOMAINDEF o una coordenada a una tabla de miembros de dominio completos. La tabla de miembros de dominio completo se define usando la instrucción DOMAINDEF comentada anteriormente.

El nuevo parámetro número 7 apunta a una tabla de búsqueda donde puede haber elementos predefinidos para ser usados por combinaciones específicas del indicador Abierto/Cerrado y nombres de dimensiones. La tabla de búsqueda tiene el siguiente formato: