Netgeo Telecom Imports 2.8 V3
Netgeo Telecom Imports 2.8 V3
Version 2.8
SAS au capital de 381 250 € - RCS Lyon 380 363 911 – SIRET 380 363 911 00153 – APE 6202A – N° de TVA intracommunautaire : FR 41 380 363 911
SOMMAIRE
1. INTRODUCTION .......................................................................................................................................... 4
1.1. Terminologie.................................................................................................................................. 4
1.2. Activation des modules ................................................................................................................. 4
1.3. Accès aux outils ............................................................................................................................ 4
1.4. Présentation des interfaces d'import ............................................................................................. 5
2. IMPORT D'EPISSURAGE............................................................................................................................ 6
2.1. Accès à l’outil ................................................................................................................................ 6
2.2. Structure du fichier d’import .......................................................................................................... 6
2.3. Opérations réalisées par l’outil ...................................................................................................... 8
3. IMPORT DE CABLAGE ............................................................................................................................. 10
3.1. Accès à l’outil .............................................................................................................................. 10
3.2. Structure du fichier d’import ........................................................................................................ 10
3.3. Opérations réalisées par l’outil .................................................................................................... 11
4. IMPORT DE BRASSAGE .......................................................................................................................... 13
4.1. Accès à l’outil .............................................................................................................................. 13
4.2. Structure du fichier d’import ........................................................................................................ 13
4.3. Opérations réalisées par l’outil .................................................................................................... 14
5. IMPORT D'ADRESSE ................................................................................................................................ 16
5.1. Accès à l’outil .............................................................................................................................. 16
5.2. Structure du fichier d’import ........................................................................................................ 16
5.3. Opérations réalisées par l’outil .................................................................................................... 17
6. IMPORT DE NDS/NDI ................................................................................................................................ 18
6.1. Accès à l’outil .............................................................................................................................. 18
6.2. Structure du fichier d’import ........................................................................................................ 18
6.3. Opérations réalisées par l’outil .................................................................................................... 19
7. IMPORT D'AFFECTATION DE PROJET .................................................................................................. 20
7.1. Accès à l’outil .............................................................................................................................. 20
7.2. Structure du fichier d’import ........................................................................................................ 20
7.3. Opérations réalisées par l’outil .................................................................................................... 21
8. IMPORT DE MASQUE SUR POINTS ET LOCAUX TECHNIQUES ......................................................... 23
5.1. Accès à l’outil .............................................................................................................................. 23
5.2. Structure du fichier d’import ........................................................................................................ 23
5.3. Opérations réalisées par l’outil .................................................................................................... 24
9. ASSOCIATION DE CABLES AUX INFRASTRUCTURES ....................................................................... 27
9.1. Accès à l’outil .............................................................................................................................. 27
9.2. Structure du fichier d’import ........................................................................................................ 27
Ce document présente certaines fonctionnalités permettant l’intégration en masse de données à travers les
différents mécanismes d’import déployés lors de l’installation du module « Import connectique ».
1.1. Terminologie
Import : action permettant d’intégrer en création ou en mise à jour un ensemble de données. Lors d’un import,
le fichier de données est parcouru, contrôlé puis intégré aux données existantes. Le résultat de l’action d’import
est tracé dans une fenêtre de suivi.
Lors du clic sur la tuile d’un des outils (au niveau de son icône ou de sa barre de titre), la zone de celui-ci se
maximise et présente l’interface d’import.
Nom Description
CODE_SITE Code de l’objet NetGeo (site) dans lequel est positionné le local
technique
Obligatoire si le nœud supérieur est un local technique
CODE_BOITE Code de l’objet NetGeo (boîte de protection) dans laquelle est réalisée
l’épissure
Nombre de colonnes différent Le nombre de colonnes ne respecte pas le format demandé en entrée de
de 22 l’import
Les cas suivants ne provoquent pas un arrêt de l’import, mais l’élément concerné n’est pas importé :
Le câble origine (ou Le câble « code du câble » n’existe pas dans NetGeo
destination) n’existe pas
Le câble origine (ou Le câble « code du câble » ne contient pas le tube « numéro du tube » ou
destination) ne contient pas le la fibre « numéro de la fibre »
tube ou la fibre indiquée
Le code du site est renseigné, Le site « code du site » n’existe pas dans NetGeo
mais le site n’existe pas
Le local technique ou le point Le local technique « code du local technique » n’existe pas dans le site
technique n’existe pas « code du site »
ou alors :
Le point technique « code du point technique » n’existe pas
La boîte de protection n’existe La boîte de protection « code de la boîte de protection » n’existe pas dans
pas le point (ou local) technique « code du point (ou local) technique »
La cassette n’existe pas La cassette « code de la cassette » n’existe pas dans la boîte de protection
« code de la boîte de protection »
La position n’est pas libre La position n’est pas libre car elle contient déjà une connexion avec des
fibres différentes de celles indiquées dans le fichier d’import
Le câble origine (ou Le câble « code du câble » n’est pas raccordé au local/point technique
destination) n’est pas raccordé « code du local/point technique »
au nœud supérieur (local ou
point technique)
Le câble origine (ou Le câble « code du câble » n’est pas raccordé à la boîte de protection
destination) n’est pas raccordé « code de la boîte de protection »
au nœud inférieur (boîte de
protection)
Pour toute incohérence détectée, celle-ci est remontée au niveau de la zone d’affichage du résultat de l’outil.
Nom Description
CODE_SITE Code de l’objet NetGeo (site) dans lequel est localisé le local technique
Obligatoire si le nœud supérieur est un local technique
CODE_LOCALTECHNIQUE Code de l’objet NetGeo (Local technique ou point technique) dans lequel est
réalisé le câblage
CODE_ARMOIRE_BOITE Code de l’objet NetGeo (armoire ou boîte de protection) dans lequel est
réalisé le câblage
CODE_EQUIPEMENT Code de l’objet NetGeo (équipement) dans lequel est réalisé le câblage
FACE_EQUIPEMENT Face de l’équipement sur laquelle est réalisé le câblage. Les valeurs
possibles sont les suivantes :
A (face avant)
B (face arrière)
COULEUR_TUBE Couleur du tube. Le code héxadécimal de la couleur doit être celle du tube
dans NetGeo
(facultatif)
L’outil va effectuer les actions suivantes afin de réaliser l’import des données :
- Transfert du fichier de données
- Contrôle de la structure du fichier
- Vérifications de la cohérence des données
- Import des données cohérentes
Nombre de colonnes différent Le nombre de colonnes ne respecte pas le format demandé en entrée de
de 16 l’import
Câble n’existe pas Le câble « code du câble » n’existe pas dans NetGeo
Le câble ne contient pas le Le câble « code du câble » ne contient pas le tube « numéro du tube » ou
tube ou la fibre indiquée la fibre « numéro de la fibre »
Le code du site est renseigné, Le site « code du site » n’existe pas dans NetGeo
mais le site n’existe pas
Le local technique ou le point Le local technique « code du local technique » n’existe pas dans le site
technique n’existe pas « code du site »
ou alors :
Le point technique « code du point technique » n’existe pas
La boîte de protection (ou La boîte de protection (ou l’armoire) « code de la boîte de protection (ou
l’armoire) n’existe pas armoire) » n’existe pas dans le point (ou local) technique « code du point
(local) technique »
L’équipement n’existe pas L’équipement « code de l’équipement » n’existe pas dans NetGeo
Le port n’existe pas Le port « nom du port » face « face de l’équipement » n’existe pas
Le port n’est pas libre Le port n’est pas libre car il contient déjà une connexion avec une fibre
différente de celle indiquée dans le fichier d’import
La fibre n’est pas libre La fibre n’est pas libre car elle est déjà connectée à un port différent de
celui indiqué dans le fichier d’import
Le câble n’est pas raccordé au Le câble « code du câble » n’est pas raccordé au local/point technique
nœud supérieur (local ou point « code du local/point technique »
technique)
Le câble n’est pas raccordé au Le câble « code du câble » n’est pas raccordé à la boîte de protection
nœud inférieur (boîte de « code de la boîte de protection/armoire »
protection ou armoire)
Pour toute incohérence détectée, celle-ci est remontée au niveau de la zone d’affichage du résultat de l’outil.
Nom Description
CODE_SITE Code de l’objet NetGeo (site) dans lequel est localisé le local technique
Obligatoire si le nœud supérieur est un local technique
CODE_LOCAL_POINTTEC Code de l’objet NetGeo (local technique ou point technique) à partir duquel
HNIQUE_ORIGINE débute l’opération de brassage
FACE_EQUIPEMENT_ORIG Face de l’équipement sur laquelle débute le brassage. Les valeurs possibles
INE sont les suivantes :
A (face avant)
B (face arrière)
CODE_JARRETIERE Facultatif.
Un code est automatiquement généré en utilisant la nomenclature associée
au modèle de jarretière si celle-ci a été définie. Sinon, un code avec une
nomenclature par défaut est généré.
CODE_LOCALTECHNIQUE Code de l’objet NetGeo (local technique ou point technique) à partir duquel
_DESTINATION se termine l’opération de brassage
(Facultatif. Par défaut, le brassage se fait dans le même local que celui
d’origine)
Nombre de colonnes différent Le nombre de colonnes ne respecte pas le format demandé en entrée de
de 14 l’import
Les cas suivants ne provoquent pas un arrêt de l’import, mais l’élément concerné n’est pas importé :
Le code du site est renseigné, Le site « code du site » n’existe pas dans NetGeo
mais le site n’existe pas
Le local technique ou le point Le local technique « code du local technique » n’existe pas dans le site
technique n’existe pas « code du site »
ou alors :
Le point technique « code du point technique » n’existe pas
Le port (origine ou destination) Le port « nom du port » face « face de l’équipement » n’existe pas dans
n’existe pas NetGeo
Le port (origine ou destination) Le port n’est pas libre car il contient déjà une connexion avec une jarretière
n’est pas libre ou une fibre différente de celle indiquée dans le fichier d’import
Nom Description
TYPE Type de l’objet sur laquelle l’adresse va être importée. Les valeurs possibles
sont les suivantes :
SITE
POINT TECHNIQUE
LOCAL TECHNIQUE
CODE Code de l’objet NetGeo dont on importe l’adresse (site, point technique ou local
technique)
ETAGE_PARENT Code de l’objet NetGeo (niveau d’un site contenant le local technique)
Obligatoire dans le cas du traitement d’un local technique contenu dans
un niveau d’un site
Contrôle de la structure Le fichier doit contenir 12 colonnes. Si ce n’est pas le cas, l’import n’est pas
du fichier réalisé et le message suivant apparaît :
« Le nombre de colonnes ne respecte pas le format demandé en entrée de
l’import »
Contrôle sur la validité Le champ type est renseigné par l’une des valeurs suivantes :
des données
SITE
POINT TECHNIQUE
LOCAL TECHNIQUE
Attention : L’import d’une adresse annule et remplace l’adresse complète si celle-ci a déjà été définie dans
l’objet concerné par l’import. Cela induit que si un champ de l’adresse est laissé vide dans le fichier d’import,
celui-ci sera également vide dans l’objet NetGeo même si une valeur était renseignée précédemment.
Nom Description
TYPE_CABLE Indique si le câble est un câble optique ou un câble optique interne. Les valeurs
possibles sont :
CableOptique
CableIntraOptique
CableCuivre
CableIntraCuivre
Les contrôles de cohérence sont réalisés pour chacune des lignes du fichier et sont les suivants :
- Le type du câble est correctement renseigné avec une des valeurs suivantes :
CableOptique
CableCuivre
CableIntraOptique
CableIntraCuivre
- Le câble existe dans la base de données de NetGeo
- Le NDS origine existe dans la base de données de NetGeo
- Le NDS extrémité existe dans la base de données de NetGeo
- Le NDI origine existe dans la base de données de NetGeo
- Le NDI extrémité existe dans la base de données de NetGeo
- Si le câble est déjà connecté au(x) NDS/NDI
- Si le câble est déjà connecté sur des NDS/NDI différents de ceux en demande
- Si le NDS origine est localisé à moins d’un mètre de l’origine du câble
- Si le NDS extrémité est localisé à moins d’un mètre de l’extrémité du câble
Pour toute incohérence détectée, celle-ci est remontée au niveau de la zone d’affichage du résultat de l’outil.
Nom Description
TYPE_OBJET Type de l’objet à attacher au projet. Les valeurs possibles sont les suivantes :
CABLECUIVRE
CABLEOPTIQUE
CABLEINTRACUIVRE
CABLEINTRAOPTIQUE
CASSETTE
LOCALTECHNIQUE
NIVEAU
POINTTECHNIQUE
BOITEPROTECTION
EQUIPEMENT
ARMOIRE
SITE
CONNECTEUR
INFRASTRUCTURE
MASQUE
ROUTE
SUPPORT
SUPPORTINTRA
CODE_PARENT_OBJET Code de l’objet NetGeo (parent permettant de définir de manière plus fine
l’emplacement de l’objet)
L’outil va effectuer les actions suivantes afin de réaliser l’import des données :
- Transfert du fichier de données
- Contrôle de la structure du fichier
- Vérifications de la cohérence des données
- Import des données cohérentes
Les contrôles de cohérence sont réalisés pour chacune des lignes du fichier et sont les suivants :
Contrôle de la structure Le fichier doit contenir 4 colonnes. Si ce n’est pas le cas, l’import n’est pas
du fichier réalisé et le message suivant apparaît :
« Le nombre de colonnes ne respecte pas le format demandé en entrée de
l’import »
Vérifications sur le projet Le projet existe et est unique dans la base de données NetGeo
Vérifications sur le type Le champ TYPE_OBJET est renseigné avec une des valeurs de la liste
d’objet à associer suivante :
CABLECUIVRE
CABLEOPTIQUE
CABLEINTRACUIVRE
CABLEINTRAOPTIQUE
CASSETTE
LOCALTECHNIQUE
NIVEAU
POINTTECHNIQUE
BOITEPROTECTION
EQUIPEMENT
ARMOIRE
SITE
CONNECTEUR
INFRASTRUCTURE
MASQUE
ROUTE
SUPPORT
SUPPORTINTRA
L’outil réalise ensuite les associations décrites dans le fichier d’import entre les objets et les projets.
A noter : L’import d’affectation de projet sur un objet parent se propage à l’ensemble de ses objets enfants.
Nom Description
CODE_PARENT Code de l’objet NetGeo (point technique ou local technique) contenant le masque
Indication du type de parent
TYPE_PARENT
Les valeurs attendues sont les suivantes :
PT (pour un point technique)
LT (pour un local technique)
POSITION_ALV_X Position du centre de l’alvéole en X par rapport au coin haut gauche du masque en
mm
Valeur numérique entière
POSITION_ALV_Y Position du centre de l’alvéole en X par rapport au coin haut gauche du masque en
mm
Valeur numérique entière
POSITION_INFRA_X Position en X de l’infra dans l’alvéole (position par rapport au coin haut gauche du
masque en mm)
Valeur numérique entière
POSITION_INFRA_Y Position en Y de l’infra dans l’alvéole (position par rapport au coin haut gauche du
masque en mm)
Valeur numérique entière
Si le masque existe dans la base de données de NetGeo, il y a une mise a jour de ses informations : Nom,
Position et Taille. Sinon, il y a une création du masque.
Les contrôles de cohérence sont réalisés pour chacune des lignes du fichier et sont les suivants :
Contrôles sur la Les valeurs des colonnes suivantes sont des valeurs numériques entières :
validité des
données DIAM_ALVEOLE
POSITION_ALV_X
POSITION_ALV_Y
TAILLE_MASQUE_X
TAILLE_MASQUE_Y
POSITION_INFRA_X
POSITION_INFRA_Y
Les valeurs de la colonne POS_INFRA sont soit ORI soit EXT
Les valeurs de la colonne TYPE_PARENT sont soit PT soit LT
Les valeurs de la colonne POS_MASQUE sont des valeurs numériques
entières comprises entre 1 et 14
Contrôles sur la Le parent existe dans la base de données de NetGeo et est d’un des trois types
définition du suivants :
parent
Point technique
Local technique localisé dans un site
Local technique localisé dans le niveau d’un site
Contrôles des Unicité de la définition d’un masque dans le fichier. Un masque sera défini
masques plusieurs fois dans le fichier afin de lui associer si nécessaire plusieurs alvéoles.
Pour un même masque (identifié par CODE_MASQUE) attaché à un même
parent (identifié par les colonnes CODE_PARENT, TYPE_PARENT), on vérifie
que les champs ci-dessous soient identiques :
Nom (NOM_MASQUE)
Largeur (TAILLE_MASQUE_X)
Hauteur (TAILLE_MASQUE_Y)
Position (POS_MASQUE)
Au niveau du parent, le masque est unique (s’il existe) dans la base de données
de NetGeo
Contrôles des Unicité de la définition d’une alvéole dans le fichier. Une alvéole sera définie
alvéoles plusieurs fois dans le fichier afin de l’associer si nécessaire à plusieurs
infrastructures. Pour une même alvéole (identifiée par CODE_ALVEOLE)
Contrôles des Existence et unicité du groupe d’infrastructure dans la base de données NetGeo
groupes
d’infrastructures Si le masque en origine (ou en extrémité) du groupe d’infrastructures est déjà
défini dans la base de données NetGeo, il doit être le même. Dans le cas
contraire, une erreur est générée.
Unicité de la définition dans le fichier du groupe d’infrastructure par origine (ou
extrémité). Un groupe d’infrastructure sera utilisé plusieurs fois dans le fichier.
Pour un même code de groupe d’infrastructures (identifié par la colonne
CODE_GRPINFRA) avec la même position (identifiée par la colonne
POS_INFRA), on vérifie que les champs ci-dessous soient identiques :
Masque (CODE_MASQUE)
Parent (CODE_PARENT, TYPE_PARENT, CODE_SITE,
CODE_NIVEAU)
Pour toute incohérence détectée, celle-ci est remontée au niveau de la zone d’affichage du résultat de l’outil.
Nom Description
TYPE_CABLE Indique si le câble est un câble optique (ou cuivre) ou un câble optique (ou cuivre)
interne.
Les valeurs possibles sont :
CableOptique
CableCuivre
CableIntraOptique
CableIntraCuivre
Il est à noter que l’outil d’import ne traite que les objets dont les informations d’association ont été renseignées
de manière cohérente.
Le but de cet outil est d’effectuer les associations entre les infrastructures (via leur groupe d’infratsructures) et
les supports qui les transportent.
Il est nécessaire que :
- Les supports soient déjà intégrés dans la base de données de NetGeo lors de l’import
- Les infrastructures (et groupes d’infrastructures) soient déjà intégrées dans la base de données de
NetGeo lors de l’import
À noter : les imports de supports et d’infrastructures sont disponibles via les outils d’import métier de NetGeo
Telecom (Menu Netgeo Import/Export Import SHP/CSV)
[Link]ès à l’outil
Cet outil d’import est accessible à partir du groupe d’outils Import Telecom disponible à partir de l’interface
principale en passant par le menu NetGeo. Il faut ensuite cliquer sur l’outil Association support /
infrastructure.
Nom Description
TYPE_SUPPORT Définit le type du support. Les valeurs possibles sont les suivantes :
Support
SupportIntra (pour les supports internes)
Il est à noter que l’outil d’import ne traite que des objets dont les informations d’import ont été renseignées de
manière cohérente.
Les contrôles de cohérence sont réalisés pour chacune des lignes du fichier et sont les suivants :
Contrôles de la validité des Les valeurs de la colonne TYPE_SUPPORT sont soit Support soit
données SupportIntra
Les valeurs des colonnes POS_X_INFRA_SUPPORT et
POS_Y_INFRA_SUPPORT sont des valeurs numériques entières
Contrôles sur les groupes Le groupe d’infrastructures existe dans la base de données NetGeo
d’infrastructures
Contrôles des associations Détection des associations entre groupes d’infrastructures et supports :
Qui existent et ne seront pas modifiées
Qui n’existent pas et seront créées
Détection des associations entre infrastructure et support :
Qui existent et sont inchangées (X, Y)
Qui existent et sont modifiées (X, Y)
Qui n’existent pas
Qui ne doivent pas être déclarées (infrastructures de niveau 2 ou
supérieur)
Pour toute incohérence détectée, celle-ci est remontée au niveau de la zone d’affichage du résultat de l’outil.
A noter :
Les groupes d’infrastructures sont associés aux supports.
Les infrastructures de 1er niveau (attachées directement à un groupe d’infrastructure) sont associées
au support et sont localisées dans le support en X et Y.
Les infrastructures de 2nd niveau ou supérieur (attachées à une infrastructure) ne sont pas associées
au support et ne sont pas localisées dans le support.