The Data Info code is used to define the data provided by a web application, its grouping in a navigation tree and the linking between different web applications. All the data, grouping and linking information is stored in the glastgen database.
The code provides a set of classes to read/update the database and a set of beans to easily access this data in a JSP environment.
The beans are added to each of the application's sessions via a filter that is meant to be added to the application. The filter also adds additional functionality for saving/loading information via xml files.
Finally we provide a set of tag files containing forms to view/edit the data, grouping and linking information. These tag files can be easily embedded in web applications.
Three beans are available, one for each of the data operations provided: Info, Grouping and Linking.
The filter creates a new set of application specific beans every time an application is deployed (in the init(FilterConfig) method). To do this it requires the application initialization parameter containing the name of the application as it appears in the Applications table below.
When the doFilter method is invoked for a new session the static beans are added to the session's scope.
The following set of database tables are used by the Data Info code.
The Applications table defines the available applications.
Column Name |
Description |
---|---|
APPID |
The primary key. |
APPLICATION |
The name of the application. |
SHORTNAME |
A short name for the application; meant to be used in linking. |
URL |
The URL of the application without the context. To be used in linking. |
PAGE |
The page where the plots are. Also for linking. |
The DataInfo table defines the application specific data. Most of the columns in this table are used for plotting purposes.
Column Name |
Description |
---|---|
ID |
The primary key. |
NAME |
The name of the data. This name must be unique within an application. |
APPID |
Foreign key to the application's primary key. |
TYPE |
The java type of the data object: hep.aida.IHistogram1D, hep.aida.IHistogram2D, org.glast.base.application.data.trending.TrendingDataChannel. |
TITLE |
The title of the corresponding plot. |
LOGYAXIS |
Boolean flag to set log y axis. |
XAXISLABEL |
The data x axis label. |
YAXISLABEL |
The data y axis label. |
LABEL |
The name of the data used in the navigation tree. It not provided the name will be used. |
DESCRIPTION |
Not used for now. The description is meant to be used to explain the data (tooltips, popups, boxes) |
STYLE |
Not used for now. Meant to be a list of comma separated style names to be applied when plotting the data. |
PATH |
Obsolete; used in System Tests for grouping To be removed. |
The DataGroups and GroupLeaf tables are used to group data together. The GroupLeaf table defines the tree's leaves, while the DataGroups table defines the folders.
Using this table allows the same data to belong to multiple folders.
Column Name |
Description |
---|---|
LEAFID |
The primary key of the leaf. |
DATAID |
Foreign key to a data's primary key. |
GROUPID |
Foreign key to the primary key of the group (folder) to which the leaf belongs to. |
Column Name |
Description |
---|---|
GROUPID |
The primary key of the group. |
GROUPNAME |
The name of the group as it appears on the navigation tree. |
PARENTGROUP |
Foreign key to a group's primary key. It allows a nested structure. |
OWNER |
The name of the group's owner. Used to display user's specific groups. |
APPID |
Foreign key to the application's primary key. |
OPERATOR |
Not used for now. Meant to somehow contain information on what to do to the contained data when the folder is selected. |
DESCSHORT |
Not used for now. Meant for ?. |
DESCLONG |
Not used for now. Meant for ?. |
Links are connections between a data or a group in one application to a group and/or a set of data in the same or another application.
Column Name |
Description |
---|---|
ID |
The primary key of the leaf. |
LINKID |
The id of the link the leaf belongs to. |
DATAID |
Foreign key to the data's id contained in the leaf. |
Column Name |
Description |
---|---|
LINKID |
The primary key of the link. |
STARTAPPID |
Foreign key to the application's id from which the link originates. |
ENDAPPID |
Foreign key to the application's id where the link ends. |
FROMFK |
Foreign key of the data from which the link starts. |
TOGROUPID |
Foreign key to the group's id where the link ends. |
OWNER |
The owner of the link. Used to display user's specific links. |
TODATA |
Obsolete. To be removed. |