Ajouter des fichiers binaires au mappage
Pour effectuer un mappage de données vers ou depuis des fichiers binaires encodés au format Protocol Buffers, vous devez d’abord ajouter le fichier .proto correspondant au mappage MapForce, comme illustré ci-dessous.
Pour ajouter un fichier .proto en tant que composant de mappage :
1.Dans le menu Insérer, cliquez sur Fichier Protocol Buffers. Vous pouvez également cliquer sur le bouton Insérer fichier Protocol Buffers 
de la barre d’outils.
2.Procédez de l’une des manières suivantes :
a.Pour ouvrir un fichier .proto stocké sur le disque local, recherchez le fichier, puis cliquez sur Ouvrir.
b.Pour ouvrir un fichier .proto à partir d’une URL, cliquez sur Passer à URL et saisissez l’URL du fichier dans le dialogue ; voir Ajouter des composants depuis une URL.
c.Pour ouvrir un fichier .proto préalablement défini comme ressource globale, cliquez sur Ressources Globales. Pour plus d'informations sur les ressources globales, voir Ressources globales d’Altova.
3.Un fichier .proto contient généralement plusieurs types de message. Lorsque vous y êtes invité, sélectionnez le type de message qui est l'objet le plus haut dans la hiérarchie (appelé « racine »).
4.Cliquez sur OK. Un dialogue s'affiche.
5.Si vous souhaitez lire des données à partir d'un fichier binaire Protocol Buffers, cliquez sur Parcourir et sélectionnez l'instance binaire à partir de laquelle vous souhaitez lire les données. Si vous souhaitez écrire des données dans un fichier Protocol Buffers ou sélectionner une instance ultérieurement, cliquez sur Ignorer.
Si le fichier .proto peut être lu correctement, MapForce affiche sa structure dans le mappage de la même manière que pour les autres types de composants, par exemple :
Jusqu'à présent, vous avez ajouté un composant binaire au mappage ; toutefois, celui-ci n'est pas encore complet, car il ne lit ni n'écrit aucune donnée. Pour des exemples illustrant des mappages complets, voir :
•Exemple : Lire des données depuis les Protocol Buffers
•Exemple : Écrire les données dans les Protocol Buffers
Bouton « Fichier/Blob »
Le bouton Fichier/Blob du composant binaire ouvre un menu contextuel proposant plusieurs commandes utiles dans les situations suivantes :
•Utiliser les noms de fichiers depuis les paramètres de composant : il s’agit de l’option sélectionnée par défaut ; elle est pertinente lorsque votre mappage lit ou génère un seul fichier binaire. Lorsque cette option est activée, vous pouvez modifier le nom du fichier depuis le dialogue Paramètres de composant ; voir Paramètres du composant binaire.
•Utiliser les noms de fichier dynamiques fournis par les mappages : cette commande est utile lorsque votre mappage doit lire ou générer plusieurs fichiers binaires. Lorsque cette option est activée, vous ne pouvez plus modifier le nom du fichier depuis le dialogue « Paramètres de composant ». À la place, vous définissez les noms de fichiers en fonction d'informations provenant du mappage lui-même. Pour un exemple d'utilisation, voir Exemple : Écrire les données dans les Protocol Buffers.
•Parser Blobs vers Protocol Buffers : cette commande transforme le composant en composant d'analyse. Cela vous permet d'analyser une valeur binaire au format Protocol Buffers afin qu'elle devienne une structure arborescente mappable. Le fonctionnement est similaire à celui de l’analyse et de la sérialisation de chaînes de caractères (voir Parser et sérialiser des strings), sauf qu’il s’agit ici non pas de chaînes de caractères, mais de chaînes d’octets binaires. Par exemple, dans le composant ci-dessous, vous pouvez connecter un élément de type binaire à l’entrée « Blob » située à gauche. Au moment de l’exécution du mappage, cette valeur binaire sera analysée et les données seront transmises aux sorties de la structure mappable située à droite.
•Sérialiser Protocol Buffers vers Blobs : cette commande transforme le composant en composant de sérialisation. Elle vous permet de sérialiser une structure arborescente mappable en une valeur binaire au format Protocol Buffers. Par exemple, dans le composant ci-dessous, vous pouvez connecter des éléments de types appropriés à la structure mappable située à gauche. Au moment de l'exécution du mappage, la structure sera sérialisée et remplira la sortie unique (de type binaire) située à droite, afin que vous puissiez la connecter ensuite à un composant cible. Cela peut s'avérer utile lorsque votre mappage doit écrire des données de type BLOB (Binary Large Object) dans une base de données cible. Une autre utilisation consiste à écrire des données dans des champs binaires (de type « octets ») d'un composant Protocol Buffers cible.
