ÿþ<html><head> <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> <link rel="stylesheet" type="text/css" href="content/Nintex.Workflow.contentHXS.css"/> <link rel="stylesheet" type="text/css" href="content/Nintex.Workflow.ont.css"/> <link rel="stylesheet" type="text/css" href="content/Nintex.Workflow.helpCss.css"/> </head><body class="ms-HPMainBody" style="padding: 2px;"><h1>Nintex Workflow 2007 Help</h1><h3>Last updated: Monday, 1 August 2011</h3> <a href="#Nintex.Workflow.SectionAdmin" style="font-size: 14pt">1 Administration and Configuration</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Licensing" style="font-size: 12pt">1.1 Licensing settings</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DatabaseSettings" style="font-size: 12pt">1.2 Database settings </a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DatabaseMappings" style="font-size: 12pt">1.3 Manage content databases</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WebAppActivation" style="font-size: 12pt">1.4 Web Application activation settings</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowActions" style="font-size: 12pt">1.5 Managing workflow actions</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.GlobalSettings" style="font-size: 12pt">1.6 Global Settings</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.LazyApprovalSettings" style="font-size: 12pt">1.7 Managing LazyApproval settings</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.MessageTemplates" style="font-size: 12pt">1.8 Defining message templates</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Activating" style="font-size: 12pt">1.9 Activating Nintex Workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.UserPreferences" style="font-size: 12pt">1.10 Configuring user preferences</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SecuritySettings" style="font-size: 12pt">1.11 Security Settings</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.PurgeWorkflowData" style="font-size: 12pt">1.12 Purge Workflow Data</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowErrorNotification" style="font-size: 12pt">1.13 Workflow Error Notifications</a><br /><a href="#Nintex.Workflow.SectionUsing" style="font-size: 14pt">2 Using the Workflow Designer</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowDesigner" style="font-size: 12pt">2.1 Getting started with the Nintex Workflow designer</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ErrorHandling" style="font-size: 12pt">2.2 Error Handling</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.HomeServerPicker" style="font-size: 12pt">2.3 Home Server Picker</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ImportExport" style="font-size: 12pt">2.4 Importing and exporting workflows</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ImportSLWorkflow" style="font-size: 12pt">2.5 Importing a SmartLibrary workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.InlineFunctions" style="font-size: 12pt">2.6 Inline functions</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.InsertReference" style="font-size: 12pt">2.7 Inserting reference fields</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.LDAPPicker" style="font-size: 12pt">2.8 LDAP Picker</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Lookups" style="font-size: 12pt">2.9 Using lookups</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.MailStorePicker" style="font-size: 12pt">2.10 MailStore Picker</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ManageWorkflows" style="font-size: 12pt">2.11 Managing Workflows</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.OpenSave" style="font-size: 12pt">2.12 Opening and saving workflows</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Print" style="font-size: 12pt">2.13 Printing</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Publishing" style="font-size: 12pt">2.14 Publishing a workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SetLabels" style="font-size: 12pt">2.15 Set action labels</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.VerboseLogging" style="font-size: 12pt">2.16 Verbose logging</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Snippets" style="font-size: 12pt">2.17 Workflow Snippets</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.StartData" style="font-size: 12pt">2.18 Workflow start data</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.StartOptions" style="font-size: 12pt">2.19 Workflow start options</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Templates" style="font-size: 12pt">2.20 Workflow templates</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WFConstants" style="font-size: 12pt">2.21 Workflow Constants</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowGallery" style="font-size: 12pt">2.22 Workflow gallery</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowVariables" style="font-size: 12pt">2.23 Workflow variables</a><br /><a href="#Nintex.Workflow.SectionInteraction" style="font-size: 14pt">3 Workflow Interaction with Sharepoint</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.LazyApproval" style="font-size: 12pt">3.1 About LazyApproval</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ApproveReject" style="font-size: 12pt">3.2 Approving, Rejecting and Reviewing Items</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.GraphViewerWebPart" style="font-size: 12pt">3.3 Configuring the Graph Viewer Webpart</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ReportViewerWebPart" style="font-size: 12pt">3.4 Configuring the Report Viewer Webpart</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Delegation" style="font-size: 12pt">3.5 Delegating Approval Tasks </a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ItemsPendingApproval" style="font-size: 12pt">3.6 My Workflow Tasks web part</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SchedulingWorkflow" style="font-size: 12pt">3.7 Scheduling a workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.StartWorkflow" style="font-size: 12pt">3.8 Starting a workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowHistory" style="font-size: 12pt">3.9 Viewing workflow history</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WorkflowStatus" style="font-size: 12pt">3.10 Viewing workflow status</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.MyWorkflows" style="font-size: 12pt">3.11 Workflows I have started web part</a><br /><a href="#Nintex.Workflow.SectionActions" style="font-size: 14pt">4 Workflow Actions</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ActionSet" style="font-size: 12pt">4.1 Action Set</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.AddUserToADGroup" style="font-size: 12pt">4.2 Add User To AD Group</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ToDoTask" style="font-size: 12pt">4.3 Assign a ToDo Task</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.FlexiTask" style="font-size: 12pt">4.4 Assign Flexi Task</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.BuildDynamicString" style="font-size: 12pt">4.5 Build Dynamic String</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CalculateDate" style="font-size: 12pt">4.6 Calculate Date</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CallWebService" style="font-size: 12pt">4.7 Call web service</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CancelCheckOut" style="font-size: 12pt">4.8 Cancel check out</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ChangeState" style="font-size: 12pt">4.9 Change State</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CheckInItem" style="font-size: 12pt">4.10 Check in item</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CheckOutItem" style="font-size: 12pt">4.11 Check Out Item</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CollectionOperation" style="font-size: 12pt">4.12 Collection Operation</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CommitWorkflow" style="font-size: 12pt">4.13 Commit pending changes</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CompileAudience" style="font-size: 12pt">4.14 Compile Audience</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CompleteNWTask" style="font-size: 12pt">4.15 Complete Workflow Task</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ConvertValue" style="font-size: 12pt">4.16 Convert Value</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CopyItem" style="font-size: 12pt">4.17 Copy an item</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CopyFileshare" style="font-size: 12pt">4.18 Copy to fileshare</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CopySharePoint" style="font-size: 12pt">4.19 Copy to SharePoint</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateSite" style="font-size: 12pt">4.20 Create a Site</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateADAccount" style="font-size: 12pt">4.21 Create AD Account</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateADSecurityGroup" style="font-size: 12pt">4.22 Create AD Security Group</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateItem" style="font-size: 12pt">4.23 Create an item</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateAudience" style="font-size: 12pt">4.24 Create Audience</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateCrmRecord" style="font-size: 12pt">4.25 Create CRM record</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateList" style="font-size: 12pt">4.26 Create list</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.CreateSiteCollection" style="font-size: 12pt">4.27 Create Site Collection</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ExchangeCreateAppointment" style="font-size: 12pt">4.28 Create appointment</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ExchangeCreateTask" style="font-size: 12pt">4.29 Create task</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DecommissionUser" style="font-size: 12pt">4.30 Decommission AD Account</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DecommissionSiteCollection" style="font-size: 12pt">4.31 Decommission Site Collection</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DelayFor" style="font-size: 12pt">4.32 Delay for</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DelayUntil" style="font-size: 12pt">4.33 Delay Until</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DelegateTask" style="font-size: 12pt">4.34 Delegate Task</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DeleteSite" style="font-size: 12pt">4.35 Delete a site</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DeleteADSecurityGroup" style="font-size: 12pt">4.36 Delete AD Group</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DeleteItem" style="font-size: 12pt">4.37 Delete an Item</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DeleteAudience" style="font-size: 12pt">4.38 Delete Audience</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.DeleteCrmRecord" style="font-size: 12pt">4.39 Delete/Disable CRM record</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.EnableLCSOnADAccount" style="font-size: 12pt">4.40 Enable LCS/OCS</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.EndWorkflow" style="font-size: 12pt">4.41 End workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ExecuteSQL" style="font-size: 12pt">4.42 Execute SQL query</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Filter" style="font-size: 12pt">4.43 Filter</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ForEach" style="font-size: 12pt">4.44 For Each</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.GetMeetingSuggestions" style="font-size: 12pt">4.45 Get meeting suggestions</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.LogHistoryList" style="font-size: 12pt">4.46 Log in the History List</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Loop" style="font-size: 12pt">4.47 Loop</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.MathOperation" style="font-size: 12pt">4.48 Math operation</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ProvisionUserOnExchange" style="font-size: 12pt">4.49 Provision User On Exchange</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.QueryBDC" style="font-size: 12pt">4.50 Query BDC</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.QueryCRM" style="font-size: 12pt">4.51 Query CRM</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.QueryExcelServices" style="font-size: 12pt">4.52 Query Excel Services</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.QueryLDAP" style="font-size: 12pt">4.53 Query LDAP</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.QueryList" style="font-size: 12pt">4.54 Query List</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.QueryUserProfile" style="font-size: 12pt">4.55 Query User Profile</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.ReadXML" style="font-size: 12pt">4.56 Query XML</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.RegularExpression" style="font-size: 12pt">4.57 Regular Expression</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.RemoveUserFromADGroup" style="font-size: 12pt">4.58 Remove User From AD Group</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.RequestApproval" style="font-size: 12pt">4.59 Request Approval</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.RequestData" style="font-size: 12pt">4.60 Request Data</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.RequestReview" style="font-size: 12pt">4.61 Request Review</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.RunIf" style="font-size: 12pt">4.62 Run If</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Parallel" style="font-size: 12pt">4.63 Run parallel actions</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SearchQuery" style="font-size: 12pt">4.64 Search Query</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SendReceiveBizTalk" style="font-size: 12pt">4.65 Send / Receive BizTalk Message</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SendNotification" style="font-size: 12pt">4.66 Send notification</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Conditional" style="font-size: 12pt">4.67 Set a condition</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SetVariable" style="font-size: 12pt">4.68 Set a variable</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SetApprovalStatus" style="font-size: 12pt">4.69 Set approval status</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SetField" style="font-size: 12pt">4.70 Set field</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SetItemPermissions" style="font-size: 12pt">4.71 Set item permissions</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.StartWorkflowAction" style="font-size: 12pt">4.72 Start workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.StateMachine" style="font-size: 12pt">4.73 State Machine</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.EndSpecificWorkflow" style="font-size: 12pt">4.74 Stop a workflow</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.SubmitRecord" style="font-size: 12pt">4.75 Submit Record</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.Switch" style="font-size: 12pt">4.76 Switch</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.TaskReminder" style="font-size: 12pt">4.77 Task reminder</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.UpdateADAccount" style="font-size: 12pt">4.78 Update AD Account</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.UpdateCrmRecord" style="font-size: 12pt">4.79 Update CRM record</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.UpdateItem" style="font-size: 12pt">4.80 Update item</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.UpdateUserProfile" style="font-size: 12pt">4.81 Update User Profile</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.UpdateXml" style="font-size: 12pt">4.82 Update Xml</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WaitForUpdate" style="font-size: 12pt">4.83 Wait for an item update</a><br />&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#Nintex.Workflow.WebRequest" style="font-size: 12pt">4.84 Web Request</a><br /><a name="Nintex.Workflow.SectionAdmin"><H1>1 Administration and Configuration</H1></a><a name="Nintex.Workflow.Licensing"><H2>1.1 Licensing settings</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Nintex Workflow uses a license file (.nlf) for server licensing. A single license file is used to store information about all servers in your organisation that are licensed for Nintex Workflow. </p> <h2>Nintex Licensing Options</h2> <p>Nintex Workflow 2007 is available in three editions &ndash; Workgroup, Standard and Enterprise. </p> <h3>Nintex Workflow 2007 &ndash; Enterprise Edition and Standard Edition</h3> <p>A license is required for each SharePoint front-end server where user interaction with Nintex Workflow 2007 components occurs.</p> <p>Please contact our sales team if you need advice at <a href="mailto:sales@nintex.com">sales@nintex.com</a></p> <h3>Nintex Workflow 2007 &ndash; Workgroup Edition</h3> <p>This license covers a single SharePoint front-end server environment with up to five team sites. Only one Workgroup Edition license can be purchased. If more than five site activations or multiple front-end servers are required, a Standard or Enterprise Edition license is required.</p> <p><strong>PLEASE NOTE: </strong>Administrators are able to manage which sites Nintex Workflow has been activated on and deactivate sites that no longer require Nintex Workflow functionality.</p> <p>Please contact our sales team if you need advice at <a href="mailto:sales@nintex.com">sales@nintex.com</a> </p> </div> </DIV><a name="Nintex.Workflow.DatabaseSettings"><H2>1.2 Database settings </H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Database settings&quot; page is available within the servers Central Administration. From the Application Tab you will find a Nintex Workflow Management menu when Nintex is deployed that contains the link to the database settings.</p> <p><img src="content/nintex.workflow.centraladministrationmenu.png" alt="central" height="200" width="253" border="1" /></p> <p>These settings need to be configured second after the licensing but prior to other settings to allow Nintex to store the configuration settings.</p> <p> <img src="content/nintex.workflow.databasesettings1.png" alt="the" height="254" width="600" border="1" /></p> <h3>Configuration Database</h3> <p> <img src="content/nintex.workflow.databasesettings2.png" alt="the" height="326" width="600" border="1" /></p> <p>Each Nintex workflow installation requires that one configuration database be specified to store the server specific configuration settings required for running the application. Click the <img src="content/nintex.workflow.editbutton.png" alt="edit" height="21" width="79" border="0" /> button to configure the connection string for this database. </p> <p>There are essentially two options here, firstly a new database can be created by Nintex, or alternatively an existing database can be used by marking the &quot;Connect to existing database&quot; check box. In each case the properties of the connection string need to be configured. These being the name of the SQL Server database server, the name of the database and the authentication settings.</p> <h3>Content Databases</h3> <p> <img src="content/nintex.workflow.databasesettings3.png" alt="the" height="326" width="600" border="1" /></p> <p>At runtime each workflow requires a content database. Hence at minimum Nintex requires at least one content database to be configured.</p> <p>Again there are essentially two options here, firstly a new database can be created by Nintex, or alternatively an existing database can be used by marking the &quot;Connect to existing database&quot; check box. In each case the properties of the connection string need to be configured. These being the name of the SQL Server database server, the name of the database and the authentication settings.</p> <p>In small farm scenarios it is reasonable to even use the same database for the content and configuration databases. By adding multiple content databases Nintex can automatically distribute the workflows within each site collection to their separate content databases to help spread the load.</p> <h3>KNOWN ISSUE</h3> <table width="90%" border="1" cellspacing="0" cellpadding="3"> <tr> <td width="27%">Title</td> <td width="73%">Error establishing connection to SQL Server</td> </tr> <tr> <td>Problem</td> <td>'An error has occurred while establishing a connection to the server. When connecting to SQL Server, this failure may be caused by the fact that under the default settings SQL Server does not allow remote connections. (provider: Named Pipes Provider, error:40 - Could not open a connection to SQL server)'. </td> </tr> <tr> <td>Resolution</td> <td>If you receive the abovementioned error or something very similar and the default Server name in the Add Configuration Database page is:<br /> &quot;LOCALSERVERNAME\Microsoft##SSEE&quot;, then here is some information.<br /> <br /> When the user has installed SharePoint as standalone and not connected to any existing install of SQL Server, an embedded instance is used called Microsoft##SSEE. This instance is locked down to other applications.<br /> <br /> To install Nintex Workflow 2007, an additional database instance must be installed. This can be SQL 2005 Express which is free and available from:<br /> <br /> <a href="http://www.microsoft.com/downloads/details.aspx?displaylang=en&amp;familyid=220549b5-0b07-4448-8848-dcc397514b41#filelist">http://www.microsoft.com/downloads/details.aspx?displaylang=en&amp;FamilyID=220549B5-0B07-4448-8848-DCC397514B41#filelist</a> <br /> <br /> It can coexist on the same server as SharePoint.<br /> <br /> The Nintex Workflow configuration pages must then be changed to point to this new database. </td> </tr> </table> <p>&nbsp; </p> </div> </DIV><a name="Nintex.Workflow.DatabaseMappings"><H2>1.3 Manage content databases</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Nintex Workflow supports multiple content databases. All data generated from a particular site collection will be stored within a single content database. By default, when a workflow is first run on a site collection, a content database is selected automatically based on how many site collections it already contains.</p> <h2>View database mappings</h2> <p>The view database mappings page is used to determine which workflow content database stores the data for a particular site collection. The page lists all site collections and their corresponding database.</p> <h2>Manage database mappings</h2> <p>The manage database mappings page allows selection of which workflow content database to use when the site collection Feature is activated on a new site collection. This is done per SharePoint content database, so all site collections held within a particular SharePoint content database will use the specified workflow content database. Site collections that already have the workflow Feature activated will not be affected by changes in these settings.</p> </div> </DIV><a name="Nintex.Workflow.WebAppActivation"><H2>1.4 Web Application activation settings</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Web Application Activation&quot; page is available within the server's Central Administration. These settings need to be configured after the <a href="#nintex.workflow.licensing">licensing</a> and after setting <a href="#nintex.workflow.databasesettings">configuration and content databases</a>. From the Application Tab you will find a Nintex Workflow Management menu when Nintex is deployed that contains the link to the web application activation settings.</p> <p><img src="content/nintex.workflow.centraladministrationmenu.png" alt="central" height="200" width="253" border="1" /></p> <p> The default web application name should be chosen automatically - if not, select it using the drop-down, then click the &ldquo;Activate&rdquo; button.</p> <h3><img src="content/nintex.workflow.webappactivation1.png" alt="" height="127" width="600" border="1" /></h3> <p>It is now best to configure the email-related <a href="#nintex.workflow.globalsettings">global settings</a>. </p> </div> </DIV><a name="Nintex.Workflow.WorkflowActions"><H2>1.5 Managing workflow actions</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This page is used to manage the Nintex Workflow actions that are available to workflow designers for the current farm, site collection or site. To modify settings for the farm, access this page from the 'Manage allowed actions' link in Central Administration Application Management. For the site or site collection, access this page via site settings.</p> <p>Check the boxes of the actions you want to appear in the Workflow Designer then click &ldquo;Save&rdquo; (not shown).</p> <p><img src="content/nintex.workflow.workflowactions2.png" alt="" height="279" width="600" border="1" /></p> <p>If an action is not checked it will not be selectable in the workflow designer. If an imported workflow contains an action that is not allowed, the workflow will not save or publish.</p> <h3>Enforce allowed actions at run time</h3> <p>The "Enforce allowed actions at run time" option is available in the Global Settings in Central Administration Application Management. When this option is enabled, a workflow that contains an action that is not marked as "allowed" will cause the workflow to error. The following actions are affected by this option:</p> <ul> <li>Add user to AD group</li> <li>Call web service</li> <li>Compile audience</li> <li>Convert value</li> <li>Copy to fileshare</li> <li>Copy to SharePoint</li> <li>Create a site</li> <li>Create AD account</li> <li>Create AD group</li> <li>Create appointment</li> <li>Create audience</li> <li>Create list</li> <li>Create site collection</li> <li>Create task</li> <li>Decommission site collection</li> <li>Delete a site</li> <li>Decommission AD account</li> <li>Delete AD group</li> <li>Delete audience</li> <li>Enable LCS/OCS</li> <li>Execute SQL</li> <li>Log in the history list</li> <li>Provision User on Exchange</li> <li>Query BDC</li> <li>Query Excel Services</li> <li>Query LDAP</li> <li>Query list</li> <li>Query user profile</li> <li>Query XML</li> <li>Remove User from AD Group</li> <li>Search query</li> <li>Send / Receive BizTalk</li> <li>Send a notification</li> <li>Set approval status</li> <li>Set item permisssions</li> <li>Start workflow</li> <li>Stop a workflow</li> <li>Submit record</li> <li>Update AD account</li> <li>Update user profile</li> <li>Update XML</li> <li>Web request</li> </ul> </div> </DIV><a name="Nintex.Workflow.GlobalSettings"><H2>1.6 Global Settings</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Global Settings&quot; page is used to set Nintex Workflow email settings for all sites in the web farm. The &quot;Global Settings &quot; page is available within the server's Central Administration. These settings need to be configured after <a href="#nintex.workflow.licensing">licensing</a>, setting <a href="#nintex.workflow.databasesettings">configuration and content databases</a> and <a href="#nintex.workflow.webappactivation">Web Application Activation</a>. From the Application Management tab you will find a Nintex Workflow Management menu when Nintex is deployed that contains the link to the Global Settings.</p> <p><img src="content/nintex.workflow.centraladministrationmenu.png" alt="central" height="200" width="253" border="1" /></p> <p> Fill in the appropriate details for your environment and click the OK button.</p> <p><img src="content/nintex.workflow.globalsettings1.png" alt="" height="641" width="600" border="1" /></p> <p>It is now possible to <a href="#nintex.workflow.activating">activate Nintex Workflow 2007 for the SharePoint Site Collection</a>. </p> <p>There are three properties that need to be set here: </p> <ul> <li><strong>Outbound SMTP Server:</strong> This is the mail server through which Nintex will send emails. Please ensure that the SharePoint application pool has permission to use this server as a relay.</li> <li><strong>From address:</strong> This is the email address that is used by the system as the &quot;From: &quot; address for each email notification sent.</li> <li><strong>Reply-to-address:</strong> This email address is set as the &quot;Reply to: &quot; destination address for email notifications sent by the system.</li> </ul> <p>In addition, there are a number of other settings to change global options. Please read the descriptions on the page to understand each option.</p> <p>Global settings are cached and refreshed automatically every 15 minutes. To see changes take affect immediately, perform an IISRESET and restart the Windows SharePoint Services timer service.</p> <h3>Enforce allowed actions at run time</h3> <p>For more information about which actions are affected by this option, see the <a href="#nintex.workflow.workflowactions">Manage allowed actions</a> help file.</p> </div> </DIV><a name="Nintex.Workflow.LazyApprovalSettings"><H2>1.7 Managing LazyApproval settings</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This page is used to manage the words used by the LazyApproval feature of Nintex Workflow 2007. You can edit the current list of recognized terms or add others. For more information please refer to the <a href="#nintex.workflow.lazyapproval">LazyApproval Help Page</a>. </p> <p>LazyApproval must first be enabled for the system. Navigate to SharePoint Central Administration on your server.<br /> <br /> Click the &ldquo;Application Management&rdquo; tab then click on &ldquo;LazyApproval settings &rdquo; in the &ldquo;Nintex Workflow Management&rdquo; section. </p> <p><img src="content/nintex.workflow.lazyapprovalsettings1.png" alt="" height="182" width="424" border="1" /></p> <p>If you see the link &ldquo;Configure server incoming mail settings&rdquo; then those settings are not configured for SharePoint. Please configure them according to your SharePoint configuration documentation. Return to this page after completing your configuration.</p> <p> If those settings are configured, you will instead see the link &ldquo;Enable LazyApproval&rdquo; which you will need to click.</p> <p><img src="content/nintex.workflow.lazyapprovalsettings2.png" alt="" height="148" width="499" border="1" /></p> <p> Now select the &ldquo;Enabled&rdquo; option. You will be asked for an &ldquo;alias&rdquo; which is the name that will be used in the email address that sends the notifications and accepts the LazyApproval replies. There is also the option to change the footer that is appended to LazyAppoval enabled notifications. Press the &ldquo;OK&rdquo; button.</p> <p><img src="content/nintex.workflow.lazyapprovalsettings3.png" alt="" height="201" width="600" border="1" /></p> <p> A list of allowed words will appear which are those that will be recognized by the LazyApproval process. You can add or remove terms at your discretion. To create a new term, click the link &quot;Create a LazyApproval term for the current Farm&quot;. </p> <p><img src="content/nintex.workflow.lazyapprovalsettings4.png" alt="" height="396" width="578" border="1" /></p> <p>You will be prompted to enter a phrase that will be recognized by the LazyApproval system, as well as an outcome (&quot;Approve&quot; or &quot;Deny&quot;). The maximum string length is 255 characters. Click the &quot;OK&quot; button once finished. </p> <p><img src="content/nintex.workflow.lazyapprovalsettings5.png" alt="" height="185" width="600" border="1" /></p> <p>To edit or delete an existing term, click the hyperlink of the term in question and make your changes. Click the &quot;OK&quot; button to commit your changes.</p> <p><img src="content/nintex.workflow.lazyapprovalsettings6.png" alt="" height="224" width="600" border="1" /></p> </div> </DIV><a name="Nintex.Workflow.MessageTemplates"><H2>1.8 Defining message templates</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p> Message templates used by the "Request approval&quot; action can be defined globally for the farm in SharePoint Central Administration, for a specific site collection or for individual sites.</p> <p> <strong>Farm</strong></p> <ol> <li>Navigate to SharePoint Central Administration on your server.</li> <li> Click the &ldquo;Application Management&rdquo; tab then click on &ldquo;Message Templates&rdquo; in the &ldquo;Nintex Workflow Management&rdquo; section. </li> </ol> <p> <strong>Site Collection</strong></p> <ol> <li>Under the Site Actions menu, select Site Settings.</li> <li>Click on Message Templates in the Nintex Workflow group</li> <li>Click Switch to Site Level settings</li> </ol> <p> <strong>Site</strong></p> <ol> <li>Under the Site Actions menu, select Site Settings.</li> <li>Click on Message Templates in the Nintex Workflow group</li> </ol> <p>The Message Templates page will load, showing the current settings for the standard message header and footer. It also displays the current default messages used for the scenarios &quot;Approval Required&quot; and &quot;Approval No Longer Required&quot;. </p> <p>The default content style for the message templates is Rich Text, which provides the opportunity to use different fonts, colours and simpler HTML styles. The SharePoint rich text tool bar is used by Nintex Workflow 2007.</p> <p>For all these templates, you can add information as you see fit. One of the important features is to add content that is dynamically created using "Insert Reference". To insert a reference please refer to the <a href="#nintex.workflow.insertreference">Insert Reference help page</a>.</p> <p>Once you have made all the changes necessary to your templates, click the OK button at the bottom of &quot;Message Templates&quot; page to apply them.</p> <p>PLEASE NOTE: Changes made to the message templates will not affect workflows in progress.&nbsp; Changes will only be seen when new instances of the workflow are started. </p> <h3>Workflow Error & Cancellation Notification Settings</h3> <p>The users who receive email notifications when a workflow errors or is cancelled is configurable at the teamsite level. Options are the user who initated the workflow and/or a specified email address. Notifications can be turned off by unchecking all options.</p> <p><img src="content/nintex.workflow.messagetemplates4.png" alt="" height="83" width="380" border="1" /></p> <p>&nbsp; </p> </div> </DIV><a name="Nintex.Workflow.Activating"><H2>1.9 Activating Nintex Workflow</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>In order to design workflows and interact with Nintex Workflow 2007 (NW2007) the product needs to be activated in any team site where the functionality is required.</p> <p>The first step is to activate the product for the Site Collection (see Step 1 below) and the second and more frequent step is to activate NW2007 per team site (see Step 2 below).</p> <h3>1. Activating NW2007 for the Site Collection</h3> <p>Navigate to your Top Site level home page and click &ldquo;Site Actions &gt; Site Settings&rdquo;:</p> <p><img src="content/nintex.workflow.activating1.png" alt="" height="302" width="340" border="1" /> </p> <p>In the right column, &ldquo;Site Collection Administration&rdquo;, click &ldquo;Site Collection Features&rdquo;:</p> <p><img src="content/nintex.workflow.activating5.png" alt="" height="138" width="600" border="1" /> </p> <p>In the &ldquo;Nintex Workflow 2007&rdquo; section, click the &ldquo;Activate&rdquo; button.</p> <p><img src="content/nintex.workflow.activating6.png" alt="" height="91" width="600" border="1" /> </p> <p>After a short delay, the page will refresh and the status will become &ldquo;Active&rdquo;</p> <p><img src="content/nintex.workflow.activating7.png" alt="" height="90" width="600" border="1" /></p> <p>It is now possible to activate Nintex Workflow 2007&trade; features in team sites.</p> <h3>2. Activating NW2007 in a teamsite </h3> <p> From the Top Site level home page, click &ldquo;Site Actions &gt; Site Settings&rdquo;</p> <p><img src="content/nintex.workflow.activating1.png" alt="" height="302" width="340" border="1" /></p> <p> In the right column, &ldquo;Site Administration&rdquo;, click &ldquo;Site Features&rdquo;.</p> <p><img src="content/nintex.workflow.activating2.png" alt="" height="134" width="600" border="1" /></p> <p> In the Nintex Workflow 2007&trade; section, click the &ldquo;Activate&rdquo; button.</p> <p><img src="content/nintex.workflow.activating3.png" alt="" height="87" width="600" border="1" /></p> <p> After a short delay, the page will refresh and the status will become &ldquo;Active&rdquo;.</p> <p><img src="content/nintex.workflow.activating4.png" alt="" height="91" width="600" border="1" /></p> <p><br /> </p> </div> </DIV><a name="Nintex.Workflow.UserPreferences"><H2>1.10 Configuring user preferences</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Nintex Workflow 2007 notifications can be sent via email, Live Communication Server or SMS, depending on how your environment is configured. Each user can then set their preferred method of notification for both business hours and after hours.</p> <p>To set your personal preferences, activate the drop down from the logged-in user name link at the top of a page, mouse-over Nintex Workflow 2007 then select &quot;Manage Notification Preferences&quot;.</p> <p><img src="content/nintex.workflow.userpreferences1.png" alt="" height="315" width="514" border="1" /></p> <p>There is a section each for your Business hours notification preference and your After hours notification preference. The default settings are &quot;Email&quot;. Make your selection from the drop-down according to the options available to you in your network. </p> <p><img src="content/nintex.workflow.userpreferences2.png" alt="" height="197" width="600" border="1" /></p> <p>The settings for Email and LCS are automatically determined by the account you are using to login. If you choose SMS, you will be prompted for an SMS address.</p> <p><img src="content/nintex.workflow.userpreferences3.png" alt="" height="232" width="600" border="1" /></p> <p>The SMS address is often something like your mobile telephone number plus a domain. However, to ensure you supply the correct address, please contact your System Administrator or equivalent for the right format and settings. </p> <p><strong>PLEASE NOTE: </strong>Nintex does not provide support for troubleshooting Email, SMS or LCS systems. </p> <p>When you are finished, click the &quot;OK&quot; button to return to your original page.</p> </div> </DIV><a name="Nintex.Workflow.SecuritySettings"><H2>1.11 Security Settings</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>According to how a user is required to interact with Nintex Workflow 2007 there are different security considerations to be made. The table below outlines the minimum permissions required to perform the actions described. In general, the runtime permissions can be inherited from the site or the parent site but must be the effective permissions for the given user at the list level. </p> <table border="1" cellpadding="5" cellspacing="0" bordercolor="#333333" style="width: 100%"> <tr> <td width="20%"><strong>Nintex Role</strong></td> <td width="35%"><strong>Required &quot;SharePoint Permission Level"</strong></td> <td width="45%"><strong>Note</strong></td> </tr> <tr> <td width="20%" valign="top">Approver/Reviewer</td> <td width="35%" valign="top">Contribute (at the item level at least)</td> <td width="45%" valign="top" style="width: 262px">This role includes all users who will be able to perform their assigned human task as part of the workflow from the SharePoint site. Users may be assigned tasks even without these permissions.</td> </tr> <tr> <td width="20%" valign="top">Lazy Approver</td> <td width="35%" valign="top">None</td> <td width="45%" valign="top" style="width: 262px">This role includes all users who will perform a <a href="#nintex.workflow.lazyapproval">Lazy Approval</a> for their assigned task. The user however will need at least &quot;Read&quot; permissions if they wish to visit the site.</td> </tr> <tr> <td width="20%" valign="top">Workflow Designer</td> <td width="35%" valign="top">Design</td> <td width="45%" valign="top" style="width: 262px">This role includes all users who are responsible for creating and maintaining workflows. With these permissions the user can use the Nintex Workflow designer as well as the related tools and pages. In order to be able to <strong>publish</strong> a workflow, the user will need to be configured as a <a href="#cawd">workflow designer.</a></td> </tr> <tr> <td width="20%" valign="top">Site Administrator</td> <td width="35%" valign="top">Full Control (on the site)</td> <td width="45%" valign="top" style="width: 262px">This role is responsible for activating and configuring the site level Nintex Workflow settings from the &quot;Site Settings&quot; page.</td> </tr> <tr> <td width="20%" valign="top">Server Administrator</td> <td width="35%" valign="top">Full Control (on the central administration site)</td> <td width="45%" valign="top" style="width: 262px">This role is responsible for the installation and the server level configuration of Nintex Workflow.</td> </tr> <tr> <td valign="top" width="20%"> Workflow user</td> <td valign="top" width="35%"> Contribute</td> <td style="width: 262px" valign="top" width="45%">Can start workflows, add schedules, view history and progress reports.</td> </tr> </table> <p> <strong>Configuring Allowed Workflow Designers</strong></p> <p>There is a know permissions quirk with SharePoint 2007 workflows created using either Nintex Workflow or SharePoint designer.</p> <p>There is a Workflows list which is used to hold all defined workflows for a team site.&nbsp; Upon creating your first workflow in SPD or activating the NW2007 feature, this list is given unique permissions, copying those currently given to the team site.&nbsp; As a result, the only people who will be able to modify permissions on this list are site owners or those who were given explicit 'Full Control' access before the list was created.</p> <p>To add/remove users as designers, the user assigning the permissions must be a site owner or have Full Control access to the Workflows list. Therefore we have exposed the list through the user interface to work around the problem. </p> <p>To add a user or group to the workflow designers group you will require Site Administrator rights. </p> <p>Activate the &quot;Site Actions&quot; button's drop down then select &quot;Site Settings&quot;. In the Nintex Workflow section, click the link &quot;Allowed workflow designers&quot;.</p> <p><img src="content/nintex.workflow.securitysettings2.png" alt="the" height="186" width="156" border="1" /></p> <p>From the permissions page below the members can be maintained by adding them in the standard SharePoint manner. Please ensure that users who require full access to the designer have &quot;Full Control&quot; set as their permissions. </p> </div> </DIV><a name="Nintex.Workflow.PurgeWorkflowData"><H2>1.12 Purge Workflow Data</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p> The <b>Purge workflow data</b> provides the option to delete historic data from the Nintex Workflow database. This option is also available as a NWAdmin operation. Reasons that data may need to be removed: </p> <ul> <li>Deleting old data to decrease the size of the Nintex Workflow content database(s).</li> <li>Deleting data added during testing of a workflow.</li> <li>Deleting data from lists that have been deleted.</li> </ul> <p> Workflow data can be purged globally for the web farm, a specific site collection or individual sites.</p> <p> To purge workflow data for the web farm:</p> <ul> <li>Navigate to <b>SharePoint Central Administration</b>.</li> <li>Click on <b>Application Management</b> tab, in the <b>Nintex Workflow Management</b> section, click on <b>Purge workflow data</b>.</li> </ul> <p> To purge workflow data for the site collection:</p> <ul> <li>Navigate to the top level site home page.</li> <li>In the <b>Site Actions</b> menu, click on <b>Site Settings</b>.</li> <li>In the Nintex Workflow section, click on <b>Purge workflow data</b>.</li> <li>Click on <b>Switch to site collection settings</b>.</li> </ul> <p> To purge workflow data for a site:</p> <ul> <li>Navigate to the top level site home page.</li> <li>In the <b>Site Actions</b> menu, click on <b>Site Settings</b>.</li> <li>In the Nintex Workflow section, click on <b>Purge workflow data</b>.</li> </ul> <p><img src="content/nintex.workflow.purgeworkflowdata1.png" alt="" height="314" width="600" border="0" /></p> <p> To purge workflow data:</p> <p> Navigate to the <b>Purge workflow data</b> settings.</p> <ul> <li>In the <b>Select workflow instances to purge</b>, specify filters to select the workflow instances for which data will be purged.</li> <li><b>Where the list or library has been deleted</b>: removes historic data for any workflows that are associated to a list that has been deleted.</li> <li><b>Use custom filter</b>: set the filter parameters</li> <ul> <li><b>Initiator is</b>: removes historic data for workflows that were started by a specific user.</li> <li><b>Instance ID is</b>: removes historic data for a specified workflow instance where the instance ID matches the GUID.</li> <li><b>Last activity is before</b>: removes historic data for workflow where the last action was before a specific time, specified in server local time.</li> <li><b>List ID is</b>: removes historic data for workflows associated with a specific internal GUID of a list.</li> <li><b>List name is</b>: removes historic data for workflows associated with a specific list name. Please note that this option is only available when purging workflow data on a site level.</li> <li><b>State is</b>: removes historic data for workflows with a specific state (Completed, Cancelled, Error).</li> <li><b>Workflow name is</b>: removes historic data for workflows with a specific name.</li> </ul> <li>Click on <b>Query</b>. This will provide a preview of the database entries matching all entered criteria.</li> <li>Click on <b>Purge</b>. This will delete historic data as specified from the content database(s).</li> </ul> <p> Note: Once data has been purged, it cannot be recovered without restoring a backed up version of the Nintex Workflow content database.</p> </div> </DIV><a name="Nintex.Workflow.WorkflowErrorNotification"><H2>1.13 Workflow Error Notifications</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p> The <b>Workflow error notification</b> settings provides the options to specify to whom workflow error and cancellation notifications are sent.</p> <p> Workflow error and cancellation notification can be set globally for the web farm, a specific site collection or individual sites.</p> <p> To set the workflow notification settings for the web farm:</p> <ul> <li>Navigate to <b>SharePoint Central Administration</b>.</li> <li>Click on <b>Application Management</b> tab, in the <b>Nintex Workflow Management</b> section, click on <b>Workflow error notifications</b>.</li> </ul> <p> Note: By default the settings will inherit from the parent settings. A site will inherit its settings from the site collection and a site collection from the farm. If the setting is changed at a specific level, it will no longer inherit the settings from the parent.</p> <p> To set the workflow notification settings for the site collection:</p> <ul> <li>Navigate to the top level site home page.</li> <li>In the <b>Site Actions</b> menu, click on <b>Site Settings</b>.</li> <li>In the Nintex Workflow section, click on <b>Workflow error notifications</b>.</li> <li>Click on <b>Switch to site collection level settings</b>.</li> </ul> <p> To set the workflow notification settings for a site: </p> <ul> <li>Navigate to the site level home page.</li> <li>In the <b>Site Actions</b> menu, click on <b>Site Settings</b>.</li> <li>In the Nintex Workflow section, click on <b>Workflow error notifications</b>.</li> </ul> <h3> Workflow Error and Cancellation Notification Settings</h3> <p> The <b>Send notifications to the workflow initiator</b> option notifies the user who started the workflow if the workflow errors or is cancelled.</p> <p> For additional users to be notified when a workflow errors or is cancelled, specify the email address of the user in the <b>Specify other email addresses that will receive the notifications</b> text field.</p> <p> Notifications can be turned off by selecting <b>No</b> for <b>Send notifications to the workflow initiator</b> and leaving the <b>Specify other email addresses that will receive the notifications</b> text field empty.</p> <p><img src="content/nintex.workflow.workflowerrornotification1.png" alt="" height="287" width="600" border="0" /></p> </div> </DIV><a name="Nintex.Workflow.SectionUsing"><H1>2 Using the Workflow Designer</H1></a><a name="Nintex.Workflow.WorkflowDesigner"><H2>2.1 Getting started with the Nintex Workflow designer</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Getting started with the Nintex Workflow designer</p> <h2>Creating a workflow </h2> <p>There are two ways to create a workflow. First, navigate to a library or list then click the &quot;Settings&quot; button. Then:</p> <ol> <li> Select the &quot;Create Workflow&quot; option. The Workflow Designer page will load with the <a href="#nintex.workflow.templates">Workflow Template</a> picker at the front.<br /> <img src="content/nintex.workflow.workflowdesigner02.png" alt="" height="46" width="250" border="1" /></li> <li>Select the &quot;Manage Workflows&quot; option. The Workflow Gallery page will load. You can then select &quot;Create&quot; from near the top of the page.<br /> <img src="content/nintex.workflow.workflowdesigner01.png" alt="" height="46" width="250" border="1" /><br /> <br /> <img src="content/nintex.workflow.workflowdesigner03.png" alt="" height="99" width="344" border="1" /></li> </ol> <h2>The Workflow Designer canvas </h2> <p>Once you have arrived at the workflow designer page, you will see two major sections. At the left of the page is the &quot;Workflow Actions&quot; palette and the section on the right (occupying the majority of the page) is the design canvas.</p> <h3>The Workflow Actions palette </h3> <p>The actions palette displays the activities that can be used in the design canvas to create workflows. The actions are divided into groups of related actions. Click the heading of a group to expand it and close the one that is currently open. The default groupings are:</p> <ul> <li>Commonly used</li> <li>Integration</li> <li>Libraries and lists</li> <li>Logic and flow</li> <li>Operations</li> <li>Provisioning</li> <li>Publishing</li> <li>Sites and workspaces</li> <li>SharePoint profiles</li> <li>User interaction</li> <li><a href="#nintex.workflow.snippets">My Snippets</a> (after a snippet has first been created) </li> </ul> <p><img src="content/nintex.workflow.workflowdesigner0.png" alt="" height="365" width="157" border="1" /></p> <p>The names of workflow actions and the groupings can be edited by an administrator. For more information please refer to the <a href="#nintex.workflow.workflowactions">Managing workflow actions help page</a>. </p> <h3>Floating the Actions palette </h3> <p>If you design a complex workflow, the Actions palette can become lost because as the page requires scrolling down, the palette remains anchored to the top of the page. To overcome the problem there are two solutions:</p> <ol> <li>Detach the palette from the left navigation area by clicking the pin at the top.<img src="content/nintex.workflow.workflowdesigner3.png" alt="" height="18" width="18" border="0" />The palette will then float and can be dragged around the page. Click the pin again to reattach it to the left navigation area.<img src="content/nintex.workflow.workflowdesigner4.png" alt="" height="19" width="18" border="0" /></li> </ol> <h3>Adding actions to the design canvas</h3> <p>To design a workflow, you need to add actions to it. That is done visually in one of two ways:</p> <ol> <li>Left click and drag an action from the palette and drop it onto a blue &quot;pearl&quot; on the design canvas.<img src="content/nintex.workflow.workflowdesigner1.png" alt="" height="17" width="23" border="0" /></li> <li>Right-click a pearl on the design canvas, mouse-over &quot;Insert Action&quot; and select the action you require from the list.</li> </ol> <p><img src="content/nintex.workflow.workflowdesigner2.png" alt="" height="252" width="299" border="1" /></p> <h3>Configuring actions </h3> <p>To change the settings used by the action, left click in the action's title bar to activate an item's drop-down. You will see a number of options:</p> <p> <strong>Configure:</strong> allows you to configure the various options that define how the action will work.</p> <p><strong>Edit Labels:</strong> When a workflow action is added to the design canvas, it appears with a frame around it and a title bar. There are four areas in which labels can be applied. The title bar is the most obvious, and there are editable areas under the action icon as well as to the left and right. Custom labels can be added according to your preferences, including in the title bar. There is no maximum length for the labels, however they are most effective when they are as short as possible or at least of similar lengths on both the left and right. </p> <p><strong>Copy:</strong> The Copy function allows you to copy an action, with all its configuration settings, and paste it in another location on the design canvas. This function can be especially useful when using the &quot;Send a notification&quot; action which is likely appear a number of times when dealing with documents and approvals. Once you select &quot;Copy&quot;, find the appropriate pearl on the design canvas, right-click it and select &quot;Paste&quot;. The configuration of the pasted action can then be modified independently of the original. </p> <p><strong>Delete:</strong> Selecting delete will remove the action and any modifications made to it from the workflow. </p> <h3>Zoom Options</h3> <p>Click the zoom buttons on the top right of the design canvas to increase or decrease the designer canvas viewing size. Click <b>1:1</b> button to restore the view to its normal state. </p> <p><img src="content/nintex.workflow.workflowdesigner7.png" alt="" height="28" width="103" border="1" /></p> <p>At the top of the design canvas are two buttons, &quot;Actions&quot; and Settings&quot;. The options and related Help files are all listed below.</p> <h2>The Actions button </h2> <ul> <li><strong>New:</strong> Clicking &quot;New&quot; will clear the current design canvas and load the <a href="#nintex.workflow.workflowgallery">Workflow Gallery</a> </li> <li><strong>Open:</strong> Please refer to <a href="#nintex.workflow.opensave">Opening and saving workflows</a> </li> <li><strong>Save:</strong> Please refer to <a href="#nintex.workflow.opensave">Opening and saving workflows</a></li> <li><strong>Save As:</strong> Allows two options, to save as a &quot;Snippet&quot; (see <a href="#nintex.workflow.snippets">Workflow Snippets</a>) or a Template (see <a href="#nintex.workflow.templates">Workflow Templates</a>) </li> <li><strong>Publish:</strong> Please refer to <a href="#nintex.workflow.publishing">Publishing a workflow</a> </li> <li><strong>Print:</strong> Please refer to <a href="#nintex.workflow.print">Printing</a> </li> <li><strong>Export:</strong> Please refer to <a href="#nintex.workflow.importexport">Importing and exporting workflows</a> </li> <li><strong>Import:</strong> Please refer to <a href="#nintex.workflow.importexport">Importing and exporting workflows</a></li> </ul> <p><img src="content/nintex.workflow.workflowdesigner5.png" alt="" height="316" width="252" border="0" /></p> <h2>The Settings Button </h2> <ul> <li><strong>Title and description:</strong> The title of the workflow and its description appear when selecting a workflow in libraries and lists and can be important to ensure clarity amongst users that select workflows. </li> <li><strong>Startup Options:</strong> Please refer to <a href="#nintex.workflow.startoptions">Workflow start options</a> </li> <li><strong>Start Data:</strong> Please refer to <a href="#nintex.workflow.startdata">Workflow start data </a></li> <li><strong>Workflow Variables:</strong> Please refer to <a href="#nintex.workflow.workflowvariables">Workflow variables </a></li> </ul> <p><img src="content/nintex.workflow.workflowdesigner6.png" alt="" height="184" width="254" border="0" /></p> <p>&nbsp; </p> </div> </DIV><a name="Nintex.Workflow.ErrorHandling"><H2>2.2 Error Handling</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The error handling panel available in some actions allows the workflow designer to capture errors that occur during the execution of the action, and create their own logic to handle it.</p> <p> <img src="content/nintex.workflow.errorhandling1.png" alt="the" height="166" width="551" border="0" /> </p> <h2>Error handling options</h2> <h3>Capture Errors</h3> <p>This option specifies whether or not to turn on capturing of errors. If this option is set to 'Yes' an error in the action will no longer cause the workflow to fail. Instead, the values described in the next two sections will be populated. This option can be set explicitly or a Yes / No workflow variable can be used.</p> <h3>Store error occurrence in</h3> <p>A yes / no workflow variable that will store whether or not an error has occurred. The variable will be set to Yes if an error occurred and No if the action execution completed.</p> <h3>Store error text in</h3> <p>A text workflow variable that will store details of an error if one occurs. This value will be set to empty if no error occurs.</p> <p>The error occurrence and error text workflow variables will not be modified if Capture Errors is set to No.</p> </div> </DIV><a name="Nintex.Workflow.HomeServerPicker"><H2>2.3 Home Server Picker</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p>Many activities require connection information to lookup Active Directory.</p> <p>The Enable LCS/OCS Activity requires an LDAP address in order to specify the Primary Home Server. Generally, this will be an object called "LC Services"</p> <p>When the HomeServer Picker is initially opened, it will attempt to connect to Active Directory using the information in the Activity dialog "LDAP Path" text box. It will then attempt to find any available "LC Services" folders. An error will occur if further credentials are required.</p> <p>Select an "LC Services" object by clicking on it, then press the "Close" button. The selected object will be pasted into the Activity dialog window.</p> <p><img src="content/nintex.workflow.homeserverpicker1.png" alt="" height="468" width="596" border="1" /></p> <h2>Options within this action</h2> <h3>LDAP Path</h3> <p>An LDAP path specifying the Active Directory location. E.g. LDAP://Nintex.com/DC=nintex,DC=com</p> <p>If your domain name is MyCompany.com, then the LDAP Path will be LDAP://MyCompany.com/DC=MyCompany,DC=com</p> <p>You can specify Containers or organizationalUnits by adding "CN=" or "OU=". E.g. LDAP://MyCompany.com/CN=Users,DC=MyCompany,DC=com or LDAP://MyCompany.com/OU=Servers,DC=MyCompany,DC=com</p> <h3>Username</h3> <p>A username with the required permissions to access the LDAP Path entered.</p> <h3>Password</h3> <p>A password for the above username.</p> <p>Click on the padlock to select from a list of Credential Workflow Constants, maintained in Site Settings by your system administrator.</p> <p><img src="content/nintex.workflow.homeserverpicker2.png" alt="" height="317" width="433" border="1" /></p> <h2>Accessing the HomeServer Picker</h2> <p>The HomeServer Picker is available from the following dialogs: <ul> <li>Provisioning Activities - Enable LCS/OCS</li> </ul> </p> </div> </DIV><a name="Nintex.Workflow.ImportExport"><H2>2.4 Importing and exporting workflows</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Using the import or export workflow option will enable you to either convert the workflow currently displayed in the design canvas into a file or open a file of the same format in the design canvas.</p> <h3>Exporting a workflow</h3> <p>A workflow can be exported and saved in the file format &quot;.nwf&quot; in order to be used in another location. To export a workflow, click the &quot;Actions&quot; button at the top of the design canvas then select &quot;Export&quot;.</p> <p><img src="content/nintex.workflow.importexport2.png" alt="" height="44" width="257" border="1" /></p> <p>You will be prompted about downloading the file that you create and its filename will be inherited from the title of the workflow. If you have not specified a title, the default value of &quot;Newworkflow.nwf&quot; will be used. Click the &quot;Save&quot; button then choose a location for the file. </p> <h3>Importing a workflow</h3> <p>To import a workflow to a library or list, navigate to the library or list in question. You will then need to create a workflow.</p> <p>There are two ways to create a workflow. First, navigate to a library or list then click the &quot;Settings&quot; button. Then:</p> <ol> <li> Select the &quot;Create Workflow&quot; option. The Workflow Designer page will load with the Workflow Template picker at the front.<br /> <img src="content/nintex.workflow.workflowdesigner02.png" alt="" height="46" width="250" border="1" /></li> <li>Select the &quot;Manage Workflows&quot; option. The Workflow Gallery page will load. You can then select &quot;Create&quot; from near the top of the page.<br /> <img src="content/nintex.workflow.workflowdesigner01.png" alt="" height="46" width="250" border="1" /><br /> <br /> <img src="content/nintex.workflow.workflowdesigner03.png" alt="" height="99" width="344" border="1" /></li> </ol> <p>Now click the &quot;Actions&quot; button at the top of the design canvas then select &quot;Import &gt; From file&quot;. </p> <p><img src="content/nintex.workflow.importexport1.png" alt="" height="40" width="506" border="1" /></p> <p>Locate the file using the file system then click the &quot;Import&quot; button. </p> <p>PLEASE NOTE: Only workflows created by Nintex Workflow 2007 can be imported. </p> <p>The previously designed workflow, with all its settings should now be displayed on the design canvas. All actions can be re-configured to your specifications. </p> </div> </DIV><a name="Nintex.Workflow.ImportSLWorkflow"><H2>2.5 Importing a SmartLibrary workflow</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Import a SmartLibrary workflow</p> <p>Nintex Workflow can read workflow files that have been exported from SmartLibrary 2.1 and generate a workflow with similar functionality. </p> <h3>Importing a SmartLibrary workflow</h3> <p>Navigate to the library or list in question. You will then need to create a workflow.</p> <p>There are two ways to create a workflow. First, navigate to a library or list then click the &quot;Settings&quot; button. Then:</p> <ol> <li> Select the &quot;Create Workflow&quot; option. The Workflow Designer page will load with the Workflow Template picker at the front.<br /> </li> <li>Select the &quot;Manage Workflows&quot; option. The Workflow Gallery page will load. You can then select &quot;Create&quot; from near the top of the page. <br /> </li> </ol> <p>Now click the &quot;Actions&quot; button at the top of the design canvas then select &quot;Import &gt; From SmartLibrary&quot;. </p> <p>Locate the previously exported SmartLibrary XML file using the file system then click the &quot;Import&quot; button. </p> <p>PLEASE NOTE: due to vastly different architectures, some features that were available in SmartLibrary have no equivalent in Nintex Workflow. Most notable is the &#8216;user choose approver&#8217; option, authenticating as the last approver and the ability to force a workflow to restart if the item is modified. </p> <p>After importing a SmartLibrary workflow, a summary will display to outline any issues. </p> </div> </DIV><a name="Nintex.Workflow.InlineFunctions"><H2>2.6 Inline functions</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>In any text input that supports <a href="#nintex.workflow.insertreference">inserting references</a>, an inline function can be entered that will evaluate when the workflow runs.</p> <p>A number of functions are provided out of the box, and additional functions can be added with the NWAdmin.exe tool. See the <a href="http://www.nintex.com/en-us/support/pages/workflow2007sdk.aspx">Nintex Workflow 2007 SDK</a> for more information.</p> <p>Functions can also be used as arguments for other functions.</p> <p><img src="content/nintex.workflow.inlinefunctions1.png" alt="example" height="179" width="576" border="0" /></p> <h3>Function behavior</h3> <p>The parsing engine first replaces any inserted reference tokens, and then the resulting text is evaluated for functions. If a function contains another function as an argument, the inner most function will be evaluated first. As reference tokens are replaced first, the reference token can also contain function syntax that will be evaluated. If text used for a function argument contains function syntax (i.e. a brace or comma character) but is not intended to be interpreted by the parser, wrap the text with {TextStart} and {TextEnd} markers to inform the parser that the block should only be treated as text and not evaluated. For example, if a number variable that contains a decimal value is passed to the function, and the decimal separator for your region is a comma, the {TextStart} and {TextEnd} tokens will need to be used.</p> <h2>Function reference</h2> <h3>fn-Abs</h3> <p>Returns the absolute value of a number.</p> <p><b>Example</b></p> <p>fn-Abs({WorkflowVariable:Number})</p> <p><b>Arguments</b></p> <ul> <li><b>Number</b> The number to return the absolute value of.</li> </ul> <h3>fn-Currency</h3> <p>Represents a numeric value as a currency formatted text.</p> <p><b>Example</b></p> <p>fn-Currency({WorkflowVariable:Cost})</p> <p><b>Arguments</b></p> <ul> <li><b>Number</b> A variable containing a numeric value.</li> </ul> <h3>fn-DateDiffDays</h3> <p>Determines the number of days between two dates. The result can be a decimal value including partial days.</p> <p><b>Example</b></p> <p>fn-DateDiffDays({WorkflowVariable:StartDate}, {WorkflowVariable:EndDate})</p> <p><b>Arguments</b></p> <ul> <li><b>Start date</b> The starting date and time to calculate the difference between.</li> <li><b>End date</b> The end date and time to calculate the difference between.</li> </ul> <h3>fn-DateDiffHours</h3> <p>Determines the number of hours between two dates. The result can be a decimal value including partial hours.</p> <p><b>Example</b></p> <p>fn-DateDiffHours({WorkflowVariable:StartDate}, {WorkflowVariable:EndDate})</p> <p><b>Arguments</b></p> <ul> <li><b>Start date</b> The starting date and time to calculate the difference between.</li> <li><b>End date</b> The end and time date to calculate the difference between.</li> </ul> <h3>fn-DateDiffMinutes</h3> <p>Determines the number of minutes between two dates. The result can be a decimal value including partial minutes.</p> <p><b>Example</b></p> <p>fn-DateDiffMinutes({WorkflowVariable:StartDate}, {WorkflowVariable:EndDate})</p> <p><b>Arguments</b></p> <ul> <li><b>Start date</b> The starting date and time to calculate the difference between.</li> <li><b>End date</b> The end and time date to calculate the difference between.</li> </ul> <h3>fn-DateDiffSeconds</h3> <p>Determines the number of seconds between two dates. The result can be a decimal value including partial seconds.</p> <p><b>Example</b></p> <p>fn-DateDiffSeconds({WorkflowVariable:StartDate}, {WorkflowVariable:EndDate})</p> <p><b>Arguments</b></p> <ul> <li><b>Start date</b> The starting date and time to calculate the difference between.</li> <li><b>End date</b> The end and time date to calculate the difference between.</li> </ul> <h3>fn-FormatDate</h3> <p>Represents a date time value in text of a specific format.</p> <p><b>Example</b></p> <p>fn-FormatDate({WorkflowVariable:MyDate}, d)</p> <p><b>Arguments</b></p> <ul> <li><b>Date</b> A variable containing a date value.</li> <li><b>Format string</b> Text describing how the date time value should be formatted. Information on how to format the value can be found on this page: <a href="http://msdn.microsoft.com/en-us/library/az4se3k1.aspx" target="_blank">Standard Date and Time Format Strings</a> and this page <a href="http://msdn.microsoft.com/en-us/library/8kb3ddd4.aspx" target="_blank">Custom Date and Time Format Strings</a>.</li> </ul> <h3>fn-Insert</h3> <p>Adds text in to a larger string.</p> <p><b>Example</b></p> <p>fn-Insert({WorkflowVariable:Text}, 4, {ItemProperty:Title})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to modify.</li> <li><b>Start position</b> The character position to insert the new text at. The first character in the string is at position 0.</li> <li><b>New text</b> The additional text that will be added at the start position.</li> </ul> <h3>fn-Length</h3> <p>Returns the number of characters in a string.</p> <p><b>Example</b></p> <p>fn-Length({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The string to count the characters of.</li> </ul> <h3>fn-Max</h3> <p>Returns the greater of two numbers.</p> <p><b>Example</b></p> <p>fn-Max({WorkflowVariable:Number1}, {WorkflowVariable:Number2})</p> <p><b>Arguments</b></p> <ul> <li><b>Number 1</b> The first number to compare.</li> <li><b>Number 2</b> The second number to compare.</li> </ul> <h3>fn-Min</h3> <p>Returns the lesser of two numbers.</p> <p><b>Example</b></p> <p>fn-Min({WorkflowVariable:Number1}, {WorkflowVariable:Number2})</p> <p><b>Arguments</b></p> <ul> <li><b>Number 1</b> The first number to compare.</li> <li><b>Number 2</b> The second number to compare.</li> </ul> <h3>fn-NewGuid</h3> <p>Generate a globally unique identifier.</p> <p><b>Example</b></p> <p>fn-NewGuid()</p> <h3>fn-PadLeft</h3> <p>Returns the provided string right aligned and padded to the total length with a specific character.</p> <p><b>Example</b></p> <p>fn-PadLeft({WorkflowVariable:Text}, 6)</p> <p>fn-PadLeft({WorkflowVariable:Text}, 6,-)</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The string to pad.</li> <li><b>Length</b> The target total length of the padded result.</li> <li><b>Character</b> Optional. The character to pad the original string with. A space character is used by default.</li> </ul> <h3>fn-PadRight</h3> <p>Returns the provided string left aligned and padded to the total length with a specific character.</p> <p><b>Example</b></p> <p>fn-PadRight({WorkflowVariable:Text}, 6)</p> <p>fn-PadRight({WorkflowVariable:Text}, 6,-)</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The string to pad.</li> <li><b>Length</b> The target total length of the padded result.</li> <li><b>Character</b> Optional. The character to pad the original string with. A space character is used by default.</li> </ul> <h3>fn-Power</h3> <p>Raises a number to the specified power.</p> <p><b>Example</b></p> <p>fn-Power({WorkflowVariable:Number}, {WorkflowVariable:Power})</p> <p><b>Arguments</b></p> <ul> <li><b>Number</b> The number to raise to the power.</li> <li><b>Number</b> The power to raise number to.</li> </ul> <h3>fn-Remove</h3> <p>Removes a section of text in a larger string.</p> <p><b>Example</b></p> <p>fn-Remove({WorkflowVariable:Text},xxx,{ItemProperty:Title})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to modify.</li> <li><b>Start position</b> The character position from which to remove the following characters. The first character in the string is at position 0.</li> <li><b>Length</b> Optional. The number of characters from the start position to remove. All remaining characters will be removed by default.</li> </ul> <h3>fn-Replace</h3> <p>Replaces a section of text in a larger string.</p> <p><b>Example</b></p> <p>fn-Replace({WorkflowVariable:Text},xxx,{ItemProperty:Title})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to modify.</li> <li><b>Old value</b> The text to search for and replace.</li> <li><b>New value</b> The text to replace Old value with.</li> </ul> <h3>fn-Round</h3> <p>Rounds a decimal value to the nearest integer.</p> <p><b>Example</b></p> <p>fn-Round({WorkflowVariable:Number})</p> <p><b>Arguments</b></p> <ul> <li><b>Number</b> The decimal number to round.</li> </ul> <h3>fn-SubString</h3> <p>Extracts a portion of text from a string.</p> <p><b>Example</b></p> <p>fn-SubString({WorkflowVariable:Text},5,10)</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to extract a value from</li> <li><b>Start index</b> The position in the text of the first character to retrieve. The first character in the string is at position 0.</li> <li><b>Number of characters</b> The number of characters to retrieve from the start index.</li> </ul> <h3>fn-ToLower</h3> <p>Formats text in a string to all lower case.</p> <p><b>Example</b></p> <p>fn-ToLower({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The string to convert to all lower case.</li> </ul> <h3>fn-ToTitleCase</h3> <p>Formats text in a string to title case.</p> <p><b>Example</b></p> <p>fn-ToTitleCase({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The string to convert to title case.</li> </ul> <h3>fn-ToUpper</h3> <p>Formats text in a string to all upper case.</p> <p><b>Example</b></p> <p>fn-ToUpper({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The string to convert to all upper case.</li> </ul> <h3>fn-Trim</h3> <p>Removes leading and trailing whitespace from a string.</p> <p><b>Example</b></p> <p>fn-Trim({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to remove leading and trailing whitespace characters from.</li> </ul> <h3>fn-XmlEncode</h3> <p>Encodes a string to make it safe for viewing in html.</p> <p><b>Example</b></p> <p>fn-XmlEncode({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to encode.</li> </ul> <h3>fn-XmlDecode</h3> <p>Decodes a html safe string to regular text.</p> <p><b>Example</b></p> <p>fn-XmlDecode({WorkflowVariable:Text})</p> <p><b>Arguments</b></p> <ul> <li><b>Text</b> The text to decode.</li> </ul> </div> </DIV><a name="Nintex.Workflow.InsertReference"><H2>2.7 Inserting reference fields</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p> By using references you can construct text for use within workflow actions containing context specific information pertaining to the list item and this instance of the workflow. To insert a reference either double click on an item from the list or select the item and click on the &quot;Insert&quot; button.</p> <p> <img src="content/nintex.workflow.insertreference1.png" alt="insert" height="533" width="449" border="1" /></p> <p> Reference information is divided into 3 categories:</p> <ul> <li><strong>Common:</strong> these are lookup values specific to the workflow, the context of the item and the current task within the workflow.</li> <li><strong>Item Properties:</strong> these are meta data columns for the item the workflow is attached to.</li> <li><strong>Workflow Variables:</strong> these are the <a href="#nintex.workflow.workflowvariables"> internal workflow variables</a> configured for the workflow.</li> </ul> <h3> Create a hyperlink built from this data</h3> <p> <img src="content/nintex.workflow.insertreferencehyperlink.png" alt="the" height="205" width="408" border="1" /></p> <p> When inserting a reference into a Rich Text box you can insert hyperlinks. Once you select the create hyperlink option you will see two fields to contain the address and display text of the hyperlink. By placing the cursor within one of the fields, selecting items from the property list and clicking on the &quot;Add&quot; button you can build each of these values with a combination of lookup data and plain text typed manually.</p> <p> You can also enter display text to be displayed in place of the hyperlink. To complete the reference, click the "Insert" button at the bottom of the pop-up window.</p> <p> A third option for the hyperlink, in which any of the references can be used, is to add a starting URL (for example a portal search address or a Google search address) and then add the lookup reference to it. Remember to use the correct protocol (http:// or https:// etc). To complete the reference, click the "Insert" button at the bottom of the pop-up window.</p> <p> <strong>'Common' Lookup References</strong> </p> <ul> <li><strong>All Approver Comments:</strong> All comments made by all approvers in ALL Request Approval Actions about the item in the workflow are displayed. </li> <li><strong>Approver Comments:</strong> All comments made by all approvers in the last Request Approval Action about the item in the workflow are displayed. </li> <li><strong>Current Date:</strong> The current date. </li> <li><strong>Current Time:</strong> The current time. </li> <li><strong>Is Document Writable:</strong> Resolves to 'yes' if the file in a document library can be updated. Resolves to 'no' if it is checked out or being edited. Note this will always resolve to 'yes' in a list. </li> <li><strong>Initiator:</strong> The username (domain\username) who caused the item to be entered into the workflow. </li> <li><strong>Initiator's Display Name:</strong> The display name of user who caused the item to be entered into the workflow. </li> <li><strong>Item URL:</strong> The url of the item in workflow. </li> <li><strong>Last Task Respondent:</strong> The username (domain\username) of the user who last registered a response to a task. </li> <li><strong>Last Task Respondent Display Name:</strong> The display name of the user who last registered a response to a task. </li> <li><strong>List ID:</strong> The unique ID of the list containing the item in workflow (Advanced). </li> <li><strong>List Name:</strong> The name of the list in which the workflow item is located. </li> <li><strong>Manager:</strong> The username (domain\username) of the workflow initiator's manager. </li> <li><strong>Manager's Display Name:</strong> The display name of the workflow initiator's manager. </li> <li><strong>Site Name:</strong> The title of the site in which the workflow item is located. </li> <li><strong>Start Date:</strong> The date the item's workflow was started. </li> <li><strong>Start Time:</strong> The time the item's workflow was started. </li> <li><strong>Web Url:</strong> The full URL of the site in which the workflow item is located. </li> <li><strong>Workflow Instance ID:</strong> The unique ID given to the running workflow instance (Advanced). </li> <li><strong>Workflow Log URL:</strong> The URL where the status of the workflow can be viewed in textual form. </li> <li><strong>Workflow Status URL:</strong> The URL where the status of the workflow can be viewed. </li> <li><strong>Workflow Title:</strong> The title of the workflow. </li> </ul> <p> <strong>The following references are available from within request approval notifications</strong> </p> <ul> <li><strong>Approval Url:</strong> The URL in SharePoint where an approval for the item in the workflow can be made. </li> <li><strong>Approver Name:</strong> The display name of the user currently required to approve the document. </li> <li><strong>Approve:</strong> A url that will approve the task without requesting further input. Can be appended with a querystring confirmationpage=<i>url to show</i> to display a custom confirmation page. Can be appended with querystring hsl=[true|false] to determine whether to show the workflow status link on the default confirmation form.</li> <li><strong>Reject:</strong> A url that will reject the task without requesting further input. Can be appended with a querystring confirmationpage=<i>url to show</i> to display a custom confirmation page. Can be appended with querystring hsl=[true|false] to determine whether to show the workflow status link on the default confirmation form.</li> <li><strong>Delegate Url:</strong> The URL in SharePoint where an approver can delegate a task if allowed.</li> </ul> <h3>Inline functions</h3> <p>In addition to inserting tokens, inline functions can be used to do additional processing in the text. See the <a href="#nintex.workflow.inlinefunctions">inline functions topic</a> for more information.</p> </div> </DIV><a name="Nintex.Workflow.LDAPPicker"><H2>2.8 LDAP Picker</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Many activities require connection information to lookup Active Directory.</p> <p>Activities such as Query LDAP and Create AD Account require an LDAP address in order to connect to an Active Directory data store.</p> <p>When the LDAP Picker is initially opened, it will attempt to connect to Active Directory using the information in the Activity dialog "LDAP Path" text box. An error will occur if further credentials are required.</p> <p>Select an Active Directory object by clicking on it, then press the "Close" button. The selected object will be pasted into the Activity dialog window.</p> <p><img src="content/nintex.workflow.ldappicker1.png" alt="" height="489" width="596" border="1" /></p> <h2>Options within this action</h2> <h3>LDAP Path</h3> <p>An LDAP path specifying the Active Directory location. E.g. LDAP://Nintex.com/DC=nintex,DC=com</p> <p>If your domain name is MyCompany.com, then the LDAP Path will be LDAP://MyCompany.com/DC=MyCompany,DC=com</p> <p>You can specify Containers or organizationalUnits by adding "CN=" or "OU=". E.g. LDAP://MyCompany.com/CN=Users,DC=MyCompany,DC=com or LDAP://MyCompany.com/OU=Servers,DC=MyCompany,DC=com</p> <h3>Username</h3> <p>A username with the required permissions to access the LDAP Path entered.</p> <h3>Password</h3> <p>A password for the above username.</p> <p>Click on the padlock to select from a list of Credential Workflow Constants, maintained in Site Settings by your system administrator.</p> <p><img src="content/nintex.workflow.ldappicker2.png" alt="" height="317" width="433" border="1" /></p> <h2>Accessing the LDAP Picker</h2> <p>The LDAP Picker is available from the following dialogs: <ul> <li>Integration Activities - Query LDAP</li> <li>Provisioning Activities - Add User to AD Group</li> <li>Provisioning Activities - Create AD Account</li> <li>Provisioning Activities - Create AD Group</li> <li>Provisioning Activities - Decommission AD Account</li> <li>Provisioning Activities - Enable LCS/OCS</li> <li>Provisioning Activities - Remove User from AD Group</li> <li>Provisioning Activities - Update AD Account</li> </ul> </p> </div> </DIV><a name="Nintex.Workflow.Lookups"><H2>2.9 Using lookups</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Many of the actions within Nintex Workflow allow you to set values at runtime with lookups. When the popup is displayed you will be given the option to select one of three sources for this value.</p> <h3>Value</h3> <p> <img src="content/nintex.workflow.lookupvalue.png" alt="the" height="82" width="234" border="1" /></p> <p>The value source allows you to type a value that will not change at runtime.</p> <h3>Workflow Data</h3> <p> <img src="content/nintex.workflow.lookupworkflowdata.png" alt="the" height="75" width="361" border="1" /></p> <p>The workflow data source allows you to use the runtime value of the custom workflow variables with the matching type you have configured and manipulated within the workflow.</p> <h3>List Lookup</h3> <p>The list lookup source is a powerful feature allowing you to make reference to any property of the current item or any item within a list in the current site. When this option is selected click on the lookup button to see the &quot;Lookup Details&quot; popup tool. </p> <p> <img src="content/nintex.workflow.lookupdetailscurrentitem.png" alt="lookup" height="167" width="400" border="1" /></p> <p>The default option is to use a value from the current item. All fields that match the type of value you are setting will be shown in the field list.</p> <p> <img src="content/nintex.workflow.lookupdetailslist.png" alt="lookup" height="228" width="481" border="1" /></p> <p>Alternatively you can locate a property on another item in any list within the site. After selecting a source list select a field containing the value to be used. Using the 'When' and 'Equals' fields locate an item in the source list. &nbsp;In the above case we have selected to use the ID of an item &quot;Shared Documents&quot; where the name of the item is "Finance Jan 2007&quot;.</p> <p><strong>Advanced Designer Tip:</strong> This is a useful method for solving the problem of environment-specific configuration values. By creating a list to hold the configuration variables you can use this lookup to retrieve the settings at runtime that may differ between your development, acceptance and production environments. This helps avoid hard-coding these settings into the workflow templates and having to change them as they are deployed between environments.</p> <p>For information about lookups used in the Nintex Workflow Message Templates, please refer to the <a href="#nintex.workflow.messagetemplates">Message Templates help page</a>. </p> </div> </DIV><a name="Nintex.Workflow.MailStorePicker"><H2>2.10 MailStore Picker</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p>Many activities require connection information to lookup Active Directory.</p> <p>The Provision User on Exchange Activity requires an LDAP address in order to specify the Mailbox Container (or Exchange Database if provisioning an Exchange 2007 mailbox). Generally, this will be an object called "Mailbox Database", residing under a "Storage Group" object</p> <p>When the MailStore Picker is initially opened, it will attempt to connect to Active Directory using the information in the Activity dialog "LDAP Path" text box. It will then attempt to find any available "Mailbox Database" folders. An error will occur if further credentials are required.</p> <p>Select a "Mailbox Database" object (or another location in which you want the mailbox to reside) by clicking on it, then press the "Close" button. The selected object will be pasted into the Activity dialog window.</p> <p><img src="content/nintex.workflow.mailstorepicker1.png" alt="" height="487" width="600" border="1" /></p> <h2>Options within this action</h2> <h3>LDAP Path</h3> <p>An LDAP path specifying the Active Directory location. E.g. LDAP://Nintex.com/DC=nintex,DC=com</p> <p>If your domain name is MyCompany.com, then the LDAP Path will be LDAP://MyCompany.com/DC=MyCompany,DC=com</p> <p>You can specify Containers or organizationalUnits by adding "CN=" or "OU=". E.g. LDAP://MyCompany.com/CN=Configuration,DC=MyCompany,DC=com or LDAP://MyCompany.com/OU=Servers,DC=MyCompany,DC=com</p> <p>Note that you must connect to the Configuration Container to access Exchange MailStore objects. E.g. LDAP://Nintex.com/CN=Configuration,DC=nintex,DC=com</p> <h3>Username</h3> <p>A username with the required permissions to access the LDAP Path entered.</p> <h3>Password</h3> <p>A password for the above username.</p> <p>Click on the padlock to select from a list of Credential Workflow Constants, maintained in Site Settings by your system administrator.</p> <p><img src="content/nintex.workflow.mailstorepicker2.png" alt="" height="317" width="433" border="1" /></p> <h2>Accessing the MailStore Picker</h2> <p>The MailStore Picker is available from the following dialogs: <ul> <li>Provisioning Activities - Provision User on Exchange</li> </ul> </p> </div> </DIV><a name="Nintex.Workflow.ManageWorkflows"><H2>2.11 Managing Workflows</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Each list or library in a site enabled with Nintex Workflow 2007 will have two additional items in its list settings menu as shown below. The second last option in the menu links to the &quot;Manage Workflows&quot; page for that specific list or library.</p> <p> <img src="content/nintex.workflow.manageworkflows1.png" alt="the" height="325" width="485" border="1" /></p> <p>When the &quot;Manage Workflows&quot; page loads you will see a list of all the workflows that belong to the current list. These are broken up into those that are published (available for selection by users) as well as those which are unpublished (saved but unavailable). </p> <p> <img src="content/nintex.workflow.manageworkflows2.png" alt="the" height="231" width="600" border="1" /></p> <p>From here there are three options:</p> <ul> <li><strong>Create a new workflow:</strong> click on the &quot;Create&quot; button in the toolbar to <a href="#nintex.workflow.workflowdesigner"> create a new workflow</a>.</li> <li><strong>Edit an existing workflow:</strong> click on the linked name of an existing workflow in order to open it for editing in the <a href="#nintex.workflow.workflowdesigner"> Nintex workflow designer</a>.</li> <li><strong>Delete an existing workflow:</strong> click on the <img src="content/nintex.workflow.deletebuttonx.png" alt="delete" height="16" width="15" border="0" /> button next to the workflow to be deleted. After confirming the deletion the workflow will be permanently removed from the system.</li> </ul> <h3>Un-publishing A Workflow</h3> <p>If you wish to un-publish a workflow this can be done within SharePoint itself. Open the Library/List Settings page and select the &quot;Workflow settings&quot; option in the menu.</p> <p><img src="content/nintex.workflow.manageworkflows3.png" alt="the" height="153" width="233" border="1" /></p> <p>A list of all published versions of the active workflows within the list or library with the number of currently running workflows will be displayed. To remove one or more from the &quot;Published&quot; list click on the &quot;Remove a workflow&quot; link.</p> <p> <img src="content/nintex.workflow.manageworkflows4.png" alt="the" height="203" width="600" border="1" /></p> <p>From the &quot;Remove workflows&quot; page, select the &quot;Remove&quot; radio button to the right of the workflow title to remove it. Note that when removing a workflow here it is not removed from the system, only from the list of workflows available to users (published workflows).</p> <p> <img src="content/nintex.workflow.manageworkflows5.png" alt="the" height="184" width="600" border="1" /></p> <p>Click the &quot;OK&quot; button to commit your changes. </p> </div> </DIV><a name="Nintex.Workflow.OpenSave"><H2>2.12 Opening and saving workflows</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This help topic describes how to open and save workflows. For information about making a workflow available to users in libraries and lists, please refer to the <a href="#nintex.workflow.publishing">Publishing a workflow help page</a>. </p> <p><strong>Opening a workflow</strong></p> <p>There are two ways to open an existing workflow:</p> <p> Navigate to the workflow designer by choosing to <a href="#nintex.workflow.workflowdesigner">create a new workflow</a>. Open any of the workflow templates that are displayed, then from the top of the design canvas, click the &quot;Actions&quot; button, then select &quot;Open&quot;.</p> <p><img src="content/nintex.workflow.opensave1.png" alt="" height="218" width="455" border="1" /> </p> <p>A dialog box will open that displays all the workflows that are associated with the list or library that you are using. </p> <p><img src="content/nintex.workflow.opensave2.png" alt="" height="146" width="569" border="1" /></p> <p>Select the workflow you wish to open then click the &quot;Open&quot; button at the bottom of the pop-up window (not shown). </p> <h2>Versioning</h2> <p>The open dialog supports opening a previously published version of a workflow. To see the available versions click the + button. Every time the workflow was published will be listed. If a workflow was saved, and not published, it will not be listed. The latest published version will be marked as (current). To open a previously published version, select one of the versions from the list and press Ok. The previous version will open in the workflow designer. If this workflow is then modified and published, a new version will be created and this new version will be the current version that is used when a workflow is started.</p> <p><img src="content/nintex.workflow.opensave5.png" alt="" height="234" width="570" border="1" /></p> <p>The other way to open a workflow is to use the &quot;Manage Workflows &quot; link provided from the SharePoint library or list view. For more information, please refer to the <a href="#nintex.workflow.manageworkflows">Manage Workflows help page.</a></p> <p><strong>Saving a workflow</strong></p> <p>You can save a workflow at any point in the design process and edit it again at a later time. To save a workflow, click the &quot;Actions&quot; button at the top of the design canvas, then select &quot;Save&quot;. If this is the first time you have saved the workflow and have not already set the title, a pop-up box will appear asking you to enter one, along with an optional description of the workflow:</p> <p><img src="content/nintex.workflow.opensave3.png" alt="" height="300" width="596" border="1" /></p> <p>If you leave the default title, which is &quot;New workflow&quot;, it could overwrite other workflows with the default name, so it is recommended that you supply a unique title for the workflow. Click the &quot;Save&quot; button when you are ready. A progress pop-up will appear. When the workflow has been saved, it will change and you can click the &quot;OK&quot; button to continue. </p> <p><img src="content/nintex.workflow.opensave4.png" alt="" height="153" width="199" border="1" /></p> </div> </DIV><a name="Nintex.Workflow.Print"><H2>2.13 Printing</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"><p>Use the <strong>Print</strong> button in the Actions menu to print the workflow design.</p> <p>Note: The <strong>Print</strong> feature prepares the workflow design page for printer friendly viewing on the web browser. The browser's standard printing function is then used to send the page to the printer.</p> <p><img src="content/nintex.workflow.print1.png" alt="" height="762" width="600" border="1" /></p> <p>Click the <strong>Print</strong> icon on the page to launch the browser's standard print functions.</p></div></DIV><a name="Nintex.Workflow.Publishing"><H2>2.14 Publishing a workflow</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Before a workflow becomes available to users within SharePoint lists and libraries it must be published.</p> <p>Once you are happy with your workflow select the &quot;Publish&quot; option from the Actions menu on the Nintex Workflow design canvas. The application will then validate the workflow and publish it, ready for SharePoint. For information about which users can publish workflows, please refer to the <a href="#nintex.workflow.securitysettings">Security Settings help page</a>. </p> <p><img src="content/nintex.workflow.publishing1.png" alt="the" height="328" width="258" border="1" /></p> <p>This process of validation and publish may take a few seconds before you will see the success message as shown below. When the workflow is published it can be managed additionally by the standard SharePoint tools as well within the &quot;<a href="#nintex.workflow.manageworkflows">Manage Workflows</a>&quot; page.</p> <p> <img src="content/nintex.workflow.publishing2.png" alt="publish" height="374" width="462" border="1" /></p> <p>If there are errors in the workflow, including actions that are not configured, the workflow will not publish. </p> </div> </DIV><a name="Nintex.Workflow.SetLabels"><H2>2.15 Set action labels</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>You can configure the text displayed around an activity by clicking on the activity's drop-down menu and selecting &quot;Edit Labels&quot;.</p> <p><img src="content/nintex.workflow.setlabels1.png" alt="" height="124" width="347" border="1" /></p> <p>You can now configure the action title and text to display to the left, right and bottom of the action. Note: The action title is used in workflow reports to indicate the current status of a running workflow.</p> <p><img src="content/nintex.workflow.setlabels2.png" alt="" height="375" width="596" border="1" /></p> <p>You can also configure the &quot;Expected duration&quot; for an action. This is typically used in actions that require human interaction. The expected duration is used in workflow reports to indicate if an action is overdue.</p> <p><img src="content/nintex.workflow.setlabels3.png" alt="" height="100" width="264" border="1" /></p> <h3>Hide from workflow status</h3> <p>This option allows you to specify that this action, and any child actions, are not displayed in the workflow history or graphical progress view. This will also cause the action to not be tracked in the workflow database. Note that the "Request Approval", "Request Review" and "Request Data" actions can be hidden from the graphical status view, but will still be displayed in the workflow history and logged in the database.</p> </div> </DIV><a name="Nintex.Workflow.VerboseLogging"><H2>2.16 Verbose logging</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <h2>Introduction</h2> <p>Verbose logging adds increased context data when viewing the history of a workflow instance. The value of all workflow variables and item properties are stored before and after each workflow action, along with additional diagnostics information such as the process the workflow was running in and the server which was executing the workflow.</p> <h2>Enabling verbose logging</h2> <p>Verbose logging must first be enabled in the farm before it can be enabled in a workflow. To enable verbose logging, browse to <a href="#nintex.workflow.globalsettings">Global Settings</a> and enable the option to allow verbose logging. A workflow with verbose logging enabled will add a larger amount of data to the workflow database than one without, therefore there is an automatic purge process to remove verbose information after a number of days. The number of days to keep verbose logs is set here.</p> <p><img src="content/nintex.workflow.verboselogging1.png" alt="" height="94" width="500" border="0" /></p> <p>After changing these settings, iisreset or wait 15 minutes for the settings to automatically refresh.</p> <p>Once verbose logging is enabled in the farm, it can be enabled in a workflow. The option to enable verbose logging is in the start options for the workflow.</p> <p><img src="content/nintex.workflow.verboselogging2.png" alt="" height="79" width="262" border="0" /> </p> <h2>Viewing verbose logs</h2> <p>Verbose information is available from the <a href="#nintex.workflow.workflowstatus">graphical workflow status</a> of a workflow. If the instance ran with verbose logging enabled, and the verbose data has not yet been cleared, a message in the workflow information panel will state that verbose logging information is available. If verbose data is available, each workflow action can be clicked on to bring up the verbose information panel. The panel shows each data item available to the workflow, with the values before and after the action executed. If any value changed, it will be highlighted.</p> <p>There are options to export the verbose information for a particular action or the entire verbose log to an xml file.</p> <h2>Considerations when using verbose logging</h2> <p>Verbose logging adds a significant amount of data to the Nintex Workflow database. The data is not intended to be kept for a long time. The verbose logging feature is intended as an assistant for workflow development and testing, and is not intended to be left on in production.</p> </div></DIV><a name="Nintex.Workflow.Snippets"><H2>2.17 Workflow Snippets</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Snippets&quot; feature is useful for advanced users who create numerous workflows. Those users who find they are creating the same set of actions in the same sequence repeatedly can choose to save these sets of actions as a snippet, for reuse in either the current workflow or other workflows on the same instance of SharePoint. </p> <h2>Creating Snippets</h2> <p>There are two ways to create a snippet. The first involves saving an entire workflow as a snippet. To do this, from the actions menu as shown below, select &quot;Save As&quot; then the &quot;Snippet&quot; option.</p> <p> <img src="content/nintex.workflow.snippets1.png" alt="save" height="328" width="510" border="1" /></p> <p>The second method is specifically attached to the use of the &quot;Action Set&quot; action as shown on the right.&nbsp; This action itself allows you to package up a number of actions, and potentially hide these nested actions. By clicking on the title bar you will notice the &quot;Save as Snippet&quot; option.</p> <p><img src="content/nintex.workflow.snippets4.png" alt="the" height="381" width="166" border="1" /></p> <p>In both cases the &quot;New Snippet&quot; popup will be presented.</p> <p> <img src="content/nintex.workflow.snippets2.png" alt="the" height="106" width="457" border="1" /></p> <p>To save the new snippet the only information needed is the unique name to save it under.</p> <h2><strong>Using Snippets</strong>&nbsp;</h2> <p> <img src="content/nintex.workflow.snippets5.png" alt="my" height="316" width="153" border="1" /></p> <p>Once a snippet has been saved a new section will appear in the Actions palette called &quot;My Snippets&quot;. It is from here that you can reuse the snippet at your convenience with all its preconfigured settings ready to go.</p> <p>To use the snippet in the workflow, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. When the snippet is released onto the pearl, it will be rendered as a set of worklfow actions - the snippet icon will not appear on the workflow canvas. </p> <p>If a snippet needs to be removed from the Actions palette you&nbsp;can right-click on the snippet itself and select the &quot;Delete&quot; option from the context menu that appears.</p> </div> </DIV><a name="Nintex.Workflow.StartData"><H2>2.18 Workflow start data</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Using the start data option, you can configure information that must be collected when the workflow is started.&nbsp; When a user starts the workflow, they will be presented with a form requesting this information. &nbsp;This data is stored as workflow variables and is referenced by other actions in the workflow.&nbsp; </p> <p> <strong>Please note:</strong> If you have created variables already, the variables created here must have different names. </p> <p> For more information please refer to the <a href="#nintex.workflow.workflowvariables">Workflow Variables help page</a>.</p> </div> </DIV><a name="Nintex.Workflow.StartOptions"><H2>2.19 Workflow start options</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><img src="content/nintex.workflow.startoptions1.png" alt="" height="39" width="39" border="1" /></p> <p>The &quot;Workflow start options&quot; determine how a workflow can be started and are accessed by clicking the &quot;Settings&quot; button above the design canvas then selecting &quot;Startup options&quot;. There is an also a statistics setting where an estimate of how long the workflow process is expected to take can be set.</p> <p>The options (including two automatic) provided are:</p> <p><img src="content/nintex.workflow.startoptions2.png" alt="" height="258" width="464" border="1" /></p> <p><strong>Start manually:</strong> A user wishing to apply workflow to an item must manually select a workflow from a list of those available. Only workflows that have the option &quot;Start manually&quot; enabled will be listed.</p> <p><strong>Start when items are created:</strong> when a library or list item is created or uploaded, all workflows in the library or list with this option enabled will start. </p> <p><strong>Start when items are modified:</strong> when a library or list item is modified, all workflows in the library or list with this option enabled will start. Checking-in a document in any way will not trigger a workflow to start. </p> <p><strong>Publish without validation:</strong> Advanced option. Specifies that a validation step is skipped when the workflow is published. Not validating the workflow is not recommended. If the workflow is large and takes a significiant length of time to publish, choosing to skip validation will help decrease how long the publish operation takes. However, if a validation issue is missed, the workflow may show unexpected errors.</p> <p><strong>Expected workflow duration:</strong> the workflow will record this duration in the database for reporting purposes.</p> <p><strong>Task List:</strong> all tasks created by a workflow are stored in a SharePoint tasklist on the teamsite. This option allows the task list that the workflow uses to be changed from the default.</p> <p><strong>PLEASE NOTE:</strong> Workflows are associated with a library or a list. Folders and sub-folders within libraries are subject to the same workflows as the parent library. Therefore, if you set a workflow to start when items are created or modified, any item, regardless of how many folders or sub-folders down it is stored, will trigger all the workflows that are set to start automatically. That behaviour is governed by SharePoint. </p> </div> </DIV><a name="Nintex.Workflow.Templates"><H2>2.20 Workflow templates</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Workflow templates allow you to create and store workflows that are common throughout your business.</p> <p>Workflow templates are tied to site collections so a template that may be visible in one part of SharePoint may not be visible in another. In these instances, you may need to Import from another team site or location. </p> <h3>Template Pop-up </h3> <p>When you first select to Create or Edit a workflow, a popup box will appear like the one shown below.</p> <p><img src="content/nintex.workflow.templates7.png" alt="" height="454" width="600" border="1" /></p> <p><strong>Please note:</strong> Templates shown may differ from those available </p> <p>You can stop showing the template popup by unchecking 'Show template page when creating a new workflow'. You can reenable this option from the open workflow dialog.</p> <p>If this popup does not appear, you may have pop-ups blocked. If this is the case a box will appear in the workflow palette like the one below.</p> <p><img src="content/nintex.workflow.templates2.png" alt="" height="155" width="304" border="0" /></p> <p>You will also have a warning appear at the top of your web browser like the one below</p> <p><img src="content/nintex.workflow.templates1.png" alt="" height="24" width="522" border="1" /> </p> <p>By clicking on this warning once, you will be presented with the following options</p> <p><img src="content/nintex.workflow.templates3.png" alt="" height="83" width="228" border="0" /> </p> <p>Clicking on &quot;Temporarily Allow Pop-ups&quot; will allow the templates pop-up to appear in the interim. Selecting &quot;Always Allow Pop-ups from This Site...&quot; will mean you do not receive these prompts anymore. </p> <p>By default you will be presented with the option of starting a blank workflow. Depending on what version of Nintex Workflow 2007 you purchased, you may also be able to select a pre-loaded template. Any template categories available will be listed in the template box. By hovering over a template the description of the template and its use will appear. This description is also shown in the right hand column under the template name, along with the category of the template, the last date modified and the last person to modify the template as shown below.</p> <h3>Which template have I selected?</h3> <p>The currently selected template will appear with a thick orange border and orange mirrored background. When not mousing-over any templates, the template name and description of the currently selected template will be shown in the right hand column. </p> <p>Once you have chosen a template (blank or otherwise), simply double-click the one of relevance or click the Create button at the bottom right of the template pop-up. </p> <h3>How do I save a workflow as a template? </h3> <p>Once you've designed a workflow that you wish to publish as a template simply click on the &quot;Actions&quot; menu at the top of the workflow palette, then click &quot;Save As&quot; and select &quot;Template&quot;.</p> <p><img src="content/nintex.workflow.templates4.png" alt="" height="303" width="506" border="1" /></p> <p>You will then be presented with the New Template dialog box as shown below</p> <p><strong>Name</strong> is the title you would like to give the template. </p> <p><strong>Category</strong> is the group title for related templates. You can select an already created category or you can create a new one as shown below</p> <p><strong>Description</strong> is a brief description of the purpose of the template and helps users identify which template they should select.</p> <p><img src="content/nintex.workflow.templates5.png" alt="" height="379" width="600" border="0" /></p> <h3>How do I delete a template?</h3> <p>A Site Owner can delete a template. To do so, click the &quot;Site Actions&quot; button then &quot;Site Settings&quot;. Then, in the &quot;Nintex Workflow&quot; section you will need to click on &quot;Workflow Templates&quot;, where the full list of templates is stored. Simply delete the template as you would any item or document. </p> </div> </DIV><a name="Nintex.Workflow.WFConstants"><H2>2.21 Workflow Constants</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Workflow Constants are values that can be set globally for all workflows, either at the Farm, Site Collection or Site level. Once defined, they can be used within workflows by inserting them from the <a href="#nintex.workflow.insertreference">Insert Reference</a> dialog where available.</p> <p><img src="content/nintex.workflow.wfconstants1.png" alt="" height="525" width="441" border="1" /></p> <p>When a workflow designer uses a constant in a workflow, they do not need to know the actual value stored. Workflow Constants are good for storing data such as URL's, LDAP paths or SQL Connection Strings.</p> <p>New workflow constants are created by clicking the &quot;Manage workflow constants&quot; from the Nintex Workflow site settings panel.</p> <p><img src="content/nintex.workflow.wfconstants3.png" alt="" height="213" width="600" border="1" /></p> <p>When creating a workflow constant, the following options are presented:</p> <h3>Title</h3> <p>The name of the constant that will display in the insert reference list.</p> <h3>Type</h3> <p>The data type of the workflow constant. Choices are String, Number, Date and Credential.</p> <p>The Credential type allows a username and password to be stored securely. Constants that are created as credentials are available for inserting when a dialog specifically has a username and password field with a padlock lookup icon. They cannot be used in regular insert reference lookups.</p> <p><img src="content/nintex.workflow.wfconstants2.png" alt="" height="57" width="286" border="1" /></p> <p>Administrators can set reusable credentials with privileges required to complete a workflow action without the workflow designer needing to know the actual username and password.</p> <h3>Value</h3> <p>The value that the constant will be replaced with when the workflow is run.</p> <h3>Description</h3> <p>Additional notes about the constant.</p> <h3>Sensitive</h3> <p>If a constant is marked as sensitive, it is only available in certain insert reference dialogs where a sensitive value may be required. For example, the insert reference box on the &quot;Execute SQL&quot; action dialog connection string field supports sensitive constants but the body and subject fields of the &quot;Send a Notification&quot; do not.</p> <p>Sensitive constants are stored encrypted. Credential constants are also stored encrypted.</p> <h3>Edit permissions</h3> <p> Permissions can be set on workflow constants so only specified users or groups are allowed to see and use the workflow constant when designing a workflow.</p> <p> If an existing workflow is modified by another user (workflow designer) who does not have permissions to see and use a workflow constant being used in that workflow, the workflow will save but cannot be republished. Only users (workflow designers) that have been granted permission to see and use the workflow constant will be able to publish the workflow.</p> <p> The security check for a workflow constant is performed when the workflow is published. Therefore, if the permissions for a workflow constant are changed, a workflow that is already using the constant will continue to use the value successfully. </p> <p> To add/edit permissions for a workflow constant:</p> <ul> <li>Navigate to the <b>Manage workflow constant </b>settings.</li> <li>Select the workflow constant to apply permission on.</li> <li>In the Ribbon, click on the <b>Edit permission</b> button.</li> </ul> <p> By default permissions is set to &quot;Everyone&quot;.</p> </div> </DIV><a name="Nintex.Workflow.WorkflowGallery"><H2>2.22 Workflow gallery</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The workflow gallery is a central repository for you to manage all Nintex Workflows created for a team site. Workflow galleries will normally be managed by a Team Site Administrator or SharePoint Administrator. </p> <p>The workflow gallery can be accessed from the &quot;Site Settings&quot; page.</p> <p><img src="content/nintex.workflow.workflowgallery1.png" alt="" height="371" width="504" border="1" /></p> <p>It is then located under the Nintex Workflow header as shown below</p> <p><img src="content/nintex.workflow.workflowgallery2.png" alt="" height="178" width="167" border="1" /> </p> <p>In the Workflow Gallery you will be presented with all the currently published workflows for this team site. The name of the workflow including the description, who last modified the workflow and what list the workflow is tied to will all be displayed.</p> <p><img src="content/nintex.workflow.workflowgallery4.png" alt="" height="170" width="600" border="1" /></p> <p>Clicking on any of the workflows will present you with a graphical display of the workflow that is not editable. Scrolling over each workflow action will provide you with information on how the workflow action is configured. </p> <p>From this display you will be able to export the workflow to another team site by clicking on the Export this workflow button at the top left as shown below</p> <p><img src="content/nintex.workflow.workflowgallery3.png" alt="" height="29" width="120" border="0" /> </p> </div> </DIV><a name="Nintex.Workflow.WorkflowVariables"><H2>2.23 Workflow variables</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>At first glance workflow variables may not seem to be needed much in most workflows. In truth, for basic approval workflows built ad-hoc by users as required they are not needed often. However, as a workflow gets more complicated and the need for implementing complex business rules and logic arises, the advanced, technically minded user will find them useful.</p> <p>Some examples of when workflow variables are useful:</p> <ul> <li>The workflow requires a value for conditional actions which is a combination of values that exist already in the system. For example, these values can be set using the &quot;<a href="#nintex.workflow.mathoperation">Math Operation</a>&quot; or &quot;<a href="#nintex.workflow.builddynamicstring">Build Dynamic String</a>&quot; actions.</li> <li>You develop the workflow in a development environment for deployment to testing and production environments. To avoid using hard coded values in the workflow that must be manually updated during deployment, workflow variables can be used to load values from other lists via <a href="#nintex.workflow.lookups"> lookups</a>. e.g. a URL to be used in an email may be different for each environment, this can be sourced at runtime from a configuration list within each environment using the &quot;<a href="#nintex.workflow.setvariable">Set Variable</a>&quot; action.&nbsp;</li> <li>A workflow may require the <a href="#nintex.workflow.createitem">creation of another list item</a> that you will need to query later using a lookup or delete automatically depending on further logic in a workflow. e.g. a new report requires that a meeting is organised, but during the workflow an administrator has rejected the report. Therefore the calendar event needs to be deleted.</li> </ul> <p>It is not always appropriate or possible to store some of these values as meta data of the item attached to the workflow. To provide the means and flexibility to handle these kinds of scenarios Nintex provides workflow variables. </p> <p> <img src="content/nintex.workflow.workflowvariables2.png" alt="the" height="235" width="331" border="1" /></p> <p><strong>Managing Workflow Variables</strong></p> <p>In order to create or delete a variable attached to a workflow, select the &quot;Settings&quot; button and then the &quot;Workflow Variables&quot; option.</p> <p><img src="content/nintex.workflow.workflowvariables3.png" alt="" height="477" width="593" border="1" /></p> <p>This will open a popup as shown below with a list of all the current variables that are configured with their type (text, number, yes/no, date time, list item ID, action ID and collection) listed in brackets. If there are no existing variables, the create variable panel will be displayed automatically. To delete an existing variable click on the <img src="content/nintex.workflow.workflowvariables5.png" alt="the" height="12" width="11" border="0" /> next to that item.</p> <p>To create an item click on the &quot;Create variable&quot; button. The &quot;Create a new variable&quot; form will be displayed to allow you to configure the name and type of your new variable. </p> <p><img src="content/nintex.workflow.workflowvariables4.png" alt="creating" height="231" width="454" border="1" /></p> <p>Please note that throughout Nintex Workflow 2007, actions that refer to workflow variables are restricted so that items of different types cannot be intermixed. In other words apples can only be compared with apples and not with bananas. Hence:</p> <ul> <li>for <a href="#nintex.workflow.mathoperation">math operations</a> you will only be able use number variables;</li> <li>when <a href="#nintex.workflow.createitem">creating a list item</a> only a List Item ID variable can be used to store the ID of the new item;</li> <li>a <a href="#nintex.workflow.conditional">conditional</a> action that is comparing the created date can only use a DateTime variable.</li> </ul> <p>Once you are happy with the variables please ensure you click on the &quot;Save&quot; button, otherwise none of your changes will be saved to the database.</p> </div> </DIV><a name="Nintex.Workflow.SectionInteraction"><H1>3 Workflow Interaction with Sharepoint</H1></a><a name="Nintex.Workflow.LazyApproval"><H2>3.1 About LazyApproval</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;LazyApproval&quot; feature of Nintex Workflow 2007 enables approvals or rejections of an item to be registered when the approver replies to the notification email with a permitted word or phrase. That word or phrase is recognized and interpreted by the system as meaning &quot;Approve&quot; or &quot;Deny&quot; and applied to the item in the workflow.</p> <p>LazyApproval is not automatically enabled at the time of installation, it has to be manually enabled. For more information, please refer to the <a href="#nintex.workflow.lazyapprovalsettings">Managing LazyApproval settings help page</a>.</p> <p>The LazyApproval feature is used in conjunction with the &quot;<a href="#nintex.workflow.requestapproval">Request Approval</a>&quot; and &quot;<a href="#nintex.workflow.requestdata">Request Data</a>&quot; workflow actions. At the time of configuring the workflow action, the designer needs to check the box &quot;Allow LazyApproval&quot;. Also, please note, LazyApproval ONLY works when email is selected as the delivery method. </p> <p><img src="content/nintex.workflow.lazyapproval2.png" alt="" height="217" width="481" border="1" /></p> <p>When LazyApproval is used, an addition to the standard email template footer is added that explains how to use LazyApproval. When the system receives the return email it will scan the top 20 lines of the reply for a recognized LazyApproval term. It scans from the top of an email downwards and uses the first recognized term it finds that is an exact match for a permitted whole word or whole phrase on a line by itself. Recognized words or phrases that appear with unrecognized other text on the same line will cause the word or phrase to be ignored and will be skipped. </p> <p>You can customize the footer text from the LazyApproval settings page in Central Administration.</p> <p>If a term is not found, a return email will be sent to the user informing him/her that their response was not able to be interpreted. The user can then reply to that email with a recognized term for the approval or rejection to take effect. </p> <p><strong>IMPORTANT NOTE:</strong> When LazyApproval emails are sent, a specific piece of identification code is appended to the email subject. Please <strong>do not edit or remove the identification code</strong> as any change to it will mean that the LazyApproval thread cannot be traced and approval by email will not be possible for the user involved. That user will have to approve the item by navigating through the SharePoint library or list where the item and workflow are being used. For more information, please refer to the <a href="#nintex.workflow.approvereject">Approving and rejecting items help page</a>. </p> <p>A system administrator can edit or add to the list of acceptable and recognized terms. For more information, please refer to the <a href="#nintex.workflow.lazyapprovalsettings">Managing LazyApproval settings help page</a>. LazyApproval terms are not case sensitive. The default set of terms is: &quot;approve&quot;, &quot;approved&quot;, &quot;decline&quot;, &quot;declined&quot;, &quot;no&quot;, &quot;ok&quot;, &quot;reject&quot;, &quot;rejected&quot; and &quot;yes&quot; as seen below:</p> <p><img src="content/nintex.workflow.lazyapproval1.png" alt="" height="235" width="414" border="1" /></p> <p>&nbsp; </p> </div> </DIV><a name="Nintex.Workflow.ApproveReject"><H2>3.2 Approving, Rejecting and Reviewing Items</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>During runtime, when a human task is created as part of a workflow, the configured users will be processed, tasks will be assigned and the notification message/s sent. The tasks assigned to a user can be seen at any one time via the <a href="#nintex.workflow.itemspendingapproval">My Workflow Tasks </a> web part or the Nintex workflow task list setup within the site.</p> <p> <img src="content/nintex.workflow.myworkflowtasks.png" alt="items" height="73" width="522" border="1" /></p> <p>To process an assigned task, click the item's hyperlink (if configured and allowed) within the notification email or on the left hand side of the <a href="#nintex.workflow.itemspendingapproval">My Workflow Tasks</a> web part. This will open the &quot;Approve Reject&quot; page ready for the user's response.</p> <p> <img src="content/nintex.workflow.approvereject1.png" alt="approve" height="385" width="600" border="1" /></p> <h2>Sections on the &quot;Approve Reject&quot; page </h2> <h3>Status</h3> <p>When the task has been generated by the &quot;Request approval&quot; action, the user can choose to approve or reject the item in the workflow. The selection made will consequently determine the path followed by the workflow. When the task has been generated by the &quot;Request review&quot; action, there is no response to process as the item is deemed satisfactory when the user is finished with it.</p> <p>Depending on the configured workflow action, the user may be given the option of <a href="#nintex.workflow.delegation">delegating</a> the task to another user.</p> <h3>Comment</h3> <p>Use this field to enter any comments about why the item was approved or rejected.</p> <h3>Item Properties</h3> <p>Listed in the Item Properties section is the meta data related to the item in the workflow. To view the full details of the item click the hyperlink next to the &quot;Item&quot; property heading. Similarly, to view the status of the workflow graphically, click on the &quot;View&quot; link provided.</p> <p>The Item Properties panel also displays the field values of the item the workflow is running on (not shown in this screenshot). You can determine which fields are displayed by creating a view called 'Workflow Task View'. The name of the view to use is configurable in the Global Settings in SharePoint Central Administration.</p> </div> </DIV><a name="Nintex.Workflow.GraphViewerWebPart"><H2>3.3 Configuring the Graph Viewer Webpart</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p>Use the Nintex Chart Viewer web part to display a Nintex Workflow report in graph/chart view.</p> <p>To use the web part, it must be added to the home page of a site. Navigate to the home page of the site to which you want to add the web part then click &quot;Site Actions&quot; then &quot;Edit Page&quot;.</p> <p><img src="content/nintex.workflow.graphviewerwebpart5.png" alt="" height="167" width="266" border="1" /></p> <p>The web part is best added to the left zone of the page so that the columns it contains have sufficient space to display items. In the left zone, click the link &quot;Add a Web Part&quot;, then select the Nintex Chart Viewer web part.</p> <p><img src="content/nintex.workflow.graphviewerwebpart6.png" alt="" height="57" width="553" border="1" /></p> <p>To edit the settings for the web part, click the &quot;Edit&quot; button then &quot;Modify Shared Web Part&quot;. </p> <p><img src="content/nintex.workflow.graphviewerwebpart7.png" alt="" height="129" width="218" border="1" /></p> <p>A series of options will be shown in the tool pane to the right of the page that are specific to this web part.</p> <p><img src="content/nintex.workflow.graphviewerwebpart1.png" alt="" height="694" width="282" border="1" /></p> <h3>Report to display</h3> <p>Select the chart to display from the drop down list.<br />Note this list is configurable by your system administrator via Central Admin.</p> <h2>Configuration</h2> <h3>Chart Display Settings</h3> <p><img src="content/nintex.workflow.graphviewerwebpart2.png" alt="" height="608" width="473" border="1" /></p> <p>Click on the Configure display settings link to set the chart type, size, colors, and other settings.</p> <h3>Columns Used in the Chart Display</h3> <p><img src="content/nintex.workflow.graphviewerwebpart3.png" alt="" height="480" width="428" border="1" /></p> <p>Click on the Configure Columns used link to select which columns are shown in the chart. By default, all columns are included.</p> <h3>Chart Filters</h3> <p><img src="content/nintex.workflow.graphviewerwebpart4.png" alt="" height="180" width="600" border="1" /></p> <p>Click on the Configure Filter Values link to set filter values for the report.<br />Note that not all reports accept filter values.</p> </div> </DIV><a name="Nintex.Workflow.ReportViewerWebPart"><H2>3.4 Configuring the Report Viewer Webpart</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p>Use the Nintex Report Viewer web part to display a Nintex Workflow report in tabular view.</p> <p>To use the web part, it must be added to the home page of a site. Navigate to the home page of the site to which you want to add the web part then click &quot;Site Actions&quot; then &quot;Edit Page&quot;.</p> <p><img src="content/nintex.workflow.reportviewerwebpart3.png" alt="" height="167" width="266" border="1" /></p> <p>The web part is best added to the left zone of the page so that the columns it contains have sufficient space to display items. In the left zone, click the link &quot;Add a Web Part&quot;, then select the Nintex Report Viewer web part.</p> <p><img src="content/nintex.workflow.reportviewerwebpart4.png" alt="" height="57" width="553" border="1" /></p> <p>To edit the settings for the web part, click the &quot;Edit&quot; button then &quot;Modify Shared Web Part&quot;. </p> <p><img src="content/nintex.workflow.reportviewerwebpart5.png" alt="" height="129" width="218" border="1" /></p> <p>A series of options will be shown in the tool pane to the right of the page that are specific to this web part.</p> <p><img src="content/nintex.workflow.reportviewerwebpart1.png" alt="" height="672" width="280" border="1" /></p> <h3>Report to display</h3> <p>Select the report to display from the drop down list.<br />Note this list is configurable by your system administrator via Central Admin. <br />Click the Show Filter checkbox to allow users to specify filter values </p> <h3>Records displayed per page</h3> <p>Enter a number to specify how many records should be displayed per page. Leave this setting blank to display all records on the one page.</p> <h2>Configuration</h2> <h3>Filter</h3> <p><img src="content/nintex.workflow.reportviewerwebpart2.png" alt="" height="180" width="600" border="1" /></p> <p>Click on the Configure Filter Values link to set filter values for the report.<br />Note that not all reports accept filter values.</p> </div> </DIV><a name="Nintex.Workflow.Delegation"><H2>3.5 Delegating Approval Tasks </H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>Delegation is processed from the <a href="#nintex.workflow.approvereject"> Approval or Review</a> task pages when the human task is configured to allow delegation. When the link is selected the delegation screen is displayed.</p> <p> <img src="content/nintex.workflow.delegation1.png" alt="delegation" height="219" width="600" border="1" /></p> <h3>Delegate</h3> <p>The mandatory delegate field is used to specify the user to assign the selected task to. To select a user click on the address book icon on the right to see the Select People or Group popup similar to that used in the <a href="#nintex.workflow.requestapproval#spg">Approval Request</a> action.</p> <p>After the form is filled in and submitted the selected task will be reassigned to this selected user.</p> <h3>Comment</h3> <p>The comment field is mandatory and allows you to provide instructions to the new user. This text is actually appended to the approval required notification that is sent to the new user.</p> <h2>Setting personal delegation preferences</h2> <p>Each user that is involved in workflows can delegate their tasks to another user in case of absence. To set your personal preferences, activate the drop down from the logged-in user name link at the top of a page, mouse-over Nintex Workflow 2007 then select &quot;Task Delegation&quot;. </p> <p><img src="content/nintex.workflow.delegation2.png" alt="" height="329" width="514" border="1" /></p> <p>If you have not set up delegation before, the summary area will be empty. To set a user and dates, click the link &quot;Delegate tasks to a user between specific dates&quot;. </p> <p><img src="content/nintex.workflow.delegation3.png" alt="" height="103" width="389" border="1" /></p> <p>You will see 4 sections that need to be set. </p> <p><img src="content/nintex.workflow.delegation4.png" alt="" height="230" width="590" border="1" /></p> <ul> <li><strong>From the beginning of:</strong> the date when delegation begins, at midnight in the morning. Click the date picker tool icon to ensure the date is set in the appropriate format for your environment.</li> <li><strong>Until the end of:</strong> the date when delegation ends, at midnight that night. Click the date picker tool icon to ensure the date is set in the appropriate format for your environment.</li> <li><strong>Delegate To: </strong>click the Lookup button and search for the appropriate user. </li> <li><strong>Scope: </strong>check the box for delegation to apply only to the current site, otherwise delegation will be applied throughout the entire SharePoint farm. </li> </ul> <p><strong>Note:</strong> long term task delegations are only used when a task is initally assigned to a user. If a task is re assigned via the 'Delegate workflow task' action, or by another user manually, the task will be assigned to the specified user, even if they have long term delegations defined.</p> </div> </DIV><a name="Nintex.Workflow.ItemsPendingApproval"><H2>3.6 My Workflow Tasks web part</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;My Workflow Tasks&quot; web part is used to display a list of workflow related tasks that require the attention of the user that is currently logged in.</p> <p>Note: tasks that are no longer valid due to missing information will display a link to remove the entry from the web part.</p> <p>To use the web part, it must be added to the home page of a site. Navigate to the home page of the site to which you want to add the web part then click &quot;Site Actions&quot; then &quot;Edit Page&quot;.</p> <p><img src="content/nintex.workflow.myworkflows1.png" alt="" height="167" width="266" border="1" /></p> <p>The web part is best added to the left zone of the page so that the columns it contains have sufficient space to to display items. In the left zone, click the link &quot;Add a Web Part&quot;.</p> <p><img src="content/nintex.workflow.myworkflows2.png" alt="" height="57" width="553" border="1" /></p> <p>The &quot;My Workflow Tasks&quot; web part is listed as follows in the &quot;Add Web Parts&quot; dialog.</p> <p><img src="content/nintex.workflow.itemspendingapproval1.png" alt="" height="47" width="540" border="1" /></p> <p>Check the box to its left then click the &quot;Add&quot; button at the bottom of the dialog box. </p> <p>The page will reload with the web part in place. If you left click and keep the mouse button depressed, you can drag the web part up or down to re-position where it appears on the page. </p> <p><img src="content/nintex.workflow.itemspendingapproval2.png" alt="" height="129" width="559" border="1" /></p> <p>The default web part settings will display:</p> <ul> <li>The item's title.</li> <li>The name of the workflow.</li> <li>The status of the workflow related task (relative to the &quot;expected duration&quot; set at the time of workflow construction). </li> <li>How long the current task has been necessary and not completed.</li> <li>The action for which the running workflow is waiting.</li> </ul> <p>If you would like to use the web part with its default settings, then click &quot;Exit Edit Mode&quot;.</p> <p><img src="content/nintex.workflow.myworkflows5.png" alt="" height="88" width="142" border="1" /></p> <p>To edit the default settings for the web part, click the &quot;Edit&quot; button then &quot;Modify Shared Web Part&quot;. </p> <p><img src="content/nintex.workflow.myworkflows6.png" alt="" height="129" width="218" border="1" /></p> <p>A series of options will be shown to the right of the page that are specific to this web part.</p> <p><img src="content/nintex.workflow.itemspendingapproval4.png" alt="" height="544" width="244" border="1" /></p> <p><strong>Web Part Options</strong></p> <ul> <li><strong>Show tasks from:</strong> You can choose to show workflows from the current site or from all the sites in the site collection. Enterprise Licenses can also choose the entire Farm.</li> <li><strong>Paging:</strong> You can choose how many items are displayed on the page by the webpart.</li> <li><strong>Display:</strong> <ol> <li><strong>Prefer filenames:</strong> By default, document titles are displayed in the web part. If there is no document title set, the document's filename is displayed. </li> <li><strong>Show tasks for all users:</strong> You can choose to display the tasks for the current user only (default) or for all users (another column is added).</li> <li><strong>Time elapsed:</strong> Adds a column to show the time elapsed since the item was created.</li> <li><strong>Initiator:</strong> Adds a column to display the user who initiated the workflow.</li> <li><strong>Status indicator:</strong> The status indicator has three states, &quot;New&quot;, an orange circle and a red circle. Setting the interval here determines how much time before the &quot;Expected duration&quot; the red circle is displayed. The same interval is used for the other two states. For example, if the status indicator interval is set at 8 hours, and the Expected duration is set at 5 days, then the red indicator will be displayed 8 hours before the duration is reached, the orange icons will be displayed between 8 hours and 16 hours and all time before that that status is displayed as new. </li> </ol> </li> <li><strong>Item name URL:</strong> Specifies where the user is directed to when they click on the list item name in the web part. <ol> <li><strong>Task display form:</strong> Directs to the view page of the task item. Please note: The default view form for 'Request approval', 'Request review' and 'Assign a Flexi task' has the same behavior as the edit form.</li> <li><strong>Task edit form:</strong> Directs to the edit page of the task.</li> <li><strong>Item display URL:</strong> Directs to the item that the task is associated to.</li> <li><strong>Custom:</strong> Specify a custom page to direct to. The following placeholders can be added to the query string: <ul> <li><strong>{TaskListID}:</strong> The GUID of the task list.</li> <li><strong>{TaskItemID}:</strong> The ID of the task item in the task list.</li> <li><strong>{ListID}:</strong> The GUID of the list that the workflow associated to the task is running in.</li> <li><strong>{ItemID}:</strong> The ID of the item that the workflow associated to the task is running on.</li> </ul> </li> </ol> </li> <li><strong>Default sorting:</strong> Specifies the order that records are displayed in.</li> </ul> </div> </DIV><a name="Nintex.Workflow.SchedulingWorkflow"><H2>3.7 Scheduling a workflow</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>A library or list item can be regularly subjected to a workflow to suit your business requirements. </p> <p>To schedule a workflow for an item, navigate to the item's location, activate the document drop-down and click the &quot;Schedule Workflows&quot; link. </p> <p><img src="content/nintex.workflow.schedulingworkflow1.png" alt="" height="294" width="206" border="1" /></p> <p>If no schedules have been made before, you will need to create one. To do so, click the &quot;Add Schedule&quot; button. </p> <p><img src="content/nintex.workflow.schedulingworkflow2.png" alt="" height="120" width="600" border="1" /></p> <p>A form will load in which you will need to configure a number of settings. The first is to choose a workflow from the drop-down menu. </p> <p><img src="content/nintex.workflow.schedulingworkflow3.png" alt="" height="41" width="600" border="1" /></p> <p>You will then need to set a date and time for the workflow schedule to begin. </p> <p><img src="content/nintex.workflow.schedulingworkflow4.png" alt="" height="46" width="600" border="1" /></p> <p>You can then set the frequency of the scheduled repetition. You can choose between hours, days and months. There is no maximum number that can be entered. Numbers entered must be integers (whole numbers, not decimals). Workdays are set by an administrator via the &quot;Site Settings &gt; Site Administration &gt; Regional settings&quot; section. Public holidays and any other special occasions are set using the &quot;Site Settings &gt; Nintex Workflow &gt; Manage Holidays&quot; page. </p> <p><img src="content/nintex.workflow.schedulingworkflow5.png" alt="" height="70" width="600" border="1" /></p> <p>The end of the scheduling cycle can then be set. You can choose to end the schedule on a certain date and time, by defining the number of times the repetition should run or you can allow it to run indefinitely. </p> <p><img src="content/nintex.workflow.schedulingworkflow6.png" alt="" height="94" width="600" border="1" /></p> <p>When you have finished configuring the page, click the &quot;Save&quot; button to continue. The scheduled workflow will appear on the &quot;Scheduled Workflows&quot; list page.</p> <p>To configure an existing schedule, click the hyperlink of the schedule in the list and edit the settings in the same manner as above. </p> <p><strong>Please note :</strong> If you make a change to a schedule it will take effect immediately. If the document is currently in the workflow, changing the schedule will not disrupt it, the schedule will be updated once the workflow has been completed. </p> </div> </DIV><a name="Nintex.Workflow.StartWorkflow"><H2>3.8 Starting a workflow</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>There are three ways to start a workflow, depending on how the workflow is configured. </p> <p><strong>Start manually:</strong> A user wishing to apply workflow to an item must manually select a workflow from a list of those available. Only workflows that have the option &quot;Start manually&quot; enabled will be listed. This help page will explain how to start a workflow manually. </p> <p><strong>Start when items are created:</strong> when a library or list item is created or uploaded, all workflows in the library or list with this option enabled will start. </p> <p><strong>Start when items are modified:</strong> when a library or list item is modified, all workflows in the library or list with this option enabled will start. </p> <p><strong>PLEASE NOTE:</strong> Workflows are associated with a library or a list. Folders and sub-folders within libraries are subject to the same workflows as the parent library. Therefore, if you set a workflow to start when items are created or modified, any item, regardless of how many folders or sub-folders down it is stored, will trigger all the workflows that are set to start automatically. That behavior is governed by SharePoint.</p> <p><strong>STARTING A WORKFLOW MANUALLY</strong></p> <p>To start a workflow manually, navigate to the list or library that contains the item you wish to push through a workflow. Locate the item then activate the item's drop-down menu then select the &quot;workflows&quot; link.</p> <p><img src="content/nintex.workflow.startworkflow1.png" alt="" height="345" width="346" border="1" /></p> <p>The SharePoint workflows page will load. A list of workflows that have been published and are available for manual initiation is displayed. To select a workflow, click the corresponding hyperlink.</p> <p><img src="content/nintex.workflow.startworkflow2.png" alt="" height="283" width="600" border="1" /> </p> <p>The selected workflow will be displayed in the browser. All you have to do now is click the &quot;Start&quot; button and the workflow will be initiated. </p> <p><img src="content/nintex.workflow.startworkflow3.png" alt="" height="431" width="600" border="1" /></p> <p>You will be returned to the library or list and the progress of the selected workflow will be displayed in-line with the item. The item could be a part of a number of different workflows and that states will show up in the same way under the column heading named after the workflow.</p> <p><img src="content/nintex.workflow.startworkflow4.png" alt="" height="96" width="600" border="1" /> </p> </div> </DIV><a name="Nintex.Workflow.WorkflowHistory"><H2>3.9 Viewing workflow history</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>To view the item's workflow history, locate the item in its library or list, activate its drop-down then click the &quot;View Workflow History&quot; link. </p> <p><img src="content/nintex.workflow.workflowstatus1.png" alt="" height="299" width="435" border="1" /></p> <p>The Workflow Status page will be loaded. It shows workflows that are running, completed, cancelled and errored. Click on the title of the workflow you wish to check for more information. In the &quot;Completed Workflows&quot; and &quot;Cancelled &amp; Errored Workflows&quot; sections there could be multiple identical titles, which will mean the item has been through the same workflow a number of times before. Ensure that you choose the relevant workflow instance. The easiest way is to choose by date. </p> <p><img src="content/nintex.workflow.workflowstatus2.png" alt="" height="181" width="600" border="1" /></p> <p>The workflow will be loaded into the Workflow Viewer which gives a visual representation of the workflow. A summary is shown in the top left corner. </p> <p><img src="content/nintex.workflow.workflowstatus4.png" alt="" height="144" width="310" border="0" /></p> <p>To access the Workflow History, click the link &quot;Click here to show detail view&quot;. Please note - the green circle visible next to the user name in the screenshot above is only available when using <a href="http://office.microsoft.com/en-us/communicationsserver/fx101729111033.aspx">Microsoft Office Live Communication Server</a>, it is not a feature of Nintex Workflow 2007.</p> <p>The Workflow History page will load. </p> <p><img src="content/nintex.workflow.workflowhistory1.png" alt="" height="259" width="600" border="1" /></p> <p>The Workflow History has three sections:</p> <ul> <li><strong>Action History:</strong> The Action History shows every completed action associated with the workflow in order. Actions are added to the top of the list, so the first action to have completed is always at the bottom of the list. The action's start and end times and its time taken to complete (duration) are shown. Many workflow actions are instant, so expect to see many durations of &quot;0 minutes&quot;. </li> <li><strong>Task History:</strong> The Task History section shows the status of tasks that were created by user interaction workflow actions such as the "Request approval" action. The start time, end time, outcome and any comments entered for the task are listed.</li> <li><strong>Workflow Messages:</strong> This section shows all messages that are generated by actions in the workflow. It also shows comments made by users (when required) and messages that are programmed to appear when the &quot;Log in the history list&quot; action is used. </li> </ul> <p>You can toggle between the Workflow History view and the Graphical view of the workflow by using the &quot;Show Graphical View&quot; above the Action History. </p> </div> </DIV><a name="Nintex.Workflow.WorkflowStatus"><H2>3.10 Viewing workflow status</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>When an item is in a workflow, sometimes it is necessary to know what stage the item has reached in the workflow.</p> <p>To view the item's workflow status, locate the item in its library or list, activate its drop-down then click the &quot;View Workflow History&quot; link. </p> <p><img src="content/nintex.workflow.workflowstatus1.png" alt="" height="299" width="435" border="1" /></p> <p>The Workflow Status page will be loaded. It shows workflows that are running, completed, cancelled and errored. Click on the title of the workflow you wish to check for more information. In the &quot;Completed Workflows&quot; and &quot;Cancelled &amp; Errored Workflows&quot; sections there could be multiple identical titles, which will mean the item has been through the same workflow a number of times before. Ensure that you choose the relevant workflow instance. The easiest way is to choose by date. </p> <p><img src="content/nintex.workflow.workflowstatus2.png" alt="" height="181" width="600" border="1" /></p> <p>The workflow will be loaded into the Workflow Viewer which gives a visual representation of the workflow. </p> <p><img src="content/nintex.workflow.workflowstatus3.png" alt="" height="387" width="600" border="1" /> </p> <p>A summary is shown in the top left corner. It contains the title of the item in the workflow, the name of the workflow, the initiator of the workflow, the date and time it was initiated and its status. As mentioned above, the possible workflow states are &quot;Running&quot;, &quot;Completed&quot;, &quot;Cancelled&quot; and &quot;Errored&quot;. Clicking the detailed view link will display the workflow history in text format. For more information, please refer to the <a href="#nintex.workflow.workflowhistory">Workflow History help page</a>.</p> <p><img src="content/nintex.workflow.workflowstatus4.png" alt="" height="144" width="310" border="0" /></p> <p>Please note - the green circle visible next to the user name in the screen shot above is only available when using <a href="http://office.microsoft.com/en-us/communicationsserver/fx101729111033.aspx">Microsoft Office Live Communication Server</a>, it is not a feature of Nintex Workflow 2007. </p> <p>If you mouse over an action's icon, it will provide information about it in a pop-up. In the case of the &quot;Request approval&quot; and &quot;Request review&quot; actions the states can be Approved, Rejected, Pending, Cancelled, Not required and Continue (Request review only).</p> <p><img src="content/nintex.workflow.workflowstatus5.png" alt="" height="172" width="374" border="1" /></p> <p><strong>COLOUR CODING</strong></p> <p>When an action is current, or waiting for some sort of action, its title bar, frame and interior will appear yellow. </p> <p>When an action is complete, or &quot;Request approval&quot; or &quot;Request review&quot; action is approved, its title bar, frame and interior will appear green.</p> <p>When a &quot;Request approval&quot; or &quot;Request review&quot; action is rejected, its title bar, frame and interior will appear red.</p> <p>If an action has not yet occurred, or was not necessary, its title bar, frame and interior will remain gray. </p> </div> </DIV><a name="Nintex.Workflow.MyWorkflows"><H2>3.11 Workflows I have started web part</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Workflows I've started&quot; web part is used to display a list of workflows that have been started by the user that is currently logged in.</p> <p>To use the web part, it must be added to the home page of a site. Navigate to the home page of the site to which you want to add the web part then click &quot;Site Actions&quot; then &quot;Edit Page&quot;.</p> <p><img src="content/nintex.workflow.myworkflows1.png" alt="" height="167" width="266" border="1" /></p> <p>The web part is best added to the left zone of the page so that the columns it contains have sufficient space to display items. In the left zone, click the link &quot;Add a Web Part&quot;.</p> <p><img src="content/nintex.workflow.myworkflows2.png" alt="" height="57" width="553" border="1" /></p> <p>The &quot;Workflows I've Started&quot; web part is listed as follows in the &quot;Add Web Parts&quot; dialog.</p> <p><img src="content/nintex.workflow.myworkflows3.png" alt="" height="51" width="460" border="1" /></p> <p>Check the box to its left then click the &quot;Add&quot; button at the bottom of the dialog box. </p> <p><img src="content/nintex.workflow.myworkflows4.png" alt="" height="138" width="561" border="1" /></p> <p>The page will reload with the web part in place. If you left click and keep the mouse button depressed, you can drag the web part up or down to re-position where it appears on the page. </p> <p>The default web part settings will display:</p> <ul> <li>The item's title.</li> <li>The name of the workflow.</li> <li>When the workflow was initiated.</li> <li>How long it has been idle or completed.</li> <li>The action for which the running workflow is waiting (effectively the workflow's status).</li> </ul> <p>If you would like to use the web part with its default settings, then click &quot;Exit Edit Mode&quot;.</p> <p><img src="content/nintex.workflow.myworkflows5.png" alt="" height="88" width="142" border="1" /></p> <p>To edit the default settings for the web part, click the &quot;Edit&quot; button then &quot;Modify Shared Web Part&quot;. </p> <p><img src="content/nintex.workflow.myworkflows6.png" alt="" height="129" width="218" border="1" /></p> <p>A series of options will be shown to the right of the page that are specific to this web part.</p> <p><img src="content/nintex.workflow.myworkflows7.png" alt="" height="286" width="265" border="1" /></p> <p><strong>WEB PART OPTIONS </strong></p> <ul> <li><strong>Show workflows from:</strong> You can choose to show workflows from the current site or from all the sites in the site collection. Enterprise Licenses can also choose the entire Farm.</li> <li><strong>Paging:</strong> You can choose how many items are displayed on the page by the webpart.</li> <li><strong>Display:</strong> By default, document titles are displayed in the web part. If there is no document title set, the document's filename is displayed. You can choose to always display filenames instead of document titles. You can also choose to display workflows that are completed, have errored or have been cancelled. Their status will be displayed in the &quot;Current action&quot; column. </li> <li><strong>Default sorting:</strong> Specifies the order that records are displayed in.</li> </ul> </div> </DIV><a name="Nintex.Workflow.SectionActions"><H1>4 Workflow Actions</H1></a><a name="Nintex.Workflow.ActionSet"><H2>4.1 Action Set</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Action set&quot; action allows you to bundle a collection of actions in a container that can be collapsed and expanded to make workflow designing more convenient. </p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <h2>Options for this action </h2> <p>This action does not require any configuration. It has a border that contains a pearl and when actions are added to the pearl inside the border, they become part of the action set. </p> <p><img src="content/nintex.workflow.actionset1.png" alt="" height="523" width="372" border="1" /></p> <p>You can minimize the action set by activating the title bar's drop down and clicking &quot;Minimize&quot;.</p> <p><img src="content/nintex.workflow.actionset2.png" alt="" height="379" width="382" border="1" /> </p> <h3>Saving as a snippet </h3> <p>To save an action set as a snippet, activate the drop down menu on the action title bar and click &quot;Save as Snippet &quot;. For more information, please refer to the <a href="#nintex.workflow.snippets">Snippets help page</a>.</p> </div> </DIV><a name="Nintex.Workflow.AddUserToADGroup"><H2>4.2 Add User To AD Group</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p>This workflow action will add a User to an Active Directory security group.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <p><img src="content/nintex.workflow.addusertoadgroup1.png" alt="" height="550" width="600" border="1" /></p> <h2>Options within this action</h2> <h3>LDAP Path</h3> <p>An LDAP path specifying the Active Directory location. E.g. LDAP://Nintex.com/OU=External,DC=nintex,DC=com</p> <p>In this example, the organization unit &lsquo;External&rsquo; in the Nintex.com domain will be searched to find the User and Group.</p> <p>You can click on the LDAP Picker button on the right of the LDAP Path field to browse an LDAP Path.</p> <h3>Username</h3> <p>The administrative username to use when connecting to LDAP. Note: This user must have access to add users to groups in the LDAP location specified above.</p> <h3>Password</h3> <p>The password of the administrative account used to connect to LDAP.</p> <p>Click on the padlock to select from a list of Credential Workflow Constants, maintained in Site Settings by your system administrator.</p> <p><img src="content/nintex.workflow.addusertoadgroup2.png" alt="" height="317" width="433" border="1" /></p> <h2>Add User to AD Group</h2> <h3>User</h3> <p>The username (sAMAccountName) of the Active Directory entry.</p> <h3>Group</h3> <p>The name of an existing Group to which the user will be added. E.g. Backup Operators. Multiple groups can be separated with semi-colons (;)</p> <h3>Error the workflow if the user already exists in the group</h3> <p>Selecting this option will cause the workflow to error if the user already exists in the group. By default this option is checked.</p> </div> </DIV><a name="Nintex.Workflow.ToDoTask"><H2>4.3 Assign a ToDo Task</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This action allows you to assign a SharePoint task to one or more users. The action can be configured to wait until all users have completed the task, or, continue after the first respondent. This action also encapsulates task reminders and escalation. This action includes functionality provided by the task reminder, delegate workflow task, and complete workflow task actions.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue "pearl" on the design canvas. Alternatively, you can right-click a pearl, mouse-over "Insert Action" and select the action from the "User Interaction" group within the list.</p> <p><img src="content/nintex.workflow.todotask1.png" alt="" height="140" width="158" border="1" /></p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within this action</h2> <p><img src="content/nintex.workflow.todotask2.png" alt="" height="659" width="600" border="1" /></p> <h3>Assignees</h3> <p>The assignees list is a mandatory field that contains all users or groups that will be assigned the task when the workflow runs.</p> <p>Users can be entered directly using their username, email address or full name and will be resolved where possible against the SharePoint user list or Active Directory.</p> <p>In the case when a group is assigned the task and Expand Groups is not selected, all users in that group will receive the task notification however, the first respondent will represent the entire group. If Expand Groups is selected, an individual task will be assigned to every member of the group. <br /> Note: Groups will only be expanded to one level. Groups within groups will not be expanded.</p> <p>In order to search for users, click on the address book icon to the right.</p> <h4><a name="spg"></a>Select People and Groups</h4> <p><img src="content/nintex.workflow.selectpeopleandgroups.png" alt="select" height="466" width="600" border="1" /></p> <p>This configuration popup allows you to search for and/or add users to the approvers list. Three tools are provided - click the title bar to expand or collapse each one. The three tools provided are:</p> <ul> <li><strong>Internal Search:</strong> By entering a partial display name, email or user account name and clicking on the magnifying glass, the system will provide you with a list of matching users and groups from SharePoint as well as Active Directory.</li> <li><strong>Add External Email Address:</strong> Allows you to enter an external email address manually. Where possible Nintex Workflow 2007 will resolve this to an actual user account.</li> <li><strong>Lookup: </strong>Allows you to add a dynamic reference as an approver. e.g. Workflow variable, list field.</li> </ul> <h3>Edit settings for</h3> <p>By changing this setting from the default "All Assignees", it allows you to configure unique notification options for each assignee in the list. Unless specifically configured, assignees will use the "All Assignees" settings. To override settings for a specific assignee, select their name from the drop down list.</p> <p><img src="content/nintex.workflow.todotask3.png" alt="" height="146" width="432" border="1" /></p> <h3>Delegate task when Assigned To changes</h3> <p>When this option is selected, if the assignee field of the task is changed, Nintex Workflow will record the change as a task delegation and the new assignee will receive the Response Required Notification. If this option is not selected, Nintex Workflow will not track the change to the assignee and Nintex Workflow reports and web parts will not reflect the new assignee.</p> <h3>Notification Settings</h3> <p>There are two different notifications that can be configured:</p> <ul> <li><strong>Response Required:</strong> Sent when the task is assigned to a user. This is also used when the task is delegated by one user to another. </li> <li><strong>Response No Longer Required:</strong> Sent when the user no longer needs to respond to the task. This can occur when a task is assigned to multiple users but only one is required to respond, when the workflow is terminated prior to the task being processed, or when an error occurs in the workflow. </li> </ul> <p><img src="content/nintex.workflow.flexitask4.png" alt="" height="345" width="595" border="1" /></p> <h3>Delivery Type</h3> <p>Delivery type is the method of delivering the notification to the primary and, if included, auxiliary user(s). </p> <p>You can choose between None, Email, Instant Message or &quot;User preference&quot;. For information on &quot;User preference&quot;, please refer to the <a href="#nintex.workflow.userpreferences">User Preferences Help Page</a>. </p> <h3>CC</h3> <p>The CC field sets auxiliary user(s) who will receive the notification.</p> <p>To set the auxiliary user(s) click on <img src="content/nintex.workflow.browseicon.png" alt="" height="12" width="15" border="0" /> to open the 'Select People and Groups' popup.</p> <h3>From</h3> <p>The From field, if specified, overrides the default sender of the notification. By default the sender is configured to use the setting configured in <a href="#nintex.workflow.globalsettings">Global Settings</a>.</p> <h3>Importance</h3> <p>The priority of the notification. This is only applicable when using email notifications.</p> <h3>Subject</h3> <p>The Subject is the title of the notification being sent and is a mandatory field. If an LCS/OCS message is being sent it will be pre-pended to the body of the notification.</p> <p>You can either type the Subject of the notification manually or by clicking on <img src="content/nintex.workflow.browseicon.png" alt="" height="12" width="15" border="0" /> you are able to <a href="#nintex.workflow.insertreference">insert references</a> from within the runtime instance of the workflow. </p> <h3>Show Attachments</h3> <p>Allows file attachments to be added to the notification .Please note: Files will not be received by a user when SMS or IM is selected as the delivery method.</p> <h3>Format</h3> <p>This sets the format of the email. If Rich Text is selected you will be able to italicize, bold, underline and indent information within your email using simple HTML styles provided by the SharePoint rich text tool bar. Plain Text is simply the text without any stylized formatting.</p> <h3>Notification Body</h3> <p>The body of the notification will adapt depending on whether the Plain Text or Rich Text format is selected. Within the space provided you can enter the content for notification as straight text and <a href="#nintex.workflow.insertreference">references</a> from with the workflow.</p> <h3>Edit Task Description</h3> <p>Allows entry of dynamic text that will display on the task response form. This can be used to communicate additional information about the task to the responding user.</p> <h3>Reminders</h3> <p><img src="content/nintex.workflow.flexitask5.png" alt="" height="485" width="600" border="1" /></p> <p>Optionally, you can configure a notification reminder to be sent to each assignee who has not yet completed the task. As well as customising the notification, you can also configure the following reminder settings:</p> <h3>Number of reminders</h3> <p>The number of reminders to send.</p> <h3>Time between reminders</h3> <p>The delay before sending each reminder in days, hours and minutes. Note: The total time is calculated by summing all fields, regardless of the Time Calculation option selected. For example, 4 days and 4 minutes will be calculated as 96 (24x4) hours and 4 minutes.</p> <h3>Time calculation</h3> <p>Specifies whether or not hours outside the work week should be included when counting down to send a reminder. The 'During business days only' option will specify that weekends or holidays are not included in the countdown, but after hours on a business day are. The 'During business hours only' option specifies that only business hours are used in the countdown. If neither option is selected, all hours will be included in the countdown. The following two examples will further explain the behaviour of each option:</p> <p><b>Example 1:</b> The task is assigned Friday morning and is configured to wait 1 day before sending a reminder. The work week is defined as Monday to Friday.</p> <p><b>Example 2:</b> The task is assigned Wednesday at 4pm and is configured to wait 4 hours before sending a reminder. The work day is defined as Monday to Friday, 8am to 5pm.</p> <h4>During business days only</h4> <p>Example 1 will send a reminder Monday morning because weekends are not included in the count down.</p> <p>Example 2 will send a reminder at 9pm on Wednesday because after business hours are included in the count down.</p> <h4>During business hours only</h4> <p>Example 1 will send a reminder Monday morning because weekends are not included in the count down.</p> <p>Example 2 will send a reminder at 11am on Thursday because after business hours are not included in the count down.</p> <h4>Neither option</h4> <p>Example 1 will send a reminder Saturday morning because weekends are included in the count down.</p> <p>Example 2 will send a reminder at 9pm on Wednesday because after business hours are included in the count down.</p> <h3>Escalation</h3> <p>Optionally, you can configure escalation. There are two possible escalation paths. Delegate task and complete task. Escalation occurs after all reminders have been sent and the specified "Time to escalation" has elapsed.</p> <p>Delegate task will re-assign all pending tasks to the nominated user after the specified time.</p> <p>Complete task will auto-respond to all pending tasks and set the overall outcome of the action to the indicated outcome after the specified time.</p> <h3>Task options</h3> <p>There are two behavioural alternatives to instruct Nintex Workflow how to handle tasks with multiple assignees. These are:</p> <ul> <li><strong>All must respond:</strong> All assignees must complete the task before the workflow will continue.</li> <li><strong>First response applies:</strong> After the first response is received, all other tasks will be set to 'not required'.</li> </ul> <h3>Content type</h3> <p>You can choose to use an existing, or instruct Nintex Workflow to create, a new content type. If using an existing content type, you will be able to select any content type that inherits from 'Workflow Task' but does not inherit from 'Nintex Workflow Task'. The 'Nintex Workflow Task' content type is reserved for request approval and request review actions. If selecting an existing content type, you can specify the value to assign to each field when the task is created.</p> <h3>Store task Ids in</h3> <p>When the workflow runs, the ID given to each task that is created will be stored into the selected collection variable.</p> <h3>Item Permissions</h3> <p><b>Set user permissions to</b>: Sets the user permission on the item.</p> <p><b>When task is complete, set user permissions to</b>: Sets the user permission on the item after the task has been completed.</p> <p>Note: Setting the item permissions could be useful when the task is delegated, this will give the delegated user the necessary permissions to view the item.</p> </div> </DIV><a name="Nintex.Workflow.FlexiTask"><H2>4.4 Assign Flexi Task</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This action allows you to assign a task to one or more users and request a specific outcome. The list of possible outcomes is determined by the workflow designer. This action also encapsulates task reminders and escalation. It also includes functionality provided by the 'Task reminder', 'Delegate workflow task', and 'Complete workflow task' actions.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue "pearl" on the design canvas. Alternatively, you can right-click a pearl, mouse-over "Insert Action" and select the action from the "User Interaction" group within the list. You will need a string workflow variable to store the action outcome and a yes/no workflow variable to store whether or not an outcome was achieved.</p> <p><img src="content/nintex.workflow.flexitask1.png" alt="" height="143" width="600" border="1" /></p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within this action</h2> <p><img src="content/nintex.workflow.flexitask2.png" alt="" height="950" width="600" border="1" /></p> <h3>Assignees</h3> <p>The assignees list is a mandatory field that contains all users or groups that will be assigned the task when the workflow runs.</p> <p>Users can be entered directly using their username, email address or full name and will be resolved where possible against the SharePoint user list or Active Directory. Please note that users and groups that do not resolve automatically will require <a href="#nintex.workflow.lazyapproval">LazyApproval</a> to complete their assigned task.</p> <p>In the case when a group is assigned the task and Expand Groups is not selected, all users in that group will receive the task notification however, the first respondent will represent the entire group. If Expand Groups is selected, an individual task will be assigned to every member of the group. <br />Note: Groups will only be expanded to one level. Groups within groups will not be expanded.</p> <p>In order to search for users, click on the address book icon to the right.</p> <h4><a name="spg"></a>Select People and Groups</h4> <p><img src="content/nintex.workflow.selectpeopleandgroups.png" alt="select" height="466" width="600" border="1" /></p> <p>This configuration popup allows you to search and/or add users to the approvers list. Three tools are provided - click the title bar to expand or collapse each one. The three tools provided are:</p> <ul> <li><strong>Internal Search:</strong> By entering a partial display name, email or user account name and clicking on the magnifying glass the system will provide you with a list of matching users and groups from SharePoint as well as Active Directory.</li> <li><strong>Add External Email Address:</strong> Allows you to enter an external email address manually. Where possible Nintex Workflow 2007 will resolve this to an actual user account.</li> <li><strong>Lookup: </strong>Allows you to add a dynamic reference as an approver. e.g. Workflow variable, list field.</li> </ul> <h3>Edit settings for</h3> <p>By changing this setting from the default "All Assignees", it allows you to configure unique notification options for each assignee in the list. Unless specifically configured, assignees will use the "All Assignees" settings. To override settings for a specific assignee, select their name from the drop down list.</p> <p><img src="content/nintex.workflow.flexitask3.png" alt="" height="176" width="488" border="1" /></p> <h3>Allow Delegation</h3> <p>When this option is selected the assignee at runtime can delegate the task to another user. For more information, please refer to the <a href="#nintex.workflow.delegation">Delegating Approval Tasks help page</a>.</p> <h3>Allow Lazy Approval</h3> <p>If LazyApproval has been enabled for your server, you can permit the assignees to use <a href="#nintex.workflow.lazyapproval">Lazy Approval</a>. LazyApproval allows users to respond to tasks via email by replying to the task notification message with their chosen outcome.</p> <h3>Notification Settings</h3> <p>There are two different notifications to configure</p> <ul> <li><strong>Response Required:</strong> Sent when the task is assigned to a user. This is also used when the task is delegated by one user to another. </li> <li><strong>Response No Longer Required:</strong> Sent when the user no longer needs to respond to the task. This can occur when a task is assigned to multiple users but only one is required to respond, when the workflow is terminated prior to the task being processed, or when an error occurs in the workflow. </li> </ul> <p><img src="content/nintex.workflow.flexitask4.png" alt="" height="345" width="595" border="1" /></p> <h3>Delivery Type</h3> <p>Delivery type is the method of delivering the notification to the primary and if included, auxiliary user(s). </p> <p>You can choose between None, Email, Instant Message or &quot;User preference&quot;. For information on &quot;User preference&quot;, please refer to the <a href="#nintex.workflow.userpreferences">User Preferences Help Page</a>. </p> <h3>CC</h3> <p>The CC field sets auxiliary user(s) who will receive the notification.</p> <p>To set the auxiliary user(s) click on <img src="content/nintex.workflow.browseicon.png" alt="" height="12" width="15" border="0" /> to open the Select People and Groups popup.</p> <h3>From</h3> <p>The From field, if specified, overrides the default sender of the notification. By default the sender is configured to use the setting configured in <a href="#nintex.workflow.globalsettings">Global Settings</a>.</p> <h3>Importance</h3> <p>The priority of the notification. This is only applicable when using email notifications.</p> <h3>Subject</h3> <p>The Subject is the title of the notification being sent and is a mandatory field. If an LCS/OCS message is being sent it will be pre-pended to the body of the notification.</p> <p>You can either type the Subject of the notification manually or by clicking on <img src="content/nintex.workflow.browseicon.png" alt="" height="12" width="15" border="0" />, you are able to <a href="#nintex.workflow.insertreference">insert references</a> from within the runtime instance of the workflow. </p> <h3>Show Attachments</h3> <p>Allows file attachments to be added to the notification. Please note: Files will not be received by a user when SMS or IM is selected as the delivery method.</p> <h3>Format</h3> <p>This sets the format of the email. If Rich Text is selected you will be able to italicize, bold, underline and indent information within your email using simple HTML styles provided by the SharePoint rich text tool bar. Plain Text is simply the text without any stylized formatting.</p> <h3>Notification Body</h3> <p>The body of the notification will adapt depending on whether the Plain Text or Rich Text format is selected. Within the space provided you can enter the content for the notification as straight text and <a href="#nintex.workflow.insertreference">references</a> from with the workflow.</p> <h3>Edit Task Description</h3> <p>Allows entry of dynamic text that will display on the task response form. This can be used to communicate additional information about the task to the responding user.</p> <h3>Reminders</h3> <p><img src="content/nintex.workflow.flexitask5.png" alt="" height="485" width="600" border="1" /></p> <p>Optionally, you can configure a notification reminder to be sent to each assignee who has not yet completed the task. As well as customising the notification, you can also configure the following reminder settings:</p> <h3>Number of reminders</h3> <p>The number of reminders to send.</p> <h3>Time between reminders</h3> <p>The delay before sending each reminder in days, hours and minutes. Note: The total time is calculated by summing all fields, regardless of the Time Calculation option selected. For example, 4 days and 4 minutes will be calculated as 96 (24x4) hours and 4 minutes.</p> <h3>Time calculation</h3> <p>Specifies whether or not hours outside the work week should be included when counting down to send a reminder. The 'During business days only' option will specify that weekends or holidays are not included in the count down, but after hours on a business day are. The 'During business hours only' option specifies that only business hours are used in the count down. If neither option is selected, all hours will be included in the count down. The following two examples will further explain the behaviour of each option:</p> <p><b>Example 1:</b> The task is assigned Friday morning and is configured to wait 1 day before sending a reminder. The work week is defined as Monday to Friday.</p> <p><b>Example 2:</b> The task is assigned Wednesday at 4pm and is configured to wait 4 hours before sending a reminder. The work day is defined as Monday to Friday, 8am to 5pm.</p> <h4>During business days only</h4> <p>Example 1 will send a reminder Monday morning because weekends are not included in the count down.</p> <p>Example 2 will send a reminder at 9pm on Wednesday because after business hours are included in the count down.</p> <h4>During business hours only</h4> <p>Example 1 will send a reminder Monday morning because weekends are not included in the count down.</p> <p>Example 2 will send a reminder at 11am on Thursday because after business hours are not included in the count down.</p> <h4>Neither option</h4> <p>Example 1 will send a reminder Saturday morning because weekends are included in the count down.</p> <p>Example 2 will send a reminder at 9pm on Wednesday because after business hours are included in the count down.</p> <h3>Escalation</h3> <p>Optionally, you can configure escalation. There are two possible escalation paths. 'Delegate task' and 'Complete task'. Escalation occurs after all reminders have been sent and the specified "Time to escalation" has elapsed.</p> <p>'Delegate task' will re-assign all pending tasks to the nominated user after the specified time.</p> <p>'Complete task' will auto-respond to all pending tasks and set the overall outcome of the action to the indicated outcome after the specified time. The specified outcome does not have to be one of the configured possible outcomes.</p> <h3>Behaviour</h3> <p>There are five behavioural alternatives to instruct Nintex Workflow how to handle tasks with multiple assignees. These are:</p> <ul> <li><strong>First response applies:</strong> The first response received will be used for the overall outcome. All other pending tasks will be set to "not required".</li> <li><strong>Majority must choose a specific outcome:</strong> The majority of assignees must agree on the same outcome. If a majority is not reached, the "outcome achieved" variable will be set to "no" and the overall task outcome will be blank. As soon as Nintex Workflow determines that a majority cannot be reached, the action will complete and all pending tasks will be set to "not required".</li> <li><strong>All must agree on a specific outcome:</strong> All assignees must select the outcome specified in the "Outcome" drop down list. If any assignee chooses an alternative outcome, all pending tasks will be set to "not required", the "outcome achieved" variable will be set to "no" and the overall task outcome will be blank.</li> <li><strong>Majority decides:</strong> The Outcome variable will be set to the most popular outcome. If Nintex Workflow can determine the most popular outcome before all assignees have completed the task, all pending tasks will be set to "not required". If two or more outcomes have the same number of responses after all tasks are completed, the "outcome achieved" variable will be set to "no" and the overall outcome will be blank.</li> <li><strong>All must agree:</strong> All assignees must agree on the same outcome. If an assignee responds with an outcome which differs to a previous respondent, all pending tasks will be set to "not required", the outcome achieved variable will be set to "no" and the overall task outcome will be blank.</li> </ul> <h3>Outcomes</h3> <p>The outcomes define all the possible responses to the task. When completing the task, assignees must choose from one of the listed outcomes. You can add new outcomes by clicking "Add outcome" or remove/edit existing outcomes using the icons. Each outcome is configured with a name and an optional description. The description is displayed on the task response form and can be used to provide instructions and more detail. Whether or not the assignee must provide comments for the outcome can be configured as optional, required or none.</p> <h3>Advanced Options</h3> <p><img src="content/nintex.workflow.flexitask6.png" alt="" height="98" width="600" border="1" /></p> <h4>Do not create branches</h4> <p>When this option is selected, the workflow canvas will not show branches under the Flexi task action. Branching logic can then be implemented manually.</p> <h4>Include an 'Other' branch</h4> <p>When this option is selected, an additional branch will be rendered to capture any outcome that is not explicitly defined in the 'Outcomes' panel. The other branch can be used to capture the case when no outcome is achieved or a custom outcome is used with the 'complete task' escalation option. This option is only available when the 'Do not create branches' option is not selected.</p> <h4>Do not use LazyApproval terms</h4> <p>When this option is selected, LazyApproval responses must be an exact match to an outcome name specified in this Flexi task action. When this option is not selected, any outcome name that is recognized as an 'approve' or 'reject' term as defined in the LazyApproval settings can be responded to with any other 'approve' or 'reject' term.</p> <h3>Store outcome in</h3> <p>After an outcome is reached, this workflow variable will be populated with the chosen outcome. See the Behaviour section for more detail on how the outcome is determined.</p> <h3>Store outcome achieved in</h3> <p>In some circumstances, it is possible that an outcome is not reached. After this action is completed, this workflow variable will be populated to indicate whether or not an outcome has been reached. See the Behaviour section for more details.</p> <h3>Task Name</h3> <p>Allows the title of the task to be defined. This is the title that appears in a SharePoint task list. If left blank, the action title will be used by default.</p> <h3>Task content type</h3> <p>Allows a task content type other than the default to be used. This option will only display if an alternative content type is available on the site. Alternative content types are primarily used to enable custom task response forms.</p> <h3>Priority</h3> <p>Specifies the value that should be assigned to the priority flag for the task.</p> <h3>Item Permissions</h3> <p><b>Set user permissions to</b>: Sets the user permission on the item.</p> <p><b>When task is complete, set user permissions to</b>: Sets the user permission on the item after the task has been completed.</p> <p>Note: Setting the item permissions could be useful when the task is delegated, this will give the delegated user the necessary permissions to view the item.</p> </div> </DIV><a name="Nintex.Workflow.BuildDynamicString"><H2>4.5 Build Dynamic String</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Build dynamic string&quot; action allows the workflow to perform basic string concatenations for use within other actions in the workflow at runtime.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>.</p> <p> <img src="content/nintex.workflow.builddynamicstring1.png" alt="the" height="298" width="571" border="0" /> </p> <h2>Options within the action </h2> <h3>Build string</h3> <p>The build string workspace allows you to combine straight text with <a href="#nintex.workflow.insertreference">references</a> from within the workflow and site at runtime.</p> <h3>Parse for tokens twice</h3> <p>When this option is selected, tokens will be searched for twice. For example, if a token called {WorkflowVariable:EmailTemplate} is inserted into the text area, and the resulting value contains the text {ItemProperty:Title}, the title token will also be replaced when this option is selected.</p> <h3>Store result in</h3> <p>The result of the string that is built at runtime will be stored in a text <a href="#nintex.workflow.workflowvariables">workflow variable</a> that is selected from this list.</p> </div> </DIV><a name="Nintex.Workflow.CalculateDate"><H2>4.6 Calculate Date</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action allows a time period to be added or subtracted from a date to create a new date.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within the action</h2> <h3><img src="content/nintex.workflow.calculatedate1.png" alt="" height="569" width="600" border="1" /></h3> <h3>Date</h3> <p>The date to use as a base for the calculation. The time period change will be applied to this date. It can be a specific date, a lookup from a variable or list, or the current date.</p> <h3>Timeframe</h3> <p>The number of years, months, days, hours and minutes to add to the date. Negative values can be used for a subtraction operation.</p> <h3>Store Date in</h3> <p>A date/time workflow variable in which to store the result of the calculation.</p> <h3>Store ISO 8601 Date string</h3> <p>A text variable that contains the date in the xml friendly ISO 8601 format.</p> </div> </DIV><a name="Nintex.Workflow.CallWebService"><H2>4.7 Call web service</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Call web service&quot; action is for advanced users and allows the workflow to make a call to a SOAP web service method.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within the action</h2> <h3><img src="content/nintex.workflow.callwebservice1.png" alt="the" height="545" width="595" border="1" /></h3> <h3>URL</h3> <p>A mandatory field that represents the full url of the SOAP web service to call. Once a URL has been entered, the Refresh button can be pressed to define the available methods.</p> <h3>Username</h3> <p>The username (including domain) to use when authenticating against the web service. This is an optional setting, however if left blank the web service must be open to anonymous access.</p> <h3>Password</h3> <p>An optional field that is the password used when authenticating against the web service. If left blank, the web service must be open to anonymous access. </p> <h3>Web service message</h3> <p>This defines the values to be sent to the web service. How the message is configured depends on the parameters required by the selected web service method. If the web service method only requires parameters of 'simple' data types, an input form is displayed to allow these values to be provided. This is the 'SOAP Builder' form. If the web service method requires ýÿcomplexýÿ parameters the SOAP Builder form cannot be displayed, and a single text box to edit the xml of the SOAP message directly is provided.</p> <p>The SOAP message xml can also be edited directly when the selected web service method only requires simple data types. Choose the 'SOAP Editor' option to switch to this mode.</p> <p>Editing the SOAP manually requires some advanced knowledge of web services, or at the very least a well documented web service that covers the request form in detail. </p> <p>For more information on the SOAP standard please refer to <a href="http://www.w3.org/tr/soap12-part0"> http://www.w3.org/TR/soap12-part0</a>.</p> <p><strong>Please note:</strong> due to their custom nature, Nintex does not provide support for troubleshooting Web Services. </p> <p>If you wish to pass the byte array of the document under workflow, type [FileData] into any input field. At runtime Nintex Workflow will base64 encode the file and pass that as the value.</p> <h3>Encode inserted tokens</h3> <p>Specifies whether inserted tokens (workflow variables, list item properties, etc) should be encoded to ensure they are valid for sending to the web service.</p> <h3>XSL Transform</h3> <p>Allows a XSL transform to be defined. This transform will be applied to the web service results before they are stored in the workflow variable.</p> <h3>Store result in</h3> <p>This list contains all the workflow variables that are of text format and will be used to store the simple type result of the call.</p> <h3>Results format</h3> <p>Defines whether the web service result should be treated as XML or not. If XML is specified, the results will be embedded in a &lt;xml&gt; root element. This is important when designing an XSL or other processing.</p> <p>&nbsp;</p> </div> </DIV><a name="Nintex.Workflow.CancelCheckOut"><H2>4.8 Cancel check out</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Cancel check out&quot; action allows the workflow to cancel a previously checked out document within the current site.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within the action </h2> <p> <img src="content/nintex.workflow.cancelcheckout1.png" alt="the" height="81" width="514" border="1" /></p> <p><strong>Undo Checkout from</strong></p> <p>There are essentially two options when performing an undo, the workflow can either cancel the check out for the item in the workflow or it can cancel the check out for an item somewhere else in the current site. From the drop-down, you can select the current item or the required location.</p> <p><strong>Where</strong></p> <p>If the current item is not selected, use this section to specify which document should have a check out cancelled. Use the <img src="content/nintex.workflow.lookupbutton2.png" alt="the" height="21" width="24" border="0" /> button to configure the criteria based on a <a href="#nintex.workflow.lookups">lookup</a>.</p> </div> </DIV><a name="Nintex.Workflow.ChangeState"><H2>4.9 Change State</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Change State&quot; action instructs a parent State Machine action which state it should run when the current state has finished. &quot;Change State&quot; actions can only be dragged on to the designer where it is in a State Machine action.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h3>Options within this action</h3> <p><img src="content/nintex.workflow.changestate1.png" alt="" height="546" width="599" border="1" /></p> <p><strong>Select Next State </strong></p> <p>Choose a state from the drop-down to determine which state will be used after the one currently selected has completed.</p> <p> Please note that the &quot;Change State&quot; action does not instantly change execution to the new state, it only sets which state should be run next.<br /> Selecting &lsquo;End State Machine&rsquo; will exit the State Machine construct when the current state has finished running.</p> </div> </DIV><a name="Nintex.Workflow.CheckInItem"><H2>4.10 Check in item</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The workflow action &quot;Check in item&quot; allows the workflow to check-in an item in an item that was checked out with the Check out item action. The workflow will error if checking in an item that was checked out by a user.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon . For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within the action</h2> <p>There are essentially two options when checking in a document, whether to check in for the item currently in the workflow or to check in an item somewhere else in the current site. From the drop-down, you can select the current item or the required location. If it is the current item, no filters need to be selected.</p> <p><img src="content/nintex.workflow.checkinitem1.png" alt="" height="183" width="374" border="1" /></p> <p>In the case of checking in an item from elsewhere in the site, a filter will need to be selected so Nintex Workflow knows which item to check in. First select the column that needs to be matched and then using the <a href="#nintex.workflow.lookups#sv">value lookup</a> set the value to match on. You can then provide comments to explain why the item was checked in. </p> <p><img src="content/nintex.workflow.checkinitemotheritem.png" alt="the" height="549" width="595" border="1" /></p> <h3>Comments</h3> <p>The comments entered will be stored with that items meta data as the check in comments</p> <p><strong>Please note:</strong> The comments are NOT stored in the Workflow History as Nintex Workflow has no access to where SharePoint stores them. </p> <h3>Check in type</h3> <p> The type of check in to perform regarding the document version. Options are Major Version, Minor Version, or No Version Change. The target document library version settings must match what is chosen in the configuration dialog. </p> <p>&nbsp; </p> </div> </DIV><a name="Nintex.Workflow.CheckOutItem"><H2>4.11 Check Out Item</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The action &quot;Check out item&quot; allows the workflow to check out an item in a selected location to the initiator of the workflow. If a library is configured to require check outs, this action must be used to check out the item before an Update List Item action is used.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon . For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>.</p> <p> <img src="content/nintex.workflow.checkoutitem1.png" alt="the" height="106" width="302" border="0" /></p> <p>When designing a workflow on a library, the default settings for this action dictate that the current item will be checked out by the workflow.</p> <p> <img src="content/nintex.workflow.checkoutitemotheritem.png" alt="the" height="147" width="524" border="0" /> </p> <p>When another item within the site is to be checked out some other settings are required to indicate which item it is. First select the list from the current site that contains the item. Once the list is selected the filter needs to be set by choosing the column to match on and the value to match using the <a href="#nintex.workflow.lookups#sv">lookup tool</a>. In the example above you can see that we are checking out the document named &quot;Jan 2007&quot; in the Shared Documents library.</p> <p><strong>Please note:</strong> this action can only work on items within the site containing the workflow. It cannot be used to check-out items in a subsite of the originating site or in a parent site of the originating site.</p> </div> </DIV><a name="Nintex.Workflow.CollectionOperation"><H2>4.12 Collection Operation</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &ldquo;Collection Operation&rdquo; action provides direct access to the values in a collection variable.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list.</p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Available Operations</h2> <p>The Target Collection parameter is required for each operation. This specifies the collection variable that the operation applies to.</p> <p><img src="content/nintex.workflow.collectionoperation1.png" alt="" height="293" width="578" border="1" /></p> <h3>Add</h3> <p>Adds the value specified in the 'value' parameter to the collection. Optionally, a variable storing the index of what position to insert the value in to the collection at can be used. If no index variable is selected, the value will be added to the end of the collection. If the index value is larger than the size of the collection, the workflow will error.</p> <h3>Clear</h3> <p>Removes all entries from the collection.</p> <h3>Count</h3> <p>Outputs a number indicating how many items are currently stored in the collection. The result is stored into a number variable specified for 'Store result in'.</p> <h3>Exists</h3> <p>Outputs a Yes / No value into 'Store result in' to indicate whether or not an item matching the specified value is currently stored in the collection. The comparison is done by comparing the text representation of the 'Value' parameter with the text representation of each item in the collection.</p> <h3>Get</h3> <p>Retrieves a value at a specified index and stores the value in a workflow variable. The output workflow variable must be compatible with the value being retrieved from the collection.</p> <h3>Join</h3> <p>Concatinates every value in the collection into a string which is stored in the 'Store result in' variable. Each value is separated by the specified delimiter value.</p> <h3>Pop</h3> <p>Retrieves the value at the end position of the collection and stores it in the 'Store result in' variable. After this operation, the value will no longer exist in the collection variable therefore the collection will be one item shorter.</p> <h3>Remove At</h3> <p>Removes the value stored in the collection at the specified index. This will cause the collection size to decrease by one.</p> <h3>Remove duplicates</h3> <p>Searches for and removes any values that exist more than once in the collection, leaving only one instance of each value. For text values, duplicate matching is case sensitive.</p> <h3>Remove by value</h3> <p>Removes all items from the collection that equal the specified value.</p> <h3>Sort</h3> <p>Sorts the values in the collection and stores the sorted collection in another collection variable specified in 'Store result in'. 'Store result in' can be the same as the source collection.</p> </div> </DIV><a name="Nintex.Workflow.CommitWorkflow"><H2>4.13 Commit pending changes</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The "Commit pending changes" action forces all existing batched operations to be committed. Batched operations are operations performed by workflow actions that do not commit immediately. For example, the "Update list item" action does not actually update an item immediately, it waits until the workflow commits. The workflow commits at a delay action, a task action or the end of the workflow. When the update list item action runs, it just registers that it needs to update the item, the item actually updates when a commit happens.</p> <p>An example of when to use the "Commit pending changes" is explained below:</p> <p>The SharePoint workflow engine does not necessarily commit batched operations in the order they are displayed on the designer. For example, if the following actions are in this order:</p> <ul> <li>Set item permissions action (Nintex)</li> <li>Update list item action (Microsoft SharePoint)</li> <li>Set item permissions action (Nintex)</li> </ul> <p>These would actually execute in this order:</p> <ul> <li>Set item permissions action (Nintex)</li> <li>Set item permissions action (Nintex)</li> <li>Update list item action (Microsoft SharePoint)</li> </ul> <p>It executes it in this order, because there are actually two batches, the Microsoft batch and the Nintex batch (any other third party has their own batch). This is because third parties cannot add operations to the Microsoft batch. In addition, all items in a single batch are executed before actions in another batch. The batch that is executed first depends on the first activity; If the Microsoft SharePoint action was encountered first, then all the Microsoft actions would run before the Nintex actions. </p> <p>The "Commit pending changes" action is another point where a workflow will execute all its batch operations.</p> <p>Therefore, modifying the above example:</p> <ul> <li>Set item permissions action (Nintex)</li> <li>Update list item action (Microsoft SharePoint)</li> <li>Commit pending changes</li> <li>Set item permissions action (Nintex)</li> </ul> <p>In this case the actions will run in the design order. The Nintex batch will run first because the Nintex action is first encountered, but in this scenario there is only one action in this batch. The "Update item" action will run. Then the workflow will commit, and the final "Set item permissions" action is in a new batch.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue "pearl" on the design canvas. Alternatively, you can right-click a pearl, mouse-over "Insert Action" and select the action you require from the list. </p> <p>This action has no settings to configure.</p> </div></DIV><a name="Nintex.Workflow.CompileAudience"><H2>4.14 Compile Audience</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p><b>* This action requires Microsoft Office SharePoint Server</b></p> <p>This workflow action will compile an existing audience in the environment.</p> <p><img src="content/nintex.workflow.compileaudience1.png" alt="" height="240" width="585" border="0" /></p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate the drop-menu, down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer</a> help page. </p> <h2>Options within this action</h2> <h3>Audience name</h3> <p>The name of the audience to compile.</p> <h3>Credentials</h3> <p>An account with permissions to compile an audience.</p> <h3>Compile type</h3> <p>Specifies whether to perform a complete or incremental compilation.</p> </div> </DIV><a name="Nintex.Workflow.CompleteNWTask"><H2>4.15 Complete Workflow Task</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action will complete any outstanding workflow tasks. It will process enough individual tasks to achieve the selected outcome, the workflow engine will then process the remaining individual tasks in accordance with the task settings.</p> <p><img src="content/nintex.workflow.completenwtask1.png" alt="" height="530" width="579" border="0" /></p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options within this action</h2> <h3>Action ID</h3> <p>When configuring a task action, you can nominate a workflow variable of type Action ID to store the assigned workflow action ID. You must specify this workflow variable to nominate which task action to complete.</p> <h3>Complete after</h3> <p>Specifies how long to wait before the task is completed. If the task is completed manually in this period, the complete action will finish without performing any change to the task. Note that even if the task is set to complete immediately, the action will always wait at least a minute before processing. Note: The total time is calculated by summing all fields, regardless of the Time Calculation option selected. For example, 4 days and 4 minutes will be calculated as 96 (24x4) hours and 4 minutes.</p> <h3>Time calculation</h3> <p>Specifies whether or not hours outside the work week should be included when counting down to automatically complete the task. The 'During business days only' option will specify that weekends or holidays are not included in the count down, but after hours on a business day are. The 'During business hours only' option specifies that only business hours are used in the count down. If neither option is selected, all hours will be included in the count down. The following two examples will further explain the behavior of each option:</p> <p><b>Example 1:</b> The complete task action starts counting down Friday morning and is configured to wait 1 day. The work week is defined as Monday to Friday.</p> <p><b>Example 2:</b> The complete task action starts counting down Wednesday at 4pm and is configured to wait 4 hours. The work day is defined as Monday to Friday, 8am to 5pm.</p> <h4>During business days only</h4> <p>Example 1 will complete the task Monday morning because weekends are not included in the count down.</p> <p>Example 2 will complete the task at 9pm on Wednesday because after business hours are included in the count down.</p> <h4>During business hours only</h4> <p>Example 1 will complete the task Monday morning because weekends are not included in the count down.</p> <p>Example 2 will complete the task at 11am on Thursday because after business hours are not included in the count down.</p> <h4>Neither option</h4> <p>Example 1 will complete the task Saturday morning because weekends are included in the count down.</p> <p>Example 2 will complete the task at 9pm on Wednesday because after business hours are included in the count down.</p> <h3>Task outcome</h3> <p>The value to set outstanding tasks to. Use 'Approved' or 'Rejected' for approval tasks, and 'Continue' for other task types.</p> <h3>Send 'response not required' message</h3> <p>If this is selected, pending approvers that the task completes the action for will receive an email informing them that their input is no longer required. Further tasks that are processed as a result of the complete task action will still receive response not required messages.</p> <h3>Comments</h3> <p>Comments to be recorded when the task is automatically completed. The comments will be added against each individual task that the Complete Task action must process to achieve the desired outcome.</p> <p>Please note that there can be a delay between when the task is processed and when the workflow continues.</p> </div> </DIV><a name="Nintex.Workflow.ConvertValue"><H2>4.16 Convert Value</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action will interpret a provided text value, and store it into a workflow variable of a different type. For example, if a text variable contains a number, this action will store the value as a numeric value in a number variable. </p> <p>A common scenario for using this action is using it with an inline function or the result of a query that returns a text string that contains a number, and that number needs to be stored into a number field of a SharePoint list. The value cannot be stored into a number field while the value is stored in a text variable. This action will allow the number text to be evaluated and stored into a number variable. The example in the screenshot demonstrates processing a text variable by using an inline function to extract the first 4 characters (maybe the variable contains 1234-XXAB). These first 4 characters will then be interpreted and stored into a number variable.</p> <p><img src="content/nintex.workflow.convertvalue1.png" alt="" height="261" width="569" border="0" /></p> <h2>Options within the action</h2> <h3>Input</h3> <p>The value that is to be interpreted.</p> <h3>Store result in</h3> <p>This option specifies the variable that the resulting value will be stored in. If the input text cannot be converted into a value that is compatible with the selected variable, the workflow will error.</p> <h3>Date format</h3> <p>This option only appears when the 'Store result in' variable is a date time variable. This option allows the exact formatting of the input date to be specified. When a date format is specified, the input date will only be recognized if it is an exact match to the format. This URL lists the recognized date formatting values: <a href="http://msdn.microsoft.com/en-us/library/8kb3ddd4.aspx" target="_blank">http://msdn.microsoft.com/en-us/library/8kb3ddd4.aspx</a>. </p> <h3>Culture (Advanced)</h3> <p>Specify the language information to use when attempting to convert the input value into another variable type. For example, if the provided input text contained a number in a European format, specifying a European culture identified (for example, de-DE for German) will ensure the value is interpreted correctly. When this parameter is blank, the current language settings of the SharePoint site will be used. This URL lists the recognized language codes: <a href="http://msdn.microsoft.com/en-us/library/0h88fahh(vs.85).aspx" target="_blank">http://msdn.microsoft.com/en-us/library/0h88fahh(VS.85).aspx</a>. The 'Short string' value should be used when specifying the 'Culture' parameter. Enter the text 'Invariant' to specify an invariant culture. </p> </div> </DIV><a name="Nintex.Workflow.CopyItem"><H2>4.17 Copy an item</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action copies an item from one list or library to another within the current site (not parent sites and not subsites). It only allows copying from the root level of a location (for example, a folder within a document library is not valid) to the root level of another location in the same site. The content type of the source must match the content type of the destination - the workflow will error if the source and destination are incompatible. If you would prefer to copy the library item in the workflow to another location in SharePoint (including folders and sub-folders of the same site), please use the &quot;<a href="#nintex.workflow.copysharepoint">Copy to SharePoint</a>&quot; action. </p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon . For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options for this action </h2> <h3><strong>Copy from</strong></h3> <p>This mandatory field is used to select the list or library where the item that is to be copied is located. </p> <h3><strong>Where</strong></h3> <p>This mandatory field allows you to choose from a drop-down the type of information about the item (for example, &quot;Created By&quot;, &quot;Title&quot;, &quot;Content Type&quot; etc) which is then defined in the field to the right. The information types available in the drop-down are dependent on what properties are used in the original location (set in the &quot;Copy from&quot; step).</p> <p>To add the specific information to match in the right field, you can enter it yourself or you can use the look up feature by clicking on <img src="content/nintex.workflow.lookupbutton2.png" alt="" height="21" width="24" border="0" />. For more details on using lookups, please refer to the <a href="#nintex.workflow.lookups">Lookups Help Page</a></p> <h3><strong>Copy to</strong></h3> <p>This mandatory field is used to select the destination in the current site for the item when it is copied. The destinations available in the drop-down are dependent on the content of the site. Please note, only root level locations are valid (folders and sub-folders are not supported). </p> <h3><strong>Overwrite an existing item</strong></h3> <p>If the item to copy is a file in a library, and a file with the same name already exists in the target library, this option will determine if the file will be overwritten. If this option is not selected, a time stamp will be added to the end of the filename. Note that overwriting a file does not increase its file version.</p> <p>Once the mandatory fields have been completed, click Save at the bottom of the pop-up window and you will return to the design canvas. </p> <p>If the mandatory fields within the &quot;Copy an item&quot; workflow action are not set, a warning icon like the one below will be shown on the design canvas. Until set, the workflow cannot be published.</p> <p><img src="content/nintex.workflow.copyitem2.png" alt="" height="74" width="150" border="0" /></p> <p>Hovering over the workflow action on the design canvas will give you a warning box indicating what mandatory fields need to be set, as shown below.</p> <p><img src="content/nintex.workflow.copyitem3.png" alt="" height="153" width="203" border="0" /></p> </div> </DIV><a name="Nintex.Workflow.CopyFileshare"><H2>4.18 Copy to fileshare</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Copy to fileshare&quot; action downloads a copy of the current item to a specified location. This action is only available when designing the workflow on a library.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon . For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options for this action </h2> <p><img src="content/nintex.workflow.copytofileshare.png" alt="" height="325" width="319" border="1" /></p> <p><strong>Destination</strong></p> <p>This required field must be a valid UNC path accessible from the SharePoint server where Nintex Workflow 2007 is installed e.g. \\myfileserver\reports. If a file name is specified in the destination path, the file will be copied using this file name.</p> <p><strong>Username</strong></p> <p>The user to authenticate against when the document is copied to the specified location.</p> <p><strong>Password</strong></p> <p>The password to authenticate with when the document is copied to the specified location.</p> </div> </DIV><a name="Nintex.Workflow.CopySharePoint"><H2>4.19 Copy to SharePoint</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>The &quot;Copy to SharePoint&quot; action allows the workflow to copy items in workflow to another library within SharePoint. When the workflow is running on document libraries, the item that the workflow is running on will be copied. In a list, any attachments on the list item that the workflow is running on will be copied.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options for this action </h2> <h3>Destination Site</h3> <p>A site picker is displayed that allows you to navigate through the portal structure of the current SharePoint environment and select the library to which the document will be copied. Folders and sub-folders can be selected. Alternatively, the URL option can be selected to use lookups to determine the destination. To copy a file to a remote environment, the URL option must be used. </p> <p><img src="content/nintex.workflow.copysharepoint1.png" alt="the" height="499" width="570" border="1" /></p> <h3>Copy InfoPath form / Copy embedded attachments</h3> <p>This option is available when designing a workflow on a form library. It allows for InfoPath attachments embedded in the form to be extracted and copied. The XPath query is used to indicate where in the form xml structure the attachments exist. If the XPath query evaluates to more than one attachment node, each attachment will be copied. To copy the actual form item in the form library, choose the 'Copy InfoPath form' option.</p> <p><img src="content/nintex.workflow.copysharepoint2.png" alt="" height="68" width="450" border="1" /></p> <h3>Overwrite options</h3> <p>Use this setting to determine the behavior when a file with the same name already exists in the destination.</p> <h4>Remove existing behavior</h4> <p>The file that already exists will be removed. If versioning is enabled in the destination the copy that is created will be an initial version.</p> <h4>Update existing item</h4> <p>The file that already exists will be overwritten. If versioning is enabled in the destination the version of the file will be incremented.</p> <h4>Rename new item</h4> <p>The file that already exists will be not be modified. The copied item will have a time stamp appended to its name.</p> <h3>Create folder structure</h3> <p>Check this box to replicate a folder structure in the target library if the item being copied is in a sub folder. This option is not applicable when the destination is a remote SharePoint environment.</p> <h3>Copy item meta data</h3> <p>Check this box to set the item properties on the target item to the same values as the source item. Only matching fields will have their values copied.</p> <h3>Store result in</h3> <p>Stores the new urls of the copied files into a text or collection variable.</p> <h3>Enter copy credentials</h3> <p>If the destination library is on a remote SharePoint environment, credentials with access to upload files are required. For copying files to a SharePoint site in the same environment as the workflow, the workflow automatically uses permissions with global SharePoint access if no other credentials are specified. To copy the item as a specific account in the local farm, enter the user credentials. Note: When a file is copied to the local farm with the global system account (i.e. no alternative credentials are specified), workflows in the destination location will not start automatically.</p> </div> </DIV><a name="Nintex.Workflow.CreateSite"><H2>4.20 Create a Site</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This feature allows you to create a site anywhere within your SharePoint environment using the workflow. </p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon . For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options for this action </h2> <h3><img src="content/nintex.workflow.createsite4.png" alt="" height="611" width="600" border="1" /></h3> <h3>Title</h3> <p>The Title is the name you wish to give the site and is a mandatory field. You can either type the name of the site manually or base it on a dynamic element provided by a lookup. To use the lookup feature, click on <img src="content/nintex.workflow.insertreferenceicon.png" alt="" height="13" width="15" border="0" />. <a href="#nintex.workflow.lookups">Click here for more information about lookups</a>. </p> <h3>Description</h3> <p>The Description is a brief statement about the site and is a mandatory field. You can either type the description of the site manually or base it on a dynamic element provided by a lookup. To use the lookup feature, click on <img src="content/nintex.workflow.insertreferenceicon.png" alt="" height="13" width="15" border="0" />. <a href="#nintex.workflow.lookups">Click here for more information about lookups</a>. </p> <h3>Inherit Permissions</h3> <p>Specifies whether or not to use the same permissions as the parent site.</p> <p>If permissions are not inherited, a Site Owner must be specified. The Site Owner is the person who will manage the site that will be created. They will be given Administrator privileges for the created site. For more information on privileges and permissions, please refer to the SharePoint Help Files.</p> <p>To set the Site Owner, click on <img src="content/nintex.workflow.browseicon.png" alt="" height="12" width="15" border="0" /> You will then have the option of choosing between an &quot;Internal Search&quot;, &quot;Add external email address&quot; or &quot;Lookup&quot;. For details on selecting between these options please <a href="#nintex.workflow.lookups">click here for more information about lookups</a>. </p> <h3>Parent Site</h3> <p>The Parent Site is the site that will contain the created site and is a mandatory field. A site picker will allow you to navigate through the portal structure and select the location where you would like to create the new site. Click the site under which you want the new site to be created. Alternatively, the 'Enter a URL' option can be selected to use lookups to determine the parent site. </p> <h3>URL</h3> <p>The URL is the web address for the created site and is a mandatory field. You can either enter the URL of the site that will be created or, by clicking on <img src="content/nintex.workflow.insertreferenceicon.png" alt="" height="13" width="15" border="0" /> you are able set the URL of the site to a field within the list or library where the workflow is being used. PLEASE NOTE: you only have to enter the part of the URL that relates to your site, not the absolute URL. For example to create a site with the URL &quot;http://ourcompanyportal/parentsite/mynewsite&quot;, you only need to enter &quot;mynewsite&quot;. </p> <h3>Template</h3> <p>The template is the SharePoint site template you wish to apply to the site that will be created. If multiple languages are installed in the environment, an option to choose the language for the site is available.</p> <p>Simply click on the drop down box and select the desired template. </p> <p>For more information on SharePoint site templates, please refer to the SharePoint Help Files. </p> <h3>Use navigation from the parent site</h3> <p>Specifies whether or not to use the same navigation as the parent site.</p> <h3>Display on the Quick Launch of the parent site</h3> <p>This option displays a link to the created list on the left hand navigation (Quick Launch) of the parent site.</p> <h3>Display on the top link bar of the parent site</h3> <p>This option displays a link to the created site on the top navigation of the parent site.</p> <h3>Store URL in </h3> <p>&quot;Store URL in&quot; allows you to store the URL for the created site in a text workflow variable and is an optional field. If there are no workflow variables created for the workflow, the drop-down list will be blank. Only the short part of the URL, the part mentioned above in the &quot;URL&quot; section of this Help File, is stored. For more information on workflow variables, refer to the <a href="#nintex.workflow.workflowvariables">Workflow Variables help page</a>. </p> <p>If the data is stored within a workflow variable it can be used at a later date to <a href="#nintex.workflow.deletesite">delete a site</a>. </p> <p>If the mandatory fields within the &quot;Create a site&quot; workflow action are not set, a warning icon like the one below will be shown on the design canvas. Until correctly set, the workflow cannot be published.</p> <p><img src="content/nintex.workflow.createsite2.png" alt="" height="74" width="150" border="0" /></p> <p>Hovering over the workflow action on the design canvas will give you a warning box indicating what items need your attention.</p> <p><img src="content/nintex.workflow.createsite3.png" alt="" height="203" width="203" border="0" /></p> </div> </DIV><a name="Nintex.Workflow.CreateADAccount"><H2>4.21 Create AD Account</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action will create an Active Directory user account in the specified LDAP location.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <p><img src="content/nintex.workflow.createadaccount1.png" alt="" height="883" width="600" border="1" /></p> <h2>Options within this action</h2> <h3>LDAP Path</h3> <p>An LDAP path specifying where to create new user accounts. E.g. LDAP://Nintex.com/OU=External,DC=nintex,DC=com</p> <p>In this example, user accounts will be created in the Nintex.com domain in the organization unit &lsquo;External&rsquo;.</p> <p>You can click on the LDAP Picker button on the right of the LDAP Path field to browse an LDAP Path.</p> <h3>Username</h3> <p>The administrative username to use when connecting to LDAP. Note: This user must have access to create user accounts in the LDAP location specified above.</p> <h3>Password</h3> <p>The password of the administrative account used to connect to LDAP.</p> <p>Click on the padlock to select from a list of Credential Workflow Constants, maintained in Site Settings by your system administrator.</p> <p><img src="content/nintex.workflow.createadaccount2.png" alt="" height="317" width="433" border="1" /></p> <h2>New Account Details</h2> <h3>sAMAccountName</h3> <p>A unique username to specify for the Active Directory entry. This must be unique within the Domain.</p> <h3>Common Name</h3> <p>The Active Directory Common Name value. This must be unique within the Container in which it will be created.</p> <h3>Display Name</h3> <p>The display name of the new account.</p> <h3>Given Name</h3> <p>The given name of the new account.</p> <h3>Surname</h3> <p>The surname of the new account</p> <h3>e-mail</h3> <p>The e-mail address of the new account</p> <h3>Generate password</h3> <p>If checked, a random password will be automatically generated by the action. If unchecked, you have the ability to specify the password for the new account.</p> <h3>Store generated password</h3> <p>The automatically generated password can be stored in a text type workflow variable. This can then be used in other actions.</p> <h3>Account Options</h3> <p>Use this property to set the following account options:<ul><li>User must change password at next logon</li><li>User cannot change password</li><li>Password never expires</li><li>User cannot change password AND Password never expires</li></ul><br />Leaving all 3 checkboxes unticked will remove all options. Note that the only valid multiple selection is User cannot change password AND Password never expires. The 'Account Options' field is available from the 'Other fields' drop down menu.</p> <h3>Other Fields</h3> <p>In addition to the above standard LDAP properties, you can select from the drop down list or manually enter additional attributes to set on the new account. In the example above, the &lsquo;mobile&rsquo; attribute has been selected to set the new account&rsquo;s cell phone property.</p> </div> </DIV><a name="Nintex.Workflow.CreateADSecurityGroup"><H2>4.22 Create AD Security Group</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p>This workflow action will create an Active Directory group in the specified LDAP location.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <p><img src="content/nintex.workflow.createadsecuritygroup1.png" alt="" height="548" width="597" border="1" /></p> <h2>Options within this action</h2> <h3>LDAP Path</h3> <p>An LDAP path specifying where to create the security group. E.g. LDAP://Nintex.com/OU=External,DC=nintex,DC=com</p> <p>In this example, a group will be created in the Nintex.com domain in the organization unit &lsquo;External&rsquo;.</p> <p>You can click on the LDAP Picker button on the right of the LDAP Path field to browse an LDAP Path.</p> <h3>Username</h3> <p>The administrative username to use when connecting to LDAP. Note: This user must have access to create security groups in the LDAP location specified above.</p> <h3>Password</h3> <p>The password of the administrative account used to connect to LDAP.</p> <p>Click on the padlock to select from a list of Credential Workflow Constants, maintained in Site Settings by your system administrator.</p> <p><img src="content/nintex.workflow.createadsecuritygroup2.png" alt="" height="317" width="433" border="1" /></p> <h2>Group Details</h2> <h3>Group Scope</h3> <p>Specify the scope for the group. Available options are: Domain local, Global or Universal</p> <h3>Group Type</h3> <p>Specify the type of group to be created. Available options are: Security or Distribution</p> <h3>Group Name</h3> <p>The name of the group to be created. E.g. Testers</p> </div> </DIV><a name="Nintex.Workflow.CreateItem"><H2>4.23 Create an item</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action creates a new list item in a list within the current site.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot;. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer help page</a>. </p> <h2>Options for this action </h2> <p><img src="content/nintex.workflow.createitem2.png" alt="" height="550" width="596" border="1" /></p> <h3>Create item in</h3> <p>This mandatory field is used to select a list to create an item in. </p> <h3><strong>Content Type</strong></h3> <p>The content type to use when creating the item. If a folder content type is selected, a folder is created. Likewise, if a document content type is selected, the appropriate blank template will be used.</p> <h3><strong>Overwrite an existing item</strong></h3> <p>If you would like to overwrite an existing item in the destination document library tick this check box. If you do not chose to overwrite an item, an identifier will be appended to the filename. Document libraries only.</p> <h3><strong>Store New Item ID in</strong></h3> <p>The created item will be assigned an ID. You can store this new item ID in a List Item Id Workflow Variable. For more information on Workflow Variables, please refer to the <a href="nintex.workflow.workflowvariables">Workflow Variables Help Page</a>. You can then use this workflow variable throughout the workflow should you wish to delete or update the item.</p> <h3>Field</h3> <p>The fields you can add to the created item will be dependent on what fields have been &nbsp; created in the destination list. For each field you can enter a value or you can use the look up feature by clicking on <img src="content/nintex.workflow.lookupbutton2.png" alt="" height="21" width="24" border="0" />. For more details on using lookups, please refer to the <a href="#nintex.workflow.lookups">Lookups Help Page</a></p> <p>Note: To create a document in a sub folder, for the name of your document specify the foldername\itemname and it will create the folder for you as well as the item. If the foldername already exists the document will be created in that folder.</p> </div> </DIV><a name="Nintex.Workflow.CreateAudience"><H2>4.24 Create Audience</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p><b>* This topic applies to Nintex Workflow Enterprise Edition only</b></p> <p><b>* This action requires Microsoft Office SharePoint Server</b></p> <p>This workflow action will create a new audience in the environment.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change the settings used by the action, left click in the action's title bar to activate the drop-menu, down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer</a> help page. </p> <p><img src="content/nintex.workflow.createaudience1.png" alt="" height="541" width="578" border="0" /></p> <h2>Options within this action</h2> <h3>Audience name</h3> <p>The name that the new audience should be called.</p> <h3>Credentials</h3> <p>An account with permissions to create an audience.</p> <h3>Description</h3> <p>Additional information to describe the audience.</p> <h3>Owner</h3> <p>The user who will be listed as the owner of the audience.</p> <h3>Include users who</h3> <p>Specify whether audience membership requires users to match any of the audience rules or all of the audience rules.</p> <h3>Audience Rules</h3> <p>Audience rules specify the requirements that a user must meet to be considered a member of this group. Multiple rules can be added by clicking the 'Add Rule' link.</p> <p><img src="content/nintex.workflow.createaudience2.png" alt="" height="363" width="556" border="0" /></p> </div> </DIV><a name="Nintex.Workflow.CreateCrmRecord"><H2>4.25 Create CRM record</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"><p><strong>* This topic applies to Nintex Workflow Enterprise Edition only</strong></p> <p>This workflow action will create a single record in Microsoft Dynamics CRM 4.0 (CRM). A record can be created for any entity, including custom entities.</p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list.</p> <p>To change the settings used by the action, left click in the action's title bar to activate a drop-down then select &quot;Configure&quot; or double-click the action's icon. For more information on the other options in the drop-down, please refer to the <a href="#nintex.workflow.workflowdesigner">Getting started with the Nintex Workflow designer</a>.</p> <h2>Options for this action</h2> <p><img src="content/nintex.workflow.createcrmrecord1.png" alt="" height="550" width="600" border="1" /></p> <p><strong>Server URL</strong></p> <p>The URL of the CRM server to connect to.</p> <p><strong>Organization name</strong></p> <p>The Organization located within CRM.</p> <p><strong>Credentials</strong></p> <p>The credentials used to connect to the CRM server and organisation.</p> <p><strong>Entity</strong></p> <p>The type of CRM record to be created.</p> <p><strong>Store record ID in</strong></p> <p>Specify a <a href="#nintex.workflow.workflowvariables">workflow variable</a> in which to store the newly created CRM record ID. This could be used as a reference to the CRM record ID in other steps of the current workflow.</p> <p><strong>Attributes</strong></p> <p>Selecting an Entity will load any Required and Business Required attributes. This will then allow the entry of data for the attributes that relate to the entity selected.</p></div></DIV><a name="Nintex.Workflow.CreateList"><H2>4.26 Create list</H2></a><DIV style="page-break-after:always; padding-left: 15px;"><div class="cntArticleBody"> <p>This workflow action permits the creation of a new list anywhere in the web application. </p> <p>To use the workflow action, drag it from the Actions palette at the left of the page and drop it onto a blue &quot;pearl&quot; on the design canvas. Alternatively, you can right-click a pearl, mouse-over &quot;Insert Action&quot; and select the action you require from the list. </p> <p>To change