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


<info>
	<title type="sort">3</title>
	<link type="guide" xref="index#workflows" />
	  <desc>Créer, modifier, supprimer un workflow</desc>
</info>
      
<title>Gérer les workflow</title>

<note style="important">
	<title>Associer un workflow à un formulaire</title>
	<p>La façon dont on associe un workflow à un formulaire est traitée <link xref="workflows_form">sur cette page</link></p>
</note>

<section id="creer_workflow">
	<title>Créer un workflow</title>

	<p>Lorsque le workflow par défaut ne convient pas à votre formulaire, vous devez créer un workflow personnalisé et l'adapter à votre besoin.</p>

	<note style="advanced">
		<title>Basez-vous sur un autre workflow de préférence</title>
		<p>Nous allons décrire comment créer entièrement un workflow, mais il est souvent préférable, en particulier quand on débute, de <link xref="#creer_workflow_depuis_modele">s'appuyer sur un workflow existant</link>. Cela facilite la compréhension des mécanismes.</p>
	</note>
	
	<section id="creer_workflow_ex_nihilo">
		<title>Créer un workflow ex nihilo</title>
		
		<p>Dans l'interface d'administration, cliquez sur « Workflow » puis sur « Nouveau workflow » :</p>

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

		<p>Attribuez un nom au workflow et validez, vous êtes redirigé sur la page d'édition du workflow. Pour ajouter un statut, attribuez-lui un nom dans le menu « Nouveau statut » à droite :</p>

		<figure>
			<media type="image" src="figures/workflow_nouveau_statut.png" />
		</figure>
		<note style="advanced">
			<title>Statuts</title>
			<p>Pour en savoir plus, vous pouvez consulter la page consacrée aux <link xref="workflows_statuts">statuts</link></p>
		</note>

		<p>Une fois ajouté, votre statut apparaît sous deux formes :</p>

		<list>
			<item><p>Dans une liste :</p></item>
		</list>

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

		<list>
			<item><p>Dans un schéma :</p></item>
		</list>

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


		<p>En cliquant sur le statut - sur son nom dans la liste ou sur son nom dans le schéma - vous êtes redirigés sur la page d'édition du statut.</p>

		<p>Pour ajouter un élément vous devez aller dans le menu « Nouvel élément « à droite choisir un type et cliquer sur « Ajouter » :</p>

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

		<p>De la même manière que pour le statut, l'élément apparaît dans la liste et dans le schéma de la page du statut :</p>

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

		<p>Vous pouvez cliquer sur l'élément dans le schéma ou dans la liste pour l'éditer.</p>

		<note style="advanced">
			<title>Statuts et Actions</title>
			<p>Dirigez-vous vers les pages consacrées aux <link xref="workflows_statuts">statuts</link> et aux <link xref="workflows_actions">actions</link> pour comprendre leur fonctionnement.</p>
		</note>

	</section>

	<section id="creer_workflow_depuis_modele">
		<title>Créer un workflow à partir d'un autre workflow</title>
		
		<p>Partir d'un autre workflow est la solution recommandée pour en créer un nouveau. Il faut commencer par dupliquer un workflow existant, puis le modifier.</p>

		<section id="dupliquer_workflow">
			<title>Dupliquer un workflow existant</title>
	
			<p>Nous prendrons l'exemple de la duplication du workflow par défaut même si l'opération peut-être réalisée avec n'importe quel workflow.</p>
			<p> Depuis l'interface d'administration, cliquez sur <em>Workflow</em> et cliquez sur le workflow <em>Par défaut</em>.</p>

			<p>Cliquez sur <em>Dupliquer</em> à droite :</p> 
  
			<figure>
				<media type="image" src="figures/workflow_dupliquer_defaut.png" />
			</figure>
  
			<p>Un nouveau workflow est créé, nommé <em>Par défaut (copie)</em>, vous êtes redirigé sur sa page.</p>

		</section>

		<section id="modifier_copie_workflow">
			<title>Modifier la copie du workflow</title>
	
			<p>Cliquez sur <em>Changer le titre</em>, dans le champ <em>Nom du workflow</em> remplacez <em>Par défaut (copie)</em> par le titre de votre choix et validez :</p>

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

			<p>Vous êtes redirigé dans le menu <em>Workflow</em>, vous pouvez maintenant éditer et modifier les statuts de ce workflows, les supprimer ou en ajouter de nouveaux.</p>

			<note style="advanced">
				<title>Statuts et Actions</title>
				<p>Dirigez-vous vers les pages consacrées aux <link xref="workflows_statuts">statuts</link> et aux <link xref="workflows_actions">actions</link> pour comprendre leur fonctionnement.</p>
			</note>
			
		</section>
		

	</section>

</section>

<section id="import_export_workflow">
	<title>Comment importer / exporter un workflow</title>

		<section id="import_workflow">
		<title>Importer un workflow</title>

		<p>Depuis l'interface d'administration, cliquez sur <em>Import</em>, vous pouvez alors choisir un fichier sur votre poste de travail.</p> 

		<figure>
			<media type="image" src="figures/workflow_lien_import.png" />
		</figure>
		
		<p>Sélectionnez le fichier .wcs qui contient le workflow et confirmez, le workflow est importé.</p>
		
		<note style="warning">
  			<title>Rôles à vérifier</title>
  			<p>Certains rôles du workflow importé peuvent ne pas exister dans votre solution. Il vous faudra alors modifier le workflow manuellement pour le faire correspondre aux rôles existant dans votre application.</p>
		</note>
  
  	</section>

  
	<section id="export_workflow">
	    <title>Exporter un workflow</title>
    
	    <p>Cliquez sur le workflow que vous souhaitez exporter, puis dans le menu à droite cliquez sur <em>Export</em> et enregistrez-le dans un fichier .wcs (l'extension est positionnée automatiquement) :</p>

		<figure>
			<media type="image" src="figures/workflow_lien_export.png" />
		</figure>
		
		<p>Le workflow est exporté, prêt à être importé dans une autre instance de Au quotidien ou déposé sur le site communautaire.</p>
    
	</section>

</section>

<section id="suppr_workflow">
		<title>Comment supprimer un workflow</title>

		<p>Depuis l'interface d'administration, allez dans <em>Workflow</em> et cliquez sur le workflow que vous souhaitez supprimer. Puis cliquez sur <em>Supprimer</em> dans le menu à droite et validez :</p>

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

</section>
	
</page>
