This manual is intended for users of the Zarafa WebApp.

Information on using ZCP with:

can be found in their respective manuals.

In short, the Zarafa WebApp is a set of collaboration applications which can be accessed through a web browser.

Aimed at (but not limited to!) corporate users, the Zarafa WebApp has all the major features that users of i.e. Microsoft Outlook use on a daily basis, such as email, calendars, contacts, notes and tasks.

Next to these basic features, the Zarafa WebApp also offers advanced collaboration features such as instant messaging, presence and integration with telephony (VoIP) and web meeting solutions, social media integration and many more.

Because the Zarafa WebApp is an open platform, it is very easy for developers to create new features and integrations for Zarafa WebApp. More and more of these features and integrations are being developed every day.

Zarafa’s aim is to let WebApp not just match, but also grow more and more beyond Outlook with every new release.

In order to use the Zarafa WebApp, a recent version of one of the following browsers is needed:

To login to the Zarafa WebApp, point the browser to the URL supplied by the local Zarafa System Administrator. By default this URL will look like:

https://LOCAL_DOMAIN_NAME/webapp/

So for example, if the local domain name is mail.example.com, the WebApp URL would be:

https://mail.example.com/webapp/

The Zarafa WebApp login screen will appear when the connection succeeded, as shown in Figure 2.1, “The Zarafa WebApp login screen”.

The login credentials can be obtained at the local Zarafa System Administrator. These by default consist of:

As a security measure all characters will be displayed as dots, when the password is entered.

Click Logon to log in to the Zarafa WebApp.

Currently the Zarafa WebApp supports the most used features of Microsoft Outlook in a fairly comprehensive way. Additional features will be implemented in every new release.

WebApp offers a number of integrated applications, which are:

All applications use the same interface style and elements, so a user will quickly find his or her way around in each of them. Each application will be covered in this manual in its own chapter.

After logging in, the user will be presented with the Mail application by default. In the next section we will illustrate the basics of the Zarafa WebApp, using the Mail application as an example. More specific information on the Mail application can be found in Chapter 3, The Mail application.

Each application in the Zarafa WebApp can be divided into several main areas, as illustrated in Figure 2.2, “The main areas of WebApp”.

The main areas are:

In Zarafa WebApp, each application has a default layout. For example, in the Mail application this is: a list of messages with a From and a Received column. However, like in Outlook, it is possible to change the layout by adding or removing columns. To do so, the user has to hover his or her mouse over any of the column headers (for example the From header) and click on the drop-down arrow that appears on the right side of the column header. Now he or sha can select the Columns option from the drop-down menu. A sub menu that looks like Figure 2.14, “Field Chooser” will appear.

The user can now select additional columns or deselect columns that he or she wants to hide.

Additionally, it is possible to sort the email list by selecting a specific column. By default email is sorted by the Received date column.

A special part of the folder hierarchy is dedicated to Public Folders. A public folder is a folder that is visible to all users that have access to them. The owner of a public folder can allow other users or a group of users to access and even edit the folder by setting its permissions. Public folders offer an easy way to share folders and items. Since the hierarchy of public folders will be visible to the other users, it is also easy to organize shared content.

To create a public folder find the folder in the Public Folder hierarchy in which you want to create a subfolder. Right-click on the folder and click on New Folder in the context menu. In the dialog that pops up, enter a name for the new folder, choose the item type that the folder can contain, and click on Ok. The new folder is now created, but before it is visible to other users you must specify the permissions that other users have. To do so, right-click on the new folder and choose Properties. In the dialog that pops up open the Permissions tab. To give one or more users permissions to use the folder click on the Add button. The Address Book will open. Select the users that you want to give access (or select Everyone if you want to make the folder accessible to all other users in the organisation). Once users have been added, you still must set the permissions for each added user. By default users will only have permission to see the folder (not the contents). So select the user and set the permissions for this user in the bottom om the dialog.

The search bar is located above the item list you want to search in.

When doing a search, a new tab will be opened with your search results. By default your entire store is being searched in, so you can search for a calendar item, a mail item, a task, a note and even a contact.

Once you have found the item you were looking for, it can be opened by double clicking the item or right-click on the item and select open. Other actions are also available via the right-click context menu.

Logging out from the Webapp can be done by clicking on the Logout button in the top right corner.

The Mail application contains the following elements, of which some are used in all other applications as well:

All Outlook folders and the Public folders (the account has access to) can be accessed.

Working with calendars is pretty straightforward. Nevertheless, we do have some functionality we would like to explain a little better:

Emails can be send directly to contacts by the right mouse button context menu option Email Message.

The letters at right side of the contact view allow users to quicky move through the contact list.

Notes are a great tool to write ideas down, write down a phone number or make a shopping list. You can use notes for lots of different purposes, but most of all you can use notes the way you please.

The Zarafa WebApp allows to specify coworkers who should be able to work on the behalf of the current user. For example, a secretary can be granted permission to send email on behalf of his/her superior or schedule meetings. This is commonly referred to as delegation.

Zarafa distinguishes two kinds of delegation:

Since Send As implies impersonating somebody else, this kind of delegation can only be set by a Zarafa system administrator. Only Send on Behalf permissions can be set from WebApp.

Permission for the following folders can be set from the delegate screen:

For each folder the following permission profiles can be set:

By default, WebApp sets the permissions for each folder to None, which means the delegate will have no permissions to access these folder. Permission levels can be changed by clicking on the drop down button and selecting the desired permission from the drop down menu.

Once the according permissions to Send On Behalf of or Send As have been granted, the user can start working on behalf of.

To remove a delegate from ab account:

The functionality of the WebApp can be extended by using plugins and widgets.

Widgets are best described as miniature applications running inside the WebApp. There are two designated areas in the WebApp where widgets can be used:

After installing and enabling the widget on the Zarafa system (can only be done by the local system administrator), a widget can be added to, moved around in or removed from these two areas. Depending on the functionality offered by the widget, it is also possible to interact with the widget itself and or change its settings. While from a technical standpoint a widget is also a plugin to WebApp, we will differentiate between the two in this manual. The main reason is that a plugin is not necessarily a widget (but a widget can be part of a plugin) and a user will clearly notice it when this is the case.

A few examples of widgets that are shipped with every Zarafa system are:

When refering to plugins in this manual, we are talking about extra functionality added to the WebApp, which is integrated more deeply into the user interface. While a plugin in most case will allow you to use it and interact with it, you will not be able to add, move around or remove it as you see fit.

A few examples of plugins for Zarafa WebApp are:

The Zarafa "Today" application is a dedicated view for widgets. This enables to have many widgets combined into a single view. To get to the Zarafa "Today" application, click on the Zarafa link in the Shortcut Bar.

The Zarafa "Today" application will appear, as shown in Figure 9.2, “The Zarafa "Today" application” From there the same procedure as with the widget sidebar can be used to add, minimize, configure and remove widgets. The only difference is that here it is possible to have multiple columns to place widgets on.

By default the Zarafa "Today" application is populated with the Appointments and Tasks widgets.

When installed, plugins can be enabled via the plugin tab in the settings dialogue.

The Zarafa WebApp allows to change many parts of its behavior by changing options and settings. Most of these options and settings have been gathered in the Settings screen.

When clicking Settings in the Shortcut Bar, the Settings screen will appear as shown in Figure 10.1, “The Settings screen”.

The Settings screen contains sections for various parts of WebApp. At the time of writing, these sections are:

When clicking on a section, its settings will be shown. The individual settings can be changed changing its values. The General section will always be shown first when opening the settings.

After changing a setting it is neccessary to click on the Apply buttom in the lower right part of the screen to make it permanent. As an additional failsave the WebApp will also ask if unsaved changes should be applied, when navigating to a different settings screen or application inside the Webapp.

More information on each section’s settings can be found below.

{%firstname}
{%initials}
{%lastname}
{%displayname}
{%title}
{%company}
{%department}
{%office}
{%assistant}
{%phone}
{%primary_email}
{%address}
{%city}
{%state}
{%zipcode}
{%country}

{%phone_business}
{%phone_business2}
{%phone_fax}
{%phone_assistant}
{%phone_home}
{%phone_home2}
{%phone_mobile}
{%phone_pager}

The feedback button is not enabled by default. It’s a plugin which can be enabled in the plugin tab. This tab can be found via the settings. Once enabled you will see a button next to the "logout" button which is called "Feedback?".