WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Conjuntos de mensajes: propiedades del conjunto de mensajes de formato físico XML

Las tablas siguientes definen las propiedades correspondientes al formato físico XML para el conjunto de mensajes.

Valores de espacio de nombres

Propiedad Tipo Significado
URI de espacio de nombres Serie Entre el nombre del espacio de nombres que está utilizando para el prefijo asociado.
Prefijo Serie Entre el prefijo para asociar los nombres de elemento y atributo con los que lo ha utilizado con el nombre de espacio de nombres.

Ubicaciones de esquemas de espacio de nombres

Propiedad Tipo Significado
URI de espacio de nombres Serie Entre el nombre del espacio de nombres que identifica el espacio de nombres que está utilizando.
Ubicación de esquema Serie Entre la ubicación del esquema para el nombre del espacio de nombres asociado que se utiliza para validar objetos en el espacio de nombres.

declaración XML

Propiedad Tipo Significado
Suprimir declaración XML Recuadro de selección Marque el recuadro de selección para suprimir la declaración XML. Si se selecciona, la declaración (por ejemplo, <?xml version='1.0'>) se suprime.

De forma predeterminado, este recuadro de selección está deseleccionado.

Versión XML Tipo enumerado Esto controla el valor de la versión en la declaración XML generada.

El valor predeterminado es 1.0.

Si establece Suprimir declaración XML en , esta propiedad se ignora.

Codificación XML Tipo enumerado Esto controla si se escribe un atributo de codificación en la declaración XML generada.

Si se selecciona Nulo, no se graba ningún atributo de codificación en la declaración XML del documento XML de salida.

Si se selecciona Como texto de documento, se generará un atributo de codificación que sea coherente con el texto del documento XML.

El valor predeterminado es Nulo.

Si el recuadro de selección Suprimir declaración XML está marcado, se hace caso omiso de esta propiedad.

Documento autónomo Tipo enumerado Seleccione , No o Nulo en la lista de valores. Si se selecciona Nulo, no habrá ninguna declaración autónoma en la declaración XML. Si selecciona o No, la declaración standalone = "yes" o standalone = "no" se añade a la declaración XML cuando se escribe el mensaje de salida. El valor predeterminado es Null.

El valor de esta propiedad no determina si se carga un subconjunto DTD externo; los subconjuntos DTD externos no se cargan nunca en este release.

Si el recuadro de selección Suprimir declaración XML está marcado, se hace caso omiso de esta propiedad.

Salida de declaraciones de espacio de nombres Tipo enumerado La propiedad Salida de declaraciones de espacio de nombres controla dónde se colocarán las declaraciones de espacio de nombres en el documento XML de salida. Seleccione una de estas opciones:
  • Al principio del documento. Las declaraciones para todas las entradas de la tabla Ubicaciones de esquemas de espacio de nombres anterior se emitirán como atributos del mensaje en el documento XML de salida. La desventaja de esta opción es que, en algunos casos, es posible que se emitan declaraciones innecesarias.
  • Si corresponde. Sólo se emitirán declaraciones cuando las necesite un elemento o atributo que esté en ese espacio de nombres. La desventaja de esta opción es que puede ser necesario emitir más de una vez la misma declaración de espacio de nombres en el documento XML de salida.

La opción predeterminada es Al principio del documento.

Esta propiedad sólo está activa si se han habilitado espacios de nombres para este conjunto de mensajes.

Valores de tipo de documento XML

Propiedad Tipo Significado
Suprimir DOCTYPE Recuadro de selección Si marca el recuadro de selección, se suprime la declaración DOCTYPE (DTD).

De forma predeterminada, este recuadro de selección está seleccionado.

ID de sistema DOCTYPE Serie Especifique el ID de sistema para el subconjunto DTD externo DOCTYPE (si DOCTYPE existe). Normalmente esto se establece en el nombre de la DTD generada (o importada) para un conjunto de mensajes.

Si se establece Suprimir DOCTYPE, esta propiedad se ignora y no se puede cambiar (el campo está inhabilitado). El valor predeterminado es www.mrmnames.net/ seguido del identificador de conjunto de mensajes.

ID público de DOCTYPE Serie Especifique el ID público para el subconjunto de DTD externo DOCTYPE (si existe DOCTYPE y se ha especificado ID de sistema).

Si se establece Suprimir DOCTYPE, esta propiedad se ignora y no se puede cambiar (el campo está inhabilitado). El valor predeterminado es el identificador de conjunto de mensajes.

Texto DOCTYPE Serie Utilice esta propiedad para añadir declaraciones DTD adicionales. El analizador XML no analiza esta propiedad y, por consiguiente, puede que no sea XML válido. Puede incluir definiciones de ENTITY o declaraciones DTD internas. Es una serie (de un máximo de 32 KB) en la que los caracteres de línea nueva y tabulador se sustituyen por \n y \t respectivamente.

El contenido no se analiza y aparece en el mensaje de salida. Si existe una DTD incorporada, el contenido de esta propiedad tiene prioridad.

Si ha establecido Suprimir DOCTYPE, esta propiedad se ignora y no se puede cambiar (el campo está inhabilitado).

Para obtener más información, consulte MRM XML: DTD incorporadas y la propiedad de texto DOCTYPE.

El valor predeterminado es un espacio vacío (no establecido).

Representación XML de valores booleanos

Propiedad Tipo Significado
Valor booleano true (verdadero) Serie Especifique la serie que se utiliza para codificar y reconocer valores booleanos (BOOLEAN) verdaderos. Cuando se analiza un documento XML, la serie 1 se acepta siempre como verdadera para un elemento BOOLEAN. Entre una serie de un máximo de 254 caracteres.

El valor predeterminado es true (verdadero). 1 también es válido.

Valor booleano false (falso) Serie Especifique la serie que se utiliza para codificar y reconocer valores BOOLEAN falsos. Cuando se analiza un documento XML, la serie 0 se acepta siempre como falsa para un elemento BOOLEAN. Entre una serie de un máximo de 254 caracteres.

El valor predeterminado es false (falso). 0 también es válido.

Representación XML de valores nulos

Propiedad Tipo Significado
Codificación de nulo numérico Tipo enumerado Especifique la codificación de nulos para los elementos XML numéricos. Esto proporciona un método para asignar un significado de nulo lógico a dichos elementos. Debe seleccionar uno de los valores siguientes de la lista que se muestra:
  • NULLEmpty. Si el valor del elemento es la serie vacía, el elemento es nulo. Éste es el valor predeterminado.
  • NULLValue. Si el valor del elemento coincide con el proporcionado por la propiedad asociada Valor de codificación de nulo numérico, el elemento es nulo.
  • NULLXMLSchema. Si el elemento contiene un atributo xsi:nil que se evalúa como cierto, el elemento es nulo.
  • NULLValueAttribute. Esta opción sólo es válida para los elementos que tienen la propiedad Formato físico XML Devolver establecida en XMLElementAttrVal o en XMLElementAttrIDVal. Consulte el apartado Conjuntos de mensajes: opciones de manejo de nulos XML para obtener información detallada.
  • NULLAttribute (obsoleto). Si el elemento contiene un atributo con un nombre que coincide con el proporcionado por la propiedad asociada Valor de codificación de nulo numérico y el atributo se evalúa como cierto, el elemento es nulo.
  • NULLElement (obsoleto). Si el elemento contiene un elemento hijo con un nombre que coincide con el proporcionado por la propiedad Valor de codificación de nulo numérico, el elemento es nulo.
Consulte el apartado Conjuntos de mensajes: opciones de manejo de nulos XML para obtener información detallada completa.
Valor de codificación de nulo numérico Serie Especifique el valor para calificar la propiedad Codificación de nulo numérico, si la ha establecido en NULLValue, NULLAttribute o NULLElement. Para obtener más información, consulte Conjuntos de mensajes: opciones de manejo de nulos XML.
Codificación de nulo no numérico Tipo enumerado Especifique la codificación de nulos para los elementos XML no numéricos. Esto proporciona un método para asignar un significado de nulo lógico a dichos elementos. Las opciones son idénticas a las disponibles para la propiedad Codificación de nulo numérico.
Valor de codificación de nulo no numérico Serie Especifique el valor para calificar la propiedad Codificación de nulo no numérico. Para obtener más información, consulte Conjuntos de mensajes: opciones de manejo de nulos XML.

Valores de fecha y hora

Propiedad Tipo Significado
Derivar formato de fecha y hora predeterminado de tipo lógico Botón Seleccione esta opción si desea que el formato de fecha y hora predeterminado se determine mediante el tipo lógico del elemento o atributo.

Puede alterar temporalmente esta propiedad para un elemento o atributo de un tipo complejo.

Utilizar formato de fecha y hora predeterminado Botón y serie Seleccione esta opción si desea especificar un formato de fecha y hora predeterminado que sea fijo para todos los elementos o atributos de un tipo lógico dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay y gDay.

Puede alterar temporalmente esta propiedad para un elemento o atributo de un tipo complejo.

Para obtener más información, consulte Conjuntos de mensajes: formatos de fecha y hora.

Principio de siglo para años de 2 dígitos Entero Esta propiedad determina cómo se interpretan los años de dos dígitos. Especifique los dos dígitos que empiezan un periodo de 100 años que contiene el año actual. Por ejemplo, si especifica 89 y el año actual es 2002, todas las fechas de dos dígitos se interpretarán como pertenecientes al rango de 1989 y 2088.
Días de la primera semana del año Tipo enumerado Especifique el número de días del año nuevo que deben estar en la primera semana.

El inicio de un año suele estar en medio de una semana. Si el número de días de dicha semana es menor que el valor especificado aquí, se considera que la semana es la última semana del año anterior; de este modo la semana 1 empieza en unos días que están en el año nuevo. De lo contrario, se considera la primera semana del año nuevo; de este modo la semana 1 empieza unos días antes del inicio del año nuevo.

Seleccione Utilizar entorno local del intermediario, que hace que el intermediario obtenga la información de la plataforma subyacente, o seleccione un número en la lista.

Primera día de la semana Tipo enumerado Especifique el día en que empieza cada semana nueva.

Seleccione Utilizar entorno local del intermediario, que hace que el intermediario obtenga la información de la plataforma subyacente, o seleccione un valor en la lista.

Comprobación estricta de fecha y hora Recuadro de selección Seleccione esta opción si desea restringir las fechas y horas a un formato de fecha y hora válido. Si se selecciona Comprobación estricta de fecha y hora, se producirá un error cuando se reciba una fecha y hora incorrectas.
Comprobación estricta de fecha y hora
Ejemplos de comprobación estricta de fecha y hora:
  • Las fechas y horas se limitarán a valores de fecha y hora válidos. Cuando utilice esta opción, una fecha como por ejemplo, el 35 de marzo no se procesará como el 4 de abril y 10:79 no se procesará como 11:19. Si se recibe una fecha y hora fuera de banda como las de estos ejemplo, se generará un error.
  • El número de caracteres de un componente de fecha y hora numérico debe estar entre los límites de los símbolos de formato correspondientes. Repita el símbolo para especificar el número mínimo de dígitos que se necesitan. El número máximo de dígitos que se permite se convierte en el umbral superior de un símbolo determinado. Por ejemplo, día del mes tiene un límite superior de 41; por consiguiente, una serie de formato de 'd' permite analizar los valores 2 y 21, pero no permite los valores 32 y 210. En la salida, los números se rellenan con ceros hasta alcanzar la longitud especificada. Un año es un caso especial; vea la propiedad del conjunto de mensajes Principio de siglo para años de 2 dígitos. La longitud de las fracciones de segundos debe coincidir implícitamente con le número de símbolos de formato de la entrada. La salida se redondea hasta la longitud especificada.
  • No se ignoran los espacios en blanco. El espacio en blanco de la serie de entrada se debe corresponder con el mismo número y posición del espacio en blanco de la serie del formato.
  • Si quedan datos por analizar en la serie de entrada cuando todos los símbolos de la serie del formato ya se han hecho coincidir, se generará un error.
Comprobación de fecha y hora flexibles.
Ejemplos de comprobación flexible de fecha y hora:
  • El analizador convertirá los valores de fecha y hora que estén fuera de banda a los valores de banda adecuados. Por ejemplo, una fecha 2005-05-32 se convertirá a 2005-06-01.
  • La salida de fecha y hora siempre se adhiere al recuento del símbolo. Por ejemplo, una serie con el formato aaaa-MM-dd (donde '-' es el separador de campos) permite analizar uno o más caracteres en MM y dd. Por consiguiente, se pueden entrar fechas que no son válidas; por ejemplo, 2005-1-123 y 2005-011-12. La salida del primer valor de 2005-1-123 será la fecha 2005-05-03 y la salida del segundo valor 2005-011-12 será la fecha 2005-11-12.
  • El número de símbolos de formato de huso horario Z se aplica sólo al formato de fecha y hora de salida.
  • Se ignoran los espacios en blanco.
Huso horario Tipo enumerado Se utilizará el valor que establezca para esta propiedad si el valor que ha especificado para la propiedad Formato de fecha y hora predeterminado no incluye información de huso horario.

El valor inicial es Utilizar entorno local del intermediario que hace que el intermediario obtenga la información de la plataforma subyacente.

Puede cambiar esta propiedad seleccionado un valor de la lista de valores.

Horario de verano Recuadro de selección Seleccione esta opción si el área de la propiedad Huso horario cumple con el horario de verano. Si no cumple con el horario de verano, no se deberá seleccionar esta opción.

Por ejemplo, si se selecciona un área en Huso horario y no se selecciona esta opción, el valor pasado representa el huso horario sin horario de verano.

Utilizar formato UTC de entrada en la salida Recuadro de selección La propiedad se aplica a los elementos y atributos de tipo lógico xsd:dateTime o xsd:time que tienen un formato de fecha y hora de I, IU, T, o TU, o que incluyen ZZZ o ZZZU.

Estos elementos y atributos pueden especificar la hora UTC (Coordinated Universal Time) utilizando el carácter Z o el huso horario +00:00 en el valor. En la entrada, el analizador MRM recuerda el modo en que se ha especificado UTC.

Si se selecciona esta propiedad y se copia el elemento o atributo en un mensaje de salida, entonces se conservará el formato UTC en el mensaje de salida y se alterará temporalmente el implícito en la propiedad de formato de fecha y hora.

Si no se selecciona esta propiedad o no se copia el elemento o atributo en un mensaje de salida, entonces se conservará el formato UTC en el mensaje de salida se controlará únicamente mediante la propiedad de formato de fecha y hora.

valores xsi:type

Propiedad Tipo Significado
Política de salida para los atributos xsi:type Tipo enumerado

Cuando escriba documentos XML, utilice esta propiedad para especificar las circunstancias bajo las que se generarán el atributo xsi:type de los elementos como salida.

Nunca
No genere atributos xsi:type de salida para los elementos, incluso si aparecen atributos xsi:type en el árbol de mensaje.
Cuando estén presentes
Genere atributos xsi:type de salida para los elementos sólo cuando aparezcan los atributos xsi:type en el árbol de mensaje. Este valor es el valor predeterminado.
Siempre (sólo para elementos simples)
Asegúrese de que todos los elementos simples se generen con un atributo xsi:type. Si hay un elemento simple que ya tiene un atributo xsi:type en el árbol de mensajes, se utilizará éste; de lo contrario, se generará un atributo xsi:type utilizando las reglas de la tabla siguiente.
Siempre (Todos los elementos)
Asegúrese de que todos los elementos se generen con un atributo xsi:type si es posible. Si ya hay un elemento que tiene un atributo xsi:type en el árbol de mensajes, se utilizará éste; de lo contrario, se generará un atributo xsi:type utilizando las reglas de la tabla siguiente.
Siga las normas de codificación SOAP
Siga el mismo comportamiento que en Siempre (sólo elementos simples). Adicionalmente, genere un atributo de tipo de codificación SOAP en el código raíz de todos los mensajes.

Si se debe generar un atributo xsi:type como salida, pero no aparece en el árbol de mensajes, el valor se genera como se describe en la tabla siguiente.

Tipo de elemento Valor generado cuando se define un elemento en el modelo Valor generado cuando un elemento se define automáticamente
Tipo simple

Si el tipo es global o es un tipo incorporado, utilícelo.

Si el tipo es local, utilice el tipo global o incorporado del que está derivado.

Utilice el tipo incorporado que mejor se ajuste al tipo de datos del elemento del árbol de mensaje.
Tipo complejo con contenido simple

Si el tipo es global, utilícelo.

Si el tipo es local, utilice el tipo global o incorporado del que está derivado.

Utilice el tipo incorporado que mejor se ajuste al tipo de datos del elemento del árbol de mensaje.
Tipo complejo con contenido complejo

Si el tipo es global, utilícelo.

Si el tipo es local, no se genera ningún atributo xsi:type.

No se genera ningún atributo xsi:type.

En desuso

Nota: Las propiedades siguientes se utilizan para controlar el comportamiento del analizador MRM; no deben cambiarse sus valores predeterminados. Estas propiedades se retirarán en un release futuro.
Propiedad Tipo Significado
Nombre de código raíz Serie Especifique el nombre del código raíz de conjunto de mensajes. Puede dejar en blanco esta propiedad, en cuyo caso no se utilizan códigos de wrapper para los mensajes (es decir, el código de mensaje es la raíz del documento). El nombre puede ir seguido de un espacio y texto adicional para que los pares de atributo/valor aparezcan con el código raíz.

El valor predeterminado está en blanco.

Suprimir comentario de indicación de la hora Recuadro de selección Si se selecciona, se suprime la serie de comentario de indicación de la hora en la salida XML.

Si no se selecciona, el comentario no se suprime y se incluye un comentario con el formato <!--Salida XML generada por MRM el: Mié 23 abr 09:34:42 20022002--> en el mensaje de salida.

El valor predeterminado es seleccionar este recuadro de selección.

Habilitar soporte de versiones Recuadro de selección Si se selecciona, se habilita el soporte de versiones. Esta propiedad especifica si las definiciones de espacio de nombres XML se codifican para el código raíz del mensaje, junto con los calificadores de espacio de nombres para los elementos que no pertenecen al espacio de nombres predeterminado. Estas definiciones de espacio de nombres se utilizan para representar la información de dependencia de conjunto de mensajes, que se utiliza para soportar el intercambio de mensajes entre aplicaciones que están basadas en personalizaciones diferentes del mismo conjunto de mensajes.

El valor predeterminado es seleccionar este recuadro de selección, por compatibilidad con los mensajes XML de MRM de releases anteriores. Si no utilizó mensajes XML de MRM en releases anteriores, asegúrese de que este recuadro de selección no esté seleccionado.

Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 16:59:12


Tema de referenciaTema de referencia | Versión 8.0.0.5 | ad09260_