Configuración de componentes XML
Una vez haya añadido un componente XML al área de la asignación puede configurarlo desde el cuadro de diálogo Configuración del componente (imagen siguiente). Puede abrir este cuadro de diálogo de una de las siguientes maneras:
•Haga doble clic en el encabezado del componente
•Haga clic con el botón derecho en el encabezado del componente y luego seleccione Propiedades
•Seleccione el componente en la asignación y haga clic en Propiedades en el menú Componente
![xml_component_settings_dialog_box](./images/xml_component_settings_dialog_box.png)
A continuación puede ver las opciones que se pueden configurar en este cuadro de diálogo.
Configuración general
El nombre del componente se genera automáticamente al crearlo, pero se puede volver a cambiar cuando quiera. El nombre del componente puede contener espacios y puntos, pero no barra, barra inversa, dos puntos, comillas dobles, ni espacios antes ni después del nombre.
Si cambia el nombre del componente, tenga en cuenta que:
•Si quiere implementar la asignación en FlowForce Server, el nombre del componente debe ser único. •Recomendamos que use únicamente caracteres que se puedan usar también en la línea de comandos. Los caracteres especiales propios de cada país pueden estar codificados de forma diferente en Windows y la línea de comandos.
|
Indica el nombre o la ruta de acceso del archivo de esquema XML que MapForce usa para validar y asignar los datos. Para cambiar el archivo del esquema haga clic en Examinar y seleccione un archivo nuevo. Para editar el archivo en Altova XMLSpy haga clic en Editar.
|
Indica el archivo de instancia XML del que MapForce debe leer los datos. Este campo es relevante para los componentes de origen y se rellena cuando se crea el componente y se le asigna un archivo de instancia XML. En un componente de origen el nombre del archivo de instancia también se usa para detectar el elemento raíz de la instancia XML y el esquema al que se hace referencia, así como para validar los datos con el esquema seleccionado. Para cambiar el archivo del esquema haga clic en Examinar y seleccione un archivo nuevo. Para editar el archivo en Altova XMLSpy haga clic en Editar.
|
Indica el archivo de instancia XML en el que MapForce escribirá los datos. Este campo es significativo para un componente de destino. Para cambiar el archivo del esquema haga clic en Examinar y seleccione un archivo nuevo. Para editar el archivo en Altova XMLSpy haga clic en Editar.
|
Permite introducir un prefijo para el espacio de nombres de destino. Antes de asignar el prefijo debe asegurarse de que el espacio de nombres de destino está definido en el esquema de destino.
|
Agrega la ruta del archivo de esquema XML al que se hace referencia al elemento raíz de los datos XML de salida. La ruta del esquema que se introduce en este campo se escribe en los archivos de instancia de destino que se generan en el atributo xsi:schemaLocation o en la declaración DOCTYPE si se está usando una DTD.
Ediciones MapForce Professional y Enterprise: Si genera código en XQuery o C++ no se permite agregar también la referencia de la DTD.
Si introduce una ruta en este campo puede definir dónde se encuentra el archivo de esquema al que hace referencia el archivo de instancia XML. Esto permite poder validar el archivo de instancia de salida en la ubicación de destino de la asignación cuando esta se ejecute. En el campo Agregar referencia de esquema/DTD puede introducir una dirección http:// o una ruta de acceso absoluta o relativa
Si desactiva esta opción puede desconectar la instancia XML de los esquemas XML o documentos DTD a los que se hace referencia. Esto puede ser útil, por ejemplo, si quiere enviar los datos XML de salida a alguien que no tiene acceso al esquema XML subyacente.
|
Esta opción está habilitada por defecto, lo que significa que la declaración XML se escribe en la salida. En la tabla siguiente puede ver la compatibilidad de esta funcionalidad con los lenguajes de destino de MapForce y sus motores de ejecución.
|
Si selecciona esta opción se inserta la declaración standalone="yes" en la declaración XML del archivo XML de destino. Para saber más consulte la declaración de documento independiente.
Tenga en cuenta que:
•Cuando se selecciona la opción independiente="yes", la generación de datos de salida es compatible con el lenguaje Built-In XSLT 1-3 y con la generación de código (C#, Java, C++ MSXML, C+ Xerces). El lenguaje de transformación Built-In y el código generado están disponibles en las ediciones Professional y Enterprise. Para más información sobre la generación de código consulte Generador de código. •No hay compatibilidad con XML incrustado en campos de bases de datos y solicitudes de servicios web (ediciones Professional y Enterprise).
|
Permite (i) definir si los tipos del esquema XML de destino deben utilizarse durante la asignación o (ii) si todos los datos asignados al componente de destino deben considerarse valores de cadena. Por defecto, esta opción está habilitada. Si desactiva esta opción podrá conservar el formato preciso de los valores. Por ejemplo, si se desea satisfacer una faceta de patrón de un esquema que requiere un número concreto de dígitos decimales en un valor numérico. Puede usar funciones de asignación de datos para dar el formato de cadena necesario al número y después asignar esta cadena al destino.
Recuerde que si deshabilita esta opción, también se deshabilita la detección de valores no válidos (p. ej. si se escriben letras en campos numéricos).
|
Ajusta el formato del documento XML de salida para que tenga un aspecto estructurado. Cada nodo secundario se presenta alejado de su elemento primario por cuatro caracteres de espacio.
|
Permite agregar una firma digital al archivo XML de instancia de salida. Esto sólo es compatible con el lenguaje de transformación integrado (véase Firmas digitales).
|
Codificación de salida
Permite especificar las siguientes opciones del archivo de instancia de salida:
•Nombre de la codificación
•Orden de bytes
•Si se incluye o no la marca BOM
La codificación de cualquier componente nuevo está definida por defecto en la opción Codificación predeterminada para componentes nuevos. Puede acceder a esta opción desde Herramientas | Opciones (sección Generales).
Si la asignación genera XSLT 1.0/2.0, marcar la casilla Orden de bytes no tiene ningún efecto, ya que estos lenguajes no son compatibles con el orden de bytes.
Archivo hoja de estilos StyleVision Power
Esta opción permite seleccionar o crear un archivo de hoja de estilos de Altova StyleVision Estos archivos permiten presentar los datos de salida de un archivo XML de instancia en varios formatos, como HTML, RTF, etc. Consulte también el apartado Usar rutas de acceso relativas en un componente.
Otras opciones
Esta opción permite un manejo especial de las secuencias de las que se sabe que contienen exactamente un elemento, como atributos necesarios o elementos secundarios con minOccurs y maxOccurs="1". En este caso se extrae el primer elemento de la secuencia y se procesa directamente como un valor atómico (y no como una secuencia)
Si los datos de entrada son no válidos para el esquema, la asignación genera un mensaje de error. Para permitir que se procesen datos de entrada no válidos, desmarque esta casilla.
|
Cuando esta opción está habilitada, MapForce guarda las rutas de acceso al archivo que aparecen en el cuadro de diálogo Configuración del componente relativas a la ubicación del archivo de diseño de MapForce (.mfd). Consulte también Rutas de acceso relativas en un componente.
|