Comment créer un diagramme de flux à partir d'un CSV

En bref

• Une ligne par étape. La position d'une ligne dans le fichier est son identité.
• Les noms d'en-tête correspondent au mappage (Forme, Texte de la zone, Ligne vers, Texte de la ligne) et l'ordre des colonnes n'a pas d'importance.
• Le texte de la boîte dessine seul des boîtes non connectées. La ligne vers est la colonne qui dessine les flèches.
• Le texte de la ligne s'associe à la ligne vers par position : "6,4" à côté de "Oui, Non" place Oui sur la flèche menant à la ligne 6.
• La voie horizontale et la voie verticale sont les deux dernières colonnes à remplir et transforment l'organigramme en un diagramme à couloirs.

Que saisir dans chaque colonne et dans quel ordre

Un CSV est une exportation. Quelque chose d'autre l'a produit (un service d'assistance, un ERP, un outil de formulaire, un rapport de file d'attente), et ce qui en est sorti est du texte brut : une ligne d'en-tête, puis une ligne par enregistrement, des champs séparés par des virgules, des guillemets doubles autour de tout champ contenant une virgule ou un saut de ligne. Il n'y a pas de formules, pas de deuxième feuille, pas de couleurs et pas de commentaires, car le format n'a nulle part où les mettre. Cette simplicité est la raison pour laquelle un fichier CSV voyage entre deux systèmes qui ne s'accordent sur rien d'autre, et c'est aussi pourquoi le fichier en lui-même ne signifie rien. Quelle que soit la raison d'être d'une colonne, elle figure dans son nom d'en-tête.

L'éditeur de QueryChart est une feuille de calcul avec des noms de colonnes fixes : #, Forme, Texte de la zone, Ligne vers, Texte de ligne, Style de ligne, Voie horizontale, Voie verticale, Parallèle avec, Notes et Lien. Un CSV correspond à ceux-ci par nom d'en-tête plutôt que par position de colonne, donc l'ordre dans lequel se trouvent vos colonnes n'a pas d'importance et toute colonne que l'éditeur ne reconnaît pas est conservée et ignorée. Vous importez en déposant le fichier .csv dans la zone de la feuille de calcul ou en y collant le texte CSV. Il n'y a pas d'assistant ni rien à mapper à la main : la ligne d'en-tête est le mappage, c'est pourquoi la ligne d'en-tête est la partie qui mérite d'être corrigée.

Reste la vraie question de savoir quoi taper. Remplissez les colonnes dans cet ordre et vous pourrez regarder chacune faire son travail. Le texte de la boîte à lui seul vous donne une colonne de boîtes non connectées, ce que restitue également un CSV d'enregistrements. Shape transforme les questions en losanges et les première et dernière rangées en terminateurs. La ligne vers est l'endroit où le diagramme apparaît : elle contient la position de la ligne à laquelle mène cette ligne, en comptant la première ligne de données pour 1, séparée par des virgules lorsqu'une ligne mène à plusieurs endroits, le texte de la ligne portant les étiquettes de branche dans le même ordre. La voie horizontale et la voie verticale viennent en dernier et transforment la chaîne en grille.

L'exemple ci-dessous est un tri de tickets d'assistance (dix-huit lignes) construit exactement dans cet ordre. Ouvrez le panneau de la feuille de calcul et lisez quelle colonne remplit chaque étape. Avant d'importer votre propre fichier, ouvrez-le une fois dans un éditeur de texte brut plutôt que dans une feuille de calcul : un délimiteur de point-virgule, deux lignes de préambule au-dessus de la ligne d'en-tête ou un encodage qui transforme les noms accentués en caractères de remplacement interrompront chacun l'importation, et une feuille de calcul masque les trois en restituant le fichier au lieu de l'afficher. /fr/guides/comment-structurer-un-fichier-csv-pour-les-organigrammes couvre entièrement cet aspect.

Comment cela fonctionne

1. Démarrer un nouveau fichier plutôt que de convertir l'export

   Le CSV que vous possédez déjà comporte une ligne par ticket, ligne de commande ou enregistrement. Le fichier que vous êtes sur le point d'écrire comporte une ligne par étape, et il y en a généralement moins de vingt pour un processus qui a produit dix mille enregistrements. Gardez l'exportation ouverte à côté de vous, car ses noms de file d'attente, ses codes d'état et ses groupes d'affectation constituent le véritable vocabulaire du processus, mais écrivez le graphique dans un nouveau fichier.

2. Mettez la ligne d'en-tête sur la première ligne

   Tapez les noms utilisés par l'éditeur, épelés comme il les épelle : Forme, Zone de texte, Ligne vers, Texte de ligne, et plus tard Voie horizontale et Voie verticale. Rien ne peut se trouver au-dessus de cette ligne (pas de titre, pas d'horodatage d'exportation, pas de ligne vide) car la correspondance est effectuée sur la première ligne du fichier. Les colonnes que vous conservez pour votre propre référence, comme l'identifiant d'enregistrement d'origine, peuvent rester là où elles se trouvent et seront conservées intactes.

3. Écrire le texte de la zone, une action par ligne

   Une ligne est une chose que quelqu'un fait. Divisez toute ligne dont le texte contient « et » et supprimez les lignes qui nomment une phase plutôt qu'une action : « Triage » est un en-tête, « Définir la priorité en fonction de l'impact et de l'urgence » est une étape. Importez à ce stade si vous voulez le voir : vous obtiendrez une colonne de cases sans flèches, qui est l'image honnête d'un fichier comportant des étiquettes et aucune relation.

4. Remplir la forme

   Commencez par la première ligne, Décision sur chaque ligne qui pose une question et Succès, Rejet ou Fin à chaque fin. Le processus est la valeur par défaut, ces cellules peuvent donc rester vides. Utilisez les orthographes utilisées par l'éditeur : une valeur qu'il ne reconnaît pas devient un processus sans problème, et une décision dessinée sous forme de rectangle conserve ses étiquettes de branche, ce qui permet de rater facilement l'erreur.

5. Remplissez Ligne vers, puis Texte de ligne

   La ligne vers prend la position de la ligne cible, en comptant la première ligne de données comme 1, séparée par des virgules lorsqu'une ligne mène à plusieurs emplacements. Le texte de la ligne prend les étiquettes de branche dans le même ordre, donc la première étiquette appartient au premier numéro. Écrivez chaque ligne avant de numéroter quoi que ce soit : la ligne vers est positionnelle, donc l'insertion d'une étape plus tard décale chaque ligne en dessous et invalide chaque référence au-delà du point d'insertion. Si une étape doit être ajoutée par la suite, ajoutez-la à la fin et pointez-la d'où elle appartient.

6. Ajoutez les voies, enregistrez au format UTF-8 et déposez le fichier dans

   Placez la scène dans la voie horizontale et le rôle dans la voie verticale, puis enregistrez le fichier au format UTF-8 avec des délimiteurs par virgule et ouvrez-le dans un éditeur de texte pour confirmer que c'est bien ce que vous avez obtenu. Déposez le .csv dans la zone de la feuille de calcul de l'éditeur ou collez-y le texte. Le graphique s'affiche au fur et à mesure qu'il atterrit et les bords s'acheminent eux-mêmes, il n'y a donc pas d'étape de mise en page : ce que vous vérifiez ensuite, c'est si une case n'a pas de flèche qui la quitte.

Erreurs à éviter

• Importer l'export au lieu d'écrire un nouveau fichier

  Un fichier avec une ligne par enregistrement n'a pas de colonne pouvant contenir un bord, il est donc importé sous la forme d'un champ de cases non connectées, une par enregistrement, ce qui pour une exportation réelle signifie des centaines. L'export est une source de vocabulaire, pas une source de structure.

• Ligne pour conserver un identifiant plutôt qu'une position de ligne

  Les numéros de ticket, les codes d'étape et les étiquettes des autres étapes sont tous supprimés silencieusement : aucune erreur, aucun avertissement, juste une case sans flèche qui la quitte. Il s'agit de la position de la ligne cible dans le fichier, en comptant la première ligne de données pour 1. /fr/guides/comment-definir-des-connexions-d-organigramme-en-csv effectue l'adressage en détail.

• Une virgule sans guillemets à l'intérieur d'une étiquette

  Le texte de la ligne est divisé en virgules, et cette division se produit APRÈS la suppression des guillemets CSV, donc l'enveloppement du champ ne vous sauve pas. Une étiquette écrite « Non, escalader » devient deux étiquettes, l'association avec Line pour décaler d'une unité et les dommages font surface comme un connecteur pointant vers un endroit inattendu plutôt que comme une mauvaise légende. Écrivez plutôt « Non, faites remonter ». C’est le seul endroit où l’on ne peut pas échapper à une virgule, c’est pourquoi il vaut la peine de le connaître avant d’exporter.

• Insérer une ligne après l'écriture des nombres

  Chaque référence en dessous du point d'insertion pointe désormais une ligne trop haut et le graphique s'affiche toujours de manière erronée. Terminez d'abord la liste des étapes, numérotez ensuite, et ajoutez plutôt que d'insérer une fois que les numéros existent.

Questions fréquentes

Quel est le plus petit CSV permettant de dessiner un organigramme ?

Deux colonnes. Une ligne d'en-tête indiquant Texte de la zone, Ligne vers, puis une ligne par étape avec l'étiquette et la position de la ligne à laquelle elle mène : un processus en quatre étapes comprend quatre lignes sous un en-tête, avec 2, 3, 4 et une cellule vide dans la deuxième colonne. Cela dessine une chaîne de rectangles avec des flèches entre eux. La forme est la troisième colonne qui mérite d'être ajoutée, car sans elle, chaque case est un rectangle et une question s'affiche de la même manière qu'une instruction, et le texte de la ligne est la quatrième, car une décision avec des sorties sans étiquette indique au lecteur qu'un jugement se produit mais pas dans quelle direction aller ensuite.

Est-ce que Line prend le numéro de ligne ou un identifiant ?

La position de la ligne cible dans le fichier, en comptant la première ligne de données comme 1, le même nombre que l'éditeur imprime dans sa colonne #. Il ne s'agit pas de l'identifiant d'enregistrement du système d'où le CSV est issu, ni d'un code d'étape que vous avez inventé, même si vous avez conservé cette colonne dans le fichier. Tout ce qui ne correspond pas à une position de ligne existante est supprimé sans aucune erreur, donc un fichier qui est systématiquement décalé de un parce que la ligne d'en-tête a été comptée comme la ligne 1 s'affiche sous forme de boîtes sans flèches et rien n'indique pourquoi.

Comment rédiger une décision à deux branches ?

Définissez la forme sur Décision, placez les deux positions cibles dans la ligne séparées par une virgule et placez les deux étiquettes dans le texte de la ligne dans le même ordre. "6,4" à côté de "Oui, Non" envoie Oui à la ligne 6 et Non à la ligne 4 ; inverser une liste et non l’autre produit un graphique erroné de la manière la plus convaincante possible, car il semble toujours complet. Si une étiquette elle-même contient une virgule, placez ce champ entre guillemets doubles. Un processus de branchement entièrement construit à partir de ce modèle se trouve chez /fr/templates/modele-d-arbre-de-decision-csv-eligibilite-au-remboursement.

Quelles valeurs la colonne Forme peut-elle prendre ?

Début, Processus, Décision, Fin, Succès et Rejet couvrent presque tous les diagrammes de processus, et il y en a d'autres pour des cas spécifiques : parmi eux, Fichier, Entrée, Sortie et Préparation. Le processus est ce que vous obtenez pour une cellule vide, et c'est aussi ce que vous obtenez pour une valeur que l'éditeur ne reconnaît pas, qui est la partie à surveiller : il n'y a pas d'erreur d'importation, donc une colonne de formes écrites dans le vocabulaire d'un autre outil s'importe proprement et dessine chaque décision sous forme de rectangle. Vérifiez les diamants après la première importation plutôt que de supposer.

Dois-je conserver le CSV une fois le graphique existant ?

Conservez-le comme enregistrement de ce que vous avez importé, et non comme élément que vous modifiez. Après l'importation, le graphique est le maître : modifier les lignes dans l'éditeur, c'est modifier le diagramme, car il s'agit du même objet, et maintenir le fichier en parallèle recrée exactement la dérive que la conversion était censée supprimer. Là où un CSV continue de gagner sa place, c'est au début du graphique suivant : csv contient un fichier par type de graphique, et copier l'un de ceux-ci est plus rapide que d'écrire une ligne d'en-tête à partir de la mémoire.