Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents
absoluteUrltrue

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
borderColorpurple
bgColorwhite
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

This is a new feature in Joget DX 8

...

  • type : 'colorscheme'
  • value : Renders color options according to assigned hex color code. 

    Code Block
    languagejs
    //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
    languagejs
    //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
    languagejs
    //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>';
    		}
    		

...

Icon Textfield (New)

Panel
borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

This is a new feature in Joget DX.

Thai

นี่เป็นคุณสมบัติใหม่ใน Joget DX

Image Added

  • 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 เกี่ยวกับวิธีใช้ค่าของฟิลด์นี้พิมพ์ในรหัสปลั๊กอิน

...

...

Repeater (New)

Image Added

  • 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
    languagejs
    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
borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

This is a new feature in Joget DX.

Thai

นี่เป็นคุณสมบัติใหม่ใน Joget DX


  • type  : 'elementmultiselectnumber'

 

Select Box

Thai

เลือกกล่อง

...

Code Block
languagejs
{
    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
languagejs
{
    regexjs_validation : '^[a-zA-Z0-9_]+$',functionName'
}
Code Block
languagejs
{
    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
languagejs
{
    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
languagejava
String value = getPropertyString("property_name");

Multi Values Field

Thai

ฟิลด์ค่าหลายค่า

Code Block
languagejava
String[] values = getPropertyString("property_name").split(";");

Combine Grid Field

Thai

รวมเขตข้อมูลกริด

Thai
เขตข้อมูลค่าเดียว

Code Block
languagejava
String valueString[] col1_values = getPropertyString("col1_name").split(";");
String[] col2_values = getPropertyString("propertycol2_name").split(";");

...

Grid Field

Thai
ฟิลด์ค่าหลายค่า

ฟิลด์กริด

Code Block
languagejava
String[]Object valuescolumns = getPropertyStringgetProperty("property_name").split(";");

Combine Grid Field

Thai

รวมเขตข้อมูลกริด

Code Block
languagejava
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
languagejava
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

...