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. IDs that are already linked before and are not in the array remain linked. To remove the old address links, set parameterreplaceAddressIds
totrue
.replaceAddressIds
BOOLEAN. This parameter specifies whether the transferred IDs should replace the existing ones. There are two cases: 1. add: The transferred address IDs in parameterrelatedAddressIds
are not yet linked, then the transferred address ID will be linked to the appointment. 2. remove: If the ID already linked to the appointment is not present in the passed address IDs in parameterrelatedAddressIds
, then the linked address ID will be removed from the appointment. That is, if no address IDs are passed at all, then all address IDs will be removed from 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": ""} }