Référence pour le fichier de propriétés du collecteur CSV Java

Utilisez ces informations pour comprendre comment le fichier de propriétés du collecteur Java™ CSV est construit.

L'emplacement du fichier de propriétés du collecteur Java CSV dans $NCHOME/precision/collectors/javaCollectors/ est indiqué dans le tableau 1. Ce fichier .properties permet de mapper les données du réseau à un ou plusieurs fichiers.

Remarque: les propriétés spécifiées dans le fichier de propriétés spécifique au collecteur remplacent toutes les propriétés associées spécifiées dans le fichier de propriétés du collecteur Java générique, $NCHOME/precision/collectors/javaCollectors/framework/collector.properties.

Tableau 1. Fichier de propriétés du collecteur CSV Java
Collector	Emplacement du fichier de propriétés dans
Collecteur CSV Java	csv/csvcollector.properties

Exemple de fichier .properties pour le collecteur CSV Java

Le fragment de code suivant présente des exemples de paramètres provenant d'un fichier .properties du collecteur Java CSV. Il définit le répertoire dans lequel les fichiers de données CSV se trouvent, puis définit le formatage des données CSV dans l'un de ces fichiers, le fichier devices.csv, qui définit les données d'entité principales.

# Directory containing CSV data
CSVDir = ../csv/exampleCsvData/

# Main entity data (device data) is in devices.csv
MainEntityData.file = devices.csv

# The delimiter for the file is a |
MainEntityData.delimiter = \\|

# There are 6 columns of data in the file
MainEntityData.numCols = 6

# Only read lines that start with 10.1.1.
MainEntityData.lineMatch = 10\\.1\\.1\\..+

# Map the first data column to the device management IP address (<ip>)
MainEntityData.1.name = ManagementIpAddress
MainEntityData.1.mapsTo = DEVICE_MANAGEMENT_IP_ADDRESS

# Arbitrary mapping of extra information
# Map column 6 to <extraInfo><systemInfo>…</systemInfo></extraInfo>
MainEntityData.6.name = AdditionalSystemInfo
MainEntityData.6.mapsTo = EXTRA_INFO.systemInfo

Propriétés et mappages

Les fichiers de propriétés du collecteur CSV Java incluent les propriétés suivantes :

Répertoire de base: Pour le collecteur Java CSV, le répertoire de base est défini dans la propriété CSVDir .
Propriétés de fichier de données: Pour le collecteur CSV Java, un ensemble de propriétés est défini pour les différents fichiers de données CSV utilisés comme entrée.

Le tableau ci-dessous répertorie les propriétés qui figurent dans les fichiers de données CSV. Pour chaque propriété, data_type est l'un des types de données pris en charge, répertoriés dans le Tableau 4.

Tableau 2. Propriétés de fichier de données
Propriété	Descriptions
`data_type.file`	Nom de fichier contenant les données CSV.
`data_type.delimiter`	Délimiteur pour les données dans le fichier CSV. Le délimiteur par défaut est la virgule (`,`).
`data_type.lineMatch`	Modèle de syntaxe d'expression régulière. Le collecteur ne lit que les lignes qui commencent par le modèle.
`data_type.numCols`	Nombre de colonnes de données dans le fichier.
`data_type.useCols`	Si les colonnes ne sont pas toutes requises, cette expression utilise une liste séparée par des virgules, par exemple `1,3`, pour indiquer les colonnes de données du fichier à utiliser.

Le tableau ci-après indique comment les données qui se trouvent dans des fichiers de données CSV sont mappées à des attributs.

Tableau 3. Mappages de données
Propriété	Descriptions
`data_type.column_number.name`	Nom lisible pour les données de la colonne.
`data_type.column_number.description`	Description lisible des données de la colonne.
`data_type.column_number.mapsTo`	Mappage à un attribut pris en charge pour le type de données.

Types de données

Le tableau ci-après répertorie les types de données pris en charge.

Tableau 4. Types de données
Propriété	Descriptions
`MainEntityData`	Données d'entité principale (périphérique).
`InterfaceData`	Données d'interface.
`EntityData`	Données d'entité au format ENTITY-MIB.
`GenericEntityData`	Données d'entité dans un format autre que ENTITY-MIB.
`L1ConnectivityData`	Données de connectivité de couche 1.
`L2ConnectivityData`	Données de connectivité de couche 2.
`L3ConnectivityData`	Données de connectivité de couche 3.
`L2VpnData`	Données de réseau privé virtuel de couche 2.
`L3VpnData`	Données de réseau privé virtuel de couche 3.
`L3VpnInterfaceData`	Données d'interface de réseau privé virtuel de couche 3.
`L3VpnRTData`	Données de cible de route de réseau privé virtuel de couche 3.
`LabelSwitchPathData`	Données de chemin commuté par étiquette (LSP).
`MplsInterfaceData`	Données d'interface de commutation multiprotocole par étiquette (MPLS).

Configuration de la source de données

En option, vous pouvez configurer des détails sur le système EMS (système de gestion des éléments) en configurant les zones répertoriées dans le tableau ci-après. Si vous configurez ces informations EMS, les données de ces zones seront utilisées par Network Manager pour modéliser le système EMS.

Tableau 5. Configuration de la source de données
Propriété	Descriptions
`DataSource.id`	Cette zone a pour valeur `1`, ce qui indique qu'il s'agit de la première source de données.
`DataSource.descr`	Description du système EMS.
`DataSource.emsHost`	Nom d'hôte du système EMS.
`DataSource.emsName`	Nom du système EMS.
`DataSource.emsVersion`	Version du système EMS.
`DataSource.emsIdentifier`	Identificateur du système EMS.
`DataSource.emsRole`	Rôle du système EMS. Prend l'une des valeurs suivantes : inconnu primary backup other
`DataSource.emsStatus`	Rôle du système EMS. Prend l'une des valeurs suivantes : inconnu up down other