Difference between revisions of "Javascript API"

From OpenKM Documentation
Jump to: navigation, search
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
There're several UI javascript function public exposed. In some OpenKM customization cases is interesting accessing some public UI javascript functions ( take a look at this video [[http://www.openkm.com/es/openkm-extensibilidad.html tab embeded web application]].
+
{{TOCright}} __TOC__
 +
 
 +
There're several UI javascript function public exposed. In some OpenKM customization cases is interesting accessing some public UI javascript functions ( take a look at this video [http://www.openkm.com/es/openkm-extensibilidad.html tab embedded web application] ).
  
 
== General Functions ==
 
== General Functions ==
Line 6: Line 8:
 
* jsOpenUserTaskInstance(String) - Open dashboard workflow view with user taskinstance, where String is the taskinstance.
 
* jsOpenUserTaskInstance(String) - Open dashboard workflow view with user taskinstance, where String is the taskinstance.
 
* jsOpenPath(String, String) - Open some path in OpenKM UI. First String is folder path, second string is document path.
 
* jsOpenPath(String, String) - Open some path in OpenKM UI. First String is folder path, second string is document path.
−
* jsopenPathByUuid(String) - Open some path in OpenKM UI where String indicates uuid.
+
* jsOpenPathByUuid(String) - Open some path in OpenKM UI where String indicates uuid.
 
* jsRefreshFolder() - Refresh ui, same as toolbar refresh button  
 
* jsRefreshFolder() - Refresh ui, same as toolbar refresh button  
 
* jsWizard(String, String) - Call wizard where first String is docPath and second String is json to string serialization of GWTFileUploadResponse bean.
 
* jsWizard(String, String) - Call wizard where first String is docPath and second String is json to string serialization of GWTFileUploadResponse bean.
Line 14: Line 16:
 
* openPathByUuid(String) - Open some path in OpenKM UI where String indicates uuid. ( deprecated from openkm 6.x ).
 
* openPathByUuid(String) - Open some path in OpenKM UI where String indicates uuid. ( deprecated from openkm 6.x ).
 
* refreshFolder() - Refresh ui, same as toolbar refresh button ( deprecated from openkm 6.x ).
 
* refreshFolder() - Refresh ui, same as toolbar refresh button ( deprecated from openkm 6.x ).
 +
* jsOpenUserTaskInstance(taskInstanceId) - Open workflow with taskInstanceId
 +
* jsCancelCheckout() - Cancel selected document checkout.
 +
* jsGetActualPath() - Return actual path of selected tree node in navigator ( desktop view ).
 +
* jsGetActualNodePath() - Return actual selected node path ( navigator or file brower ).
 +
* jsGetActualNodeUUID() - Return actual selected node uuid ( navigator or file brower ).
 +
* jsGetUser() - Return GWTUser object serialized to JSON.
  
 
== Specific Cryptography Functions ==
 
== Specific Cryptography Functions ==
Line 24: Line 32:
 
* destroyScannerApplet() - Indicates should be cleaned the scanner applet
 
* destroyScannerApplet() - Indicates should be cleaned the scanner applet
 
* destroyUploaderApplet() - Indicates should be cleaned the uploader applet
 
* destroyUploaderApplet() - Indicates should be cleaned the uploader applet
 +
 +
== Specific HTMLEditor Functions ==
 +
* jsSearchDocumentHTMLEditorPopup - Open search document popup
 +
* jsSearchFolderHTMLEditorPopup - Open search folder popup
 +
 +
== specific Wiki Functions ==
 +
* jsOpenWikiPage(String) - Open wiki page with some title
 +
* openWikiPage(String - Open wiki page with some title ( deprecated from openkm 6.x ).
  
 
== How expose GWT public methods to JS ==  
 
== How expose GWT public methods to JS ==  
 +
Example 1- how to expose '''static method''' called '''i18n''' to public js as jsI18n
 +
<source lang="java">
 +
/**
 +
* initJavaScriptApi
 +
*/
 +
native void initJavaScriptApi() /*-{
 +
$wnd.jsI18n = function(s) {
 +
return @com.openkm.frontend.client.Main::i18n(Ljava/lang/String;)(s);
 +
};
 +
}-*/;
 +
</source>
 +
 +
Example 2- How to expose '''non static method''' from class Toolbar.java to public js as jsRefreshFolder.
 +
 +
After Toolbar.java has been created can be called the initJavaScriptApi:
 +
<source lang="java">
 +
ToolBar toolBar = new ToolBar();
 +
mainPanel.topPanel.toolBar.initJavaScriptApi(mainPanel.topPanel.toolBar);
 +
</source>
  
−
Example how to expose internall methow i18n to public js as jsI18n
+
Toolbar.java code:
 
<source lang="java">
 
<source lang="java">
 
/**
 
/**
−
* initJavaScriptApi
+
* initJavaScriptApi
−
*/
+
*/
−
native void initJavaScriptApi() /*-{
+
 
−
$wnd.jsI18n = function(s) {
+
public native void initJavaScriptApi(ToolBar toolBar) /*-{
−
return @com.openkm.frontend.client.Main::i18n(Ljava/lang/String;)(s);
+
$wnd.jsRefreshFolder = toolBar.@com.openkm.frontend.client.widget.toolbar.ToolBar::executeRefresh();
−
};
+
}-*/;
−
}-*/;
 
 
</source>
 
</source>
−
 
  
 
For more information take a look at [[https://developers.google.com/web-toolkit/doc/latest/DevGuideCodingBasicsJSNI latest GWT DevGuideCodingBasicsJSNI]]
 
For more information take a look at [[https://developers.google.com/web-toolkit/doc/latest/DevGuideCodingBasicsJSNI latest GWT DevGuideCodingBasicsJSNI]]
  
 
[[Category: Extension Guide]]
 
[[Category: Extension Guide]]

Latest revision as of 09:04, 17 February 2015

There're several UI javascript function public exposed. In some OpenKM customization cases is interesting accessing some public UI javascript functions ( take a look at this video tab embedded web application ).

General Functions

  • jsI18n(String) - Returns frontend trasnlation where String is the translation key.
  • jsOpenWikiPage(String) - Open wiki page where String is wiki title.
  • jsOpenUserTaskInstance(String) - Open dashboard workflow view with user taskinstance, where String is the taskinstance.
  • jsOpenPath(String, String) - Open some path in OpenKM UI. First String is folder path, second string is document path.
  • jsOpenPathByUuid(String) - Open some path in OpenKM UI where String indicates uuid.
  • jsRefreshFolder() - Refresh ui, same as toolbar refresh button
  • jsWizard(String, String) - Call wizard where first String is docPath and second String is json to string serialization of GWTFileUploadResponse bean.
  • i18n(String) - Returns frontend trasnlation where String is the translation key ( deprecated from openkm 6.x ).
  • openWikiPage(String) - Open wiki page where String is wiki title ( deprecated from openkm 6.x ).
  • openPath(String, String) - Open some path in OpenKM UI. First String is folder path, second string is document path. ( deprecated from openkm 6.x ).
  • openPathByUuid(String) - Open some path in OpenKM UI where String indicates uuid. ( deprecated from openkm 6.x ).
  • refreshFolder() - Refresh ui, same as toolbar refresh button ( deprecated from openkm 6.x ).
  • jsOpenUserTaskInstance(taskInstanceId) - Open workflow with taskInstanceId
  • jsCancelCheckout() - Cancel selected document checkout.
  • jsGetActualPath() - Return actual path of selected tree node in navigator ( desktop view ).
  • jsGetActualNodePath() - Return actual selected node path ( navigator or file brower ).
  • jsGetActualNodeUUID() - Return actual selected node uuid ( navigator or file brower ).
  • jsGetUser() - Return GWTUser object serialized to JSON.

Specific Cryptography Functions

  • cryptographyLoaded() - Hide UI status indicating cryptography applet is yet loaded.
  • digitalSignatureEnded() - Indicates digital signature has finished.
  • digitalSignatureCanceled() - Cancelling digital signature has been canceled.
  • startDigitalSignature() - Start digital signature.

Specific Applets Functions

  • destroyScannerApplet() - Indicates should be cleaned the scanner applet
  • destroyUploaderApplet() - Indicates should be cleaned the uploader applet

Specific HTMLEditor Functions

  • jsSearchDocumentHTMLEditorPopup - Open search document popup
  • jsSearchFolderHTMLEditorPopup - Open search folder popup

specific Wiki Functions

  • jsOpenWikiPage(String) - Open wiki page with some title
  • openWikiPage(String - Open wiki page with some title ( deprecated from openkm 6.x ).

How expose GWT public methods to JS

Example 1- how to expose static method called i18n to public js as jsI18n 

/**
 * initJavaScriptApi
 */
native void initJavaScriptApi() /*-{
	$wnd.jsI18n = function(s) {
		return @com.openkm.frontend.client.Main::i18n(Ljava/lang/String;)(s);
	};
}-*/;

Example 2- How to expose non static method from class Toolbar.java to public js as jsRefreshFolder.

After Toolbar.java has been created can be called the initJavaScriptApi: 

ToolBar toolBar = new ToolBar();
mainPanel.topPanel.toolBar.initJavaScriptApi(mainPanel.topPanel.toolBar);

Toolbar.java code: 

/**
 * initJavaScriptApi
 */

public native void initJavaScriptApi(ToolBar toolBar) /*-{
	$wnd.jsRefreshFolder = toolBar.@com.openkm.frontend.client.widget.toolbar.ToolBar::executeRefresh();
}-*/;

For more information take a look at [latest GWT DevGuideCodingBasicsJSNI]

Retrieved from "https://www.openkm.com/wiki/index.php?title=Javascript_API&oldid=12188"