#################################################################################################################################################################################### # 2022-02.23: ChangeLog on API {timeactivity} # --------------------------------------------------------------- # Hub API documentation updated to v3.915 ## # API /timeactivity/index - add column parentkeyevent that match replacement orginal planning (the one in absence before replacement, if any) #################################################################################################################################################################################### # 2022-02.14: ChangeLog on API {employees} # --------------------------------------------------------------- # Hub API documentation updated to v3.914 ## # API /employees/* related to groups of employees (view/list/add/delete) - add method creategroup/ that let you create a group of employees (GET or POST depending on the quantity of employees to create) - add method viewgroup/ to view group of employees or groups for a single employee - add method listAllGroups/ - add method deletesinglegroup/ to delete a single group of employees - add method deleteallgroupsforsingleemployee/ to delete all groups for a single employee - add method deletesingleemployeefromgroup to delete a single row employee/group #################################################################################################################################################################################### # 2021-10.13: ChangeLog on API {activitylocations} # --------------------------------------------------------------- # Hub API documentation updated to v3.913 ## # API /activitylocations/viewGroup updated - add column creationDatetime and lastUpdateDatetime for each group # API /activitylocations/listAllGroups created - list all existing group definition #################################################################################################################################################################################### # 2021-08.26: ChangeLog on API {scenario} and {activitylocations} # --------------------------------------------------------------- # Hub API documentation updated to v3.912 ## # API /scenario was updated - when using a keycodesite linked to a workspace and a child account (not the main account of the hub connector key_project), the site is allowed # API /activitylocations was updated - new parameter for /view and /index : show_workspacesLocations (by default 0). If 1, will retrieve data from child account linked to an allowed workspace (attached to the main account of the hub connector key_project) #################################################################################################################################################################################### # 2021-04.28: ChangeLog on API {oauth} # ---------------------------------------- ## #################################################################################################################################################################################### # Hub API documentation updated to v3.909 # API /scenarios was updated : - /scenarios/attachments/list added. Let you list all attachments for a given scenario instance - /scenarios/attachments/add added. Let you add a single attachment - /scenarios/attachments/remove added. Let you remove a single attachment - /index : add optional parameter showStepFormAsRawPdf. By default 0. Can be set to 1. - /gethistoricaldata : add optional parameter showStepFormAsRawPdf. By default 0. Can be set to 1. #################################################################################################################################################################################### # 2021-01.27: ChangeLog on API {oauth} # ---------------------------------------- ## #################################################################################################################################################################################### # Hub API documentation updated to v3.908 # API info was updated for Hub 2.3 and 3.0 - add oAuthActivated parameter 1/0. - add oAuthActioAuth_access_token if oAuth mode is activated - add oAuth_expires_in parameter if oAuth mode is activated # API oAuth was created for Hub 2.3 and 3.0 - oauth/token let you add an additional layer of security by using access_token as request header authorization Bearer token. # Global change for Hub 2.3 and 3.0 - if oAuthActivated=1 (from info/), using access_token (from oAuth) is mandatory on ALL calls (using http header authorization bearer token) - if oAuthActivated=1, HTTPS is mandatory ! #################################################################################################################################################################################### # 2020-10.12: ChangeLog on API {scenarios} # ---------------------------------------- ## #################################################################################################################################################################################### # API scenario for Hub 3.0 only - add method scenarios/updatestepadditionalfields to allow update on additional fields only for a given scenario step instance #################################################################################################################################################################################### # 2020-08.27: ChangeLog on API {scenarios} # ---------------------------------------- ## #################################################################################################################################################################################### # API scenario for Hub 3.0 only - add method scenarios/index to list all existing scenarios instances - add method scenarios/getdefinitions to list all existing scenarios definitions for given Hub account - add method scenarios/getdefinitionsteps to list all existing steps definition for a given scenario definition - add method scenarios/gethistoricaldata to list all historical changes for a given scenario instance, date range, or based on other filters - add method scenarios/create to create a new intance of scenario - add method scenarios/changestep to change step of a given "opened" scenario instance - add method scenarios/addcomment to add a single comment to a given scenario instance #################################################################################################################################################################################### # 2020-04-24: ChangeLog on API events/absence/deleteall and /deletebykeyevent # --------------------------------------------------------------------------- ## #################################################################################################################################################################################### # API events/absences for Hub 3.0 only - add method absences/deletebykeyevent that allow deletion of one to many absences from keyevent parameter (matricule and keyemployee are optional) - add option parameter keyevent to method /absences/deleteall - in short both methods could do the same. Only mandatory parameter differ. #################################################################################################################################################################################### # 2019-01-21: ChangeLog on API activitylocations and employees # ---------------------------------------------------------- ## #################################################################################################################################################################################### # API employees/ for Hub 3.0 only - Allow to show employee pin code using optional query parameter showPwd=1. Could be used on index/, view/, update/ # API activitylocations/ for Hub 3.0 only - add method creategroup/ that let you create a group of sites (GET or POST depending on the quantity of sites to create) - add method viewgroup/ to view group of sites or groups for a single site - add method deletesinglegroup/ to delete a single group of sites - add method deleteallgroupsforsinglesite/ to delete all groups for a single site - add method deletesinglesitefromgroup to delete a single row site/group -method activitylocations/addphonenumber is now public -method activitylocations/updatephonenumber is now public -method activitylocations/deleteallphonenumber is now public -method activitylocations/deletephonenumber is now public -method activitylocations/listphonenumbers is now public # API info/ changed for Hub 3.0 only - display info regarding access rights READ/WRITE depending on APIs #################################################################################################################################################################################### # 2018-11-28: ChangeLog on API timeactivity # ----------------------------------------- ## #################################################################################################################################################################################### # API timeactivity/ for Hub 3.0 - Add 1 new column : certified to results #################################################################################################################################################################################### # 2018-10-26: ChangeLog on API timeactivity # ----------------------------------------- ## #################################################################################################################################################################################### # API timeactivity/ for Hub 3.0 - Add 2 new columns : fromPlanned and toPlanned to results #################################################################################################################################################################################### # 2018-09-17: ChangeLog on format # ------------------------------- ## #################################################################################################################################################################################### # new format allowed - Add format CSV allowed for exporting resuts. Columns plitted by ; and line by \r\n # changes on API {surveys/answers} Hub 3.0 - add optional parameter hidejsoncolumns to be used for example for csv format or simply to reduce http response size #################################################################################################################################################################################### # 2018-08-08: ChangeLog on employees and activitylocations # -------------------------------------------------------- ## #################################################################################################################################################################################### # changes on API {employees/} Hub 2.3 and 3.0 - if keyEmployee/keyMatricule is matching an existing protected employee, this record will be returned without failure neither column real values. Instead ***RGPD PROTECTION*** will be displayed for each column. This "protected" record will be controlled/owned movework-connect side by the end user and not by the Hub editor/developer. # changes on API {activitylocations/} Hub 2.3 and 3.0 - if keyCodeSite is matching an existing protected employee, this record will be returned without failure neither column real values. Instead ***RGPD PROTECTION*** will be displayed for each column. This "protected" record will be controlled/owned movework-connect side by the end user and not by the Hub editor/developer. #################################################################################################################################################################################### # 2017-12-06: ChangeLog on employees # ---------------------------------- ## #################################################################################################################################################################################### # changes on API {employees/} Hub 2.3 and 3.0 - modify call to create/ method and update/method adding 3 optional fields : address zipcode city - update /view call adding address,zipcode,city values #################################################################################################################################################################################### # 2017-06-20: ChangeLog on activitylocations # ------------------------------------------ ## #################################################################################################################################################################################### # changes on API {activitylocations/} Hub 3.0 only - Hub 30 : add call to grab all group of sites /getallactivitylocationsgroups #################################################################################################################################################################################### # 2016-02-23: ChangeLog on activitylocations and timeactivity # ----------------------------------------------------------- ## #################################################################################################################################################################################### # changes on API {activitylocations/} - add optional parameter ismobilelocation. if 1, zipcode is no more required. By default, ismobilelocation=0 # changes on API {timeactivity/} - Hub 2.3 : display only validated activities. - Hub 3.0 : by default display only validated activities. But you can display all activities with new parameter showOnlyValidatedActivities=1 #################################################################################################################################################################################### # 2014-11-20: ChangeLog The Hub 3.0 release. ## # ------------------------------------------ ## #################################################################################################################################################################################### # changes on API {activitylocations/} - add new parameter "phonenumber" that is the main phone number for the site (update/create) #################################################################################################################################################################################### # 2014-05-06: ChangeLog The Hub from v2.1.3RC to 2.3 : This is the first stable public and complete release. ## # ---------------------------------------------------------------------------------------------------------- ## #################################################################################################################################################################################### # changes on API {info/} - add parameter hubversion indicating the version of Hub API related to the key_dev/key_proj couple. Usefull to avoid existing integration to be broken by improvement of Hub API server side. While your hubversion is not updated manually, Hub API server side won't change (and you won't have access to new features too). - add parameter mailnotification indicating the email that could be used for notifications (managed internally Movework side) # changes on API {employees} - firstname is no longer mandatory # changes on API {activitylocations} - keycodeclient is no longer mandatory. If filled it still has to match an existing customers ! #################################################################################################################################################################################### # 2013-03-18: ChangeLog The Hub from v2.1.2RC to 2.1.3RC : ## # -------------------------------------------------------- ## #################################################################################################################################################################################### # changes on API {events/interventions} : - Add new optional field "name" to methods [events/intervention/create] [events/intervention/update] [events/intervention/index]. # changes on API {customers/} - field "zipcode" is no longer required. Could be empty #################################################################################################################################################################################### # 2013-03-12: ChangeLog The Hub from v2.1RC to 2.1.2RC : ## # ------------------------------------------------------ ## #################################################################################################################################################################################### # changes on API {events/interventions} : - Add new method events/interventions/index. Check documentation for more informations. #################################################################################################################################################################################### # 2013-03-08: ChangeLog The Hub from v1.0 to 2.1RC : ## # -------------------------------------------------- ## #################################################################################################################################################################################### ######################################### # [TAKE CARE OF REGRESSIONS YOUR SIDE] ## ######################################### # Tests to proceed (at least) to check Hub integration compliance editor side (from v1.0 to v2.1) : - Check that your wrapper for API {info} manage correctly new fields - Check that your wrapper for API {customer} doesn't break because of new field "siret" returned on customer/view. - Check that your wrapper for APIs events/* doesn't break because of the modification of type for returned field "duration" (from integer to float) - Check that your wrapper for API events/interventions doesn't break because of the new field "keyhub1" returned on events/interventions/view. - Check that your wrapper for API employees doesn't break because of the new field "keyunification" returned one employees/*. # updates documentations & tools - Update technical documentation - Update hub-lib PHP - Update code sample query-builder # changes on API {info} API. - Add 2 new fields in {info} API : [projectname] : name of the project related to given key_project [editorname] : name of the project related to given key_developper # changes on API {customers} - Add new optional field "siret" (varchar[15]) for both method [customers/index] [customers/create] [customers/update] [customers/view] # changes on API {events/*} : - Type of field "duration" is modified from int to float. It let you manage more precise interventions. No limitation on decimal counts. Methods affected by this modification: [events/intervention/create] [events/intervention/update] [events/intervention/index] [events/absence/create] [events/closure/create] # changes on API {events/interventions} : - Add a new field called "keyHub1" (varchar[45]) that could be used when creating a new intervention. Could be usefull for particular use cases when hub editor want to add external business logic on event interventions (such as types, explanation, tags...). It's an optional field. Methods affected by this modification: [events/intervention/create] [events/intervention/update] [events/intervention/view] - Add 2 new optional parameters for [events/interventions/view] to filter on "keymatricule" and/or "keycodesite" # changes on API {employees} : - New field "keyunification" is added to the definition of an employee. We strongly recommand to not use it as it is only used for particular (weird) use cases when employees have several keymatricule. Methods affected by this modification : [employees/index] [employees/create] [employees/update] [employees/delete]