The program allows exporting originals files of selected document info records.
Example of usage:
After a system copy the program can be used to export template originals, which can then be restored on the test system (see Import Originals) or for periodic extracts of Q-documents for publication on the intranet.
Documents can be additionally filtered with customer exits. Also name changes and client specific actions are possible.
Selection Screen
Parameter | Description |
|---|---|
Document type | Search restriction by document type |
Document | Search restriction by document number |
Part document | Search restriction by part document |
Version | Search restriction by document version |
Status | Search restriction by document status |
User | Search restriction by user |
Change No. | Search restriction by change number |
Laboratory / Office | Search restriction by laboratory / office |
Application | Only originals with this application will be exported. |
KPro storage location | For document types with storage system „KPro" only originals from storage system „KPro" will be exported. |
Vault storage location | For document types with storage system „vault" only originals with storage location „ vault" will be exported. |
Max. number of originals | Only as much originals as entered will be exported. (Option for test purpose). |
Extended Search | Starts extended search, for details see Extended Search. |
Selection list before export | Selection list of originals which will be exported will be displayed before processing. Function not available for background processing (batch mode). |
Test mode | Only selection and display of originals which shall be exported. |
Export to directory on server | If set, the originals will be written on the server. For batch processing the originals will always be written on the server. |
File name | Controls the writing pattern for file name:
|
Export directory | Directory on work station or server (acc. „Export to server directory) to which the originals shall be exported. |
Job-ID | Job-ID for execution of process (see Mass Operations Document Info Records). |
Optional log file | Name of an optional log file. |
Orig.export w/o stamp | Depending on the system configurations the originals are stamped during their exportation. Set this flag to supressed the stamping. |
If the report is processed in the background, no selection list for further restrictions will be generated.
File Name Format
By default the following file format will be used:
[Dokumentart][DokumentNr][Teildokument][Version][Applikation]#[DateiNr].[Extension]
[document type][document number][part document][version][application]#[file no.].[extension]
A customizing exit will allow other name conventions.
Handling of Special Characters
Special characters in a document number will automatically be replaced. The customizing offers 2 different methods which perform different replacement routines. While importing the files, the system checks the filenames for those escape characters and starts the inverted replacement function if one of those characters are found.
If the filename contains the escape characters for both methods, the classic method „replacement with ASCII code" will be performed. This is necessary to ensure the backward compatibility of the function with older product versions as well as with older extracts of originals.
Classic method: Replacement with ASCII Code
This method uses one escape character. While exporting the original file, the escape character is written first, followed by the ASCII Code of the special character in the hexadecimal format.
Example:
Document type | ZNG |
Part document | 000 |
Version | 00 |
Document number | A:123-H7A\1 |
Application | |
File No | 2 |
Possible file name | ZNG_A~3A123-H7A~5C1_000_00_PDF#2.pdf (~3A stands for : and ~5C for \ ) |
New method: Replacement with Unicode Codes
This method also uses an escape character. But in difference to the classic method, a closing escape character is used as well since the amount of replacement characters for each special character can vary (This is due to the definition of Unicode Codes). In the export process the escape character is written first, followed by the Unicode-Code of the special character in numerical format. Finally the closing escape character is added. The two escape characters cannot be set in the customizing, in contrast to the classic method, but are fixed characters: { and }.
Document type | ZNG |
Part document | 000 |
Version | 00 |
Document number | A:123-H7A\1 |
Application | |
File No | 2 |
Possible file name | ZNG_A{58}123-H7A{92}1_000_00_PDF#2.pdf ({58} stands for : and {92} for \ ) |