1. Hiérarchies
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.
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.
Exemple : la hiérarchie géographie contient en niveau 1 les continents, en niveau 2 les pays, en niveau 3 les villes.
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 |
Principes de création d'une hiérarchie et ses valeurs
Format de fichier accepté :
- .csv
- .xls
- .xlsx
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.
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.
Création d'une hiérarchie par fichier
- Cliquer sur
Menu principal >
Administration, Administration des données > Imports>.svg)
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.
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)
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
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)
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 Administration, Administration des données > Imports > Attributs, risques et hiérarchies.
Cet import fonctionne aussi pour les indicateurs : le format attendu est identique.
Colonne | Code Mesure | Libellé Mesure | Libellé long Mesure | Description Mesure | Code Genre | Code Catégorie | Hiérarchie\* | Niveau\* | Valeur de niveau\* |
Description | Code mesure à créer | Libellé mesure à créer | Libellé long de la mesure | Description de la mesure | Code d'identification du genre | Code d'identification de la catégorie | Code de la hiérarchie de rattachement | Code du niveau de rattachement | Code de la valeur de niveau de rattachement |
Obligatoire | ✅ Oui | ✅ Oui | ❌ Non | ❌ Non | ✅ Oui | ✅ Oui | ❌ Non | ✅ Oui si colonne Hiérarchie ajoutée | ✅ Oui si colonne Hiérarchie ajoutée |
(*) : On répète ces 3 dernières colonnes autant de fois que la mesure est rattachée
3. Utilisateurs
L'écran Import des utilisateurs vous permet de créer plusieurs utilisateurs en une seule fois et de modifier des utilisateurs existants, à partir d'un fichier CSV.
Nouveauté v7.8 : Refonte de l'écran
- Les performances de l'import ont été améliorées, vous permettez d'importer plus rapidement vos lots d'utilisateurs.
- L'invite de mot de passe à la création disparaît : les utilisateurs définissent leur mot de passe à leur premier accès.
- Une meilleure expérience avec un écran plus moderne.
1. Télécharger le modèle
- Ne pas modifier les noms de colonnes du modèle. Les en-têtes contiennent un identifiant technique entre crochets (exemple :
Login*_[1135343]). Cet identifiant est utilisé par Project monitor pour relier chaque colonne au bon attribut. Si vous le retirez ou le modifiez, l'import échoue. - L'ordre des colonnes doit être strictement respecté.
- Le fichier doit être au format CSV, séparateur point-virgule (
;), encodage UTF-8.
Avant tout import, téléchargez le modèle CSV pour avoir la bonne structure de fichier.
- Cliquer sur Administration > Administration des données >
Imports>
Utilisateurs. - Cliquer sur Télécharger le modèle
- Ouvrir le fichier avec votre tableur ou un éditeur de texte.
Le fichier modèle est téléchargé sur votre poste, au format CSV.
Premier accès et définition du mot de passe
À la création d'un utilisateur (par import ou unitaire), un mot de passe aléatoire est généré automatiquement. Ni l'administrateur, ni l'utilisateur ne le reçoivent.
Selon le mode de connexion de votre plateforme, le premier accès de l'utilisateur se passe ainsi :
- Connexion par SSO : l'utilisateur se connecte directement via le SSO de votre organisation, sans aucune saisie de mot de passe.
- Connexion par identifiant et mot de passe : l'utilisateur clique sur Mot de passe oublié depuis l'écran de connexion. Il reçoit alors un e-mail lui permettant de définir lui-même son mot de passe, conformément aux règles de la plateforme.
Contenu du modèle
Le modèle contient 13 colonnes. Les colonnes marquées d'une étoile (*) sont obligatoires, les autres sont facultatives.
Colonne | Login | Prénom | Nom | Description | Fonction | Mail | Société | Téléphone standard | Téléphone bureau | Téléphone mobile | Date d'ouverture | Date de fermeture | Ressource suivie |
Description | Identifiant unique de connexion de l'utilisateur. | Prénom de l'utilisateur. | Nom de l'utilisateur. | Description libre de l'utilisateur. | Fonction ou intitulé de poste. | Adresse e-mail de l'utilisateur. Utilisée pour les notifications et l'envoi du lien de premier accès. | Société de rattachement. | Numéro de téléphone standard. | Numéro de téléphone du bureau. | Numéro de téléphone mobile. | Date à partir de laquelle l'utilisateur peut se connecter. Doit être au format DD/MM/YYYY. | Date à partir de laquelle l'utilisateur ne peut plus se connecter. Doit être au format DD/MM/YYYY. | Login de la ressource suivie par l'utilisateur, si applicable. Renseigner VRAI ou TRUE pour activer la création de la ressource. Cette colonne est obligatoire. |
Obligatoire | ✅ Oui | ✅ Oui | ✅ Oui | ❌ Non | ❌ Non | ✅ Oui | ❌ Non | ❌ Non | ❌ Non | ❌ Non | ❌ Non | ❌ Non | ✅ Oui |
En modification d'un utilisateur existant, la colonne Ressource suivie est obligatoire : une valeur vide désactive le suivi de la ressource. Renseignez-la pour chaque ligne du fichier.
2. Importer le modèle
Une fois le fichier complété, importez-le pour créer les utilisateurs.
- Cliquer sur Administration > Administration des données >
Imports>Utilisateurs. - Cliquer dans la zone de dépôt ou faire glisser-déposer votre fichier
.csv. - Cliquer sur Importer.
Le fichier sélectionné s'affiche dans la zone.
L'import démarre. Une fois terminé, un message de retour s'affiche.
Pour chaque ligne valide, un utilisateur est créé sur la plateforme.
Vous le retrouvez dans la liste des utilisateurs (Administration > Paramétrage utilisateur > Gestion des utilisateurs > 
Utilisateurs).
Importer deux fois le même fichier ne supprime plus les utilisateurs depuis la version 7.8.
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 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.
Colonne | Code Attribut | Type d'objet | Libellé attribut | Ordre | Groupe | Thème | Format | Liste | Valeur par défaut | Unité | Calculé | Formule | Confidentiel | Obligatoire | Universel | Critère de rupture | Critère de recherche | Critère de recherche rapide |
Description | Code de l'attribut à créer | Type d'objet associé à l'attribut | Libellé de l'attribut à créer | Valeur numérique pilotant le positionnement de l'attribut dans l'onglet du projet | Code du groupe d'attribut | Thème dans lequel l'attribut apparaît | Format de création de l'attribut | Code de la liste de l'attribut au format LISTE | Valeur de l'attribut par défaut | Texte ou symbole à saisir Information de l'unité de l'attribut | Au format booléen. | Formule préfixée par UP.CODE_ATTRIBUT ou PROJET.CODE_ATTRIBUT
Construction de la formule avec les caractères standards (+ ; - ; * ; /). | Au format booléen. | Au format booléen. | Au format booléen. L'attribut est présent dans tous les projets | Au format booléen.
Permet une consolidation | Au format booléen.
Permet de rechercher selon cet attribut | Au format booléen.
Permet d'ajouter l'attribut à la page « mise à jour rapide » |
Obligatoire | ✅ Oui | ✅ Oui | ✅ Oui | ❌ Non | ❌ Non | ✅ Oui | ✅ Oui | ✅ Oui, si Format = LISTE | ❌ Non | ❌ Non | ❌ Non | ✅ Oui, si Format = NUMERIQUE et si Calculé = VRAI | ❌ Non | ❌ Non | ❌ Non | ❌ Non | ❌ Non | ❌ Non |
Règles spécifiques | Le code ne peut contenir que des lettres et des chiffres (les caractères suivants inclus «- » « _ » « / »). | Les valeurs possibles dans cette colonne sont : PROJET, TACHE, ECHANGE, PHASE (=planning), FILTRE (=portefeuille), UP (=plateforme), DEMANDE | Préciser le thème correspondant en majuscule : PROJET, PLANNING, RESSOURCE, BUDGET, INDICATEUR, RISQUE, REVENU | Préciser le format attendu en majuscule : CHAINE, NUMERIQUE, BOOLEEN, LISTE, DATE, AREA, RICHE, IMAGE, DOCUMENT | Sinon, OK si vide | 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 | VRAI (si doit être coché)
N.B. : pour les attributs au format numérique | Les attributs pouvant entrer dans la formule sont ceux au format NUMERIQUE, LISTE
Facultatif si autre format | VRAI (si doit être coché) | VRAI (si doit être coché) | VRAI (si doit être coché) | Valable (cochable si format de l'attribut : LISTE, BOOLEEN, NUMERIQUE, CHAINE, DATE)
VRAI (si doit être coché) | Valable (cochable si format de l'attribut : LISTE, BOOLEEN, NUMERIQUE, CHAINE, DATE)
VRAI (si doit être coché) | 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. |