This page contains a general overview of the Connexion UI.

The Connexion UI is divided up into several areas.

Toolbars

Connexion includes two main toolbars. These toolbars provide access to most of the main functions regarding the server, as well as creating and importing channels.

Server bar

This Server toolbar allows you to perform actions at the server level. Clicking on a tab will exit the server bar operation.

The toolbar contains the following options. Hover over each icon to see a tool-tip that identifies the action.

Advanced search

Use the Advanced search to locate channels across all groups on the Connexion server.

To search, begin by typing the name of the channel in the Find Channels field. Connexion will display a list of matches using a type-ahead matching logic. Select the channel you want from the list and you will navigate directly to the channel pane.

Server connections

Click on the Server connections, Application Servers, Databases icon to view information about the available servers.

The gray box at the left displays the message counts for the server. Messages are broken down according to:

• Q (queued): total number of messages currently in the server queue (across all channels)
• P (processed): total number of messages that have been processed (across all channels on the server)
• E (error): total number of messages in an error status (across all channels on the server)
• F (filtered): total number of messages that have been filtered (across all channels on the server)

Connexion will also display the name of the current server and the name of the associated database. In the illustration above, the server is Pete and the database is Default.

From this screen, you can add a server, add a message repository (a database), and change the security settings for the database.

To add a server:

1. Click the Add Server Connection icon.
2. Enter the Name, Host, Port, Default User, Domain, and Instance Key for the new server.
3. If this server should be used upon Connexion startup, click the star icon next to the Name field.
4. When you are finished, either click Connect or Connect & Select to connect to the new server.

To add a message repository:

1. Click the Create/Attach Message Repository icon.
2. Enter the database name and creation credentials for the new database. If the database should exist on a separate server, enter it here.
3. Click Create Database.

Once your server and database are created, you can elevate the security credentials.

To set elevated credentials:

1. Click the Set Database Elevated Credentials icon.
2. Set the new user and password for the elevated credentials. If you will be using impersonation, use the "Domain/User" format for the user.
3. Click Update Credentials.

To delete a server connection, click the Delete Server Connection icon and confirm.

Dashboard

The Dashboard \displays a tabular list of all channels currently set up within Connexion. You can filter this table to see channels in specific groups. It also displays statistics for each channel.

Use the fields and options to filter the dashboard to see only those channels you are interested in.

You can export the contents of the dashboard to a delimited file by clicking the Export icon. Note: This will export the current contents of the dashboard, not all channels on the Connexion server.

You can also toggle between all channels and production channels only by clicking the Toggle display icon.

Using Groups and Tabs

A single Connexion system may contain hundreds of channels. In order to provide easier navigation and organization of channels, they can be separated into different tabs on the user interface. The number on the tab indicates the number of channels on that tab.

In the illustration above, there are two tabs in the Connexion installation - Default, which has two devices, and Testing, which contains one device.

Right-click on the tab to see a context menu of available tab operations.

From the menu you can:

• Manage tabs (create, delete, rename); choose Manage Tabs to edit all tabs from a single screen (as opposed to editing tabs one at a time)
• Manage channels (create, delete, start, stop, delete); choose Manage Channels to edit all channels in the tab from a single screen (as opposed to editing channels one at a time)
• Export/import channels on the tab, or Move All Channels on a tab to a particular group within the tab

Within each tab, channels are divided into groups. Currently, groups are a display-only concept and have no server-side impact. A new Connexion installation contains one group, Default. Click the Groups icon to see a list of all groups in the tab.

To edit group information, select it in the list and edit the fields in the right-hand pane.

The Groups screen contains its own toolbar for group operations.

The toolbar allows you to:

• Add a new group
• Delete a group
• Load channels for all existing groups
• Filter groups by Application Server or Repository
• Mark a group to be loaded at startup
• Save or revert changes made to a group

To create a new group:

1. Right-click on the Default tab and choose Add New Group or press CTRL+T.
2. Name the new group.
3. Click Save.

A new tab will appear for the new group.

To move channels between groups:

1. Locate the channel, right-click, and choose Move to group from the context menu.
2. Select the new group.
3. Click Save.

System configuration

Click on the System Configuration icon to access system-level settings, change history, and backups (note, these actions were formerly housed in the System Channel).

See the System Configuration page for more information on these options.

Event log

The Event Log records all events in Connexion across all channels.

The event log includes the following:

• Date Stamp: The date/time of the event.
• Severity: The type of event (Info, Warning, Error, Fatal); errors, warnings, and fatalities are color-coded.
• ID: A unique, system-generated ID for the event (if applicable). Each event ID is associated with a particular error or warning. In the example above, 5083 is associated with a specific database error. Another error (for example, with another database) would have a different event ID.
• App Server: The name of the application server where the event occurred.
• Event: The text of the actual event.
• Channel: The channel in which the event occurred.
• Device: The device in which the event occurred (if applicable).

Each of these columns can be filtered by using the drop-downs or by entering the filter criterion in the text field.

In addition, the Event Log provides the following options via buttons at the top of the event table.

• Click Query to refresh the table and add any new events that may have occurred.
• Click Log Folder to open the directory where log files are stored as text files in Windows Explorer. Files can then be opened in a text editor, moved, or emailed.
• Use the arrow buttons to browse through the event list.
• Click any of the remove buttons to:
  • Remove only today's events
  • Remove all events
  • Remove specific events

Channel toolbar

The Channel toolbar contains icons that allow you to perform various channel operations.

Operations include:

• Create New Channel
• Import Channel(s) from File (*.cxn)
• Manage Channels
• Import Custom Device (*.dll)
• Open Connexion Package Manager (to import devices/channels)
• Create a Bug Report
• About Connexion
• Show Help

See Channels and Devices for more information on channel/device operations.

Channel/Device panes

Connexion will display panes containing configuration options for a channel. Selecting a device within a channel will display configuration options for that particular device.

Channels Pane

Before any channels have been configured, Connexion will display a variety of options to allow you to start creating channels or configure administrative settings (if not done so previously).

Once a channel has been configured, select it to see channel details, as well as configuration options for the channel.

See Channels and Devices for more information.

Device Pane

The Device pane displays configuration options for a particular device. Select the Device in the channel to view and change configuration options.

See Channels and Devices for more information.

Resizing and Docking

The size of the channels pane and device pane can be adjusted vertically by hovering the mouse over the upper grey divider bar and dragging up or down.

The device pane can be detached entirely from the application, which can be useful in multi-monitor configurations. To detach the device pane, click the windowing icon on the right side of the device bar.

To re-attach the floating window to the main window, click the windowing icon. The floating window can be moved by clicking and dragging on the top-most bar, and maximized by clicking on the maximize icon in the top-right corner of the floating window.