GetTasksForWorkflowAssociationAndCurrentUser


Description

This method retrieves the list of workflow tasks for all documents in the specified workflow for a company. Tasks for only the current user are returned.

Parameters

Parameter

Type

Description

associationKey

WorkflowAssociationKey

The workflow association key that specifies the workflow being examined.

includeCompleted

boolean

The value true indicates both complete and incomplete tasks will be returned. The value false indicates only incomplete tasks will be returned.


Return Value:

Value

Type

Description

GetTasksForWorkflowAssociationAndCurrentUserResult

ArrayOfWorkflowTask

A list of the current user’s workflow tasks for all of the documents in the specified workflow for the company.


Examples

The following C# example retrieves the list of the current user’s tasks for the Dynamics GP Sales Quote Approval Workflow set up for the sample company. The tasks for all documents in the workflow are returned. The list of tasks is displayed in a dialog.

Be sure to use the URL and port for your workflow server.


using System;
using System.Collections.Generic;
using System.Text;
using System.Windows.Forms;
using Microsoft.Dynamics.Workflow.Proxy;

namespace WorkflowWebServiceSample
{
	class Program
	{
		static void Main(string[] args)
		{
			CompanyKey companyKey;
			WorkflowAssociationKey workflowKey;
			WorkflowTask[] tasks;

			// Create an instance of the web service
			DynamicsWorkflow wsWorkflow = new DynamicsWorkflow();

			// Specify the URL used to access the Workflow web service
			wsWorkflow.Url = "http://WorkflowServer:10072/_vti_bin/WorkflowService.asmx";

			// Be sure that default credentials are being used
			wsWorkflow.UseDefaultCredentials = true;

			// Create the company key for the sample company
			companyKey = new CompanyKey();
			companyKey.Id = (-1);

			// Get the tasks for a workflow
			workflowKey = new WorkflowAssociationKey();
			workflowKey.OrganizationKey = companyKey;
			workflowKey.WorkflowName = "Dynamics GP Sales Quote Approval Workflow";

			// Get tasks for this workflow and user, including completed tasks
			tasks = wsWorkflow.GetTasksForWorkflowAssociation(workflowKey, true);

			// Display the list of tasks for the workflow
			StringBuilder taskList = new StringBuilder();
			foreach (WorkflowTask t in tasks)
			{
				taskList.AppendLine(t.AssignedTo + " -- " + t.Description);
		}
			MessageBox.Show(taskList.ToString());
	}
}
}


Documentation Feedback