Folder samples
Basics
On most methods you'll see parameter named "fldId". The value of this parameter can be some valid folder UUID or path.
Example of fldId:
- Using UUID -> "f123a950-0329-4d62-8328-0ff500fd42db";
 - Using path -> "/okm:root/test"
 
Methods
createFolder
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 createFolder(Folder fld)  | 
 Folder  | 
 Creates a new folder and return as a result an object Folder.  | 
| 
 The variable path into the parameter fld, must be initializated. It indicates the folder path into OpenKM. 
The other variables of Folder ( fld ) will not take any effect on folder creation. We suggest use the method below createFolderSimple rather this one.  | 
||
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
using com.openkm.sdk4csharp.bean;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                Folder fld = new Folder();
                fld.path ="/okm:root/test";
                ws.createFolder(fld);
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}
createFolderSimple
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 createFolderSimple(String fldPath)  | 
 Folder  | 
 Creates a new folder and returns as a result an object Folder.  | 
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
using com.openkm.sdk4csharp.bean;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                ws.createFolderSimple("/okm:root/test");
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            }
        }
    }
}
getFolderProperties
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 getFolderProperties(String fldId)  | 
 Folder  | 
 Returns the folder properties.  | 
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
using com.openkm.sdk4csharp.bean;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                System.Console.WriteLine(ws.getFolderProperties("/okm:root/test"));
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            }
        }
    }
}
deleteFolder
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 deleteFolder(String fldId)  | 
 void  | 
 Delete a folder.  | 
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                ws.deleteFolder("/okm:root/test");
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}
renameFolder
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 renameFolder(String fldId, String newName)  | 
Folder | 
 Renames a folder.  | 
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
using com.openkm.sdk4csharp.bean;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                // Exists folder /okm:root/test
                ws.renameFolder("/okm:root/test", "renamedFolder");
                // Folder has renamed to /okm:root/renamedFolder
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}
moveFolder
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 moveFolder(String fldId, String dstId)  | 
 void  | 
 Moves a folder into some folder or record.  | 
| The values of the dstId parameter should be a folder or record UUID or path. | ||
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                // Exists folder /okm:root/test
                ws.moveFolder("/okm:root/test", "/okm:root/tmp");
                // Folder has moved to /okm:root/tmp/test
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}
getFolderChildren
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 getFolderChildren(String fldId)  | 
 List<Folder>  | 
 Returns a list of all folder which their parent is fldId.  | 
| The parameter fldId can be a folder or a record node. | ||
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
using com.openkm.sdk4csharp.bean;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                foreach (Folder fld in ws.getFolderChildren("/okm:root"))
                {
                    System.Console.WriteLine(fld);
                }
            }
            catch (Exception e)
            {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}
isValidFolder
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 isValidFolder(String fldId)  | 
 Boolean  | 
 Returns a boolean that indicate if the node is a folder or not.  | 
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                // Return false
                ws.isValidFolder("/okm:root/logo.png");
                // Return true
                ws.isValidFolder("/okm:root");
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}
getFolderPath
Description:
| Method | Return values | Description | 
|---|---|---|
| 
 getFolderPath(String uuid)  | 
 String  | 
 Converts a folder UUID to folder path.  | 
Example:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using com.openkm.sdk4csharp;
namespace OKMRest
{
    public class Program
    {
        static void Main(string[] args)
        {
            String host = "http://localhost:8080/OpenKM";
            String username = "okmAdmin";
            String password = "admin";
            OKMWebservice ws = OKMWebservicesFactory.newInstance(host, username, password);
            
            try
            {
                System.Console.WriteLine(ws.getFolderPath("f123a950-0329-4d62-8328-0ff500fd42db"));
            } catch (Exception e) {
                System.Console.WriteLine(e.ToString());
            } 
        }
    }
}