By default, the report output files are saved in the content store. You have also have the following choices for saving report output files:
You can save a copy in another file location
outside of Cognos 8 so that you can share it with external applications
or people who don’t have Cognos 8 .
This is how most report output files are saved.
You can save a copy in another file location inside Cognos 8
so that it can be used again . This may also be useful for archive purposes,
since files that are saved in the Content Store may be deleted regularly
due to retention rules.
A descriptor file with an _descr extension is also saved. Saved files are not managed by Cognos 8.
You can specify that an additional copy of report output be saved in a file system outside of Cognos 8. For example, users may want to share a report with an external application, such as a web site, and have it saved there every time it is updated so that current content is always available. Users may also want to save reports on a Local Area Network for people who do not have access to Cognos 8.
In Cognos Connection, if users select Save to the file
system as the report delivery method when they run or
schedule a report, the files are saved in the specified location
each time the report runs.
There are two associated properties in Cognos Configuration that must be set first: one enables saving file output to a file system, the other specifies the root directory for saving files. For more information, see the Cognos 8 Installation and Configuration Guide.
You must have the required permissions to access Cognos Administration functionality. See Secured Functions and Features.
Start Cognos Connection.
In the upper-right corner, click Launch, Cognos Administration.
On the Configuration tab, click Dispatchers and Services.
On the toolbar, click the Define File System Locations
button .
Click New.
Enter a name, description, and screen tip.
In File systems location box, type the location where you want to save report output files.
The location that you type is appended to the File system root location.
Click Finish.
By default, report output files are saved in the content store. For single-file report outputs, you can also save a copy of the output in a file location in Cognos 8 so that you can use it again. This may also be useful for archive purposes, since files that are saved in the Content Store may be deleted regularly due to retention rules.
The following formats can be saved: PDF, .csv, XML, Excel 2002, and HTML that does not have embedded graphics. You cannot save HTML fragment, XMTML, or Excel 2000 or 2007 single sheet formats.
In Cognos Connection, if users select Save to the file
system as the report delivery method when they run or
schedule a report, the files are saved in the specified location
each time the report runs.
The file location applies to saved output originating from the selected Content Manager service.
When you save report outputs files to a file system in Cognos 8, a report output descriptor file is also created. The descriptor file is an XML file that contains information about the report output, such as the name, locale, creation time, owner user name and authentication namespace, the associated report search path, burst key information, and the report version contact.
The descriptor file takes the same name as the output file, with the suffix _descr added. For example, a saved PDF report with the name 158_1075940415360.pdf has a descriptor file with the name 158_1075940415360_desc.xml.
You can also specify a script so that you can run post-processing commands each time a report output is copied to the file system. For example, if your report output files are ultimately stored in an archiving system, you can use a script to perform this action.
You can use the settings that are listed in the following table.
Parameter | Purpose |
CM.OutPutLocation | The location where you want to store copies of report output files. Old report versions are not deleted when a new one is saved. You must manage the content of the output directory to keep the report versions you want. |
CM.OutputScript | The location and name of a shell script, such as a .bat or .sh file, that runs after a report output is saved to the target directory. The full file names of the output file and descriptor are passed to the script. |
CM.OutputByBurstKey | When report output is distributed by bursting, it is assigned a burst key. Specify whether to store output in a subdirectory with the same name as the burst key. Default: false (output not stored by burst key) |
Start Cognos Connection.
In the upper-right corner, click Launch, Cognos Administration.
On the Status tab, click System.
In the upper-left corner of the Scorecard pane, click the arrow to view the Change view menu. Click Services, and then click Content Manager.
Click the arrow next to ContentManagerService to display the Actions menu, and then click Set properties.
Click the Settings tab.
Click Edit next to Advanced Settings.
Select Override the settings acquired from the parent entry.
In the Parameter column, enter the parameter name.
For example, enter CM.OutPutLocation.
In the Value column, enter the associated value for the setting.
Continue entering setting names and values as required.
Click OK.
On the Set properties page, click OK.