You are here: Reference Guides > Workflow Nodes (A-Z) > Approval Node

Approval node properties (Designer)

The Approval node is a step within a workflow that requires the consent or decision of its assignees to proceed to the next step in the workflow.

Property

Description

AllowBulkApproval

Whether or not assignees should have the option of bulk approving their assignments based on this node in the Winshuttle Task List detail view.

AllowOverrideDuration

Allows the initiator of the form to set a new duration (time in which the task must be completed), other than the default set from the Duration property. A reference to a column must be entered in the property, either as an expression (e.g. date(today()+[//my:numberofdaysallowed])) or a single column (e.g. [overrideDuration]).

NOTE: This option works in conjunction with a SharePoint list or document library column. The column can be created from an InfoPath control in the form that has been exported as a Form Library Column or manually created in the document library properties. The overriding value must be in a date format (e.g. 12/07/2010). Make sure that users are aware of the format. Using a date picker control ensures that users enter a correctly formatted value.

AllowReassignment

Allows the task assignee to reassign their task.

AllowReplacement

Allows the task assignee to replace a process controlled document that is being routed.

AllowTeamAddition

Allows the task assignee toadd team members (members of his/her SharePoint Group) to the task. New team additions receive an email notifying them that they have a task. This setting converts an assignment to a single user into a team assignment.

ApprovalType

Type of approval required to complete this task. Possible values are:

  • Unanimous — all must agree for approval.
  • SingleAproval — a single approval is required for approval.
  • SingleRejection — a single rejection is required for rejecting.
  • ApprovedVote — approval is based on a vote (see VoteCount).
  • RejectedVote — rejection is based on a vote (see VoteCount).
  • SingleDecision — single approval or rejection is required to complete the task.

Assignment
CompletionLinkText

Text displayed as the hypertext link directing the assignee to their task.

CommentRequirement

Requires that the task assignee enter a comment before completing the assignment. Possible values are:

  • None — comments are not required.
  • Always — a comment is always required.
  • OnReject — a comment is only required if the assignee is rejecting (their disposition in an Approval task is Reject).

DefaultApprovalPeriod

The time (in days or hours) in which a task will automatically be approved if the assignee does not complete it.

NOTE: The task will be automatically completed only when the value (amount of time) of this setting and the Duration property setting have elapsed. The workflow continues along the transition or transitions that meets the criteria. If you have a task and there is a single transition, it will go down that path. If you have an approval node and a reject node, it will move down the approved transition.

Best practice when you use this function is to have a transition node that is set to condition "AutoApproved" and one that is labeled "ExplicitlyApproved" and a transition that is labeled "Rejected."

Description

A description of the task/assignment.

Duration

The time (in days or hours – see DurationUnit) within which the task must be completed. Reminder emails are sent out one DurationUnit before the assignment due date, unless the Duration is set to 1 unit. Overdue emails are sent out after the assignment due date.

DurationUnit

The time unit (days or hours) for the duration of the task.

EmailApproval

Allows the task assignee to complete the assignment (approve or reject) via email.

EmailFormattingType

Type of notification that goes out when the task is assigned. Possible values are:

  • HTML — the email notification is sent in HTML format.
  • HTML and Text — the email notification is sent in both HTML and text format, and the mobile device automatically determines which view (text or HTML) to display.
  • Text — the email notification is sent in text format.

NOTE: in order to support as many devices as possible, there are two email options that specifically address mobile devices, HTML/Text or Text. Some devices fully support HTML/text emails, rendering the correct view of the notification, while other devices do not. The Text option should be used for devices that do not support HTML/Text email. Run a few test with your workflow and mobile device(s) to determine which option is best for your users.

FormAttachmentFormat

Whether to use MHTML or JPEG as the format for the email form attachments.

FormHiddenFields

List of fields to hide from the task assignee.

NOTE: This option maintains sensitive information on the server only.

FormHiddenFieldType

Type of fields to hide from the task assignee.

FormView

The InfoPath form view visible to the task assignee when the assignment is accessed.

IncludeAssignment CompletionLinkIn Notification

Toggles the inclusion/exclusion of a hypertext link in the task notification, directing the assignee to their task (see AssignmentCompletionLinkText).

IncludeHistoryIn Notification

Toggles the appending of workflow history associated with the form or document.

IncludeItem

Attaches the form and/or file attachments to the email.

IncludeItemLinkIn Notification

Toggles the inclusion/exclusion of a hypertext link in the task notification, directing the assignee to the form or document pertaining to the task (see ItemLinkText).

Include MainPageLink InNotification

Toggles the inclusion/exclusion of a hypertext link in the task notification, directing the assignee to the Designer site where the task originated (see MainPageLink Text).

ItemLevelPermissions

The name of the SharePoint permission set that should be ascribed to the Originator for the SharePoint item against which the workflow will run.

ItemLevelPermissions Type

Can be one of the following:

  • None — does nothing with respect to permissions.
  • Add — adds the given permission to the item.
  • Replace — replaces the current permission sets with the given permission set.

ItemLinkText

A hypertext link directing the assignee to the form or document pertaining to the task.

LinkOrder

The order in which to place the links in the automatically generated email notifications.

MainPageLinkText

A hypertext link directing the assignee to the Designer site where the task originated.

ManagedAttributes

SharePoint list fields exposed to the task assignee.

Name

The name of the task/assignment.

OverdueReminder Frequency

The interval (in hours or days) to send the overdue notices for an assignment.

NOTE: The default value of this property (0) sends only one reminder after the assignment is past due.

PastDueEmailCC

Takes a comma-separated list of email addresses and/or swimlane names that will be carbon copied when a past due email is sent.

RequireReview

Requires that the assignee view the task’s supporting document/file by clicking on the link to it prior to completing their assignment.

SendAssignmentEmail

Whether or not to send an email to the workflow participant who receives an assignment based on this node.

SendDefaultApproval
Email

Whether or not to send an email to the workflow participant should a default assignment approval happen based on this node.

SendPastDueEmail

Whether or not to send an email to the workflow participant who receives an assignment based on this node when the assignment becomes overdue.

SendReminderEmail

Whether or not to send an email to the workflow participant who receives an assignment based on this node when the assignment will soon become overdue.

SetValues

Allows you to set a value in a form field or SharePoint list item, after the task has been completed.

Swimlane

The swimlane assigned to the task.

Type

Read-only type of the node.

VoteCount

Percentage that must be reached by the participants assigned to the node for approval or rejection to be granted.