wcs/help/fr/api-workflow.page

50 lines
1.6 KiB
Plaintext
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<page xmlns="http://projectmallard.org/1.0/"
type="topic" id="api-workflow" xml:lang="fr">
<info>
<link type="guide" xref="index#api" />
<revision docversion="0.1" date="2013-01-04" status="draft"/>
<credit type="author">
<name>Frédéric Péters</name>
<email>fpeters@entrouvert.com</email>
</credit>
<desc>Workflow, états, transition, etc.</desc>
</info>
<title>Traitement d'un formulaire</title>
<p>
w.c.s expose une API autorisant les logiciels tiers à faire progresser le
traitement d'un formulaire; cela passe par la définition dans le statut du
workflow d'un élément de type « Changement de statut automatique », dans
lequel un identifiant de déclencheur est défini.
</p>
<p>
La demande d'un changement d'état se fait par une requête <code>POST</code> à
l'adresse du formulaire en question, suivi de <code>jump/trigger/</code> et de
la référence à l'identifiant de déclencheur.
</p>
<screen>
<output style="prompt">$ </output><input>curl -H "Accept: application/json" -X POST \
https://www.example.net/inscriptions/newsletter/14/jump/trigger/validate</input>
<output>{"url": null, "err": 0}</output>
</screen>
<p>
Il est également possible d'accompagner le déclenchement d'un changement
de statut d'une série de données, qui seront enregistrées dans les données de
workflow du formulaire.
</p>
<screen>
<output style="prompt">$ </output><input>curl -H "Content-type: application/json" -H "Accept: application/json" \
-X POST -d@donnes.json \
https://www.example.net/inscriptions/newsletter/14/jump/trigger/validate</input>
<output>{"url": null, "err": 0}</output>
</screen>
</page>