FreeFlow, the .NET toolkit for Metastorm BPM

Home | Administrator | FAQ | Screenshots | Documentation | Downloads | Suggestions | Bugs | PowerShell | Links

Here are the answers to some frequently asked questions. The links to the documentation often contain examples in C# and VB.NET.

General

What versions of e-Work/MBPM does FreeFlow support?
FreeFlow has been tested with e-Work 6.2 through 6.6 and Metastorm BPM 7.0 to 7.6. It should also work with e-Work 6.0 and 6.1 but will not work with earlier versions of e-Work. The FreeFlow.Administration assembly works against 6.5, 6.6, 7.0, 7.5 and 7.6 database schemas.
What versions of the .NET Framework does FreeFlow support?
FreeFlow currently supports version 2 of the .NET Framework. Versions for .NET 1.1 are available, but are no longer actively developed.
How do I use FreeFlow in my .NET project?
Copy the FreeFlow assemblies to a convenient location on your computer and add a reference to the FreeFlow.Client or FreeFlow.Administration assembly.

FreeFlow.Client namespace

How do I login to the engine?
The Connection.LogOn method can be used to login using standard eUser authentication.
Is SSO supported?
SSO is supported via the Connection.LogOnForm method. You will need to configure the engine following the instructions provided by Metastorm before attempting to use SSO. However the instuctions for Win32 clients should be used, rather than the web configuration. If an ASP.Net application is being used to connect to the engine, ensure <identity impersonate= "true"/> is set in web.config
How do I start an action and commit it?
Use ActionPage.StartBlankForm to open a blank form or ActionPage.StartAction to start an action on a folder.
How do I raise a flag?
Use one of the Connection.RaiseFlag overloads.
Can I find out if a flag was successfully raised?
Flags are raised asynchronously so there is no way for FreeFlow to know if the flag was successfully raised. If notification is required, a better solution may be to trigger a user action via ActionPage.StartBlankForm or ActionPage.StartAction.
How do I access the fields on a form?
The ActionPage class has a Form property that gives access to the form associated with the action and its fields.
How do I read and write attachments?
If your e-Work form has a clip field, then FreeFlow's Form object will contain an AttachmentField object that has an Attachment property that gives access to reading and writing attachments.

FreeFlow Administrator

I keep getting "Timeout expired" error messages, why?
This generally happens when the database is very busy or a query with a large result set is being executed. If this happens frequently, there is a 'Query timeout' option available that should be increased.
I keep getting error messages when I'm connected to an Oracle database, why?
Oracle databases are not fully supported currently. Unfortunately Oracle support is not currently a high priority. If you are desperate for Oracle support, contact the author.



© 2005-2008 Chris Bell