skip to main content
Programmers documentation > Integrating with JViews Diagrammer > The TGO-SDM adapter
 
The TGO-SDM adapter
The TGO-SDM adapter is a layer that provides a live mapping between a JViews TGO data source and a JViews Diagrammer SDM model. This feature allows you to integrate and visualize JViews TGO business data in JViews Diagrammer views.
JViews Diagrammer views can leverage the JViews TGO data source structure to create highly customizable diagram representations of the business data hierarchy and attributes.
Data source hierarchy mapping
The mapping at the hierarchy level handles the correspondence between the JViews TGO data source hierarchy and the SDM model hierarchy: a TGO parent object is mapped to an SDM node and a TGO child object is mapped to an SDM child node.
JViews TGO provides different types of hierarchical objects, such as shelves (IltShelf), cards (IltCard), BTS (IltBTS), as well as subnetworks (regular parent-child relationship). All these hierarchies are mapped to parent-child relationships at the SDM model level.
Attribute binding
The mapping at the attribute level handles the correspondence between the JViews TGO attribute model (IlpAttribute) and the SDM object properties (IlvSDMModel). Unlike the 1:1 hierarchy mapping, the attribute mapping is more complex as a TGO attribute may hold a collection of data whereas an SDM object property is designed to hold a single string-based piece of data.
For example, the JViews TGO predefined attribute objectState (ObjectStateAttribute) holds all statuses and states associated with an object, including alarm, severity, primary and secondary states. The attribute mapping binds the TGO objectState attribute to different SDM object properties, such as alarm and severity. Because of the complexity of this mapping, it may be declared as read-only, which means that the SDM model can only read the bound property but not modify it.
For details about the JViews TGO data source, see Programmers documentation > Business objects and data sources > Data sources.
For details about the JViews Diagrammer SDM model, see Other related documentation Rogue Wave JViews Diagrammer > Programmer's documentation > Developing with the JViews Diagrammer SDK > Introducing the SDK > Styling and Data Mapping (SDM).

Copyright © 2018, Rogue Wave Software, Inc. All Rights Reserved.