Python client - OpenKM 5.1

From OpenKM Documentation
Revision as of 09:17, 6 March 2012 by Pavila (talk | contribs)

Jump to: navigation, search

These sample code is using the SOAPpy library. If you are in a Debian based distro you can install it this way:

$ sudo aptitude install python-soappy

More info about Python and webservices at:

Remote method info

from SOAPpy import WSDL

# Register WSDL
sAuth = WSDL.Proxy('http://localhost:8080/OpenKM/OKMAuth?wsdl')

print sAuth.methods.keys()
print sAuth.soapproxy

callInfo = sAuth.methods['login']

print callInfo.inparams[0].name
print callInfo.inparams[0].type

print callInfo.inparams[1].name
print callInfo.inparams[1].type

Authentication

from SOAPpy import WSDL

# Register WSDL
sAuth = WSDL.Proxy('http://localhost:8080/OpenKM/OKMAuth?wsdl')

# Login
token = sAuth.login(user='okmAdmin', password='admin')
print 'Token: '+token

# Logout
sAuth.logout(token=token)

Create document

from SOAPpy import WSDL
 
# Register WSDL
sAuth = WSDL.Proxy('http://localhost:8080/OpenKM/OKMAuth?wsdl')
sDocument = WSDL.Proxy('http://localhost:8080/OpenKM/OKMDocument?wsdl')
 
# Login
token = sAuth.login(user='okmAdmin', password='admin')
print 'Token: '+token
 
# Create document
newDoc = sDocument.create(token=token, doc={'path':'/okm:root/hosts_1.txt', 'mimeType': None,
    'actualVersion': None, 'author': None, 'checkedOut': False,
    'created': None, 'language': None,
    'lastModified': None, 'lockInfo': None, 'locked': False,
    'permissions': 0, 'size': 0, 'subscribed': False, 'uuid': None,
    'convertibleToPdf': False, 'convertibleToSwf': False,
    'compactable': False, 'training': False}, content='Hello, world!')
print newDoc 
 
# Logout
sAuth.logout(token=token)

Perform search

from SOAPpy import WSDL

# Register WSDL
sAuth = WSDL.Proxy('http://localhost:8080/OpenKM/OKMAuth?wsdl')
sSearch = WSDL.Proxy('http://localhost:8080/OpenKM/OKMSearch?wsdl')

# Login
token = sAuth.login(arg0='okmAdmin', arg1='admin')
print 'Token: '+token

# Search
queryResultArray = sSearch.findByContent(arg0=token, arg1='grial')

# Starting with OpenKM 5.0 should be queryResultArray['item']
for queryResult in queryResultArray['value']:
  print queryResult['document']['path']

# Logout
sAuth.logout(arg0=token)

Search using find()

from SOAPpy import WSDL
 
# Register WSDL (note you may need to change the port if you have modified it to not use 8080)
sAuth = WSDL.Proxy('http://localhost:8080/OpenKM/OKMAuth?wsdl')
sSearch = WSDL.Proxy('http://localhost:8080/OpenKM/OKMSearch?wsdl')
 
# Login
token = sAuth.login(user='okmAdmin', password='admin')
print 'Token: '+token
 
# Search
queryResultArray = sSearch.find(token=token, params='Hello')
 
# Starting with OpenKM 5.0 should be queryResultArray['item']
for results in queryResultArray:
    for result in results:
        print 'uuid: ' + result['document']['uuid']
        print 'mimeType: ' + result['document']['mimeType']
        print 'path: ' + result['document']['path']
        print 'author: ' + result['document']['author']
        print 'created: ' + result['document']['created']
 
# Logout
sAuth.logout(token=token)

Download document

#!/usr/bin/python
# -*- coding: utf-8 -*-

import warnings, base64
warnings.simplefilter('ignore', DeprecationWarning)

from SOAPpy import WSDL
 
# Register WSDL
sAuth = WSDL.Proxy('http://localhost:8080/OpenKM/OKMAuth?wsdl')
sDocument = WSDL.Proxy('http://localhost:8080/OpenKM/OKMDocument?wsdl')
 
# Login
token = sAuth.login(user='okmAdmin', password='admin')
print 'Token: '+token

docPath = u'/okm:root/path/to/document.pdf'
content = sDocument.getContent(token=token, docPath=docPath, checkout=False);
file = open('document.pdf', 'wb');
file.write(base64.decodestring(content));
file.close();

# Logout
sAuth.logout(token=token)