Create Item
Applies To: System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator
The Create Item activity is used in a runbook to create new appointment, contact group, and Email Message or task items.
The following tables list the required properties, optional properties, and published data for Create Item activities. The required and optional properties are presented according to item type: appointment, contact group, task, and email message.
Additionally, this topic describes how to create recurring appointments and tasks.
Create Item Required Properties (Appointment)
Element |
Description |
Valid values |
Start |
The start time of the appointment |
DateTime |
End |
The end time of the appointment |
DateTime |
Subject |
The subject of the appointment |
String |
Body |
Details about the appointment |
String |
Create Item Optional Properties (Appointment)
Element |
Description |
Valid values |
Allow New Time Proposal |
Indicates whether the new time proposals are allowed |
True False |
Attachments |
List of attachments for the item |
Comma separated list of file paths |
Body Type |
Content type of body |
Text HTML |
Categories |
List of categories that are associated with the appointment |
Comma separated list |
Destination Folder |
Alternative destination folder of the appointment |
String |
Free Busy Status |
The free/busy status of the owner of the appointment |
Free Tentative Busy OOF NoData |
Importance |
Sets the importance of the appointment |
Low Normal High |
Is All Day Event |
Indicates whether the appointment is an all-day event |
True False |
Is Online Meeting |
Indicates whether the appointment is an online meeting |
True False |
Is Reminder Set |
Indicates whether a reminder is set for the appointment |
True False |
Is Response Requested |
Indicates whether responses are requested |
True False |
Location |
The location of the appointment |
String |
NetShow URL |
The URL of the Microsoft NetShow online meeting |
String |
Number of Occurrences |
Number of occurrences |
Integer |
Optional Attendees |
Optional attendees for the meeting |
Comma separated list of e-mail addresses |
Recurrence |
The recurrence pattern for the meeting |
Daily Weekly The same day each month The same week each month The same day each year The same week each year |
Recurrence Ends |
The last occurrence of the meeting |
DateTime |
Recurrence Interval |
The recurrence interval |
Integer |
Recurs On These Days |
The day(s) on which the appointment recurs |
String |
Reminder (Minutes) |
Defines how many minutes before the occurrence a reminder is to be triggered |
Integer |
Reminder Due By |
Sets the reminder due date and time for this appointment |
DateTime |
Required Attendees |
List of required attendees |
Comma separated list of email addresses |
Resources |
List of resources for the meeting |
Comma separated list |
Sensitivity |
Sets the sensitivity of the appointment |
Normal Personal Private Confidential |
Create Item Required Properties (Contact Group)
Element |
Description |
Valid values |
Display Name |
The name of the contact group |
String |
Members |
List of members associated with contact group |
Comma separated list of email addresses |
Create Item Optional Properties (Contact Group)
Element |
Description |
Valid values |
Categories |
List of categories that are associated with the Contact Group |
Comma separated list |
Destination Folder |
Alternative destination folder of the Contact Group |
String |
Create Item Required Properties (Task)
Element |
Description |
Valid values |
Body |
Details about the task |
String |
Due Date |
The date and time that the task is due |
DateTime |
Start Date |
The date and time that the task starts |
DateTime |
Subject |
The subject of the task |
String |
Create Item Optional Properties (Task)
Element |
Description |
Valid values |
Actual Work |
The actual amount of work spent on the task |
Number |
Billing Information |
Billing information for the task |
String |
Body Type |
Indicates whether the body is text or HTML |
Text HTML |
Categories |
List of categories associated with the task |
Comma separated list |
Companies |
List of companies associated with the task |
Comma separated list |
Complete Date |
The date and time that the task was completed |
DateTime |
Contacts |
List of contacts associated with the task |
Comma separated list |
Destination Folder |
Alternative destination folder of the task |
String |
Importance |
The importance of the item. |
Low Normal High |
Is Reminder Set |
Indicates whether a reminder is set for the task |
True False |
Mileage |
The mileage of the task |
String |
Number of Occurrences |
Number of occurrences for a recurring task |
Integer |
Percent Complete |
The completion percentage of the task |
Number |
Recurrence |
The recurrence pattern for the meeting |
Daily Weekly The same day each month The same week each month The same day each year The same week each year |
Recurrence Ends |
The last occurrence of the task |
DateTime |
Recurrence Interval |
The recurrence interval |
Integer |
Recurs On These Days |
The day(s) on which the task recurs |
String |
Reminder (Minutes) |
Defines how many minutes before the occurrence a reminder is to be triggered |
Integer |
Reminder Due By |
The date and time when the reminder is due |
DateTime |
Sensitivity |
Sensitivity of the task |
Confidential Normal Personal Private |
Task Status |
The status of the task |
NotStarted InProgress Completed WaitingOnOthers Deferred |
Total Work |
The total amount of work spent on the task |
Integer |
Create Item Required Properties (E-Mail Message)
Element |
Description |
Valid values |
To |
List of recipients of the email |
Comma separated list of email addresses |
Subject |
Subject of the email |
String |
Body |
Body of the email |
String |
Create Item Optional Properties (E-Mail Message)
Element |
Description |
Valid values |
Attachments |
List of attachments |
Comma separated list of file paths |
Bcc |
List of Bcc recipients for this email |
Comma separated list of email addresses |
Body Type |
Indicates whether the body is text or HTML |
Text HTML |
Categories |
List of categories associated with the email |
Comma separated list |
Cc |
List of Cc recipients for this email |
Comma separated list of email addresses |
Destination Folder |
Alternative destination folder for the sent message |
String |
From |
Who the email came from |
String |
Importance |
The importance of the email |
Low Normal High |
In Reply To |
The In-Reply-To reference |
String |
Is Delivery Receipt Requested |
Indicates whether a delivery receipt is requested |
True False |
Is Read Receipt Requested |
Indicates whether a read receipt is requested |
True False |
Is Response Requested |
Indicates whether a response is requested |
True False |
References |
References of the email |
String |
Sender |
The sender of the email message |
String |
Sensitivity |
The sensitivity of the email |
Normal Personal Private Confidential |
Create Item Published Data
Element |
Description |
Value type |
ID |
The ID of the item that was created |
String |
Item Type |
The type of the item that was created. |
String |
Destination Folder |
The folder where the item is stored |
String |
Domain |
Domain the Exchange Server belongs to |
String |
Exchange Server Address |
Address of the Exchange Server |
String |
Timeout (seconds) |
Timeout value for the Exchange Server connection |
Number |
Use Autodiscover |
Whether or not to use Autodiscover to check for changes |
Boolean |
User Name |
User name used to log on to the Exchange Server |
String |
Recurring Appointments and Tasks
The integration pack provides the ability to create recurring appointments and tasks. To setup a recurring appointment or task, perform the following steps:
Add the optional Recurrence property.
Select the desired recurrence pattern from one of the available options.
To use a pattern other than the Daily pattern, add the optional Recurs On These Days property.
Specify a value for the Recurs On These Days property according to the rules that are presented in the following table.
Element |
Description |
Recurrence |
Recurs On These Days |
Daily |
Not required. |
Weekly |
Specify a comma separated list of day names. Full or abbreviated day names are acceptable. For example: Saturday, Sunday or Sat, Sun. |
The same day each month |
Not required. The day is determined by the start date. |
The same week each month |
Specify a relative index followed by a day of the week. Valid indexes include First, Second, Third, Fourth, and Last. Days of the week include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekday, and WeekendDay. For example: First Monday. |
The same day each year |
Not required. The day is determined by the start date. |
The same week each year |
Specify a relative index followed by a day of the week. Valid indexes include First, Second, Third, Fourth, and Last. Days of the week include Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday, Weekday, and WeekendDay. The month is determined by the start date. For example: First Monday |