The OnBase software necessary to automate disc creation for Document Distribution consists of the OnBase Client and its regularly required DLLs, as well as its configuration to communicate with Rimage.
The OnBase Client software communicates with Rimage through a pair of Rimage files, the Image Order File and Production Order File. These files must be configured for both the Rimage software and the OnBase Client. To configure the OnBase Client for use with Rimage, complete the following steps.
The settings in the CD Setup for Rimage dialog box are specific to the current Windows user.
-
In the Client go to File | Rimage Setup and populate all of the path fields in the CD Setup for Rimage dialog box:
- Enter the paths to the Production Order File Path and the Image Order File Path. It is mandatory that these paths are identical to the paths configured for Rimage when the Rimage software was installed.
-
Enter the path to appropriate label file in the Backup Label File Path, Export Label File Path, or Statement Label File Path fields. A path can be entered in one or all of these fields, depending on how your system is being used. If a label type is not going to be used, leave that field populated with the default of N/A.
Note:
If no label is assigned for an automated export or automated publishing job, or if the label assigned is invalid, the job is canceled and removed from Rimage. This error is written to the SYS - Automated CD Reports log file, archived in OnBase and accessible through the OnBase Client.
Four label files are provided with the OnBase installation: A back-up label file (backup.btw), an export label file (export.btw) and two statement label files (statement.btw and statement2.btw). Create a folder to store these labels. This folder can be created at any network location, but it is a best practice to use the same folder where the Client software is installed, in order to limit the locations of required files and simplify file maintenance.
You can customize any of the label files with the CD label designer software provided with the Rimage Unit, to add a company logo or other plain text, but the label will only supply the merge fields described in this section. No additional values can be merged into the label.
CAUTION:When you customize these labels, do not remove any fields that exist already on the label, and do not change the field data sources from their original specifications. It is important that any changes you make do not eliminate or alter the meanings of the supplied merge fields. They must remain with the same field number order for the labeling to function properly.
-
The backup.btw file is intended for use with disk group back-ups using Document Distribution. It contains the following predefined merge fields, in this order:
Merge Field
Description
1
Disk Group Number
2
Disk Group Name
3
Logical Volume Number
4
Copy Number
5
Produced On
6
Volume Created
7
Volume Promoted
8
Disposition Date
-
The export.btw file is intended for exporting disk group platters and requires Document Distribution and Export. It contains the following predefined merge fields, in this order:
Merge Field
Description
1
Disk Group number
2
Disk Group name
3
Logical Volume number
4
Job Date
5
Creation date and time of the exported volume
6
Promotion date and time of the exported volume
7
The Institution Name of the Institution whose default Disk Group is the Disk Group associated with the exported volume.
Note:This field is left blank if the associated Disk Group is not the default Disk Group of any Institution.
-
The statement.btw and statement2.btw files are intended for use with document distribution modules, such as Document Distribution . They contain the following predefined merge fields, in this order:
Merge Field
Description
1
Date the distribution job was sent to Rimage
2
Recipient name
3
Recipient address line 1
4
Recipient address line 2
5
Recipient address line 3
6
CD # x of y (where x is the current disc and y is the total number of discs in the distribution)
7
Account number (available in statement2.btw only)
8
Document date (available in statement2.btw only)
9
Recipient address line 4
-
- In the Rimage Server Temporary File Path field, enter the path of the temporary folder that you created when the Rimage software was installed.
- Click Save. The appropriate entries for the Rimage integration are made in the registry on the workstation.
-
In order to poll the OnBase database, the OnBase Client configured for use with Rimage must be launched under the -AUTOWRITECD switch.
This switch initiates workstation polling of the database for Document Distribution and for user requests. The polling rate is established by the OnBase user account logged on to the workstation. The Document List Refresh Rate set on the General tab of the User Options dialog box is used as the polling rate. The document refresh rate is configurable from 100 to 1,000 seconds.
Note:The service will not start if the client has been running for longer than 24 hours. In order for the service to be executed daily, the client must be restarted each day after the configured time window has elapsed.
To apply the -AUTOWRITECD switch:
- Select the icon used to launch OnBase and select Properties from the right-click menu.
- In the Target: field, type -AUTOWRITECD(prefaced by a space) at the end of the target path. Select Apply then OK to exit the dialog.