Table of Contents | ||
---|---|---|
|
Usage
Thai |
---|
การใช้ |
English Plugin Properties Options allow a plugin to gather configuration data from a plugin user. Thai ตัวเลือกคุณสมบัติปลั๊กอินอนุญาตให้ปลั๊กอินรวบรวมข้อมูลการกำหนดค่าจากผู้ใช้ปลั๊กอิน
Plugin Properties Options should be returned in the abstract method "getPropertyOptions" of each plugin.
Thai ตัวเลือกคุณสมบัติปลั๊กอินควรส่งคืนในเมธอด abstract "getPropertyOptions" ของแต่ละปลั๊กอิน
...
type : 'color'
Thai ประเภท: 'สี'
Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Thai อ้างถึง Dependency Field Attributes สำหรับแอททริบิวพิเศษที่ต้องแสดง / ซ่อนฟิลด์นี้ตามค่าฟิลด์อื่น
Color Scheme (New)
Panel | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||
This is a new feature in Joget DX 8 |
...
- type : 'colorscheme'
value : Renders color options according to assigned hex color code.
Code Block language js //The first hex color code indicates the color group //Hex color code after the first color code would be render as seen in example picture above //Numbers of color can be determined based on number of hex color code after the first hex color code (color group) //This example contains 5 colors "value" : "#e9e9e9;#FFFFFF;#AABEB2;#00652D;#00796b;#004c40" //This example contains 1 color "value":"#e9e9e9;#FFFFFF" //This example contains 3 colors "value":"#e9e9e9;#3b2d2d;#7d0956;#0cf2e7"
- If we wish to access the property editor, the code can be located at the directory located at the disk drive Joget is downloaded (Example : <joget dx8 <Joget DX 8 installation folder>/apache-tomcat-9.0.62/webapps/jw/js/jquery/jquery.propertyeditor.js)
Color group, color choices, and no. of color options can be determine at the array called schemeOptions (line 10368):
Code Block language js //Shows color group: #e9e9e9 //With 5 colors options //With 15 color choices schemeOptions : [ "#e9e9e9;#FFFFFF;#996C67;#291715;#c41c00;#ff5722", "#e9e9e9;#FFFFFF;#D3B8B9;#774B4E;#d32f2f;#9a0007", "#e9e9e9;#FFFFFF;#C1ADB8;#2a8ffb;#2a0814;#e72a6d", "#e9e9e9;#FFFFFF;#90AECF;#2a8ffb;#4a0072;#7b1fa2", "#e9e9e9;#FFFFFF;#7EB3C7;#334A52;#512da8;#140078", "#e9e9e9;#FFFFFF;#7AB5B7;#324B4C;#303f9f;#001970", "#e9e9e9;#FFFFFF;#AECAC7;#2C6562;#1976d2;#004ba0", "#e9e9e9;#FFFFFF;#AFA4DA;#312D4A;#304ffe;#0026ca", "#e9e9e9;#FFFFFF;#9debf9;#007252;#00838f;#005662", "#e9e9e9;#FFFFFF;#AABEB2;#00652D;#014048;#ff5722", "#e9e9e9;#FFFFFF;#BEBDAB;#565737;#2e7d32;#005005", "#e9e9e9;#FFFFFF;#D5C1B5;#755741;#827717;#524c00", "#e9e9e9;#FFFFFF;#D8BEBB;#AC2C2E;#8d6e63;#5f4339", "#e9e9e9;#FFFFFF;#7FD1AE;#757575;#0f2f4a;#0072d2", "#e9e9e9;#FFFFFF;#A4BEB8;#006651;#546e7a;#29434e" ],
If you wanted to change the no. of color options shown, simply change the number in line: 10424, 10426 & 10450 to the desired number such as 3. You are required to change the no of color options in the schemeOptions too.
Code Block language js //Line 10424 & 10426 if (colors.length === 6) { //Change 6 to desired number html += '<colorgroup style="background:'+colors[0]+';">'; for (var i=1; i<6; i++) { //Change 6 to desired number html += '<color style="background:'+colors[i]+';"></color>'; } html += '</colorgroup>'; } else { html += '<colorgroup><color></color><color></color><color></color><color></color><color></color></colorgroup>'; } //Line 10450 for (var i = 1; i < 6; i++) //Change 6 to desired number { html += '<color style=\"background:'+values[i]+';\"></color>'; }
...
type : 'HtmlEditor'
Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Thai อ้างถึง Dependency Field Attributes สำหรับแอททริบิวพิเศษที่ต้องแสดง / ซ่อนฟิลด์นี้ตามค่าฟิลด์อื่น
Refer to Retrieve Properties Value in Plugin - Single Value Field on how to use the value of this field type in the plugin code.
Thai อ้างอิงถึง Retrieve Properties Value in Plugin - Single Value Field เกี่ยวกับวิธีใช้ค่าของฟิลด์นี้พิมพ์ในรหัสปลั๊กอิน
Icon Textfield (New)
Panel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
This is a new feature in Joget DX.
|
- type : 'icon-textfield'
- Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Image
Thai |
---|
ภาพ |
type : 'fileimage',
appPath : '[APP_PATH]',
allowInput : Optional, 'true' or 'false'. Set to 'true' to allow custom link.
isPublic : Optional, 'true' or 'false'. Set to 'true' to auto set the permission to access by anonymous.
allowType : Optional, a string of file extension seperated (;). Example: ".jpeg;.jpg;.gif;.png".
maxSize : Optional, integer value in string format. In kB.
imageSize : Optional, can be integer value in string format or a css expression. Example: '50' or "width:100px;height:70px;".
Refer to Regular Express (Regex) Validation Attributes for extra attributes to do validation using regex.
Thai อ้างถึง Regular Express (Regex) Validation Attributes สำหรับแอตทริบิวต์เพิ่มเติมเพื่อทำการตรวจสอบความถูกต้องโดยใช้ regex
Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Thai อ้างถึง Dependency Field Attributes สำหรับแอททริบิวพิเศษที่ต้องแสดง / ซ่อนฟิลด์นี้ตามค่าฟิลด์อื่น
Refer to Retrieve Properties Value in Plugin - Single Value Field on how to use the value of this field type in the plugin code.
Thai อ้างอิงถึง Retrieve Properties Value in Plugin - Single Value Field เกี่ยวกับวิธีใช้ค่าของฟิลด์นี้พิมพ์ในรหัสปลั๊กอิน
...
type : 'Readonly'
Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Thai อ้างถึง Dependency Field Attributes สำหรับแอททริบิวพิเศษที่ต้องแสดง / ซ่อนฟิลด์นี้ตามค่าฟิลด์อื่น
Refer to Retrieve Properties Value in Plugin - Single Value Field on how to use the value of this field type in the plugin code.
Thai อ้างอิงถึง Retrieve Properties Value in Plugin - Single Value Field เกี่ยวกับวิธีใช้ค่าของฟิลด์นี้พิมพ์ในรหัสปลั๊กอิน
...
Repeater (New)
type : 'Repeater'
fields : A JSON array of 'fields' JSON objects which can support any properties field types and its attributes.
Refer to Field Types for the attributes of the fields.
Code Block language js fields : [ {name : 'value', label : 'Value', required: 'true', type: 'checkbox', options: [{ value: 'true', label: ''}]}, {name : 'label', label : 'Label', required: 'true', type: 'textfield'} ]
Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Thai อ้างถึง Dependency Field Attributes สำหรับแอททริบิวพิเศษที่ต้องแสดง / ซ่อนฟิลด์นี้ตามค่าฟิลด์อื่น
Refer to Retrieve Properties Value in Plugin - Repeater Field on how to use the value of this field type in the plugin code.
Thai อ้างอิงถึง Retrieve Properties Value in Plugin - Repeater Field เกี่ยวกับวิธีใช้ค่าของฟิลด์ชนิดนี้ในรหัสปลั๊กอิน
Multiselect in Grid Interface (New)
Thai |
---|
Thai |
เลือกได้หลายแบบในส่วนต่อประสานกริด (ใหม่) |
...
Panel | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
This is a new feature in Joget DX.
|
type : 'elementmultiselectnumber'
Select Box
Thai |
---|
เลือกกล่อง |
type : 'SelectBox'
Refer to Option Field Attributes for extra attributes.
Thai อ้างถึง Option Field Attributes สำหรับแอตทริบิวต์เพิ่มเติม
Refer to Dependency Field Attributes for extra attributes to do show/hide this field based on other field value.
Thai อ้างถึง Dependency Field Attributes สำหรับแอททริบิวพิเศษที่ต้องแสดง / ซ่อนฟิลด์นี้ตามค่าฟิลด์อื่น
Refer to Retrieve Properties Value in Plugin - Single Value Field on how to use the value of this field type in the plugin code.
Thai อ้างอิงถึง Retrieve Properties Value in Plugin - Single Value Field เกี่ยวกับวิธีใช้ค่าของฟิลด์นี้พิมพ์ในรหัสปลั๊กอิน
...
The following attributes are designed for Auto Complete, Password Field, Text Area and Text Field.
Thai คุณลักษณะต่อไปนี้ได้รับการออกแบบมาสำหรับ Auto Complete, Password Field, Text Area และ Text Field
regex_validation : Optional, regular express in string format.
validation_message : Optional, error message to display when validation failurevalidation failure.
Code Block | ||
---|---|---|
| ||
{
regex_validation : '^[a-zA-Z0-9_]+$',
validation_message : 'Invalid ID!!'
} |
Javascript Function Validation Attributes
The following attributes are designed for all field type.
js_validation : Optional, Javascript function name in string format or a function.
Code Block | ||
---|---|---|
| ||
{ regexjs_validation : '^[a-zA-Z0-9_]+$',functionName' } |
Code Block | ||
---|---|---|
| ||
{ js_validation_message : 'Invalid ID!!' function(fieldName, fieldValue) { if (fieldValue.indexOf("#") > 0) { return "Error! Value contains #"; } return null; } } |
Dependency Field Attributes
...
The following attributes are available for all field types.
Thai แอททริบิวต่อไปนี้ใช้ได้กับฟิลด์ทุกประเภท
These attributes are used to show/hide a field based on the value of another field.
Thai แอ็ตทริบิวต์เหล่านี้ใช้เพื่อแสดง / ซ่อนฟิลด์ตามค่าของฟิลด์อื่น
The value of a field hidden by these attributes will be ignore during save.
Thai ค่าของฟิลด์ที่ถูกซ่อนโดยแอตทริบิวต์เหล่านี้จะถูกละเว้นในระหว่างการบันทึก
control_field : Optional, 'name' of another field used to control the show/hide of current field.
control_value : Optional, value or regular expression (regex) in string format. This value need to match the value of the controlling field in order to make the field visible.
control_use_regex : Optional, 'true' or 'false'. Default to 'false'. Set to 'true' to use regular expression (regex) in matching the value.
Code Block | ||
---|---|---|
| ||
{ control_field: 'chartType', control_value: 'bar|xy|area|bubble|line|candlestick|ohlc', control_use_regex: 'true', } |
...
All the plugin must extends the "org.joget.plugin.base.ExtDefaultPlugin" abstract class. We can use the "Object getProperty(String)" and "String getPropertyString(String)" method to retrieve the configured properties.
Thai ปลั๊กอินทั้งหมดจะต้องขยายคลาสนามธรรม "org.joget.plugin.base.ExtDefaultPlugin" เราสามารถใช้วิธี "Object getProperty (String)" และ "String getPropertyString (String)" วิธีการเพื่อดึงคุณสมบัติที่กำหนดค่าไว้
Single Value Field
(String)" and "String getPropertyString(String)" method to retrieve the configured properties.
Thai ปลั๊กอินทั้งหมดจะต้องขยายคลาสนามธรรม "org.joget.plugin.base.ExtDefaultPlugin" เราสามารถใช้วิธี "Object getProperty (String)" และ "String getPropertyString (String)" วิธีการเพื่อดึงคุณสมบัติที่กำหนดค่าไว้
Single Value Field
Thai |
---|
เขตข้อมูลค่าเดียว |
Code Block | ||
---|---|---|
| ||
String value = getPropertyString("property_name"); |
Multi Values Field
Thai |
---|
ฟิลด์ค่าหลายค่า |
Code Block | ||
---|---|---|
| ||
String[] values = getPropertyString("property_name").split(";"); |
Combine Grid Field
Thai |
---|
รวมเขตข้อมูลกริด |
Thai |
เขตข้อมูลค่าเดียว |
Code Block | ||
---|---|---|
| ||
String valueString[] col1_values = getPropertyString("col1_name").split(";"); String[] col2_values = getPropertyString("propertycol2_name").split(";"); |
...
Grid Field
Thai |
---|
ฟิลด์ค่าหลายค่าฟิลด์กริด |
Code Block | ||
---|---|---|
| ||
String[]Object valuescolumns = getPropertyStringgetProperty("property_name").split(";"); |
Combine Grid Field
Thai |
---|
รวมเขตข้อมูลกริด |
Code Block | ||
---|---|---|
| ||
String[] col1_values = getPropertyString("col1_name").split(";");
String[] col2_values = getPropertyString("col2_name").split(";"); |
Grid Field
Thai |
---|
ฟิลด์กริด |
);
if (columns != null) {
for (Object colObj : (Object[]) columns) {
Map col = (Map) colObj;
String col1_value = (String) opt.get("col1_key");
String col2_value = (String) opt.get("col2_key");
}
} |
Repeater Field
Code Block | ||
---|---|---|
| ||
Object columnsfields = getProperty("property_name"); if (columnsfields != null) { for (Object colObjfieldObj : (Object[]) columnsfields) { Map colfield = (Map) colObjfieldObj; String col1field1_value = (String) optfield.get("col1field1_key"); String col2field2_value = (String) optfield.get("col2field2_key"); } } |
Element Select Box
...