Updating an Existing Report
Use the update Report command to modify an existing report. The report to update is specified by the parameter -report. The property values that you want to modify must be provided by an updated configuration file.
Note: | All property values provided by the configuration file will be overwritten. In case you want to retain the existing property values, you must delete the whole property entry from the configuration file. |
The syntax for the command is:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Report [-url <CENTRASITE-URL>] -user <USER-ID>-password <PASSWORD>-report <REPORT>[-file <CONFIG-FILE>] [–template <TEMPLATE-FILE>]
The input parameters are:
Parameter | Description |
-url | (Optional) The URL of the CentraSite registry. Default value is http://localhost:53307. |
-user | The user ID of a registered CentraSite user who has the CentraSite Administrator role. For example, Administrator. |
-password | The password for the registered CentraSite user identified by the parameter -user. |
-report | Name or key of the report you want to update. If the report name contains white spaces, enclose the name with "". |
-file | (Optional) Name of the configuration file which contains the report properties. For additional details, see Report Configuration File. |
-template | (Optional) Name of the BIRT report design (.rptdesign) file to update. |
Examples:
Providing report configuration file and BIRT report design file:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Report -url http://localhost:53305/CentraSite/CentraSite –user Administrator –password manage –report “API Usage Report” –file c:\temp\APIUsageReportConfig.xml –template c:\temp\APIUsageReport1.rptdesign
Providing report configuration file:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Report -url http://localhost:53305/CentraSite/CentraSite –user Administrator –password manage –report “API Usage Report” –file c:\temp\APIUsageReportConfig.xml
Providing BIRT report design file:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd update Report -url http://localhost:53305/CentraSite/CentraSite –user Administrator –password manage –report “API Usage Report” –template c:\temp\APIUsageReport1.rptdesign
The response to this command could be:
Executing the command : update Report
Successfully executed the command : update Report
A sample update configuration file is shown below. The sample illustrates how you can overwrite the description of an existing report. All other property values will remain unchanged.
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties version="1.0">
<entry key="com.centrasite.report.Description">Detailed Description of the
API Usage Report </entry>
</properties>