Log files
Log Files
The PDF Processor has the ability to generate log files during its operation. By supplying the LogIdentifer parameter to the various script functions, a log file is automatically created or appended to. The LogIdentifier determines the filename of the resulting log file. Typically these would by based on the current activity or transaction, thereby creating separate log files for each event.
The log files are useful when trying to determine why a particular function might have failed. The WriteLog function provides the ability to include custom log entries to help debug script related issues.
The log files are created on the M-Files server in the following location:
C:\ProgramData\PentagonDocs Assistant\Server Logs\<Vault Name> <Vault GUID>
Each vault with the PDF Processor installed will have its own Server Logs sub folder based on the display name of the vault and its globally unique identifier (GUID).
Example Log File
Filename: {8056887D-1C6E-413C-994C-48AAB14219A3}.log
01/01/2019 09:00:00:5562 - Vault Extension Method: ExDOCS_WriteAttributes_DWG
01/01/2019 09:00:00:5862 - Checking Out...
01/01/2019 09:00:00:6482 - DWG File Count: 1
01/01/2019 09:00:00:6492 - Creating RealDWG COM Object. (dllhost.exe)
01/01/2019 09:00:01:2083 - Call SyncPropertiesFromMFiles COM method.
01/01/2019 09:00:01:3183 - Processing Object: ID 1 Version 2
01/01/2019 09:00:01:3353 - FileVer: ID 1 Version 2
01/01/2019 09:00:01:3353 - Download DWG to temp file: C:\ProgramData\PentagonDocs Assistant\DWG Processor\Temp\4yx2uhha.dwg
01/01/2019 09:00:01:3973 - Download failed: The file has not been committed yet.
01/01/2019 09:00:01:3973 - Attempting to Download previous File Version
01/01/2019 09:00:01:4093 - FileVer: ID 1 Version 1
01/01/2019 09:00:01:4093 - Download DWG to temp file: C:\ProgramData\PentagonDocs Assistant\DWG Processor\Temp\4yx2uhha.dwg
01/01/2019 09:00:01:4453 - Open DWG file
01/01/2019 09:00:01:5483 - Update attribute values of matching Titleblocks
01/01/2019 09:00:01:6333 - Save DWG file
01/01/2019 09:00:02:1063 - Upload updated DWG file
01/01/2019 09:00:02:1443 - Delete temp files from server
01/01/2019 09:00:02:1453 - Releasing COM object.
01/01/2019 09:00:02:1453 - Set Modifying User
01/01/2019 09:00:02:1783 - Checking In...
Automatic Removal of Log Files
Because the creation of log files can be based on an activity or transaction, the number of log files can quickly accumulate. The PDF Processor will automatically remove log files older than 24 hours.
This setting can be increased or decreased by changing the following registry entry:
Registry Key |
HKEY_LOCAL_MACHINE\SOFTWARE\PentagonDOCS\Server |
Value Name |
DeleteLogFilesAfterHours |
Type |
REG_DWORD |
Default |
0x00000018 (24) 24 Hours |