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 :
Lorsque cet indicateur a pour valeur Oui, WebSphere Partner Gateway 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 s'effectue sur la page Prestataires B2B du profil. Pour plus d'informations, voir Données utiles.
Lorsqu'un document contient des pièces jointes, WebSphere Partner Gateway 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 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 :
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 :
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 :
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 des documents 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 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 des documents avec 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.
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.
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.
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.
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.
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 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 :
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 des documents 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 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 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.
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.
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.
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. 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 WebSphere Partner Gateway implique les opérations suivantes :
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
où 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.
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.
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 :
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 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.
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. |
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 :
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 37 contient les balises contenues dans la valeur par défaut de cet attribut.
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 :
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 |
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
où 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.
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]
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 :
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 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.
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 17 présente la structure d'objet métier de données utiles qui est encapsulée dans une enveloppe de transfert XML.
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 :
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 39.
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.
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.
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
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 :
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 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
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 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 :
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 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 :
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.