Document samples
Basics
On most methods you'll see parameter named "docId". The value of this parameter can be a valid document UUID or path.
Example of docId:
- Using UUID -> "68a27519-c9cc-4490-b281-19ff9f19318b";
- Using path -> "/okm:root/SDK4PHP/logo.png"
Methods
createDocumentSimple
Description:
Method | Return values | Description |
---|---|---|
createDocumentSimple($docPath, $content) |
Document |
Creates a new document and return as a result an object Document with the properties of the created document. |
Parameters: $content string type is recommend using file_get_contents — Reads entire file into a string |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testCreateDocumentSimple() {
try {
$fileName = dirname(__FILE__) . '/files/logo.png';
$docPath = '/okm:root/SDK4PHP/logo.png';
$document = $this->ws->createDocumentSimple($docPath, file_get_contents($fileName));
var_dump($document);
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testCreateDocumentSimple();
?>
deleteDocument
Description:
Method | Return values | Description |
---|---|---|
deleteDocument($docId) |
void |
Deletes a document. |
Parameters: When a document is deleted it is automatically moved to /okm:trash/userId folder. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testDeleteDocument(){
try {
$this->ws->deleteDocument('/okm:root/SDK4PHP/logo.png');
echo 'deleted';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testDeleteDocument();
?>
getDocumentProperties
Description:
Method | Return values | Description |
---|---|---|
getDocumentProperties($docId) |
Document |
Returns the document properties. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetDocumentProperties() {
try {
$document = $this->ws->getDocumentProperties('/okm:root/SDK4PHP/logo.png');
var_dump($document);
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetDocumentProperties();
?>
getContent
Description:
Method | Return values | Description |
---|---|---|
getContent($docId) |
string |
Retrieves a document content - binary data - of the actual document version. |
Parameters: $docId string type is the uuid or path of the Document |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetContent($method) {
$content = $this->ws->getContent('/okm:root/SDK4PHP/logo.png');
switch ($method) {
case 1:
$file = fopen(dirname(__FILE__) . '/files/logo_download.png', 'w+');
fwrite($file, $content);
fclose($file);
echo 'download correct';
break;
case 2:
$document = $this->ws->getDocumentProperties('/okm:root/SDK4PHP/logo.png');
header('Expires', 'Sat, 6 May 1971 12:00:00 GMT');
header('Cache-Control', 'max-age=0, must-revalidate');
header('Cache-Control', 'post-check=0, pre-check=0');
header('Pragma', 'no-cache');
header('Content-Type: ' . $document->getMimeType());
header('Content-Disposition: attachment; filename="' . substr($document->getPath(), strrpos($document->getPath(), '/') + 1) . '"');
echo $content;
break;
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetContent(2);
?>
getContentByVersion
Description:
Method | Return values | Description |
---|---|---|
getContentByVersion($docId, $versionId) |
string |
Retrieves a document content ( binary data ) of an specific document version. |
Parameters: $versionId string type is the uuid or path of the Document |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetContentByVersion($method) {
$content = $this->ws->getContentByVersion('/okm:root/SDK4PHP/logo.png',1.1);
switch ($method) {
case 1:
$file = fopen(dirname(__FILE__) . '/files/logo_download_version.png', 'w+');
fwrite($file, $content);
fclose($file);
echo 'download correct';
break;
case 2:
$document = $this->ws->getDocumentProperties('/okm:root/SDK4PHP/logo.png');
header('Expires', 'Sat, 6 May 1971 12:00:00 GMT');
header('Cache-Control', 'max-age=0, must-revalidate');
header('Cache-Control', 'post-check=0, pre-check=0');
header('Pragma', 'no-cache');
header('Content-Type: ' . $document->getMimeType());
header('Content-Disposition: attachment; filename="' . substr($document->getPath(), strrpos($document->getPath(), '/') + 1) . '"');
echo $content;
break;
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetContentByVersion(1);
?>
getDocumentChildren
Description:
Method | Return values | Description |
---|---|---|
getDocumentChildren($fldId) |
array |
Returns a list of all documents which their parent is fldId. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetDocumentChildren(){
try {
$documents = $this->ws->getDocumentChildren('/okm:root');
foreach ($documents as $document) {
var_dump($document);
}
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetDocumentChildren();
?>
renameDocument
Description:
Method | Return values | Description |
---|---|---|
renameDocument($docId, $newName) |
Document |
Changes the name of a document and returns the Document |
Parameters: $newName string type is the new name for the Document |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testRenameDocument() {
try {
$document = $this->ws->renameDocument('604e17e8-3285-4e8a-910c-c99ee4e44262', 'logo_rename.png');
var_dump($document);
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testRenameDocument();
?>
setProperties
Description:
Method | Return values | Description |
---|---|---|
setProperties(Document $doc) |
void |
Changes a document properties. |
Variables allowed to be changed:
The parameter Language must be ISO 691-1 compliant. More information at https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes. Only not null and not empty variables will be take on consideration. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testSetProperties(){
try {
$document = $this->ws->getDocumentProperties('604e17e8-3285-4e8a-910c-c99ee4e44262');
$document->setTitle('Logo');
$document->setDescription('some description');
$document->setLanguage('es');
//Keywords
$keywords = array();
$keywords[] = 'test';
$document->setKeywords($keywords);
//Categories
$categories = array();
$category = $this->ws->getFolderProperties('/okm:categories/test');
$categories[] = $category;
$document->setCategories($categories);
$this->ws->setProperties($document);
echo 'updated';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testSetProperties();
?>
createFromTemplate
checkout
Description:
Method | Return values | Description |
---|---|---|
checkout($docId) |
void |
Marks the document for edition. |
Parameters: Only one user can modify a document at same time. Before starting edition you must do a checkout action that lock the edition process for other users and allows only to the user who has executed the action. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testCheckout() {
try {
$this->ws->checkout('/okm:root/SDK4PHP/logo.png');
// At this point the document is locked for other users except for the user who executed the action
echo 'correct';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testCheckout();
?>
cancelCheckout
Description:
Method | Return values | Description |
---|---|---|
cancelCheckout($docId) |
void |
Cancels a document edition. |
Parameters: $docId string type is the uuid or path of the Document This action can only be done by the user who previously executed the checkout action. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testCancelCheckout() {
try {
// At this point the document is locked for other users except for the user who executed the action
$this->ws->cancelCheckout('/okm:root/SDK4PHP/logo.png');
// At this point other users are allowed to execute a checkout and modify the document
echo 'correct';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testCancelCheckout();
?>
forceCancelCheckout
Description:
Method | Return values | Description |
---|---|---|
forceCancelCheckout($docId) |
void |
Cancels a document edition. |
Parameters: This method allows to cancel the edition of any document. It is not mandatory to execute this action by the same user who previously executed the checkout action. This action can only be done by a super user ( user with ROLE_ADMIN ). |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testForceCancelCheckout() {
try {
// At this point the document is locked for other users except for the user who executed the action
$this->ws->forceCancelCheckout('/okm:root/SDK4PHP/logo.png');
// At this point other users are allowed to execute a checkout and modify the document
echo 'correct';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testForceCancelCheckout();
?>
isCheckedOut
Description:
Method | Return values | Description |
---|---|---|
isCheckedOut($docId) |
bool |
Returns a boolean that indicate if the document is on edition or not. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testIsCheckedOut() {
try {
echo "Is the document checkout:" . $this->ws->isCheckedOut('/okm:root/SDK4PHP/logo.png');
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testIsCheckedOut();
?>
checkin
Description:
Method | Return values | Description |
---|---|---|
checkin($docId, $content, $comment) |
Version |
Updates a document with a new version and returns an object with new Version values. |
Parameters: $content string type is recommend using file_get_contents — Reads entire file into a string $comment string type is the comment for the new version the document Only the user who started the edition - checkout - is allowed to update the document. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testCheckin() {
try {
$fileName = dirname(__FILE__) . '/files/logo.png';
$version = $this->ws->checkin('/okm:root/SDK4PHP/logo.png', file_get_contents($fileName),"optional some comment");
var_dump($version);
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testCheckin();
?>
getVersionHistory
Description:
Method | Return values | Description |
---|---|---|
getVersionHistory($docId) |
array |
Returns a list of all document versions. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
//ini_set('display_errors', true);
//error_reporting(E_ALL);
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetVersionHistory() {
try {
$versions = $this->ws->getVersionHistory('/okm:root/SDK4PHP/logo.png');
foreach ($versions as $version) {
var_dump($version);
}
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetVersionHistory();
?>
lock
Description:
Method | Return values | Description |
---|---|---|
lock($docId) |
LockInfo |
Locks a document and returns an object with the Lock information. |
Parameters: $docId string type is the uuid or path of the Document Only the user who locked the document is allowed to unlock. A locked document can not be modified by other users. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testLock() {
try {
$lockInfo = $this->ws->lock('/okm:root/SDK4PHP/logo.png');
var_dump($lockInfo);
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testLock();
?>
unlock
Description:
Method | Return values | Description |
---|---|---|
unlock($docId) |
void |
Unlocks a locked document. |
Parameters: $docId string type is the uuid or path of the Document Only the user who locked the document is allowed to unlock. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testUnlock() {
try {
$this->ws->unlock('/okm:root/SDK4PHP/logo.png');
echo 'unlock';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testUnlock();
?>
forceUnlock
Description:
Method | Return values | Description |
---|---|---|
forceUnlock($docId) |
void |
Unlocks a locked document. |
Parameters: This method allows to unlcok any locked document. It is not mandatory to execute this action by the same user who previously executed the checkout lock action. This action can only be done by a super user ( user with ROLE_ADMIN ). |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testForceUnlock() {
try {
$this->ws->forceUnlock('/okm:root/SDK4PHP/logo.png');
echo 'forceUnlock';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testForceUnlock();
?>
isLocked
Description:
Method | Return values | Description |
---|---|---|
isLocked($docId) |
bool |
Returns a boolean that indicates if the document is locked or not. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testIsLocked() {
try {
echo "Is document locked:" . $this->ws->isLocked('/okm:root/SDK4PHP/logo.png');
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testIsLocked();
?>
getLockInfo
Description:
Method | Return values | Description |
---|---|---|
getLockInfo($docId) |
LockInfo |
Return an object with the Lock information |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetLockInfo() {
try {
var_dump($this->ws->getLockInfo('/okm:root/SDK4PHP/logo.png'));
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetLockInfo();
?>
purgeDocument
Description:
Method | Return values | Description |
---|---|---|
purgeDocument($docId) |
void |
Document is definitely removed from repository. |
Parameters: Usually you will purge documents into /okm:trash/userId - the personal trash user locations - but is possible to directly purge any document from the whole repository. When a document is purged only will be able to be restored from a previously repository backup. The purge action removes the document definitely from the repository. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testPurgeDocument() {
try {
$this->ws->purgeDocument('/okm:root/SDK4PHP/logo.png');
echo 'purgeDocument';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testPurgeDocument();
?>
moveDocument
Description:
Method | Return values | Description |
---|---|---|
moveDocument($docId, $dstId) |
void |
Moves a document into some folder or record. |
Parameters: $dstId string type is the uuid or path of the Folder or Record |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testMoveDocument() {
try {
$this->ws->moveDocument('/okm:root/SDK4PHP/logo.png','/okm:root/SDK4PHP/tmp');
echo 'moveDocument';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testMoveDocument();
?>
copyDocument
Description:
Method | Return values | Description |
---|---|---|
copyDocument($docId, $dstId) |
void |
Copies a document into a folder or record. |
Parameters: $dstId string type is the uuid or path of the Folder or Record |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testCopyDocument() {
try {
$this->ws->copyDocument('/okm:root/SDK4PHP/logo.png','/okm:root/SDK4PHP/tmp');
echo 'copyDocument';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testCopyDocument();
?>
restoreVersion
Description:
Method | Return values | Description |
---|---|---|
restoreVersion($docId, $versionId) |
void |
Promotes previous document version to actual version. |
Parameters: $versionId string type is the version of the Document |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testRestoreVersion() {
try {
$this->ws->restoreVersion('/okm:root/SDK4PHP/logo.png','1.1');
echo 'restoreVersion';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testRestoreVersion();
?>
purgeVersionHistory
Description:
Method | Return values | Description |
---|---|---|
purgeVersionHistory($docId) |
void |
Purges all documents version except the actual version. |
Parameters: This action compact the version history of a document. This action can not be reverted. |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testPurgeVersionHistory() {
try {
// Version history has version 1.3,1.2,1.1 and 1.0
$this->ws->purgeVersionHistory('/okm:root/SDK4PHP/logo.png');
// Version history has only version 1.3
echo 'purgeVersionHistory';
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testPurgeVersionHistory();
?>
getVersionHistorySize
Description:
Method | Return values | Description |
---|---|---|
getVersionHistorySize($docId) |
int |
Returns the sum in bytes of all documents into documents history. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetVersionHistorySize() {
try {
$units = array("B", "KB", "MB", "GB", "TB", "PB", "EB");
$bytes = $this->ws->getVersionHistorySize('/okm:root/SDK4PHP/logo.png');
$value = "";
for ($i = 6; $i > 0; $i--) {
$step = pow(1024, $i);
if ($bytes > $step) {
$value = number_format($bytes / $step, 2) . ' ' . $units[$i];
}
if (empty($value)) {
$value = $bytes . ' ' . $units[0];
}
}
echo $value;
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetVersionHistorySize();
?>
isValidDocument
Description:
Method | Return values | Description |
---|---|---|
isValidDocument($docId) |
bool |
Returns a boolean that indicates if the node is a document or not. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testIsValidDocument() {
try {
// Return true
var_dump($this->ws->isValidDocument("/okm:root/SDK4PHP/logo.png"));
// Return false
var_dump($this->ws->isValidDocument('/okm:root'));
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testIsValidDocument();
?>
getDocumentPath
Description:
Method | Return values | Description |
---|---|---|
getDocumentPath($uuid) |
string |
Convert document UUID to document path. |
Parameters: |
Example:
<?php
include '../src/openkm/OpenKM.php';
use openkm\OKMWebServicesFactory;
use openkm\OpenKM;
class ExampleDocument {
const HOST = "http://localhost:8080/OpenKM/";
const USER = "okmAdmin";
const PASSWORD = "admin";
private $ws;
public function __construct() {
$this->ws = OKMWebServicesFactory::build(self::HOST, self::USER, self::PASSWORD);
}
public function testGetDocumentPath() {
try {
var_dump($this->ws->getDocumentPath("8b559709-3c90-4c26-b181-5192a17362b2"));
} catch (Exception $e) {
var_dump($e);
}
}
}
$openkm = new OpenKM(); //autoload
$exampleDocument = new ExampleDocument();
$exampleDocument->testGetDocumentPath();
?>