Difference between revisions of "Direct link"
From OpenKM Documentation
Line 1: | Line 1: | ||
− | Direct link need a '''user''' which have login grants. A good practice is configure the profile of this user to disallow anything | + | You can download a document from OpenKM using a command line utility like '''wget'''. Since OpenKM 6.2.1 Community and OpenKM 6.2.5 Professional there is a service with BASIC authentication for this task. |
+ | Direct link need a '''user''' which have login grants. A good practice is configure the profile of this user to disallow anything. | ||
Available parameters: | Available parameters: | ||
Line 6: | Line 7: | ||
Example | Example | ||
− | http://'''user''':''' | + | http://'''user''':'''password'''@openkm_host/OpenKM/Download?'''uuid'''=4ca63b87-e340-443e-aeef-6c7e2fb57aea |
− | http://'''user''':''' | + | http://'''user''':'''password'''@openkm_host/OpenKM/Download?'''path'''=/okm:root/test/test.doc |
+ | |||
+ | This ease some integration tasks: | ||
+ | |||
+ | $ wget http://okmAdmin:admin@localhost:8080/OpenKM/Download?uuid=xxx-yyy-zzz | ||
+ | |||
+ | You can reference a document by UUID using the '''uuid''' parameter or by path, using the '''path''' parameter. In the same URL you need to specify the user and password. | ||
+ | |||
+ | [[Category: Utilities]] | ||
{{Note|If you use path parameter, ia good practice encode url to prevent problems with special characters}} | {{Note|If you use path parameter, ia good practice encode url to prevent problems with special characters}} |
Revision as of 14:16, 21 November 2012
You can download a document from OpenKM using a command line utility like wget. Since OpenKM 6.2.1 Community and OpenKM 6.2.5 Professional there is a service with BASIC authentication for this task. Direct link need a user which have login grants. A good practice is configure the profile of this user to disallow anything.
Available parameters:
- uuid ( the document UUID )
- path ( the document path )
Example
http://user:password@openkm_host/OpenKM/Download?uuid=4ca63b87-e340-443e-aeef-6c7e2fb57aea http://user:password@openkm_host/OpenKM/Download?path=/okm:root/test/test.doc
This ease some integration tasks:
$ wget http://okmAdmin:admin@localhost:8080/OpenKM/Download?uuid=xxx-yyy-zzz
You can reference a document by UUID using the uuid parameter or by path, using the path parameter. In the same URL you need to specify the user and password.
![]() |
If you use path parameter, ia good practice encode url to prevent problems with special characters |