Overview

The ProcessMaker Zimlet allows users to navigate their ProcessMaker Home area directly from their Zimbra mail screen.

You can download the ProcessMaker Zimlet from the Zimbra Gallery.

Note: ProcessMaker Zimlet does not integrate with any version of Zimbra Desktop.

How the Plugin Works

Zimlet must be uploaded and installed into Zimbra. When configuring the zimlet, simply enter parameters as to the location of the ProcessMaker server, as well as the users unique user name and password.

Zimbra will now contain an extra tab labeled ‘ProcessMaker’. By clicking on this, you will be taken to a new screen with the ProcessMaker home area displayed. Here you have access to all of the folders in ProcessMaker, allowing you to work with and manage your cases just as if you’d logged directly into your ProcessMaker workspace.

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

Requirements

  • Processmaker V 1.6 and later.

Supported Zimbra Versions

The following are the Zimbra versions with which ProcessMaker Zimbra Zimlet is compatible:

  • ZCS 5.0 or later
  • ZCS 6.0 or later
  • ZCS 7.0 or later
  • ZCS 8.0 or later

Recommendations

  • Time on Zimbra server must be the same as Time on ProcessMaker server, otherwise some triggers may not work.

Installation and Configuration

Steps for Installing Zimbra Collaboration Suite (7.1.2_GA on Ubuntu 10.04 64-bit OS)

Install Zimbra by typing "./install.sh" and uninstall by typing "./install.sh -u"

Prerequisite packages

  • NPTL
  • sudo-1.7.2p1-1ubuntu5.3
  • libidn11-1.15-2
  • libpcre3-7.8-3build1
  • libgmp3c2-2:4.3.2+dfsg-1ubuntu1
  • libexpat1-2.0.1-7ubuntu1
  • libstdc++6-4.4.3-4ubuntu5
  • libperl5.10-5.10.1-8ubuntu2.1

Suggested prerequisites

  • perl-5.10.1
  • sysstat
  • sqlite3

Install Procedure

  • Start the Ubuntu server and connect using PuTTY.
  • At the login prompt, login with your administrator account (administrator / myadminpass) and then type su and the root password (myrootpass)
  • Download the Open Source Edition from Open Source Edition Downloads: Enterprise Messaging and Collaboration Software by Zimbra.

Download directly from the server

  • Obtain the download URL from the Zimbra OSE page
  • Type the following commands on the server console (using the correct URL)

Code:

cd /temp wget http://files2.zimbra.com/downloads/7.1.2_GA/zcs-7.1.2_GA_3268.UBUNTU10_64.20110804130819.tgz
  1. Extract the archive by typing the following commands:

Code:

mkdir /temp/install
tar -C /temp/install --strip-components=1 -xzf /temp/zcs*

Start the installation program by typing the following:

Code:

cd /temp/install
./install.sh

Agree to license agreement? Press y {ENTER}

If you are missing any prerequisites, exit the installation and install them. You can install all at one time by separating each name with a space after apt-get install such as the following:

Code:

aptitude install sysstat sqlite3
# Install zimbra-ldap? Press y {ENTER}
# Install zimbra-logger? Press y {ENTER}
# Install zimbra-mta? Press y {ENTER}
# Install zimbra-snmp? Press y {ENTER}
# Install zimbra-store? Press y {ENTER}
# Install zimbra-apache? Press y {ENTER}
# Install zimbra-spell? Press y {ENTER}
# Install zimbra-memcached? Press n {ENTER} (if multi-server, press y instead)
# Install zimbra-proxy? Press n {ENTER} (if multi-server, press y instead)
# The system will be modified. Continue? Press y {ENTER}
# DNS ERROR resolving MX for localhost.localdomain. Change domain name? Press n
#You are presented a menu for resolving unconfigured options, press 3 {ENTER}
#Select Admin password, press 4 {ENTER}. Then type your new password  {ENTER}
#Press r {ENTER} for previous menu
#Press a {ENTER} to apply changes.
#Press y {ENTER}, {ENTER} to save configuration (/opt/zimbra/config.9066)
#The system will be modified - continue? Press y {ENTER}
#Notify Zimbra of your installation? Press n {ENTER} (feel free to answer yes if this is not a test system)
#Press {ENTER} to exit setup. NOTE: Log files placed in /opt/zimbra/log

Now your ZCS Open Source installation has been completed.

To test your zimbra service login as Zimbra user :-

# su – zimbra
zmcontrol status

The output should look like this:

ip-10-73-18-235.ec2.internal
antispam               Running
antivirus              Running
ldap                   Running
logger                 Running
mailbox                Running
mta                    Running
snmp                   Running
spell                  Running

If any service is not running then you can do start/stop your zimbra service :-

$ zmcontrol stop/start
For Admin User -  http://ec2-107-20-155-72.compute-1.amazonaws.com:7071
For Normal User - http://ec2-107-20-155-72.compute-1.amazonaws.com

Steps for Uninstalling ZCS

# su – zimbra
$ zmcontrol stop
$ exit
# cd zcs-6.0.6_GA_2330.F11.20100505202915
# ./install.sh -u
# rm -rf /opt/zimbra

Steps for Connecting to Zimbra Collaboration Server

Enter URL http://ec2-107-20-155-72.compute-1.amazonaws.com or http://107.20.155.72/

User Id : root
Password : solutions

You will get a screen as below:

After Logging You Will get a Screen as below:

Click on the ProcessMaker Tab.

By clicking on the Tab ProcessMaker Options will display as shown below.

Go to Preference by clicking ProcessMaker Tab > Setup.

A window popup will display to fill the details of ProcessMaker.

Where:

  • UserName – Processmaker username
  • Password - Processmaker password
  • Languages - English
  • Server – The server name on which the processmaker resides
  • Workspace – Proceessmaker workspace
  • Protocol – http/https
  • Port –if not default port then mention the port used by ProcessMaker.

And then click on Ok.

Once the Preference is set ProcessMaker Environment will start.

Login works only after the preferences are set.

Examples

New Case

Go to Start 'New Case by Clicking ProcessMaker Tab > New Case.

On Click of Start New Case You will get a window popup in which there will be list of Processes to be started.

Select any one and click on OK.

Cases Inbox

Go to Cases Inbox by Clicking ProcessMaker Tab > Cases Inbox.

On Click of Cases Inbox you will get a window in which there will be list of Case Ids to be started.

Select any one and click on OK.

Draft

Go to Draft by Clicking ProcessMaker Tab > Draft. On Click of Draft you will be redirected to Draft in the ProcessMaker that will be visible in Main Content Area of the Tab.

Participated

Go to Participated by Clicking ProcessMaker Tab > Participated. On Click of Participated you will be redirected to Participated in the ProcessMaker that will be visible in Main Content Area of the Tab.

Paused

Go to Paused by Clicking ProcessMaker Tab > Paused. On Click of Paused you will be redirected to Paused in the ProcessMaker that will be visible in Main Content Area of the Tab.

Unassigned

Go to Unassigned by Clicking ProcessMaker Tab > Unassigned .On Click of Unassigned you will be redirected to Unassigned in the ProcessMaker that will be visible in Main Content Area of the Tab.

Documents

Go to Documents by Clicking ProcessMaker Tab >Documents. On Click of Documents you will be redirected to Documents in the ProcessMaker that will be visible in Main Content Area of the Tab.

Manual

Go to Manual by Clicking ProcessMaker Tab > Manual. On click of this Link ProcessMaker Wikipedia webpage will be available in the Main Content Area of the Tab.