Gestion des documents contenant des pièces jointes

Business Integration Connect fournit le gestionnaire de données de pièces jointes pour traiter les documents qui sont envoyés de Business Integration Connect à InterChange Server et 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 peut être appelé dans l'un des contextes suivants :

Quelle que soit l'entité appelante (adaptateur ou Server Access), lorsqu'elle reçoit un document dans une enveloppe de transfert XML, elle 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 20, 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'entité appelante reçoit une représentation d'objet métier pour un document dans une enveloppe de transfert XML, elle 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 21, 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

Le gestionnaire de données de pièces jointes peut interpréter la structure de cette 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 Business Integration Connect envoie un document à InterChange Server, il doit déterminer si le contenu doit ou non être encapsulé dans une enveloppe de transfert XML. Si Business Integration Connect crée l'enveloppe de transfert, les données utiles et toutes les pièces jointes sont codées au format Base64. Business Integration Connect envoie ensuite l'enveloppe de transfert XML au composant compatible ICS approprié à l'aide des en-têtes de niveau de transfert correspondants. Ce composant compatible avec ICS (un adaptateur WebSphere Business Integration ou le gestionnaire de données d'encapsulage) 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. Définissez l'objet métier de données utiles résultant et renvoyez cet objet métier à l'entité appelante.

Traitement d'un document qui ne se trouve pas dans une 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 d'un document qui se trouve dans une 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.

    Il 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.

    Il 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 contenu de pièces jointes.

    Il 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.

    Il extrait 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 Business Integration Connect reçoive un document d'InterChange Server, un composant compatible ICS doit déterminer si la représentation d'objet métier des données utiles et de toutes les pièces jointes doivent ou non être encapsulées dans l'enveloppe de transfert XML. InterChange Server envoie l'objet métier au composant compatible ICS approprié qui traite la conversion réelle. Ce composant compatible ICS (un adaptateur WebSphere Business Integration ou le gestionnaire de données d'encapsulage) 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 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 enfant.

    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 Business Integration Connect et renvoie ce dernier à l'entité appelante.

Création d'un document 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 d'un document à l'aide d'une 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.

    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 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èces 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 Business Integration Connect implique les opérations suivantes :

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 Business Integration Connect, dans les emplacements indiqués dans le Tableau 38.

Tableau 38. 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_DefaultAttachmentConfig.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 la machine 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 :

    Ajoutez le fichier jar correspondant au gestionnaire de données de pièces jointes, bcgwbiattachmentdh.jar, à la liste des fichiers jar inclus au démarrage d'ICS.

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 39. 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 39. Un exemple de métaobjet pour le gestionnaire de données de pièces jointes est représenté dans la Figure 6.

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 39. 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.

Important:
Pour affecter une valeur aux attributs figurant dans le Tableau 39, 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 quel gestionnaire de données le gestionnaire de données de pièces jointes appelle 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 41.

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 41. 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

Business Integration Connect fournit le fichier d'entrée référentiel InterChange Server suivant, qui contient un exemple de métaobjet pour le gestionnaire de données de pièces jointes :

rép_produit/Integration/WBI/WICS/Attachment/
    MO_DataHandler_DefaultAttachmentConfig.in
 

rép_produit représente le répertoire dans lequel le produit Business Integration Connect est installé. Ce fichier référentiel définit un gestionnaire de données de pièces jointes unique dont le type MIME est wbic_attachment et dont le métaobjet enfant associé est MO_DataHandler_DefaultAttachmentConfig. La Figure 6 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 6. Exemple de métaobjet enfant pour le gestionnaire de données de pièces jointes


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. WebSphere Server Access utilise le métaobjet MO_Server_DataHandler dans le même but. Ajoutez une référence au gestionnaire de données de pièces jointes dans l'un de ces métaobjets.

Pour associer des types MIME contenus dans des documents aux gestionnaires de données qui prennent en charge ces types MIME, un composant compatible ICS fait référence à un métaobjet de gestionnaire de données de niveau supérieur. Le Tableau 42 répertorie les noms du métaobjet de niveau supérieur, en fonction du composant qui doit accéder à un gestionnaire de données.

Tableau 42. Métaobjets de gestionnaire de données de niveau supérieur pour InterChange Server
Composant WebSphere Business Integration Composant compatible ICS Métaobjet de gestionnaire
de données de niveau supérieur
Adaptateur Adapter for XML, Adapter for HTTP, Adapter for JMS MO_DataHandler_Default
Client d'accès utilisant Server Access
Connect Servlet MO_Server_DataHandler

Vous apportez les modifications suivantes au métaobjet MO_Server_DataHandler ou MO_DataHandler_Default :

Par exemple, supposez que vous disposez du gestionnaire de données de pièces jointes tel qu'il est configuré dans la Figure 6. La Figure 7 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 7. Association du type MIME wbic_attachment MIME au gestionnaire de données de pièces jointes


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 8 présente la structure d'objet métier de données utiles qui est encapsulée dans une enveloppe de transfert XML.

Figure 8. Relation entre l'objet métier de données utiles et les objets métier de pièces jointes


Comme le montre la Figure 8, 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 43.

Tableau 43. 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 8, 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 8 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 :


Tableau 44. 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 8, 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 une définition d'objet métier de pièces jointes. 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 :

Dans la Figure 8, 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 :

    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 8, 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 Business Integration Connect 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 :

Copyright IBM Corp. 1997, 2004