Click or drag to resize

SOAppointment Interface

Appointment object - represents to-do's, follow-ups, phone-calls.

Namespace:  SuperOffice.COM.SuperOfficeDB
Assembly:  SuperOfficeDB.Interop (in SuperOfficeDB.Interop.dll) Version: 8.0.0.0
Syntax
public interface SOAppointment : IAppointment

The SOAppointment type exposes the following members.

Properties
  NameDescription
Public propertyCode exampleActiveDate
ActiveDate is DoBy until the appointment is completed, then ActiveDate = Done date Activedate is the same as the DoBy date until the appointment is completed, then the ActiveDate is changed to Done date.
(Inherited from IAppointment.)
Public propertyCode exampleActiveLinks
ActiveLinks - Number of active links to documents, projects, Urls, appointments, sales, contacts, persons, selections
(Inherited from IAppointment.)
Public propertyCode exampleActivityLinks
The ActivityLinks attached to this appointment. Add or remove links on this object.
(Inherited from IAppointment.)
Public propertyCode exampleAlarm
Has Alarm? Alarm gives you a notification before the start time of the appointment
(Inherited from IAppointment.)
Public propertyCode exampleAlarmOffset
Alarm - minutes before Alarm gives you a notification before the start time of the appointment AlarmOffset is the number of minutes before the appointments alarm is supposed to "fire"
(Inherited from IAppointment.)
Public propertyCode exampleAllDayEvent
AllDayEvent - Is this an all day event: FALSE = No, TRUE = Yes.
(Inherited from IAppointment.)
Public propertyCode exampleAssignedBy
AssignedBy - Who (last) assigned this appointment to associate_id?
(Inherited from IAppointment.)
Public propertyCode exampleAssociate
The owner of this appointment. The associate whose diary/checklist the appointment is in
(Inherited from IAppointment.)
Public propertyCode exampleAutoSaveOnChangeIdentity
Should the model save on IdentityChanged?
(Inherited from IAppointment.)
Public propertyCode exampleAutoSaveOnFlush
Should the model save on flush cache?
(Inherited from IAppointment.)
Public propertyCautionWarning
Get caution warning number
(Inherited from IAppointment.)
Public propertyCode exampleChanged
has record been changed since read? If the appointment has been modified since it was loaded, this will return false
(Inherited from IAppointment.)
Public propertyCode exampleColorIndex
ColorIndex - used in Japan From CRM 5 Release 5.5 you may set different colour schema on the different types of appointments.
(Inherited from IAppointment.)
Public propertyCode exampleCompleted
Completed checkbox An appointment that has not been completed yet will always be shown in the owning associates diary. If the do by date has passed, it will be in the checklist even if it had a time stamp. See the database manual for more information regarding appointments shown in checklist or diary.
(Inherited from IAppointment.)
Public propertyCode exampleContact
The Contact for this appointment It may also be 0 if no contact is associated with the appointment
(Inherited from IAppointment.)
Public propertyCode exampleCreatedAssociate
The user that created the object The associate that first created the appointment
(Inherited from IAppointment.)
Public propertyCode exampleCreatedDate
The date the object was saved to the database. The date and time the appointment was first created.
(Inherited from IAppointment.)
Public propertyCode exampleDescription
Appointment text holds a descriptive text about the appointment. Filled out by the user.
(Inherited from IAppointment.)
Public propertyCode exampleDoBy
deadline for todo, starttime for appointment The date and time that the appointment is supposed to be completed.
(Inherited from IAppointment.)
Public propertyDocument (Inherited from IAppointment.)
Public propertyCode exampleDocumentLink
OBSOLETE - use ActivityLinks instead. Obsolete Obsolete
(Inherited from IAppointment.)
Public propertyCode exampleDone
date+time when task was completed. The date and time that the appointment was actually completed.
(Inherited from IAppointment.)
Public propertyCode exampleDuration
duration of appointment - in minutes Duration (in minutes) of the appointment.
(Inherited from IAppointment.)
Public propertyCode exampleEmailId
EmailId - If invitation and status changes should be mailed, this is the ID of the email address used.
(Inherited from IAppointment.)
Public propertyCode exampleEndDate
EndDate = DoBy + duration EndDate is the same as DoBy + duration.
(Inherited from IAppointment.)
Public propertyExternalFieldChanged
have external fields been changed?
(Inherited from IAppointment.)
Public propertyCode exampleForeignKey
ForeignKey Get the foreign key values for this appointment
(Inherited from IAppointment.)
Public propertyCode exampleFreeBusy
FreeBusy - What kind of time is this: 0 = Busy, 1 = Free.
(Inherited from IAppointment.)
Public propertyCode exampleGroup
Primary User Group of owning associate. Set implicitly by AssociateId.
(Inherited from IAppointment.)
Public propertyCode exampleGroupID
The owner's primary user group id The usergroup_id the owner of the appointment object belongs to.
(Inherited from IAppointment.)
Public propertyCode exampleIdentity
The primary key on the primary table. Is zero for new objects. Is set when an object is saved. The appointments database unique internal identity.
(Inherited from IAppointment.)
Public propertyCode exampleInvitedPerson
The person who is invited by the appointment If the appointment is a booking, the invited persons may be your associates, but you are also able to invite contact persons from other companies to join your meeting. They do not receive an invitation, unless you send them one by email, but you can see in the appointment that persons other than your associates have been invited to a meeting. Each invited person will have an appointment slave record.
(Inherited from IAppointment.)
Public propertyCode exampleIsAvailable
is record available in db? It's useful to check if an appointment actually exists before adding new properties to it.
(Inherited from IAppointment.)
Public propertyIsFavourite
Add/Remove this appointment from my favourites
(Inherited from IAppointment.)
Public propertyCode exampleIsRecurring
Is this a recurring appointment.
(Inherited from IAppointment.)
Public propertyCode exampleIsRequiredFilled
Are all the required fields filled out? Can we save the record? Checks if all properties that are required in this model is filled
(Inherited from IAppointment.)
Public propertyCode exampleIsValid
does the record exist? To save time, we dont load a record into buffer before one of its properties is asked for. This checks if the requested record is available in buffer
(Inherited from IAppointment.)
Public propertyCode exampleLeadTime
LeadTime
(Inherited from IAppointment.)
Public propertyLocalizedCautionWarning
Localized caution warning text
(Inherited from IAppointment.)
Public propertyCode exampleLocation
Location - Location for appointment, defaulted from invited resource of type place and other rules, but you can write anything you want.
(Inherited from IAppointment.)
Public propertyCode exampleMother
Mother appointment. Used for linking invitations to the main appointment.

The mother property is used if the appointment is a booking.

If this is a normal appointment, the mother will be 0.

If this appointment was the original appointment, made by the associate that wants to invite others to a meeting, the id in mother will be the same as the appointments identity.

If this appointment is a daughter appointment, generated from someone inviting you to a meeting, the id here will be the same as the mother appointments identity

(Inherited from IAppointment.)
Public propertyCode examplePerson
The Person for this appointment Must be a contact person registered on the current company. This does not mean however that a person is required
(Inherited from IAppointment.)
Public propertyCode examplePriority
Priority - list item - table enTablePriority=79 Its possible to give appointments different priorities. All the different priority types are saved in the priority table, and edited from the Admin. Client. An appointment does not require a priority
(Inherited from IAppointment.)
Public propertyCode examplePrivate
Visible for who? Public/Private 0=public,1=private,2=group The confidentiality of appointments is shown as different types of private on the appointment
(Inherited from IAppointment.)
Public propertyCode examplePrivateToGroup
The group this appointment is visible for when Private = group. The confidentiality of appointments is shown as different types of private on the appointment
(Inherited from IAppointment.)
Public propertyCode exampleProject
Project for this appointment An appointment may also be connected to a project, so you see the appointment both on the company card, and on the project card. This does not mean however that a project is required.
(Inherited from IAppointment.)
Public propertyCode examplePublishType
Publish type for this appointment: 0 = enPublishTypeUndefined, 1 = enPublishTypeExternal.
(Inherited from IAppointment.)
Public propertyCode exampleRecurrence
Get the recurrence object for this appointment. If this is not a recurring event the object gets default zero values.
(Inherited from IAppointment.)
Public propertyCode exampleRecurrenceRuleId
RecurrenceRuleId - Id for the recurrence rule for recurring appointments, otherwise 0.
(Inherited from IAppointment.)
Public propertyCode exampleRejectCounter
RejectCounter - How many invitees have rejected this appointment.
(Inherited from IAppointment.)
Public propertyCode exampleRejectReason
RejectReason - Why was this booking or assignment rejected, the RejectReason list is a source of suggestions but you can write anything here.
(Inherited from IAppointment.)
Public propertySale
Sale for this appointment
(Inherited from IAppointment.)
Public propertyCode exampleSentry
Sentry settings for this object. Lets you find out your read/write access to the object.
(Inherited from IAppointment.)
Public propertyCode exampleStatus
Status for the appointment, for example: 1 = not started/accepted, 3 = completed, 5 = booking, 9 = declined. The different statuses an appointment may have, from a fixed predefined list. See the database manual for an updated list of status types
(Inherited from IAppointment.)
Public propertySuggestedAppointmentId
Gets the suggested appointment id
(Inherited from IAppointment.)
Public propertyCode exampleTask
Appointment task type - list item - table enTableTask=67 Task comprises the different types of activities, like Phone call, Meeting and so on
(Inherited from IAppointment.)
Public propertyCode exampleTimeZoneLocationId
Gets the Timezone location id this appointment was stored under
(Inherited from IAppointment.)
Public propertyCode exampleType
1=diary,2=checklist,6=invite The different types of appointment, if the appointment is supposed to be shown in the diary or checklist, or if its a document
(Inherited from IAppointment.)
Public propertyCode exampleUDef
UDef - The user-defined fields on the appointment.
(Inherited from IAppointment.)
Public propertyCode exampleUpdatedAssociate
The last user to modify the object If the appointment has never been updated, this will return 0
(Inherited from IAppointment.)
Public propertyCode exampleUpdatedDate
The date of the most recent update. If the appointment has never been updated, this will return 0; formatted as a SuperOffice date (see the database manual), this will return 01.01.1970
(Inherited from IAppointment.)
Public propertyCode exampleUpdateMode
How will the recurring events be updated? For example: 0 = enNotSet, 1 = enOnlyThis, 2 = enThisAndForward...
(Inherited from IAppointment.)
Public propertyValidationMessage
get validation message, if empty model will think it is ok to save
(Inherited from IAppointment.)
Top
Methods
  NameDescription
Public methodCode exampleAcceptInvitation
Accept or reject this invitation: 0 = Reject, 1 = Accept.
(Inherited from IAppointment.)
Public methodAddParticipant (Inherited from IAppointment.)
Public methodCode exampleAssignTo
Assign appointment to an associate, from another associate (default from current associate)
(Inherited from IAppointment.)
Public methodCode exampleCancelChanges
Undo any changes made since the object was loaded. If you made changes to the model that you dont want to be saved to the database, call the CancelChanges method
(Inherited from IAppointment.)
Public methodCode exampleChangeIdentity
Loads a different record into the object. Causes changes to the existing object to be saved first. Saves the changes made to the appointment model to the database. The last thing you do to an object if you want the changes you made to be saved. The ChangeIdentity method calls the save method first.
(Inherited from IAppointment.)
Public methodClone
Clone this appointment
(Inherited from IAppointment.)
Public methodCode exampleDelete
Delete the object from the database. May throw an error if you are not allowed to delete the object. Deletes the specified appointment model from the database
(Inherited from IAppointment.)
Public methodCode exampleGetNoOfParticipants
Number of participants for this booking.
(Inherited from IAppointment.)
Public methodCode exampleGetParticipants
Get all participants of the required type for this appointment. Returns an SOAssociates or an SOPersons list depending on the type.
(Inherited from IAppointment.)
Public methodCode exampleHasConflict
Has this appointment(booking) a time conflict? 0 = enResponseReject, 1 = enResponseAccept
(Inherited from IAppointment.)
Public methodCode exampleInsertAppointmentPerson
If the main appointment has a person, insert the person as a participant on the booking.
(Inherited from IAppointment.)
Public methodIsSuggestedItem
Is this appointment used as a suggested appointment?
(Inherited from IAppointment.)
Public methodRemoveParticipant (Inherited from IAppointment.)
Public methodCode exampleSave
Persist the object to the database. May throw an error if you are not allowed to save changes to the object. Saves the changes you made to the appointment model to the database, does not return the new data from the database
(Inherited from IAppointment.)
Public methodCode exampleSetDefaults
Populate the object with default values, such as setting the owner to the current user. The user is able to define their own default types, priority and duration under View – Preference in the CRM 5 clients. Calling the setDefaults method will set these values on the appointment.
(Inherited from IAppointment.)
Public methodCode exampleSetDefaultsCall
SetDefaults for a phone call appointment. Has short duration. Starts now. The user is able to define their own default types, priority and duration under View – Preference in the CRM 5 clients. Calling the setDefaults method will set these values on the appointment. The user is able to define their own default types, priority and duration under View Preference in the CRM 5 clients. Calling the SetDefaultsCall method will set these values on the appointment.
(Inherited from IAppointment.)
Public methodCode exampleSetDefaultsToDo
SetDefaults for a ToDo appointment. Has no start time. The user is able to define their own default types, priority and duration under View – Preference in the CRM 5 clients. Calling the setDefaults method will set these values on the appointment. The user is able to define their own default types, priority and duration under View Preference in the CRM 5 clients. Calling the SetDefaultsToDo method will set these values on the appointment as long as it is of type = ToDo
(Inherited from IAppointment.)
Public methodSuggestedItemId
Get the suggested item id
(Inherited from IAppointment.)
Top
See Also