ServiceNav propose une fonctionnalité d’import et de mise à jour en masse, dédiée à faciliter l’intégration d’un nouveau parc et les modifications sur de forts volumes.
Accéder au menu des Imports
Le rôle de l’utilisateur doit posséder le droit d’accéder au point de menu.
Se rendre au niveau de Configuration > Général > Imports
Les éléments à renseigner sont :
- Le fichier à importer
- Mode d’import
Par défaut, le lancement d’un import traite aussi bien les lignes possédant déjà un ID (mise à jour) que celles n’en possédant pas (création). Afin de garantir que seule l’une de ces deux opérations sera réalisée (en particulier en cas de fichier volumineux et/ou non fiable), il est possible de limiter le traitement à la mise à jour ou création seule.
- Entité
Il est actuellement possible d’importer des Équipements ou des Services unitaires, à l’aide de cette fonctionnalité.
Contenu du fichier
Le format attendu est CSV, avec un encodage UTF-8.
La taille maximum dépend du paramétrage de votre plateforme.
Un fichier doit être importé dans la même langue que celle dans laquelle il a été exporté (si un export a été fait). Dans le cas contraire, les valeurs renseignées, telles que les noms d’arguments, ne trouveront pas de correspondance et les lignes seront refusées.
Les colonnes et en-têtes attendus correspondent en tout point au format du fichier exporté via Configuration > Services > Liste ou Configuration > Équipements > Liste. Ce formalisme doit être respecté.
Attention lors de l’ouverture sous Excel d’un CSV exporté, les colonnes doivent être au format Texte, afin de ne pas altérer/interpréter leur contenu.
Export d’un parc
En se positionnant sur la société racine, il est possible :
- En activant « Comptes et subordonnés » : d’exporter l’intégralité du parc visible (sites, sous-sites, clients infogérés et revente)
- En désactivant « Comptes et subordonnés » : d’exporter le parc de la société courante
Il n’existe actuellement pas de possibilité, pour un utilisateur de n’exporter que son parc interne (=société de rattachement + sites/sous-sites, sans les clients).
Un travail sur le fichier excel du parc global est nécessaire (filtrage sur « Company Name » et/ou « Collector name »).
Comment mettre à jour/vider un champ
Cas général
La valeur d’un champ est issue de l’export
Si cette valeur est conservée, le champ ne sera pas modifié.
Si une autre valeur est renseignée, le champ sera mis à jour
Si aucune valeur n’est renseignée (cellule vide), le champ sera vidé
Cas des entités liées : les colonnes comportant le nom des entités liées sont exportées à titre indicatif. L’import se base uniquement sur les IDs
- par exemple, pour ajouter ou modifier une plage de disponibilité ou une étiquette, on travaillera sur la colonne des ID, seule colonne prise en compte dans l’import.
Si le champ vidé est obligatoire, la mise à jour de la ligne sera refusée, pour assurer la cohérence des données.
Mots de passe
Les champs de type
- compte > mot de passe
- compte > mot de passe de cryptage
- compte > application secret
contiennent à l’export, si ils sont protégés dans le service/équipement, la valeur ‘**********’ (10 étoiles). Si ils sont hérités, la valeur est vide.
Si cette valeur est conservée dans le fichier, le champ ne sera pas modifié.
Si une autre valeur est renseignée, le mot de passe sera mis à jour (et chiffré lors de l’import)
Si aucune valeur n’est renseignée (cellule vide), le mot de passe sera vidé
La valeur d’un champ lié au compte de supervision ne peut pas être renseignée si le compte est hérité
A l’inverse, elle ne peut pas être vide si le compte est protégé
Equipements – modèle d’équipement et étiquettes
Ces champs doivent contenir une ou plusieurs associations ID:Libellé, séparées par des |
251:Matériel Dell Poweredge|266:Matériel - Lame HP Blade|290:Materiel IBM DS
Attention : l’ajout d’un ou plusieurs modèles d’équipement ne crée pas les services unitaires associés sur l’équipement créé.
Lancement de l’import
Une fois le fichier renseigné, et l’entité sélectionnée, il est possible de lancer les opérations en cliquant sur
Une fois l’import lancé, un suivi de progression est affiché. Selon la volumétrie du fichier, L’opération peut prendre plusieurs de minutes.
Attention : une opération d’import est liée à un utilisateur. Il est impossible, pour un même utilisateur, de lancer un nouvel important tant que le précédent n’est pas terminé. Il est cependant tout à fait possible, pour un autre utilisateur, de lancer un import sur le même périmètre, simultanément.
Il est possible de continuer à utiliser ServiceNav pendant l’import (fonctionnement en tâche de fond).
Fin de l’import et consultation des rapports
Une fois l’import terminé, il est historisé pour 24 h dans le suivi des imports passés
Il est possible de télécharger les rapports de chaque import, afin de pouvoir par exemple retravailler les lignes ignorées ou en erreur.
