L'exportation/importation CSV est utilisée pour les tâches suivantes :

Manipulation en masse - ajout d'appareils, de groupes de tâches et d'instances de modèles
Manipulation en masse - mise à jour des appareils et des tâches (seuils, noms, intervalles, paramètres de tâche)
Manipulation en masse - suppression de tâches
Fonctionnalité de modèle
Inventaire détaillé, y compris les seuils

L'exportation/importation CSV ne prend en compte que les deux niveaux de groupe situés au-dessus d'un périphérique. Les périphériques et les tâches situés dans des structures arborescentes plus profondes ne seront exportés qu'avec les deux groupes situés au-dessus.

Pour utiliser la fonction d'exportation, accédez à /root/Configurations, sélectionnez la fonction appropriée dans le menu ou cliquez sur l'icône d'exportation CSV :

L'importation et l'exportation sont effectuées par l'utilisateur qui lance l'action ou modifie l'objet du Scheduler (exportation uniquement). Lors de l'importation d'un fichier CSV, celui-ci doit avoir le même format que lorsqu'il a été créé par la fonction d'exportation.

Chaque colonne comporte une balise (en lettres majuscules) dans la ligne d'en-tête afin d'identifier le type de colonne. Les balises décrites dans la section suivante sont définies.

CSV - balises de groupe

Balise	Description
GROUP_NAME_1	Nom du groupe sous le parent d'importation/exportation
GROUP_NAME_2	Nom du groupe sous GROUP_NAME_1 (au-dessus des appareils)

CSV - balises de périphérique

Balise	Description
DEVICE_NAME	Nom du périphérique. Cette balise ne doit pas être vide pour les opérations d'ajout/mise à jour.
DEVICE_TYPE	Type de l'appareil. Clés possibles : firewall, firewall_pix, gateway, host, ids_ips, interface, other, proxy, printer, router, server, ssl, switch, vpn, wlan
DEVICE_ADDRESS	Nom DNS ou adresse IP du périphérique
DEVICE_SUBNET_MASK	Masque de sous-réseau du périphérique

CSV - balises de tâche

Balise	Description
JOB_NAME	Nom de la tâche. Cette balise ne doit pas être vide pour les opérations d'ajout/mise à jour.
JOB_TYPE	Type de la tâche. Cet élément ne peut pas être modifié. Clés possibles pour l'opération d'ajout : dhcp, remote_disk, dns, dns_query, fetchfile, http, ping, imap, remote_nwinterface, parsefile, pop3, remote_process, shell, smtp, snmp, sql, tcp, buslay
JOB_AGENT	Nom de connexion du collecteur qui exécutera la tâche.
JOB_INTERVAL	Intervalle en secondes. Valeurs possibles : 5, 10, 20, 30, 40, 50, 60 (1 minute), 120 (2 minutes), 180 (3 minutes), 240 (4 minutes), 300 (5 minutes), 360 (6 minutes), 600 (10 minutes), 1800 (30 minutes), 3600 (1 heure), 7200 (2 heures), 21600 (6 heures), 43200 (12 heures), 86400 (1 jour), 604800 (7 jours)
JOB_EXECUTION	Valeurs possibles : démarré, arrêté
JOB_PARAMETERS	Chaîne contenant tous les paramètres nécessaires à l'exécution d'une tâche. Veuillez noter que \r doit être encodé comme $!r!$ et \n comme $!n!$. Exemple pour une tâche ICMP : interval_mode=0&packets=10&bytes=56&icmpid_random=0
JOB_ALARM_LIMITS	Chaîne de caractères représentant la limite d'alarme. Exemple pour une tâche ICMP : WarningCond=Or&Warning1=error_code;<>;0;1;&MajorCond=Or&Major1=packetloss;%3d;100;1;

CSV - Balises PID

Il existe différentes balises PID qui contiennent des propriétés et des propriétés personnalisées attribuées à des objets. Ces colonnes sont créées si le contenu Standard ou Complet est spécifié lors de l'exportation.

Exemple : numéro de série PID

CSV - autres balises

Balise	Description
TEMPLATE_NAME	Nom du modèle auquel un périphérique ou une instance de tâche est lié
TYPE	Type d'objet (groupe, périphérique, tâche), ne peut pas être modifié
ID	ID de l'objet pour l'opération de mise à jour/suppression
COMMANDE	Valeurs possibles : ignorer : la ligne est ignorée (comme si elle avait été supprimée du fichier CSV) use : si ce n'est pas un ajout/une mise à jour, utiliser comme parent pour ajouter ci-dessous (nécessaire pour les tâches et les modèles) add : Ajouter un objet (pour les tâches : un périphérique doit être défini avec la commande add, use ou update) update : mettre à jour la configuration (les types de tâches ne peuvent pas être modifiés) supprimer : seuls les travaux peuvent être supprimés

CSV - exporter

Pour créer un objet d'exportation, accédez à /root/Configurations et sélectionnez Ajouter une exportation CSV :

Exemple de configuration :

Propriété	Description
Nom	Nom de la configuration d'exportation
Séparateur de colonnes	Choisissez l'un des séparateurs suivants : , ; \| : ou tabulation
Sous le groupe	Point d'entrée de l'arborescence des objets. Les objets situés sous ce groupe sont exportés. Recherchez le groupe contenant les périphériques à exporter
Contenu	Permet de sélectionner la quantité de données à exporter. Les balises GROUP_NAME_1 et GROUP_NAME_2 ne sont exportées que si des groupes sont sélectionnés dans la configuration. Les balises de périphérique ne sont exportées que si des périphériques sont sélectionnés. Les balises de tâche ne sont exportées que si des tâches sont sélectionnées. Si seules des tâches sont exportées, la balise DEVICE_NAME est ajoutée à titre informatif. Basique : comprend : GROUP_NAME_1, GROUP_NAME_2, DEVICE_NAME, DEVICE_TYPE, DEVICE_ADDRESS, JOB_NAME, JOB_TYPE, JOB_AGENT, JOB_INTERVAL, JOB_EXECUTION, JOB_PARAMETERS, JOB_ALARM_LIMITS, TEMPLATE_NAME, TYPE, ID, COMMAND Complet : comprend le contenu de base ainsi que DEVICE_SUBNET_MASK, DEVICE_SYSLOG_SOURCE, DEVICE_SYSLOG_LEVEL, DEVICE_WEB_LINK, DEVICE_REMOTE_ACCESS, plus toutes les balises PID
Groupes	En cochant cette case, le fichier contiendra également le nom du groupe qui contient les objets, ainsi que le nom du groupe affilié
Périphériques, tâches	Dans cette section, le nombre d'entrées dans le fichier CSV peut être réduit en définissant un filtre comme indiqué dans l'exemple de configuration ci-dessus

Pour générer un fichier d'exportation, accédez au nouvel objet, cliquez sur Générer et appuyez sur le bouton Générer dans le panneau de droite :

Après la génération, ouvrez le fichier CSV avec Internet Explorer, Firefox, Excel ou n'importe quelle application de tableur, ou enregistrez-le localement. Modifiez les paramètres si vous le souhaitez ou laissez-les tels quels.

Exemple de fichier CSV exporté :

CSV - importation

Accédez à /root/Configurations et sélectionnez Ajouter une importation CSV :

Configuration :

Propriété	Description
Nom	Nom de la configuration d'importation CSV
Séparateur de colonnes	Choisissez l'un des séparateurs suivants : , ; \| : ou tabulation, en fonction du séparateur utilisé dans le fichier à importer.
Groupe inférieur	Point d'entrée de l'arborescence d'objets pour ajouter des objets en dessous. Pour les commandes de mise à jour, de suppression et d'utilisation, le type et l'identifiant du fichier CSV sont utilisés et cette entrée de configuration est ignorée
Fichier	Le fichier CSV à importer. Les entrées vides sont effacées. Les entrées inexistantes ne sont pas modifiées pour les objets existants et sont laissées vides pour les objets ajoutés
Télécharger le fichier	Zone permettant de télécharger les fichiers CSV d'importation préparés.

Avant de lancer l'importation, un contrôle de cohérence du fichier est effectué. Il peut être lancé manuellement en appuyant sur Vérifier. Un aperçu statistique est affiché sur la page d'importation. Le fichier journal contient plus d'informations pour chaque ligne traitée.

CSV - exemple d'importation

Un fichier CSV précédemment exporté peut être utilisé comme modèle pour l'importation. De nouveaux appareils, tâches et instances de modèles d'appareils ou de tâches peuvent être ajoutés à l'aide de la configuration ci-dessous. Après l'exportation, toutes les commandes sont définies par défaut sur « ignorer ».

Dans l'exemple suivant, deux appareils avec deux tâches chacun doivent être ajoutés sous le groupe existant Région Zurich sous le groupe Appareils. La colonne ID a été conservée à partir des objets exportés afin d'identifier les groupes existants. La colonne Commande a été modifiée de « ignorer » à « utiliser » pour les groupes et à « ajouter » pour les nouveaux appareils et tâches :

Utilisez n'importe quel objet d'importation existant ou créez-en un nouveau à l'aide de Ajouter une importation CSV. Le même objet d'importation peut être utilisé pour différentes tâches d'importation. Plusieurs objets d'importation peuvent être créés pour de futures procédures d'importation automatisées.

Cliquez sur Importer pour ouvrir la configuration d'importation :

Glissez-déposez le fichier CSV préparé dans la zone Télécharger le fichier et cliquez sur Vérifier :

Si la vérification échoue, ouvrez le fichier journal fourni sous la section Détails du résultat et corrigez les erreurs dans le fichier d'importation :

Si la vérification a réussi, vérifiez les objets répertoriés dans la section Détails des résultats et cliquez sur Importer :

Une fois l'importation terminée, les détails des résultats s'affichent à nouveau :

Les objets résultants doivent maintenant apparaître sous le chemin d'accès à l'arborescence sélectionné :

CSV - importation avec des modèles

Lorsque vous utilisez l'importation CSV, la colonne TEMPLATE_NAME du fichier CSV source peut être utilisée pour créer des instances de modèles existants. Veuillez noter les points suivants concernant les importations de modèles :

La colonne TEMPLATE_NAME n'est interprétée que si la commande add est utilisée pour la ligne correspondante
L'importation vérifie s'il existe exactement un modèle de niveau supérieur du type approprié, sinon elle signale une erreur
Les modèles sont pris en charge pour les groupes, les appareils et les tâches
Les nouveaux objets sont créés en tant qu'instances à partir du modèle
Les groupes et les appareils sont ajoutés sous le parent actuel
Les tâches sont ajoutées sous le périphérique actuel (dernier ajouté ou défini par la commande « use »)
Il n'est pas possible d'ajouter un groupe sous un périphérique.

Documentation

Exportation/importation CSV