Csharp webservice dll

From OpenKM Documentation
Revision as of 12:13, 23 September 2013 by Jllort (talk | contribs) (Controlling exceptions)

Jump to: navigation, search

Nota clasica.png Dll have been compiled for net 2.0 that should ensure go with any upper .net version

Download File:OKMWebservice.zip

Available api:

  • Webservices for OpenKM Professional 6.4
  • Webservices for OpenKM Professional 6.2
  • Webservices for OpenKM Community 6.0+

Understanding the basics

For all webservices methods are available two methods one with token and other without it. For example to get granted roles of some node path can be used:

Dictionary<String, int> getGrantedRoles(String nodePath);
Dictionary<String, int> getGrantedRoles(String token, String nodePath);

First case getGrantedRoles(nodePath) internally controls login and logout actions for you and is not needed a token.

On second getGrantedRoles(token, nodePath) is necessary provide a token. That means you take control of login and logout actions in your source code.

Example

String host = "http://localhost:8080";
String user = "okmAdmin";
String password = "admin";

int serverVersion = OKMWebServiceFactory.PROFESSIONAL_6_4;
OKMWebservice webservice= null;
if (serverVersion == OKMWebServiceFactory.PROFESSIONAL_6_4)
{
	webservice= OKMWebServiceFactory.getInstance(host, user, password, OKMWebServiceFactory.PROFESSIONAL_6_4);
}
else
{
	webservice= OKMWebServiceFactory.getInstance(host, user, password, OKMWebServiceFactory.PROFESSIONAL_6_2);
}

Controlling exceptions

OKMWebservice dll will throw OKMWebserviceException if happens some error. Is good practice take control in your source code.

try {
  webservice.login();
} catch (OKMWebserviceExceptione){

}