1.3. Objetivos
2.7.5. Rol del Maestro en la Disciplina Escolar
Events are scheduled activities that are automatically added to your calendar when created.
Events can be scheduled for a specific date/time or can be designated as a recurring activity.
The Event record is defined in the actSched (scheduling) XSD.
Event Record in NetSuite UI:
Usage Notes
Supported Operations
•
add
•
addList
•
update
•
updateList
•
delete
•
deleteList
Events (CalendarEvent) Field Definitions
49
•
get
•
getList
•
searchNext
•
search
•
searchMore
Associated Records
An event record can be created by itself or associated with the following records in NetSuite:
•
customer
•
contact
•
opportunity
Recurrence
A recurring event can be modified to change or delete an individual event in the series. In the
NetSuite Web Services Platform, this is handled using the recurrenceExclusionList type.
To Delete individual events in a series:
Update the recurring event with a list of exclusions (in the form of dates) in the
recurrenceExclusionList type. The recurrenceExclusionList type sets a list of timestamps of
individual events that have been excluded from the series.
Important: Once an event has been excluded, it is separated from the rest of of the events in
the series, and it can NOT be associated with the event series.
To Update an individual instance of a recurring event
1.
Update the recurring event with a list of exclusions (in the form of dates) in the
recurrenceExclusionList field.
2.
For each exclusion, add a new event that contains the updated data.
The original event and the new modified event have different internal ID values and
the new updated event is no longer associated with the event series.
To retrieve excluded events from a series:
Submit a get operation for the desired event series and return the values listed in the
recurrenceExclusionList type.
Field Definitions
Events (CalendarEvent)
Field Definitions
50
Record Fields
The fields defined below are used to add and update information in a event record.
CalendarEvent
Field Name Type /
Length Req. Mapping Notes
internalId string N This is a required field for update, delete and get operations.
title String / 48 Y Title This sets the subject line of the e-mail sent to those invited to the event, the title displayed if this event is marked public and the title displayed on the calendar of those invited to this event.
organizer RecordRef N Organizer This field has a default value of the current user.
location String / 48 N Location Sets the location for the event. If a value is supplied status Enum N Status This field has a default value of confirmed. The values
used to populate this field are _cancelled, _completed, _confirmed or _tentative.
accessLevel Enum N Event
Access
This field has a default value of public. The values used to populate this field are _public, _private or _showAsBusy. reminderMinutes Enum N Reminder This field has a default value of 15m. The values used to
populate this field are _none, _0minutes, _5minutes, _10minutes, _15minutes, _30minutes, _1hour, _2hours, _3hours, _4hours, _5hours, _8hours, _1day, _2days, _3days, or _1week.
reminderType Enum N Reminder
Type
The values used to populate this field are _popupWindow or _email.
message String /
4000
N Message
transaction RecordRef N Opportunity This is a reference to an opportunity record that already exists in your NetSuite account.
startDate Datetime Y Date
Start Time
allDayEvent Boolean N All day
event
This field requires a true or false value and is settable only. To determine whether an exiting event is all day, you must use the start and end times for the event. isRecurringEvent Boolean N This field requires a true or false value.
period Enum Y/N This field is only required if isRecurringEvent is true. The values used to populate this field are _every,
Events (CalendarEvent)
Field Definitions
51
List Fields
The fields defined below are used to add and update information in lists that are attached to
the contact record.
ExclusionDateList
This list is used to denote individual events in a series that have been modified or deleted. For
detailed information, see “Recurrence” on page 49.
frequency Enum Y/N This field is only required if isRecurringEvent is true. The values used to populate this field are _day, _month, _monWedFri, _tueThu, _week, _monThruFri, _satSun and _year
seriesStartDate Datetime N Series Start Date
This field is not available for add operations.
endByDate Datetime N End By
noEndDate Boolean Y No End Date This field allows a true or false value only.
sendEmail Boolean N Notify
internal attendees by e-mail
This field has a default value of false. If set to True, each attendee listed in the attendeeList type is notified of the event via email.
customForm recordRef Y/N None References an existing custom form for this record type. To ensure that field relationships defined within a desired custom form are maintained, you must provide the customForm value. Also, if defaults are off, then customForm is required, if defaults are on then the default form is used. Internal ID values for existing forms can be found at Setup > Customization > Entry Forms.
createdDate DateTime On Add
None: Hidden
When adding a record, this field defaults to the current system date and time. This field can be overwritten but, if not, the default value is set regardless of any use default settings.
endDate DateTime Y Date
End Time lastModifiedDate DateTime N None:
Hidden
This is a read only field. When updating a record, this field defaults to the current system date and time.
owner RecordRef N This field has a default value of the current user. exclusionDateList List N See “ExclusionDateList” on page 51
attendeeList List N See “AttendeeList” on page 52
resourceList List N See “ResourceList” on page 52
customFieldList List N See “CustomFieldList” on page 4
Field Name Type /
Events (CalendarEvent)
Field Definitions
52
AttendeeList
This list is used to identify each attendee for the event.
ResourceList
This list is used to schedule available resources for the event.
Search Record Fields
The fields defined below are used to search information in event records.
EventSearch
Field Name Type Req. Mapping Notes
exclusionDate Datetime Y Sets the individual events that have been modified or deleted within a series. See “Recurrence” on page 49.
Field Name Type /
Length Req. Mapping Notes
sendEmail Boolean N Email This field has a default value of true.
attendee RecordRef Y Send
Invitation to
This field is a reference to an entity record that already exists in your account.
response Enum N Response The values used to populate this field are _accepted, _declined, _noResponse or _tentative. The default value is _noResponse.
attendance Enum N Attendance The values used to populate this field are _required or _optional. The default value is _required.
Field Name Type / Length Req. Mapping Notes
resource RecordRef Y Resource This is a reference to a resource record that already exists in your account.
location String / 25 N Location This is a read-only field that provides the location of the selected resource.
Field Name Search XSD Type Mapping
attendees SearchMultiSelectField Attendees
calendar SearchMultiSelectField Calendar
createdDate SearchDateField Date Created
Events (CalendarEvent)
Field Definitions
53
lastModifiedDate SearchDateField Date Last Modified
location SearchStringField Location
organizer SearchMultiSelectField Organizer
resources SearchMultiSelectField Resources
response SearchEnumMultiSelectField Response
startDate SearchDateField
status SearchEnumMultiSelectField Status
title SearchStringField Title
customFieldList SearchCustomFieldList