Resource type: calendar
With this API call an appointment can be edited. The ID of the appointment to be edited has to be specified as resourceid
. The default values for the appointment follow-up on the tab “Tools >> Settings >> Basic settings >> Automatization” for the appointment type are taken into account.
Parameters:
data
OBJECT. The following information can be set when editing an appointment:description:
Appointment descriptionstart_dt:
Start of the appointmentend_dt:
End of the appointmentart:
Type of appointmentganztags:
All-day appointment?allowTransitTime:
Enter transit time?transitTime:
Transit time. Time format: e.g. 00:30:00transitTimePre:
Transit time before the appointment. Time format: e.g. 00:30:00transitTimePost:
Transit time after the appointment. Time format: e.g. 00:30:00note:
Notes on the appointmentabgesagt:
true or false. Sets appointment status on active or cancelledprivate:
Private appointment?erinnerung:
Time of the appointment reminder before the appointment. Possible values are:0 minutes, 15 minutes, 30 minutes, 1 hours, 2 hours, 3 hours, 1 days, 2 days, 3 days, 1 weeks, 3 weeks
origin:
Appointment imported via ICS?ressources:
ARRAY. Ressources of the appointment. All existing ressources are replaced with the given array. The values can be read out under “Extras >> Settings >> Administration >> Singleselect >> Modul: Calendar management, Field: ressources”von:
STRING. The user to be entered as the appointment creator at field “von” (creator). The username can be queried via Get users.
relatedAddressIds
ARRAY. Address IDs to be linked with the appointment.relatedEstateId
INTEGER. Estate ID to be linked with the appointment.location
OBJECT. Place of appointment (see below)subscribers
OBJECT. Participants. Can be users (users
) oder groups (groups
).reminderTypes
ARRAY. Type of appointment reminder. Can accept the valuesemail
,popup
orsms
. For this purpose, the fielderinnerung
must also be set to a time with the parameterdata
.
Example:
{ "actionid": "urn:onoffice-de-ns:smart:2.5:smartml:action:modify", "resourceid": "383", "identifier": "", "resourcetype": "calendar", "parameters": { "data": {"description":"Besichtigung beim Kunden", "start_dt": "2016-12-11 17:00:00", "end_dt" : "2016-12-11 18:00:00", "art" : "Besichtigung", "ganztags" : 0, "note" : "das ist eine Notiz", "private" : 0, "ressources": ["Konferenzraum", "Firmenfahrzeug"]}, "relatedAddressIds" : [1935, 1931], "relatedEstateId" :608, "location" : {"estate" : 608}, "subscribers": {"users" : [14], "groups" : [172]} } }
and the options for the appointment location are
address
estate
user
group
mandant
(customer)sonstiges
(other)customVideoUrl
(video conference)userMeetingUrl
(video conference from user / meeting link from user basic data. Value: user id)keine Angaben
(not specified)
If you set the location of an user, group, address or estate that is not linked to the appointment, the location will be entered under sonstiges
(other).
{ "location" : { "address" : "5431"} } { "location" : { "estate" : "39"} } { "location" : { "user" : "21"} } { "location" : { "group" : "39"} } { "location" : { "mandant" : true} } { "location" : { "sonstiges" : "Testr.1, 52062 Aachen"} } { "location" : { "customVideoUrl" : "www.onoffice.de"} } { "location" : { "userMeetingUrl" : 17} } { "location" : {"keine Angaben": ""} }