字段及表单规则 - 支持的JavaScript函数

默认情况下，脚本语言为 JavaScript, 我们已经为您添加了jQuery 和 $CS（在全局范围内均可用），因此，允许用户使用 jQuery (v 1.8.3) 和 $CS 库进行编程。 (注意: 使用jQuery访问元素时，不支持 $ 符号)。

$CS 库中可用的Javascript函数

$CS.getValue(field)

使用该函数可以获取指定字段的值。
可以使用它为文本字段设置输入文本
可以使用它为精选列表字段指定选定的项目。

var statusId=$CS.getValue("STATUS");
var subject= $CS.getValue("SUBJECT");
var created_date=$CS.getValue("CREATEDDATE"); //This will return a JavaScript Date Object
var additional_hardware=$CS.getValue("RES_3_QUS_3"); //For checkbox type resource fields returns an array of selected resources

————————————————————————————————————————————————————————————————————————————————————————

$CS.setValue(field,value)

使用本函数为指定的字段设置值。
可以使用它为文本字段设置输入文本
可以使用它为精选列表字段指定选定的项目。

$CS.setValue("STATUS","1");
$CS.setValue("SUBJECT","test request");
$CS.setValue("UDF_DATE1", new Date());
$CS.setValue("RES_3_QUS_3", ["CD RW", "External Harddisk" , "Optical Mouse"]); //Will remove existing selected resources and add this resources for checkbox type resource fields.

$CS.getText(field)
- 使用本函数获取指定字段的选定项目的文本。
- 本函数只能使用于精选列表字段。

var status=$CS.getText("STATUS");

$CS.setText(field,text)

使用本函数可以为指定的字段设置选定的项目的文本。
本函数只能使用于精选列表字段。

$CS.setText("STATUS","Open");

$CS.addOptions(field,options)

使用本函数为指定的字段添加选项
这里，options变量应该时一个选项阵列。
本函数只能使用于精选列表字段。

$CS.addOptions("STATUS",["Open","Closed"]);

$CS.removeOptions(field,options)

使用本函数从指定的字段中，移除已有的选项内容。
这里，options变量应该时一个选项阵列。
本函数只能使用于精选列表字段。

$CS.removeOptions("STATUS",["Open","Closed"]);

$CS.removeAllOptions(fields)

使用本函数从指定的字段，移除所有的已有选项，
这里，fields变量是要移除的字段阵列。

$CS.removeAllOptions(["STATUS"]); // If all options of status field is removed, new request creation will not work. Since every request should have a status.
$CS.removeAllOptions(["STATUS","PRIORITY"]);

$CS.enableField(fields)

使用本函数可以启用一个或多个字段。
这里，fields变量应该是要启用的字段的阵列。

$CS.enableField(["LEVEL","PRIORITY","URGENCY"]);

$CS.disableField(fields)

使用本函数可以禁用一个或多个字段。只允许用户查看字段，不能编辑相应的字段。
这里，fields变量应该是要禁用的字段的阵列。

$CS.disableField(["LEVEL","PRIORITY","URGENCY"]);

$CS.hideField(fields)

使用本函数可以隐藏一个或多个字段。限制用户查看相应的字段。
这里，fields变量应该是要隐藏的字段的阵列。

$CS.hideField(["LEVEL","PRIORITY","URGENCY"]);

——————————————————————————————————————————————————————————————————————————————————————

$CS.showField(fields)

使用本函数可以显示一个或多个已被隐藏的字段。允许用户查看相应的字段。
这里，fields变量应该是要显示的字段的阵列。

$CS.showField(["LEVEL","PRIORITY","URGENCY"]);

$CS.mandateField(fields)

使用本函数可以将一个或多个字段设置为必填字段。用户不填写相应字段的值时，不能提交表单。
这里，字段应该是要设置为必填字段的阵列。

$CS.mandateField(["LEVEL","PRIORITY","URGENCY"]);

$CS.nonMandateField(fields)

使用本函数可以将一个或多个字段设置为非必填字段。这些字段没有值也可以提交表单。

$CS.nonMandateField(["LEVEL","PRIORITY","URGENCY"]);

$CS.stopFormSubmission()

使用本函数停止提交表单。
本函数只适用于“表单提交时”的事件。

var status=$CS.getText("STATUS");
if(status==="Closed")
{
$CS.stopFormSubmission();
}

$CS.isRequester()

使用本函数，检验登录的用户是否为一个请求人。
如果是请求人，函数返回 True, 否则返回值为False。

$CS.isTechnician()

使用本函数，检验登录的用户是否为一个技术员。
如果是技术员，函数返回 True, 否则返回值为False。

$CS.hasRole(role)

使用本函数，检验登录的用户是否属于指定的角色。
如果登录用户具有指定的角色权限，函数返回 True, 否则返回值为False。

$CS.hasRole("SDAdmin");

$CS.getLoggedInUserId()

使用本函数获取登录用户的用户ID。

var userId=$CS.getLoggedInUserId();

$CS.getLoggedInUserName()

使用本函数获取登录用户的用户名称。

var userName= $CS.getLoggedInUserName();

$CS.setFieldDependency(dependencyObject)

使用本函数为字段设置依赖关系，
这里依赖对象为两个或三个依赖的对象（JSON对象）

$CS.setFieldDependency(dependencyObject);

$CS.setTasks(tasksArray)

使用本函数可以设置所给任务ID的阵列。

$CS.setTasks(["templateTask1","templateTask2","templateTask3"]);

$CS.unSetTasks(tasksArray)

取消设置任务

$CS.unSetTasks(["templateTask1","templateTask2","templateTask3"]);

$CS.setDescription(description)

设置描述字段的内容。

$CS.setDescription("Application crashes / hangs frequently in user environment causing instability for the system.");

$CS.getDescription()

获取描述字段的内容。

var descriptionContent=$CS.getDescription();

$CS.disableOptions(fieldId,options)

使用该函数可以禁用指定字段的选项。
本函数只适用于精选列表字段。
这里的options变量为选项阵列。

$CS.disableOptions("STATUS",["Open","Closed"]);

$CS.enableOptions(fieldId,options)

使用该函数可以启用指定字段的选项。
本函数只适用于精选列表字段
这里的options变量为选项阵列

$CS.enableOptions("STATUS",["Open","Closed"]);

$CS.isVisible(field)

本函数用于检查字段或资源当前是否可视化。

var isPriorityFieldVisiable=$CS.isVisible("PRIORITY");

$CS.isEnabled(field)

本函数用于检查字段或资源当前是否被启用。

$CS.isEnabled("PRIORITY");

$CS.isMandated(field)
- 本函数用于检查字段或资源当前是否是必填项。

$CS.isMandated("PRIORITY");

注意:

如果脚本在执行过程中出错，错误信息在控制台可以看到，它采用如下的格式：

Caught following exception in executing field & form rules script execution of rule:[ Rule name ] at line number: [ line number ] and column:[ column number ] --> Error Message

如:

Caught following exception in executing field & form rules script execution of rule:[ check for open request ] at line number: [ 2 ] and column: [ 8 ] --> Uncaught SyntaxError: Unexpected token = .