S'applique à
EXFO Exchange
Introduction
Cette procédure vous montrera comment importer plusieurs travaux à la fois dans EXFO Exchange, en utilisant le format de fichier CSV.
Procédure à suivre
Il est possible de créer plusieurs travaux à la fois dans EXFO Exchange en les important via un fichier CSV.
Cette procédure est divisée en deux parties ;
A. Préparer le fichier CSV
B. Importer le fichier CSV
A. Préparer le fichier CSV
1. Format du fichier
Le format de fichier CSV pris en charge par Exchange comporte quelques spécifications qui doivent être prises en considération si vous voulez que vos tâches soient importées correctement.
Voici le contenu d'un exemple de fichier.
name | assignees | company | customer | dueDate | customProperty_City | customProperty_Region | testPointName | identifier_Cable ID | identifier_Fiber ID | testType_01 | testType_02 | testType_03 | testConfigurations |
Job-1 | user1@exfo.com | EXFO | Operator 1 | 12/16/2022 | Quebec | North Shore | Cable001 - Fiber01 | 1 | 1 | FIP | iOLM | Picture & GPS | DefaultConfig.iolmcfg |
Cable001 - Fiber02 | 1 | 2 | FIP | iOLM | |||||||||
Job-2 | EXFO | Business A | 01/17/2023 | Montreal | Island | Cable001 - Fiber01 | 1 | 1 | FIP | OTDR | Picture & GPS | IEC SM SF APC.cmax2cfg | |
Cable001 - Fiber02 | 1 | 2 | FIP | OTDR | |||||||||
Job-3 | user1@exfo.com|user2@exfo.com | EXFO | Cellsite36 | Levis | South Shore | Cable001 - Fiber01 | 1 | 1 | FIP | OPM | Check Live Fiber | IEC SM SF APC.cmax2cfg|1550nm -20dBm.opmcfg | |
Cable001 - Fiber02 | 1 | 2 | FIP | OPM |
2. Colonnes obligatoires
Les colonnes suivantes sont obligatoires. Si vous omettez l'une d'entre elles, le fichier CSV ne pourra pas être importé.
- name
- testPointName
- testType_01
3. Colonnes supplémentaires et facultatives
Les colonnes suivantes sont facultatives
- assignees
- company
- customer
- dueDate
- customProperty_xx
- identifier_xx
- testType_xx
- testConfiguration
Remarque : toutes les colonnes facultatives et supplémentaires peuvent avoir des valeurs "vides", si nécessaire.
3.1 Assignés
- La colonne des destinataires peut contenir l'adresse électronique des utilisateurs auxquels vous souhaitez attribuer la tâche correspondante.
- IMPORTANT : Veillez à ce que les adresses électroniques soient écrites exactement comme elles sont affichées dans la page Membres.
- Remarque : vous pouvez inclure plus d'un destinataire par travail en utilisant le caractère "pipe".
- Si un utilisateur n'est PAS visible dans la page Membres, vous devez d'abord l'inviter à Exchange.
- Veuillez vous référer à Inviter des utilisateurs à votre organisation EXFO Exchange à partir de l'application web pour plus de détails sur la façon d'inviter des utilisateurs dans Exchange.
3.2 Date d'échéance
Vous pouvez spécifier une date d'échéance pour chaque tâche que vous souhaitez importer, en indiquant une date dans la colonne dueDate.
Voici les formats de date actuellement pris en charge
- aaaa-mm-jj (par exemple 2022-11-25)
- mm/jj/aaaa (par exemple, 25/11/2022)
S'il est défini, le nombre de jours avant que la tâche ne soit "due" apparaîtra dans l'application web, dans la page "Jobs".
Note: Cette date apparaîtra également sur l'application client MaxTester, FTB et Mobile.
3.3 Propriétés personnalisées
- Les propriétés des tâches permettent d'identifier les actifs du réseau qui seront testés.
- Outre la société et le client, qui sont des propriétés standard, vous pouvez définir des propriétés supplémentaires pour les tâches que vous souhaitez importer.
- Pour définir une nouvelle propriété personnalisée, vous devez ajouter une colonne supplémentaire avec le modèle customProperty_My property, où "My property" est le nom de votre propriété personnalisée.
IMPORTANT : Toutes les tâches que vous définirez dans votre fichier CSV doivent avoir les mêmes propriétés personnalisées, mais certaines d'entre elles peuvent être vides.
3.4 Identifiants
- Les identificateurs de test sont également un bon moyen d'identifier les ressources du réseau et les ports à tester.
- Outre le testPointName, vous pouvez définir des identifiants personnalisés pour documenter les tests à exécuter. Chaque nom/valeur d'identifiant sera stocké dans les résultats des tests et inclus dans les rapports générés à partir de ces résultats.
- Pour définir un nouvel identifiant, vous devez ajouter une colonne supplémentaire avec le modèle identifier_My ID, où "My ID" est le nom de votre identifiant.
Remarque : le nom du testPointName est affiché dans la liste des tests sur les applications client MaxTester, FTB et Mobile. Il est également utilisé pour définir les noms des fichiers de résultats (par exemple Cable001 - Fiber01.iolm).
4. Types de tests
- Pour chaque tâche et point de test, vous devez spécifier au moins un type de test. Toutefois, vous pouvez également ajouter des types de test supplémentaires si nécessaire.
- Pour définir un nouveau type de test, vous devez ajouter une colonne supplémentaire avec le modèle testType_xx, où XX est le numéro/compte du nouveau type de test (c'est-à-dire 01, 02, 03, etc.).
- En outre, la valeur que vous spécifiez pour chaque ligne de point de test / colonne de type de test associera les deux ensemble.
- Types de tests actuellement pris en charge (sensibles à la casse):
FIP
iOLM
OTDR
OPM
OLTS
OLX - Tout autre test est considéré comme un test "générique", qui peut être exécuté sur l'application mobile (par exemple, GPS, Picture, Check VFL).
- Vous pouvez également définir des "sous-types", qui sont des étiquettes supplémentaires affichées dans les applications clientes pour identifier le test à exécuter (par exemple, Endface, A->B, etc.).
- Les types et sous-types de test doivent être séparés par le caractère "pipe" (sans espace).
5. Configurations de test
- Vous pouvez associer une ou plusieurs configurations de test à une tâche lorsque vous les importez au format CSV.
- Cependant, vous ne pouvez pas associer une configuration à un point de test particulier (par exemple, Cable001 - Fiber02). Par conséquent, la ou les mêmes configurations de test seront utilisées pour tous les points de test d'une même tâche.
- Pour associer une configuration particulière à une tâche, vous devez spécifier son nom de fichier dans la colonne testConfiguration, sur la même ligne que le nom de la tâche correspondante.
Remarque : vous pouvez spécifier plusieurs configurations de test en les séparant par le caractère "pipe" (sans espace).
- Pour en savoir plus sur la façon de rendre votre propre configuration de test disponible dans Exchange, veuillez lire Importer des configurations de test dans votre organisation EXFO Exchange.
B. Importer le fichier CSV
Une fois que votre fichier CSV est prêt, vous pouvez l'importer dans Exchange en suivant les étapes suivantes.
1. Sélectionnez l'espace de travail approprié dans lequel vous souhaitez importer la ou les tâches.
2. Naviguez jusqu'à la page Jobs.
3. Cliquez sur la flèche déroulante située à côté du bouton Add et sélectionnez Importer.
4. Naviguez pour sélectionner le fichier CSV que vous souhaitez importer et cliquez sur Import.
5. La liste doit être rafraîchie et les nouvelles tâches que vous avez importées doivent être visibles.
6. En cas de problème avec le format de votre fichier CSV, un message d'erreur s'affiche avec les causes possibles de l'échec.