This type of action will create a new item in a list that you identify in the action definition. The action definition determines how each column in the new list item is populated.
When creating this type of action definition, keep in mind that the columns referenced by the action must exist in both the source list and the destination list and must utilize the same column names. If they do not, the action will fail when it is executed. If an action fails, the status area will include an appropriate error message and links to the failed item(s).
In the Winter 2006 Update and later releases, this action type supports all libraries with a base type of document library. The Winter 2006 release did not support document, picture, or form libraries.
All of the steps in these procedures are required, except Steps 3, 9, and 12.
1. When a Create List Item action is executed, it writes to a list that is identified in the action definition. Therefore, you need to create that destination list before you create the action definition.
2. Select the Create a New Action button at the top of the Actions Wizard.
3. In the Site URL field, type the URL of the action library that will hold the new action definition and click Add. If the action library is located in the current site, this field can be left blank.
4. All of the libraries that have a type of Document Library and can therefore be used to store an action definition are displayed in the Document Libraries area. Highlight the action library you want to use.
· Actions cannot be written to an action library located in a sub-area.
5. Type the name of the new action definition in the Action Name field.
· This is the name that will be displayed to users, so make sure the name makes the purpose of the action as clear as possible.
· At the same time, keep in mind that the drop-down that displays the action titles will automatically resize to fit the longest title. As a result, CorasWorks recommends that you limit your action names to approximately 30 characters in length.
6. Use the Action Type drop-down to select Create List Item. When you make this selection, the page is refreshed and the Configure Action Type section of the display is expanded with the appropriate entry fields for that action type.
7. In the Message Displayed for Successful Action field, type the message to be displayed to users when an action is completed successfully.
8. In the Error Message Displayed for Failed Action field, type the message to be displayed to users when an action fails for any reason.
9. If you also want to include any SharePoint error details when an action fails, select the Include SharePoint Error Details checkbox. When this option is enabled, SharePoint details will be appended to the error message you define in the step above.
10. The Lists drop-down field is automatically populated with all of the lists available on the current site. To save the list items created as a result of this action in a different site, type the URL for that site in the Add Site field.
11. In the Lists field, select the name of the list where you want list items created as a result of this action to be saved (the destination list). The page is refreshed.
12. If you want the new item to include a copy of any attachments associated with the source item, select the Include Attachments checkbox. This feature is new as of the Winter 2006 Update.
· The size of the attachments allowed is dependent upon the virtual server’s general settings.
13. All of the column names that can be used to create a new item are displayed below the Include Attachments checkbox. You must select or populate at least one column for the action definition. You have several options for each column:
· If you want the column to be populated with the same data as the selected item in the roll-up or Cross-Connect, place a mark in the left-most checkbox.
· If you want the column to be populated with the same content every time an item is created as a result of this action, type that static data in the entry field.
o Several functions are available for use in single and multi-line columns. For a listing and definitions, see the Additional Functions topic.
· If you want the user to populate the column when the action is executed, choose the Select at Runtime checkbox.
o If the column must be populated, select the Required Field checkbox.
o If you want the column to be displayed in a different order on the Action Runtime Interface than it is on the Actions Wizard interface, type the desired order in the Entry Order field. If you leave this field blank, the column will be displayed in the same order as it is shown in the Actions Wizard.
· If you want the column in the new item to be blank, leave it blank in the definition.
NOTE: You can use any combination of static data, data copied from the selected item, and data entered by the user at runtime for the columns displayed on the Actions Wizard interface. However, you should not try to select more than one for a single column. The Actions Wizard will not allow you to select both the left-most checkbox and the Select at Runtime checkbox. And if you select a checkbox and also enter a static value for a single column, the checkbox will take precedence when the action is executed.
14. If you are working with the Winter 2006 Update or a later release and the selected list includes date columns, a Date Picker with multiple drop-downs and entry fields is available. You can:
· Use the left-most checkbox to copy the date and time from the selected roll-up item when the action is executed.
· Use the first drop-down to select a static date from a calendar. Navigate to the desired month and year and then click on the date you want to select.
· Select the hour and minutes from a pair of drop-downs.
· Select one of the CorasWorks date functions from a drop-down, so you do not need to identify a literal date. For a complete listing with definitions, please refer to the Date Functions section of this help topic.
· Add or subtract the identified number of days from the existing value in the date column by entering a positive or negative number in the Day(s) entry field. If the date column is not currently populated, the days will be added or subtracted from today’s date. If you want to subtract days, simply precede the number by a – sign. If you want to add days, a symbol is not necessary.
· Choose Select at Runtime to prompt the user the make a selection using any of the above options when the action is executed.
If you attempt to utilize multiple selection options, the Actions Framework will look for a date function first, then a Day(s) entry, and then a calendar date. There is no interaction between these methods, so, for example, it will not process a combination of a date function and a Day(s) value, such as adding five days to the first day of the first quarter.
15. When you are finished defining the new action, select Save. The action is now available for use in a roll-up or Cross-Connect.