saada logo

 
  SAADA OVERVIEW
Home  
News  
Tutos and Links  
Download  
  Tutorial
Getting started  
Doing More  
SaadaQL  
The Web Interface  
VO Publishing  
Tips & Troubelshooting  
  COMMUNITY
Mailing List  
Saada Sites  
How to Contact us ?  
  DEVELOPER CORNER
Contributors  
Next Step  
Old Releases  
Inside Saada  
Using UWS  

 

SourceForge.net Logo


HOME ART > DEVELOPER CORNER > Old Releases > Saada 1.4.2 > TUTORIAL > Saada Relationships > Create a Relationship
Relationship Setup



 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