El comando valtaxonomypackage | taxpkg valida uno o más paquetes de taxonomías XBRL de acuerdo con la Taxonomy 1.0 Packages. Tenga en cuenta que el comando valida los paquetes de taxonomías, no las taxonomías en sí. No comprueba si los puntos de entrada que contiene se ajustan a la especificación XBRL 2.1 ni a ninguna otra especificación XBRL. Para validar los puntos de entrada que contiene, utilice el comando valxbrltaxonomy (dts) junto con la opción --taxonomy-package del comando.
raptorxmlxbrl valtaxonomypackage | taxpkg [opciones] PaqueteTaxonomías |
•El argumento PaqueteTaxonomías es el paquete de taxonomías XBRL que se debe validar. El paquete de taxonomías suele ser un archivo ZIP.
•Si desea validar varios paquetes de taxonomías, tiene dos opciones: (i) enumerar los paquetes que se deben validar en la interfaz de la línea de comandos, separando cada paquete del siguiente con un espacio; o (ii) enumerar los paquetes que se deben validar en un archivo de texto (.txt), con un nombre de archivo por línea, y proporcionar este archivo de texto como argumento PaqueteTaxonomías junto con la opción --listfile configurada con el valor true (ver lista de opciones más abajo).
Ejemplos
Ejemplos del comando valtaxonomypackage:
•raptorxmlxbrl valtaxonomypackage c:\Test.zip
•raptorxmlxbrl taxpkg --listfile=true c:\ListaPaquetesTaxonomías.txt
•raptorxmlxbrl taxpkg --listfile c:\ListaPaquetesTaxonomías.txt
RaptorXMLXBRL (y RaptorXMLXBRLServer para comandos administrativos) en Windows raptorxmlxbrl (y raptorxmlxbrlserver para comandos administrativos) en Windows y Linux * Las minúsculas (raptorxmlxbrl y raptorxmlxbrlserver) funcionan en todas las plataformas (Windows y Linux), mientras que las mayúsculas (RaptorXMLXBRL) funcionan solamente en Windows. * Use la barra diagonal en Linux y la barra diagonal inversa en Windows. |
En sistemas Windows: si hay espacios o caracteres especiales (por ejemplo en los nombres de archivos o de carpetas, empresas, personas o productos) debe usar comillas: por ejemplo, "Mi archivo". Sin embargo, debe tener en cuenta que una barra diagonal inversa seguida de comillas dobles (por ejemplo, "C:\Mi Directorio\") es posible que no se lea correctamente. Esto se debe a que la barra diagonal inversa también se usa para empezar secuencias de escape y la secuencia de escape \" también usa las comillas dobles. Para evitar secuencia de caracteres puede añadir otra barra diagonal inversa: \\". En resumen: si necesita escribir una ruta que contenga espacios y una barra diagonal inversa, esta es la mejor forma de hacerlo: "C:\Mi Directorio\\". |
Opciones
Las opciones del comando aparecen más abajo divididas en grupos. Los valores se pueden dar sin comillas excepto en estos dos casos: (i) cuando la cadena de valor contiene espacios y (ii) cuando en la descripción de la opción se indique explícitamente que es necesario el uso de comillas. Si una opción toma un valor booleano y no se indica ningún valor, entonces el valor predeterminado de la opción es TRUE. Use la opción --h, --help para ver información sobre el comando.
--listfile = true|false Si el valor es true, el argumento ArchivoEntrada del comando se entiende como un archivo de texto que contiene un nombre de archivo por línea. Otra opción es enumerar los archivos en la ILC, separados por un espacio. No obstante, recuerde que las ILC tienen un límite de caracteres. Además, no olvide que la opción --listfile solamente afecta a los argumentos y no a las opciones. Valor predeterminado: false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--recurse = true|false Esta opción se utiliza para seleccionar ficheros dentro de subdirectorios (incluso en archivos ZIP). Si el valor es true, el argumento ArchivoEntrada del comando seleccionará el fichero seleccionado también en los subdirectorios. Por ejemplo: "test.zip|zip\test.xml" seleccionará los ficheros llamados test.xml en todos los subdirectorios de la carpeta ZIP. Si quiere puede usar los caracteres comodín * y ?. Por ejemplo: *.xml seleccionaría todos los ficheros de la carpeta ZIP que tengan la extensión .xml. Valor predeterminado: false Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--schema-imports = load-by-schemalocation | load-preferring-schemalocation | load-by-namespace | load-combining-both | license-namespace-only Esta opción indica el comportamiento de los elementos xs:import. Cada uno de estos elementos tiene un atributo opcional namespace y un atributo opcional schemaLocation: <import namespace="unEspacioNombres" schemaLocation="unaURL">. La opción indica si se debe cargar un documento de esquema o solo autorizar a un espacio de nombres. Si la opción indica que se debe cargar un documento de esquema, entonces indica también qué información debe utilizarse para encontrar el documento de esquema. Valor predeterminado: load-preferring-schemalocation. •load-by-schemalocation: el valor del atributo schemaLocation se utiliza para buscar el esquema, teniendo en cuenta las asignaciones de catálogo. Si está presente el atributo namespace, se importa el espacio de nombres (con licencia). •load-preferring-schemalocation: si está presente, se utiliza el atributo schemaLocation teniendo en cuenta las asignaciones de catálogo. Si no está presente el atributo schemaLocation, entonces se usa el valor del atributo namespace a través de las asignaciones de catálogo. Este es el valor predeterminado. •load-by-namespace: el valor del atributo namespace se utiliza para buscar el esquema por medio de una asignación de catálogo. •load-combining-both: si el atributo namespace o schemaLocation tiene una asignación de catálogo, entonces se usa la asignación. Si ambos atributos tienen asignaciones de catálogo, entonces es el valor de la opción --schema-mapping (opción XBRL y opción XML/XSD) decide qué asignación se utiliza. Si no hay ninguna asignación de catálogo, entonces se usa el atributo schemaLocation. •license-namespace-only: se importa el espacio de nombres. No se importa el documento de esquema. |
--schema-mapping = prefer-schemalocation | prefer-namespace Si se usa la ubicación y el espacio de nombres para buscar el documento de esquema, esta opción indica cuál de ellos debe ser la opción preferida durante la búsqueda en el catálogo. Si la opción --schemalocation-hints o la opción --schema-imports tiene el valor load-combining-both y si las partes de espacio de nombres y URL pertinentes tienen asignaciones de catálogo, entonces el valor de la opción especifica cuál de las dos asignaciones se utiliza (la asignación del espacio de nombres o de la URL: el valor prefer-schemalocation se refiere a la asignación de la URL). Valor predeterminado: prefer-schemalocation. |
--schemalocation-hints = load-by-schemalocation | load-by-namespace | load-combining-both | ignore Determina el comportamiento predeterminado de los atributos xsi:schemaLocation y xsi:noNamespaceSchemaLocation. Indica si se debe cargar un documento de esquema y, si así es, indica qué información debe utilizarse para encontrarlo. Valor predeterminado: load-by-schemalocation. •Valor predeterminado: load-by-schemalocation. Este valor toma la URL de la ubicación del esquema de los atributos xsi:schemaLocation y xsi:noNamespaceSchemaLocation de los documentos de instancia XML o XBRL. •El valor load-by-namespace toma la parte de espacio de nombres del atributo xsi:schemaLocation y una cadena vacía en el caso del atributo xsi:noNamespaceSchemaLocation y encuentra el esquema por medio de una asignación de catálogo. •Si usa el valor load-combining-both y el espacio de nombres o la URL tienen una asignación de catálogo, se usa dicha asignación. Si ambos tienen asignaciones de catálogo, el valor de la opción schema-mapping (opción XBRL y opción XML/XSD) decide qué asignación se utiliza. Si ni el espacio de nombres ni la URL tiene una asignación de catálogo, se usa la URL. •El valor ignore ignora los atributos xsi:schemaLocation y xsi:noNamespaceSchemaLocation. |
--script = ARCHIVO Una vez finalizada la validación, ejecuta el script Python. Para indicar más de un script basta con agregar la opción varias veces. |
--api, --script-api-version = 1; 2; 2.1 to 2.4; 2.4.1; 2.5 to 2.8; 2.8.1 to 2.8.6; 2.9.0; 2.10.0; 2.11.0; 2.11.1; 2.12.0; 2.12.1 Especifica la versión de la API de Python que se debe utilizar para el script. El valor predeterminado es la última versión (actualmente 2.12.1). En lugar de valores numéricos enteros como 1 y 2, también puede utilizar los valores correspondientes 1.0 y 2.0. Asimismo, puede utilizar tres dígitos 2.5.0 o dos dígitos (2.5). Consulte también el apartado Versiones de la API de Python. |
--script-output = ARCHIVO Escribe el resultado estándar del script en el archivo llamado ARCHIVO. |
--script-param = CLAVE:VALOR Parámetros definidos por el usuario a los que se puede acceder durante la ejecución de scripts Python. |
--use-user-pkg-folder = true|false Especifica si se debe utilizar (i) la carpeta de paquetes del usuario o (ii) la carpeta de paquetes del sistema que utilizan las aplicaciones de Altova (ver tabla siguiente). El valor predeterminado es false. De forma predeterminada, los productos de Altova descargan y almacenan los paquetes de taxonomías y los paquetes de esquemas en carpetas comunes a todo el sistema destinadas, respectivamente, a las taxonomías y a los esquemas. Estas carpetas comunes de taxonomías y esquemas son utilizadas por todos los productos de Altova instalados en dicho sistema y por todos los usuarios de dicho sistema. No obstante, si un usuario no tiene acceso a las carpetas del sistema, se puede configurar que los paquetes de taxonomías y los paquetes de esquemas se descarguen en una carpeta de paquetes del usuario. Asegúrese de que la configuración de esta opción coincida con la configuración correspondiente en el Gestor de paquetes de taxonomías y en el Gestor de paquetes de esquemas de Altova. Puede acceder a la configuración del Gestor de paquetes de taxonomías y del Gestor de paquetes de esquemas de Altova mediante el icono con forma de rueda situado en la parte inferior izquierda del cuadro de diálogo de estas aplicaciones.
| Carpeta de paquetes de todo el sistema | Carpeta de paquetes del usuario |
|---|
Windows | C:\ProgramData\Altova\pkgs | C:\Users\<usuario>\Documentos\Altova\pkgs | Linux | /var/opt/Altova/pkgs | /home/<user>/Altova/pkgs |
Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
|
--catalog = ARCHIVO Especifica la ruta de acceso absoluta a un archivo de catálogo que no está en el archivo de catálogo raíz instalado. El valor predeterminado es la ruta de acceso absoluta del archivo de catálogo raíz instalado (<carpeta-instalación>\Altova\RaptorXMLXBRLServer2027\etc\RootCatalog.xml). Consulte el apartado Catálogos XML para obtener más información. |
--user-catalog = ARCHIVO Especifica la ruta de acceso absoluta a un catálogo XML que debe utilizarse junto con el catálogo raíz. Consulte el apartado Catálogos XML para obtener más información. |
--enable-globalresources = true|false Habilita la función de recursos globales. Valor predeterminado: false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
|
--error-format = text|shortxml|longxml Especifica el formato de la salida de error. Los valores posibles son formatos de texto, XML y XML detallado (longxml). Valor predeterminado: text. |
--error-limit = N | unlimited Especifica el límite de errores con un valor comprendido entre 1 y 9999 o unlimited (ilimitado). El valor predeterminado es 100. Cuando se alcanza el límite de error, se detiene la validación. Esta opción es muy práctica a la hora de limitar el uso del procesador durante la validación o transformación. |
--info-limit = N | unlimited Indica el límite del mensaje de información dentro del rango 1-65535 or unlimited. Si se alcanza el límite de información indicado, el procesamiento continúa pero ya no se informa de más mensajes. El valor predeterminado es 100. |
--help Muestra el texto de ayuda para el comando. Por ejemplo valany --h. (Otra opción es usar el comando help con un argumento. Por ejemplo: help valany). |
--job-timeout = SEGUNDOS Define un tiempo de espera para el trabajo en segundos. Si se agota el tiempo especificado, el trabajo se cancelará. El valor predeterminado 0 significa que no habrá tiempo de espera. |
--listfile = true|false Si el valor es true, el argumento ArchivoEntrada del comando se entiende como un archivo de texto que contiene un nombre de archivo por línea. Otra opción es enumerar los archivos en la ILC, separados por un espacio. No obstante, recuerde que las ILC tienen un límite de caracteres. Además, no olvide que la opción --listfile solamente afecta a los argumentos y no a las opciones. Valor predeterminado: false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--log-output = ARCHIVO Escribe el registro de salida en la URL de archivo indicada. Compruebe que la ILC tiene permiso de escritura en la ubicación de destino. |
--network-timeout = VALOR Indica el tiempo de espera en milisegundos para operaciones remotas de entrada y salida. Valor predeterminado: 40000. |
--recurse = true|false Esta opción se utiliza para seleccionar ficheros dentro de subdirectorios (incluso en archivos ZIP). Si el valor es true, el argumento ArchivoEntrada del comando seleccionará el fichero seleccionado también en los subdirectorios. Por ejemplo: "test.zip|zip\test.xml" seleccionará los ficheros llamados test.xml en todos los subdirectorios de la carpeta ZIP. Si quiere puede usar los caracteres comodín * y ?. Por ejemplo: *.xml seleccionaría todos los ficheros de la carpeta ZIP que tengan la extensión .xml. Valor predeterminado: false Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--verbose = true|false Si el valor es true, se genera información adicional durante la validación. Valor predeterminado es false. Nota: si no se especifica un valor para la opción, el valor booleano de la opción se establece en true. |
--verbose-output = ARCHIVO Escribe el resultado detallado en el ARCHIVO indicado. |
--version Muestra el número de versión de RaptorXML+XBRL Server. Si se utiliza con un comando, escriba la opción --version antes del comando. |
--warning-limit = N | unlimited Especifica el límite de advertencia en el rango 1-65535 o unlimited (ilimitado). El procesamiento continua si se alcanza el límite pero no se registrarán más advertencias. El valor por defecto es 100. |
|
