<page xmlns="http://projectmallard.org/1.0/"
      type="topic"
      id="workflows_actions">

<info>
	 <title type="sort">6</title>
	<link type="guide" xref="index#workflows" />
	  <desc>Les actions utilisables à chaque étape du workflow</desc>
</info>
      
<title>Les actions de workflow</title>

<p>Les actions sont les éléments de base que l'on combine au sein d'un <link xref="workflows_statuts">statut</link> pour déterminer ce qui va se passer lorsqu'une demande atteint le statut en question.</p>
<p>Les actions permettent notamment d'envoyer des mails/sms à différentes personnes, de changer le destinaire de la demande, de dialoguer avec le demandeur, de modifier la demande, de créer un document à partir de la demande, de communiquer avec des webservices, de changer de statut... </p>
<section id="ajouter-action">
	<title>Ajouter une action</title>

<p>Pour ajouter une action à un statut cliquez sur le statut en question, puis choisissez une action dans la liste déroulante et cliquez sur ajouter :</p>

	<figure>
			<media type="image" src="figures/ajouter_action.png" />
	</figure>	

</section>

<section id="editer-action">
	<title>Éditer une action</title>

<p>Pour éditer une action, cliquez sur le lien « éditer » qui apparaît au survol de l'action :</p>

	<figure>
			<media type="image" src="figures/editer_action.png" />
	</figure>	

</section>

<section id="supprimer-action">
	<title>Supprimer une action</title>

<p>Pour supprimer une action, cliquez sur le lien « supprimer » qui apparaît au survol de l'action :</p>

	<figure>
			<media type="image" src="figures/supprimer_action.png" />
	</figure>	

</section>

<section id="types">
	<title>Les différents types d'action</title>

	<section id="afficher_formulaire">
		<title>Afficher un formulaire</title>
		
<p>
Lors du traitement d'une demande il peut être nécessaire de demander des informations supplémentaires à l'usager, ou qu'un agent complète la demande avec des informations internes (à l'image d'un « cadre réservé à l'administration » sur du papier).
</p>

<p>L'action « Afficher un formulaire » permet d'afficher des champs de formulaire supplémentaires (tous les champs w.c.s. sont disponibles) à un rôle particulier : demandeur (expéditeur), destinataire (gestionnaire de la demande) ou n'importe quel autre rôle utilisé dans w.c.s..</p>

		<figure>
			<title>Afficher un formulaire</title>
			<media type="image" src="figures/afficher_formulaire.png" />
		</figure>

		<p>Lors de l'édition de cette action choisissez le rôle concerné, donnez un nom au formulaire ( « Nom de variable »), puis cliquez sur « Éditer les champs » pour ajouter les champs souhaités. L'ajout se fait exactemment comme pour un <link xref="form_simple">formulaire classique</link> de w.c.s., vous ajoutez autant de champs que vous le souhaitez. Après validation, le formulaire est créé, au sein du statut concerné.</p>

	<note style="important"><p>
	Il est important de préciser pour chaque champ du formulaire un <gui>Nom de <link xref="workflows_variables">variable</link></gui> si l'on souhaite réutiliser, ailleurs dans le workflow, la valeur saisie.
	</p></note>

	</section>

	<section id="afficher_message">
		<title>Afficher un message</title>
		<p>Cette action permet d'afficher un message au demandeur lorsqu'il a validé sa demande. Dans le texte du message vous pouvez introduire du code html ainsi qu'un certain nombre de <link xref="workflows_variables">variables</link> prédéfinies (rappelées sous la fenêtre de texte).</p>


		<figure>
			<title>Afficher un message</title>
			<media type="image" src="figures/afficher_message.png" />
		</figure>

	</section>


	<section id="message_recapitulatif">
		<title>Agréger dans un message de récapitulatif</title>
		<p>Ce statut permet d'envoyer quotidiennement à un gestionnaire la liste des demandes qui sont dans le statut concerné. Par exemple, on pourra envoyé chaque matin à l'agent en charge du trairement un mail rappellant toutes les demandes ayant le statut « en attente de traitement ».</p>

		<figure>
			<title>Message de récapitulatif</title>
			<media type="image" src="figures/message_recapitulatif.png" />
		</figure>

	</section>

	<section id="ajouter_role_expediteur">
		<title>Ajouter un rôle à l'expéditeur</title>

		<p>Si l'on souhaite que le demandeur se voit attribué un rôle particulier dans le statut concerné, on lui ajoute ce rôle avec cette action. Le rôle vient s'aditionner aux rôles existants pour le demandeur, pas s'y substituer.</p>

		<figure>
			<title>Ajouter un rôle à l'expéditeur</title>
			<media type="image" src="figures/ajouter_role_expediteur.png" />
		</figure>

	</section>

	<section id="webservice">
		<title>Appeler un webservice</title>

		<p>Cette action permet de lier w.c.s. à une application tierce grâce à la saisie d'une URL webservices :</p>

		<figure>
			<title>Appeler un webservice</title>
			<media type="image" src="figures/webservice.png" />
		</figure>

		<p>L'URL peut contenir un certain nombre de <link xref="workflows_variables">variables</link> système ou spécifiques à la demande. Le champ nom de variable permet de préciser la variable dans laquelle sera stockeé la réponse du webservice.</p>
	</section>

	<section id="attribuer_fonction">
		<title>Attribuer une fonction</title>
		<p>Cette action permet d'attribuer la fonction de destinataire ou d'expéditeur à un rôle particulier. Il peut, par exemple, s'avérer utile de réaffecter la demande à un nouveau destinataire à une étape particulière (par exemple suite à une validation hiérarchique).</p>

		<figure>
			<title>Attribuer une fonction</title>
			<media type="image" src="figures/attribuer_fonction.png" />
		</figure>

	</section>


	<section id="changer_statut">
		<title>Changer de statut</title>
		<p>Cette action permet de basculer d'un statut à un autre : accepté, refusé, transmis, etc.. L'action est affichée lors du traitement de la demande, sous forme d'un bouton à disposition des gestionnaires.</p>
		<p>Il vous faut définir l'intitulé du bouton pour la personne en charge du traitement, puis le statut associé, enfin les rôles pouvant interagir avec ce bouton.</p>
		<p>Sur le schéma cette action est representée par une flèche associant les deux statuts concernés.</p>

		<figure>
			<title>Changer de statut</title>
			<media type="image" src="figures/changer_statut.png" />
		</figure>

	</section>

	<section id="changer_statut_automatique">
		<title>Changer de statut automatiquement</title>
		<p>Le changement de statut automatique permet de basculer d'un statut à un autre sans intervention manuelle. Le basculement s'opère soit :</p> 
		<list>
			<item><p>Lorsqu'une condition basée sur une variable est satisfaite (Champ « Condition »);</p></item>
			<item><p>Lorsqu'un webservice déclenche une action (Champ « Déclencheur ») ;</p></item>
			<item><p>Lorsqu'un délais est appliqué (Champ « Expiration »)</p></item>
		</list>

		<figure>
			<title>Changer de statut automatiquement</title>
			<media type="image" src="figures/changer_statut_automatiquement.png" />
		</figure>

	</section>

	<section id="changer_statut_soumission">
		<title>Changer de statut à la soumission</title>
		<p>Cette option est obsolète. Elle existe pour des raisons de compatibilité mais ne doit plus être utilisée.</p>

		<figure>
			<title>Changer de statut à la soumission</title>
			<media type="image" src="figures/changer_statut_soumission.png" />
		</figure>

	</section>

	<section id="workflow_document">
		<title>Créer un document</title>
		<p>Il peut-être utile de créer un document à partir d'une demande, c'est possible avec cette action.</p>

		<figure>
			<title>Créer un document</title>
			<media type="image" src="figures/workflow_document.png" />
		</figure>

		<p>Il suffit de choisir un libellé pour le bouton affiché au destinataire pour lui permettre de générer ce document et de faire un modèle de document au format RTF. Ce modèle peut contenir un certain nombre de <link xref="workflows_variables">variables</link> prédéfinies (rappelées sous la fenêtre de texte).</p>

	</section>


	<section id="enregistrer_journal">
		<title>Enregistrer dans le journal</title>
		<p>Cette action permet de saisir un commentaire qui sera affiché dans le journal, c'est à dire dans l'historique de la demande, aussi bien pour le demandeur que pour le destinataire.</p>

		<figure>
			<title>Enregistrer dans le journal</title>
			<media type="image" src="figures/enregistrer_journal.png" />
		</figure>

	</section>


	<section id="sms_email">
		<title>Envoyer un SMS / Envoyer un mail</title>
		<p>Il est possible d'envoyer des SMS et des courriels automatiquement. Ces messages disposent d'une liste de <link xref="workflows_variables">variables</link> permettant d'appeler les détails de la demande ou/et de l'usager afin de personnaliser les messages (rappelées sous la fenêtre de texte).</p>

	<p>Ces messages peuvent être des courriels ou des SMS (pour les plateformes disposant d'un abonnement SMS).</p>

		<figure>
			<title>Envoyer un SMS / Envoyer un mail</title>
			<media type="image" src="figures/sms_email.png" />
		</figure>

	</section>

	<section id="workflow_joindre_fichier">
		<title>Permettre de joindre un fichier</title>
		<p>L'action permet à un rôle particulier (demandeur, destinataire ou tout rôle w.c.s.), de pouvoir ajouter un fichier à la demande</p>
		<p>On peut définir un titre (s'affichant avant le bouton de téléchargement), le libellé du bouton, une remarque s'affichant juste en dessous du bouton, ainsi que le caractère obligatoire ou facultatif du champ :</p>

		<figure>
			<title>Permettre de joindre un fichier</title>
			<media type="image" src="figures/workflow_joindre_fichier.png" />
		</figure>

	</section>

	<section id="workflow_edition">
		<title>Permettre l'édition</title>
		<p>Cette fonction permet à un rôle particulier (demandeur, destinataire ou tout rôle w.c.s.) d'éditer, donc de modifier un formulaire déjà validé.</p>

		<figure>
			<title>Permettre l'édition</title>
			<media type="image" src="figures/workflow_edition.png" />
		</figure>

	</section>

	<section id="workflow_commentaire">
		<title>Permettre un commentaire</title>
		<p>Cette action permet à un rôle particulier (demandeur, destinataire ou tout rôle w.c.s.) de commenter le formulaire. Cela est fréquemment utilisé pour permettre un premier échange entre expéditeur et destinataire concernant la demande : on crée alors une action « Permettre un commentaire » avec 2 rôles, expéditeur et destinataire.</p>

		<figure>
			<title>Permettre un commentaire</title>
			<media type="image" src="figures/workflow_commentaire.png" />
		</figure>

	</section>

	<section id="workflow_supprimer_formulaire">
		<title>Supprimer le formulaire</title>
		<p>Cette action permet de supprimer le formulaire afin, par exemple, de respecter le délais légal de sotckage des données personnelles.</p>

		<figure>
			<title>Supprimer le formulaire</title>
			<media type="image" src="figures/workflow_supprimer_formulaire.png" />
		</figure>

	</section>

	<section id="wokflow_supprimer_role">
		<title>Supprimer un rôle de l'expéditeur</title>
		<p>Cette action permet de supprimer un rôle dont dispose l'expéditeur. Par exemple si le formulaire concerne une résiliation, on va, en fin de traitement, enlever le rôle « Abonné » au demandeur.</p>

		<figure>
			<title>Supprimer un rôle de l'expéditeur</title>
			<media type="image" src="figures/workflow_supprimer_role.png" />
		</figure>

	</section>

</section>

</page>
