Comment importer un CSV dans un outil d'organigramme

En bref

• Deux manières d'y accéder : déposez le fichier .csv dans la zone de la feuille de calcul ou collez-y le texte CSV.
• Les colonnes sont mises en correspondance par nom d'en-tête et non par position, donc l'ordre d'exportation n'a pas d'importance.
• Les colonnes non reconnues sont transportées et ignorées : laissez les identifiants et les horodatages de votre exportation.
• La première ligne est lue comme en-tête, donc le titre du rapport au-dessus doit d'abord être supprimé.
• La ligne contient les numéros de ligne, de sorte que l'ordre dans lequel les lignes se trouvent dans le fichier fait partie des données.

Que se passe-t-il entre le fichier et le canevas

Il n'y a pas d'assistant d'importation. Un .csv entre dans QueryChart de deux manières : faites glisser le fichier sur la zone de la feuille de calcul sous le canevas, ou ouvrez-le dans un éditeur de texte, sélectionnez le texte et collez-le dans le tableau. Les deux empruntent le même chemin (la première ligne est lue comme en-tête, chaque ligne qui la suit devient une ligne) et le diagramme est restitué à partir de ces lignes au fur et à mesure qu'elles atterrissent. Rien ne vous demande de mapper les colonnes, car les noms d'en-tête le font.

La correspondance s'effectue par nom d'en-tête et non par position de colonne : Forme, Zone de texte, Ligne vers, Texte de ligne, Style de ligne, Voie horizontale, Voie verticale, Parallèle à, Notes, Lien. Votre export peut les émettre dans n'importe quel ordre. Les colonnes que QueryChart ne reconnaît pas (identifiants de ticket, horodatages, centre de coûts, les trois colonnes ajoutées par quelqu'un pour un rapport il y a deux ans) sont conservées et ignorées, donc supprimer le fichier avant de l'importer est un travail que vous n'avez pas à faire. La conception de la colonne elle-même est couverte par /fr/guides/comment-structurer-un-fichier-csv-pour-les-organigrammes.

Ce qui différencie le CSV du collage à partir d'une feuille de calcul, c'est qu'un CSV est un fichier texte brut et que les fichiers texte comportent leurs propres échecs. Le délimiteur peut être un point-virgule plutôt qu'une virgule, car c'est ce que produit une exportation d'une application vers une langue européenne. L'encodage peut ne pas être UTF-8, auquel cas les étiquettes accentuées et non latines arrivent sous la forme de mojibake. Un champ contenant une virgule doit être mis entre guillemets sinon il se divise en deux. Et une exportation à partir d'un outil de reporting s'ouvre généralement avec un titre de rapport et une date de génération au-dessus de l'en-tête : la première ligne du fichier est l'en-tête, ces lignes doivent donc disparaître.

L'exemple ci-dessous est un parcours d'essai SaaS jusqu'au renouvellement : 26 lignes, six décisions, trois résultats rejetés et une boucle depuis le rappel du jour 7 jusqu'à la configuration. Ouvrez le panneau de feuille de calcul en dessous et observez quelles colonnes se remplissent à chaque étape, car c'est l'ordre dans lequel les colonnes d'un fichier importé comptent, et les deux dernières sont celles que la plupart des exportations portent déjà sous un autre nom. Le graphique terminé et le CSV qui le produit se trouvent sur /fr/templates/modele-de-carte-de-parcours-client-csv-essai-saas-a-payant.

Comment cela fonctionne

1. Ouvrez le fichier et regardez la première ligne

   Ouvrez le .csv dans un éditeur de texte plutôt que dans Excel, car Excel cache précisément les problèmes. La première ligne doit être l'en-tête. Supprimez un titre de rapport, une ligne générée, toute ligne vide au-dessus de l'en-tête et toute ligne de totaux en bas, puis enregistrez.

2. Renommez les en-têtes avec les noms de colonnes de l'éditeur

   Forme, Zone de texte, Ligne vers, Texte de ligne, Style de ligne, Voie horizontale, Voie verticale, Parallèle à, Notes et Lien. Ce sont les noms qui correspondent, donc l'ordre dans lequel ils se trouvent n'a pas d'importance et une colonne que vous n'avez pas peut simplement être absente. Un en-tête qui n'est pas l'un de ces noms (« Étape suivante », « Type d'étape ») apparaît comme un extra ignoré plutôt que comme une erreur, c'est pourquoi une flèche manquante est presque toujours un problème d'en-tête.

3. Vérifiez le délimiteur et l'encodage

   Un fichier exporté par une application définie dans des paramètres régionaux européens est généralement séparé par des points-virgules et arrive avec la ligne entière dans une seule colonne. Réexportez et choisissez la virgule. Enregistrez au format UTF-8 pendant que vous y êtes : depuis Latin-1 ou UTF-16, les étiquettes accentuées et non latines apparaissent sous forme de mojibake, et la réexportation est plus rapide que de retaper chaque étiquette.

4. Citer chaque champ contenant une virgule

   Ligne vers et Texte de ligne sont des listes séparées par des virgules dans un seul champ, donc un fichier bien formé les cite toujours : « 20,18 » et « Achète un forfait, Expire sans paiement ». Il en va de même pour un texte de zone tel que « Approuver, puis déposer ». Une virgule non citée divise la ligne et tout ce qui se trouve à sa droite atterrit dans la mauvaise colonne sans que rien ne vous indique que cela s'est produit.

5. Déposez le fichier dans la zone de la feuille de calcul ou collez le texte

   Ouvrez un nouveau graphique, puis faites glisser le fichier .csv sur la zone de la feuille de calcul située sous le canevas ou collez le texte CSV directement dedans. Aucun assistant, aucun mappeur de colonnes et aucun écran de correspondance de champs n'apparaissent ; les lignes apparaissent dans le tableau et le diagramme en est rendu. Si vous n'êtes pas sûr du fichier, essayez-le d'abord dans un tableau de travail.

6. Vérifiez quatre choses au moment où les lignes atterrissent

   Un : le nombre de lignes est égal au nombre de lignes du fichier moins l'en-tête. Deux : la ligne 1 est votre première étape, pas votre texte d'en-tête. Trois : une ligne vers un numéro que vous connaissez déjà (celle qui boucle vers l'arrière est la plus facile à repérer) atterrit sur l'étape que vous vouliez dire. Quatre : les étiquettes des branches se trouvent sur les flèches que vous attendez. Dès lors, éditez le tableau plutôt que le fichier.

Erreurs à éviter

• Un titre de rapport au-dessus de la ligne d'en-tête

  Les exportations à partir des CRM et des systèmes de tickets s'ouvrent souvent avec le nom du rapport et une date de génération. La première ligne du fichier est lue comme en-tête, donc votre véritable en-tête devient la ligne 1 et chaque ligne jusqu'au numéro est décalée de un : un graphique qui s'affiche et est erroné. Supprimez ces lignes avant d'importer.

• Exportations délimitées par des points-virgules

  Une application définie sur des paramètres régionaux qui utilisent la virgule comme séparateur décimal écrit des points-virgules entre les champs, et chaque ligne arrive alors sous la forme d'une valeur unique. Réexportez en choisissant la virgule plutôt que de rechercher et de remplacer le séparateur, car le texte Ligne vers et Ligne contient leurs propres virgules et un remplacement global les corrompt.

• Trier le fichier après que la ligne vers soit remplie

  Ligne vers les points aux positions des lignes, et non aux identifiants de votre système source, donc le tri de l'exportation par propriétaire ou par date renumérote ensuite chaque étape sous les connexions. Remplissez la ligne jusqu'à la fin, et si des lignes doivent être déplacées, déplacez-les dans l'éditeur. /fr/guides/comment-definir-des-connexions-d-organigramme-en-csv couvre l'adressage dans son intégralité.

• S'attendre à ce qu'une colonne inégalée se plaigne

  Une colonne que QueryChart ne reconnaît pas est portée et ignorée : rien ne devient rouge et rien n'est perdu. C'est ce qui permet à une exportation de se dérouler intacte, et c'est aussi la raison pour laquelle un en-tête mal saisi échoue silencieusement : les données sont dans le fichier, elles sont sur la ligne et elles ne font rien.

Questions fréquentes

Existe-t-il un assistant d'importation ou un mappeur de colonnes ?

Non. Il existe deux manières d'entrer et chacune constitue une action unique : déposez le fichier .csv dans la zone de la feuille de calcul sous le canevas ou collez-y le texte CSV. Les colonnes sont mises en correspondance par nom d'en-tête, il n'y a donc rien à configurer et aucune étape de correspondance de champ pour se tromper. Lorsqu'une colonne semble n'avoir rien fait, la cause est le nom de l'en-tête plutôt qu'un paramètre que vous avez manqué.

Dois-je supprimer les colonnes que QueryChart n'utilise pas ?

Non. Les colonnes non reconnues sont conservées et ignorées, de sorte qu'une exportation contenant des identifiants de ticket, des horodatages, un centre de coûts et quatre colonnes de reporting peut être introduite exactement telle qu'elle est sortie. Les conserver ne coûte rien et préserve le lien vers l’origine des lignes. Le seul travail sur les colonnes qui vaut la peine d'être effectué en premier est de renommer celles que vous souhaitez faire correspondre : Texte de la zone, Ligne vers, Texte de la ligne, Forme et les colonnes à deux voies.

Mon fichier est arrivé sous forme d'une seule colonne. Ce qui s'est passé?

Le délimiteur n'est pas une virgule. Les exportations à partir d'applications définies dans des paramètres régionaux européens sont généralement séparées par des points-virgules, et un fichier séparé par des tabulations enregistré avec une extension .csv se comporte de la même manière. Réexportez et choisissez la virgule plutôt que de remplacer le séparateur à la main, car le texte Ligne vers et Ligne contient des listes séparées par des virgules qu'un remplacement global détruirait. Enregistrez en UTF-8 en même temps : un mauvais encodage apparaît comme mojibake dans les étiquettes, jamais comme une erreur.

Les lignes ont été importées mais aucune flèche n'est apparue.

La ligne vers est vide ou contient autre chose que des numéros de ligne. Les causes habituelles sont une exportation dont la colonne de l'étape suivante contient les propres identifiants du système source (STEP_014) au lieu de positions dans le fichier, ou un en-tête nommé quelque chose qui ne correspondait pas, auquel cas cette colonne a été considérée comme un extra ignoré. Les deux sont fixes dans le tableau : tapez les numéros de ligne dans Ligne vers et les flèches apparaissent au fur et à mesure. /csv-to-flowchart montre à quoi ressemble un fichier qui fonctionne.

Puis-je réimporter le fichier plus tard pour mettre à jour le graphique ?

Rien ne relie le graphique au fichier d'où il provient (il n'y a pas d'actualisation, pas de synchronisation et pas de connecteur), donc réimporter est un autre collage plutôt qu'une mise à jour. Considérez cela comme une décision prise une seule fois : après l'importation, le graphique est la définition du processus, et l'exportation devient un instantané de ce à quoi il ressemblait ce jour-là. Si les données sources changent effectivement chaque semaine, il s'agit presque certainement d'un journal d'instances plutôt que d'une définition d'étapes, et seules les étapes appartiennent au graphique.