Reference10:Concept myPBX

Overview

myPBX is the UC client of the innovaphone PBX. It is intended for assisting typical phone users with their everyday tasks. It consists of two parts:

• A web application that runs in any modern web browser. It provides the functionality needed for audio teleophony, instant messaging, monitoring peoples statuses and more.
• The myPBX launcher. It's a Windows application that integrates the myPBX web application into the Windows desktop and adds some interesting additional features like video telephony and Outlook integration.

Web application

The main user interface is an HTML5 application that runs in a web browser. It communicates with the PBX using HTTP-Requests (AJAX). The actual session logic is implemented inside the PBX.

The picture shows how call control is done. The myPBX session has access to the phone registration as they are both located in the same PBX. Thus it can monitor and create or modify calls.

myPBX launcher

The launcher is a tool for integrating myPBX into the Windows desktop. It is not needed in order to use myPBX but it adds some convenient functions that are not available otherwise.

• Automatically open the myPBX web application on startup.
• Desktop notifications.
• Video telephony
• Office2010 Integration
• Hotkey for dialing numbers out of any Windows application.
• Set the status depending on user activity.
• Switch to a standby PBX if the main PBX is down.
• Write trace files.

Requirements

PBX

• myPBX license
• Reporting license (for seeing recent calls in the history)

Web browser

• Current version
• JavaScript enabled
• HTML5 XMLHttpRequest (AJAX) enabled
• HTML5 Web Storage (DOMStorage) enabled
• HTML5 Cross-document messaging (postMessage) enabled

Note: The launcher always uses Microsoft Internet Explorer for opening the web application. It does not use the configured standard browser.

Launcher

• Windows 7
• .NET 4

Related technology

• myPBX uses the innovaphone Reporting as a database for call lists.
• The Exchange Calendar Connector sets the presence of PBX users depending on their Exchange Calendar. myPBX can display that presence.

Configuration

PBX

Basic configuration

• Make sure you have installed the appropriate licenses.
  • myPBX for the web application.
  • Reporting for the call list.
  • Video for video telephony.
• Activate the licenses for the inidiviual user objects (License tab). This can also be done using config templates.
• Enable myPBX on the page PBX/Config/myPBX.

Additional hints

• Only users with a password can login to myPBX.
• There should be a dedicated device configured at the user object for each phone registration.
• To use mobile phones, the mobility device must have a name in the fork config at the user object.
• The LDAP configuration is taken from the phone config at the user object.
• The dialling location has to be configured at the phone config of the user object.
• Phones should be registered using the PBX password so that user can change their login password without affecting the phone registrations.
• If federation is used ("use as domain" checked), the user names and the PBX system name should match the email addresses of people.

Launcher

Basic configuration

• The configuration dialog is located in the context menu of the tray icon.
• Configure the URL in the myPBX tab (e.g. http://x.x.x.x/PBX0/MY/client.htm).

Administrative configuration

• While deploying the software administrators can specify a default configuration using MSI parameters.
  • URL - The primary URL.
  • URL2 - The secondary URL (standby PBX).
  • TRACE - Write trace files (true or false).
  • AUTOSTART - Autostart myPBX (true or false).
  • AUTOPRESENCE - Detect user activity on the computer in order to set the IM status (true or false).

Appendix

CPU usage

Connected myPBX sessions need additional resources on the PBX. With an area-wide utilization of myPBX you can have approximately half the amount of users per box than without using it.

Network traffic

In idle state the web application needs an empty message exchange every 30 seconds in order to keep the session alive. This messages take about 800 bytes. So per session the minimum network traffic is approximately:

• 1600 B/min
• 94 kB/h
• 2.2 MB/d

Included open source software

The myPBX web application contains the following open source software:

rc4.js

  * RC4 symmetric cipher encryption/decryption
  * Copyright (c) 2006 by Ali Farhadi.
  * released under the terms of the Gnu Public License.
  * see the GPL for details.
  *
  * Email: ali[at]farhadi[dot]ir
  * Website: http://farhadi.ir/

sha1.js

  *  Secure Hash Algorithm (SHA1)
  *  http://www.webtoolkit.info/

jquery-1.7.2.js

  * jQuery JavaScript Library v1.7.2
  * http://jquery.com/
  *
  * Copyright 2011, John Resig
  * Dual licensed under the MIT or GPL Version 2 licenses.
  * http://jquery.org/license
  *
  * Includes Sizzle.js
  * http://sizzlejs.com/
  * Copyright 2011, The Dojo Foundation
  * Released under the MIT, BSD, and GPL Licenses.
  *
  * Date: Wed Mar 21 12:46:34 2012 -0700