From Contest

[edit] XMLConference-Application

What is XMLConference?

XMLConference is a Java-Servlet written for the Snom-3XX phones with XML-Browser-Firmware. To use this application you need to have installed firmware version 7.2.3 (or later).

XMLConference uses the Asterisk Manager interface, and shows call-related information on the Snom phone display and allows you to interact with these calls.

Features:

• lists active conference rooms
• lists users in conference rooms
• shows user-related information
• allows to mute/unmute users
• allows to kick users
• allows to lock/unlock conference rooms

• shows online-status of agents
• lists call queues
• shows queue-related information
• lists queued users
• lists queue-members

• allows for simultaneous sessions
• independent installation from Asterisk server
• works on all Snom 3xx phones

(Conferencing is done via Asterisk MeetMe-application.)

Requirements:

XMLConference uses the Asterisk Manager interface, so you need to activate the Manager interface and to configure a manager account (http://www.voip-info.org/wiki/view/Asterisk+config+manager.conf).

Please make sure your manager account has the necessary privileges to access, or XMLConference will not work properly.

XMLConference can be installed on any server (not necessarily the Asterisk server it monitors) and needs to be able to access the Asterisk server(s) to monitor in the local LAN or via Internet (listening to port 5038). Please make sure your Snom phones can access the server running XMLConference.

Basically communications via the Asterisk Manager interface are not encrypted, so access using a VPN, a SSH tunnel or any other encrypted tunnel is highly recommended.

XMLConference uses XML functions based on Snom firmware 7.2.3 or later. Please take a look at http://wiki.snom.com/Minibrowser to find out more about this. XMLConference will work on all Snom 3xx phones, but it is recommended to use Snom 360/370 phones because of display space.

Accessing the XMLConference application demo server (Hosting provided by http://www.loca.net)

To access the demo server please configure a button on your Snom phone using http://82.140.45.26:8180/XMLConferenceBrowser/XMLConference as an Action-URL.

You will be asked for your the Asterisk server address, username and the password (Manager interface user).If you do not want to enter these information with the phone keyboard you can add some login-data to the URL:

http://82.140.45.26:8180/XMLConferenceBrowser/XMLConference?server=myasterisk.de&username=myname&password=secret If for security reasons you do not want to provide your password within the URL you will be asked for it every time you try to login.

Remember: This is only a demo server for the application itself. You will need your own asterisk server to test it!

Using the XMLConference application

XMLConference can be used with the following keys on the Snom phone

• arrow keys (up/down/left/right)
• F1 for selecting
• F3 for refreshing the view (Button “2” on Snom 300)

F4 to return into the main menu (Button “3” on Snom 300)

The F2-Key (Button “1” on Snom 300) is only used within the conference room menu where all the users of a conference room are listed. Pressing F2 will send you to the room options menu.

Timeout

A session times out after 5 minutes of inactivity. To avoid session timeout please use a function, e.g. reloading the displayed information page with F3.

Auto Reload

Session timeout can be avoided setting up the auto-reload (refresh) function in the Snom phone. You can choose refresh-rates from 500 to 60000 ms. Please verify the connection speed between phone and server before choosing a value too low.

Building XMLConference yourself

You can compile your own Version of XMLConference. For this you will need Java 1.5 or newer and the Java-Libraries from Asterisk-Java (www.asterisk-java.org).

Running XMLConference (server requirements)

You will need an Apache-Tomcat server Version 5.5 or newer, and a JRE 1.5 or newer to run XMLConference. Apache-Tomcat is available for Linux other OS.

XMLConference - Menus

1. Choose conference rooms

• displays a list of all active conference rooms
• shows the number of persons in this room behind room number
• select room to see the complete list of users

1.1 Inside the conference room

• displays a list of all users in the conference room
• select a user to get more information and options about this user
• press F2 to reach the room options menu

1.1.1 User options

• information about the user
• user can be muted/unmated and/or kicked

1.1.2 Room options

• shows the users in this conference room
• conference room can be locked/unlocked

2. Show Agents

• lists all the agents and their state (if available)

3. Show Queues

• displays a list of all existing queues
• select a queue to get more information about this queue

3.1 Inside a queue

• displays information about the selected queue
• item “Agents in Queue” indicates the number of agents that are assigned to this queue
• the number of agents currently logged-in and the number of agents that are busy are displayed in brackets (selectable item, watch 3.1.1)
• item “Users in Queue” indicates the “quality” of the users in this queue (selectable item, watch 3.1.2)

3.1.1 Agents in Queue

• displays a list of agents that are assigned to the queue
• displays an agents status within this queue

3.1.2 Users in Queue

• displays waiting users in this queue

4. Server information

• displays status information about the Asterisk server

5. Auto refresh

• Set-up of auto-refresh interval to keep phone display up to date (value between 500 to 60000, the time between two refreshes in milliseconds)

6. Logout

• please use this function to keep the number of open sessions small

Downloads

The source files:

Media:XMLConferenceSource.zip

The binary:

Media:XMLConferenceBin.zip