La pestaña Opciones avanzadas permite especificar las
propiedades de generación del esquema XML, el comportamiento del conversor XML de
petición y respuesta y las preferencias relacionadas con el compilador.
Esta pestaña contiene los campos siguientes:
En el grupo Especificar propiedades de generación de esquema XML:
- Generar jerarquía mínima en esquemas XML
- Este recuadro de selección controla el formato de mensaje del
esquema XML generado y, en consecuencia, el análisis y la generación de XML en los
conversores XML. Los conversores XML basados en esquemas XML que tienen jerarquías minimizadas tienden a ofrecer un
mejor rendimiento.
- Seleccione este recuadro de selección si desea que los conversores
XML se generen de forma que utilicen una jerarquía de estructuras XML reducida, en los
casos en los que no sea necesaria una jerarquía de estructuras detallada para identificar
de forma exclusiva cada elemento de la estructura.
Cuando existan elementos con el mismo nombre
de código, el nombre del elemento que aparezca más tarde en el documento se prefijará con los
suficientes códigos padre para producir un nombre exclusivo.
Este método aumenta la eficacia de
los clientes de proceso de mensajes, al reducir el número y la complejidad de objetos de los que
deben crearse instancias.
- Deseleccione este recuadro de selección si desea que el asistente genere un
esquema XML que represente la jerarquía completa de la estructura de lenguaje.
- Generar grupos en esquemas XML
- Este recuadro de
selección controla si el conversor XML debe incluir grupos en los esquemas XML
generados:
- Seleccione este recuadro de selección si desea que el
conversor XML incluya grupos en los esquemas XML generados.
- Quite la marca del recuadro de
selección si desea que el conversor XML incluya "contenido" de grupos en
línea en lugar de utilizar referencias de grupo. Esta opción es útil para aplicaciones
que no dan soporte a la utilización de grupos y referencias de grupo en esquemas XML.
- Generar nombres de tipo complejo cortos
- El método normal para generar un nombre de tipo complejo es concatenar el nombre del
grupo con los nombres de todos los padres del grupo, con un carácter de subrayado
"_" después de cada nombre, excepto del último.
- No obstante, si se marca este recuadro de selección, se genera un nombre de tipo
complejo a partir sólo del nombre del grupo.
- Por ejemplo, en este grupo COBOL:
01 ServiceRequest.
02 CommonHeader.
05 HeaderType1.
10 Element1 PIC X(10).
El nombre de tipo XML
complejo del elemento
HeaderType1 es:- servicerequest_commonheader_headertype1
si el recuadro de selección no está seleccionado.
- HeaderType1 si el
recuadro de selección está seleccionado.
- La abreviación de los nombres de tipos complejos permite la generación de un código
de cliente más compacto (generalmente código de clase Java™) a partir de los archivos
WSDL y XSD que contienen los tipos XML complejos.
- El hecho de marcar el recuadro de selección no tiene ningún efecto en escenarios
descendentes o de encuentro en el medio.
- Al
intentar abreviar un nombre de tipo complejo, es posible que se produzca una
colisión si el nombre corto del tipo ya existe como resultado de un tipo definido
anteriormente para un grupo con idéntico nombre pero nombres de grupos padre
diferentes. Por ejemplo, en la siguiente estructura COBOL:
01 ServiceRequest.
02 CommonHeader.
05 HeaderType.
10 Element PIC X(10).
02 SpecificHeader.
05 HeaderType.
10 Element PIC X(10).
el nombre de tipo del
grupo HeaderType bajo SpecificHeader entra en conflicto con el nombre
de tipo del grupo HeaderType bajo CommonHeader.
- En caso de conflicto, todos los nombres en conflicto conservan los nombres de tipo largo
originales. Por lo tanto, en este ejemplo, los nombres de tipo resultantes son:
- servicerequest_commonheader_headertype
y
- servicerequest_specificheader_headertype.
- El nombre corto de un tipo complejo se forma tomando el nombre del elemento XML
que tiene ese tipo, más algunas modificaciones posibles.
Las normas para formar
nombres cortos son:
- Partimos del nombre del elemento XML que tiene el tipo (por ejemplo,
HeaderType1).
- Si el nombre empieza por un carácter que no es válido para
nombres Java (por ejemplo,
un dígito), se le añadirá el prefijo de un doble subrayado
"__".
- Si hay un guión "-" en el nombre de grupo COBOL original, se sustituirá
por un subrayado simple "-" .
- Las
mayúsculas/minúsculas del nombre de grupo se conservarán.
- Por ejemplo, el siguiente grupo:
03 2-In--B.
04 var2 blank zero pic 999.99.
genera el nombre de tipo complejo
abreviado
__2_In__B.
- Generar comentarios en XSD
- Seleccione este recuadro de selección para hacer que los comentarios del
archivo de código fuente COBOL se generen como documentación de anotación en los archivos
XSD y WSDL generados (consulte la sección Incluir comentarios de código fuente COBOL en archivos XSD y WSDL generados)
- Esta opción se aplica solo al escenario de desarrollo ascendente para generar
un servicio Web y se aplica solo si especifica Conversión XML compilada.
- Generar elementos XML calificados en esquemas XML
- Este recuadro de selección permite la generación de elementos XML calificados
en los esquemas XML.
Esto permite la opción de solicitar que todos los elementos XML
estén cualificados con un espacio de nombres y tengan soporte para la generación de esquemas
XML que se puedan incluir en otros esquemas con menos oportunidad de colisión
de espacio de nombres.
En el grupo Especificar comportamiento del conversor de XML a estructura de lenguaje:
- Validar el espacio de nombres de destino del elemento XML raíz
- Seleccione este recuadro de selección para habilitar la validación
del espacio de nombres destino del elemento raíz en documentos XML. El espacio de nombres
destino del elemento raíz se puede encontrar en el esquema XML que lo define.
- Inicializar miembros de la estructura de lenguaje antes de la conversión XML
- Seleccione la opción para inicializar todos los elementos de datos
numéricos y no numéricos en ceros y espacios, respectivamente, antes de convertir XML en
la estructura de lenguaje.
- Utilizar literales VALUE para inicializar los elementos de datos omitidos
- Marque este recuadro de selección para habilitar la inicialización de los elementos
de datos de la estructura de lenguaje de petición que ha excluido de la estructura
de datos de entrada del servicio Web (consulte la sección
Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL ).
- Esta opción se aplica solo al escenario de desarrollo ascendente para generar
un servicio Web y se aplica solo si especifica Conversión XML compilada.
- Utilizar literales VALUE para inicializar los elementos de datos vacíos
- Marque este recuadro de selección para habilitar la inicialización de los elementos
de datos de la estructura de lenguaje de respuesta que ha incluido en la
estructura de datos de entrada del servicio Web (consulte la sección
Inicialización de elementos de datos en la estructura de datos de entrada de la aplicación COBOL ).
- Esta opción se aplica solo al escenario ascendente para generar un servicio Web y se
aplica solo si especifica Conversión XML compilada.
En el grupo Especificar comportamiento del conversor de estructura de
lenguaje a XML:
- Datos de lenguaje
- Esta opción controla cómo el programa de conversión XML de tiempo de ejecución de
respuesta maneja los caracteres de los datos COBOL de respuesta que no están permitidos
en la especificación XML 1.0:
- Seleccione Filtrar caracteres no permitidos en XML 1.0 si
desea que el programa de conversión explore los datos no numéricos y numéricos de la
estructura de lenguaje y convierta los caracteres que no están permitidos en la
especificación XML 1.0 a un espacio EBCDIC, ASCII o UNICODE (según la página de códigos
de respuesta).
- Seleccione Detener en
caracteres ilegales en XML 1.0 si desea explorar datos tanto numéricos
como no numéricos de la estructura de lenguaje y generar una excepción si se
encuentran caracteres ilegales XML 1.0.
- Seleccione No comprobar caracteres ilegales si
desea que el programa de conversión no compruebe si hay caracteres no permitidos en la
especificación XML 1.0.
Para obtener más información, consulte la
sección Diagnósticos de conversor XML.