Kbase P102484: What are CorVu logical directories?
Autor |
  Progress Software Corporation - Progress |
Acesso |
  Público |
Publicação |
  3/24/2005 |
|
Status: Unverified
GOAL:
What are CorVu logical directories?
FIX:
CorVu Logical Directories
SUMMARY
When CorVu builds a Quick Report, it hard-codes the directory in which the .sqy file should be found that was created when the report was built. It is possible though to use logical or relative directories, by adding entries to the CORVU.INI, thus increasing the portability of the report and the security. Adding the entries to the INI file must be done before the report is created.
PROCEDURE
Setting up CORVU.INI ? Directories Entry
First, setup the CORVU.INI file in the Corvu directory with the following entry:
[Directories]
HOME=C:\Corvu\Test\
The entry to the left of the equal sign, in this case HOME, can be any identifier you wish. (However, no spaces.)
The right-hand part of the entry should point to the directory where the embedded object(s) that will be part of your new object is/are saved. In our case, this should be the place where the SQY file is saved prior to creating the QRP, (Quick Report file).
How to Use Logical Directories
Once you have setup the CORVU.INI file, go into Graphical Analysis and create your Quick Report, saving it as a QRP.
So what did this do? When you saved the QRP file, CorVu made a notation within the file of what the name of the SQY file is that the QRP was created from and in which directory it will find it. However, because we had setup our CORVU.INI file with the logical HOME pointing to the directory where we saved the SQY file, CorVu will place the logical HOME in place of the path statement.
The QRP file can be accessed by e.g. Notepad. Note that the embedded SQY entry now has a directory of HOME, instead of a specific hard-coded directory.
Now, if required, the SQY object to any directory and simply update the CORVU.INI file to tell CorVu how to resolve the symbolic HOME.
For example, if we were to move the SQY to a directory called Corvu\Sqys on our C: drive, the entries for our CORVU.INI file would look like this:
[Directories]
HOME=C:\Corvu\Sqys\
Now when we run our Quick Report, CorVu will find the SQY in the new directory.
Additional Information
Another reason to do this is if you are creating the Quick Report on a different PC than will be used to actually run the Quick Report.
One note, you can have as many Logical Directory entries as you wish. This will work with any embedded object within any CorVu object.
You can also create a menu with the HOME directory set. Doing so, saves the home rather than the actual path. However, if you view the file behind the option, you will see the true path.
Warnings!
A couple of things to keep in mind as to how this all works.
1. This procedure must be done prior to the creation of the CorVu object. Objects created prior to this change won't find the Logical Directory.
2. Any computer which is to use this Logical Directory must have the identical settings in its CorVu.ini file prior to creation. CorVu will translate as much of a path as matches a Logical Directory entry. CorVu will not use the first match in searching the Directories entry. Instead, it will first of all take the longest path that matches a logical.
What does this mean? Suppose, for example, you have the following Directories entries in the CORVU.INI:
[Directories]
TEST=C:\TestData
TEST1=C:\TestData\Test1
When you save your object, the following translations will occur:
Any pointer to a file saved in C:\TestData\Test1 would have the path transl.ated to TEST1
Any pointer to a file saved in C:\TestData\Test1\Fred would have the path translated to TEST1\Fred
Any pointer to a file saved in C:\TestData\Fred would have the path translated to TEST\Fred
3. Furthermore, there are two internal Logical Directories within CorVu - DataDir and CorvuDir. They point to the DataDir and CorvuDir entries in the CORVU.INI files. CorVu advises not to set any logical directory entries equal to these, i.e. do not put the following in the Directories entry: TEST=DataDir.