ItemSelection

Utilizzare questo elemento per selezionare un singolo dato nella struttura di COBOL.

Le regole di selezione si applicano come segue:

  • Quando viene selezionato un elemento, vengono selezionati automaticamente tutti gli elementi del gruppo parent che contengono l'elemento selezionato
  • Se un elemento selezionato contiene la clausola REDEFINES, questa deve essere specificata anche nell'elemento RedefineSelection per questa specifica di messaggio
  • Quando viene selezionato un elemento del gruppo, vengono selezionati automaticamente tutti i relativi elementi secondari (tutti gli elementi che contengono la clausola REDEFINES sono anch'essi soggetti alla regola precedente)
  • Quando viene selezionato un elemento ODO (ripetizione dimensione variabile), deve essere selezionato anche il suo oggetto ODO (variabile conteggio). Altrimenti i risultati prodotti dalle risorse generate non sono definiti
  • Gli elementi ItemSelection possono apparire in qualsiasi ordine all'interno di ItemSelectionArray
  • Il valore dell'attributo ItemSelection deve specificare il nome dell'elemento dati preceduto da nomi di gruppi principali separati da punti.
  • I valori degli attributi ItemSelection non sono sensibili al maiuscolo / minuscolo. Ad esempio, specificare itemName="FoO.bAr" equivale a specificare itemName="fOo.BaR"
  • Se nessuno degli elementi selezionati viene visualizzato nella struttura del linguaggio, i risultati prodotti dalle risorse generate non sono definiti.

Contenuto da

Contiene

Nessuna

Attributi

Campi Descrizione
Attributo: itemName
Valori validi: Vedere la Descrizione
Obbligatorio?:
Valore predefinito: Nessuno
Specifica il nome dell'elemento dati da selezionare.
Attributo facoltativo
Valori validi: yes | no
Obbligatorio?: No
Valore predefinito: Nessuno
Specifica se l'elemento dello schema XML generato da questo elemento è facoltativo. Se impostato su "yes", l'elemento dello schema XML corrispondente avrà un facet minOccurs generato e impostato su 0. Se questo attributo non viene specificato, il facet minOccurs non viene generato.

Il valore dell'attributo deve specificare il nome elemento qualificato da un nome parent separato da punti come mostrato nell'esempio.

Esempio

Per la seguente struttura linguistica COBOL

01 INPUT-MSG.
    02 IN-LL            PICTURE S9(3) COMP.
    02 IN-ZZ            PICTURE S9(3) COMP.
    02 IN-TRCD          PICTURE X(10).
    02 IN-CMD           PICTURE X(8).
    02 IN-NAME1         PICTURE X(10).
    02 redParent.
       03 redefd.
          04 IN-NAME2   PICTURE X(10).
       03 redefd2 redefines redefd.
          04 IN-NAME2R  PICTURE X(10).
    02 IN-EXTN          PICTURE X(10).
    02 IN-EXTNR redefines in-extn PICTURE X(10).
    02 IN-ZIP           PICTURE X(7).

È possibile specificare i seguenti elementi:


<ItemSelectionArray>
   <ItemSelection itemName="input-msg.redParent"/>
   <ItemSelection itemName="input-msg.in-extn"/>
   <ItemSelection itemName="input-msg.in-zip"/>
   <ItemSelection itemName="input-msg.in-ll"  optional="yes"/>
</ItemSelectionArray>
Nota: Per specificare la ridefinizione del 'redefd2 nel gruppo 'redParent, è necessario specificare il seguente 'RedefinesArray:

In caso contrario, gli elementi redefd vengono selezionati per impostazione predefinita.


<RedefinesArray>
   <RedefineSelection redefine="input-msg.redParent.redefd" 
            useRedefinition="input-msg.redParent.redefd2"/>
</RedefinesArray>