Add New List Item

AVEVA Work Tasks allows you to add a new list item to the list using XML List XML variables. Update Variable activity can be used to add/update an item to the list. To add an item you need to select the scope as New from Choose the List Item to Work on options. You can also use List Navigator Activity to set the scope. With the help of a scenario, we will explain this function.

Assume that you have created a list called Purchase Orders with the following fields.

• Reference Number

• Purchase Order Date

• Raised By User

• Deliver To User

• Status

• Purchase Order Details

  • Item Name

  • Quantity

  • Unit Price

  • Item Total

• Total Purchase amount

Now you want to add items to this list.

To add a new List Item

1. Login to the Enterprise Console and launch the Workflow Designer page.

2. You need to create an XML List type XML variable for the Purchase Orders list. If the variable is not created, follow the below mentioned procedure to create.

3. Click the edit icon in the XMLVariables property from the Start Activity Properties. The following screen is displayed. 
    

4. Click New Variable to add a new variable.

5. Type the variable name as 'purchaseorders'.

6. Select XML List from the Type drop-down list.

7. Type the List name in the Select List field or click the  icon to select the list. In this case, select Purchase Orders list. 
   

8. Select New as the scope from the ListItem Scope Options to point to a new item in the Purchase Orders list.
   
    

9. Now you can see the XML nodes in a tree-view that are mapped to the controls while creating the list.

10. Click Save Variable. A message is displayed saying 'Variable Updated'. Close the window.
    Note: If you set the scope as Current while creating the XML List type XML variable, you can change it in to New using List Navigator activity.

11. Drag and drop Update Variable activity to add an item to the list.

12. Click the edit icon in the Set Variable property. The following screen is displayed.
    

13. Click the Select link and select the respective field of the XML List type XML Variable created for the list (in this case purchaseorders). The fields displayed in the tree-view represent the XML nodes of the controls in the list.
    
    

14. Select a field for which you want to set the value, from the tree-view and enter the value for the field in the right-hand side text box, or you can use the  icon to set the value.
    

15. If you want to set the value, select enter a value from the tree-view, and then enter the value. Also you can select variables or contents or any XML Variable nodes directly by selecting the respective node from the tree-view. If you want to combine multiple node values, you can build an expression by selecting Build Expression.  
    

16. In the same way, you can set the value for all other fields in the list for the new item. Make sure to specify the values for all mandatory fields of the list.

17. After setting the value for the entire field, click OK. When you execute this workflow, a new item will get added based on the value that you have set.