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
Puede insertar la instrucción END utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo General y pulse sobre el botón End Figura 8, Excel XBRL Taxonomy Language – Instrucción END |
VERSION
La instrucción VERSION tiene los siguientes parámetros:
Número |
Requerido |
Contenido |
Tipo |
1 |
Sí |
El número de versión. El valor “1” implica que se siguen las convenciones indicadas en la versión 1. El valor “2” implica que se siguen las convenciones indicadas en la versión 2. |
Número |
Ejemplo:
Instruction: |
param1: |
VERSION |
2 |
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.
Puede insertar la instrucción VERSION utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo General y pulse sobre el botón Version Figura 9, Excel XBRL Taxonomy Language – Instrucción VERSION La ventana de parámetros es la siguiente: Figura 10, Excel XBRL Taxonomy Language – Parámetros de instrucción VERSION
|
|
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:
Número |
Requerido |
Contenido |
Tipo |
1 |
No |
Espacio de nombres objetivo del esquema de la taxonomía. Este parámetro solo es requerido si la taxonomía define nuevos elementos. |
URN (URL,URI) o Coordenada |
2 |
No |
Prefijo del Espacio de nombres. |
Cadena |
3 |
Sí |
Nombre del fichero de la Taxonomía) |
URL |
4 |
No |
Comentarios XML que se incluirán al principio del esquema generado |
Texto |
5 |
No |
Contenido del atributo xml:base en el nodo raíz |
URL |
Ejemplo:
Instruction: |
param1: |
param2: |
param3: |
BOT |
http://www.example.com/2008/taxonomy |
ex |
ex-2008-07-15.xsd |
Puede insertar la instrucción BOT utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Taxonomy y pulse sobre el botón New Taxonomy Figura 11, Excel XBRL Taxonomy Language – Instrucción BOT La ventana de parámetros es la siguiente: Figura 12, Excel XBRL Taxonomy Language – Parámetros de instrucción BOT
|
|||||
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:
Número |
Requerido |
Contenido |
Tipo |
3 |
No |
Nombre del fichero Linkbase (relativo al directorio del fichero Excel) |
URL |
4 |
No |
Comentarios XML que se incluirán al principio del fichero de linkbase generado |
Texto |
Ejemplo:
Build: |
param1 |
param2 |
param3 |
param4 |
BOL |
ej-2008-07-15-label.xml |
© example company… |
Puede insertar la instrucción BOL utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Linkbases pulse sobre el botón New Linkbase Figura 13, Excel XBRL Taxonomy Language – Instrucción BOL La ventana de parámetros es la siguiente: Figura 14, Excel XBRL Taxonomy Language – Parámetros de instrucción BOL
|
||
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:
Número |
Requerido |
Contenido |
Tipo |
3 |
Sí |
Punto de entrada (relativo al directorio de Excel) del DTS a cargar. Puede ser un linkbase, una taxonomía o un documento instancia. |
URL |
Ejemplo:
Build: |
param1 |
param2 |
param3 |
LOAD |
ifrs/ifrs-gp-2006-08-15.xsd |
En el ejemplo anterior se carga la taxonomía IFRS 2006 desde una carpeta llamada ifrs.
Puede insertar la instrucción LOAD utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo General y pulse sobre el botón Load Figura 15,Excel XBRL Taxonomy Language – Instrucción LOAD La ventana de parámetros es la siguiente: Figura 16,Excel XBRL Taxonomy Language – Parámetros de instrucción LOAD
|
|||
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:
Número |
Requerido |
Contenido |
Tipo |
3 |
Sí |
Coordenada de hoja donde se encuentra la tabla de correspondencias entre nombres y QNames. |
Coordenada |
Ejemplo:
Build: |
param1 |
param2 |
param3 |
NAME2QNAME |
ConfigurationOptions!B4 |
Puede insertar la instrucción NAME2QNAME utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Other pulse sobre el botón Name to Qname table Figura 17, Excel XBRL Taxonomy Language – Instrucción NAME2QNAME La ventana de parámetros es la siguiente: Figura 18,Excel XBRL Taxonomy Language – Parámetros de instrucción NAME2QNAME
|
||
La tabla de correspondencias debe tener el siguiente formato:
Name |
Prefix |
LocalName |
monetary |
xbrli |
monetaryItemType |
string |
xbrli |
stringItemType |
domain |
nonnum |
domainItemType |
Explicit dimension |
xbrldt |
dimensionItem |
Typed dimension |
xbrldt |
dimensionItem |
Default member |
xbrli |
item |
Member |
xbrli |
item |
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.
Puede crear las cabeceras de la Tabla de Qnames utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Configuration y pulse sobre el botón Table Headers y elija la opción Name QName Figura 19,Excel XBRL Taxonomy Language – Instrucción Insertar Tabla NameQName |
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:
Número |
Requerido |
Contenido |
Tipo |
4 |
Sí |
Coordenada de la celda donde comienza la tabla de conceptos. La tabla de conceptos tiene una estructura fija de columnas. Esta coordenada debe ser la esquina superior izquierda de la tabla (considerando que no se tiene en cuenta la cabecera y que se debe omitir). La estructura de la tabla de conceptos se define más abajo. |
Coordenada |
Puede insertar la instrucción CONCEPTS utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Taxonomy y pulse sobre el botón Concepts Figura 20,Excel XBRL Taxonomy Language – Instrucción Concepts La ventana de parámetros es la siguiente: Figura 21,Excel XBRL Taxonomy Language – Parámetros de instrucción Concepts
|
|
Bajo la versión 1: La tabla de conceptos debe tener la siguiente estructura:
prefix |
name |
id |
type |
sg |
balance |
period |
abstract |
nillable |
ej |
Concept |
ej_Concept |
xbrli:monetaryItemType |
xbrli:item |
debit |
instant |
false |
True |
… |
… |
… |
… |
… |
… |
… |
… |
… |
end |
Bajo la versión 2: La tabla de conceptos debe tener la siguiente estructura:
prefix |
name |
id |
type |
sg |
balance |
period |
abstract |
nillable |
Attribute |
ej |
Con |
ej_Co |
xbrli:monetaryItemType |
xbrli:item |
debit |
instant |
false |
True |
Sheet!A3 |
… |
… |
… |
… |
… |
… |
… |
… |
… |
|
end |
Puede crear las cabeceras de la Tabla de Conceptos utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Configuration y pulse sobre el botón Table Headers y elija la opción Concepts Figura 22, Excel XBRL Taxonomy Language – Instrucción Insertar Tabla de Conceptos |