Relation can be created from the Saada GUI. Click on the "Relation" tab.
Important The Creation panel only works. Loading and Deletion panels must’nt be used.
Fill carefully the panel. Saada1.4 doesn’t allow to modify configuration from the GUI.
Field | purpose |
Relation name |
the relation name must be unique. It must be set with letters, numbers or ’_’ |
Primary Collection : in collection |
name of collection from which the relationship starts |
Primary Collection : in datatype |
Category of data from which the relationship starts |
Secondary Collection : in collection |
name of collection from which the relationship ends. |
Secondary Collection : in datatype |
Category of data from which the relationship ends |
Correlation definition |
This subpanel adds qualifiers to the relationship. Qualifiers must have a Java compliant name (letters, numbers or ’_’ ans not begining with a number). Set the qualifer name in the "qualifier name" field and then click on "Add a Qualifier" |
The Saada Relationship is created when clicking on the create button.
An SQL table with the relation’s name is created
A java class with the relationship’s name is created is created in SAADA_DB_HOME/algo_correlation. This class must be updated to compute properly the link. The default class will put links between all couple of data. That can produce an hudge link set for arge collections
Populating the relationship
Upgrade the Java class : The method computeLinks of this class must be modified to compute liunks. If links are computed by another way (e.g. SQL query), the content of the method computeLinks must be commented out.
Compile the modified class : Go in SAADA_DB_HOME and run the command ./sant relation.compile. This command compiles all correlator classes found in SAADA_DB_HOME/algo_correlation. Ir Successed only when all classes can be compiled
Populate the relationship : Go in SAADA_DB_HOME and run the command ./sant relation.populate Drelation=RelationName. This command will first empty the relation and then run the correlator class.
Index the relationship : Saada relationships must be indexed to be used. Go in SAADA_DB_HOME and run the command ./sant relation.index Drelation=RelationName
NOTE : The 3 previous command can be run in one step with the command ./sant relation.make Drelation=RelationName
Publish the relationship in the Web interface : As any other meta-data, relationship are cached in the Tomcat application. The best way to be sure that the new relationship is visible for Web users is to restart Tomcat. last update 2007-06-24
|