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 :
Lorsque cet indicateur a pour valeur Oui, Business Integration Connect encapsule systématiquement un document dans une enveloppe de transfert XML, qu'il contienne ou non des pièces jointes. Le paramétrage de cet indicateur sur Oui pour le regroupement d'intégration dorsale d'effectue dans le cadre de l'écran Prestataires B2B du profil. Pour plus d'informations, voir Données utiles.
Lorsqu'un document contient des pièces jointes, Business Integration Connect l'encapsule dans une enveloppe de transfert XML. Tout flux de documents contient des données utiles, et le cas échéant, des pièces jointes. 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.
Le gestionnaire de données de pièces jointes peut être appelé dans l'un des contextes suivants :
Si Business Integration Connect et une version antérieure à 4.2.2 d'InterChange Server participent dans la notification d'événements (Business Integration Connect lance la requête), le servlet WebSphere Business Integration Connect (client d'accès) envoie le document à Server Access, qui appelle le gestionnaire de données d'encapsulage pour convertir le document en représentation d'objet métier associée. Si ce document est encapsulé dans une enveloppe de transfert XML, le gestionnaire de données d'encapsulage appelle le gestionnaire de données de pièces jointes pour convertir le format sérialisé du document (dans son enveloppe de transfert XML) en objet métier correspondant.
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 :
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 :
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 :
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.
Le document ne contient que des données utiles que le gestionnaire de données de pièces jointes doit convertir en représentation d'objet métier associée. Pour plus d'informations, voir Traitement d'un document qui ne se trouve pas dans une enveloppe de transfert.
Le document contient des données utiles et éventuellement quelques pièces jointes. Par conséquent, le gestionnaire de données de pièces jointes doit convertir les données utiles et toutes les pièces jointes en représentation d'objet métier associée. Pour plus d'informations, voir 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 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.
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 :
Les données utiles sont contenues dans la balise XML <payload>. Chaque pièce jointe est contenue dans une balise XML <attachment>.
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.
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.
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.
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.
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.
Le gestionnaire de données crée donc une instance de l'objet métier de pièces jointes par défaut, définit les valeurs du type de contenu et du codage dans son objet métier d'informations de contenu, puis définit les données de pièces jointes codées en base64 (sous la forme d'une chaîne) dans l'attribut attachment.
Le gestionnaire de données de pièces jointes renseigne ensuite l'objet métier conteneur de pièces jointes à l'aide de l'objet métier de pièces jointes par défaut.
Le gestionnaire de données de pièces jointes renseigne ensuite l'objet métier conteneur de pièces jointes à l'aide de l'objet métier de pièces jointes par défaut.
Le gestionnaire de données de pièces jointes vérifie ensuite les informations spécifiques à l'application de niveau objet métier de la définition d'objet métier de pièces jointes 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. Si cette balise existe, le gestionnaire de données crée l'objet métier d'informations de contenu pour la pièce jointe et définit la valeur du type de contenu et du codage de la pièce jointe.
Pour finir, le gestionnaire de données de pièces jointes renseigne l'objet métier conteneur de pièces jointes à l'aide de l'objet métier de pièces jointes.
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 :
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.
Le document ne contient que des données utiles que le gestionnaire de données de pièces jointes doit créer à partir de la représentation d'objet métier associée. Le gestionnaire de données n'a pas besoin de créer une enveloppe de transfert pour le document. Pour plus d'informations, voir Création d'un document sans enveloppe de transfert.
Le document contient des données utiles et éventuellement quelques pièces jointes. Par conséquent, le gestionnaire de données de pièces jointes doit convertir la représentation d'objet métier de données utiles en données utiles et pièces jointes et encapsuler ces composants dans une enveloppe de transfert. Pour plus d'informations, voir 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 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.
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 :
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.
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.
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.
Le gestionnaire de données de pièces jointes effectue les opérations suivantes pour traiter l'objet métier de pièces jointes :
Les informations spécifiques à l'application au niveau de l'objet métier de pièces jointes contient la balise cw_mo_bcg_content_info qui identifie l'attribut d'informations de contenu. Cet attribut contient le type de contenu et le codage de cette pièce jointe. Le gestionnaire de données de pièces jointes enregistre ces informations de contenu dans la balise de pièce jointe du document.
Il utilise le type MIME dans la mappe de type de contenu correspondant pour créer une instance d'un gestionnaire de données. Ce dernier convertit l'objet métier de pièces jointes en document de pièces jointes correspondant et renvoie le document résultant (sous forme de chaîne) au gestionnaire de données de pièces jointes.
Le gestionnaire de données de pièces jointes extrait les octets de la chaîne renvoyée (à l'aide du jeu de caractères, s'il y a lieu) et code les octets au format Base64. Il enregistre ensuite le résultat dans la balise de pièce jointe.
L'utilisation du gestionnaire de données de pièces jointes fourni par Business Integration Connect implique les opérations suivantes :
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
Déployez les fichiers sur le serveur Web conformément à la documentation relative au serveur Web.
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 :
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.
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 :
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.
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. |
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 :
ContentTypeMap_x
où x correspond à un nombre entier qui identifie de manière exclusive la mappe de type de contenu dans la définition de l'objet métier.
Le Tableau 40 contient les balises contenues dans la valeur par défaut de
cet attribut.
Tableau 40. Balises valides pour la valeur par défaut de l'attribut content-type-map
Nom de balise | Description | Obligatoire ? |
---|---|---|
ContentType |
Type de contenu réel fourni dans l'enveloppe de transfert (par
exemple, text/xml).
| Oui |
MimeType |
Type MIME utilisé pour identifier le gestionnaire de données pour
qu'il convertisse le type de contenu associé en objet métier. Si
l'élément MimeType n'est pas spécifié, le gestionnaire de
données utilise la valeur de l'élément ContentType pour
instancier le gestionnaire de données.
| Non |
CharSet |
Nom du jeu de caractères (par exemple, UTF-8) que le gestionnaire de données de pièces jointes utilise pour convertir les octets en chaîne ou inversement. Si vous ne spécifiez pas CharSet, le gestionnaire de données de pièces jointes procède comme suit :
| Non |
ConvertAttachment |
Valeur booléenne qui indique si la pièce jointe doit ou non être convertie
en objet métier. La valeur par défaut est false.
| Non |
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 |
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
où 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
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
Vous apportez les modifications suivantes au métaobjet MO_Server_DataHandler ou MO_DataHandler_Default :
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).
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 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.
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 :
Chaque étape est décrite dans les sections ci-dessous.
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.
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 :
Cette balise cw_mo_bcg_content_info est au format suivant :
cw_mo_bcg_content_info=attribut_informations_contenu
où attribut_informations_contenu représente le nom de l'attribut qui contient l'objet métier conteneur de pièces jointes.
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.
| 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.
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
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 :
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).
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).
Cette balise cw_mo_bcg_content_info est au format suivant :
cw_mo_bcg_content_info=contentTypeEncodingAttr
où contentTypeEncodingAttr est le nom de l'attribut qui contient l'objet métier Codage du 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
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 :
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.
La balise wbic_type est au format suivant :
wbic_type=Attachment
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.
Cette balise cw_mo_bcg_default_attribute est au format suivant :
cw_mo_bcg_content_info=attribut_pièce_jointe_par_défaut
où 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.
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 :
wbic_type=Attachment
Cette pièce jointe est représentée par la définition d'objet métier attachment1_BusObj.
cw_mo_bcg_default_attribute=defaultAttach
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 :
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.
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.
Cette balise cw_mo_bcg_attachment est au format suivant :
cw_mo_bcg_attachment=attribut_conteneur_pièces_jointes
où attribut_conteneur_pièces_jointes est le nom de l'attribut qui contient l'objet métier Conteneur de pièces jointes.
Cette balise cw_mo_bcg_content_info est au format suivant :
cw_mo_bcg_attachment=attribut_informations_contenu
où 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.
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.