Onglet Options avancées

Modifier en ligne

L'onglet Options avancées vous permet de spécifier des propriétés de définition de schéma XML (cet onglet concerne exclusivement la transformation XML)

Cet onglet contient les zones suivantes:

Dans le groupe Spécifier les options de génération de schéma XML :
Générer une hiérarchie minimale dans les schémas XML
Cette case à cocher contrôle le format de message du schéma XML généré et, par conséquent, l'analyse syntaxique et la génération de XML dans les convertisseurs XML. Les convertisseurs XML basés sur des schémas XML ayant des hiérarchies réduites ont tendance à avoir de meilleures performances.
- Cochez cette case si vous souhaitez que les convertisseurs XML soient générés de manière à utiliser une hiérarchie de structure XML réduite, lorsqu'une hiérarchie de structure plus détaillée n'est pas nécessaire pour identifier de manière unique chaque élément de la structure.
  Lorsqu'il existe des éléments ayant le même nom de balise, le nom de l'élément qui apparaît plus tard dans le document est préfixé avec autant de balises parent que nécessaire et génère un nom unique. Cette méthode augmente l'efficacité des clients de traitement de messages et réduit le nombre et la complexité des objets à instancier.
- Décochez cette case si vous souhaitez que l'assistant génère un schéma XML qui représente la hiérarchie complète de la structure de langage.
Générer des groupes dans les schémas XML
Cette case à cocher détermine si le convertisseur XML inclut des groupes dans les schémas XML générés:
- Cochez cette case si vous souhaitez que le convertisseur XML inclue des groupes dans les schémas XML générés.
- Décochez cette case si vous souhaitez que le convertisseur XML inclue le groupe "contents" en ligne au lieu d'utiliser des références de groupe. Cette option est utile pour les applications qui ne prennent pas en charge l'utilisation de groupes et de références de groupe dans les schémas XML.
Générer des noms de type complexe abrégés

La méthode normale pour générer un nom de type complexe consiste à concaténer le nom du groupe aux noms de tous les parents du groupe, avec un trait de soulignement "_" après chaque nom sauf le dernier.

Toutefois, si cette case est cochée, un nom de type complexe est généré en prenant uniquement le nom du groupe.
Par exemple, dans ce groupe COBOL :
```
01 ServiceRequest.
  02  CommonHeader.
    05  HeaderType1.
      10  Element1        PIC X(10).
```
Le nom de type XML complexe de l'élément HeaderType1 est:
- servicerequest_commonheader_headertype1 si la case n'est pas cochée.
- HeaderType1 si la case est cochée.
Le raccourcissement des noms de type complexe permet de générer un code client plus compact (généralement du code de classe Java™ ) à partir des fichiers WSDL et XSD contenant les types XML complexes.

La définition de cette case à cocher n'a aucun effet sur les scénarios descendant ou intermédiaire.
Lors de la tentative de raccourcissement d'un nom de type complexe, une collision est possible si le nom abrégé du type existe déjà à la suite d'un type défini précédemment pour un groupe ayant un nom identique mais des noms de groupe parent différents. Par exemple, dans la structure suivante COBOL :
```
01  ServiceRequest.
  02  CommonHeader.
    05  HeaderType.
      10  Element          PIC X(10).
  02  SpecificHeader.
    05  HeaderType.
      10  Element          PIC X(10).
```
Le nom de type du groupe HeaderType sous SpecificHeader entre en conflit avec le nom de type du groupe HeaderType sous CommonHeader.
En cas de collision, tous les noms de collision conservent les noms de type longs d'origine. Ainsi, dans cet exemple, les noms de type obtenus sont les suivants:
- servicerequest_commonheader_headertype et
- servicerequest_specificheader_headertype.
Le nom abrégé d'un type complexe est formé en prenant le nom de l'élément XML qui possède ce type, ainsi que certaines modifications possibles. Les règles de formation des noms abrégés sont les suivantes:
1. Prenez le nom de l'élément XML ayant le type (tel que HeaderType1).
2. Si le nom commence par un caractère non valide pour les noms Java (par exemple, un chiffre), il est précédé d'un double trait de soulignement "__".
3. Si un trait d'union "-" est présent dans le nom du groupe original COBOL, il est remplacé par un simple trait de soulignement "_".
4. La casse du nom de groupe est conservée.
Par exemple, le groupe suivant:
```
03 2-In--B.
   04 var2 blank zero pic 999.99.
```
se traduit par le nom de type complexe abrégé __2_In__B.
Générer les commentaires en XSD

Cochez cette case pour que les commentaires du fichier de code source COBOL soient générés en tant que documentation d'annotation dans les fichiers XSD et WSDL générés (voir Inclure les commentaires du code source COBOL dans les fichiers XSD et WSDL générés )

Cette option s'applique uniquement au scénario de développement ascendant pour la génération d'un service Web et s'applique uniquement si vous spécifiez la conversion XML compilée.

Générer des éléments qualifiés dans des schémas XML

Cochez cette case pour déterminer la valeur de l'attribut elementFormQualified dans les schémas XML générés par l'outil.
Remarque: Cette option affecte uniquement le type de conversion "Conversion XML compilée".
Dans le groupe Specify XML language structure converter behavior :

Valider le nom de l'espace de nom cible de l'élément XML racine

Cochez cette case pour activer la validation de l'espace de nom cible de l'élément racine dans les documents XML. L'espace de nom cible de l'élément racine se trouve dans le schéma XML qui le définit.

Initialiser les membres de structure de langage avant la conversion XML

Sélectionnez l'option permettant d'initialiser tous les éléments de données numériques et non numériques à des zéros et des espaces respectivement avant que XML ne soit converti dans la structure de langage.

Utiliser des littéraux VALUE pour initialiser les éléments de données omis

Cochez cette case pour activer l'initialisation des éléments de données de la structure linguistique que vous avez exclus de la structure de données d'entrée de la transformation XML (voir Initialisation des éléments de données dans la structure de données d'entrée de l'application COBOL ).

Cette option s'applique uniquement au scénario de développement ascendant pour la génération d'une transformation XML et s'applique uniquement si vous spécifiez la conversion XML compilée.

Utiliser des littéraux VALUE pour initialiser les éléments de données vides

Cochez cette case pour activer l'initialisation des éléments de données de la structure linguistique que vous avez inclus dans la structure de données d'entrée de la transformation XML (voir Initialisation des éléments de données dans la structure de données d'entrée de l'application COBOL ).

Cette option s'applique uniquement au scénario ascendant pour la génération d'une transformation XML et s'applique uniquement si vous spécifiez la conversion XML compilée.
Dans le groupe Specify language structure to XML converter behavior :
Données de langage :
Cette option contrôle la manière dont le programme de conversion XML en cours d'exécution traite les caractères des données COBOL qui sont illégaux dans la spécification XML 1.0 :
- Sélectionnez Filtrer les caractères non autorisés dans XML 1.0 si vous souhaitez que le programme de conversion analyse les données non numériques et numériques dans la structure de langage et convertisse tout caractère non autorisé dans la spécification XML 1.0 en espace EBCDIC, ASCII ou UNICODE (en fonction de la page de codes).
- Sélectionnez Halt on characters ??? in XML 1.0 si vous souhaitez que le programme de conversion analyse les données non numériques et numériques dans la structure de langage et génère une exception si des caractères non autorisés dans XML 1.0 sont détectés.
- Sélectionnez Ne pas rechercher les caractères non autorisés si vous souhaitez que le programme de conversion ne recherche pas les caractères non autorisés dans la spécification XML 1.0 .
Pour plus d'informations, voir Options de gestion des caractères XML illégaux.