In ILOG JViews TGO, the off-page connector type determines how the object base is represented. Each off-page connector type is associated with a specific base renderer that is in charge of drawing the object according to its type and alarm information.

Customizing Existing Off-Page Connector Types

The following properties apply to all these predefined off-page connector types:

The following properties are mapped, that is, their value is computed automatically from the alarms set in the object (column Set). You can override the mapped values or customize their graphic representation even when the object does not carry states and alarms.

The following property is specific to the type IltOffPageConnector.Standard. This type determines the graphic representation of an off-page connector in the form of two nested relief diamonds.

How to Customize Standard Off-Page Connectors

The following CSS extract shows how you can customize the graphic representation of standard off-page connectors. In this example, the size of the off-page connector is set to 21x21:

object."ilog.tgo.model.IltOffPageConnector"[type=Standard] {
   shapeWidth: 21;
   shapeHeight: 21;
}

Customizing New Off-Page Connector Types

How to Create a New Off-Page Connector Type from an Image (using the API)

// Create the new OPC type
IltOffPageConnector.Type opcType = new IltOffPageConnector.Type("MyType");
 
// Retrieve the image and create the base renderer factory
Image img = IltSystem.GetDefaultContext().getImageRepository().getImage("type.png");
IltOPCImageBaseRendererFactory factory = new IltOPCImageBaseRendererFactory(img);
 
// Associate the new OPC type to the image base renderer factory
IltSettings.SetValue("OffPageConnector.Type.MyType.Renderer", factory);

How to Create a New Off-Page Connector Type from an Image (using CSS)

setting."ilog.tgo.model.IltOffPageConnector"{
   types[0]: @+opcType0;
}
Subobject#opcType0 {
  class: 'ilog.tgo.model.IltOffPageConnector$Type'; 
  name: "MyType";
}

Likewise, you can customize the renderer using global CSS settings. To do so, you need to specify the full path to the object to be customized, as well as the value of its name attribute in order to match the right type of object in the system. The CSS property to customize here is renderer. In the example below, the name of the renderer factory class that is included in the search path is MyOPCRendererFactory.

setting."ilog.tgo.model.IltOffPageConnector.Type"[name="MyType"] {
   renderer: @+opcRendererFactory1;
}
Subobject#opcRendererFactory1 {
   class: 'MyOPCRendererFactory';
}

How to Create a New Off-Page Connector Type Using an Image per Base Style

Another way to represent a type with an image is to specify a source image and an alarm color level parameter for every required base style, directly in CSS. No other base style property or renderer parameter is needed, as a complete image is provided for every needed base style.

To create a new type of off-page connector using an image per base style, do the following:

The resources that apply to off-page connector types are identified as:

You can edit the values directly in the JViews TGO resource bundle files.

When you create new off-page connector types, the label and tooltip information will also be retrieved from the same resource bundle to be displayed, for example, in a table cell. As you declare new types, register the corresponding entries into the resource bundle file, as follows:

Considering that you have created the following new off-page connector type:

IltOffPageConnector.Type opcType = new IltOffPageConnector.Type("MyType");

You should declare the following properties in the JTGOMessages.properties file: