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

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

Parámetro 1

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

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

Parámetro 5

Parámetro 1

Parámetro 3

Parámetro 2

Parámetro 4

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

Parámetro 3

Parámetro 4

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

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

Botonones configurables con enlaces a recursos

Parámetro 3

Acceso a la configuración de botones

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

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

Parámetro 3

Creación de las cabaceras de la tabla de Qnames

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

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

Parámetro 4

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