Please rate how useful you found this document: 
Average: 1 (1 vote)

Release Notes | >Downloadable version

Plugin Version: 2.0.5


ProcessMaker InOutlook is a plugin created to allow standard ProcessMaker users to use ProcessMaker from within the Microsoft Outlook email client (versions 2007 and 2010) instead of through the standard browser interface.

How the plugin works

Outlook will now contain an extra folder labeled ProcessMaker. By clicking on symbol it will show all user cases sorted into folders based on the status of the case. This allows to work and manage cases just as if you’d logged directly into a ProcessMaker workspace.

Dynaforms are displayed to the user in the preview area of Outlook and the user interacts with them in the same way as normal.


This plugin allows users to perform only the following tasks from within the Outlook interface:


Outlook version 2.0.5 and earlier

  • ProcessMaker 2.0 and later.
  • Microsoft .Net Framework 3.5
  • Microsoft Outlook 2007 or 2010

Outlook version 2.0.6

  • ProcessMaker v. 2.5.0 or higher
  • Microsoft Outlook 2007 or 2010
  • Install the new Outlook Add-in


  • The Outlook Connector plugin must be updated in the server.
  • Clear ProcessMaker cache server right after installing the new version in the server.
  • Even if you have more than one language installed on your server, the outlook connector plugin will only display English at the moment of configuring the server data.

Installation and Configuration

Install the plugin in ProcessMaker

The plug-in will be available once >imported the Enterprise plug-in with the corresponding license, it's necessary to activate it once it's installed, it doesn't need additional configuration on the server side.

Install the Add-in for Outlook

Files provided with the Enterprise plug-in:

- Outlook Add-in for Outlook 2007

- Outlook Add-in for Outlook 2010 32 bits

- Outlook Add-in for Outlook 2010 64 bits (New file added from version 2.0.4 of the plug-in)

- Outlook Add-in for Outlook 2007 and 2010 v 2.0.6 ( 32 and 64 bits )

Note: Only clients or partners who have got the license and who haven't got a trial version, will have the installers.

For 2007 version of Outlook first install libraries "Primary Interop Assemblies" which do not come by default with Office 2007. The steps to install are:

  1. Close the Outlook application if it's open.
  2. If using Outlook 2007, first install the file "o2007pia.msi" (which provided in the package installers) or download and install the Microsoft Redistributable Primary Interop Assemblies.
  3. Run the Add-in installer "setup.exe" which will check if .NET Framework is installed on the system, if it isn't the following window will display:

Click on Accept to download and install the .NET framework.

Once the .NET Framework is installed, and running the setup it will display the following installer window

Then the ProcessMaker in Outlook Wizard will display

Click on Next and select a folder where the outlook will be installed

Confirm the installation and click on Next.

Once the installation is completed, click on Finish.

Reinstalling the Outlook Add-in

If you update you Outlook plugin version to 2.0.6, you must uninstall your current Outlook Add-inn and reinstall the corresponding the one corresponding to the last version, following the steps below:

1. Close your Outlook.

2. Uninstall the Outlook previously installed, so Open Programs and Features by clicking the  Start button, clicking Control Panel, clicking Programs, and then clicking Programs and Features, then look for the ProcessMaker in Outlook add-in and click on Uninstall:

3. Install the new Outlook Add-in.

4. Open your Microsoft Outlook, the add-in must be included inside the add-in tab:

Setup the Add-in for Outlook

After installing the Add-in, open Outlook. A window will appear to configure the data server and the user account to use it. For Outlook 2007 the view will be:

Click on Configuration:


  • Protocol: Choose between http or https.
  • Server: Specify the name of the server.
  • Workspace: Specify the name of the workspace.
  • User: Enter the name of the user.
  • Password: Enter the password of the user.
  • Language: Choose between Spanish or English.
  • Enable Cases Menu: Check this option if you want to see the Case Menu when a case is being executed. Available from Version: 2.0.6 on

When the button "Save" is pressed, it will connect to the server to try to validate the user. If the validation was successful, the configuration window disappears and the system will be ready to use.

Interaction with Cases List

  • It is possible to interact with cases (lists, steps, etc), in the same way as it does from the web application, but in a simpler and faster way, because the Add-in for Outlook records user information the first time and subsequently it is useful to be used by the system without being authenticated in every moment.

By clicking on ProcessMaker folder, all the folders from the ProcessMaker workspace will display:

Notice that the Folder B. Inbox shows the number of new cases assigned to the current user that are pending review.

  • All of the characteristics (forms, input documents, output documents, triggers, derivations, etc.) are fully functional from Outlook.

In Outlook 2010, folders have different view, each of them has a different icon:

Due to performance, the number of cases in the Participated and Unassigned folders do not show unlike the Inbox and Draft folders which are displayed enclosed in parenthesis.

Each folder of the case list will be explained as follows:


This folder contains essential information about the Outlook Connector Plugin:

New Case

One of the main characteristics of this plugin is the possibility to start cases inside the outlook application. By clicking on this option all cases in which the user configured on the Outlook Settings participates are listed. Don't forget that this user must be assigned to the initial task in order to start the case:


All incoming cases will be stored on this folder as the following image:

Double click on the name of the case to open it.


Includes cases that are being edited or advanced by the user but have not yet been submitted to the next task, check the following image:

Double click on the name of the case to open it


Includes all the cases that the user has sent or participated in, check the following image:


Includes all cases which will be claimed by a pool of users assigned into the task, check the following image:


Includes a list of all cases which were paused during their execution. This gives users a quick view of their cases status since it is not possible to pause and unpause cases from the Outlook interface. Cases must be unpause by going to ProcessMaker Interface.

Running Cases - Cases Menu

Available from Version: 2.0.6 on

When running a case, the Case Menu with the four options found when running cases in ProcessMaker was added, you will find them at the top of the Menu like the one shown in the illustration bellow.

This functionality can be configured when ProcessMaker server is configured inside the Outlook, it means that the user can decide if the whether the Cases Menu will display or not. This is practically the same as the one you will find in ProcessMaker, as follows you will find a brief explanation of each one of these options:


It shows all the DynaForms, Output and Input Documents assigned in the current task, so it can be accessed easily into each one of them:

For more information about this, check Cases documentation


It shows all the information of the current process, if you click the down arrow you will find the following options:

  • Process Map: By clicking on Process Map option a new tab will open next to the current case, showing the Process Map of the current process which is being executed.

  • Process Information: By clicking on Process Information a new window with the information of the current process will display:
  • Task Information: By clicking on Task Information a new window with the information of the current task


Users can execute the following actions:

  • Pause The current case in execution can be paused. By clicking on the calendar icon, a calendar will display in which the date of the unpaused case must be defined.
  • Reassign: A selected case from the list can be reassigned, it means that the owner of a case will change. If a user different form admin needs to reassign a case then assign him a role with the PM_REASSIGNCASE

Case Notes

Case Notes are used to add comments and observations about cases, which can be read by anyone who has rights to open the case.


Go to "Start New Case" by clicking on A. New Case. All new cases will display on the right side.

Click on the case to start it. On the right-hand side the first form assigned to that task will be displayed:

Solving the session issue for Printing a Dynaform and Downloading a Document

Usually when it was required to print or download a dynaform or a document the session had lost, and ProcessMaker was forced to log out and log in again. This error occurs because on php.ini file session.use_only_cookies was with the value 1 and that disable the use of the PHPSESSID which use this value to manage sessions.

To solve that problem modify the value of the session.use_only_cookies as the image below:

Finally restart all the services.

Printing a Dynaform

Now, checked the option Show print DynaForm button on the Dynaform properties as the image below:

When a case is created and print button is clicked the following print window will display with a brief description of the case:

Downloading a Dynaform

Applying the configuration explained above, downloading any document during a case or inside a ProcessMaker won't be a problem, see the image below for an example: