En esta sección se encuentra el listado detallado de las instrucciones necesarias para crear nombres y variables en el DTS Definition language. Puede encontrar información sobre el resto de instrucciones en la guia de ayuda del generador de taxonomías.
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, es 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. Donde xbrli es 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 La ventana de parámetros es la siguiente: |
Formato tabla de correspondencias
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 |
NAMEDEF
Esta instrucción define un nuevo espacio de nombres y de prefijos para su uso posterior. La instrucción puede estar encapsulada en los siguientes tipos de bloques:
- 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.
- 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, 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:
Número | Requerido | Contenido | Tipo |
1 | Sí | URI del espacio de nombres. | URI |
2 | Sí | Prefijo del espacio de nombres. | Token |
Ejemplo:
Instruction | param1 | param2 |
NAMEDEF | http://xbrl.iasb.org/info | info |
PROPERTYSET
La instrucción PROPERTYSET sirve para establecer parejas de clave y valor que serán puestas en una linkbase genérica como recursos a disposición del procesador XBRL. Las parejas de propiedades clave, valor pueden tener distintos usos.
Esta instrucción solo se puede especificar en una linkbase genérica. Por ello deberá estar dentro de un grupo de instrucciones que comience por BOGENLINK – EOGENLINK u otro similar que haya creado un contenedor de linkbase genérica.
A continuación se documentan algunas claves que usan las herramientas gráficas de Reporting Estandar S.L. para proporcionar una mejor interfaz de usuario:
La propiedad InstanceFileNamePattern sirve para proporcionar una expresión que se evaluará cuando el usuario quiera guardar el informe XBRL que está editando y proporcionará una propuesta de nombre de informe. Si existe un valor para esta propiedad en el DTS, cuando el usuario quiera guardar un informe en el disco duro, si el informe no tiene un nombre asignado aún (no se guardó con anterioridad y no es un informe que se ha abierto desde un archivo) se calculará la propuesta de nombre de archivo evaluando la expresión de esta propiedad y se utilizará ese nombre en la ventana de “guardar archivo”. Vea el ejemplo más abajo.
La propiedad ActiveRolAfterNewInstance sirve para proporcionar el rol (Vista) que se activará de forma predeterminada cuando el usuario seleccione la opción Nuevo Informe XBRL en las herramientas gráficas. Vea el ejemplo más abajo.
La instrucción PROPERTYSET tiene los siguientes parámetros:
Número | Requerido | Contenido | Tipo |
1 | No | Identificador del recurso que contendrá la tabla de propiedades clave-valor. | Token |
4 | Si | Coordenada de la Tabla de Propiedades que contiene las claves y valores que se añadirán como recurso a la linkbase genérica. Ver el formato de esa tabla más abajo. | Coordenada |
Ejemplo:
Build: | param1 | param2 | param3 | param4 |
PROPERTYSET | props | Opciones!F20 |
Formato de la Tabla de Propiedades
Propiedad | Valor |
ActiveRolAfterNewInstance | http://xbrl.ifrs.org/role/ifrs/ias_1_2014-03-05_role-110000 |
- Propiedad: Esta columna contendrá el nombre de la propiedad. Los nombres de las propiedades no pueden repetirse en un DTS. Tienen que ser únicas. Se recomienda que el nombre de la propiedad no tenga espacios y sea una única palabra
- Valor: Es el valor que tendrá la propiedad. En el ejemplo anterior es el valor de un rol. Pero puede ser cualquier cadena de texto.
Algunas propiedades pueden tener como valor una expresión que se evaluará dinámica mente y tomará valores que pueden venir desde el informe XBRL generado o la licencia del usuario. El siguiente ejemplo calculará un nombre de archivo usando información de valores reportados en el informe:
'Informe_' + Xpath('//*:NumeroDeIdentificacionTributaria[1]') + '.xbrl'
En el ejemplo anterior, se utilizará la constante “Informe_” a continuación se evaluará la expresión XPath que obtendrá del informe XBRL el número de identificación tributaria y a continuación se añadirá la extensión .xbrl. El resultado será un nombre de informe propuesto, y que varía respecto de los datos del informe en el momento en que el usuario crea el informe.
Nota adicional:
Las listas de propiedades-valores no proporcionan validaciones. Solo sirven para ayudar al entorno gráfico a que sea más amigable. Actualmente, las propiedades dentro de un DTS estan soportadas por todas las herramientas de Reporting Estándar S.L. Las listas de propiedades-valores son XBRL 2.1 válido y no deben suponer ningún problema en otras herramientas XBRL.