Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Summary_list
Task5Settings
Task1Overview
Task2Summary
Task3Inputs
Task4Outputs

HTML
<a id="Overview"></a>

Overview

To configure a controller, select it from the

Referencemacro
LabelAll controllers
list, as shown below:

...

The

Referencemacro
LabelSummary
screen will appear, allowing you to configure the inputs and outputs of the selected controller:

HTML
<a id="Summary"></a>

Summary

The

Referencemacro
LabelSummary
section allows you to add, view or edit the data inputs and outputs of the selected controller. From this section you can access the full list of inputs and outputs of the controller, but also the settings of a specific input or output, by clicking on the relevant link:

Screenshotmacro
Borderfalse
Shadowfalse
URL/download/attachments/12588544/config_controller_1.png

HTML
<a id="Inputs"></a>

When you first set up the system, the Summary screen will be empty. To add a data input or output to your controller, check the relevant sections below.

Inputs

To add a new data input, click on the

Buttonmacro
LabelAdd new
button from either the
Referencemacro
LabelSummary
or the
Referencemacro
LabelInputs
screen, as shown below:

Screenshotmacro
Borderfalse
Shadowfalse
URL/download/attachments/12588544/config_controller_2.png

A new window will open, allowing you to name the data input. Enter a name and click on the

Buttonmacro
LabelAdd
button, as shown below:

Screenshotmacro
Borderfalse
Shadowfalse
URL/download/attachments/12588544/config_controller_3.png

The new input will be added to the 

Referencemacro
LabelAll inputs
list, as shown below:

Screenshotmacro
Borderfalse
Shadowfalse
URL/download/attachments/12588544/add_input.png

Configuring the data input

To configure a data input, select it from the

Referencemacro
LabelAll inputs
list, as shown below:

Screenshotmacro
Borderfalse
Shadowfalse
URL/download/attachments/12588544/config_input_1.png

A new window will open on the right-hand side panel, allowing you to configure the settings of your data output:

Screenshotmacro
Borderfalse
Shadowfalse
URL/download/attachments/12588544/config_input_2.png

Name

The

Referencemacro
LabelName
field allows you to view or edit the name of the current data input. To rename, overtype the current entry.

Type

The

Referencemacro
LabelType
field allows you to specify the connection method by which the data should be collected from the phone system. The following methods are supported:

  • Listener
  • Serial port
  • Client socket
  • Pipe server
  • BCM SSH
  • XML file
  • File reader
  • BCM DCOM

 

Listener

This method creates a socket and binds it to a specific port, accepting any data received on the connection without challenge.

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_listener.png

FieldDescription
Connection message

An optional greeting message which is sent to any connecting socket.  This message can include one or more of the following variables:

  • Keywordmacro
    Label{remoteip}
    - the IP address of the remote party
  • Keywordmacro
    Label{remoteport}
    - the remote party's source port
PortThe port that the listener should bind to
Address family The address family of the socket
Socket typeThe type of data flow the socket expects
Protocol typeThe type of protocol the listener will use
Serial port

This method allows the connection of a serial (RS-232) device.

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_serial.png

FieldDescription
Port nameThe name of the serial port device, e.g. COM 1, COM 2
Baud rate
The serial port's speed
ParityThe parity check regime
Data bitsThe number of data bits, between 5 and 8
Handshake

The type of handshake the serial port requires:

  • none - no handshake required
  • rts - Request to Send
  • xonxoff - X-On/X-Off
  • rtsxonxoff - either RTS or X-On/X-Off is used
Buffer sizeThe size of the serial port's data buffer
Buffer threshold The size that the buffer must first reach before being empty
Stop bitsThe number of stop bits used
Client socket

This method creates a TCP socket and connects to a remote host.  When the connection is established, optionally, a password can be sent. Thereafter, any data received is accepted.

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_client_socket.png

FieldDescription
AddressThe IP address or hostnameto which the socket should connect
Address family The address family of the socket
PortThe port that the listener should bind to
UsernameAn optional username which is sent upon successful connection.
Password

An optional password which is sent upon successful connection.

IP script 
Trickle frequency 
Trickle data 
Pipe server

This method opens a global named pipe and accepts any data that is sent to it.

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_pipe_server.png

FieldDescription
Pipe name
The name of the pipe that is created
Buffer size
 The size of the buffer, in bytes, that is allocated to the pipe.
BCM SSH

This method registers a connection with the 

Referencemacro
LabelNortel CDRClient.dll
library and receives data-callbacks whenever the PBX produces data.

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_BCM_SSH.png

FieldDescription
Host
The IP address or hostname of the BCM PBX
Username
The username required to access PBX CDR events
PasswordThe password required to access PBX CDR events
App ID 

 

XML file

This method monitors an XML file for new nodes.  Any new nodes are extracted and presented into a new XML document.  An XPath query is used to specify which nodes to monitor.  A unique element is required to track which nodes are new.  Default properties are designed to workwith the "ticketcollector.xml" file produces by an 

Referencemacro
LabelAlcatel OmniPCX Enterprise
PBX.

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_XML_file.png

FieldDescription
Location
The full filename of the XML file to be monitored. The 
Keywordmacro
Label{app}
variable can be used to specify the program data location of the running service
X-Path query
The XPath query to use when testing for new nodes
Checksum nodeThe unique node/element to use to track which nodes have been added since the last check
Outer element

The name of the outer XML element to be used to contain any new nodes when the new XML document is created for output.

Check interval 
Delay

A value, in milliseconds, that specifies the artificial delay that is waited when a change in the source XML file is discovered.  If the file were to be accessed immediately upon a change, i.e. without such a delay, the operating system would most likely not allow access to the file so soon, causing a sharing violation.

File reader

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_file_reader.png

BCM DCOM

Screenshotmacro
Borderfalse
URL/download/attachments/12588544/input_BCM_DCOM.png

HTML
<a id="Outputs"></a>

Outputs

HTML
<a id="Settings"></a>

Settings