Set Approval Status

Set Approval Status

The Set Approval Status widget sets the Approval Status field in a list or library to one of a pre-defined set of choices. If the Approval Status field does not exist, the widget will create it.

NOTE: This widget must run as a user with the Design level or above on the list. If the workflow initiator does not have this permission level, configure the Run As property to use an account that does.

Widget Properties:

Column Description
Item (Required)

Click the Icon-Ellipsis button to select an item to set the approval status for:

  • Select Current Item (the default) to update the Approval Status column for the item the workflow was started on.
  • Select External List Lookup to update the Approval Status for an item in another list or library in the site, site collection, or another site in another site collection:
    • To set the Approval Status for an item in a list in the current site, select a list in the List box. To discard check out for an item in a list in another site or site collection, make the desired selections in the Site Collection and Site boxes and then select a library from the List of available libraries.
    • To identify the item in the list or library that you want to set Approval Status for, select a Filter Field and enter a match criteria in the Equals box, either by typing one or by adding a lookup using the Add Lookup icon (Button-AddLookup). If more than one item matches the criteria, Approval Status is updated for the first item returned.
Approval Status

Select the new value for the Approval Status field. Select the value from the choices Approved, Rejected, Pending, Draft, or Scheduled. If the Approval Status field does not exist, it is created when the widget runs.

NOTE: If you want to set the Approval Status to something other than the pre-defined set of choices, or if you want to update a field named something other than “Approval Status”, use the Update Item widget or Set Field Value widget.

Comments Enter text or a combination of text and lookups to write a comment to the Approver Comments field for the Item. If the Approver Comments field does not exist, it is created when the widget runs.
Click Apply to save the widget settings.

Example Using Set Approval Status Widget

Return to Lists and Items Widgets

See Also: