Page History

AssignmentManager

• URL : /jw/js/json/util.js

• Auto included in all userview pages.

  Chinese
  自动包含在所有用户视图页面中。

• Used to deal with assignment of a logged in user.

  Chinese
  用于处理登录用户的分配。

completeAssignment(baseUrl, activityId, redirect)

Description

Completes an assignment with a specific process instance id & activity instance id

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如 'http://localhost/jw'

  • activityId - activity instance id of the assignment to be completed

    Chinese
    activityId - 要完成的分配的活动实例标识

  • redirect - a URL to redirect to after the assignment is completed (optional)

    Chinese
    redirect - 分配完成后重定向到的URL（可选）

Sample code  

 AssignmentManager.completeAssignment('http://localhost/jw', '1_1_activity', 'http://localhost/completed.jsp');

completeAssignmentWithVariable(baseUrl, activityId, variableData, redirect)

Description

Completes an assignment with a specific process instance id & activity instance id with option to set workflow variables

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如   'http://localhost/jw'

  • activityId - activity instance id of the assignment to be completed

    Chinese
    activityId - 要完成的分配的活动实例标识

  • variableData - variables to be set. All variable name must prefix with "var_"

    Chinese
    variableData - 要设置的变量。所有变量名都必须以“var_”作为前缀

  • redirect - a URL to redirect to after the assignment is completed (optional)

    Chinese
    redirect - 分配完成后重定向到的URL（可选）

Sample code  

AssignmentManager.completeAssignmentWithVariable('http://localhost/jw', '1_1_activity', 'var_status=new&var_id=123', 'http://localhost/completed.jsp');

getCurrentUsername(baseUrl, callback)

Description

Gets the current logged in username in Joget Workflow

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如 'http://localhost/jw'

  • callback - a callback function after a successful call

    Chinese
    callback -  成功调用后的回调函数

Sample code 

var callback = {
    success : function(response){
        //response.username
        if(response.username != "roleAnonymous"){
            console.log("Username is " + response.username);
        }else{
            console.log("User is anonymous");
        }
    }
};
AssignmentManager.getCurrentUsername('http://localhost/jw', callback);

login(baseUrl, username, password, callback)

Description

Login the user in Joget Workflow

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如 'http://localhost/jw'

  • username - username for user to login

    Chinese
    username - 用户名

  • password - password for user to login

    Chinese
    password - 密码

  • callback - a callback function after a successful call (optional)

    Chinese
    callback - 成功调用后的回调函数

Sample code  

var callback = {
    success : function(response){
        //response.username && response.isAdmin
        if(response.username != "roleAnonymous"){
            console.log("username (" + response.username + ") is " + ((response.isAdmin !== undefined && response.isAdmin === "true")?"admin":"not an admin"));
        }else{
            console.log("Fail to login user!");
        }
    }
};
AssignmentManager.login('http://localhost/jw', 'admin', 'admin', callback);

loginWithHash(baseUrl, username, hash, callback)

Description

Login the user with hash in Joget Workflow

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如 'http://localhost/jw'

  • username - username for user to login

    Chinese
    username - 用户名

  • hash - hashed password for user to login.  (refer to Hashed Password)

    Chinese
    hash - 登录的Hash密码.  (refer to 散列密码（Hashed Password）)

  • callback - a callback function after a successful call (optional)

    Chinese
    callback - 成功调用后的回调函数

Sample code  

var callback = {
    success : function(response){
        //response.username && response.isAdmin
        if(response.username != "roleAnonymous"){
            console.log("username (" + response.username + ") is " + ((response.isAdmin !== undefined && response.isAdmin === "true")?"admin":"not an admin"));
        }else{
            console.log("Fail to login user!");
        }
    }
};
AssignmentManager.loginWithHash('http://localhost/jw', 'admin', '14ACD782DCFEB2BCDE2B271CCD559477', callback);

logout(baseUrl)

Description

Logs out the current logged in username in Joget Workflow

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如 'http://localhost/jw'

Sample code  

AssignmentManager.logout('http://localhost/jw');

withdrawAssignment(baseUrl, activityId)

Description

Withdraws an assignment with a specific activity instance id

Parameters

• • baseUrl - base URL of Joget Workflow, e.g., 'http://localhost/jw'

    Chinese
    baseUrl - Joget Workflow的基本URL，例如 'http://localhost/jw'

  • activityId - activity instance id of the assignment to be withdrawn

    Chinese
    activityId - 要撤销的分配的活动实例ID

Sample code  

AssignmentManager.withdrawAssignment('http://localhost/jw', '1_1_activity');

ConnectionManager

• URL : /jw/js/json/util.js

• Auto included in all userview pages.

  Chinese
  自动包含在所有用户视图页面中。

• Convenient method to do AJAX call.

  Chinese
  AJAX方便的调用方法

ajaxJsonp(url, callback, params)

Description

Initiates Ajax call with JSONP

Parameters

• • url - URL to initiate Ajax call

    Chinese
    url - 启动Ajax调用的URL

  • callback - a callback function after a successful call (optional)

    Chinese
    callback - 成功调用后的回调函数（可选）

  • params - parameters for the call (optional)

    Chinese
    params - 调用参数（可选）

Sample code 

var callback = {
    success : function(response){
        //do something
    }
};
ConnectionManager.ajaxJsonp('http://localhost/test', callback, 'id=4&name=test');

get(url, callback, params, xss)

Description

Initiates Ajax GET to a specific URL

Parameters

• • url - URL for GET action

  • callback - a callback function after a successful call (optional)

    Chinese
    callback - 成功调用后的回调函数（可选）

  • params - parameters for the call (optional)

    Chinese
    params - 调用参数（可选）

  • xss - use when the URL is cross-domain (optional)

    Chinese
    xss - 当URL是跨域时使用（可选）

Sample code 

var callback = {
    success : function(response){
        //do something
    }
};
ConnectionManager.get('http://localhost/test', callback, 'id=6&name=test', false);

post(url, callback, params)

Description

Initiates Ajax POST to a specific URL

Parameters

• • url - URL for GET action

  • callback - a callback function after a successful call (optional)

    Chinese
    callback - 成功调用后的回调函数（可选）

  • params - parameters for the call (optional)

    Chinese
    params - 调用参数（可选）

Sample code 

var callback = {
    success : function(response){
        //do something
    }
};
ConnectionManager.post('http://localhost/test', callback, 'id=6&name=test');

FormUtil

• URL : /jw/js/json/formUtil.js

• Auto included in page using form.

  Chinese
  自动包含在使用表单的页面中

• Convenient method to interact with form field.

  Chinese
  方便与表单域交互的方法

getField(fieldId)

Description

Used to gets the field object of a form field

Parameters

• • fieldId - id of a form field

Sample code 

var field = FormUtil.getField("field1");
$(field).val("test"); //set value

getFieldsAsUrlQueryString(fields)

Description

Used to generates the fields value as url query parameter string

Parameters

• • fields - an array contains objects with "field", "param" and "defaultValue" attributes.

    Chinese
    fields - 一个数组包含带有“field”，“param”和“defaultValue”属性的对象。

    
    - field : id of a form field

    Chinese
    - field : 表单字段的ID

    
    - param : paremeter name to be used

    Chinese
    - param : 要使用的参数名称

    
    - defaultValue : value to be used when the field return empty value (Optional)

    Chinese
    - defaultValue : 当字段返回空值时使用的值（可选）

Sample code 

var fields = [
    {"field":"field1", "param":"p_field1"},
    {"field":"field2", "param":"p_field2"},
    {"field":"field3", "param":"p_field3", "defaultValue":"default value"},
];
 
var queryString = FormUtil.getFieldsAsUrlQueryString(fields);
console.log(queryString); //p_field1=Field1%20value&p_field2=Field2%20value;Field2%20second%20value&p_field3=default%20value

getGridCells(cellFieldId)

Description

Used to gets the cell objects of every rows of a grid field

Parameters

• • cellFieldId - Grid Field Id and the cell id separated by a dot ".". Eg. gridId.cellId

    Chinese
    cellFieldId - 网格字段ID和由点“.”分隔的单元格ID。例如： gridId.cellId.

Sample code 

var cells = FormUtil.getGridCells("gridId.field1");
$(cells).each(function(){
    //do something
});

getGridCellValues(cellFieldId)

Description

Used to gets the cell values of every rows of a grid field and return it in an array.

Parameters

• • cellFieldId - Grid Field Id and the cell id separated by a dot ".". Eg. gridId.cellId

    Chinese
    cellFieldId - 网格字段ID和由点“.”分隔的单元格ID。例如： gridId.cellId.

Sample code 

var values = FormUtil.getGridCellValues("gridId.field1");
for (var i = 0; i < values.length; i++) {
    console.log(values[i]); //i equals to row number start from 0
}

getValue(fieldId)

Description

Used to gets the value of a form field. 

Parameters

• • fieldId - id of a form field

    Chinese
    fieldId - 表单字段id

Sample code 

var value = FormUtil.getValue("field1");

getValues(fieldId)

Description

Used to gets the values of a form field. Values will return in an array. 

Parameters

• • fieldId - id of a form field

    Chinese
    fieldId -表单字段id

Sample code 

var values = FormUtil.getValues("field1");
for (var i = 0; i < values.length; i++) {
    console.log(values[i]); 
}

JPopup

• URL : /jw/js/json/ui_ext.js

• Auto included in all userview pages.

  Chinese
  自动包含在所有用户视图页面中

• Convenient method to create/show/hide a popup dialog to display a page.

  Chinese
  方便的方法来创建/显示/隐藏弹出对话框来显示页面

create(id, title, width, height)

Description

Used to creates a popup dialog element.

Parameters

• • id - an unique identifier of the popup dialog

    Chinese
    id - 弹出对话框的唯一标识符

  • title - a title to display for on the top of popup dialog (Optional)

    Chinese
    title - 在弹出对话框顶部显示的标题（可选）

  • width - width of the popup dialog box (Optional)

    Chinese
    width - 弹出对话框的宽度（可选）

  • height - height of the popup dialog box (Optional) 

    Chinese
    height - 弹出对话框的高度（可选）

Sample code 

JPopup.create("testPopup", "Test Popup Dialog");

hide(id)

Used to hides a created and shown popup dialog element.

Parameters

• • id - an unique identifier of the popup dialog

    Chinese
    id - 弹出对话框的唯一标识符

Sample code 

JPopup.hide("testPopup");

show(id, url, params, title, width, height, action)

Description

Used to creates a popup dialog element.

Parameters

• • id - an unique identifier of the popup dialog

    Chinese
    id - 弹出对话框的唯一标识符

  • url - an URL of a page to show in popup dialog

    Chinese
    url - 在弹出对话框中显示的页面的URL

  • params - a JSON object to pass parameter and its value (Optional)

    Chinese
    params - 要传递参数及其值的JSON对象（可选）

  • title - a title to display for on the top of popup dialog (Optional)

    Chinese
    title - 在弹出对话框顶部显示的标题（可选）

  • width - width of the popup dialog box (Optional)

    Chinese
    width - 弹出对话框的宽度（可选）

  • height - height of the popup dialog box (Optional)

    Chinese
    height - 弹出对话框的高度（可选）

  • action - Get/Post. Default to Post (Optional) 

    Chinese
    action - 获取/发布。默认为发布（可选）

Sample code 

var params = {
    id : "1",
    name : "test"
};
 
JPopup.show("testPopup", "http://www.joget.org", params);

UI

• URL : /jw/js/json/ui.js

• Auto included in all userview pages.

  Chinese
  自动包含在所有用户视图页面中

• Convenient method to retrieve value for UI usages.

  Chinese
  方便的方法来检索用户界面的值

adjustPopUpDialog(dialogbox)

Description

Used by system to align the popup dialog to the center of the screen.

Parameters

• • dialogbox - the popup dialog object

    Chinese
    dialogbox - 弹出的对话框对象

Sample code 

UI.adjustPopUpDialog(JPopup.dialogboxes["testPopup"]);

escapeHTML(content)

Description

Used to escapes HTML syntax in a value

Parameters

• • content - content to be escapes

    Chinese
    content - 内容是 escapes

Sample code 

var content = "<p>test content</p>";
var escapedContent = UI.escapeHTML(content);
console.log(escapedContent); // &lt;p&gt;test content&lt;/p&gt;

getPopUpHeight(height)

Description

Used by the system to calculate the height of a popup dialog for current screen size to support mobile device.

Parameters

• • height - Max height of the popup dialog. Default to "90%".

    Chinese
    height - 弹出对话框的最大高度。默认为“90％”。

Sample code 

var height = UI.getPopUpHeight("500px");

getPopUpWidth(width)

Description

Used by the system to calculate the width of a popup dialog for current screen size to support mobile device.

Parameters

• • width - Max width of the popup dialog. Default to "90%".

    Chinese
    width - 弹出对话框的最大宽度。默认为“90％”。

Sample code 

var width = UI.getPopUpWidth("800px");

userviewThemeParams()

Description

Used by system to gets the query parameters string that contains the meta of current userview theme in used.

Sample code 

var url = "http://localhost/jw/form/embed?" + UI.userviewThemeParams();

UrlUtil

• URL : /jw/js/json/util.js

• Auto included in all userview pages.

  Chinese
  自动包含在所有用户视图页面中。

• Convenient method to deal with URL.

  Chinese
  方便的方法来处理URL

constructUrlQueryString(params)

Description

Used to generate a query string based on a parameters object

Parameters

• • params - an object contains all parameter as attribute name and its values in array

    Chinese
    params - 一个对象包含所有参数作为属性名称及其在数组中的值

Sample code 

var params = {
    "name" : ["joget"],
    "email" : ["info@joget.org", "test@joget.org"]
};
var queryString = UrlUtil.constructUrlQueryString(params);
console.log(queryString); // name=joget&email=info%40joget%2Eorg&email=test%40joget%2Eorg

encodeUrlParam(url)

Description

Used to encodes the URL parameters in a URL.

Parameters

• • url - URL with parameters to be encode. Note: it use "&" and "=" as separator.

    Chinese
    url - 要编码参数的URL。注意：它使用“＆”和“=”作为分隔符。

Sample code 

var url = "http://localhost/jw/test?name=joget&email=info@jogte.org&email=test@joget.org";
 
var encodedUrl = UrlUtil.encodeUrlParam(url);
console.log(encodedUrl); // http://localhost/jw/test?name=joget&email=info%40joget%2Eorg&email=test%40joget%2Eorg

getUrlParams(url)

Description

Used to gets an object contains all parameter as attribute name and its value in an URL. 

Parameters

• • url - URL to be parses to retrieve all parameters and its value in array.

    Chinese
    url - 要解析的URL以检索数组中的所有参数及其值。

Sample code 

var url = "http://localhost/jw/test?name=joget&email=info@jogte.org&email=test@joget.org";
 
var params = UrlUtil.getUrlParams(url);
console.log(params); // {"name" : ["joget"], "email" : ["info@joget.org", "test@joget.org"]}

mergeRequestQueryString(queryString1, queryString2)

Description

Used to merge 2 URL query parameters strings into one query string.

Parameters

• • queryString1 - first query parameters string

    Chinese
    queryString1 - 首先查询参数字符串

  • queryString2 - second query parameters string. If a parameter is exist in both query strings, the value in second query string will override the first one.

    Chinese
    queryString2 - 第二个查询参数字符串。如果两个查询字符串中都存在参数，则第二个查询字符串中的值将覆盖第一个查询字符串中的值。

Sample code 

var q1 = "name=joget&email=info@jogte.org&email=test@joget.org";
var q2 = "name=joget team&phone=012345678";
 
var queryString = UrlUtil.mergeRequestQueryString(q1, q2);
console.log(queryString); // name=joget%20team&email=info%40joget%2Eorg&email=test%40joget%2Eorg&phone=012345678