Excerpt from the Cassini Reference Manual.
The Guru Browser application allows you to browse, recover, import, and export files from the Guru database as Guru objects.
After logging on to Guru, click the Apps then select Guru Browser.
Browsing Guru Objects
Once the Guru Browser application comes up, you first must specify a search parameter or 'key1' to identify which Guru object attribute you would like to browse, by default this is set to ri.sys.ObjClass. For a list of object classes, please refer to RI Guru Object Classes document.
For example, you want to browse the RiPatch objects, therefore you'd choose the RiPatch from the list and all available RI Patches are displayed to the right side of the window as shown below.
You can specify what information you want to be displayed. The above window, displays the ri.sys.Name and ri.sys.CreationDate information. You can configure what to be displayed by selecting the Options > Config Table View menu.
This will display the following window.
You can select the keys from the Available Keys and click the right arrow to add to the Viewed Keys. To remove any specific keys from the Viewed Keys, select the key you want to remove, then click the left arrow. To change the order of the keys, use the up and down arrow buttons at the bottom of the Viewed Keys display. When done, click the Save button.
You can choose the display to sort in ascending or descending order by choosing the Ascent or Descent selection respectively, followed by clicking the Refresh Table button. You can also choose to display all of the available objects by choosing All, or only display the last object by choosing Last, or you can specify how many objects you want to display by choosing SelectNumber and enter the maximum number of objects you want to display.
Exporting a Guru Object
To export a Guru object using the Guru Browser application, select the object you want to export. The following window displays an example of exporting RiTestplan object with title of testplan01. First, 'key1' is set to ri.sys.ObjClass. Then, select testplan01 from the list. Click the right mouse button, and select the Export > send to Export List menu.
Then, at the bottom of the RI Guru Browser window, click on the Guru Export List page.
You can export more than one Guru objects at a time. When done with adding all of the Guru objects to be exported, click the Export button. Enter any comment you would like to add to the export objects.
Select a directory you want to save the exported file at by selecting the Look in: field; and enter a filename in the File name: field. Typically, you would leave the file type as default (.gzp). When done making your selections, click the Export button. This will create a packed Guru Zip file that includes all the objects you selected and you now can save, store or transport that file to another guru. This is very useful for ending files or objects to RI for support questions etc.
Importing a Guru Object
To import a Guru zip file xxx.gzp that includes Guru objects, use the Guru Browser application, click the Guru Import List page of the Guru Browser window.
Click on the Get Import File(s) button to select which file to import the Guru objects to the local Guru.
The contents of the .gzp is previewed above with color indicating the following:
- Green text denotes objects that do not currently exist in the local Guru and will imported
- Red text denotes that object to be imported is newer than the version that exists on the local Guru. This object will be imported, and when requested by an application, the imported version will be used. The older version will be saved in the local guru’s revision history.
- Magenta text denotes that object to be imported is older than the version that exists on the local Guru. This object will be imported, and when the object resource is requested by an application, the current version on the local Guru will be used. The imported older version will be saved in local guru’s revision history.
- Black text denotes that the object already exist in the local Guru and is the most current version and as such, the object in the import list will not be imported.
Select the directory and filename which you placed the imported file, then click on the Import button to close the dialog.
Now press the "Import" button, when the process is finished, you have the Guru object(s) in your Guru. When the process is finished, you have the Guru object(s) in your Guru.
RECOVERING a GURU OBJECT
To recover a Guru object using the Guru Browser application, select the object you want to recover and make it the last revision. The following window displays an example of recovering RiTestplan object with title of testplan01. First, 'key1' is set to ri.sys.ObjClass and select RiTestplan as the object class. Then, select testplan01 from the list.
Note: Each Guru Application may have a more direct method for accessing previous versions, like the Show Test Objects. menu in the Test Plan Editor.
Once you've selected a Guru object, click the Revision History page the bottom of the window.
The above window displays the list of the available versions of the selected Guru object. Select the one which you want to recover from and right click mouse button and select Make Last RevisionOf. This step makes the selected object to be the latest version in Guru. DO NOT use this to revise application objects (i.e. use a previous version of the Device Connection Editor) without specific instructions from RI Support.