Convertir un inventaire d'équipements

Le format de fichier que Tibius WiFi importe pour nommer vos points d'accès, et comment le produire depuis un tableur sans que le fichier quitte votre ordinateur.

L’inventaire d’équipements dit à Tibius WiFi quel point d’accès se cache derrière chaque adresse MAC / BSSID observée, et où il se trouve. Il est distinct du profil, qui dit quoi surveiller : un inventaire ne se partage jamais avec un profil, et ne quitte l’appareil que si vous l’exportez.

Le format, en bref

Tibius WiFi importe, dans Inventaire › Importer :

• un fichier texte CSV en UTF-8, dont la première ligne nomme les colonnes ;
• séparé par des points-virgules (les virgules et les tabulations sont aussi reconnues, d’après la ligne d’en-tête) ;
• avec une ligne par adresse : un équipement qui a plusieurs adresses — une par radio, par exemple — occupe plusieurs lignes portant le même nom ;
• dont deux colonnes sont indispensables : name, le nom de l’équipement, et rule_value, son adresse. Toutes les autres sont facultatives, et leur ordre est libre.

L’application reconnaît le format à son contenu, et non à l’extension : un fichier qui commence par { est lu comme l’export JSON complet, tout autre comme ce tableau. Gardez néanmoins l’extension .csv, qui permet au sélecteur de fichiers du téléphone de le proposer. L’annexe en bas de cette page donne la liste complète des colonnes, les types d’équipement et les limites.

Le plus petit fichier accepté tient en deux lignes :

name;rule_value
AP Accueil;02:11:22:33:44:55

Un fichier plus complet, tel que le produit le convertisseur :

equipment_id;name;type;vendor;model;base_mac;scope;profile_id;profile_name;site;building;floor;room;location_note;notes;rule_id;rule_type;rule_value;rule_to;rule_profile_id;rule_note
;AP Accueil;access_point;Constructeur;M-100;;global;;;Siège;A;0;Accueil;Au plafond, côté entrée;;;exact;02:11:22:33:44:01;;;Corp-Wifi
;AP Accueil;access_point;Constructeur;M-100;;global;;;Siège;A;0;Accueil;Au plafond, côté entrée;;;exact;02:11:22:33:44:02;;;Corp-Invités
;Routeur fibre;router;;;;global;;;Siège;A;-1;Local technique;;;;exact;02:11:22:33:44:04;;;

Les deux premières lignes décrivent un seul équipement, « AP Accueil », reconnu sous deux adresses.

Le convertisseur

Écrire ce fichier à la main est possible ; le produire depuis le tableau que vous avez déjà est plus sûr. Le convertisseur lit un fichier CSV, TSV ou Excel .xlsx, vous montre ce qu’il a compris, et produit un fichier que l’application importe sans retouche.

1. Choisir le fichier

Les exports de tableur sont reconnus tels qu’ils sortent : UTF-8, Windows-1252 (le « CSV » d’Excel sous Windows), UTF-16 (le « Texte Unicode » d’Excel) ; point-virgule, virgule, tabulation ou barre verticale. L’écran dit ce qu’il a supposé et permet de le corriger. Pour un classeur, vous choisissez la feuille ; si un titre précède les noms de colonnes, vous choisissez la ligne qui les porte.

Les anciens classeurs .xls et les fichiers OpenDocument .ods ne sont pas lus : enregistrez-les en .xlsx ou en CSV.

2. Faire correspondre les colonnes

Le convertisseur propose, pour chaque information que Tibius WiFi connaît, la colonne de votre fichier qui semble la contenir : « Adresse MAC », « BSSID » ou « MAC » pour l’adresse, « Nom » ou « Équipement » pour le nom, « Étage », « Salle », « SSID »… Vous pouvez tout changer. Quand deux colonnes sont possibles — « MAC » et « BSSID », par exemple — rien n’est choisi à votre place : l’écran les nomme, et attend votre choix.

Si chaque ligne porte plusieurs adresses — une colonne « MAC 2,4 GHz » et une colonne « MAC 5 GHz » —, cochez la seconde dans Autres colonnes d’adresses : chaque adresse devient une règle du même équipement.

Les colonnes que vous n’utilisez pas sont simplement ignorées. Aucune information n’est inventée : un numéro de série ou une adresse IP, que Tibius WiFi ne sait pas ranger, reste dans votre fichier.

3. Ce qui est normalisé, et ce qui ne l’est jamais

Une adresse s’écrit de bien des façons ; toutes celles que l’application accepte sont ramenées à la même forme, AA:BB:CC:DD:EE:FF :

Tout le reste est refusé, jamais réparé : un octet à un seul chiffre (A:BB:…), des séparateurs mélangés (AA:BB-CC…), une étoile, une longueur fausse. Deviner un zéro manquant, c’est inventer une adresse — et faire dire à un rapport qu’un point d’accès se trouve dans une pièce où il n’est pas.

C’est aussi pourquoi une adresse saisie comme un nombre dans Excel est signalée : le tableur en a peut-être effacé les zéros de tête, et le convertisseur ne les remet pas. Formatez la colonne en texte, et saisissez-la de nouveau.

Les types d’équipement sont reconnus en français comme en anglais — « Point d’accès », « AP », « Routeur », « Box », « Répéteur », « Nœud mesh »… Un type inconnu est rangé sous « Autre équipement », comme l’application le ferait elle-même, et l’écran le signale.

4. Le contrôle

Avant de produire quoi que ce soit, le convertisseur fait le compte :

• lignes lues, lignes valides, équipements et adresses produits ;
• lignes en erreur — adresse absente ou illisible, nom absent : elles sont écartées du fichier produit ;
• doublons — la même adresse plus haut dans le fichier, écrite pareil ou autrement : seule la première occurrence est gardée. Si elle était attribuée à un autre équipement, l’écran le dit : importés tous deux, ils rendraient l’identification de cette adresse ambiguë dans l’application ;
• avertissements — un même équipement dont l’étage ou la salle change d’une ligne à l’autre : la première valeur est retenue, comme dans l’application.

Chaque problème est désigné par son numéro de ligne, sa colonne et la seule cellule en cause, pour que vous puissiez corriger votre fichier source.

Écarter une ligne invalide plutôt que tout refuser, c’est ce que fait l’application elle-même : elle importe ce qui est valide, et dit ce qu’elle a refusé. Le convertisseur le fait simplement plus tôt, là où vous pouvez encore corriger. L’export n’est bloqué que s’il ne reste rien à importer, ou si le fichier produit dépasserait ce que l’application accepte de lire.

5. Télécharger, puis importer

Le fichier produit porte le nom de votre fichier source, suivi de .tibius-wifi-inventaire.csv. Copiez-le sur le téléphone, puis, dans Tibius WiFi, ouvrez Inventaire › Importer. L’application affiche un compte rendu avant d’enregistrer quoi que ce soit. Réimporter le même fichier ne crée aucun doublon : un équipement déjà présent à l’identique est ignoré.

Par défaut, les équipements sont reconnus dans tous les profils. L’option « Propres à un profil » les réserve au profil depuis lequel vous lancerez l’import — et c’est depuis ce profil qu’il faut alors importer : l’inventaire général refuse un tel fichier plutôt que de rendre ces équipements visibles partout.

Confidentialité

Votre fichier reste sur cet appareil et n’est jamais envoyé à Tibius. Ce n’est pas seulement une intention :

• la lecture, la vérification et la conversion sont faites par votre navigateur, avec un code servi par ce site — aucune bibliothèque ni aucun service tiers ;
• la page déclare une politique de sécurité qui interdit au navigateur toute connexion sortante : même un code qui le voudrait ne pourrait rien envoyer ;
• rien n’est enregistré, ni sur le site ni dans le navigateur : recharger ou fermer la page efface tout ;
• le fichier produit est créé sur votre appareil, au moment où vous appuyez sur le bouton.

Pour le vérifier vous-même : ouvrez les outils de développement de votre navigateur, onglet Réseau, puis convertissez un fichier. Aucune requête n’apparaît après le chargement de la page.

Un inventaire situe l’infrastructure d’un site : traitez le fichier produit avec le même soin que votre fichier source. N’ouvrez pas un inventaire d’origine inconnue dans un tableur qui exécute des formules — une cellule commençant par = y serait interprétée.

Limites

• Le convertisseur ne produit que des adresses exactes. Les plages, jokers et masques que l’application sait aussi décrire s’écrivent directement dans le fichier, ou dans l’écran d’un équipement.
• Les personnalisations propres à un profil (alias, localisation propre) ne passent pas par ce format : le format complet est l’export JSON de l’application.
• Les dates, formules et cellules fusionnées d’un classeur ne sont pas interprétées : seule la valeur enregistrée de chaque cellule est lue.