FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page

2019-10-29T10:17:12Z

Mise à jour pour être en accord avec la nouvelle version de la source de la page

Nouvelle page

<languages/>
===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. Tous types de fichiers sont acceptés.

===Utilisation===

*Methode POST
*Paramètres :
:- Workflow : nom du workflow Mapping à invoquer
:- Couples key/value : méta données
:- Fichier à envoyer
:- Type de réponse (XML avec fichier encodé en base64, ou directement le fichier)
::Exemples : XML, PDF, XPS, TXT, CSV, EXE, JPG, PNG, ZIP etc...

*Contrairement à la méthode mapUploadFile, l'utilisation de mapSoapRunStreamFromPost permet d'invoquer un workflow
*Le contenu du fichier doit être passé directement dans le corps, sans enveloppe et sans 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 utilisables dans le workflow sous forme de variables [%xxxx%]
**Le fichier est identifié par la variable [%MAP_FILE_IN%]
* Si le paramètre "getobject=1" est ajouté à l'URL, le corps de la réponse contient directement le fichier issu du workflow sans enveloppe XMLS ni encodage en base64.

===Exemple de requête SOAP===

'''Avec un fichier PDF'''

<code>curl -u mapadmin:mapadmin -X POST --data-binary "@/tmp/mon_fichier.pdf" "http://192.168.100.14:8002/cgi-bin/mapsoapserver.exe/mapSoapRunStreamFromPost?key=workflow&value=testsoap&key=macle1&value=mavaleur1&key=macle2&value=mavaleur2"</code>

'''Avec un fichier XML'''

<code>curl -u mapadmin:mapadmin -X POST --data "@/tmp/mon_fichier.xml" "http://192.168.100.14:8002/cgi-bin/mapsoapserver.exe/mapSoapRunStreamFromPost?key=workflow&value=testsoap&key=typdoc&value=facture&key=enseigne&value=mag_paris&getobject=1"</code>

<u>Remarques</u> :

*Le paramètre "'''worfklow'''", permet de spécifier le nom du workflow à invoquer. S'il n'est pas renseigné, c'est le workflow "root" qui est appelé.
*"macle1", "mapcle2", "typdoc" et "enseigne" sont des exemples de méta données récupérables dans le workflow, permettant à Mapping d'effectuer le traitement adapté au fichier.
*La présence du @ dans l'option --data-binary permet de spécifier qu'il s'agit d'un fichier.
*Dans le premier exemple, le fichier transmis étant un PDF, l'option utilisée est --data-binary , mais pour les fichiers "texte", comme l'exemple XML, l'option pourrait être "--data"
* Dans le 2ème exemple, le paramètre "getobject=1" permet d'avoir une réponse de type "octet-stream", sans enveloppe XML ni encodage en base64

===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"

<br />
[[Fichier:OX S workflow mapsoaprunstreamfrompost1.png|alt=|centré|354x354px|sans_cadre]]
[[Fichier:OX S Workflow mapsoaprunstreamfrompost2.png|alt=|centré|828x828px|sans_cadre]]

===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")

{{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".

[[Fichier:OX S mapsoaprunstreamfrompost.png|centré|350x350px|alt=|sans_cadre]]
[[Fichier:OX S mapSoapRunStreamFromPost.png|centré|984x984px|alt=|sans_cadre]]

===Open Api Specification 3 (YAML)===

openapi: "3.0.0"
info:
title: mapSoapRunStreamFromPost
description: Send a file to Mapping
version: "0.0.0"
servers:
- url: "{protocol}://{server}:{port}/mapsoapserver.exe"
description: Local Server
variables:
protocol:
default: 'http'
server:
default: '127.0.0.1'
port:
default: '8002'
paths:
/mapSoapRunStreamFromPost:
post:
summary: Send a file to a Mapping Workflow
tags:
- mapSoapRunStreamFromPost
parameters:
- name: workflow
in: query
required: false
description: Name of the workflow to call
schema:
type: string
example: my_workflow
- name: key
in: query
required: false
description: key
explode: true
style: form
schema:
type: array
items:
type: string
example: my_key
- name: value
in: query
required: false
description: value
explode: true
style: form
schema:
type: array
items:
type: string
example: my_value
requestBody:
required: true
content:
application/octet-stream:
schema:
type: string
format: binary
responses:
'200':
description: Base64 response sent by the Workflow
content:
application/xml:
schema:
type: object
xml:
name: 'Envelope'
prefix: 'soap'
namespace: "http://schemas.xmlsoap.org/soap/envelope/"
properties:
Body:
type: object
xml:
prefix: soap
properties:
mapSoapRunStreamFromPostResponse:
type: object
properties:
mapSoapRunStreamFromPostResult:
type: object
properties:
document:
type: string
format: byte
description: base64 content

ONYX:9.0:Utilisation:mapSoapRunStreamFromPost/fr - Historique des versions

FuzzyBot : Mise à jour pour être en accord avec la nouvelle version de la source de la page