ONYX - 9.0 - Utilisation - mapSoapRunStreamFromPost
Différence entre versions
De MappingDoc
(→Exemple de workflow pour traitement synchrone) |
(→Exemple de workflow pour traitement synchrone) (Balise : Éditeur visuel) |
||
| Ligne 30 : | Ligne 30 : | ||
===Exemple de workflow pour traitement asynchrone=== | ===Exemple de workflow pour traitement asynchrone=== | ||
| − | *La variable param1 récupère le contenu de macle1 | + | *La variable param1 récupère le contenu de macle1 (boite paramètre) |
| − | *La variable param2 récupère le contenu de macle2 | + | *La variable param2 récupère le contenu de macle2 (boite paramètre) |
| − | *La boite "Print" permet d'envoyer le fichier dans la file d'attente "MON_ENTRY" | + | *La boite "Print" permet d'envoyer le fichier dans la file d'attente "MON_ENTRY" (boite "Imprimer") |
**Le fichier transmis dans le flux du WebService est [%MAP_FILE_IN%] | **Le fichier transmis dans le flux du WebService est [%MAP_FILE_IN%] | ||
**La coche "Ajouter les paramètres courants" permettent de transmettre les variables param1 et param2 avec le fichier dans la file d'attente "MON_ENTRY" | **La coche "Ajouter les paramètres courants" permettent de transmettre les variables param1 et param2 avec le fichier dans la file d'attente "MON_ENTRY" | ||
| Ligne 44 : | Ligne 44 : | ||
===Exemple de workflow pour traitement synchrone=== | ===Exemple de workflow pour traitement synchrone=== | ||
| − | *La variable param1 récupère le contenu de macle1 | + | *La variable param1 récupère le contenu de macle1 (boite paramètre) |
| − | *La variable param2 récupère le contenu de macle2 | + | *La variable param2 récupère le contenu de macle2 (boite paramètre) |
| − | *Composition du document XML en XPS | + | *Composition du document XML en XPS (boite Designer) |
| − | *Conversion du XPS en PDF | + | *Conversion du XPS en PDF (Boite de conversion vers PDF) |
| − | *Envoi du résultat dans la réponse de la requête SOAP | + | *Envoi du résultat dans la réponse de la requête SOAP (Boite "Affichage dans le navigateur") |
| + | |||
{{warning}} La boite permettant de renvoyer le résultat au consommateur doit se trouver dans le Workflow déclenché par le WebService. Elle ne peut en aucun cas se trouver dans un sous workflow invoqué par un "call". | {{warning}} La boite permettant de renvoyer le résultat au consommateur doit se trouver dans le Workflow déclenché par le WebService. Elle ne peut en aucun cas se trouver dans un sous workflow invoqué par un "call". | ||
Version du 12 avril 2019 à 07:20
Sommaire
Introduction
mapSoapRunStreamFromPost est une méthode du WebService "mapsoapserver.exe"
Cas d'usage :
- Envoyer un fichier à Mapping pour récupérer de manière synchrone un fichier réponse (par exemple transmission d'un XML et réception d'un PDF en retour)
- Envoyer un fichier de grande taille à Mapping, pour un traitement asynchrone
Utilisation
- Methode POST
- Contrairement à la méthode mapUploadFile, l'utilisation de mapSoapRunStreamFromPost permet d'invoquer un workflow
- Le contenu du fichier doit être passé directement à la place de l'enveloppe XML, tel quel (pas d'encodage en base64)
- Tous les paramètres <key/value> doivent être passés exclusivement dans l'URL (il n'y a pas d'enveloppe XML)
- Dans le workflow :
- Les couples key/value sont récupérables sous forme de variables [%xxxx%]
- Le fichier est identifié par [%MAP_FILE_IN%]
Exemple de requête SOAP
curl -u mapadmin:mapadmin -X POST --data-binary "@/tmp/mon_fichier.pdf" "http://192.168.100.14:8002/cgi-bin/mapsoapserver.exe/mapSoapRunStreamFromPost?workflow=testsoap&key=macle1&value=mavaleur1&key=macle2&value=mavaleur2"
Remarques :
- Si l'un des paramètres "key" a pour valeur "worfklow", cela permet de spécifier le nom du workflow à invoquer. S'il n'est pas renseigné, c'est le workflow "root" qui est appelé.
- "macle1" et "mapcle2" sont 2 méta données récupérables dans le workflow.
- La présence du @ dans l'option --data-binary permet de spécifier qu'il s'agit d'un fichier.
- Le fichier transmis étant un PDF, l'option utilisée est --data-binary , mais pour les fichiers "texte", l'option serait "--data"
Exemple de workflow pour traitement asynchrone
- La variable param1 récupère le contenu de macle1 (boite paramètre)
- La variable param2 récupère le contenu de macle2 (boite paramètre)
- La boite "Print" permet d'envoyer le fichier dans la file d'attente "MON_ENTRY" (boite "Imprimer")
- Le fichier transmis dans le flux du WebService est [%MAP_FILE_IN%]
- La coche "Ajouter les paramètres courants" permettent de transmettre les variables param1 et param2 avec le fichier dans la file d'attente "MON_ENTRY"
Exemple de workflow pour traitement synchrone
- La variable param1 récupère le contenu de macle1 (boite paramètre)
- La variable param2 récupère le contenu de macle2 (boite paramètre)
- Composition du document XML en XPS (boite Designer)
- Conversion du XPS en PDF (Boite de conversion vers PDF)
- Envoi du résultat dans la réponse de la requête SOAP (Boite "Affichage dans le navigateur")
La boite permettant de renvoyer le résultat au consommateur doit se trouver dans le Workflow déclenché par le WebService. Elle ne peut en aucun cas se trouver dans un sous workflow invoqué par un "call".
