10   VoiceObjects Preferences

This chapter explains how to deal with the VoiceObjects preferences in order to configure Desktop for Eclipse.

The preferences need to be adjusted for instance if you want to switch the connection mode of Desktop for Eclipse or modify the Control Center connections.

Opening the VoiceObjects Preferences

To open the VoiceObjects preferences do the following:

1.        In the menu bar of Desktop for Eclipse open the Window menu and click Preferences. The Preferences window will open up.

2.        In the left pane of the Preferences window, click VoiceObjects. The VoiceObjects preferences will be displayed in the right pane.


 

To apply your settings and close the Preferences window click OK.

Click Apply to save your settings without closing the Preferences window. To restore all displayed settings to their defaults, click Restore Defaults.

Click Cancel to leave the Preferences window without saving any changes.

Configuring the Connection Mode

In the Repository connection section of the Preferences window, you may switch the connection mode from standalone to network or vise versa.

Refer to Chapter 1 – Getting Started with Desktop for Eclipse for more details about the two working modes in Desktop for Eclipse.

i8Note: Working in network mode requires an installation of the VoiceObjects platform and a running VoiceObjects Desktop process.

Switch to standalone mode

1.        In the Repository connection section, select Work in standalone mode.



2.        At the bottom of the Preferences window, click OK to save your settings.

You will log on to the local Metadata Repository and all projects and libraries available will be loaded into the Repository Browser in the left-hand pane of Desktop for Eclipse.


Switch to network mode

1.        In the Repository connection section, select Work in network mode.



2.        Enter the User ID and Password provided to you by your local VoiceObjects administrator. The default user ID and password on a fresh VoiceObjects installation are voadmin / manager.

3.        Enter the Host and Port of the machine running the VoiceObjects Desktop process that points to the Metadata Repository you want to connect to (possibly also provided by your administrator). Based on this information the corresponding WSDL URL is automatically generated. Typically the WSDL URL is of the form (http://server:port/VoiceObjects/Services/WSProvider?wsdl) where server denotes the network name or IP address of the physical server running the VoiceObjects Desktop process and port denotes the connector port for the VoiceObjects Desktop process. The port is set to 80 by default, but can be modified during installation and configuration. See the Installation Guide or the Administration Guide for details.
The WSDL URL can also be entered manually by clicking Advanced….

4.        Optionally click Advanced… to specify required information for a Secure Sockets Layer (SSL) connection to the VoiceObjects Desktop process. Select Connect using Secure Sockets Layer (SSL) and specify the path to the server’s certificate. You can either browse for the certificate and specify an absolute path or directly type an HTTP URI.
Note that if you want to connect through Secure Sockets Layer (SSL) you must enter a certificate URI. Click OK to save your settings and return to the Preferences window.


 

5.        Optionally click Test connection to confirm that the connection details are provided correctly.

6.        At the bottom of the Preferences window, click OK to save your settings.

You will log on to the specified Metadata Repository and all projects and libraries available in the corresponding Metadata Repository will be loaded into the Repository Browser in the left-hand pane of Desktop for Eclipse.


 

i8Note: You can only log on to a Metadata Repository if an appropriate Desktop seat license is available. If a message appears telling you that no more seats are available, contact your administrator. For more information on license management within the VoiceObjects platform see Chapter 4 – Managing Licenses in the Administration Guide.

Ask for connection mode on startup

Desktop for Eclipse can be configured to always ask for the connection mode on startup, which is useful if for instance you frequently shuttle between two locations.

To enable this mechanism the checkbox Ask for Metadata Repository connection on startup must be selected in the Preferences window.



Switch connection mode transiently

The connection mode of Desktop for Eclipse can also be switched transiently directly from the VoiceObjects menu by clicking Switch Connection Mode.


 

As opposed to the setting in the Preferences window, using the Switch Connection Mode dialog will only temporarily change the connection mode. Once Desktop for Eclipse has been closed and restarted, it will startup in the connection mode selected in the Preferences window.

Configuring a Control Center Connection

In the Control Center connection section of the Preferences window, you may add, edit or delete Control Center connections.

For details on the Control Center refer to Chapter 3 – Managing Servers and Services in the Deployment Guide.

i8Note: To add a Control Center connection you need to have the access rights for the Control Center you are referencing. Contact your VoiceObjects administrator if you do not have the appropriate rights.

Add a Control Center connection

1.        In the Control Center connection section of the Preferences window, click Add.


 

2.        The Control Center Connection window comes up.


 

3.        Enter voadmin as User ID and manager as Password if no other user ID and password have been provided to you by your local VoiceObjects administrator.

4.        Enter the Host and Port of the machine running the VoiceObjects Server process that points to the logical Server object you want to open the Control Center for. Based on this information the corresponding WSDL URL is automatically generated. Typically the WSDL URL is of the form (http://server:port/VoiceObjects/Services/WSProvider?wsdl) where server denotes the network name or IP address of the physical server running the VoiceObjects Server process and port denotes the connector port for the VoiceObjects Server process. Typically the port is set to 8099 by default, but can be modified during installation and configuration. See the Installation Guide or the Administration Guide for details.
The WSDL URL can also be entered manually by clicking Advanced.

5.        Also optionally click Advanced… to specify required information for a Secure Sockets Layer (SSL) connection to the VoiceObjects Server process. Select Connect using Secure Sockets Layer (SSL) and specify the path to the server’s certificate. You can either browse for the certificate and specify an absolute path or directly type an HTTP URI.
Note that if you want to connect through Secure Sockets Layer (SSL) you must enter a certificate URI. Click OK to save your settings and return to the Preferences window.


 

6.        Click Browse to retrieve a list of all Server objects available under the previously defined WSDL URL and to select one from the list.

7.        Optionally, enter Testing URL and Testing parameter, which are used in order to start the Debug Viewer or Phone Simulator from the Control Center. A default value based on the host and port configuration is provided automatically.

8.        Enter a unique Alias for this connection, which will be displayed in the drop-down list in the upper right corner of the Control Center.



9.        Click OK to save the new Control Center connection and return to the Preferences window.

10.    In the Preferences window, click OK to save your settings and to exit the VoiceObjects preferences.

11.    Click Test connection to confirm that the connection details have been provided correctly.

You will log on to the specified Control Center connection and all servers, server instances and services available will be loaded into the Control Center initially located at the bottom of Desktop for Eclipse. In order to display the information for the newly added connection select the corresponding alias from the drop-down list in the upper right corner.



Edit a Control Center connection

In the Control Center connection section of the Preferences window, select the connection you want to modify and click Edit.



For details on the connection parameters refer to Add a Control Center connection above.

Delete a Control Center connection

1.        In the Control Center connection section of the Preferences window, select the connection you want to remove from the list and click Delete.


 

2.        In the upcoming confirmation message click OK to finally delete this connection.


 

3.        In the Preferences window, click OK to save your settings and to exit the VoiceObjects preferences.

Advanced Preferences

In addition to changing the connection mode or managing Control Center connections a set of advanced preferences can be defined for Desktop for Eclipse.

To configure advanced preferences for Desktop for Eclipse do the following:

1.        In the left pane expand the VoiceObjects entry and click Advanced.

The advanced preferences will be displayed in the right pane.


Adjust settings for internal server process

In the Embedded Server section several settings regarding the embedded server, which is used for deploying an application temporarily, can be specified.


 

Select Use all local network interfaces if you want Desktop for Eclipse to use all existing network interfaces.

By selecting Select network interfaces from the list you can restrict the access to one or more network interfaces from the list below. Desktop for Eclipse will then only be accessible through the selected network interfaces.

By default Desktop for Eclipse uses the port number 8070. If this port is already in use on your machine you can change it in the Port Number field.

If you want to connect a remote media platform to your local installation and your machine is behind a firewall or uses NAT (Network Address Translation), you will most likely need to specify a Connector URL. For more information about Connector URLs see Chapter 1 – Reconfiguring Initial Settings in the Administration Guide.

i8Note: A modified Connector URL will only take effect after restarting Desktop for Eclipse.

Adjust look and feel

In the Look and Feel section you define the look & feel of your Desktop for Eclipse environment:


 

The Editor theme field allows selecting the theme which defines the colors used in object editors. By default the Editor theme is set to Artic Blue.

In addition, two settings for the Control Center can be specified. Confirmation setting defines when Desktop for Eclipse should ask for a confirmation before executing a Control Center command (Always, Never, On contextmenu commands only; On button commands only).

The Refresh cycle setting defines the interval in which the Control Center automatically refreshes the displayed content. Disabled will disable the automatic refresh of the Control Center.