‣

Table of contents

1. Preamble

Ce document présente l’ensemble des APIs (Application Programming Interface) mises à disposition par Project Monitor.

Editorial agreement / Glossary

Term	Description
PM	Project Monitor
API	Application Programming Interface
REST	Representation State Transfer
HTTP	HyperText Transfer Protocol

Architecture principle

These APIs are based on :

• the principle of REST (Representational State Transfer) architecture,
• HTTP (hyper text transfer protocol),
• JSON (JavaScript Object Notation) data format.

Test tools

To test APIs interactively, we recommend using one of the following plug-ins:

• Postman recommandé par Virage Group: https://www.postman.com/downloads/
• Firefox REST Client: https: //addons.mozilla.org/fr/firefox/addon/restclient/
• Chrome Advanced REST Client: https: //chrome.google.com/webstore/detail/advanced-rest-client/
🚨
Please note that when xls files are returned, the "restclient" plug-in tries to display the downloaded files directly, rather than offering to open them with the dedicated application.

To obtain the correct date format, you can use one of the following converters:

• http://www.ruddwire.com/handy-code/date-to-millisecond-calculators/
• www.timestamp.fr translates dates into seconds and vice versa

2. General information

Syntax

Principle

In accordance with the HTTP protocol, each API is an HTTP request composed of the following elements:

• a URL, e.g. https://monprojectmonitor/MonitorMakerWeb/api/projects
• un verbe HTTP, ex : POST
• des informations dans le header HTTP, ex : X-PM-LOGIN : monLogin

The request can be completed with elements in JSON (JavaScript Object Notation) format, http://www.json.org/ex : {"libelle":"monProjet","code":"mon_projet"...} By default, the API returns data in JSON format.

Some calls may return ms-excel or csv files.

Legible date format

Dates can be supplied in a readable format: YYYY-MM-DDT00:00:00 (RFC-1123, ISO-8601 : http://wiki.fasterxml.com/JacksonFAQDateHandling)

Example: "dateDebut": "2016-12-31T00:00:00" is accepted but "attributs": { "ATT_IMPLEMENTATION_END_DATE": "2018-12-31T00:00:00"} is not.

Query parameters

Query parameters can be passed using a variety of syntaxes.

The first two syntaxes are based on the URL standard: http: //fr.wikipedia.org/wiki/Uniform_Resource_Locator#URL_absolue

1. Parameter integrated into the "path". Example: /projects/2012/germany The order is important, since the API implicitly expects this parameter in this place. Parameters are not named.
2. HTTP parameters. Example: /projects?country=Germany&year=2012 Parameters are named (key = value). They are separated from the "path" by ? and separated by &. The order of the parameters is not important.
3. "Matrix parameter Example: /projects/;year=2012;country=germany Parameters are named (key = value). They are not separated from the "path" and are prefixed by ;. The order of the parameters is not important. This notation is not linked to the URL standard.

Finally, these different syntaxes are not incompatible within the same query. It is possible to have parameters in one syntax and others in another. On the other hand, a parameter is expected by the API in a particular syntax.

If the following query is possible : /projects/closed;year=2012?country=Germany&login=mdupont

The following query is not its equivalent: /projects/2012;country=Germany?status=closed&login=mdupont

URLS root

All Webservices are available from the following URL: https://{UrlProjectMonitor}/MonitorMakerWeb/api where UrlProjectMonitor est le nom DNS de l’installation de Project Monitor Example: https://projectmonitor/MonitorMakerWeb/api

Authentication

JWT token

• Acquisition

Unlike the api key, the JWT token is generated directly by an acquisition web service (api/auth/jwt/token). This web service takes as parameters the login and password with which you wish to authenticate.

• Example with cURL
Copy

curl --location '' --header 'X-PM-LOGIN: monlogin' --header 'X-PM-PASSWORD: monmotdepasse'

• API Key deactivation

Properties can be used to disable api key operation, so token mode is the only authorized mode. If the property is not defined, then either api key or token will be used, and the 2 modes can coexist. Unlike the api key, the token has an expiry date, so it's possible to change the token's default lifetime (24h).

API Key (Depreciated)

Each call to a webservice must be accompanied by an apikey. An apikey is a large string of meaningless characters that authenticates the calling service. The apikey can be generated in the platform's administration screen or specified in the parameters file. <XXX>.monitormaker.properties via the com.vc.mm.webservice.apikey

#/ com.vc.mm.webservice.apikey (replaces com.vc.mm.commande.exec.auth)
#/ authentication string (api key) for executing web services
# since 5.4.1
#/ required: no
#/ default: nothing (execution impossible)
com.vc.mm.webservice.apikey= BkBUlBLMl4y66kW10M1aRdrGiGn1yO3S

Or via the administration screen :

The administration screen lets you define several apikey, name them and, above all, restrict their use to a given IP address. In the example above, the apikey can only be used for requests originating from the IP address 192.168.0.80. The apikey must then be sent for each web service call by one of the following means, in order of verification:

1. In the specific HTTP header via the key : X-PM-API-KEY
2. In the 'BASIC' HTTP Authorization header: the apikey replaces the login and the password field can be filled with any value.
3. In the query parameters with the parameter: apikey

Example: https: //projectmonitor/MonitorMakerWeb/api/templates?apikey=BkBUlBLMl4y66kW10M1aRdrGiGn1yO3S

The latter method is insecure (the apikey appears in the URL in clear text, and can therefore typically appear in log files that are themselves insecure).

It should only be used in an internal context (behind a DMZ, for example).

Headers

HTTP request header

In addition to the authentication elements described above, we need to add the following header:

Accept: application/json

HTTP header for responses

Web services systematically return json encoded in UTF-8 :

Content-Type: application/json;charset=UTF-8

Cross domain access

Il est possible d’accéder aux webservices de Project Monitor à partir de page HTML + javascript d’un autre domaine que celui de Project Monitor. Pour cela, il existe deux techniques.

JSON-P

Project Monitor implémente la technique json-p (http://en.wikipedia.org/wiki/JSONP) et propose un paramètre global pour chaque webservice : jsoncallback.

This parameter must be supplied as a query parameter. Example:

<!—requête envoyée par une balise ‘script’ -->
<script src="<http://projectmonitor/MonitorMakerWeb/api/templates?login=jdupont&jsoncallback=myCallBack>"></script>
<!— résultat du web service reçues en paramètre de la fonction callback. -->
<script>function myCallBack(data) {console.log(data.value);}</script>

Cross-Origin Resource Sharing

Cross-Origin Resource Sharing (ou CORS, http://en.wikipedia.org/wiki/Cross-origin_resource_sharing) est un mécanisme standard permettant le partage d’information entre sites web. Project Monitor prend en charge ce mécanisme côté serveur. Ce mécanisme dépend du navigateur exécutant la page html appelante : http://en.wikipedia.org/wiki/Cross-origin_resource_sharing#Browser_support

Errors

Errors are reported via status HTTP

Code	Description
400	Wrong request. The parameters supplied are not correct. In this case, the body of the response contains functional code as well as message in plain text, all sent in JSON format. Warning: there may be 400 errors without message functionality. The most common example is a call without passing the expected parameters. Ces messages ne sont pas générés directement par Project Monitor mais par le serveur Wildfly. Le contenu est en général du Content-Type: text/html. Example: Request to create a project without passing the json parameter as input
401	Current user identification problem
403	Forbidden - The current user does not have the right to use this API. Example: "Project creation" rights are required to POST the URL https://projectmonitor/MonitorMakerWeb/api/projects/
415	It is certainly missing Content-Type: application/json in the header.
500	Internal server error

3. API (HTTP verb: GET)

/templates: project templates

Description	List of project templates
Webservice code	/templates
Management rules	Right ACT_UTILISER_GABARIT Using templates in projects
Example	https://projectmonitor/MonitorMakerWeb/api/templates
Bean Sortie	Bean IdLibelle
Body Sortie	{ "id": 255527, "libelle": "le libellé de mon objet", "description": "une description plus longue souvent facultative", "designation": "éventuellement un libellé alternatif" }
Results	JSON

/currentuser : project filters

Description	List of project filters accessible to the current user
Webservice code	/currentuser/filters
Management rules	Right ACT_UTILISER_FILTRES_PUB_PROJET Using public project filters in the filter selector
Example	https://projectmonitor/MonitorMakerWeb/api/currentuser/filters
Bean Sortie	Bean IdLibelle
Body Sortie	{ "id": 255527, "libelle": "le libellé de mon objet", "description": "une description plus longue souvent facultative", "designation": "éventuellement un libellé alternatif" }
Results	JSON

/currentuser : authorization rights

/roles

Description	List project roles
Webservice code	/roles
Management rules	Right ACT_CONSULTER_ROLE Consult platform administration roles
Example	https://projectmonitor/MonitorMakerWeb/api/roles
Bean Sortie	Bean RoleValue
Body Sortie	[{ "id": 123, "libelle": "Chef de projet", "description": "Responsable de projet", "key": "246703” }, ...]
Results	JSON

/roles/hierarchical: user roles on all projects

/users

/users: user details

/lists

/projects

/projects attributes : value of a project attribute

/projects forms: attribute values for a project form

/projects: list of projects

Description	Returns a list of projects filtered by the supplied filter "filterId" corresponds to a persistent project filter.
Webservice code	/projects;filterId={filterId}
Management rules	Right ACT_CONSULTER_PROJECT_AFFECTE Consultation of a project to which the user is assigned
Example	https://projectmonitor/MonitorMakerWeb/api/projects;filterId=426 https://projectmonitor/MonitorMakerWeb/api/projects
Bean Sortie	Bean IDLibelle
Body Sortie	[{ "id": 255527, "libelle": "le libellé de mon objet", "description": "une description plus longue souvent facultative", "designation": "éventuellement un libellé alternatif" }, { "id": 255523, "libelle": "le libellé de mon objet 3", "description": "une description plus longue souvent facultative", "designation": "éventuellement un libellé alternatif" }]
Results	JSON

/projects: identification of the "model" project

/projects: retrieve the value of attachments to hierarchies

/projects: retrieve the value of attachments to a structure

/hierarchies: project links

/hierarchies values: retrieve the levels and level values of a structure

/team

Description	Lists the people making up a project team
Webservice code	/projects/{projectId}/team
Management rules	Right ACT_CONSULTER_PROJECT_AFFECTE Consultation of a project to which the user is assigned
Example	https://projectmonitor/MonitorMakerWeb/api/projects/3025/team
Bean Sortie	Bean WSProjet
Body Sortie	{ "id": "12345", "libelle":"test web service 1", "description":"", "code":"test-ws1", "libelleLong":"test web service", "statut": { "id": 246721, "libelle": "En cours", "description": "", "code": "CODE_STATUT", "equipe": {"CODE_ROLE1": ["login1", " login2"] } }
Results	JSON

/reports

/phases

Description	Returns the list of phases associated with the project.
Webservice code	/phases?projectId={projectId}
Management rules	Right ACT_CONSULTER_OBJET_PLANNING Consultation of a schedule object
Example	https://projectmonitor/MonitorMakerWeb/api/phases?projectId=426
Bean Sortie	Bean WSPhase
Body Sortie	{ "id": 520454, "libelle": "Expression des Besoins","description": "", "code": "", "type": {beanValeurListe},"etat": {beanValeurListe}, "message": "","parent": { "id": 520455, "libelle": "Lot 1", "description": "","key": "520455" }, "loginResponsable": "jdupont", "debutEstime": 1521216000000,"finEstime": 1530975600000,"debutCible": 1521216000000,"finCible": 1530975600000,"projet":{"id": 520451} }
Results	JSON

/phases: data recovery

Description	Returns the properties of a phase without dependencies.
Webservice code	/phases/{phaseID}
Management rules	Right ACT_CONSULTER_OBJET_PLANNING Consultation of a schedule object
Example	https://projectmonitor/MonitorMakerWeb/api/phases/331359
Bean Sortie	Bean WSPhase
Body Sortie	{ "id": 520454, "libelle": "Expression des Besoins","description": "", "code": "", "type": {beanIdOuCode},"etat": {beanIdLibelle}, "dateDebut": null,"message": "", "parent": { "id": 520455, "libelle": "Lot 1","description": "", "key": "520455" },"loginResponsable": "jdupont", "codeStatut": "A_VALIDER","debutEstime": 1521216000000, "finEstime": 1530975600000,"debutCible": 1521216000000, "finCible": 1530975600000 }
Results	JSON

/phases: dependency recovery

Description	Returns properties on the dependencies of a phase
Webservice code	/phases/{phaseID}/dependencies
Management rules	Right ACT_CONSULTER_OBJET_PLANNING Consultation of a schedule object
Example	https://projectmonitor/MonitorMakerWeb/api/phases/331359/dependencies
Bean Sortie	Bean WS Dependency
Body Sortie	[{ "predecesseur":{ "id": 520453, "libelle": "Conduite du projet","description": null, "key": "520453" },"projetPredecesseur": { "id": 520452,"libelle": "DP - AREA PRE SORT", "description": "","key": "520452" },"type": "REL_TYPE_FINISH_TO_START", "valeur": 0 }, ...]
Results	JSON

/phases attributes : value of a attribute type phase

/admin

Description	Renvoie des informations sur la version de Project Monitor et des scripts exécutés sur la base de données.
Webservice code	Right ACT_AFFICHER_ETAT_ADMIN Display administration reports
Management rules	https://projectmonitor/MonitorMakerWeb/api/admin/about
Example	/admin/about
Bean Sortie	Channel
Body Sortie	{ "version": "v5.4.0.3", "database": { "productName": "SQL server", "base": "projmon", "userName": "projmon"}, "scripts":[ { "datePassage":1317765600000, "RCSfile" : "G_libelles_v_5_4_0_1.sql" "revision" : " 1.1" "commentaire" : ""} ... ] }
Results	JSON

Description	Synchronous execution of the batch command supplied as a parameter
Webservice code	/admin/exec/{commandName}
Management rules	Law ACT_CONFIG_TECHNIQUE Configure the application's technical parameters
Example	https://projectmonitor/MonitorMakerWeb/api/admin/admin/exec/IndexerProjetCommand
Bean Entrée
Body Input
Bean Sortie	Channel
Body Sortie	200 OK
Results	JSON

4. API (HTTP verbs: POST/DELETE)

/projects: creation or modification

Description	Creating or modifying one or more projects To modify a project, pass its id to the input BeanWsProject. The web service accepts as input a simple BeanWsProjet or an array of BeanWsProjets (creation/modification). Notes : - The "id" field only needs to be filled in when updating a project. When a project is created, an id is automatically generated. - For attributes of the "List value" type, it is the code of the list value that must be sent, not its label. - The "idStatus" and "idGabarit" properties have priority over "codeStatus" and "codeGabarit". You can set either one or the other, but if both are present, only the id will be taken into account. - MOD_INDICATOR" is a fixed value that does not apply to modules other than indicator. Multiple categories can be entered by separating blocks with commas. - Accepted representation codes are : REP_REALISE and REP_PLANIFIE_REPARTI
Webservice code	/projects
Management rules	Droits ACT_CONSULTER_PROJET_AFFECTE Consultation of a project to which the user is assigned ACT_CREER_PROJET Project creation ACT_MODIFY_PROJECT Project modification
Example	https://projectmonitor/MonitorMakerWeb/api/projects
Bean Entrée	WsProjet bean or array of WsProjet beans
Body Input	{ "id": "12345", "libelle":"test web service 1", "description":"", "code":"test-ws1", "libelleLong":"test web service", "statut": { "id": 246721, "libelle": "En cours", "description": "", "code": "CODE_STATUT" } "idGabarit": -1, "codeGabarit": "CODE_GABARIT" "dateDebut":1072911600000, "dateFin":1167519600000, "loginChefDeProjet": "ngavard", "rattachements": {"CODE_HIERARCHIE1": ["CODE_VN1"], "CODE_HIERARCHIE2": ["CODE_VN2", CODE_VN3]}, "equipe": {"CODE_ROLE1": ["login1", " login2"], "CODE_ROLE2": ["login3"]}, "attributs": {"CODE_ATTRIBUT1_CHAINE": "ma valeur" , " CODE_ATTRIBUT2_VALEUR_NUM": 55.5, " CODE_ATTRIBUT3_VALEUR_LISTE":"CODE_VALEUR_LISTE"} }
Bean Sortie	Bean WSRetour
Body Sortie	{ "beanWsErreur" : { "code" : "LBL_RATTACHEMENTS_PROJET_HIERARCHIES_INCOMPLETE", "message" : "Toutes les hiérarchies ne sont pas affectées" }, "beanWsItem" : { "id" : 12345, "code" : "test-ws1", "libelle" : "test web service 1" } }
Results	JSON

/projects: list of projects

Description	Advanced project search based on filter and json parameter criteria. "filterId" corresponds to a persistent project filter. NB: For the "codeVue" field, only " dashboard (piloting)" views will work.
Webservice code	/projects/query
Management rules	Right ACT_CONSULTER_PROJECT_AFFECTE Consultation of a project to which the user is assigned
Example	https://projectmonitor/MonitorMakerWeb/api/projects;filterId=426/query https://projectmonitor/MonitorMakerWeb/api/projects/query
Bean Entrée	BeanFilterProjectParam
Body Input	{ "loginUser":"loginUser", "codeRoles":["CODE_ROLE1", "CODE_ROLE2",...], "codeAttributListe":"CODE_ATTRIBUT_LISTE", "idValeurAttributListe":128824, "jalonEnRetard": "false", "idProjets": [244071, 290590, ...], "codeVue": "CODE_VUE", "idProjetPere" : 200115 }
Bean Sortie	BeanWSCockpit
Body Sortie	{ "projet": {}, "valeurCockpits": { "CODE_COCKPIT1": {"feux": {"code": "VERT"}, "iconeName": "BallGreen.png"}, "CODE_COCKPIT2": {"feux": {"code": "GRIS"}, "iconeName": "BallGrey.png"}, ... } }
Results	JSON

/phases: creation or modification

/tasks

Description	Advanced search of task based on json parameter criteria. "filterId" corresponds to a persistent project filter.
Webservice code	/tasks;filterId={filterId}/query
Management rules
Example	https://projectmonitor/MonitorMakerWeb/api/tasks/query https://projectmonitor/MonitorMakerWeb/api/tasks;filterId=426/query
Bean Entrée	BeanWsFiltreTacheParam
Body Input	{ "loginEmetteur": "loginUser1", "loginAssigne": "loginUser2", "dateFinSuperieureA":1072911600000, "dateFinInferieureA":1072911600000, "dateEcheanceSuperieureA":1072911600000, "dateEcheanceInferieureA":1072911600000, "listeIdsStatut": [123, 466], "listeIdsCategorie": [987, ...] "beanFiltreProjetParam": { "idProjets": [244071, 290590, ...] "loginUser":"loginUser", "codeRoles":["CODE_ROLE1", "CODE_ROLE2"] } }
Bean Sortie	BeanWsTacheOut
Body Sortie	{ "id": 22709, "libelle": "libellé de la tâche", "code": "22709", "dateModification": 1338274295973, "projet": {beanObjet}, "message": "Contenu HTML <b> de la tâche</b>", "saisissable": true, "loginEmetteur": "loginUser1", "loginAssigne": " loginUser2", "dateDebut": null, "dateDebutPrevue": null, "dateFin": null, "dateEcheance": null, "etat": {beanIdLibelle}, "type": {beanIdLibelle}, "urlTache": "http://projectmonitor/MonitorMakerWeb/connexion.jsf?NumEcran=351&IdSMM=12 25&IdUP=2204&IdObjet=22709", "urlProjet": "http:// projectmonitor/MonitorMakerWeb/connexion.jsf?NumEcran=351&IdSMM=1225&IdUP= 2204&IdObjet=290354" }
Results	JSON

Description	Creating or modifying a task or a set of tasks If the task sent contains an id or code that already exists: the existing task is modified. Otherwise, a new task is created using the information received. Mandatory fields for creation are : - label: subject of the task - project: identified by its id or code The mandatory fields for modification are: - id or code (of the task)
Webservice code	/tasks;
Verb	POST
Management rules
Example	https://projectmonitor/MonitorMakerWeb/api/tasks
Bean Entrée	Bean WsTacheEntréeOu array[BeanWsTacheEntrée1, BeanWsTacheEntrée2,BeanWsTacheEntrée3
Body Entrée (si création)	{ "libelle": "Mettre à jour l’univers BO pour CASSIOPEE", "projet": { "id": 573456 }, "message": "Demande du service BCU. Merci de mettre à jour l’univers BO pour <b>cassiopée</b>. <br/> Avertir le service Facturation quand la demande sera realisée.", "loginEmetteur": "blopez", "etat": { "code": "ETAT_A_DEBUTER" }, "categorie": { "code": "CAT_BI" }, "gabarit": { "code": "GAB_TACHE_DSI" }, "priorite": { beanIdOuCode }, "phase": { "code": "CODE_PHASE"}, "loginAssigne": "Severin.prin", "loginsParticipants": ["pierre.visualiseur","julie.cheffep"], "roleAssigne": "ROL_CP_MOE”, "roleParticipants" : "ROL_MEMBRE_EQUIPE”, "envoyerMail" : true, (mail à tous assigné, chef de projet et participants), "envoyerMailChefDeProjet" : true (mail au chef de projet), "envoyerMailAssigne" : true, (mail à assigné) "envoyerMailParticipants" : true (mail à participants) }
Body Entrée (si modification)	{ "id": 12345, "loginAssigne": "jmchevillot", "statut": { "code": "ETAT_A_FACTURER" }, "attributs": { "NUM_BON_FACTU": "2017_BCU_12345", "NB_HEURES_PASSEES": 10.5 }, "phase": { "code": "CODE_PHASE"}, "loginsParticipants": ["pierre.visualiseur","julie.cheffep"], "roleParticipants" : "ROL_MEMBRE_EQUIPE” }
Bean Sortie	BeanWSBack
Body Sortie	Renvoyé par Project Monitor : tableau de BeanWsRetour. Un BeanWsRetour est composé d’un BeanWsErreur portant le code et le message de l’erreur (champs vides si pas d’erreur), et un BeanWsItem portant les informations du projet concerné. { "beanWsErreur" : { "code" : "LBL_RATTACHEMENTS_PROJET_HIERARCHIES_INCOMPLETE", "message" : "Toutes les hiérarchies ne sont pas affectées" }, "beanWsItem" : { "id" : 12345, "code" : "test-ws1", "libelle" : "test web service 1" } }
Results	JSON

/documents

• A document can be associated with an object or a attribute object (in the case of creation AND deletion). If the call concerns a attribute, theattribute code must be supplied.
• If a document is attached to an object, a default structure link type is used. The default type is "Attachment" in most cases, and "Deliverable" for phases and milestones.
• On ne peut ajouter/supprimer un document sur un objet que si celui-ci est rattaché à un projet ou est lui-même un projet. Par conséquent, ces webservices ne fonctionnent pas avec des gabarits.

/echange : creation or modification

5. cURL import method

Presentation

These Webservices can be used to send import or synchronization files. Their syntax is specific and not based on what has been seen previously. The cURL tool is supplied in p-monitor's "install" directory. It calls p-monitor via HTTP and transmits a CSV file to be imported. If the platform is to import data via its HTTP interface, a platform-specific user must exist and have the right rights to execute the import.

Import identifier

Identifier	PM rights	Note
TEST	#NA	This special import is used to test the technical chain. It simply mails the file sent by cURL back to the authenticated user.
IMPORT_PROJET	#NA	Import via Excel import files (see Import memo for expected file syntax).
IMPORT_INVOICE	ACT_EXECUTE_SYNCHROFACTURE Synchronize invoices
IMPORT_DEVIS	ACT_EXECUTE_SYNCHRODEVIS Synchronize quotes
IMPORT_TACHE	ACT_CREER_TACHE Add a task	Import via Excel import files (see Import memo for expected file syntax).
ACTIVITY_ENTRY	ACT_EXECUTE_SYNCHROACTIVITY Synchronize timesheet
ENTRY_ACTIVITY_RAF	ACT_EXECUTE_SYNCHROACTIVITY Synchronize timesheet
ACTIVITY_ENTRY_RAF_DETAIL	ACT_EXECUTE_SYNCHROACTIVITY Synchronize timesheet
MEASURES_UP	#NA
SYNCHROPROJET	ACT_EXECUTE_SYNCHROPROJECT Synchronize projects
SYNCHROENVELOPPE	#NA
SYNCHROFINANCIERE (2)	#NA	This import represents the generic import of financial documents: you must specify the financial document type code as a query parameter.
SYNCHROAFFECTATION	#NA
SYNCHROENGAGEMENT	#NA
SYNCHROMANDATTING	#NA
SYNCHROBUDGET	#NA
ENTRY_PROVISIONAL_REPARTITIONED_BUDGET_1	#NA	Import of forecast total distributed 1
ENTRY_PROVISIONAL_REPARTIED_BUDGET_2	#NA	Import of forecast total distributed 2
ENTRY_PROVISIONAL_REPARED_BUDGET_3	#NA	Import of forecast total distributed 3

New cURL launch method

To launch a cURL import, use the following syntax in a batch : curl -H "Accept:application/json" -H "Authorization: montoken" -silent -F

Accept :application/json	header d’entête pour se connecter à Project Monitor
LOGINUSERPM	Login de l’utilisateur spécifique de Project Monitor
APIKEYSERVEUR	(si authentification par apikey uniquement)  : api key du serveur ou de l’up, configurée dans l’administration Project Monitor ou dans le FICHIER de configuration (*.properties)
fileSend.txt	name of the file to be sent to p-monitor. This must be in the current directory
url.de.projectmonitor	L’URL de l’instance de Project Monitor qui doit recevoir le fichier.
IMPORT_ID	import type identifier. See list above.

To wait for the end of the command to continue processing in your batch file once the import is complete, use the wait option:

curl -H "Accept:application/json" -H "Authorization: montoken" -silent -F wait=true -F attachment=@fichierAEnvoyer.txt
"http://url.de.projectmonitor/MonitorMakerWeb/api/import/IDENTIFIANT_IMPORT?login=LOGINUSERPM"

To find out whether a cURL import is in progress, use the isrunning option:

curl -H "Accept:application/json" -H "Authorization: montoken" -silent -F isrunning=true -F attachment=@fichierAEnvoyer.txt
"http://url.de.projectmonitor/MonitorMakerWeb/api/import/IDENTIFIANT_IMPORT?login=LOGINUSERPM"

To specify the type of financial document when importing SYNCHROFINANCIERE, use the mandatory importType option:

curl -H "Accept:application/json" -H "Authorization: montoken" -silent -F attachment=@fichierAEnvoyer.txt
"http://url.de.projectmonitor/MonitorMakerWeb/api/import/SYNCHROFINANCIERE/importType/TYPE_PIECE_FINANC_REALISE?login=LOGINUSERPM"

$headersToken = New- Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headersToken.Add('X-PM-LOGIN',$login)
$headersToken.Add('X-PM-PASSWORD',$password)
echo "Tentative d'authentification pour l'utilisateur $login et son mot de passe est $password"
try{$response = Invoke-WebRequest -Headers $headersToken - URI "" | ConvertFrom-Json} 
catch [System.Net.WebException] {echo "Impossible d'obtenir le token (verifiez votre login/mot de passe)"
return} echo "Appel du web service d'export projet"
$token = $response.token
curl.exe -X POST -k -H Authorization:$token -H Accept:application/json -F attachment=@ImportPF.csv 
"https://pmdemo.p-monitor.com/MonitorMakerWeb/api/import/SYNCHROFINANCIERE/importType/TYPE_PIECE_FINANC_REALISE/"

The user specified by the login parameter receives an e-mail summarizing the import process.

The http return codes visible to curl are :