Bloomberg

The Bloomberg Groups are visual color-coded named groups (much like the io.Connect Channels) which the user can select from the UI of Bloomberg apps. They provide data synchronization across Bloomberg apps (e.g., if two apps are in the same colored group, when an instrument changes in one app, the other app is updated respectively). The Bloomberg Adapter provides configurable mapping between the Bloomberg Groups and the io.Connect Channels.

⚠️ Note that the io.Connect Channels are mapped via configuration to the default names of the Bloomberg Groups. Therefore, modifying the default name of a group in the Bloomberg Terminal will cause the respective mapping between the Bloomberg Groups and the io.Connect Channels to break. Any change you make to a Bloomberg Group name must be reflected in the channels.json Channels configuration file of io.Connect Desktop, which contains the io.Connect Channel definitions and the mappings to the respective Bloomberg Groups.

Get Group Names

Get the known groups as a list of strings with the group names:

• Interop method name: "T42.BBG.GetGroups"
• Accepts: void
• Returns: Array of strings with the available Bloomberg group names;

Example:

const result = await io.interop.invoke("T42.BBG.GetGroups");

// Example value: ["Group-B", "Group-A"]
const groups = result.returned.Result;

if (groups && groups.length > 0) {
    // Use the Bloomberg groups here.
};

Get Group Context

Get the context of a group by name:

• Interop method name: "T42.BBG.GetGroupContext"
• Accepts: The group name as a string;
• Returns: The context of the group as a string;

Example:

const invocationOptions = { group: "Group-A" };
const result = await io.interop.invoke("T42.BBG.GetGroupContext", invocationOptions);

// Example value: "VOD LN Equity"
const context = result.returned.Result;

Update Group Context

Update the context of a group by name:

(void) T42.BBG.SetGroupContext (string group, string context)

• Interop method name: "T42.BBG.SetGroupContext"
• Accepts: The name of the group as a string and context as a string with which to update the group;
• Returns: void

Example:

const invocationOptions = {
    group: "Group-A",
    context: "BARC LN Equity"
};

io.interop.invoke("T42.BBG.SetGroupContext", invocationOptions);

An interop-enabled app can subscribe for and be notified about group changes:

• Interop method name: "T42.BBG.GroupsChanged"
• Accepts: void
• Returns: An array of objects with name and value string properties, representing the name of the changed group and the value of its new context;

Example:

const subscription = await io.interop.subscribe("T42.BBG.GroupsChanged");

subscription.onData(handleGroupChanges);

function handleGroupChanges(streamData) {
    // Example value: [{ name: "Group-A", value: "VOD LN Equity" }]
    const changes = streamData.data.groups;
    // Handle group changes here.
};

By default, all Bloomberg Groups are mapped to io.Connect Channels. The io.Connect Channels and the respective mappings to the Bloomberg Groups are defined in the channels.json Channels configuration file of io.Connect Desktop.

To map a Bloomberg Group to an io.Connect Channel, use the "blpGroup" property of the "meta" object in the Channel definition. It's possible to configure the mappings so that the Bloomberg Groups will synchronize only with the io.Connect Channels, or with both the io.Connect Channels and the FDC3 User Channels.

Synchronization with io.Connect Channels

The following example demonstrates mapping an io.Connect Channel to a Bloomberg Group:

⚠️ Note that this mapping will enable context synchronization of the Bloomberg Groups only with the io.Connect Channels. If you want to map the Bloomberg Groups so that they will be synchronized both with the io.Connect Channels and the FDC3 User Channels, see the Synchronization with io.Connect Channels & FDC3 User Channels section.

{

    "name": "Red",
    "meta": {
        "color": "red",
        "blpGroup": {
            "name" : "Group-G",
            "readDataFieldPath" : "data.partyPortfolio.ric",
            "writeDataFieldPath" : "data.partyPortfolio.ric",
            "read" : "ric",
            "write": "ric"
        }
    }
}

The "blpGroup" object has the following properties:

Property	Type	Description
"name"	string	The name of the Bloomberg Group to bind to the respective io.Connect Channel.
"read"	"ric" | "blp"	The type of the context to read (RIC or Bloomberg ticker).
"readDataFieldPath"	string	Specifies the field path to the io.Connect Channel data from where the Bloomberg Adapter will read the updated Channel context value and then update the Bloomberg Group context.
"write"	"ric" | "blp"	The type of the context to write (RIC or Bloomberg ticker).
"writeDataFieldPath"	string	Specifies the field path to the io.Connect Channel data where the Bloomberg Adapter will write the data retrieved from the updated Bloomberg Group context.

Synchronization with io.Connect Channels & FDC3 User Channels

The following example demonstrates how to map a Bloomberg Group to an io.Connect Channels so that the Bloomberg Groups will synchronize both with the io.Connect Channels and the FDC3 User Channels:

{
    "name": "Red",
    "meta": {
        "color": "red",
        "blpGroup": {
            "name": "Group-G",
            "readDataFieldPath": "data.fdc3_fdc3&instrument.id.BBG",
            "writeDataFieldPath": "data.fdc3_fdc3&instrument.id.BBG",
            "read": "blp",
            "write": "blp",
            "updateObjectFieldPath": "data.fdc3_fdc3&instrument",
            "updateObject": {},
            "postUpdate": { "latest_fdc3_type": "fdc3&instrument" }
        }
    }
}

You can map all other Bloomberg Groups in a similar way, updating only the values for the name of the Bloomberg Group and for the name and color of the respective io.Connect Channel.