A Report Depository is a labeled storage area (network folder) where CM4D Scheduler places generated Reports (and Thumbnail images, if defined) once the job is successfully completed.
Depositories are mandatory when using CM4D Scheduler. You must define all Report Depositories for Managed Reports used in Scheduled Jobs. Scheduler Report Depository is the folder assigned to a Managed Report as the location where Scheduler will store the generated PDF report (and Thumbnail, if available).
Report depositories:
- Can have an unlimited number of Depositories
- Must be a NETWORK path
- Must have WRITE access for the Launcher Service User
- Must have READ access for CM4D Web users
- The Depository must have a valid definition - Unique Name & Path (combination)
- The same Depository Label cannot be set for two different folder paths
- The same folder path cannot be set for two Depository Labels
- Valid folder characters
Create Depositories
Depositories are defined via the Report Depository tab in the CM4D Scheduler Manager. A Depository is a labeled storage area where CM4D Scheduler places generated Reports. When a Scheduled Job is run, the generated report will be saved to the Depository assigned to the Managed Report(s) included in the Scheduler Job definition.
- Enter filter text here - Enter a string to filter down the entire grid to only rows containing text matching the string entered. This filtering is dynamic and will update the grid as you type.
- Drag a column header here to group by that column - See the topic Grid Controls for information on how to use the grouping and sorting options available in the Grid area.
- Columns - The available columns can be used to sort and group the results of a search.
- Field Chooser - To access any additional or removed columns, right click in the column header area and select Field Chooser. Drag the column names into position in the column header area and close the Field Chooser dialog.
Label
Enter a unique label to identify the Depository.
Path
Provide a path to an existing network folder where Scheduler will generate the reports that will provide the Report information to be entered into the database. This path should be a UNC path, or you may end up with duplicate depositories on multiple machines, depending on where the Scheduler Job is run from.
You must click Save to commit changes to the Depository paths. If you click Revert, no action will be taken and the change will be reset to the last saved state.
If the folder does not already exist, Scheduler will ask if you would like it to create the folder for you.
If the folder path is modified, Scheduler Manager will move any existing Reports to the new folder location, and update the existing Report Records in the database.
If the folder path is used by another Depository, Scheduler will warn you and now allow that path to be saved as a duplicate Depository. You can choose OK, and then click inside the blank Path field. The invalid path will appear and then you can manually fix the path to create a new folder within an existing Depository path.
Add
Creates a new Depository row. Change the Label and Path, then click Save.
Remove
If you wish to delete a Depository, select the Depository row in the Report Depository grid and click Remove. Click OK to confirm deletion of the Depository. All Report Record entries in the Database associated with the deleted Depository will be removed. To select more than one row at a time for deletion, use either the Ctrl or Shift key, then click the Remove button. Each row will prompt you individually to confirm whether you want to move any report files associated with the Depository.
When a Depository is deleted, Scheduler Manager offers to delete the folder and all files within the selected Depository.
Click Yes to delete the folder and any files within that folder.
Click No to leave the Depository folder and any remaining files on the network.
Purge
If a Report (PDF) originally generated by Scheduler no longer exists in the assigned Depository folder, you can purge (or remove) all records relating to the missing reports from the Database.
Click Purge to delete the records for the selected Depository. The Purge operation will only remove database records for reports that no longer exist in the selected depository.
Revert
Click Revert to return all Depository settings to the last saved state.
How to Create a New Depository
Click Add.
Change the default label Report Depository n to something unique to the reports that will be stored there.
Type in the folder path or click 
to browse to select an existing network folder.
If the folder that you want to use does not exist, you can type in or browse to the partial path, then type in the remaining path information for the folder you want to create.
If the folder doesn't exist, Scheduler will create it for you. Click OK.
Click Save.