1. Préambule
Objet du document
Le présent document présente les capacités et modalités d’import de Project Monitor.
Cela couvre les imports de :
- Hiérarchie
- Projet
- Mesures
2. Imports du thème Administration
2.1 Hiérarchies
Principes de création d’une hiérarchie et ses valeurs
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Pour rappel les hiérarchies sont des arborescences qui permettent de classer les projets, les ressources.. Une hiérarchie dispose de plusieurs caractéristiques (rattachement obligatoire, règle de comportement…). Une hiérarchie est composée de niveaux dont on définit le comportement (critère d’analyse, niveau de rattachement…). Chaque niveau comprend des valeurs de niveau disposant des caractéristiques suivantes Code / Libellé / Libellé long / Description / Logo.
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.
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
La création d’une hiérarchie par fichier
Cliquer sur le menu principal, Admin
, section Administration des données
puis Import
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.
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 est le point d’entrée :
- Lecture d’un code existant : modification si le fichier contient un libellé ou une description différente,
- Lecture d’un code inexistant : création d’un nouveau niveau.
Exemple :
Contenu du fichier :
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.
Si la liste des niveaux ne correspond pas au contenu de la hiérarchie : message d'erreur
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.
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)
2.2 Risques
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier doit contenir une ligne d’en-têtes.
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 le menu principal, Admin
, section Administration des données
puis Import
Attributs, risques et hiérarchies
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
2.3 Utilisateurs
Principe
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier doit contenir une ligne d’en-têtes.
L’import des utilisateurs n’est disponible que pour de la création des utilisateurs. 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.
Les 4 premières colonnes sont obligatoires. Les colonnes doivent être ordonnées comme dans le tableau :
Dans l'écran d'import des utilisateurs
- Remplir les champs communs à tous les utilisateurs importés.
- Cliquer sur
Importer un fichier csv xls ldif
en haut à droite - Sélectionner le fichier.
- Cliquer sur
Enregistrer
pour déclencher l'import des utilisateurs de la liste.
La liste "utilisateurs en cours d'import" se remplit, un tooltip détaille les erreurs.
Erreurs pouvant être rencontrées
- Ce login est déjà utilisé
- Le login ne peut contenir que des lettres et des chiffres (les caractères suivants inclus : '_','-','.','@').
- L’e-mail doit être sous la forme chaîne@serveur.extension
- Le mot de passe est obligatoire
- Contactez Virage Group pour acquérir des licences supplémentaires
Colonne | Description | Règle |
Code utilisateur | Login | Obligatoire
Le login ne peut contenir que des lettres et des chiffres (les caractères suivants inclus : '_','-','.','@'). |
Libellé utilisateur | Prénom | Obligatoire |
Libellé long utilisateur | Nom | Obligatoire |
Mail | E-mail | Obligatoire
Chaîne@serveur.extension |
Société | Société | Facultatif |
Fonction | Fonction | Facultatif |
Téléphone standard | 20 caractères | Facultatif
20 caractères maximum (pas de contrainte sur les caractères acceptés) |
Téléphone bureau | 20 caractères | Facultatif
20 caractères maximum (pas de contrainte sur les caractères acceptés) |
Téléphone Mobile | 20 caractères | Facultatif
20 caractères maximum (pas de contrainte sur les caractères acceptés) |
2.4 Attributs
Principe
Format de fichier accepté :
- .xls
Le fichier doit contenir une ligne d’en-têtes.
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 le menu principal,
Admin
, sectionAdministration des données
puisImport
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. |
3. Import des projets par fichier Excel®
3.1 Principe de création de projet
La création de projet peut se faire soit par :
- L’interface de l’application (cas mono projet)
- Un import de fichier Excel (XLS, XLSX) (cas multiprojets)
- Les webservices (cas mono ou multiprojets)
Dans le cas de la création par interface, on crée projet par projet. Les modes opératoires peuvent être :
- Création à partir d’une structure vierge
- Duplication d’un projet existant
- Création à partir d’un modèle (ou gabarit) de projet
- Import MS Project
Dans le cas d’une création avec Excel® (format .xls), on peut créer de 1 à N projets en un seul import.
Méthode
Il existe 2 possibilités afin d’importer des projets dans Project Monitor :
- Manuelle : en passant par les commandes en tâche de fond
- Par webservice en tâche planifiée : utilisation de curl
L’utilisation de l’une ou l’autre méthode dépend essentiellement de l’objectif recherché et de sa fréquence :
- Création/Modification ponctuelle à Manuelle
- Modification hebdomadaire voire quotidienne à cURL / Voir le mémo webservices pour ce mode opératoire
L’import manuel se fait par le biais des commandes en tâche de fond disponibles dans le Thème Projets
> Paramétrage
> Import
.
Contraintes
Droit requis :
Format de fichier accepté :
- .xls
- .xlsx
Il est impossible de créer des projets par import si le paramétrage génère des codes automatiques.
Configuration globale - ‣
Un message d'erreur sera affiché :
“ERROR - L'import projet n'est pas possible sur une plateforme configurée en génération automatique de codes projet
”
Si votre import est réalisé en mode manuel, alors il vous est possible de suspendre ce paramétrage afin de permettre l’import.
3.2 La création de projet par fichier Excel®
Le fichier d’import Excel® permet la création des éléments d’identification du projet, leur structure, les objets des thèmes planning, ressource, budget, indicateur. Il permet d’initier les valeurs sur :
- L’identité (libellé, description, date de début / fin, CP, …)
- Le rattachement dans les hiérarchies
- Les différentes valeurs pour les différents champs attributs
- Les équipes projet
- Les phases et jalons du projet
- Les indicateurs avec leurs valeurs
- Les budgets avec leurs valeurs – pour des imports budgets avancés (enveloppe, pièce financière, …) voir les chapitres dédiés (import enveloppe ; import pièce financière ; synchronisation budget).
- Les ressources du projet sans affectation de cible – pour des imports avancés, voir les chapitres dédiés (import saisie activité ; import planifié ; import des ressources).
Les dates dans le fichier Excel® doivent être sous la forme jj/mm/aaaa indépendamment de la langue de l’utilisateur. Pour ce faire le format de cellule doit être de type date et de paramètre régional France.
Les paramètres ou informations complémentaires seront réalisés directement à l’aide de l’interface. (Ex : vue associée, logo, fichiers, …)
Structure du fichier Excel® d’import de projets
La structure du fichier Excel® doit être la suivante :
- La première ligne des feuilles Excel® désigne le nom des colonnes. Elle n’est pas importée.
- Un onglet par typologie de donnée (identification / rattachement hiérarchique / attribut)
- Les libellés d’onglet doivent prendre le formalisme suivant :
- Le nom de l’onglet pour l’identification doit être préfixé par
PRJ-
- Cet onglet est obligatoire. - Le nom de l’onglet pour le rattachement doit être préfixé par
RAT-
- Pour une utilisation en mise à jour préfixe
RAT-
suffixe-DIFF
- Le nom de l’onglet pour l’équipe doit être préfixé par
EQU-
- Pour une utilisation en mise à jour préfixe
EQU-
suffixe-DIFF
- Le nom de l’onglet pour les valeurs des attributs doit être préfixé par
ATT-
- Le nom de l’onglet pour le planning doit être préfixé par
PLA-
- Le nom de l’onglet pour les budgets doit être préfixé par
BUD-
- Le nom de l’onglet pour les ressources doit être préfixé par
RES-
- Le nom de l’onglet pour les indicateurs doit être préfixé par
IND-
- Le nom de l’onglet pour le planifié réparti des indicateurs doit être préfixé par
IND-PLAN
. - Le nom de l’onglet pour les tâches associées au projet doit être préfixé par
TAC-
. - Il ne faut pas de ligne vide
Limitations
Le mécanisme d’import ne permet pas de créer des indicateurs métiers autres que les jalons/ressources/indicateurs/budgets/tâches (ex : risques, échanges, …).
Pour les ressources, l’import Excel® ne permet pas d’importer des valeurs cibles, réalisées, … Les données sont initialisées à 0.
3.3 Structure du fichier Excel®
3.3.1 Détail de l’onglet IDENTIFICATION
Règles particulières :
- Une ligne par projet
- Il est possible de modifier un projet. Dans ce cas, il doit être identifié obligatoirement par son code.
Sans planification progressive
Colonne | Description | Règle |
Code Projet* | Code d’identification du projet
Type de colonne texte | • Obligatoire
• Un code est unique.
• Il ne doit comporter que des chiffres des lettres ou des «- » « _ » « / » |
Libellé Projet* | Libellé du projet à l’affichage | • Obligatoire
• Un libellé est unique |
Chef de projet | Identification du chef de projet | • Facultatif
• Saisir le login de l’utilisateur
• Un chef de projet doit être nécessairement un compte utilisateur |
Statut | Statut du projet | • Facultatif
• Saisir la valeur exacte du statut (code ou libellé)
• La valeur doit exister dans Project Monitor au moment de l’import
• Si aucune valeur n’est précisée, c’est la valeur par défaut qui est prise
• Dans le cas d’un ré-import, si la valeur est vide, c’est la valeur saisie dans l’application qui s’applique. |
Date de début* | Date de début du projet | • Obligatoire
• Ne peut pas être postérieure à la date de fin
• Attention au format doit être de type jj/mm/aaaa |
Date de fin* | Date de fin du projet | • Obligatoire
• Ne peut pas être antérieure à la date de début
• Attention au format doit être de type jj/mm/aaaa |
Description | Description du projet | • Facultatif
• Champ de texte libre sans mise en forme |
Code Projet père | Code d’identification du projet père
Type de colonne texte | • Facultatif
• Code Projet correspondant à un projet déjà créé |
Avec planification progressive
Colonne | Description | Règle |
Code Projet* | Code d’identification du projet
Type de colonne texte | • Obligatoire
• Un code est unique.
• Il ne doit comporter que des chiffres des lettres ou des «- » « _ » « / » |
Libellé Projet* | Libellé du projet à l’affichage | • Obligatoire
• Un libellé est unique |
Chef de projet | Identification du chef de projet | • Facultatif
• Saisir le login de l’utilisateur
• Un chef de projet doit être nécessairement un compte utilisateur |
Statut | Statut du projet | • Facultatif
• Saisir la valeur exacte du statut (code ou libellé)
• La valeur doit exister dans Project Monitor au moment de l’import
• Si aucune valeur n’est précisée, c’est la valeur par défaut qui est prise
• Dans le cas d’un ré-import, si la valeur est vide, c’est la valeur saisie dans l’application qui s’applique. |
Date de début* | Date de début du projet | • Obligatoire
• Ne peut pas être postérieure à la date de fin
• Attention au format doit être de type jj/mm/aaaa |
Date de fin* | Date de fin du projet | • Obligatoire
• Ne peut pas être antérieure à la date de début
• Attention au format doit être de type jj/mm/aaaa |
Description | Description du projet | • Facultatif
• Champ de texte libre sans mise en forme |
Code Projet père | Code d’identification du projet père
Type de colonne texte | • Facultatif
• Code Projet correspondant à un projet déjà créé |
Date de début de lissage du reste à faire | Date de début de lissage du RAFG de chaque ressource pour chaque phase du projet | • Facultatif
• Attention le format doit être de type jj/mm/aaaa
• Si pas renseignée :
◦ Si le projet a déjà une date de début de lissage du raf + en cas de présence de RAFG dans l’onglet ressource, alors la date du jour est appliquée et tous les RAFG sont relissés à partir de la date du jour sur les durées des phases respectives.
◦ Si le projet a déjà une date de début de lissage du raf + pas de RAFG dans l’onglet ressource, alors la date de début de lissage du RAF est conservée.
◦ Si le projet n’a pas encore de date de début de lissage du raf + en cas de présence de RAFG dans l’onglet ressource.
◦ Si le projet n’a pas encore de date de début de lissage du raf + pas de RAFG dans l’onglet ressource, pas de date de début de lissage appliquée au projet et tous les RAFG sont relissés à partir de la date du jour sur les durées des phases respectives.
• Si renseignée :
◦ Si le projet a déjà une date de début de lissage du raf alors celle-ci est mise à jour avec la date importée (erreur si la date n’est pas comprise dans celles du projet).
◦ Si le projet n’a pas encore de date de début de lissage du raf, alors cette date devient la date projet de début du lissage du reste à faire. |
3.3.2 Détail de l’onglet RATTACHEMENT
Règles particulières :
- Une ligne par rattachement par projet. Il peut donc y avoir plusieurs lignes pour un même projet.
- Le rattachement des valeurs d’une ligne à un projet se fait soit par le code ou le libellé.
- En cas d’import d’un projet déjà existant en base, l’ensemble des rattachements est réinitialisé. Cela signifie que les valeurs qui auraient été modifiées dans l’application sont effacées au profit de celles mentionnées dans le fichier d’import.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Hiérarchie* | Permet d’indiquer que le projet est rattaché à une hiérarchie donnée. | • Obligatoire
• On saisit soit la valeur de la hiérarchie, soit le code de la hiérarchie |
Niveau* | Permet d’indiquer le niveau le plus bas de rattachement du projet sur une hiérarchie donnée.
Le niveau de rattachement n’est pas nécessairement le niveau le plus bas de hiérarchie. Ex : un projet A peut être rattaché au niveau Pays et un projet B au niveau Ville d’une hiérarchie de type géographique. | • Obligatoire
• On saisit soit la valeur soit le code
• Le niveau doit être déclaré comme niveau de rattachement dans l’application |
Valeur de niveau* | Permet d’indiquer la valeur auquel on rattache le projet. | • Obligatoire
• On saisit soit la valeur soit le code
• La valeur de niveau doit exister dans Project Monitor au moment de l’import |
CAS PARTICULIER DU MODE « DIFF »
Dans le cas où l’on souhaite utiliser le fichier pour réaliser de mise à jour, on peut appliquer des règles différentes en intégrant le suffixe « DIFF » à l’onglet « RAT » (ex de nommage onglet : RAT_import_DIFF).
En mode DIFF :
- L’ensemble des rattachements n’est pas réinitialisé par défaut. Il faut stipuler explicitement les rattachements à modifier lors de l’import.
- Si une ligne stipule uniquement le code hiérarchie alors tous les rattachements sont supprimés (utile pour faire une remise à zéro éventuelle pour des hiérarchies multirattachées)
- Si une ligne stipule uniquement le code hiérarchie et le code niveau alors tous les rattachements de ce niveau sont supprimés.
- Si une ligne stipule le code hiérarchie, le code niveau et la valeur de niveau
- Pour le cas des hiérarchies à rattachement simple : la valeur est remplacée par celle de l’import
- Pour le cas des hiérarchies à rattachement multiple : la valeur est ajoutée à celle déjà existante
3.3.3 Détail de l’onglet EQUIPE
Règles particulières :
- Une ligne par utilisateur et par projet. Il peut donc y avoir plusieurs lignes pour un même projet.
- Le rattachement des valeurs d’une ligne à un projet se fait soit par le code ou le libellé.
- En cas d’import d’un projet déjà existant en base, l’ensemble des affectations est réinitialisé. Cela signifie que les utilisateurs qui auraient été modifiés dans l’application sont effacés au profit de ceux mentionnés dans le fichier d’import.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Rôle | Indique le rôle que l’on souhaite attribuer à un utilisateur | • Obligatoire
• On saisit soit la valeur, soit le code du rôle |
Nom | Indique le compte utilisateur à associer au rôle. | • Obligatoire
• Reprise du login de l’utilisateur |
CAS PARTICULIER DU MODE « DIFF »
Dans le cas où l’on souhaite utiliser le fichier pour réaliser de mise à jour, on peut appliquer des règles différentes en intégrant le suffixe « DIFF » à l’onglet « EQU » (ex de nommage onglet : EQU_import_DIFF).
En mode DIFF :
- L’ensemble des utilisateurs n’est pas réinitialisé par défaut.
- Si une ligne stipule uniquement le code du rôle alors tous les rattachements utilisateurs sont supprimés (utile pour faire une remise à zéro éventuelle)
- Si une ligne stipule le code du rôle et le code de l’utilisateur, il est ajouté à ceux déjà existants.
3.3.4 Détail de l’onglet ATTRIBUT
Règles particulières :
- Une ligne par attribut et par projet. Il peut donc y avoir plusieurs lignes pour un même projet.
- Le rattachement des valeurs d’une ligne à un projet se fait soit par le code ou le libellé.
- Il n’est pas possible d’importer un attribut technique.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Attribut | Indique l’attribut | • Obligatoire
• On saisit soit la valeur, soit le code de l’attribut |
Valeur | Indique la valeur de l’attribut | • Obligatoire
• Reprise de la valeur saisie.
• ATTENTION au format notamment pour les formats date de respecter le formalisme jj/mm/aaaa
• ATTENTION au format booléen doit respecter Y (yes) ou N (no)
• La valeur peut aussi être une URL |
3.3.5 Détail de l’onglet PLANNING
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Type | Type de l’objet planning : JALON ou PHASE | • Obligatoire |
Code | Code de l’élément du planning | • Obligatoire
• Utilisé pour repérer l’objet planning pour création ou modification |
Libellé | • Obligatoire | |
Type | Code ou libellé du type de l’élément du planning | • Obligatoire |
Date début | • Facultatif
• S’il n’y a pas de date précisée et qu’il s’agit d’une modification, la date présente est effacée | |
Date début estimée | • Facultatif
• S’il n’y a pas de date précisée et qu’il s’agit d’une modification, la date présente est effacée
• Si non précisée, prends la date de début | |
Date fin | • Facultatif
• S’il n’y a pas de date précisée et qu’il s’agit d’une modification, la date présente est effacée
• Date cible pour un jalon | |
Date fin estimée | • Facultatif
• S’il n’y a pas de date précisée et qu’il s’agit d’une modification, la date présente est effacée
• Si non précisée, prends la date de fin
• Date estimée pour un jalon | |
Statut | Obligatoire
Saisir la valeur exacte du statut (code ou libellé)
La valeur doit exister dans Project Monitor au moment de l’import
Dans le cadre d’un jalon, valeur possible entre « FAIT » et « A FAIRE » | |
Parent | Facultatif
Code de la phase parente
Le parent de la phase doit être renseigné dans une ligne antérieure à la phase fille. | |
Synchronisation des dates | AUTO ou MANUEL | • Facultatif
• Par défaut : AUTO |
Assigne | Login de l’utilisateur | • Facultatif
• Ne change pas l’assigné si rien de précisé |
Dépendances | Liste des dépendances de l’objet planning séparées par des virgules. Chaque dépendance peut être composée de 4 chaînes de caractères décrivant la dépendance, séparées par des slashs.
CODE OBJET DEPENDANT / DELAI / CODE TYPE DEPENDANCE / CODE PROJET DEPENDANT
CODE OBJET DEPENDANT : code du jalon ou de la phase
DELAI : durée en jour. Délai entre le code du jalon/phase et le projet dépendant
CODE TYPE DEPENDANCE* : code de la liaison entre phase et jalon
CODE PROJET DEPENDANT : code du projet dépendant | • Facultatif
• Ne change pas les dépendances si rien de précisé
• Exemple « J1/0/DD/ADM2012 » désigne le jalon J1 du projet de code ADM2012 et de type DEBUT-DEBUT.
• Exemple « J1/1 » désigne le jalon J1 du même projet que l’objet planning. Délai de 1 jour et de type fin-début.
• Exemple « J1 » désigne le jalon J1 du même projet que l’objet planning. Délai de 0 jour de type FIN-DEBUT
• Exemple « J1/0/DF/ADM2012,J2 » désigne deux jalons J1 et J2.
• En modification, les dépendances qui ne sont pas précisées dans la liste sont supprimées (si celle-ci contient des dépendances)
• En cas de création, le projet désigné par la dépendance doit avoir été créé dans une ligne antérieure. |
Gabarit | Code du jalon ou de la phase gabarit | • En cas de création d’un élément du planning permet d’ajouter les attributs du gabarit.
• En cas de gabarit défini par défaut, l’élément du planning est créé depuis ce gabarit par défaut |
Règles particulières :
- Dans cet onglet, on indique l’ensemble des phases et des jalons du projet
- Une ligne par objet du planning et par projet. Il peut donc y avoir plusieurs lignes pour un même projet.
- Le rattachement des valeurs d’une ligne à un projet se fait soit par le code ou le libellé.
- La présence de l’onglet planning active le module planning sur le projet.
- Lors de la création d’une phase il faut sa durée soit obligatoirement supérieure ou égale à 1 jour.
*Les valeurs attendues pour le < code type dépendance > sont :
- « FD » correspondant au type « Fin-Début »
- « DD » correspondant au type « Début-Début »
- « FF » correspondant au type « Fin-Fin »
- « DF » correspondant au type « Début-Fin »
- La valeur de ce code est requise uniquement si un code projet est aussi renseigné.
- Si aucune valeur n’est renseignée alors la valeur par défaut est « FD ».
- Voici quelques exemples :
Syntaxes | Significations |
JALON_2/2/DD | Dépendance vers le jalon de code JALON_2 avec un délai de 2 jours et de type début-début. |
JALON_3/0 | Dépendance vers le jalon de code JALON_3 avec un délai de 0 jour et de type fin-début. |
JALON_4/1/DF | Dépendance vers le jalon de code JALON_4 avec un délai de 1 jour et de type début-fin. |
JALON_5/0/DF/PROJ10 | Dépendance vers le jalon de code JALON_5 du projet de code PROJ10 avec un délai de 0 jour et de type début-fin. |
JALON_6 | Dépendance vers le jalon de code JALON_6 avec un délai de 0 jour et de type fin-début. |
- Voici quelques exemples incorrects :
Syntaxes | Significations |
JALON_2/DD | Absence du délai |
JALON_3/0/PROJ11 | Absence du type |
JALON_3/PROJ11 | Absence du délai et du type |
JALON_2/2/DG | Type inconnu |
N.B. : Project Monitor ne contrôle pas lors de l’import le respect des liens de dépendances
3.3.6 Détail de l’onglet RESSOURCE
Règles particulières :
- Une ligne par ressource, par phase et par projet. Il peut donc y avoir plusieurs lignes pour un même projet.
- Si aucune phase n’est précisée, la ressource est affectée à la phase projet (cas notamment des ressources sans phase).
- La présence de l’onglet ressources active ce module sur le projet.
Sans Planification progressive
Depuis la version 6.5.4, ce type d’import n’est plus disponible
Avec planification progressive
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Code Phase | Code ou libellé de la phase du projet où affecter la ressource | • Si précisé, la ressource est affectée à cette phase
• Sinon, utilisation de la phase projet. |
Code ressource | Code de la ressource UP de la plateforme | • Obligatoire |
Cible | Valeur Cible | • Facultatif (Si non précisé : « - ») |
Reste à faire global | Valeur du reste à faire de la ressource pour la phase | • Facultatif (Si non précisé : « - ou cible » selon règle de recopie) |
3.3.7 Détail des onglets INDICATEURS (IND et IND-PLAN)
Il est possible d’importer des valeurs de réalisé et de planifié pour les indicateurs.
Import du réalisé des indicateurs
Règles particulières :
- N lignes par indicateur et par projet. Chaque ligne d’indicateur présente le réalisé pour une période donnée. Il peut y avoir plusieurs lignes pour un même projet.
- Si aucune phase n’est précisée, l’indicateur est affecté à la phase projet (cas notamment des indicateurs sans phase).
- La présence de l’onglet indicateur active ce module sur le projet.
- Si nous importons les onglets "ACT-" / "IND-" et "IND-PLAN" (dans cet ordre précis) alors les valeurs des colonnes "référence" et "cible finale" de "IND-" seront écrasées par les valeurs des colonnes "référence" et "cible finale" de "IND-PLAN". Donc dans le cadre de cet import les colonnes "référence" et "cible finale" de "IND-" n'ont pas besoin d'être renseignées.
- Si nous importons les onglets "ACT-" / "IND-PLAN" et "IND-" (dans cet ordre précis) alors les valeurs des colonnes "référence" et "cible finale" de "IND-PLAN" seront écrasées par les valeurs des colonnes "référence" et "cible finale" de "IND-". Donc dans le cadre de cet import les colonnes "référence" et "cible finale" de "IND-PLAN" n'ont pas besoin d'être renseignées.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Code Phase | Code ou libellé de la phase du projet où affecter l’indicateur | • Si précisé, l’indicateur est affecté à cette phase
• Sinon, utilisation de la phase projet |
Type UP/Local | « UP » s’il s’agit d’un indicateur UP. Sinon, c’est un indicateur local | • Obligatoire |
Code indicateur | Code de l’indicateur UP de la plateforme si type « UP » | • Obligatoire pour un indicateur UP (identifie l’indicateur) |
Libellé indicateur | Libellé de l’indicateur si type « Local » | • Obligatoire pour un indicateur local (identifie l’indicateur) |
Genre | Code d’identification du genre ou libellé du genre | • Obligatoire pour un indicateur local
• Il est préférable de travailler sur le code genre |
Catégorie | Code d’identification de la catégorie ou libellé de la catégorie | • Obligatoire pour un indicateur local
• Il est préférable de travailler sur le code catégorie |
Code Répartition | REPARTITION_LINEAIRE ou REPARTITION_MANUELLE | • Règle de répartition de l’évolution
• Si non précisé, utilise le code répartition de la catégorie |
Référence | Valeur Référence | • Facultatif (Si non précisé : « 0 ») |
Cible | Valeur Cible | • Facultatif (Si non précisé : « 0 ») |
Période | Date désignant une période pour la valeur Réalisé | • Facultatif
• Format JJ/MM/AAAA |
Réalisé | Pour les indicateurs qui ont une structure de mesure stock : Valeur de réalisé cumulé
Pour les indicateurs qui ont une structure de mesure flux :
Valeur de réalisé. | • Facultatif (Si non précisé : « 0 ») |
Import du planifié réparti des indicateurs
Règles particulières :
- N lignes par indicateur et par projet. Chaque ligne d’indicateur présente le réalisé pour une période donnée. Il peut y avoir plusieurs lignes pour un même projet.
- Si aucune phase n’est précisée, l’indicateur est affecté à la phase projet (cas notamment des indicateurs sans phase).
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Code Phase | Code ou libellé de la phase du projet où affecter l’indicateur | • Si précisé, l’indicateur est affecté à cette phase
• Sinon, utilisation de la phase projet |
Type UP/Local | « UP » s’il s’agit d’un indicateur UP. Sinon, c’est un indicateur local | • Obligatoire |
Code indicateur | Code de l’indicateur UP de la plateforme si type « UP » | • Obligatoire pour un indicateur UP (identifie l’indicateur) |
Libellé indicateur | Libellé de l’indicateur si type « Local » | • Obligatoire pour un indicateur local (identifie l’indicateur) |
Genre | Code d’identification du genre ou libellé du genre | • Obligatoire pour un indicateur local
• Il est préférable de travailler sur le code genre |
Catégorie | Code d’identification de la catégorie ou libellé de la catégorie | • Obligatoire pour un indicateur local
• Il est préférable de travailler sur le code catégorie |
Code Répartition | REPARTITION_LINEAIRE ou REPARTITION_MANUELLE | • Règle de répartition de l’évolution
• Si non précisé, utilise le code répartition de la catégorie |
Référence | Valeur Référence | • Facultatif (Si non précisé : « 0 ») |
Cible | Valeur Cible | • Facultatif (Si non précisé : « 0 ») |
Période | Date désignant une période pour la valeur Réalisé | • Facultatif
• Format JJ/MM/AAAA |
Planifié | Valeur Planifié réparti de la période indiquée en colonne K. | • Facultatif (Si non précisé : « 0 ») |
3.3.8 Détail de l’onglet BUDGET
Règles particulières :
- n lignes par budget et par projet. Chaque ligne de budget présente le réalisé pour une période donnée. Il peut y avoir plusieurs lignes pour un même projet.
- Si aucune phase n’est précisée, le budget est affecté à la phase projet (cas notamment des budgets sans phase).
- La présence de l’onglet budget active ce module sur le projet.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Code phase | Code ou libellé de la phase du projet où affecter le budget | • Si précisé, le budget est affecté à cette phase
• Sinon, utilisation de la phase projet |
Code budget | Code du libellé UP de la plateforme | • Obligatoire (identifie le budget) |
Code Répartition | REPARTITION_LINEAIRE_JOURS_CALENDAIRES
REPARTITION_LINEAIRE_JOURS_OUVRES
REPARTITION_MANUELLE
REPARTITION_A_LA_FIN
REPARTITION_LINEAIRE_PERIODES_ECHUES
REPARTITION_LINEAIRE_PERIODE_COURANTE | • Règle de répartition de la répartition
• Si non précisé, utilise le code répartition de la catégorie |
Cible | Valeur Cible | • Facultatif (Si non précisé : « 0 ») |
Planifié | Valeur planifié | • Facultatif (Si non précisé : « 0 ») |
Période | Date désignant une période pour la valeur Réalisé, Mandaté ou Engagé | • Facultatif
• Format JJ/MM/AAAA |
Réalisé | Valeur Réalisé | • Facultatif (Si non précisé : « 0 ») |
Mandaté | Valeur Mandatée si budget public | • Facultatif (Si non précisé : « 0 ») |
Engagé | Valeur Engagée si budget public | • Facultatif (Si non précisé : « 0 ») |
3.3.9 Détail de l’onglet TÂCHE
Règles particulières :
- Dans cet onglet, on indique l’ensemble des tâches du projet
- Une ligne par tâche et par projet. Il peut donc y avoir plusieurs lignes pour un même projet.
- Le rattachement des valeurs d’une ligne à un projet se fait soit par le code ou le libellé
- La présence de l’onglet tâche active le module planning sur le projet
Colonne | Description | Règle |
Code Projet* | Code du projet | • Obligatoire |
Libelle* | Libellé de la tâche (Sujet) | • Obligatoire |
Date de création | Date de création de la tâche | • Facultatif :
• Si vide = date de l'import
• Format jj/mm/aaaa |
Date d’échéance | Date d'échéance de la tâche | • Facultatif
• Format jj/mm/aaaa |
Date de début | Débutée le | • Facultatif
• Format jj/mm/aaaa
• Si vide = date de l'import |
Date début prévue | Début cible | • Facultatif
• Format jj/mm/aaaa |
Date de fin | Pour le | • Facultatif
• Format jj/mm/aaaa |
Émetteur | Émetteur de la tâche | • Obligatoire
• login de l'utilisateur
• |
Assigné | Assigné | • Facultatif
• login de l'utilisateur |
Charge | Charge (j/h)
| • Facultatif
• Valeur numérique |
Type de tâche | Type de tâche
Code de la valeur de liste Type de tâche | • Obligatoire
• |
Priorité | Priorité de la tâche
Code de la valeur de liste Priorité | • Obligatoire |
État | État de la tâche Code de la valeur de liste État | • Obligatoire |
Jalon | Jalon ou phase du projet
Code du jalon | • Facultatif.
• Doit exister dans Project Monitor |
Message | Message de la tâche | • Facultatif |
PJ | Lien URL en PJ | • Format |
Participant | login | • Facultatif
• Chaque utilisateur séparé par une virgule
• ex : NOM Prénom, Nom Prénom, Nom Prénom |
3.3.10 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 l’ensemble des hiérarchies
- Création dans Project Monitor de l’ensemble des attributs
- Création dans Project Monitor de l’ensemble des utilisateurs
- Création dans Project Monitor des types de phases importées
- Création dans Project Monitor des mesures UP budgets et ressources importées
- Constituer le fichier Excel® d’import
- Vérifier l’absence de projet ayant un code identique à l’un des projets qui sera réalisé
- Importer le fichier Excel®
- Si nécessaire mettre à jour le détail des projets (jalon, planning…)
4. Imports du thème Budget
4.1 Budget (mesure)
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier doit pas contenir de lignes d’entêtes :
- Code Budget
- Libellé Budget
- Libellé long Budget
- Description Budget
- Code genre
- Code catégorie
L’ensemble des champs doivent être au format texte.
L’import budget n’est disponible que pour de la création des mesures budget. 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 doit contenir une ligne d’entêtes.
Colonne | Description | Règle |
Code Budget | Code budget à créer | Obligatoire |
Libellé Budget | Libellé budget à créer | Obligatoire |
Libellé long budget | Libellé long | Facultatif |
Description Budget | Description | Facultatif |
Code Genre | Code d’identification du genre | Obligatoire |
Code Catégorie | Code d’identification de la catégorie | Obligatoire |
Budget générique | Booléen | Facultatif - si VRAI alors mesure budget générique |
Axe analytique | Code Axe analytique | Facultatif – Obligatoire si budget générique à « VRAI » |
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 le budget est rattaché.
4.2 Factures
Format de fichier accepté :
- .xls
Le fichier ne doit pas contenir de lignes d’entêtes.
L’import des factures fonctionne sur les projets dont le module revenu est activé. Si celui-ci n’est pas activé sur le projet en cours d’import, une erreur est remontée.
Création ou modification réalisée en fonction de l’existence de la facture suivant son code.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Code facture* | Code de la facture | • Obligatoire (identifie la facture) |
Libellé facture* | Libellé de la facture | • Obligatoire |
Code État | Code de la valeur de liste état facture | • Facultatif
• Si non spécifié, utilise l’état par défaut et retourne un warning |
Date période | Période de la facture | • Facultatif
• Permet de retrouver la période de Project Monitor
• Si non spécifié, utilise la période sélectionnée dans le contexte
• Format JJ/MM/AAAA |
Date émission | Date d’émission ou d’échéance de la facture (date déclarée) | • Facultatif
• Format date jj/mm/aaaa |
Message | Message ou remarque | • Facultatif |
Montant | Montant de la facture | • Facultatif |
Remise | Remise sur la facture | • Facultatif |
Liens devis | Liste de codes de devis séparés par le caractère « | » s’il s’agit d’un fichier CSV ou « , » s’il s’agit d’un fichier Excel® | • Facultatif
• Si précisé, associe l’ensemble des devis à la facture |
4.3 Devis
Format de fichier accepté :
- .xls
Le fichier ne doit pas contenir de lignes d’entêtes.
L’import des devis fonctionne sur les projets dont le module revenu est activé. Si celui-ci n’est pas activé sur le projet en cours d’import, une erreur est remontée.
Création ou modification réalisée en fonction de l’existence du devis suivant son code.
Colonne | Description | Règle |
Code ou Libellé Projet* | Code d’identification du projet ou libellé du projet | • Obligatoire
• Il est préférable de travailler sur le code projet |
Code devis* | Code du devis | • Obligatoire (identifie le devis) |
Libellé devis * | Libellé du devis | • Obligatoire |
Code État | Code de la valeur de liste état devis | • Facultatif
• Si non spécifié, utilise l’état par défaut et retourne un warning |
Code Nature | Code de la valeur de liste nature devis | • Facultatif
• Si non spécifié, utilise l’état par défaut et retourne un warning |
Date période | Période du devis | • Facultatif
• Permet de retrouver la période de Project Monitor
• Si non spécifié, utilise la période sélectionnée dans le contexte
• Format : jj/mm/aaaa |
Date émission | Date d’émission ou d’échéance du devis (date déclarée) | • Facultatif
• Format : jj/mm/aaaa |
Message | Message ou remarque | • Facultatif |
Montant | Montant du devis | • Facultatif |
Remise | Remise sur le devis | • Facultatif |
Liens factures | Liste de codes de factures séparés par le caractère « | » s’il s’agit d’un fichier CSV ou « , » s’il s’agit d’un fichier Excel® | • Facultatif
• Si précisé, associe l’ensemble des factures au devis |
4.4 Enveloppes Budgétaires
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier doit pas contenir de lignes d’entêtes :
- Code enveloppe
- Puis budget
L’ensemble des champs doivent être au format texte.
L’import ne fonctionne pas en annuleEtRemplace sur les enveloppes : Il faut donner l’ordre DELETE pour effectuer les suppressions d’enveloppes.
En ce qui concerne les budgets des enveloppes, si des budgets ne sont pas spécifiés dans l’import, ces budgets sont supprimés de l’enveloppe concernée après import : l’ordre de suppression concerne uniquement l’objet enveloppe.
L’ordre annuleEtRemplace concerne l’objet enveloppe : il n’y a aucune destruction d’enveloppe sans demande par import. Par contre, les données contenues dans l’enveloppe non spécifiées par l’import se font éjecter : l’annuleEtRemplace a donc lieu sur le contenu de l’enveloppe mais pas sur la liste des enveloppes.
Colonne | Description | Règle |
Code | Code de l’enveloppe | Obligatoire |
Libellé | Libellé de l’enveloppe | Obligatoire |
Libellé Long | Libellé long de l’enveloppe | Facultatif |
Description | Description de l’enveloppe | Facultatif |
Enveloppe Générale | Code de l’enveloppe générale | Obligatoire
L’enveloppe générale est mise à jour avec le budget s’il n’y était pas. |
Statut | Code du statut de l’enveloppe | Obligatoire |
Budget | Code du budget UP | Obligatoire
Ce budget doit appartenir à une SFRIM cochée « Géré par enveloppe » |
Cible | Cible enveloppe sur le budget | Obligatoire |
Exercice | Code de l’exercice | Facultatif |
Planifié | Valeur planifiée de l’exercice | Facultatif |
Hiérarchie | Code de la hiérarchie de rattachement | Facultatif |
Valeur de Niveau | Code de la valeur de niveau de rattachement sur la hiérarchie | Facultatif
La valeur de niveau doit être sur un niveau de rattachement |
Action / Mouvement | Code Action | CREATE, MODIFY, DELETE
Facultatif. Si non précisé, pas de DELETE et pas de Warning |
4.5 Pièces financières
Format de fichier accepté :
- .csv
Le fichier doit pas contenir de lignes d’entêtes.
Règles d’import
- Mode d’import manuel (par défaut : create)
Si la pièce financière n’existe pas,
- Elle est créée automatiquement
- L’affectation au projet ou à la phase se fait automatiquement à l’import
- Dans le cas de l’import d’une pièce financière répartie,
- La répartition affichée dans la pièce financière est toujours « manuelle » même si le mode de répartition est différent dans la catégorie budget.
Annule et remplace en mode manuel : il est possible de mettre en place un mode d’import spécifique pour les clients. Ce mode d’import est à préciser dans le fichier de configuration de la base de données. Ce mode d’import « Annule&Remplace » sera valable pour tous les imports de pièces financières (et prend le pas sur une commande CURL).
Dans ce cas, toutes les pièces financières de l'exercice courant et de l'exercice précédent sont supprimées, pour être remplacées par les pièces financières présentes dans le fichier d’import.
Création d’un script spécifique pour le client
- Mode d’import par CURL
Si la commande CURL ne précise rien ; alors le fonctionnement normal d'import s'applique :
- si une pièce financière n'existe pas, elle est créée et affectée à la phase ou au projet
- si une pièce financière existe et a le même code, alors les données sont mises à jour et remplace les données précédentes.
- si une pièce financière existe et a le même code, mais qu'aucune donnée est différente, alors rien ne change
La commande se fait par code de type de pièce financière (donc par représentation).
curl -silent -u pribet:pribet --form file=@RealiseComptaRemplace.csv "http://localhost/MonitorMakerWeb/import/SYNCHROFINANCIERE?type=COMPTA”
Si commande curl avec &remplace=true ; alors, on supprime toutes les pièces financières pour les remplacer par celles précisées dans le fichier à importer.
curl -silent -u pribet:pribet --form file=@RealiseComptaRemplace.csv "http://localhost/MonitorMakerWeb/import/SYNCHROFINANCIERE?type=COMPTA&remplace=true"
Déchiffrage de l’exemple suivant :
- u LOGIN_UTILISATEUR:MOT_DE_PASSE
- -form file=@LIBELLE_FICHIER_A_IMPORTER
http://URL/ACTION/TYPE_IMPRT?type=CODE_TYPE_PIECE_FINANCIERE&remplace=true"
Eléments à modifier :
LOGIN_UTILISATEUR:MOT_DE_PASSE
LIBELLE_FICHIER_A_IMPORTER
CODE_TYPE_PIECE_FINANCIERE
Ajouter ou non selon le besoin : &remplace=true
Gestion des dates :
La date de ligne s’affiche dans le suivi financier. Elle est obligatoire. Elle n’est prise en compte lors de l’import que si c’est la seule renseignée. C’est-à-dire que la date de ligne de pièce financière n’est pas renseignée.
En revanche, la date de ligne de pièce financière pilote la période d’imputation de la dépense. Elle sert également lors de la mise à jour. Mais elle n’apparait pas dans la liste des pièces financières (sous-onglet suivi financier).
Si le client souhaite faire apparaitre la date de la ligne de la pièce financière, il est nécessaire d’exploiter un autre champ facultatif et non exploité lors de l’import (ex : description) pour faire remonter la date de pièce financière au format texte
Règle d’import selon le statut des projets :
Les imports de pièces financières lorsque le statut du projet est clos sont impossibles. Une erreur fonctionnelle apparait, dans le rapport d'import (sauf en saisie rétroactive : pour une période antérieure à la période de clôture). Rappel : un projet est clos automatiquement s'il a un méta statut "Terminé" et si sa date de fin est dépassée.
Règle d’import des représentations prévisionnelles réparties :
Depuis la version v6.2.1.3, il est désormais possible de définir le montant « à répartir » d’une pièce financière de type « prévisionnel réparti 1/2/3 », il suffit d’indiquer le code de représentation prévisionnel non réparti « REP_PREVISIONNEL_1 », « REP_PREVISIONNEL_2 » ou « REP_PREVISIONNEL_3 ». La date de ligne est ignorée lorsque ce type de représentation est indiqué.
Règle d’import selon le statut
Les différentes valeurs de statut : PF_STATUT_OUVERT, PF_STATUT_VALIDE*
- Si modification : si PF validée, on ne la modifie pas
- Si annule et remplace : si PF a statut validé, alors on ne l'annule pas
La valeur PF_STATUT_VALIDE permet de « bloquer » la Pièce Financière, qui n’est alors plus modifiable.
* PF_STATUT_VALIDE correspond à une pièce financière dont le statut (la valeur de liste) a pour méta-statut "validé".
Colonne | Description | Règle |
Code | Code de la pièce financière | Obligatoire
Un code est unique. |
Libellé | Libellé de la pièce financière | Obligatoire si création
Si vide, pas de modification de la donnée |
Libellé Long | Libellé long de la pièce financière | Facultatif
Si vide, pas de modification de la donnée |
Description | Description de la pièce financière | Facultatif
Si vide, pas de modification de la donnée |
Date | Date de la pièce financière | Obligatoire si création
Format aaaammjj
Si vide, pas de modification de la donnée |
Pièce financière parente | Code de la pièce financière parente :
Par exemple, code de l’affectation financière pour un engagement | Facultatif
Si vide, pas de modification de la donnée |
Enveloppe | Code de l’enveloppe | Facultatif
Obligatoire si Project Monitor a été défini avec des codes enveloppes. |
Projet | Code du projet | Facultatif |
Phase | Code de la phase | Facultatif.
Si non précisé et Projet renseigné, utilisation de la phase projet.
Si précisé veuillez renseigner le code Projet. |
Budget | Code du budget UP | Facultatif
Budget de la ligne de pièce financière
Obligatoire si la pièce financière est en Action / Mouvement CREATE, MODIFY et DELETE |
Représentation | Code de la représentation | Facultatif
Représentation de la ligne de pièce financière. Si non précisé, en fonction du type d’import et de la pièce financière
REP_CIBLE, REP_MANDATE, REP_ENGAGE, REP_PLANIFIE_REPARTI,
REP_PREVISIONNEL_REPARTI_1,
REP_PREVISIONNEL_REPARTI_2,
REP_PREVISIONNEL_REPARTI_3,
REP_PREVISIONNEL_1,
REP_PREVISIONNEL_2,
REP_PREVISIONNEL_3 |
Valeur | Valeur de la pièce financière | Facultatif
Valeur de la ligne de pièce financière pour la représentation
Pour les représentations (REP_PREVISIONNEL_1,
REP_PREVISIONNEL_2,
REP_PREVISIONNEL_3) cela correspond à la valeur du montant à répartir |
Date ligne | Date de la ligne de la pièce financière
Pour la répartition planifiée repartie cette date précise la période de répartition | Facultatif (pour les représentations REP_CIBLE, REP_MANDATE, REP_ENGAGE, REP_PREVISIONNEL_1, REP_PREVISIONNEL_2 et REP_PREVISIONNEL_3)
Obligatoire (pour les représentations REP_PLANIFIE_REPARTI, REP_PREVISIONNEL_REPARTI_1,
REP_PREVISIONNEL_REPARTI_2,
REP_PREVISIONNEL_REPARTI_3)
Format aaaammjj
Si ce champ est renseigné, il est prioritaire sur la date de pièce financière, qui n’est pas lu par Project Monitor |
Action / Mouvement | Code Action | CREATE, MODIFY, DELETE
Facultatif. Si non précisé, pas de DELETE et pas de Warning |
Numéro de marché | Numéro de marché de la PF | Facultatif
Si vide, pas de modification de la donnée |
Identifiant tiers | Identifiant tiers de la PF | Facultatif
Si vide, pas de modification de la donnée |
Société bénéficiaire | Société bénéficiaire de la PF | Facultatif
Si vide, pas de modification de la donnée |
Pièce jointe | Pièce jointe associée à la PF | Facultatif
Si vide, pas de modification de la donnée |
Statut | Code du statut de la pièce financière | Facultatif
Si vide valorisation avec la valeur de liste définie par défaut (« Ouverte ») |
4.6 Synchronisation des budgets
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier doit contenir de lignes d’entêtes :
- Code Projet
- Puis Code phase
- Puis Code Enveloppe
- Puis Code budget
Si les lignes ne sont pas ordonnancées correctement ce message d’erreur apparaîtra (après import) :
- CODE_PROJET_PROJET_-CODE_ENVELOPPECODE_BUDGET - ERROR - Objet en double dans le fichier d'import :
- CODE_PROJET correspond à la colonne « Code Identifiant Projet »
- CODE_ENVELOPPE correspond à la colonne « Code Enveloppe »
- CODE_BUDGET correspond à la colonne « Code Budget »
Si une mesure n’a pas été affectée au sein du projet et qu’elle est présente dans le fichier d’import, l’affectation est réalisée automatiquement. Si des valeurs de représentation (ex : la cible) ne sont pas précisées dans le fichier d’import, la valeur est par défaut à « 0 » (zéro).
L’import ne fonctionne pas en annuleEtRemplace : Il faut donner l’ordre DELETE pour effectuer les suppressions d’affectations des budgets aux phases.
Le fichier en import possède au minimum les 18 colonnes détaillées sur la page suivante.
Colonne | Description | Règle |
Code Identifiant Projet | Code porté par l’attribut qui a été choisi dans l’administration de la plateforme
• Admin
• Config. Plateforme
• Dans la section « Ressource / budget », rechercher le champ « Identifiant projet pour la synchronisation des budgets »
• Choisir par exemple : « Code » | Obligatoire |
Code Phase | Code de la phase du projet | Facultatif
Si non précisé, c’est la phase projet qui est concerné. |
Code Enveloppe | Code de l’enveloppe correspondante | Facultatif |
Code budget | Code du budget | Obligatoire |
Code Répartition | Mode de répartition du planifié
REPARTITION_LINEAIRE_JOURS_CALENDAIRES
REPARTITION_LINEAIRE_JOURS_OUVRES
REPARTITION_MANUELLE
REPARTITION_A_LA_FIN
REPARTITION_LINEAIRE_PERIODES_ECHUES
REPARTITION_LINEAIRE_PERIODE_COURANTE | Facultatif
Si non précisé, utilisation de la répartition définie sur la catégorie pour l’affectation du budget à la phase |
Cible | Valeur cible | Facultatif
Si non précisé, valeur « 0 » en cas de création.
Si non précisé, pas de mise à jour en cas de modification |
Planifié | Planifié sur la période mensuelle | Facultatif
Si non précisé, pas de mise à jour |
Date Période | Date permettant d’identifier la période mensuelle des valeurs qui suivent | Facultatif pour les représentations apériodiques (cible, planifié)
Obligatoire pour les représentations périodiques (estimé, réalisé, engagé, mandaté)
Format aaaammjj.
Sous Excel, le format de la cellule doit être « texte » |
Estimé | Valeur estimée sur la période mensuelle | Facultatif
Si non précisé, pas de mise à jour |
Réalisé | Valeur réalisée sur la période mensuelle pour un budget non public | Facultatif
Si non précisé, pas de mise à jour |
Engagé | Engagé sur la période mensuelle pour un budget public | Facultatif
Si non précisé, pas de mise à jour |
Mandaté | Mandaté sur la période mensuelle pour un budget public | Facultatif
Si non précisé, pas de mise à jour |
Action / Mouvement | Code Action | CREATE, MODIFY, DELETE
Facultatif
Si non précisé, pas de DELETE et pas de Warning |
5 Colonnes réservées | RFU – Reserved For Future Use | |
Colonnes libres | Suite de colonnes libres et non lues par Project Monitor |
4.7 Planifié
Format de fichier accepté :
- .xls
- .xlsx
Le fichier ne doit pas contenir de lignes d’entêtes.
Colonne | Description | Règle |
Date | Date servant à retrouver la période | Obligatoire si le code répartition est égal à REPARTITION_MANUELLE
Facultatif sinon
Format de date jj/mm/aaaa |
Code budget | Code de la mesure budgétaire | Obligatoire |
Code ou libellé projet | Code ou libellé du projet de la plateforme | Obligatoire |
Code phase | Code du phase | Obligatoire
S’il n’y a pas de phase veuillez indiquer le paramètre suivant « _PROJET_ » |
Code Enveloppe | Code de l’enveloppe | Facultatif
Obligatoire si Project Monitor a été défini avec des codes enveloppes. |
Code Répartition | Mode de répartition du planifié
REPARTITION_LINEAIRE_JOURS_CALENDAIRES
REPARTITION_LINEAIRE_JOURS_OUVRES
REPARTITION_MANUELLE
REPARTITION_A_LA_FIN
REPARTITION_LINEAIRE_PERIODES_ECHUES
REPARTITION_LINEAIRE_PERIODE_COURANTE | |
Planifié total | Valeur du planifié total | Si cette valeur n’est pas précisée, la valeur vaut 0 |
Planifié réparti | Valeur du planifié réparti (sur la période désignée par la date | Si le code répartition est égal à REPARTITION_MANUELLE et que cette valeur n’est pas précisée, la valeur vaut 0
Non lu si le code répartition est différent de REPARTITION_MANUELLE |
4.8 Prévisionnel
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier ne doit pas contenir de lignes d’entêtes.
Si lors de l’import la ligne n’a pas la même répartition que celle précisée par l’import, une erreur est sortie et la ligne est ignorée par l’import.
Colonne | Description | Règle |
Date | Date servant à retrouver la période | Obligatoire si le code répartition est égal à REPARTITION_MANUELLE
Facultatif sinon
Format de date jj/mm/aaaa |
Code budget | Code de la mesure budgétaire | Obligatoire |
Code ou libellé projet | Code ou libellé du projet de la plateforme | Obligatoire |
Code phase | Code du phase | Obligatoire
S’il n’y a pas de phase veuillez indiquer le paramètre suivant « _PROJET_ » |
Code Enveloppe | Code de l’enveloppe | Facultatif
Obligatoire si Project Monitor a été défini avec des codes enveloppes. |
Code Répartition | Mode de répartition du prévisionnel
REPARTITION_LINEAIRE_JOURS_CALENDAIRES
REPARTITION_LINEAIRE_JOURS_OUVRES
REPARTITION_MANUELLE
REPARTITION_A_LA_FIN
REPARTITION_LINEAIRE_PERIODES_ECHUES
REPARTITION_LINEAIRE_PERIODE_COURANTE | |
Prévisionnel total | Valeur du prévisionnel total | Si cette valeur n’est pas précisée, la valeur vaut 0 |
Prévisionnel répartir | Valeur du prévisionnel réparti 1,2 ou 3 sur la période désignée par la date | Si le code répartition est égal à REPARTITION_MANUELLE et que cette valeur n’est pas précisée, la valeur vaut 0
Non lu si le code répartition est différent de REPARTITION_MANUELLE |
4.9 Demande
Format de fichier accepté :
- .xls
Le fichier ne doit pas contenir de lignes d’entêtes.
Cas d’erreurs :
- SI : le plan budgétaire n'a pas de mesure budgétaire affecté et nous renseignons le code budget A dans le fichier d'import
- ALORS le message d'erreur suivant est affiché :
Les montants sont intégrés au code budget A dans le demandé du projet
- SI : le plan budgétaire a une mesure budgétaire affecté A et nous renseignons le code budget B dans le fichier d'import
- ALORS le message d'erreur suivant est affiché :
Le plan budgétaire ne contient pas le budget de code : B – ERROR
- SI : le plan budgétaire a une mesure budgétaire affecté A et nous renseignons le code budget B dans le fichier d'import et que la mesure budgétaire B n'est pas affectée au projet
- ALORS le message d'erreur suivant est affiché :
Pas de budget affecté au projet. Code ressource lue : B, phase : _PROJET_ - ERROR
Colonne | Description | Règle |
Date Période | Date permettant d’identifier l’exercice de la VLM (fonctionnement retenu par cohérence avec les autres imports – une valeur d’exercice serait plus aisée) | Format aaaammjj |
Code budget | Code du budget | Obligatoire |
Code ou libellé projet | Code ou libellé du projet | Obligatoire |
Code Phase | Code de la phase du projet | Obligatoire
S’il n’y a pas de phase veuillez indiquer le paramètre suivant « _PROJET_ » |
Code Enveloppe | Code de l’enveloppe | Facultatif
Obligatoire si Project Monitor a été défini avec des codes enveloppes. |
Code Version | Code de la version du plan budgétaire | Obligatoire |
Hypothèse | Hypothèse de la version du plan
le code de valeur de liste des hypothèses budgétaires doit être obligatoirement "HYPOTHESE_BUDGET_LISTE" | Obligatoire
Valeurs possibles :
BASSE, MEDIUM ou HAUTE |
Demande de budget (montant) | Montant de la demande pour le budget / enveloppe / phase / exercice concerné | |
Code Statut | Statut de la demande .
Modification du statut de la demande si précisé | Facultatif.
Si tous les statuts ne sont pas identiques au titre d’une demande budgétaire, c’est le dernier qui prévaut. |
Commentaire | Commentaire du projet pour la version.
Préfixe « IMPORT » ajouté en début de commentaire servant à repérer le commentaire importer et à le modifier si besoin. | Si tous les commentaires ne sont pas identiques au titre d’une demande budgétaire, c’est le dernier qui prévaut. |
5. Imports du thème Ressources
5.1 Ressources (mesure)
L’import des ressources n’est disponible que pour de la création de ressource. 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.
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier doit contenir une ligne d’entêtes :
- Code Ressource
- Libellé Ressource
- Libellé long Ressource
- Description Ressource
- Code genre
- Code catégorie
Colonne | Description | Règle |
Code Ressource | Code ressource à créer | Obligatoire |
Libellé Ressource | Libellé ressource à créer | Obligatoire |
Libellé long Ressource | Libellé long de la ressource | Facultatif |
Description Ressource | Description de la ressource | Facultatif |
Code Genre | Code d’identification du genre | Obligatoire |
Code Catégorie | Code d’identification de la catégorie | Obligatoire |
Utilisateur associé | Booléen | Si VRAI, l’utilisateur de login « code ressource » doit exister en base. Cet utilisateur est associé à cette ressource. Echoue si l’utilisateur n’existe pas. |
Ressource générique | Booléen | |
Ressource de facturation | Booléen | |
Profil spécifique | Code du profil | Facultatif |
Pourcentage d’activité | Valeur de multiplication des capacités | SI rien, alors valeur égale à 0 |
Période Cout | Date à partir de laquelle il faut affecter le coût de la ressource jusqu’à la dernière période de la plateforme | Facultatif. Si non précisé, on prend la période active.
Attention au format doit être de type jj/mm/asa |
Cout de la ressource | Coût de la ressource | Facultatif (suggestion : intégrer cette information dès l’import des ressources car la modification est lourde) |
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 ressource est rattachée
5.2 Réalisé de la saisie d’activité
L’import de la saisie d’activité fonctionne sur les projets dont le module ressource est activé. Si celui-ci n’est pas activé sur le projet en cours d’import, une erreur est remontée. Il faut aussi que les ressources soient présentes dans le projet. Le projet doit aussi être commencé.
Enfin pour que l’import puisse fonctionner il faut :
- Aller dans la structure de mesure de la ressource Structures de mesure
- Vérifier que la valeur du champ est
Saisie d'activité à la journée
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Colonne | Description | Règle |
Date saisie | Date correspondante à la saisie d’activité | • Obligatoire
• Sert également à retrouver la période
• Format de date : jj/mm/aaaa |
Code ressource | Code de la ressource de la plateforme | • Obligatoire |
Code ou libellé projet | Code ou libellé du projet de la plateforme | • Obligatoire |
Code phase | Code de la phase | • Obligatoire si la ressource est ajoutée au niveau de la phase
• Facultatif si la ressource est ajoutée au niveau projet. Dans ce cas inscrire dans cette colonne « _PROJET_ ». La valeur est alors affectée sur la phase Projet de la ressource |
Valeur | Valeur à écrire dans la case correspondante à la date de saisie | • Valeur en jours, selon le nombre d’heures par jour de la ressource ou, à défaut, de la plateforme .
Exemples:
- 1 pour une journée
- 0.5 pour 1/2 journée
- 0.125 pour 1h, dans le cas d’une configuration de 8h/journée au niveau de la ressource ou de la plateforme |
5.3 RAFG de la ressource de la planification progressive
L’import de reste à faire fonctionne sur les projets dont le module ressource est activé. Si celui-ci n’est pas activé sur le projet en cours d’import, une erreur est remontée. Il faut aussi que les ressources soient présentes dans le projet. Le projet doit aussi être commencé.
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier ne doit pas contenir de lignes d’entêtes.
Colonne | Description | Obligatoire | Règle |
Code ressource | Code de la ressource de la plateforme | OUI | |
Code ou libellé projet | Code ou libellé du projet de la plateforme | OUI | |
Code phase | Code de la phase | OUI | Mettre la valeur « _PROJET_ » pour affecter la valeur sur la phase Projet de la ressource |
RAFG | Valeur du RAFG | OUI | La valeur est lissée automatiquement entre la date de début de lissage et la fin de la phase |
5.4 Reste à faire détaillé manuel des ressources avec planification progressive
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Le fichier ne doit pas contenir de lignes d’entêtes.
Colonne | Description | Obligatoire | Règle |
Code ressource | Code de la ressource de la plateforme | OUI | |
Code ou libellé projet | Code ou libellé du projet de la plateforme | OUI | |
Code phase | Code de la phase | OUI | Mettre la valeur « _PROJET_ » pour affecter la valeur sur la phase Projet de la ressource |
Date | Date où le RAFDM est appliqué pour la ressource | OUI | Mêmes règles que dans l'interface.
La date de RAFDM doit être supérieure ou égale à la date de début de lissage et inférieure ou égale à la date de fin de phase.
En l'absence de date de début de lissage sur le projet : En l'absence de date de début de lissage sur le projet : elle est initialisée à la date du jour
Format attendu : JJ/MM/AAAA |
RAFDM | Valeur du RAFDM | OUI | La valeur est positionnée tagguée manuelle jour à la date indiquée
S'il y a du RAFG : règles standards
S'il n'y a pas de RAFG : règles standards |
6. Import du thème Collaboratif
6.1 Import des tâches
Droit requis :
Format de fichier accepté :
- .csv
- .xls
- .xlsx
Colonne | Description | Règle |
CODE_PRJ | Code du projet | Obligatoire |
Libelle* | Libellé de la tâche (Sujet) | Obligatoire |
DATE_CREATION | Date de création de la tâche | Facultatif :
Si vide = date de l'import
Format jj/mm/aaaa |
DATE_ECHEANCE | Date d'échéance de la tâche | Facultatif
Format jj/mm/aaaa |
DATE_DEBUT | Débutée le | Facultatif
Format jj/mm/aaaa
Si vide = date de l'import |
DATE_DEBUT_CIBLE | Début cible | Facultatif
Format jj/mm/aaaa |
DATE_FIN | Pour le | Facultatif
Format jj/mm/aaaa |
EMETTEUR | Émetteur de la tâche | Obligatoire
login de l'utilisateur
|
ASSIGNE | Assigné | Facultatif
login de l'utilisateur |
CHARGE | Charge (j/h)
| Facultatif
Valeur numérique |
CODE_TYPE_TACHE | Type de tâche
Code de la valeur de liste Type de tâche | Obligatoire
|
PRIORITE | Priorité de la tâche
Code de la valeur de liste Priorité | Obligatoire |
ETAT | État de la tâche Code de la valeur de liste État | Obligatoire |
JALON | Jalon ou phase du projet
Code du jalon | Facultatif.
Doit exister dans Project Monitor |
MESSAGE | Message de la tâche | Facultatif |
PARTICIPANT | login | Facultatif
Chaque utilisateur séparé par une virgule
ex : NOM Prénom, Nom Prénom, Nom Prénom |