Using the FWProcessRuntime API

Learn about the FWProcessRuntime API

Last published at: February 12th, 2025

The FWProcessRuntime API manages all runtime operations, such as working process instances.

 

Creating the FWProcessRuntime Object

FWProcessRuntime oRuntime = new FWProcessRuntime(“connection string”, “external user name”);

Creates the FWProcessRuntime object 

 

Get a Process Instance

FWProcessInstance oInst = oRuntime.GetInstance(“id of the instance”); 

FWProcessInstance oInst = oRuntime.GetInstanceUsingName(“name of the instance”);

Gets the Process Instance object using the id or the name 

 

Set Instance Priority

Set the instance priority using the execute method once you create an instance using the API.
 

 

 

Abort a Process Instance

Bool bFlag = oRuntime.AbortInstance(“id of the instance”);

Aborts the selected Process Instance 

 

Complete a selected task

Bool bFlag = oRuntime.CompleteTask(“id of the task”, “task return value”, “task comment”);

Completes a given task programmatically 

 

Extend a selected task

Bool bFlag = oRuntime.ExtendTask(“id of the task”, “number of days to extend by”); Insert your text here

Extends the expiration of a task by a given number of days 

 

Get a list of Process Instances

Dictionary oList = oRuntime.GetInstances(“created by user-id”)

Dictionary oList = oRuntime.GetInstances(“”, “tenant ID”)

Hashtable oList = oRuntime.GetInstances(“execution status”);

Gets all Process Instances created by a certain user

Gets all Process  Instances for a given tenant

Gets all instances based on a selected execution status 

 

Get the status of the license file

licenseStatus oStatus = oRuntime.GetLicenseStatus(ref “error message string”, ref “license properties”);

Gets the status of the license and the licensing information 

 

Get all open tasks for Users

Datatable oTasks = oRuntime.GetOpenTasks(); 

Datatable oTasks = oRuntime.GetOpenTasks(“string user id”);

Gets all open tasks for the current user 

Gets all open tasks for a selected user 

 

Get a selected task

Datatable oTask = oRuntime.GetTask(“task id”);

Gets a selected task using a task ID 

 

Get task choices Info

List oList = oRuntime.GetTaskChoices(“task ID”);

Gets a list of task choices for a selected task 

 

Reassign all tasks

Bool bFlag = oRuntime.ReAssignAllTasks(“old user id”, “new user-id”);

Reassigns all tasks from one user to another 

 

Reassign tasks

Bool bFlag = oRuntime.ReAssignTask(“id of the task”, “new user ID to reassign”);

Reassigns a selected task to another user 

 

Remove a Process Instance

Bool bFlag = oRuntime.RemoveInstance(“id of the instance”);

Removes a selected Workflow Instance 

 

Run the engine manually

oRuntime.RunEngine();

Tells the engine to process the next item on the workflow queue