Therefore Programming Interface 3.0

 

This Function is called by the Thereforeâ„¢ Solution Designer, every time the "Settings..." button in the Call DLL task properties is pressed.

 

 

Arguments

 

nObjectID

The object ID of the object the workflow process belongs to. Depending on the nObjectType parameter this is either a category number or case definition number.

 nObjectType

         The object type of the nObjectID parameter. 3 stands for category, 37 for case definition (see TheObjectType enumeration)

 bstrTenant

         The tenant name the workflow instance belongs to.

 bstrParams

         The last settings returned in ShowSettingsDlg.

 

Return

 

The settings to be stored in the database. The next time ShowSettingsDlg is execute the bstrParams parameter will contain this value.

When ProcAutomaticInst is called the bstrParams parameter will contain this value. Workflow macros will be automatically resolved before.

 

 

Remarks

 

For calling this method the workflow DLL has to be present on the machine the Thereforeâ„¢ Solution Designer is used and has to be registered properly.

 

C# Sample (Implementing the Function)

public string ShowSettingsDlg(int nObjectID, int nObjectType, string bstrTenant, string bstrParams)

{

 if (nObjectType != 3)

      {

         MessageBox.Show("This workflow task can only be used for categories.");

    return "";

      }

 

 return "D:\\WorkflowOutput";

}