Resource type: accessControl
This API call can be used to apply preconfigured data record rights stamps to various modules. The data record authorisation stamps are created in enterprise under “Action bar of the supported modules: Further actions >> Data record authorisation >> Stamp”. You can save your configurations for data record rights as a stamp and then use them on selected data records.
As with enterprise, the rights stamp can only be applied if the API user has the rights to set the data record rights (‘Extras >> Settings >> User >> Rights >> Data record rights: Extend and limit rights”) and write access to the corresponding data record.
You can find more information on data record authorisation stamps in the online help.
Parameters:
acTemplate
STRING. MANDATORY. Name of the data record rights stamp template to be used.module
STRING. MANDATORY. Module to which the stamp is to be applied. Possible values:estate
,address
,agentsLog
,calendar
,task
.recordId
INTEGER. MANDATORY. ID of the data record to which the stamp is to be applied.templateOwner
INTEGER. MANDATORY. User ID of the user who created the stamp. The rights are applied by the API user (e.g. important for log entries), thetemplateOwner
parameter only specifies the user from which the template is loaded.
Example
{ "actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do", "resourceid": "", "identifier": "", "resourcetype": "accessControl", "parameters": { "acTemplate":"Test1", "module": "estate", "recordId": 83, "templateOwner": 19 } }
Response
{ "status": { "code": 200, "errorcode": 0, "message": "OK" }, "response": { "results": [ { "actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:do", "resourceid": "", "resourcetype": "accessControl", "cacheable": false, "identifier": "", "data": { "meta": { "cntabsolute": null }, "records": [ { "id": 0, "type": "", "elements": { "success": "success" } } ] }, "status": { "errorcode": 0, "message": "OK" } } ] } }