Propriétés des attributs d'objet métier

L'architecture d'un objet métier définit les différentes propriétés s'appliquant aux attributs. Cette section indique comment le connecteur interprète quelques-unes de ces propriétés et décrit la manière de les définir lors de la modification d'un objet métier.

Propriété de nom

Chaque attribut d'objet métier doit avoir un nom unique.

Propriété de type

Chaque attribut d'objet métier doit avoir un type, tel que Integer, String ou le type d'un objet métier enfant. Lorsque le connecteur rencontre un attribut de type Date, Long Text ou String, il insère la valeur entre guillemets puis la traite en tant que données de type caractères.

Propriété de cardinalité

Chaque attribut d'objet métier représentant un enfant ou un tableau d'objets métier enfant a la valeur 1 ou N respectivement. Tous les attributs représentant des objets métier enfant ont également une propriété ContainedObjectVersion (qui indique le numéro de version de l'enfant) et une propriété Relationship (qui indique la valeur du paramètre Containment).

Propriété de longueur maximale

Si l'attribut est de type String, ce type de propriété indique la longueur maximale autorisée pour la valeur de l'attribut.

Propriété de clé

Un attribut simple au minimum doit être spécifié dans chaque objet métier en tant que clé. Pour définir un attribut en tant que clé, affectez à cette propriété la valeur Yes. Si l'attribut d'objet métier est de type String, il est recommandé de définir des données de type Varchar plutôt que char dans la base de données.

Remarque :
Le connecteur ne prend pas en charge la spécification d'un attribut qui représente un objet métier enfant ou un tableau d'objets métier enfant en tant qu'attribut de clé.

Si la propriété de clé a la valeur true pour un attribut simple, le connecteur ajoute cet attribut à la clause WHERE des instructions SQL SELECT, UPDATE, RETRIEVE et DELETE générées lors du traitement de l'objet métier.

Si la propriété de clé a la valeur true pour un attribut dans un enfant qui stocke la relation parent-enfant dans l'enfant (de type cardinalité simple et multiple), le connecteur utilise les clés primaires du parent contenus dans la clause WHERE de l'instruction SELECT et n'utilise pas la propriété Key. Pour plus d'informations sur la spécification du nom des attributs d'objet métier dont les valeurs sont utilisées pour définir les attributs de clé étrangère de l'enfant, voir Informations spécifiques à l'application au niveau de l'attribut.

Propriété de clé étrangère

Le connecteur utilise cette propriété pour déterminer si un attribut est une clé étrangère.

Propriété obligatoire

La propriété Required indique si un attribut doit contenir une valeur.

Si cette propriété est spécifiée pour un attribut qui représente un objet métier de type cardinalité simple, le connecteur oblige l'objet métier parent à contenir un objet métier enfant pour cet attribut.

Lorsque le connecteur reçoit un objet métier avec une requête Create, le connecteur provoque l'échec de l'opération de création si les deux conditions suivantes sont réunies :

Lorsque le connecteur reçoit un objet métier avec une requête Retrieve et qu'un attribut requis de l'objet métier ne dispose d'aucune valeur correcte ou d'aucune valeur par défaut, le connecteur provoque l'échec de l'opération d'extraction.

Le connecteur n'utilise pas cette propriété pour les attributs contenant un tableau d'objets métier enfant.

Remarque :
Si l'attribut de clé utilise une séquence ou un compteur ou qu'il est renseigné par la base de données (UID=AUTO), il ne doit pas porter la valeur Required.

Propriété AppSpecificInfo

Pour plus d'informations sur cette propriété, voir Informations spécifiques à l'application au niveau de l'attribut.

Propriété de valeur par défaut

Cette propriété indique la valeur par défaut que le connecteur utilise pour renseigner un attribut simple s'il n'est pas renseigné par une valeur dans la table de la base de données. Le connecteur n'évalue pas cette propriété pour les attributs représentant un objet métier enfant ou un tableau d'objets métier enfant.

Le connecteur évalue cette propriété uniquement si la propriété de configuration UseDefaults a la valeur true. Pour plus d'informations, voir Tableau 6.

Valeur d'attribut spéciale

Les attributs simples contenus dans les objets métier peuvent avoir la valeur spéciale CxIgnore. Lorsqu'il reçoit un objet métier provenant du courtier d'intégration, le connecteur ignore tous les attributs dotés de la valeur CxIgnore. Il fait comme si ces attributs étaient invisibles.

Lorsque le connecteur extrait des données de la base de données et que l'instruction SELECT renvoie une valeur null pour un attribut, le connecteur affecte à cet attribut la valeur CxIgnore par défaut. Si une valeur a été spécifiée pour le paramètre UNVL des informations d'application de l'attribut, le connecteur utilise cette valeur pour représenter la valeur null.

Dans la mesure où le connecteur demande à ce que chaque objet métier dispose au minimum d'un attribut de clé primaire, les développeurs doivent veiller à ce que les objets métier WebSphere Business Integration Adapter transmis au connecteur disposent au minimum d'une clé primaire n'ayant pas la valeur CxIgnore. La seule exception à cette condition concerne un objet métier dont la clé primaire doit être générée par le connecteur à l'aide d'un compteur ou d'une séquence ou par la base de données.

Lorsque le connecteur insère des données dans la base de données et qu'un attribut d'objet métier ne dispose d'aucune valeur spécifiée, il utilise la valeur spécifiée par la propriété UseNullValue de l'attribut. Pour plus d'informations sur la propriété UseNullValue, voir UNVL=value dans Tableau 11.

Copyright IBM Corp. 1997, 2004