The WebSocket connector is very similar to the Streams Simulator connector, except that rather than looping through a file, it would either connect through web sockets, long polling, or repeatedly poll an external URL for new records to process.
Steps:
1. Enter the connection details:
Property |
Description |
Path |
The path to which the WebSocket server will respond to. |
User ID |
The User ID that will be used to connect to the WebSocket server. |
Password |
The password that will be used to connect to the WebSocket server. Check the Show Characters box to display the entered characters. |
Request Body |
For both the HTTP and ws:// POST requests sent to the WebSocket server. |
Timeout |
The length of time to wait for the server response (10 to 300). Default is 10. |
2. Select the Message Type.
3. Select either the dot (.) or comma (,) as the Decimal Separator.
NOTE |
Prepend 'default:' for the elements falling under default namespace. |
4. Click to the fetch the schema based on the connection details. Consequently, the list of columns with the data type found from inspecting the first ‘n’ rows of the input data source is populated and the Save button is enabled.
This also populates the Id Column with the set of columns, of arbitrary type, that can be concatenated to form a unique row identifier.
5. You can also opt to load or save a copy of the column definition.
6. Click to add columns to the WebSocket connection that represent sections of the message. Then enter or select:
Property |
Description |
Name |
The column name of the source schema. |
JsonPath/Text Column Index/XPath |
The JsonPath/Text Column Index/XPath of the source schema. |
Type |
The data type of the column. Can be a Text, Numeric, or Time |
Date Format |
The format when the data type is Time. |
Filter |
Defined parameters that can be used as filter. |
Enabled |
Determines whether the message field should be processed. |
NOTE |
To parse and format times with higher than millisecond precision, the format string needs to end with a period followed by sequence of upper case S. There can be no additional characters following them. For example: yyyy-MM-dd HH:mm:ss.SSSSSS |
7. Date/Time values of output data and Date/Time inputs, where supported, is by default unchanged.
You can opt to define the Show in Timezone and Source Timezone settings.
8. For this section:
Refer to Define Real-Time Settings for more information.