Formation · Leçon 6

Comment faites-vous parler vos systèmes ?

Poser une connexion entre deux systèmes ne fait pas à soi seul que les deux tiennent le même enregistrement avec le même sens. Dans cette leçon vous remplissez la carte d'intégration : quel champ se déplace dans quel sens, comment le format se convertit, comment le même enregistrement ne se coupe pas en deux et chez qui le travail attend quand la connexion se coupe.

Ce que vous apprendrez dans cette leçon

Dans la cinquième leçon vous avez monté le premier flux et les intégrations tenaient en une seule ligne de la fiche de montage. Cette leçon ouvre cette ligne. Que deux systèmes se comprennent ne revient pas à poser une connexion entre eux ; l'accord tient dès qu'il est écrit quel champ se déplace dans quel sens, comment le format se convertit et qui reste en attente quand la connexion se coupe.

La leçon ne parcourt pas l'écran de connecteurs d'un outil particulier. Ce qui est traité, c'est la carte d'intégration : l'enregistrement rempli avant de monter la connexion et qui reste en main ensuite. La carte en main, les mêmes questions ressortent répondues quel que soit l'outil avec lequel la connexion est montée.

Objectifs de la leçon

  • Remplir la carte d'intégration sur six colonnes
  • Marquer le sens et la source pour chaque paire de champs
  • Écrire la conversion de format au lieu de la laisser à la supposition
  • Choisir la clé de dédoublonnage et fixer la règle de conflit
  • Décider séparément la reprise initiale et la synchronisation continue
  • Écrire qui attend et quel est le secours manuel quand la connexion se coupe
  • Éprouver la connexion par trois passages : vide, ordinaire et atypique

Prérequis : le dictionnaire de champs de la troisième leçon et le flux monté dans la cinquième. Sans dictionnaire de champs la table de correspondances ne peut pas s'écrire, car les définitions des champs à apparier ne sont pas encore là.

Ce qu'est une intégration et ce qu'elle n'est pas

Intégrer, c'est que deux systèmes tiennent le même enregistrement avec le même sens. Avoir une connexion en place ne donne pas cela à soi seul ; l'enregistrement devient vraiment commun quand les deux côtés lisent le même champ avec le même sens.

En pratique la distinction se mesure à une question : en ouvrant un enregistrement côte à côte dans les deux systèmes, disent-ils la même chose ? Si la réponse est non, la connexion fonctionne mais l'intégration n'est pas en place. Cet état ne lève pas d'erreur non plus, car chaque système paraît cohérent en lui-même.

Ce qu'est une intégration

Des champs définis les uns par rapport aux autres, le sens choisi, le format converti et le même enregistrement non coupé en deux. Autant de décisions qui peuvent être écrites.

Ce qu'elle n'est pas

Poser une connexion entre deux systèmes et regarder les données circuler. Savoir si les données qui circulent sont bien lues est une autre question et elle ne se répond pas toute seule.

Repère de limite

Chaque fois que vous vous arrêtez en appariant un champ pour vous demander ce que l'autre côté compte comme tel, il manque là une ligne sur la carte. Une ligne manquante ressort au premier enregistrement atypique.

La carte d'intégration : six colonnes

La carte tient sur une page et chaque ligne décrit une paire de champs. Les six colonnes répondent aux six questions posées pendant le montage de la connexion ; quand une colonne reste vide, le comportement de ce champ est laissé à l'outil.

Remplir la carte avant de monter la connexion est un travail différent de la remplir après. Remplie avant, les manques ressortent sur le papier ; remplie après, c'est le comportement produit par l'outil qui est enregistré, et un comportement erroné entre dans la carte avec l'air d'être juste.

Les six colonnes de la carte

  • Système et champ source : où naît l'enregistrement
  • Système et champ cible : où l'enregistrement est écrit
  • Sens : à sens unique ou dans les deux sens
  • Conversion de format : comment chaque côté écrit la même valeur
  • S'il arrive vide : ce qui part vers la cible tant que le champ est vide
  • En cas de conflit : quelle valeur reste quand les deux côtés diffèrent

Les deux dernières colonnes sont souvent remplies en dernier alors qu'elles mériteraient d'être posées en premier. Les valeurs vides et les conflits sont les deux endroits où les intégrations produisent des pannes silencieuses.

Sens : système source, système miroir

Dans chaque paire de champs, un côté est l'endroit où naît l'enregistrement et l'autre en est le miroir. Choisir la source n'est pas une préférence mais un constat : la source est là où le champ se forme pour la première fois. Le miroir porte l'enregistrement plutôt qu'il ne le change.

Un sens réciproque peut se monter, mais il a un prix : dès que les deux côtés peuvent écrire, la possibilité d'un conflit apparaît, et si la règle de conflit n'est pas écrite, le dernier qui écrit l'emporte. Qui écrit en dernier tient le plus souvent au moment, si bien que le résultat devient difficile à prévoir.

Système source

L'endroit où le champ naît en premier. La correction s'y fait aussi ; une correction faite dans le miroir peut être reprise au transfert suivant.

Système miroir

Le côté qui tient l'enregistrement pour l'afficher et mener son propre travail. Dès que les champs miroir sont tenus pour lecture seule, les discussions dans l'équipe raccourcissent.

Sens réciproque

Un champ que les deux côtés peuvent écrire. Il ne se monte que si la règle de conflit est écrite ; sans règle, le champ est ramené à un seul sens.

Correspondance des champs : la même chose, un autre nom

Deux systèmes gardent la même information sous des noms différents. La table de correspondances met ces noms côte à côte, mais le vrai travail est d'apparier les définitions et non les noms. Deux champs portant le même nom pour des choses différentes est une situation plus fréquente que deux champs aux noms différents pour la même chose.

Le dictionnaire de champs de la troisième leçon gagne ici sa place : comme le sens du champ est écrit, la discussion sur les correspondances porte sur des définitions. Sans dictionnaire, apparier revient à poser deux écrans côte à côte et à relier des cases qui se ressemblent.

Une fois la table de correspondances complète, aucun champ entre les systèmes ne reste sans être discuté. Un champ non discuté est celui qui traverse le transfert silencieusement vide.

Conversion de format : date, téléphone, montant, nom

Deux systèmes peuvent écrire la même valeur autrement. L'ordre d'une date, les préfixes téléphoniques, le séparateur d'un montant et les majuscules d'un nom sont les endroits classiques où un transfert se casse en silence. Cette cassure ne lève pas d'erreur, car le système cible peut interpréter la valeur reçue selon ses propres règles.

Qui fait la conversion trouve sa réponse sur la carte : du côté source, pendant le transfert, ou du côté cible. Les trois endroits conviennent, mais quand le choix n'est pas écrit la conversion se fait à deux endroits et la valeur se casse en se convertissant deux fois.

Date et heure

L'ordre et le fuseau sont deux questions distinctes. Le même jour peut tomber sur deux jours ; quand le mois et le jour changent de place, l'enregistrement paraît toujours valable et cela passe inaperçu.

Téléphone et identifiant

Indicatif de pays, espaces et séparateurs. Si la clé de dédoublonnage est le téléphone, une différence de format coupe la même personne en deux enregistrements.

Montant et unité

Séparateur décimal, séparateur de milliers et devise. Un montant qui ne porte pas son unité retombe sur la valeur par défaut au moment d'être interprété dans la cible.

Si une règle de conversion tient sur une ligne de la carte, elle est assez nette. Une règle qui ne tient pas sur une ligne est le plus souvent le mélange de deux règles.

Clé de dédoublonnage : le même enregistrement deux fois

Le résultat que les transferts produisent le plus souvent est le même enregistrement coupé en deux dans la cible. La raison est le plus souvent celle-ci : le système regarde une clé pour savoir si l'enregistrement reçu a déjà été écrit, et la clé n'est soit pas choisie, soit pas tenue sous la même forme des deux côtés.

Choisir la clé était le sujet de la troisième leçon ; ici il s'agit de confirmer que la clé se tient sous la même forme dans les deux systèmes. Si la clé est gardée avec des espaces dans la source et sans dans la cible, les deux enregistrements paraissent différents et un doublon apparaît dans la cible.

Trois questions sur la clé

  • La clé se tient-elle sous la même forme dans les deux systèmes ?
  • La clé peut-elle changer avec le temps, et qu'advient-il alors de l'ancien enregistrement ?
  • Que deviennent les enregistrements reçus avec une clé vide : écrits, ou mis en attente ?

Un doublon est une panne silencieuse. Les rapports gonflent leurs totaux, le client est contacté deux fois, et au bout d'un moment on ne distingue plus lequel des deux enregistrements est à jour.

Rythme : immédiat, en file et par lots

Le moment où l'enregistrement se déplace compte autant que ce qui se déplace. Le transfert immédiat est l'option la plus visible, mais tout travail ne demande pas de déplacer les choses à l'instant ; là où un délai est admis, le transfert par lots tourne avec moins de pièces mobiles.

Choisir le rythme n'est pas une préférence de vitesse mais d'attente : si le transfert prend du retard, qui attend et cette personne remarque-t-elle le retard ? Un retard qui passe inaperçu revient non comme une panne mais comme « les données sont fausses ».

1 Transfert immédiat

L'enregistrement part dès qu'il est créé. Quand il n'est pas écrit ce qui se passe si l'autre côté ne répond pas, l'enregistrement peut rester en l'air.

2 Transfert en file

Les enregistrements sont écrits dans une file et déplacés dans l'ordre. Au moment d'une coupure la file attend, et au retour de la connexion elle reprend où elle s'était arrêtée.

3 Transfert par lots

Tout se déplace ensemble à intervalles fixes. L'option la plus simple là où le délai est accepté ; la fenêtre de transfert est annoncée à l'équipe.

Données existantes : reprises ou laissées en place ?

La question la plus souvent sautée pendant le montage d'une connexion est celle-ci : que deviennent les enregistrements accumulés jusqu'à aujourd'hui ? Il y a là deux travaux distincts et, mélangés, les deux restent à moitié faits. La reprise initiale est un déplacement en une fois ; la synchronisation continue mène tout ce qui vient ensuite. L'une finit, l'autre commence, et leurs règles n'ont pas à être les mêmes.

Reprendre les données existantes n'est pas nécessaire dans tous les cas. Commencer « à partir d'aujourd'hui » est aussi un choix valable et suffit pour la plupart des pilotes ; les anciens enregistrements restent dans leur propre système. Quand la reprise est décidée, la portée s'écrit : à partir de quelle date et des enregistrements dans quel état, dossiers clos inclus ou non.

Ce que porte la ligne de reprise initiale

  • Portée : les données existantes sont-elles reprises, sinon le jour de départ
  • Plage de dates : à partir de quelle date
  • Filtre d'état : les enregistrements clos, annulés et archivés sont-ils inclus
  • Balayage des doublons : la forme de la clé a-t-elle été alignée dans les deux systèmes
  • Retour arrière : comment une reprise qui tourne mal est retirée de la cible

La reprise initiale est le moment qui pèse le plus sur la clé de dédoublonnage. Une différence de format qui passe inaperçue sur des enregistrements arrivant un par un produit des doublons en nombre lors d'un déplacement en masse, et ce nombre peut dépasser ce que quiconque nettoierait à la main.

C'est pourquoi la reprise initiale se fait avec des données réelles plutôt que d'essai, et il vaut mieux qu'elle soit réversible : une plage de dates étroite part d'abord, le résultat est comparé dans les deux systèmes, et si aucun doublon ne sort, le reste suit. Marquer les enregistrements repris est ce qui rend possible de retirer de la cible une reprise erronée.

Qui attend quand la connexion se coupe ?

Toute connexion se coupe de temps en temps. La leçon ne propose pas de supprimer cette possibilité ; elle propose d'écrire où le travail s'arrête quand cela arrive. Non écrite, une coupure se montre non comme une panne mais comme un manque remarqué des jours plus tard.

La ligne de coupure de la carte porte trois choses : la personne qui attend, le secours manuel et le retour arrière. Ces trois écrits, une coupure se mène comme un retard ; non écrite, une coupure peut devenir en silence une perte de données.

Ce que porte la ligne de coupure

  • Qui attend : le nom de la personne dont le travail reste inachevé
  • Où part l'alerte : vers une personne ou vers une boîte partagée
  • Secours manuel : comment le même travail avance sans connexion
  • Retour arrière : comment un enregistrement à moitié transféré est repris dans la cible
  • Note de coupure : où la coupure et sa durée sont notées

Un enregistrement à moitié transféré se remarque moins qu'un enregistrement jamais déplacé : un enregistrement apparaît bien dans la cible, si bien que le manque ne sort qu'à l'usage.

Droits et accès : ce que voit chaque compte

Une connexion se monte avec un compte, et tout ce que ce compte voit peut s'ouvrir à l'autre côté. Utiliser le compte le plus large pendant le montage rend le travail plus rapide et laisse derrière une porte que personne ne rétrécit ensuite.

Que le compte appartienne au travail plutôt qu'à une personne est une autre affaire. Une connexion montée avec un compte personnel s'arrête en silence quand cette personne part, et la raison de l'arrêt est cherchée dans la connexion elle-même.

Ce que porte la ligne d'accès

  • Avec quel compte la connexion est montée et à qui ce compte appartient
  • Quels enregistrements le compte peut lire et lesquels il peut écrire
  • Quand le droit est revu
  • Quels accès sont repris si la connexion est fermée

La règle d'accès écrite dans la troisième leçon est éprouvée une deuxième fois ici : un champ dont le public était écrit dans le dictionnaire s'ouvre peut-être à un autre système par l'intégration.

Éprouver l'intégration : trois passages

Après le montage de la connexion, l'épreuve ne s'arrête pas au déplacement d'un enregistrement suivi d'un coup d'oeil au résultat. Faits ensemble, les trois passages vérifient la plupart des lignes de la carte.

L'épreuve se fait avec des données d'essai et les enregistrements d'essai se reconnaissent à leur nom. Une épreuve menée avec des enregistrements réels laisse dans le système cible une trace qu'il faut nettoyer.

1 Passage vide

Un enregistrement dont les champs non obligatoires sont laissés vides. Il montre ce que devient une valeur vide dans la cible : reste-t-elle vide, une valeur par défaut est-elle écrite, l'enregistrement est-il refusé.

2 Passage ordinaire

L'enregistrement typique du travail quotidien. Sert à ouvrir la correspondance des champs et la conversion de format côte à côte et à les comparer.

3 Passage atypique

Un nom long, un téléphone au format différent, un deuxième enregistrement sous la même clé. Le passage qui éprouve les règles de dédoublonnage et de conflit.

Le résultat des trois passages s'écrit à côté de la carte. Une ligne non éprouvée ne compte pas comme montée.

Exemple de bout en bout : l'agence immobilière se connecte

Dans les leçons précédentes le bureau a choisi une tâche pilote, écrit son processus, dressé son dictionnaire de champs, choisi son outil et monté le premier flux. Maintenant le système d'annonces et le tableau de suivi ne se voient pas, et la même demande est saisie à la main à deux endroits.

Le bureau commence par remplir la carte et une discussion sort dès la première ligne : dans quel système naît le numéro de téléphone ? La demande qui arrive dans le système d'annonces porte un téléphone et le tableau de suivi aussi ; les deux se tiennent sous des formes différentes.

Les premières lignes que le bureau remplit

Comme source est marqué l'enregistrement de demande du système d'annonces ; le tableau de suivi est admis comme miroir. Pour le champ téléphone la conversion de format se fait pendant le transfert et ramène tout à une seule forme. Comme clé de dédoublonnage le téléphone est choisi, car la même personne peut écrire depuis des annonces différentes.

La ligne de valeur vide s'écrit ainsi : si le téléphone est vide l'enregistrement n'est pas écrit dans le tableau de suivi, il tombe dans une liste d'attente et la responsable du bureau parcourt cette liste en fin de journée. Sur la ligne de conflit le côté source est tenu au-dessus ; les corrections faites à la main dans le tableau vont dans le champ de notes et non dans le champ téléphone.

Comme rythme le transfert par lots est choisi, car déplacer les demandes quelques fois dans la journée plutôt qu'au moment où elles arrivent suffit au travail. Sur la ligne de coupure la personne qui attend est écrite comme la responsable du bureau, et l'ancienne manière de saisir reste ouverte comme secours manuel.

Le tableau de suivi portait déjà des enregistrements, la décision de reprise initiale est donc prise elle aussi. Plutôt que de déplacer tout l'historique, le bureau prend les demandes récentes et ouvertes ; les dossiers clos restent dehors, car leur équivalent dans le tableau est déjà clos. La reprise est d'abord tentée sur une plage de dates étroite et le nombre de lignes est comparé dans les deux systèmes. Au premier essai des doublons sortent : la forme du téléphone n'est pas encore alignée. La conversion est corrigée et la reprise recommencée, les enregistrements repris sont marqués d'une étiquette, et cette étiquette est ce qui permet de retirer en bloc de la cible une reprise qui tourne mal.

Dans l'épreuve des trois passages, le passage atypique attrape un manque : quand une deuxième demande arrive du même téléphone, un nouvel enregistrement s'ouvre dans le tableau de suivi. La règle de clé est corrigée et la deuxième demande entre en note sous la même personne.

Exercice : cette semaine

Cette semaine, portez une seule connexion sur la carte. Vous n'avez pas à monter une connexion neuve ; dessiner la carte d'un transfert qui tourne déjà fait le même travail et sort en général quelques lignes manquantes.

Télécharger la carte d'intégration (xlsx) · une carte d'une page qui fait remplir la correspondance des champs, le sens, la conversion de format, la reprise initiale et le comportement en cas de coupure ; l'épreuve des trois passages y est aussi.

Erreurs fréquentes

Les erreurs ci-dessous ne sortent pas de la connexion elle-même mais de la carte restée incomplète. Leur point commun est celui-ci : toutes tournent sans produire de message d'erreur.

Relier sans écrire le sens

Dès que les deux côtés peuvent écrire, le dernier qui écrit l'emporte. Les corrections faites à la main peuvent être reprises au transfert suivant et la raison est cherchée dans l'outil.

Laisser la clé sous sa forme

Si le même téléphone se tient sous deux formes, deux enregistrements apparaissent dans la cible. Un doublon abîme aussi bien le rapport que le contact avec le client.

Laisser la valeur vide à l'outil

Un champ vide peut retomber sur une valeur par défaut dans la cible. Une valeur par défaut ressemble à une valeur remplie, elle ne se distingue donc plus ensuite.

Ne pas écrire la coupure

Si personne n'est défini comme attendant quand le transfert s'arrête, le manque peut sortir des jours plus tard avec la question d'un client.

Éprouver avec des données réelles

Quand l'enregistrement d'essai est pris dans le réel, une trace à nettoyer reste dans la cible, et le nettoyage se fait le plus souvent à moitié.

Remplir la carte après coup

Une carte écrite après le montage enregistre le comportement produit par l'outil. Un comportement erroné se trouve documenté par la même voie comme s'il était juste.

Liste de contrôle

Si chaque point de cette liste peut être répondu avant la mise en service, la carte compte comme complète.

Avant la mise en service

  • Sur chaque ligne, source, cible et sens sont écrits
  • Champs demandant une conversion marqués et lieu de la conversion choisi
  • Clé de dédoublonnage sous la même forme dans les deux systèmes
  • Portée, plage de dates et retour arrière de la reprise initiale écrits
  • Comportement en cas de valeur vide écrit pour chaque champ
  • Règle de conflit écrite et connue de l'équipe
  • Le compte de la connexion appartient au travail, non à une personne
  • Personne qui attend, secours manuel et retour arrière écrits
  • Trois passages faits avec des données d'essai et leurs résultats notés
  • Enregistrements d'essai nettoyés du système cible

Glossaire

Termes qui reviennent dans les conversations d'intégration. Parler la même langue que la personne qui monte la connexion rend le remplissage de la carte plus court.

La suite

Dans cette leçon vous avez fait parler deux systèmes : vous avez apparié les champs, choisi le sens, converti le format, décidé si les données existantes sont reprises et écrit le comportement en cas de coupure. Les leçons à venir traitent du maintien de cet ordre : mener les exceptions, faire entrer l'équipe dans le processus et mesurer le résultat.

Si vous souhaitez continuer avec les leçons publiées, vient le module qui raconte où regarder quand un transfert ne tourne pas comme prévu.

Leçon 7 : Quand l'automatisation ne marche pas

Panne silencieuse, fiche de panne, méthode de coupe en deux et correction durable.

Leçon 5 : Monter la première automatisation

La fiche de montage et les cinq parties. La ligne d'intégration ouverte ici s'y trouve.

Toutes les leçons

La section formation dans son ensemble et les modules ajoutés depuis.

Si vous souhaitez remplir la carte ensemble avant de relier deux systèmes, écrivez-nous.

Demander un Devis sur WhatsApp

Questions fréquentes

Faut-il coder pour une intégration ?
Cela dépend de l'outil choisi. La carte de cette leçon se remplit aussi sans coder ; ce qui est traité n'est pas le maniement d'un connecteur mais ce qu'il convient d'écrire entre deux systèmes. La carte en main, les mêmes questions se trouvent répondues par quelque voie que la connexion soit montée.
Une carte est-elle utile quand un connecteur tout prêt existe ?
Un connecteur tout prêt apparie les champs avec ses propres suppositions et ces suppositions n'apparaissent pas à l'écran. La carte montre si elles conviennent à votre travail ; les endroits où elles ne conviennent pas sortent le plus souvent sur les lignes de valeur vide et de conflit.
Deux systèmes peuvent-ils s'écrire mutuellement ?
Ils le peuvent, à condition que la règle de conflit soit écrite. Sans règle, quand les deux côtés mettent à jour le même champ, celui qui écrit en dernier reste et les corrections faites à la main peuvent être reprises au transfert suivant. Si la règle ne peut pas s'écrire, ramener le champ à un seul sens réserve en général moins de surprises.
Pourquoi le même enregistrement se coupe-t-il en deux dans la cible ?
Le plus souvent la clé de dédoublonnage n'est pas choisie ou se tient sous une autre forme dans les deux systèmes. Un téléphone gardé avec des espaces d'un côté et sans de l'autre montre la même personne comme deux enregistrements séparés. Aligner la forme de la clé pourrait retirer la plupart des doublons.
Si la connexion se coupe, des données sont-elles perdues ?
Cela dépend du rythme du transfert. En file, les enregistrements attendent dans la file, si bien qu'au retour de la connexion cela reprend où cela s'était arrêté ; en transfert immédiat, si ce qui se passe quand l'autre côté ne répond pas n'est pas écrit, l'enregistrement peut rester en l'air. La ligne de coupure de la carte se remplit exactement pour cela.