Event commands

Events are appointments. An event repeat, eg. it may occur every friday in a month, or on the 1st of every month in a year. The instance of an event on a given date is simply called an instance.

GetEventTypes

Get a list of the event types.

Input

Output

types	collection[ eventtype ]	A collection of all event types
default	number	The MB ID of the default event type

CreateUpdateEvent

Creates or updates an event in Microbizz.

If an event with the given event id already exists, then the event will be overwritten.

If the event provided has an event id of 0, a new event will be created and a new event id will be provided.

Input

event

The event to create/update

Output

event

The event object as it is in Microbizz after the update

DeleteEventByID

Delete an event in Microbizz.

Input

eventid	number	The Microbiz ID of an event
allusers	boolean	If 0 then current user will be removed from the event. If 1 then all users will be removed from the event.

Output

-

An event can only be deleted if the current user is attached to the event.

DeleteEventInstanceByInstanceID

Delete an instance (i.e. date) of a repeated event.

Input

instanceid

string

The Microbizz instance ID of an event for a date

Output

-

GetEventsByUserAndDate

Get a list of events in Microbizz.

This can be quite slow if fromdate and enddate are not the same. May return same event more than once if fromdate and enddate are not the same.

Input

fromdate	date
todate	date
userid	number

Output

calendarentries

collection[ event ]

A collection of events

GetMyStodos

Read a list of relevant reminders (“stodos”).

Input

None

-

Output

stodos

collection [ stodo ]

List of reminders

StodoAccept

Accept or postpone a reminder (“stodo”).

Input

stodoid	number	The ID of a reminder
userid	number	Not used but required for historic reasons, just set to 0
postpone	number	Number of minutes to postpone the reminder; if not included, or if 0, then the reminder is accepted.