0 / 0
Volver a la versión inglesa de la documentación

Paso XML Composer (DataStage)

Última actualización: 12 mar 2025
Paso XML Composer (etapa Hierarchical Data)

Utilice una estructura especificada para componer el contenido XML.

Destino XML

Escribir en archivo
Especifique el directorio de salida y el prefijo de nombre de archivo para los archivos que se compondrán o pulse Insertar parámetro y seleccione el nombre del parámetro para el directorio de salida y el prefijo de nombre de archivo. Los parámetros que están disponibles son los parámetros que ha definido anteriormente en el trabajo y las macros incorporadas que están en IBM® InfoSphere® DataStage®.
Pasar como serie
Pase la serie XML compuesta a un paso o etapa en sentido descendente para su posterior proceso.
Pasar como objeto grande
Pase la serie XML compuesta como un objeto grande. La etapa final de destino, que es la última etapa del trabajo, debe ser una etapa sensible a LOB, como el conector de Db2, el conector deOracle, el conector de ODBC, el conector de Teradata o el conector de WebSphere MQ. Estas etapas utilizan la serie de localizador de LOB para obtener los datos XML y, a continuación, grabarlos en la base de datos de destino o en la cola de mensajes. El trabajo puede contener etapas no sensibles a LOB, pero estas etapas no deben modificar la serie de localizador de LOB. Si la última etapa del trabajo no es sensible a LOB, el localizador de LOB se escribe como datos, en lugar de interpretarse como un localizador.

Raíz de documento

Seleccione el elemento de nivel superior que describe los documentos que está componiendo. Los tipos que se muestran en el espacio de nombres de la biblioteca son definiciones de elementos de nivel superior. Siguiendo el estándar de esquema XML, solo los elementos de nivel superior pueden describir documentos. El nombre del elemento que selecciona debe coincidir con el nombre de elemento de nivel superior en los documentos de instancia. Por ejemplo, si está componiendo documentos de pedido, seleccione el elemento Pedido. Cuando selecciona el elemento, puede ver su estructura y verificar que la estructura es correcta para los documentos que desea componer.
Nota: Los elementos desde los que selecciona la raíz de documentos son de los recursos que se importaron previamente en las bibliotecas de esquemas. Si necesita importar el recurso que contiene la raíz de documento para el paso XML Composer, pulse Abrir bibliotecas e importe el recurso que necesite. A continuación, vuelva al editor de ensamblaje y configure la raíz de documento.

Validación

De forma predeterminada, XML Composer utiliza la validación mínima y el trabajo falla si se produce una violación. Para personalizar la validación, especifique la acción que se debe realizar cuando se produce una infracción.

Para obtener más información sobre las reglas de validación, consulte Reglas de validación de XML Composer (DataStage).

Correlaciones

Cree una correlación con el elemento document_collection. La forma de correlacionar este elemento determina si se crean un documento o varios. Para generar un solo documento, correlacione la raíz de la entrada (superior) con document_collection. Para generar varios documentos, correlacione un elemento de lista con el elemento document_collection. A continuación, se crea un archivo para cada elemento de la lista. Para obtener más información sobre la asignación, consulte Trabajar con la tabla de asignación (DataStage).

Cabecera

Especifique más información opcional que incluir al principio de la salida XML.

Generar fragmento XML
No incluya la declaración XML, los comentarios ni las instrucciones de proceso.
Incluir declaración XML
Incluya la declaración XML, por ejemplo, <?xml version="1.0" encoding="UTF-8">.
Incluir comentarios
Incluya los comentarios que especifique en el campo Comntarios.
Incluir instrucciones de proceso
Incluya las instrucciones de proceso que especifique en el campo Instrucciones de proceso. Encierre cada instrucción de proceso entre las etiquetas <? y ? >.
Incluir schemaLocation
Incluya el atributo schemaLocation en el archivo xml con el valor que especifique en el campo Ubicación del esquema.
Incluir noNamespaceSchemaLocation
Incluya el atributo noNamespaceSchemaLocation en el archivo xml con el valor que especifique en el campo Sin ubicación de esquema de espacio de nombres.

Formato

Tipo de codificación
Seleccione la codificación que desea utilizar para el documento. La codificación predeterminada es UTF-8.
Estilo de formato
Marque el recuadro para aplicar las siguientes opciones de formato a la salida XML:
  • Espacios por nivel de sangrado - Seleccione el número de caracteres a utilizar para cada nivel de sangrado en la salida XML.
  • Nuevo estilo de línea - Seleccione el tipo de línea nueva. Las opciones son UNIX (LF), DOS (CRLF) o MAC (CR).
  • Huso horario - Especifique el valor de huso horario de +14:00 a -14:00. Si los datos de salida de Composer tienen algún elemento de tipo de datos de fecha (time, dateTime o gMonth), el paso Composer convierte el tipo de datos de fecha de acuerdo con el huso horario especificado y añade los datos convertidos a los datos de salida de Composer. Si los datos de salida de Composer no contienen información de huso horario, entonces el huso horario que se especifica en el campo de texto se añade a los datos de salida de Composer.

    Puede seleccionar la opción Insertar parámetro para insertar parámetros que contengan el huso horario en tiempo de ejecución, en lugar de especificarlos en el momento del diseño.

  • Omitir atributos con valor predeterminado - Para los atributos que tienen valores predeterminados y están en los datos o para los atributos que tienen valores fijos, omita los valores de la salida XML.
  • Omitir elementos nulos - Para elementos nulos que no están en los datos, omita los elementos de la salida XML.
  • Omitir elementos vacíos opcionales - Si un nodo XML tiene un valor vacío, omita los elementos de la salida XML.