Gestion des documents contenant des pièces jointes

WebSphere Partner Gateway fournit le gestionnaire de données de pièces jointes pour traiter les documents qui sont envoyés de WebSphere Partner Gateway à InterChange Server. Le gestionnaire de données de pièces jointes convertit un document dans l'enveloppe de transfert XML (contenant ou non des pièces jointes) du format sérialisé en représentation d'objet métier associée. Vous devez configurer le gestionnaire de données de pièces jointes sous forme de gestionnaire de données utiles dans l'un des cas suivants :

Le gestionnaire de données de pièces jointes est appelé par un adaptateur WebSphere Business Integration.

Lorsque l'adaptateur reçoit un document dans une enveloppe de transfert XML, il appelle le gestionnaire de données de pièces jointes pour convertir le document en représentation d'objet métier appropriée. Par exemple, la figure 22, présente le composant Adapter for JMS qui appelle le gestionnaire de données de pièces jointes pour convertir le format sérialisé du document en représentation d'objet métier correspondante. A l'inverse, lorsque l'adaptateur reçoit une représentation d'objet métier pour un document dans une enveloppe de transfert XML, il appelle le gestionnaire de données de pièces jointes pour convertir la structure d'objet métier au format de document approprié. Par exemple, la figure 23, présente le composant Adapter for JMS qui appelle le gestionnaire de données de pièces jointes pour convertir la représentation d'objet métier du document au format sérialisé.

Cette section contient des informations relatives au gestionnaire de données de pièces jointes :

Exécution de la conversion par le gestionnaire de données de pièces jointes

Le gestionnaire de données de pièces jointes peut interpréter la structure de l'enveloppe de transfert XML et traiter la conversion entre les données qu'elle contient et la représentation d'objet métier correspondante, en procédant comme suit :

Conversion de documents en objets métier

Avant que WebSphere Partner Gateway envoie un document à InterChange Server, il doit déterminer si le contenu doit ou non être encapsulé dans une enveloppe de transfert XML. Si WebSphere Partner Gateway crée l'enveloppe de transfert, les données utiles et toutes les pièces jointes sont codées au format Base64. WebSphere Partner Gateway envoie ensuite l'enveloppe de transfert XML à l'adaptateur approprié à l'aide des en-têtes de niveau de transfert correspondants. Cet adaptateur peut être configuré pour appeler le gestionnaire de données de pièces jointes afin qu'il traite la conversion des données utiles et de toutes les pièces jointes d'un document encapsulé XML en représentation d'objet métier correspondante.

Pour convertir un document encapsulé dans une enveloppe de transfert XML en représentation d'objet métier correspondante, l'entité appelante instancie le gestionnaire de données de pièces jointes afin de lui transmettre le document (dans son enveloppe de transfert). Le gestionnaire de données de pièces jointes effectue ensuite les opérations suivantes :

  1. Il charge les mappes de type de contenu définies dans le métaobjet enfant du gestionnaire de données.

    Les mappes de type de contenu sont définies dans les propriétés de configuration ContentTypeMap_x du métaobjet enfant. Le métaobjet enfant est un objet métier qui contient des informations de configuration destinées au gestionnaire de données de pièces jointes. Les attributs de cet objet métier associent des mappes de type de contenu à des types de contenu. Pour plus d'informations, voir Création du métaobjet enfant de pièces jointes.

  2. Il vérifie le document pour savoir s'il est encapsulé dans une enveloppe de transfert XML.
  3. Il définit l'objet métier de données utiles résultant et renvoie cet objet métier à l'entité appelante.
Traitement des documents sans enveloppe de transfert

Si le gestionnaire de données de pièces jointes détermine que le document n'est PAS contenu dans une enveloppe de transfert XML, il n'a pas besoin d'extraire les données utiles de cette structure d'enveloppe. Par conséquent, le gestionnaire de données utilise la propriété de configuration PayloadDataHandlerMimeType (définie dans son métaobjet) pour obtenir le type MIME qui identifie le gestionnaire de données utiles par défaut à instancier pour les données utiles du document. Ce gestionnaire de données convertit les données utiles en objet métier de données utiles correspondant et renvoie l'objet métier de données utiles résultant à son entité appelante.

Traitement des documents avec enveloppe de transfert

Si le gestionnaire de données de pièces jointes détermine que le document est contenu dans une enveloppe de transfert XML, il doit extraire les données utiles et toutes les pièces jointes de cette structure d'enveloppe avant de les traiter. Par conséquent, le gestionnaire de données effectue les opérations suivantes pour traiter et convertir le document :

  1. Il extrait les données utiles et toutes les pièces jointes de l'enveloppe de transfert et décode les données utiles.

    Les données utiles sont contenues dans la balise XML <payload>. Chaque pièce jointe est contenue dans une balise XML <attachment>.

  2. Il recherche les mappes d'un type de contenu qui correspond à celui des données utiles.

    Il utilise le type MIME spécifié dans la mappe de type de contenu correspondant pour créer une instance d'un gestionnaire de données. Ce dernier convertit les données utiles en objet métier de données utiles correspondant et renvoie l'objet métier résultant au gestionnaire de données de pièces jointes.

  3. Il crée l'objet métier d'informations de contenu pour les données utiles.

    Le gestionnaire de données de pièces jointes vérifie les informations spécifiques à l'application de niveau objet métier de la définition d'objet métier de données utiles et détermine le nom de l'objet métier d'informations de contenu dont le nom d'attribut est spécifié par la balise cw_mo_bcg_content_info. Il crée une instance de cet objet métier d'informations de contenu et définit les valeurs du type de contenu et du codage des données utiles.

  4. Il crée l'objet métier conteneur de pièces jointes pour les données utiles.

    Le gestionnaire de données de pièces jointes vérifie les informations spécifiques à l'application de l'objet métier de données utiles et détermine le nom de l'objet métier conteneur de pièces jointes dont le nom d'attribut est spécifié par la balise cw_mo_bcg_attachment. Il crée une instance de l'objet métier conteneur de pièces jointes et le sauvegarde dans l'attribut approprié de l'objet métier de données utiles.

    Si la balise cw_mo_bcg_attachment n'existe pas (ou qu'elle est vide), on part du principe que le document ne contient pas de pièces jointes. Aucune autre étape de traitement n'est donc requise. Le gestionnaire de données de pièces jointes renvoie l'objet métier de données utiles converti.

  5. Il crée l'objet métier de pièces jointes par défaut pour le conteneur de pièces jointes.

    Le gestionnaire de données de pièces jointes vérifie les informations spécifiques à l'application de l'objet métier conteneur de pièces jointes et détermine le nom de l'objet métier de pièces jointes par défaut dont le nom d'attribut est spécifié par la balise cw_mo_bcg_default_attribute. Il crée une instance de l'objet métier de pièces jointes par défaut et le sauvegarde dans l'attribut approprié de l'objet métier conteneur de pièces jointes.

  6. Il détermine si la pièce jointe doit être convertie en objet métier, en recherchant dans les mappes de type de contenu un type de contenu correspondant à celui de la pièce jointe.

    Le gestionnaire de données de pièces jointes examine le type de contenu et le codage du jeu de caractères de la pièce jointe et vérifie si une entrée correspondante existe dans une mappe du type de contenu.

Conversion d'objets métier en documents

Avant que WebSphere Partner Gateway reçoive un document d'InterChange Server, un adaptateur doit déterminer si la représentation d'objet métier des données utiles et de toutes les pièces jointes doit ou non être encapsulée dans l'enveloppe de transfert XML. InterChange Server envoie l'objet métier à l'adaptateur approprié qui traite la conversion réelle. Ce gestionnaire de données peut être configuré pour appeler le gestionnaire de données de pièces jointes afin qu'il traite la conversion des données utiles et de tous les objets métier de pièces jointes en données utiles et pièces jointes correspondantes, ainsi que la création d'une enveloppe de transfert XML.

Pour convertir un objet métier de données utiles comportant des pièces jointes en représentation d'enveloppe de transfert associée, l'entité appelante instancie le gestionnaire de données de pièces jointes afin de lui transmettre l'objet métier de données utiles. Le gestionnaire de données de pièces jointes effectue les opérations suivantes :

  1. Il charge les mappes de type de contenu définies dans son métaobjet de configuration.

    Les mappes de type de contenu sont définies dans les propriétés de configuration ContentTypeMap_x du métaobjet enfant. Le métaobjet enfant est un objet métier qui contient des informations de configuration destinées au gestionnaire de données de pièces jointes. Les attributs de cet objet métier associent des mappes de type de contenu à des types de contenu. Pour plus d'informations, voir Création du métaobjet enfant de pièces jointes.

  2. Il vérifie l'objet métier pour déterminer si une enveloppe de transfert XML doit être créée.
  3. Il définit les données utiles et toutes les balises de pièces jointes dans le document WebSphere Partner Gateway et renvoie ce dernier à l'entité appelante.
Création des documents sans enveloppe de transfert

Si le gestionnaire de données de pièces jointes détermine que l'objet métier de données utiles ne nécessite PAS d'enveloppe de transfert XML, il n'a pas besoin d'encapsuler les données utiles dans la structure d'enveloppe. Par conséquent, le gestionnaire de données utilise le gestionnaire de données utiles par défaut pour convertir l'objet métier de données utiles en document de données utiles correspondant. La propriété de configuration PayloadDataHandlerMimeType (définie dans le métaobjet enfant du gestionnaire de données de pièces jointes) contient le type MIME qui identifie le gestionnaire de données utiles par défaut à instancier pour l'objet métier de données utiles. Ce gestionnaire de données reçoit l'objet métier données utiles sous forme d'argument et renvoie l'objet métier de données utiles résultant à son entité appelante.

Création des documents avec enveloppe de transfert

Si le gestionnaire de données de pièces jointes détermine que l'objet métier de données utiles nécessite une enveloppe de transfert XML, il doit encapsuler les documents de données utiles et de pièces jointes dans cette structure d'enveloppe. Par conséquent, le gestionnaire de données effectue les opérations suivantes pour traiter et convertir l'objet :

  1. Il extrait le type de contenu et le codage du jeu de caractères des données utiles.

    La balise cw_mo_bcg_content_info des informations spécifiques à l'application au niveau de l'objet métier de données utiles indique le nom de l'attribut d'informations de contenu. Cet attribut contient le type de contenu et le codage des données utiles.

    Remarque : Si l'attribut d'informations de contenu n'existe pas, utilisez le gestionnaire de données par défaut (identifié par le type MIME contenu dans la propriété de configuration PayloadDataHandlerMimeType du métaobjet enfant du gestionnaire de données de pièces jointes) pour convertir l'objet métier de données utiles.
  2. Il recherche les mappes d'un type de contenu qui correspond à celui des données utiles.

    Le gestionnaire de données de pièces jointes utilise le type MIME spécifié dans la mappe de type de contenu correspondant pour créer une instance d'un gestionnaire de données utiles. Ce dernier convertit l'objet métier de données utiles en document de données utiles correspondant et renvoie le document résultant au gestionnaire de données de pièces jointes. A partir de la chaîne renvoyée par le gestionnaire de données utiles, le gestionnaire de données de pièces jointes code les octets au format Base64 et enregistre le résultat dans la balise de données utiles de l'enveloppe de transfert XML.

  3. Il extrait le conteneur de pièces jointes de l'objet métier de données utiles.

    Le conteneur de pièces jointes réside dans l'attribut de conteneur de pièces jointes de l'objet métier de données utiles. Les informations spécifiques à l'application au niveau de l'objet métier de données utiles contient la balise cw_mo_bcg_attachment qui identifie l'attribut de conteneur de pièces jointes. Cet attribut contient les pièces jointes.

    Si la balise cw_mo_bcg_attachment n'existe pas (ou qu'elle est vide), on part du principe que le document ne contient pas de pièces jointes. Aucune autre étape de traitement n'est donc requise. Le gestionnaire de données de pièces jointes renvoie les données utiles converties dans son enveloppe de transfert.

  4. Pour chaque pièce jointe, il détermine si celle-ci est représentée sous forme d'objet métier ou simplement de données.

Configuration de l'environnement pour le gestionnaire de données de pièces jointes

L'utilisation du gestionnaire de données de pièces jointes fourni par WebSphere Partner Gateway implique les opérations suivantes :

Spécification du schéma à utiliser

Vous pouvez utiliser le schéma par défaut pour le gestionnaire de données de pièces jointes ou un schéma (wbipackaging_v1.1_ns.xsd) permettant d'inclure l'ID de contenu dans le regroupement d'intégration dorsale.

Pour utiliser le schéma wbipackaging_v1.1_ns.xsd, configurez la propriété wbipackaging_version dans le fichier bcg.properties. (Le fichier bcg.properties est décrit dans le Guide de l'administrateur.) Cette propriété est :

 wbipackaging_version=1.n 

n est égal à 0 ou 1. La valeur par défaut de la propriété est 1.0.

Le métaobjet des données de pièces jointes dispose de l'attribut wbipackaging_version, dont la valeur peut être 1.0 ou 1.1. Si vous donnez la valeur 1.1 à l'attribut, le gestionnaire de données de pièces jointes analyse et génère les messages XML contenant l'ID de contenu de la pièce jointe.

Pour définir l'ID de contenu de la pièce jointe, l'objet métier de codage utilise l'attribut contentId. Lorsque le gestionnaire de données de pièces jointes génère le message XML à partir de l'objet métier, il utilise cet attribut pour créer la balise contentId de la pièce jointe. Lorsque le gestionnaire de données de pièces jointes génère l'objet métier à partir du message XML, il définit cet attribut, à l'aide de la valeur spécifiée dans la balise contentId du message XML.

Déploiement du gestionnaire de données de pièces jointes

Le gestionnaire de données de pièces jointes et le fichier référentiel associé sont disponibles sur le support d'installation de WebSphere Partner Gateway, dans les emplacements indiqués dans le tableau 35.

Tableau 35. Emplacement des composants pour le gestionnaire de données de pièces jointes
Composant Emplacement
Gestionnaire de données de pièces jointes
Integration/WBI/WICS/Attachment/
 bcgwbiattachmentdh.jar
Fichier référentiel
Integration/WBI/WICS/Attachment/
 MO_DataHandler_DefaultAttachmentConfigV1.0.in
ou
Integration/WBI/WICS/Attachment/
 MO_DataHandler_DefaultAttachmentConfigV1.1.in

Déployez les fichiers sur le serveur Web conformément à la documentation relative au serveur Web.

Spécification de l'emplacement du gestionnaire de données de pièces jointes

WebSphere InterChange Server a besoin de l'emplacement du gestionnaire de données de pièces jointes, afin de le charger au moment de l'exécution. Pour indiquer son emplacement, procédez comme suit :

  1. Modifiez le script de démarrage ICS, start_server.bat, situé dans le sous-répertoire bin du répertoire produit d'InterChange Server (sur l'ordinateur où réside InterChange Server).
  2. A la variable CLASSPATH dans ce fichier, ajoutez le fichier jar du gestionnaire de données de pièces jointes : bcgwbiattachmentdh.jar.

Configuration du gestionnaire de données de pièces jointes

La configuration du gestionnaire de données de pièces jointes comprend les étapes suivantes relatives à la création d'objets métier de configuration :

Remarque : Vous devez également créer les définitions d'objet métier liées aux pièces jointes pour le gestionnaire de données de pièces jointes. Pour plus d'informations, voir Création de définitions d'objets métier liées aux pièces jointes.

Création du métaobjet enfant de pièces jointes

Pour configurer le gestionnaire de données de pièces jointes, vous devez créer un métaobjet enfant afin d'indiquer le nom de classe et les propriétés de configuration dont a besoin le gestionnaire de données de pièces jointes. Pour créer ce métaobjet, vous devez créer une définition d'objet métier contenant les attributs indiqués dans le tableau 36. Utilisez Business Object Designer, qui fait partie des outils de WebSphere Business Integration, pour créer cette définition d'objet métier.

Le métaobjet enfant fournit le nom de classe et les propriétés de configuration dont a besoin le gestionnaire de données de pièces jointes. Dans l'outil Business Object Designer, créez un métaobjet enfant qui inclut les types MIME destinés aux données utiles et aux types de pièces jointes que vous pensez recevoir.

Les attributs du métaobjet enfant sont indiqués dans le tableau 36. Un exemple de métaobjet pour le gestionnaire de données de pièces jointes est représenté dans la figure 15.

Remarque : Les exemples d'objets métier mentionnés dans ce chapitre n'incluent pas les attributs standard (comme ObjectEventId) requis par WebSphere InterChange Server mais qui ne sont pas utilisés par le gestionnaire de données de pièces jointes.
Tableau 36. Propriétés de configuration du métaobjet enfant de pièces jointes
Nom d'attribut Description
ClassName

Nom de classe (obligatoire), qui désigne la classe du gestionnaire de données suivante :

com.ibm.bcg.DataHandlers.AttachmentDataHandler
ContentTypeMap_x

La mappe du type de contenu correspondant aux données utiles et aux types de pièce jointe que vous vous attendez à recevoir dans l'encapsuleur XML.

Pour plus d'informations, voir Mappes de type de contenu.

PayloadDataHandlerMimeType Type MIME utilisé pour identifier le gestionnaire de données par défaut, qui traite les données utiles auxquelles aucune pièce jointe n'est associée.
wbipackaging_version Cet attribut peut avoir la valeur 1.0 ou 1.1. Si vous donnez la valeur 1.1 à l'attribut, le gestionnaire de données de pièces jointes analyse et génère les messages XML contenant l'ID de contenu de la pièce jointe.
Important : Pour affecter une valeur aux attributs figurant dans le tableau 36, définissez la valeur par défaut de l'attribut. Par exemple, si le gestionnaire de données de pièces jointes doit utiliser le gestionnaire de données XML comme son gestionnaire de données par défaut, affectez à la valeur par défaut de l'attribut PayloadDataHandlerMimeType la valeur text/xml.
Mappes de type de contenu

La mappe de type de contenu détermine le gestionnaire de données appelé par le gestionnaire de données de pièces jointes pour convertir les informations mises en forme dans le type de contenu associé. Par exemple, si le type de contenu des données utiles est application/xml, le gestionnaire de données de pièces jointes recherche une mappe de type de contenu dont l'attribut ContentType contient la valeur application/xml. Si aucun type de contenu correspondant n'est détecté, le gestionnaire de données considère qu'il ne doit PAS convertir la pièce jointe associée en objet métier.

Vous pouvez créer une mappe pour chacun de ces types de contenu, à l'aide des informations spécifiques à l'application au niveau de l'attribut, comme indiqué dans le tableau 38.

Lorsque vous créez un attribut dans le métaobjet enfant qui représente une mappe de type de contenu, rappelez-vous les éléments suivants :

La mappe du type de contenu peut également indiquer le jeu de caractères utilisé pour le codage et spécifier si une pièce jointe doit être ou non convertie en objet métier. Pour plus d'informations sur les attributs du métaobjet enfant, voir Création du métaobjet enfant de pièces jointes.

Par exemple, supposez que le document contient les types de contenus suivants :

Tableau 38. Exemples de mappes de type de contenu
Type de contenu Nom d'attribut Valeur par défaut
text/xml ContentType_1 ContentType=text/xml;MimeType=myxml; CharSet=UTF-8;ConvertAttachment=false;
application/xml ContentType_2 ContentType=application/xml; MimeType=mynewxml;CharSet=UTF-16; ConvertAttachment=true;
application/octet-stream ContentType_3 ContentType=application/octet-stream; MimeType=myoctet
Exemple de métaobjet

WebSphere Partner Gateway fournit les fichiers référentiels d'entrée d'InterChange Server suivants, qui contiennent un exemple de métaobjet enfant pour le gestionnaire de données de pièces jointes :

rép_produit/Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfigV1.0.in

rép_produit/Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfigV1.1.in

ProductDir est le répertoire d'installation de votre produit WebSphere Partner Gateway. Les fichiers référentiels définissent un gestionnaire de données de pièces jointes unique dont le métaobjet enfant associé est MO_DataHandler_DefaultAttachmentConfig. La figure 15 présente l'exemple de métaobjet enfant du gestionnaire de données de pièces jointes. Ce métaobjet définit deux mappes de type de contenu, ContentTypeMap_1 et ContentTypeMap_2.

Figure 15. Exemple de métaobjet enfant pour le gestionnaire de données de pièces jointes
Cette figure montre un exemple de métaobjet enfant contenant deux mappes de type de contenu.

MO_DataHandler_DefaultAttachmentConfigV1.1.in contient l'attribut supplémentaire :

[Attribute]
     Name = WBIPackaging_Version
     Type = String
     MaxLength = 255
     IsKey = false
     IsForeignKey = false
     IsRequired = true
     DefaultValue = 1.0
     IsRequiredServerBound = false
     [End]

Mise à jour du métaobjet du gestionnaire de données de niveau supérieur

Un composant WebSphere Business Integration Adapter (tel que Adapter for JMS) utilise le métaobjet MO_DataHandler_Default pour identifier les gestionnaires de données à utiliser. Ajoutez une référence au gestionnaire de données de pièces jointes dans le métaobjet.

Apportez les modifications suivantes au métaobjet MO_DataHandler_Default :

  1. Ajoutez un attribut dont le nom identifie le type MIME associé à l'instance de gestionnaire de données de pièces jointes ; en d'autres termes, pour un document qui contient ce type MIME, le gestionnaire de données associé peut traiter sa conversion en objet métier.

    Le type de cet attribut est la définition d'objet métier du métaobjet enfant du gestionnaire de données de pièces jointes (voir Création du métaobjet enfant de pièces jointes).

  2. Ajoutez un attribut pour chacun des types MIME de pièce jointe pris en charge, si ces derniers n'existent pas déjà dans le métaobjet de gestionnaire de données de niveau supérieur.

    Le type de ces attributs serait le métaobjet enfant du gestionnaire de données associé.

Par exemple, supposez que vous disposez du gestionnaire de données de pièces jointes tel qu'il est configuré dans la figure 15. La figure 16 présente le métaobjet MO_DataHandler_Default dont l'attribut associe le type MIME wbic_attachment à l'instance du gestionnaire de données de pièces jointes qui est configuré par le métaobjet enfant MO_DataHandler_DefaultAttachmentConfig. Ce métaobjet de gestionnaire de données de niveau supérieur associe également le type MIME de document (text/xml) au métaobjet enfant du gestionnaire de données XML.

Figure 16. Association du type MIME wbic_attachment MIME au gestionnaire de données de pièces jointes
Cette figure montre le métaobjetMO_DataHandler_Default dont l'attribut associe le typeMIME avec l'instance du gestionnaire de données de pièces jointes configuré dans le métaobjet enfant MO_DataHandler_DefaultAttachmentConfig.

Pour chaque combinaison unique des types de contenu pris en charge que vous devez prendre en charge, répétez ce processus en ajoutant un attribut dans le métaobjet de gestionnaire de données de niveau supérieur approprié dont le nom d'attribut est le type MIME associé à l'instance de gestionnaire de données de pièces jointes et dont le type est le nom du métaobjet enfant associé. Assurez-vous également que les types MIME configurés (ainsi que leurs métaobjets enfant) existent dans le métaobjet de niveau supérieur.

Création de définitions d'objets métier liées aux pièces jointes

Si vous envoyez ou recevez des documents qui sont encapsulés dans une enveloppe de transfert XML, l'objet métier de données utiles doit contenir des informations relatives aux pièces jointes. Tout flux de documents contient des données utiles, et le cas échéant, des pièces jointes. Le gestionnaire de données de pièces jointes s'attend à ce que ces informations de pièces jointes se trouvent dans des objets métier liés aux pièces jointes. Par conséquent, vous devez créer des définitions d'objet métier pour représenter ces informations. Une définition d'objet métier est la forme que prennent les informations utilisées par InterChange Server. Vous devez utiliser l'outil Business Object Designer pour créer des définitions d'objet métier.

La figure 17 présente la structure d'objet métier de données utiles qui est encapsulée dans une enveloppe de transfert XML.

Figure 17. Relation entre l'objet métier de données utiles et les objets métier de pièces jointes
Cette figure montre la relation entre les objets métier de données utiles et les objets métiers de pièces jointes. L'objet métier de données utile pointe sur attachContainer_BusObj, qui pointe sur defaultAttach_Bus Obj et sur attachment1_BusObj. Les objets métier de pièces jointes pointent sur un contentInfo_BusObj.

Comme le montre la figure 17, toutes les pièces jointes sont contenues dans l'objet métier conteneur de pièces jointes. S'il existe des pièces jointes, l'objet métier de données utiles possède un attribut qui correspond à l'objet métier conteneur de pièces jointes.

Assurez-vous que la structure de l'objet métier contient des objets métier requis par des pièces jointes, en procédant comme suit :

  1. Créez une définition d'objet métier destinée à contenir les propriétés de codage du type de contenu requises par le regroupement d'intégration dorsale.
  2. Créez une définition d'objet métier pour chaque type de pièce jointe.
  3. Créez une définition d'objet métier pour l'objet métier conteneur de pièces jointes.
  4. Modifiez la définition d'objet métier pour votre objet métier de données utiles.

Chaque étape est décrite dans les sections ci-dessous.

Représentation des informations de contenu

Pour stocker le type de contenu et le codage des données utiles ou des pièces jointes associées, créez l'objet métier d'informations de contenu. Pour créer une définition d'objet métier d'informations de contenu, créez les attributs présentés dans le tableau 39.

Tableau 39. Attributs de l'objet métier d'informations de contenu
Attribut Type d'attribut Description S'agit-il d'un attribut clé ?
contentType Chaîne

Type de contenu des données utiles ou des pièces jointes associées

Oui
encoding Chaîne Codage de caractères des données utiles ou des pièces jointes associées Non

Dans la figure 17, la définition d'objet métier contentInfo_BusObj contient des attributs pour le type de contenu et le codage de la pièce jointe. Ces attributs possèdent tous des informations spécifiques à l'application au niveau des attributs afin de spécifier le nom de l'en-tête du protocole associé. Par exemple, les informations spécifiques à l'application de l'attribut x-aux-sender-id sont définies comme suit :

name=x-aux-sender-id

Vous pouvez choisir le nom de votre choix pour identifier la définition d'objet métier d'informations de contenu. Les informations spécifiques à l'application de l'objet métier de pièces jointes déterminent s'il s'agit d'un type d'objet métier Codage du type de contenu. La figure 17 illustre un exemple de définition d'objet métier Codage du type de contenu appelé contentType_BusObj.

Représentation des données de pièces jointes

Pour les données de pièces jointes qui ne doivent pas être converties en objet métier, créez l'objet métier de pièces jointes par défaut. Cet objet métier permet de stocker des données codées au format base64 qui émanent de l'enveloppe de transfert.

Pour créer une définition d'objet métier de pièces jointes par défaut, procédez comme suit :

  1. Créez les attributs présentés dans le tableau 40.
  2. Si vous créez l'objet métier d'informations de contenu, ajoutez, dans les informations spécifiques à l'application pour la définition d'objet métier de pièces jointes par défaut, la balise cw_mo_bcg_content_info afin d'identifier l'attribut qui contient les informations de contenu.

    Cette balise cw_mo_bcg_content_info est au format suivant :

    cw_mo_bcg_content_info=attribut_informations_contenu

    attribut_informations_contenu représente le nom de l'attribut qui contient l'objet métier conteneur de pièces jointes.

Tableau 40. Attributs de l'objet métier d'informations de pièces jointes par défaut
Attribut Type d'attribut Description S'agit-il d'un attribut clé ?
attachment Chaîne

Elément de données de pièces jointes.

Remarque : Il s'agit de l'attribut clé de la définition d'objet métier.
Oui

Attribut stockant les informations de contenu

Objet métier

Attribut facultatif stockant l'objet métier d'informations de contenu, qui fournit le type de contenu et le codage des données de pièces jointes. Cet attribut doit avoir une cardinalité unique.

Remarque : Si cet attribut n'existe PAS, le gestionnaire de données de pièces jointes ne définit pas les données de pièces jointes dans l'objet métier.

Pour plus d'informations sur le format de l'objet métier d'informations de contenu, voir Représentation des informations de contenu.

Non

Dans la figure 17, la définition d'objet métierdefaultAttach_BusObj contient des attributs relatifs à l'élément de données de pièces jointes, y compris un objet métier d'informations de contenu stockant le type de contenu et le codage associés. L'élément de données de pièces jointes représenté par cet objet métier de pièces jointes par défaut comporte pas un codage de type de contenu qui est représenté par l'attribut contentType_attach. Par conséquent, la définition d'objet métier de pièces jointes par défaut inclut la balise suivante dans ses informations spécifiques à l'application au niveau de l'objet métier :

cw_mo_bcg_content_info=contentType_attach

Représentation des pièces jointes

Pour chaque type de pièce jointe contenue dans votre document qui est converti en objet métier, vous devez créer une définition d'objet métier de pièces jointes distincte. Celle-ci représente les données réelles figurant dans une pièce jointe au document. Pour créer une définition d'objet métier de pièces jointes, procédez comme suit :

  1. Créez un attribut pour chaque élément de données de pièces jointes.

    Les types d'attributs possibles peuvent inclure une chaîne (pour les éléments de données simples) ou une définition d'objet métier (pour les données complexes).

  2. Si la pièce jointe nécessite un codage de type de contenu :
    1. Créez un attribut de codage de type de contenu.

      Le type de cet attribut est la définition d'objet métier de codage de type de contenu (voir Représentation des informations de contenu).

    2. Ajoutez aux informations spécifiques à l'application au niveau de l'objet métier de la définition d'objet métier de pièces jointes la balise cw_mo_bcg_content_info, afin d'identifier l'attribut qui contient le codage de type de contenu.

      Cette balise cw_mo_bcg_content_info est au format suivant :

      cw_mo_bcg_content_info=contentTypeEncodingAttr

      contentTypeEncodingAttr est le nom de l'attribut qui contient l'objet métier Codage du type de contenu.

Dans la figure 17, le document de données utiles possède une pièce jointe, qui est représentée par la définition d'objet métier attachment1_BusObj. Cette pièce jointe comporte un codage de type de contenu représenté par l'attribut contentTypeEncoding. Par conséquent, la définition objet métier de pièces jointes inclut la balise suivante dans ses informations spécifiques à l'application au niveau de l'objet métier :

cw_mo_bcg_content_info=contentTypeEncoding

Représentation du conteneur de pièces jointes

Le conteneur de pièces jointes contient toutes les pièces jointes de document dans l'enveloppe de transfert. Pour représenter le conteneur de pièces jointes pour InterChange Server, créez l'objet métier conteneur de pièces jointes. Chaque attribut présent dans l'objet métier conteneur de pièces jointes représente une seule pièce jointe.

Pour créer une définition d'objet métier conteneur de pièces jointes, procédez comme suit :

  1. Ajoutez un attribut pour chaque pièce jointe du document qui doit être convertie en objet métier.

    Le type de chacun de ces attributs correspond à l'objet métier de pièces jointes associé (voir Représentation des pièces jointes). Chaque attribut doit avoir plusieurs cardinalités.

  2. Ajoutez la balise wbic_type aux informations spécifiques à l'application relatives à chaque attribut, afin d'identifier l'attribut sous la forme d'une pièce jointe.

    La balise wbic_type est au format suivant :

    wbic_type=Attachment

    Remarque : Un attribut de pièce jointe peut avoir plusieurs cardinalités.
  3. Si les données utiles contiennent des données de pièces jointes qui ne doivent PAS être converties en objet métier :
    1. Ajoutez un attribut pour l'objet métier de pièces jointes par défaut.

      Le type de cet attribut correspond à l'objet métier de pièce jointe par défaut (voir Représentation des données de pièces jointes). Il s'agit de l'attribut clé de l'objet métier conteneur de pièces jointes. Cet attribut ne nécessite PAS la balise wbic_type dans ses informations spécifiques à l'application.

      Remarque : L'objet métier conteneur de pièces jointes peut contenir un seul attribut de pièce jointe par défaut. Toutefois, cet attribut peut avoir plusieurs cardinalités.
    2. Ajoutez aux informations spécifiques à l'application au niveau de l'objet métier de la définition d'objet métier de pièces jointes la balise cw_mo_bcg_default_attribute, afin d'identifier l'attribut qui contient les données de pièces jointes.

      Cette balise cw_mo_bcg_default_attribute est au format suivant :

      cw_mo_bcg_content_info=attribut_pièce_jointe_par_défaut

      attribut_pièce_jointe_par_défaut représente le nom de l'attribut qui contient l'objet métier de pièces jointes par défaut.

    Important : Si aucun attribut de pièces jointes par défaut n'existe, le gestionnaire de données de pièces jointes ne peut pas convertir les pièces jointes qui ne possèdent pas une mappe de type de contenu associée ou des pièces jointes qui ne sont pas converties en objets métier. Ces pièces jointes sont perdues lors de la conversion en représentation d'objet métier.

Dans la figure 17, le conteneur de pièces jointes est représenté par la définition d'objet métier attachContainer_BusObj. Cette définition d'objet métier de conteneur de pièces jointes comporte les attributs suivants :

Modification de la définition d'un objet métier des données utiles

La définition de l'objet métier des données utiles représente les informations contenues dans votre document. Elle contient un attribut pour chaque information que vous devez transférer entre WebSphere Partner Gateway et InterChange Server. Pour plus d'informations sur la création de la définition d'un objet métier de données utiles, voir Objet métier défini pour un document.

Si vous envoyez ou recevez des documents qui contiennent des pièces jointes, l'objet métier de données utiles doit contenir des informations relatives aux pièces jointes. Tout flux de documents contient des données utiles, et le cas échéant, des pièces jointes. Si les données utiles de votre document contiennent des pièces jointes, vous devez modifier la définition de l'objet métier des données utiles comme suit :

  1. Créez un attribut stockant les données utiles.

    Il est peut-être plus facile à utiliser si vos données utiles réelles sont stockées dans une définition d'objet métier de données utiles distincte. Dans ce cas, l'objet métier de données utiles de niveau supérieur contient pour les données utiles un attribut dont le type est la définition d'objet métier des données utiles réelles.

  2. Ajoutez un conteneur de pièces jointes :
    1. Ajoutez un attribut stockant le conteneur de pièces jointes.

      Le type de cet attribut est la définition d'objet métier de conteneur de pièces jointes (voir Représentation du conteneur de pièces jointes). Cet attribut doit avoir une cardinalité unique.

    2. Dans les informations spécifiques à l'application pour la définition d'objet métier des données utiles, ajoutez la balise cw_mo_bcg_attachment afin d'identifier l'attribut qui contient le conteneur de pièces jointes.

      Cette balise cw_mo_bcg_attachment est au format suivant :

      cw_mo_bcg_attachment=attribut_conteneur_pièces_jointes

      attribut_conteneur_pièces_jointes est le nom de l'attribut qui contient l'objet métier Conteneur de pièces jointes.

  3. Le cas échéant, vous pouvez indiquer le type de contenu des données utiles. Le gestionnaire de données de pièces jointes utilise ce type de contenu pour déterminer quel gestionnaire de données à instancier pour convertir les données utiles. S'il trouve un type de contenu correspondant dans les mappes de type de contenu, il instancie le gestionnaire de données pour ce type de contenu.
    1. Ajoutez un attribut d'informations de contenu correspondant à un attribut facultatif qui stocke le type de contenu et le codage des données utiles. Cet attribut doit avoir une cardinalité unique.
      Remarque : Si cet attribut n'existe PAS, le gestionnaire de données de pièces jointes fait en sorte que le gestionnaire de données convertisse les données utiles à partir de la valeur de la propriété de configuration PayloadDataHandlerMimeType dans son métaobjet enfant.
    2. Dans les informations spécifiques à l'application pour la définition d'objet métier des données utiles, ajoutez la balise cw_mo_bcg_content_info afin d'identifier l'attribut qui contient les informations de contenu.

      Cette balise cw_mo_bcg_content_info est au format suivant :

      cw_mo_bcg_attachment=attribut_informations_contenu

      attribut_informations_contenu représente le nom de l'attribut qui contient l'objet métier d'informations de contenu. Pour plus d'informations sur le format de l'objet métier d'informations de contenu, voir Représentation des informations de contenu.

  4. Ajoutez tous les attributs de configuration requis pour votre protocole de transfert.

    Par exemple, si vous utilisez le protocole de transfert JMS, votre définition d'objet métier de données utiles doit contenir l'objet métier dynamique JMS. Pour plus d'informations, consultez la section relative à la création de définitions d'objet métier à l'appui de votre protocole de transfert.

Copyright IBM Corp. 2003, 2005