Difference between revisions of "Csharp forms dll"

From OpenKM Documentation
Jump to: navigation, search
(TreeForm)
(SearchForm)
Line 96: Line 96:
 
form.search.msg.min.char=At least you need to add tree characters
 
form.search.msg.min.char=At least you need to add tree characters
 
form.search.msg.empty=Search has return empty results
 
form.search.msg.empty=Search has return empty results
 +
button.cancel=Cancel
 
</source>
 
</source>
  

Revision as of 08:55, 24 September 2013


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

OKMForm DLL library has general purpose forms to help work with OpenKM.

Understanding the basics

  • TreeForm ( tree navigator across taxonomy, templates and personal folder)
  • SearchForm ( search form across taxonomy, tamplates and personal folder )
  • ConfigurationForm ( form to display OpenKM configuration parameters ).

TreeForm

TreeForm display navigator tree which can be switched between taxonomy, templates and personal context.


Okm user guide 511.png


Events:

  • Button cancel trigger treeButtonCancelled method in TreeHander.
  • Button accept trigger treeButtonAccepted method in TreeHander.

Nota clasica.png TreeForm needs DictionaryHelper for UI translatiosn take a look at Csharp_utils_dll#DictionaryHelper

Translations properties needed:

form.tree.title=Navigation tree
form.tree.context.root=Taxonomy
form.tree.context.templates=Templates
form.tree.context.personal=Personal
form.tree.contextmenu.newfolder=New folder
form.tree.contextmenu.renamefolder=Rename folder
form.tree.contextmenu.deletefolder=Delete folder
form.tree.button.accept=Sign
form.tree.input.title=Folder management
button.cancel=Cancel

Example:

public class Example : TreeHandler {
  public Example(Dictionary dictionary, OKMWebservice webservice) {
    TreeForm treeForm = new TreeForm(this, dictionary, webservice);
  }
 
  // showTree
  public void showNavigatorTree() {
    try
    {
      treeForm.setFirstTime(true);
      treeForm.ShowDialog();
    }
    catch (Exception e)
    {
      Logger.Instance.error("treeForm", e);
    }
 
  }
 
  // treeButtonCancelled
  public void treeButtonCancelled()
  {
    // something to do here
  }
 
  //treeButtonAccepted
  public void treeButtonAccepted(String fldPath, String fldUuid)
  {
    // something to do here
  }
}

SearchForm

SearchForm display search form which can be switched between taxonomy, templates and personal context.


Okm user guide 512.png


Are needed at least tree characters to be able to do a search.


Events:

  • Button cancel trigger searchButtonCancelled method in SearchHander.
  • Button accept trigger searchSelectedFolder method in SearchHander when is looking for folders.
  • Button accept trigger searchSelectedDocument method in SearchHander when is looking for document.
  • Button accept trigger searchSelectedMail method in SearchHander when is looking for mail.
  • Button accept trigger searchSelectedRecord method in SearchHander when is looking for record.



Nota clasica.png SearchForm needs DictionaryHelper for UI translatiosn take a look at Csharp_utils_dll#DictionaryHelper

Translations properties needed:

form.search.title=Search
form.search.msg.min.char=At least you need to add tree characters
form.search.msg.empty=Search has return empty results
button.cancel=Cancel

Exemple:

public class Example : SearchHandler {
  public Example(Dictionary dictionary, OKMWebservice webservice) {
    // Looking for folders
    SearchForm searchForm = new SearchForm(SearchForm.TAXONOMY_FOLDER, OKMQueryParamsBean.FOLDER, this, dictionary, webservice);
  }
 
  // show Search
  public void showSearch() {
  try
	{
	  searchForm.ShowDialog();
	}
	catch (Exception ex)
	{
	  Logger.Instance.error("treeForm", e);
	}
  }
 
    // searchButtonCancelled
  public void searchButtonCancelled()
  {
    // Something to do here
  }
 
  // searchSelectedFolder
  public void searchSelectedFolder(String nodePath, String nodeUuid)
  {
	// Something to do here
  }
 
  // searchSelectedDocument
  public void searchSelectedDocument(String nodePath, String nodeUuid)
  {
    // Something to do here
  }
 
  // searchSelectedMail
  public void searchSelectedMail(String nodePath, String nodeUuid)
  {
    // Something to do here
  }
 
  // searchSelectedRecord
  public void searchSelectedRecord(String nodePath, String nodeUuid)
  {
    // Something to do here
  }
}

ConfigurationForm

ConfigurationForm display OpenKM configuration parameters.


Okm user guide 513.png


Events:

  • Button cancel trigger configurationButtonCancelled method in ConfigurationHander.
  • Button accept trigger configurationButtonAcceptedmethod in ConfigurationHander.


Translations properties needed:

form.configuration.name=Configuration
form.configuration.language=Language
form.configuration.version=OpenKM Version
form.configuration.userName=User
form.configuration.password=Password
form.configuration.host=Host
form.configuration.error.msg=Field {0} can not be empty
button.accept=Accept
button.cancel=Cancel


public class Example : SearchHandler {
  public Example(Dictionary dictionary, OKMWebservice webservice) {
    Dictionary<String, String> languages = new Dictionary<string,string>();
    languages.Add("enGB", "English");
    languages.Add("esES", "Spanish");
    Dictionary<int, String> versions = new Dictionary<int,string>();
    versions.Add(OKMWebServiceFactory.PROFESSIONAL_6_4, "6.4");
    versions.Add(OKMWebServiceFactory.PROFESSIONAL_6_2, "6.2");
    ConfigBean configBean = new ConfigBean();
    configBean.Host = "http://localhost:8080/OpenKM";
    configBean.User = "okmAdmin";
    configBean.Password = "admin";
    configBean.Version = OKMWebServiceFactory.PROFESSIONAL_6_2;
    configBean.Language = "enGB";
    configurationForm = new ConfigurationForm(this, dictionary, Program.okmWebservice, configBean, languages, versions);
  }
 
  // show configuration
  public void showConfiguration() {
    try
    {
      configurationForm.ShowDialog();
    }
    catch (Exception ex)
    {
      Logger.Instance.error("configuration", ex);
    }
  }
 
  // configurationButtonCancelled
  public void configurationButtonCancelled()
  {
    // Something to do here
  }

  // configurationButtonAccepted
  public void configurationButtonAccepted(ConfigBean configBean)
  {
    // Something to do here
  }
}