En esta sección se encuentra el listado detallado de las instrucciones necesarias para empezar la creación de una taxonomía. Puede encontrar información sobre el resto de instrucciones en la guia de ayuda del generador de taxonomías.
VERSION
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. El caso habitual es tener exclusivamente una instrucción VERSION al principio del conjunto de instrucciones de definición del DTS.
La instrucción VERSION tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | Sí | El número de versión, puede tomar los valores:
Otros valores que pueden ocasionar resultados no deseados. El valor por defecto para la versión es 1. | Número |
Ejemplo:
Instruction: | param1: |
VERSION | 2 |
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 La ventana de parámetros es la siguiente: |
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 La ventana de parámetros es la siguiente: |
EOT
La instrucción EOT indica el Final de la Taxonomía (End Of a Taxonomy).
Después de una instrucción EOT es posible empezar otra instrucción BOT. En el momento en que la instrucción EOT es ejecutada los ficheros de la Taxonomía producida son serializados a disco.
Puede insertar la instrucción EOT utilizando el plug-in de Excel XBRL Taxonomy Language. Para hacer esto acuda al grupo Taxonomy y pulse sobre el botón End of taxonomy |
XBRLPACK
La instrucción XBRLPACK sirve para crear paquetes de taxonomías (archivos ZIP) que contienen una copia de los archivos de la taxonomía. Estos archivos ZIP actúan como cache de los archivos que están en Internet. De esta forma, el procesador XBRL puede acceder a los archivos publicados como si estuviera accediendo a Internet aunque este leyendo un archivo comprimido dentro de un ZIP.
Reporting Estándar S.L. además dispone de una base de datos distribuida en Internet con todos los paquetes de taxonomías disponibles. Esta base de datos facilita el acceso a las taxonomías por parte de los usuarios. El sistema de catálogos utilizado por Reporting Estándar es extensible y en cascada. Es decir, si un catálogo no tiene el archivo solicitado, se le consultará al siguiente catálogo. Si ningún catálogo dispone del archivo seleccionado se descargará el archivo en Internet.
La instrucción XBRLPACK tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | Sí | Coordenada de la Tabla de nombre y descripción del contenido del archivo de paquete de taxonomías. Ver el formato de esta tabla más abajo | Coordenada |
2 | Sí | Versión del paquete de taxonomías. Cada paquete de taxonomías puede etiquetarse con una versión. Esta versión será utilizada para identificar el paquete de taxonomías. Es recomendable que sea un número secuencial. | Cadena |
3 | Sí | Nombre del archivo que se va a generar. Es recomendable que tenga extensión .zip y que no tenga espacios ni caracteres fuera del ASCII estándar de forma que sea más sencillo publicarlo en Internet. | Cadena |
4 | Sí | Coordenada de la Tabla de mapeo de archivos entre Internet y las carpetas dentro del ZIP. Ver el formato de esta tabla más abajo. | Coordenada |
5 | Sí | Coordenada de la Tabla de los puntos de entrada. Ver el formato de esta tabla más abajo. | Coordenada |
6 | Sí | Coordenada de la Tabla de archivos a empaquetar en el ZIP. Ver el formato de esta tabla más abajo. | Coordenada |
Ejemplo:
Build: | param1 | param2 | param3 | param4 | param5 | param6 |
XBRLPACK | Zip!B4 | 1 | Taxonomia_XYZ.zip | Zip!F4 | Zip!I4 | Zip!P4 |
Formato de la Tabla de nombre y descripción del contenido
Idioma | Nombre | Descripción |
es | Taxonomía 2015 para XYZ | Reporte del año 2015 |
en | XYZ 2015 Taxonomy | To be used for year 2015 |
end |
- Idioma: Esta columna contendrá el código IETF BCP 47 de idioma. Si se documentan varios idiomas, el software utilizará el idioma preferido por el usuario en la lista de preferencia que ha indicado.
- Nombre: Esta columna contendrá el nombre que se asigna a la taxonomía. Este nombre es lo que mostrarán las herramientas cuando hagan referencia a esta taxonomía.
- Descripción: Esta columna es opcional y puede tener un texto explicativo adicional.
Formato de la Tabla de mapeo de archivos
Origen | Destino |
http://www.XYZ.org/xbrl/2015-12-31/ | archivos1/ |
http://www.ABC.org/xbrl/2014-12-31/ | archivos2/ |
end |
- Origen: Esta columna contiene una URL que es común a un conjunto de archivos que están publicados en Internet. Por ejemplo, si el punto de entrada de nuestra taxonomía es «http://www.XYZ.org/xbrl/2015-12-31/punto_de_entrada.xsd» y tenemos otros 30 archivos publicados en el mismo directorio o en carpetas por debajo de ese directorio. La ruta común por la que todos los archivos comienzan es «http://www.XYZ.org/xbrl/2015-12-31/»
- Destino: Esta columna contiene la carpeta dentro del ZIP que tendrá una copia de los archivos que están en Internet. Por ejemplo, si el archivo que en Internet se llama «http://www.XYZ.org/xbrl/2015-12-31/punto_de_entrada.xsd»en el zip deberá existir una carpeta llamada «archivos1″ y dentro de esa carpeta deberá existir un archivo llamado «punto_de_entrada.xsd». En el caso de que nuestra taxonomía tenga archivos en carpetas por ejemplo: «http://www.XYZ.org/xbrl/2015-12-31/ifrs1/pre_ias1.xml» este archivo deberá guardarse en el ZIP en la ruta: «archivos1/ifrs1/pre_ias1.xml» de forma que pueda ser encontrado por las herramientas usando el contenido de esta tabla.
En el mismo ZIP se pueden poner muchas reglas de mapeo desde muchas URLs de inicio a distintas carpetas dentro del ZIP.
Formato de la Tabla de los puntos de entrada
Idioma | Nombre | Descripción | Tabla de URLs |
es | Consolidado | Reporte consolidado | Zip!N4 |
es | Individual | Reporte individual | Zip!N7 |
end |
- Idioma: Esta columna contendrá el código IETF BCP 47 de idioma que corresponde con el resto de los elementos de la línea en la tabla. Si se documentan varios idiomas, el software utilizará el idioma preferido por el usuario en la lista de preferencia que ha indicado.
- Nombre: Esta columna contendrá el nombre que se asigna al punto de entrada. Este nombre es lo que mostrarán las herramientas cuando hagan referencia a este punto de entrada.
- Descripción: Esta columna es opcional y puede tener un texto explicativo adicional.
- Tabla de URLs: esta columna es obligatoria y contiene la coordenada de otra tabla que tiene la lista de URLs absolutas que forman parte del punto de entrada. Aunque el caso más normal es que sea solo una URL (un punto de entrada) la especificación permite que se indique una lista de URLs, por eso en este campo, en vez de poner una URL se pone una referencia a una tabla que contiene la lista de URLs.
Aunque no es obligatorio según la especificación, lo normal es que la tabla de mapeo de archivos de Internet y las carpetas dentro del ZIP contenga entradas para cubrir todos los puntos de entrada referenciados.
Formato de la Tabla de URLs
Puntos de entrada |
http://www.XYZ.org/xbrl/2015-12-31/punto_de_entrada.xsd |
end |
- Puntos de entrada: es una única columna que termina en la fila que tenga la marca de fin de la tabla “end”. Todas las URLs enumeradas en esta lista formarán parte del punto de entrada.
Formato de la Tabla de archivos a empaquetar en el ZIP
Origen | Destino |
xbrl/2015-12-31/punto_de_entrada.xsd | archivos1/punto_de_entrada.xsd |
… | … |
end |
- Origen: esta columna tiene la lista de archivos que se incluirán en el ZIP. Esta columna identifica cada uno de los archivos en el disco duro local a partir de la carpeta donde se ha guardado el Excel.
- Destino: esta columna tiene el nombre del archivo que se creará en el ZIP, incluyendo las sub-carpetas dentro del ZIP que sean necesarias. Nota que estas carpetas están relacionadas con las que aparecen en la columna “destino” de la tabla de mapeo de archivos entre Internet y las carpetas dentro del ZIP. Ver más arriba.
Es posible realizar cálculos Excel para que se rellenen automáticamente la mayoría de los datos de estas columnas.
END
END es una instrucción sin parámetros que indica el final del proceso de generación de la taxonomía. Esta instrucción finaliza la fase 3 del proceso de generación del DTS y será la última instrucción de la hoja de instrucciones.
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 |