User guide v4.x
Printer Tool allows users to print documents in PDF format and upload them to OpenKM.
Configuration
- Go to the notification area of the Windows taskbar.
- Right-click the OKMPrinter icon.
- Go to the "Configuration" option.
First, you must choose the Configuration menu item to set your configuration values:
| Property | Type | Description |
|---|---|---|
|
Language |
Select |
User interface language. |
|
User |
String |
User ID for accessing OpenKM. user1 |
|
Password |
String |
The password of the user. pass1 |
|
Host |
String |
OpenKM URL. http://localhost:8080/openkm/ |
|
Request path to upload |
Bool |
When it is enabled, the user will be asked if they want to change the default destination path. |
|
Default path to upload |
String |
Set the default destination path. This option is enabled when the "Request path to upload" option is disabled. |
|
Use personal token |
Bool |
The authentication will be done with the access token. |
| Personal token | String |
The personal access token. okmpat-Ky1t16O2Rwx4ttPmOK0R |
After you set your configuration values, a folder called OpenKM is created in your user My Documents folder. In this OpenKM folder, there is a configuration file named openkm.xml
Alternative configuration of the main file folder
To configure a custom path for storing key application files such as:
- The log file (openkm.log)
- The configuration file (openkm.xml)
- Temporary files generated during runtime
This configuration is done using the okm.folder.path property, located in the app.properties file within the installation directory.
Example:
okm.folder.path=C:\\New_folder_path
When to Use This Configuration:
This option is especially useful when there are issues using the default file paths, such as:
-
Insufficient file system permissions
-
Limited disk space or access restrictions in the default location
-
Need to separate system files from configuration and data
-
IT infrastructure policies or organization requirements
After making the changes, you must restart the app.
Print and upload
- Open a document from any application.
- Print the document.
- Choose "OKMPrinter" as the destination printer.
- The application will show a message "The document has been successfully uploaded" to indicate the process is finished.
The uploaded document will be saved with the pattern: "OKMPrinter_YearMonthDay_Hour.pdf".
