Mappage des éléments de données étendus vers des attributs de classe d'événement Enterprise Console

Chaque élément extendedDataElement dans une définition d'extension d'événement CBE est mappé dans la définition de classe d'événement Enterprise Console correspondante.

Le tableau 1 représente le mappage de extendedDataElement dans une définition d'extension d'événement CBE vers des attributs dans une définition de classe d'événement Enterprise Console.

Définition d'extension d'événement CBE

Définition de classe d'événement Enterprise Console

extendedDataElement.name

nom d'attribut

extendedDataElement.type

type d'attribut

extendedDataElement.defaultValue
extendedDataElement.defaultHexValue

apparence "par défaut" de l'attribut

extendedDataElement.minOccurs

Si la valeur est "0" (zéro), l'élément de données étendu n'est pas mappé vers la définition de classe d'événement Enterprise Console car tous les attributs sont requis par le serveur Enterprise Console.

extendedDataElement.maxOccurs

Ignoré : au cours de la conversion d'un événement au format CBE en événement au format Enterprise Console, seul le premier élément de données étendu répété est mappé.

extendedDataElement enfant

chaque élément enfant d'élément de données étendu est converti en un autre attribut dans la définition de classe d'événement Enterprise Console. Le processus est répété de manière récursive jusqu'à ce qu'il n'y ait plus de sous-éléments dans l'élément de données étendu. Pour plus d'informations sur le nom d'attribut qui en résulte dans la définition de classe d'événement Enterprise Console, reportez-vous à la section "Nom".

Tableau 1. Mappage d'éléments dans une définition d'événement CBE et d'attributs dans des définitions de classe d'événement Enterprise Console.


Les sections qui suivent expliquent en détail comment chaque attribut d'une définition d'événement CBE est mappé vers un attribut dans une définition de classe d'événement Enterprise Console :

Nom

extendedDataElement peut être imbriqué dans un autre extendedDataElement. Le nom de l'attribut qui en résulte dans la définition de classe d'événement est formé par la concaténation des noms de tous les éléments extendedDataElements du plus ancien jusqu'à l'élément en cours de mappage. Le caractère "." est utilisé comme séparateur.

Par exemple, la définition d'extension d'événement CBE

<eventDefinition name="Transaction"> parent="event";
    <extendedDataElement name="tx_number" type="string">
        <extendedDataElement name="tx_items" type="string">
            ...
        </extendedDataElement>
    </extendedDataElement>
</eventDefinition>

aboutit à la classe de définition d'événement Enterprise Console suivante :

TEC_CLASS :
    Transaction ISA EVENT
    DEFINES {
        tx_number: STRING;
        tx_number.tx_items: STRING;
        ...
    }
END
Remarques :
  1. Le nom de l'attribut qui en résulte peut avoir à être converti pour s'adapter à l'espace de caractères utilisé pour les noms d'attribut dans l'événement Enterprise Console.
  2. Une définition d'événement CBE sans l'attribut parent est toujours mappée vers une définition de classe d'événement avec EVENT comme sa surclasse.

Type

Le tableau 2 décrit comment le sous-champ "type" d'un élément de données étendu est mappé vers le type de données d'attribut dans la définition de classe d'événement Enterprise Console.

Définition d'extension d'événement CBE

Définition de classe d'événement Enterprise Console

  • noValue

L'élément extendedDataElement est entièrement ignoré

  • byte
  • short
  • int
  • long

INT32

  • float
  • double

REAL

  • string
  • dateTime
  • boolean
  • hexBinary

STRING

  • byteArray
  • shortArray
  • intArray
  • longArray

LIST_OF INT32

  • floatArray
  • doubleArray

LIST_OF REAL

  • stringArray
  • dateTimeArray
  • booleanArray

LIST_OF STRING

Tableau 2. Mappage des types d'élément de données étendu vers des types d'attribut Enterprise Console.

Valeur par défaut et valeur hexadécimale par défaut

Les valeurs par défaut d'une définition d'élément de données étendu sont mappées vers les valeurs par défaut de l'attribut correspondant dans la définition de classe d'événement Enterprise Console.

Par exemple, la définition d'extension d'événement CBE

<eventDefinition name="Transaction" parent="event">
    ...
    <extendedDataElement name="tx_type" type="string">
        <defaultValue>purchase</defaultValue>
    </extendedDataElement>
 
    <extendedDataElement name="tx_internal_code" type="long">
        <defaultValue>42</defaultValue>
    </extendedDataElement>

    <extendedDataElement name="tx_approvers" type="string">
        <defaultValue>employee_1</defaultValue>
        <defaultValue>employee_2</defaultValue>
    </extendedDataElement>

    <extendedDataElement name="tx_key" type="hexBinary">
        <defaultValue>CE908712AF</defaultValue>
    </extendedDataElement>

</eventDefinition>

aboutit à la classe de définition d'événement Enterprise Console suivante :

TEC_CLASS :
    Transaction ISA EVENT
    DEFINES {
        tx_type: STRING, default="purchase";
        tx_internal_code: INT32, default=42;
        tx_approvers: STRING, default=[employee_1, employee_2];
        tx_key: STRING , default=CE908712AF;
        ...
    };
END


Rubriques connexes
Mappage des attributs Common Base Event vers des attributs d'événement Enterprise Console