FIXimatesm User Guide

v4.0.0

FIXimate is an interactive Web browser based reference for the FIX Specification. FIXimate has been generated from the FIX Orchestra Repository. This section provides a user guide for the various features and capabilities of FIXimate.

Screen setup

The screen is split into three areas as follows:

The upper set of links on the left-hand side offers this user guide, a disclaimer, release notes, the download of FIXimate for offline usage, and allows to switch to the display of FIX legacy versions. The latter shows the scope of the FIX Repository at the time of the release of previous FIX versions all the way back to FIX 4.0. It offers a link to switch back to FIX Latest in the same area of the screen.

Selecting content for display

The second section on the left-hand side of the screen offers a number of search boxes to select data for display on the upper or lower pane on the right hand-side as follows:

Using regular expressions to search the repository

Regular expressions are extremely powerful and may be used inside the "Find all:" search box. Especially the characters ^ (element must start with this string), $ (element must end with this string), and . (element can have any character at this position) are very useful and shown as a hint beneath the search box. Character ranges (e.g. "[0-9]" or "[A-Z]") and repetitions (e.g. "{3}") are also supported. Special characters like brackets (e.g. "(") need to be escaped with a backslash character ("\"). Please see here for further detail.

Note that FIXimate does not support case sensitivity in regular expressions.

Examples:

The third section on the left-hand side offers a number of predefined lists for display on the upper pane on the right hand-side as follows:

The elements in these lists can then be selected to see more detailed information. Message and component details are displayed in the upper pane of the right-hand side, thereby replacing the previous list. Fields and code set details are displayed in the lower pane of the right-hand side without removing the list from the upper pane.

The fourth and last section on the left-hand side offers a detailed list of FIX messages structured by business area and category. Each of the areas and categories can be expanded or collapsed to show the desired subset of FIX messages. The user may then click on any of the messages to trigger its display in the upper pane of the right-hand side.

Display of search results

Search results from the Find all box are displayed in the upper pane of the right-hand side of the screen. The results are sorted by name grouped as follows:

Display of messages

Messages are displayed in the upper pane of the right-hand side of the screen. The message name can be clicked to open the message details in a separate tab for better visibility. The nested components of a message are collapsed upon display and can be individually expanded or collapsed by clicking on Component or the name of the component. It is also possible to collapse or expand all components at once.

When expanding a component, the screen area to the left of the first column changes to a grey color to show what belongs to this component. If the component is a repeating group, an additional visualization is provided in form of a bracket. This is useful when analyzing deeply nested components with multiple repeating groups.

Additionally, upon expansion of a component, the lower pane is used to display the overall usage of this component in FIX messages and/or components. Any of the displayed message or component names can be selected to have the upper pane display it instead of the message shown before.

The following information is provided:

Display of components

Components are displayed in the upper pane of the right-hand side of the screen. The component name can be clicked to open the component details in a separate tab for better visibility. The information provided for the component and the handling of nested components are identical to what is available for messages (see above). Additionally, information about the usage of the given component is provided at the end of the upper pane.

Display of fields

Fields are displayed in the lower pane of the right-hand side of the screen. The tag number or field name can be clicked to open the field details in a separate tab for better visibility. The usage of a given field in messages and components is displayed at the end of the lower pane. Any of these message or component names can be selected to have the upper pane display the details.

Instead of resizing upper and lower pane to increase the space for the display of a field with a large code set, it is possible to click on the field name to open a separate browser tab that only shows the field details.

The following information is provided for a field:

Display of code sets

Code sets are displayed similar to fields in the lower pane of the right-hand side of the screen. The usage of a given code set in fields is displayed at the end of the lower pane. Any of these field names can be selected to have the lower pane display the details, thereby replacing the code set shown there before.

The following information is provided for a code set:

URLs for direct access

FIXimate can be invoked from the FIX website by using the dropdown menu Tools. This opens up FIXimate in your browser as it is a simple URL (https://fiximate.fixtrading.org/). However, it is also possible to use a URL with additional elements in two ways.

  1. Open a full version of FIXimate with the result of a predefined search
  2. Open FIXimate as a single frame to show an individual message, component, field or code set.

The first usage requires to append a single parameter to the base URL to provide an identifier or name of a message, component, field or code set. It is also possible to append an arbitrary search term as if one had manually entered it into the Find all search box. The result is FIXimate running in a browser with all three panes, the search item being shown on the left-hand side and the search result in the upper pane of the right-hand side.

Here are some examples:

The second usage is to extend the URL with direct access to the message, component, field or code set. This is useful as part of documentation or specifications to reference the standard FIX definition.

This approach does not apply to an arbitrary search and requires knowing the unique identifier as defined in the FIX Orchestra Repository. The result is a single pane with the details of the selected message, component, field or code set.

Here are some examples: