Import — Administration

1.1 Hiérarchies

Principes de création d'une hiérarchie et ses valeurs

📃

Format de fichier accepté :

.csv
.xls
.xlsx

Les hiérarchies dans Project Monitor peuvent être créées :

Directement dans l'application par saisie dans les champs. La saisie se fait soit en mode rapide avec uniquement la saisie du nom soit en mode avancé avec la possibilité de saisir des informations complémentaires. Ce mode de création inclut des fonctions de « cliquer glisser » pour modifier le rattachement d'une valeur.
À l'aide du mécanisme d'import de fichier.

‣

Modèles d'import à télécharger

Hiérarchie

Une hiérarchie permet d'organiser la plateforme en regroupant hiérarchiquement des objets (projets, ressources, etc.) ou des utilisateurs. Hiérarchies

Permet de réaliser une gestion des droits et de localiser/cloisonner l'accès à certains objets. On parle de rattachement.

Exemple : la hiérarchie géographie contient en niveau 1 les continents, en niveau 2 les pays, en niveau 3 les villes.

Il est possible d'associer une hiérarchie à un groupe d'utilisateurs pour faire des restrictions de droits. Par défaut, un objet est en accès sans restriction, mais s'il est rattaché à un groupe d'utilisateurs, seuls les utilisateurs rattachés à ce groupe peuvent utiliser l'objet.

🚩

Nouveauté v7.8 : Codes de niveau partagés entre hiérarchies

L'import accepte désormais un code de niveau qui existe déjà dans une autre hiérarchie de la plateforme. L'unicité du code de niveau n'est plus exigée entre hiérarchies — elle reste maintenue à l'intérieur d'une même hiérarchie.

HIÉRARCHIE	NIVEAU 1	NIVEAU 2	NIVEAU 3
Géographie	Continent	Pays	Ville
	Europe	France	Paris
			Nantes
		Italie	Rome
			Milan
	Asie	Japon	Tokyo
		Inde	New Dehli
			Bombay

Illustration des concepts d'une hiérarchie

Création d'une hiérarchie par fichier

Cliquer sur Menu principal > Administration, Administration des données > Imports > Attributs, risques et hiérarchies.

La création d'une hiérarchie par import de fichier permet de créer :

Les libellés, codes et descriptions des niveaux
Les libellés, codes et descriptions des valeurs de niveau

Les paramètres du niveau et les caractéristiques complémentaires des niveaux devront être ajustés directement à l'aide de l'interface.

Règle et formalisme du fichier

La structure du fichier doit être la suivante :

Les données doivent figurer sur le premier onglet
La première ligne définit les intitulés des informations importées ou exportées sur les niveaux et valeurs de niveau. Le libellé de ces colonnes doit être défini dans l'administration des libellés. Par défaut on a : Libelle_VN, Code_VN, Description_VN
La deuxième ligne définit les libellés, codes et descriptions des niveaux
Les lignes suivantes définissent l'arborescence des valeurs de niveau
Il faut reprendre l'ensemble des parents pour chaque valeur de niveau filles sur chaque ligne.
Il ne faut pas de ligne vide.

Limitations

Le mécanisme d'import ne permet pas de mise à jour des codes de hiérarchie ou des codes de niveau de hiérarchie.

Sur l'exemple, on ne peut pas créer une valeur de niveau sous « EUROPE » par import.

Si la liste des niveaux ne correspond pas au contenu de la hiérarchie : message d'erreur

Conseil / Mode opératoire

Nous vous conseillons de procéder comme suit pour la réalisation d'un import :

Création dans Project Monitor de la hiérarchie et de ses propriétés
Création dans Project Monitor des niveaux et de leurs propriétés
Exporter au format Excel® la structure de la hiérarchie
Compléter le fichier obtenu avec les différentes valeurs de niveaux souhaitées
Importer le fichier modifié
Si nécessaire, mettre à jour le détail des valeurs de niveau (code, logo, description)

Modification d'une hiérarchie par fichier

La modification d'une hiérarchie par import de fichier permet de modifier les libellés et descriptions des valeurs de niveau.

L'unicité du code de la valeur de niveau (à l'intérieur d'une même hiérarchie) est le point d'entrée :

Lecture d'un code existant dans la hiérarchie : modification si le fichier contient un libellé ou une description différente,
Lecture d'un code inexistant : création d'une nouvelle valeur de niveau.

💡

Exemple :

Les lignes suivantes contiennent les valeurs des différents niveaux

Lecture B9 : code connu → la hiérarchie sera modifiée à cette valeur de niveau ou plus bas.

Comparaison des champs et modification si delta

Lecture E9 : code connu → la hiérarchie sera modifiée à cette valeur de niveau ou plus bas.
Lecture K9 : nouveau code → cette valeur de niveau de la hiérarchie sera ajoutée.

Via commande cURL

L'import de hiérarchie est faisable via un appel de webservice en fournissant le fichier excel d'import.

Étape 1 : Récupérer le token

curl -X GET -H X-PM-LOGIN  // Login de l'utilisateur //
-H X-PM-PASSWORD:admin "http://localhost:8888/MonitorMakerWeb/api/auth/jwt/token" // Adresse du serveur //

Étape 2 : Lancer l'import de hiérarchies

curl POST X-PM-LOGIN: // Login de l'utilisateur //
-H Authorization: // Autorisation token //
-H Accept:application/json 
-F attachment=@D:/projectmonitor/temp/Hierarchies.xls // Chemin du fichier à importer //
"http://localhost:8888/MonitorMakerWeb/api/import/IMPORT_HIERARCHIE" // Adresse du WebService import des hiérarchies //

Tous les niveaux décrits dans le fichier sont importés même s'ils n'ont pas de valeur de niveau associée.

Si le niveau existe déjà (recherche par code), alors le reste des informations du fichier est ignoré (pas de mise à jour des libellés).

Erreurs bloquantes :

format d'entête incorrect
hiérarchie inexistante
ligne des niveaux incorrecte

Erreur non bloquante :

erreur sur une ligne de description de valeur de niveau (la ligne entière n'est pas importée)

1.2 Risques

📃

Format de fichier accepté :

.csv
.xls
.xlsx

Le fichier doit contenir une ligne d'en-tête.

L'import de mesure n'est disponible que pour de la création de mesure. Cet import ne dispose pas de code action. Par conséquent, il n'est pas possible de modifier ou de supprimer des mesures par le biais de cet import.

Le fichier en import possède au minimum les 6 colonnes détaillées dans le tableau.

Cliquer sur Menu principal > Administration, Administration des données > Imports > Attributs, risques et hiérarchies.

Cet import fonctionne aussi pour les indicateurs : le format attendu est identique.

Colonne	Description	Règle
Code Mesure	Code mesure à créer	Obligatoire
Libellé Mesure	Libellé mesure à créer	Obligatoire
Libellé long Mesure	Libellé long de la mesure	Facultatif
Description Mesure	Description de la mesure	Facultatif
Code Genre	Code d'identification du genre	Obligatoire
Code Catégorie	Code d'identification de la catégorie	Obligatoire
Hiérarchie\*	Code de la hiérarchie de rattachement	Facultatif
Niveau\*	Code du niveau de rattachement	Obligatoire si Hiérarchie
Valeur de niveau\*	Code de la valeur de niveau de rattachement	Obligatoire si Hiérarchie

(*) : On répète ces 3 dernières colonnes autant de fois que la mesure est rattachée

1.3 Utilisateurs

Voir Utilisateurs

1.4 Attributs

Principe

📃

Format de fichier accepté :

.xls

Le fichier doit contenir une ligne d'en-tête.

L'import des attributs n'est disponible que pour de la création des attributs. Cet import ne dispose pas de code action. Par conséquent, il n'est pas possible de modifier ou de supprimer des attributs par le biais de cet import.

Cliquer sur Menu principal > Administration, Administration des données > Imports > Attributs, risques et hiérarchies.
Cliquer sur le bouton Ajouter un fichier ou glisser déposer le fichier pour charger le fichier contenant les attributs à importer,
Cliquer sur le bouton Importer pour démarrer l'import.

Lors de l'import, les attributs en erreur ne sont pas importés et un message d'erreur apparaît dans le rapport d'import.

Erreurs pouvant être rencontrées

Un des champs obligatoires non renseigné
Code projet avec des caractères non autorisés
Groupe ou formulaire non créé
Liste non créée pour un attribut liste
Pour un attribut calculé, contrôle sur format de l'attribut. Doit être numérique.
Si formule avec des attributs autres format que ceux acceptés
Critère de rupture coché sur un attribut dont le format ne le permet pas.
Critère de recherche coché sur un attribut dont le format ne le permet pas.
Critère de recherche rapide coché sur un attribut dont le format ne le permet pas.

Liste des champs

Colonne	Description	Règle
Code Attribut	Code de l'attribut à créer	Obligatoire Le code ne peut contenir que des lettres et des chiffres (les caractères suivants inclus «- » « _ » « / »).
Type d'objet	Type d'objet associé à l'attribut	Obligatoire Les valeurs possibles dans cette colonne sont : PROJET, TACHE, ECHANGE, PHASE (=planning), FILTRE (=portefeuille), UP (=plateforme), DEMANDE
Libellé attribut	Libellé de l'attribut à créer	Obligatoire
Ordre	Valeur numérique pilotant le positionnement de l'attribut dans l'onglet du projet	Facultatif
Groupe	Code du groupe d'attribut	Facultatif
Thème	Thème dans lequel l'attribut apparaît	Obligatoire Préciser le thème correspondant en majuscule : PROJET, PLANNING, RESSOURCE, BUDGET, INDICATEUR, RISQUE, REVENU
Format	Format de création de l'attribut	Obligatoire Préciser le format attendu en majuscule : CHAINE, NUMERIQUE, BOOLEEN, LISTE, DATE, AREA, RICHE, IMAGE, DOCUMENT
Liste	Code de la liste de l'attribut au format LISTE	Obligatoire si format LISTE Sinon, OK si VIDE
Valeur par défaut	Valeur de l'attribut par défaut	Facultatif CHAINE : texte NUMERIQUE : Chiffre BOOLEEN : VRAI (si doit être coché) LISTE : code de la valeur de liste DATE : jj/mm/aaaa AREA : texte RICHE : texte
Unité	Texte ou symbole à saisir Information de l'unité de l'attribut	Facultatif
Calculé	Au format booléen.	Facultatif VRAI (si doit être coché) N.B. : pour les attributs au format numérique
Formule	Formule préfixée par UP.CODE_ATTRIBUT ou PROJET.CODE_ATTRIBUT *Construction de la formule avec les caractères standards (+ ; - ; ; /).**	Obligatoire Si l'attribut est au format numérique calculé Les attributs pouvant entrer dans la formule sont ceux au format NUMERIQUE, LISTE Facultatif si autre format
Confidentiel	Au format booléen.	Facultatif VRAI (si doit être coché)
Obligatoire	Au format booléen.	Facultatif VRAI (si doit être coché)
Universel	Au format booléen. L'attribut est présent dans tous les projets	Facultatif VRAI (si doit être coché)
Critère de rupture	Au format booléen. Permet une consolidation	Facultatif Valable (cochable si format de l'attribut : LISTE, BOOLEEN, NUMERIQUE, CHAINE, DATE) VRAI (si doit être coché)
Critère de recherche	Au format booléen. Permet de rechercher selon cet attribut	Facultatif Valable (cochable si format de l'attribut : LISTE, BOOLEEN, NUMERIQUE, CHAINE, DATE) VRAI (si doit être coché)
Critère de recherche rapide	Au format booléen. Permet d'ajouter l'attribut à la page « mise à jour rapide »	Facultatif VRAI (si doit être coché) N.B. : pour les attributs critères de recherche. Si critère de recherche rapide coché et par critère de recherche alors l'erreur remonte dans le rapport d'import.