FreeFlow, the .NET toolkit for Metastorm BPM
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/Metastorm BPM 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 Metastorm BPM 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 support is still being improved.
Ensure you have downloaded the most recent version of the FreeFlow Administrator