การกำหนดชุดคำสั่ง (Command Set)

คุณสมบัตินี้ช่วยให้คุณสามารถกำหนดค่าแบบไดนามิกให้กับโหนด โดยอิงจากข้อมูลจาก Automation ใช้สัญลักษณ์ {{}} และขยายความด้วยข้อมูลที่สอดคล้องกับประเภทข้อมูลแต่ละประเภท

ชื่อ	ชื่อ	ตัวแปร
table	ดึงข้อมูลจากตาราง	table.columnName
variables	ดึงข้อมูลจากตัวแปร	variables.variableName
loopData	ดึงข้อมูลในวงล้อของ Node	loopData.loopId
globalData	ดึงข้อมูลทั่วไปของสถานการณ์	globalData
prevBlockData	ดึงค่าจากบล็อกก่อนหน้า	prevBlockData
googleSheets	ดึงข้อมูลจาก Google Sheets	googleSheets.referenceKey
spreadSheets	ดึงข้อมูลจากสเปรตชีต	spreadSheets.referenceKey

ในการกำหนดชุดคำสั่ง คุณต้องปฏิบัติตามรูปแบบ {{keyword}}และแทนที่คำว่า keywordด้วยแหล่งข้อมูลที่ระบุข้างต้น สิ่งนี้ช่วยให้ Automation สามารถแยกแยะระหว่างข้อมูลคงที่และข้อมูลไดนามิกได้ สมมติว่าคุณมีตัวแปร listname ในกระบวนการ และค่าของมันคืออาร์เรย์ของวัตถุ คุณต้องการส่งตัวแปรนี้ไปยัง API โดยใช้คำขอ HTTP (HTTP Request)

[ 
    { "name": "Telegram", "url": "https://telegram.org/" },
    { "name": "X", "url": "https://twitter.com/" }, 
    { "name": "Etsy", "url": "https://www.etsy.com/" } 
]

คุณสามารถใช้ชุดคำสั่งต่อไปนี้ภายในส่วนเนื้อหาของโหนด HTTP Request :

{{variables.listname}}

แต่จะเกิดอะไรขึ้นถ้าคุณต้องการใช้คุณสมบัติ url ขององค์ประกอบแรกในอาร์เรย์เป็นค่าในโหนด เปิดลิงก์เพื่อทำสิ่งนี้ คุณสามารถใช้ชุดคำสั่งดังนี้:

{{variables.listname[0].url}}

ในชุดคำสั่งนั้น 0หมายถึงองค์ประกอบแรกของArray และหากคุณต้องการดึงองค์ประกอบที่สองของArray ให้แทนที่ด้วย 1หรือใช้ 2เมื่อคุณต้องการดึงองค์ประกอบที่ 3 เป็นต้น

การเข้าถึงข้อมูลอื่นภายในชุดคำสั่ง เพื่อเข้าถึงข้อมูลอื่นภายในชุดคำสั่ง คุณต้องใส่ชุดคำสั่งที่เข้าถึงข้อมูลด้วยวงเล็บเหลี่ยม ([]) ตัวอย่าง: เมื่อคุณต้องการคูณค่าของตัวแปร salary ด้วยตัวเลข 12 โดยใช้ฟังก์ชัน $multiply

{{$multiply([variables.salary],12)}}

หรือเมื่อคุณต้องการทราบความยาวของตาราง bang1 โดยใช้ฟังก์ชัน $getLength

{{$getLength[bang1]}}

---

ฟังก์ชัน (Function)

ฟังก์ชันหรือคำสั่งการทำงานที่ถูกกำหนดไว้ล่วงหน้าทั้งหมดจะเริ่มต้นด้วยคำนำหน้า $เสมอ เช่น

$funcName(param)

และนี่คือรายการอ้างอิงของฟังก์ชันที่มีอยู่ใน Automation

$date(date, dateFormat?)

รับค่าหรือจัดรูปแบบวันที่ ฟังก์ชันนี้มีสองพารามิเตอร์ โดยพารามิเตอร์ที่สองเป็นพารามิเตอร์เลือก หากคุณต้องการจัดรูปแบบวันที่ปัจจุบัน คุณสามารถส่งผ่าน dateFormatเป็นพารามิเตอร์แรกโดยตรง เช่น

{{$date('dd-MMMM-yyyy')}}และผลลัพธ์จะเป็น 14-September-2023

คุณสามารถดูรูปแบบวันที่ทั้งหมดที่มีอยู่ในหน้านี้ และสำหรับพารามิเตอร์วันที่ ให้ดูรูปแบบวันที่ที่ถูกต้องได้จาก [หน้า MDN]

ตัวอย่างเช่น :

{{$date("dd/MM/yyyy-hh:mm aaaa") }} // 01/10/2023-05:00 p.m
{{$date("dd/MM/yyyy-hh:mm aaaa") }} // 01/10/2023-11:00 a.m
{{$date("dd/MM/yyyy-hh:mm aaaa OOOO") }} // 01/10/2023-11:00 a.m
{{$date("timestamp")}} // 132424534

$rand(min?, max?)

ฟังก์ชันนี้จะสร้างตัวเลขสุ่ม (ทั้งจำนวนเต็มหรือทศนิยม) หรือสร้างตัวเลขในช่วงระหว่างพารามิเตอร์ขั้นต่ำ min และสูงสุด max

ตัวอย่างเช่น :

{{$rand()}} // 23
{{$rand()}} // 13.333333
{{$rand(0, 10)}} // 6
{{$rand(0, 10.4)}} // 2.24234234

$randint(min?, max?)

สร้างจำนวนเต็มสุ่มหรือจำนวนในช่วงระหว่างพารามิเตอร์ขั้นต่ำ min และสูงสุด max ตัวอย่าง

{{$randint()}} // 23
{{$randint()}} // 13

{{$randint(0, 10)}} // 6
{{$randint(0, 10)}} // 2

$getLength(str)

การรับความยาวของ string หรือ Array

ตัวอย่างเช่น :

// รับความยาวของสตริง
{{$getLength("testing")}}  // 12
// รับความยาวของตาราง
{{$getLength([table])}}  // 4
// รับความยาวของคอลัมน์ "ข้อความ" ในแถวที่สอง
{{$getLength([table.1.text])}}  // 99

$getOTP(secret)​

ฟังก์ชันนี้จะรับพารามิเตอร์ในรูปแบบของสตริงและสร้างรหัส OTP จากสตริงนั้น โดยทั่วไปฟังก์ชันนี้จะใช้เมื่อคุณต้องการรับรหัสผ่าน OTP ตาม 2fa

ตัวอย่างเช่น :

{{$getOTP("qwjke234ewrh3249wei")}} // 123456
// รับรหัส OTP จากตัวแปรที่มี 2fa
// a=qwjke234ewrh3249wei
{{$getOTP([variables.a])}} //123456

$randData(text)​

ฟังก์ชันสำหรับสร้างข้อมูลสุ่ม โดยคุณเพียงแค่ส่งผ่านชุดคำสั่งให้กับพารามิเตอร์ เช่น $randData("?l") จะสร้างตัวอักษรเล็กสุ่ม เช่น a

ชุดคำสั่งที่รองรับ :

• ?l: ตัวอักษรเล็ก

• ?u: ตัวอักษรใหญ่

• ?d: ตัวเลข

• ?f: ตัวอักษรเล็ก + ตัวอักษรใหญ่

• ?s: สัญลักษณ์

• ?m: ตัวอักษรใหญ่ + ตัวเลข

• ?n: ตัวอักษรเล็ก + ตัวเลข

• ?a: ใด ๆ

และคุณสามารถนำมารวมกันได้ เช่น $randData("[email protected]") ฟังก์ชันนี้จะทำการสร้างอีเมลในรูปแบบ [email protected]

ตัวอย่างเช่น :

{{$randData("?d?d")}}   // 11
{{$randData("[email protected]")}}   // [email protected]
{{$randData("?d?u?s?l?l?s?a?m")}}   // qe7Q@do*?sds

$randDate(minDate?, maxDate?, dateFormat?)​

ฟังก์ชันนี้จะสร้างข้อมูลวันที่แบบสุ่มภายในช่วงของพารามิเตอร์ minDateและ maxDate ในรูปแบบที่กำหนดโดย dateFormat

ตัวอย่างเช่น :

{{$date("2023-10-01", "2023-10-05", "DD MMMM YYYY")}}  // 3 October 2023
{{$date("2022-10-01", "2023-10-01", "DD MMMM YYYY")}}  // 13 December 2022

$randPick(data)​

ฟังก์ชันนี้จะเลือกองค์ประกอบสุ่มหนึ่งองค์ประกอบจากอาร์เรย์ข้อมูลของตัวแปร dataฟังก์ชันนี้มักใช้เมื่อคุณส่งผ่านอาร์เรย์เข้าไปในฟังก์ชัน

ตัวอย่างเช่น :

data =["a","b", "c"]
{{$randPick([variables.data])}} // b

---

ตัวแปร (Variable)

ตัวแปรจะถูกเก็บในรูปแบบของ Object โดยชื่อของตัวแปรจะเป็นคีย์ของออบเจ็กต์นั้น

{
   "url": "https://google.com",
   "numbers": [100, 500, 300, 200, 400]
}

การดึงค่าของตัวแปร url: ชุดคำสั่ง: {{ variables.url }} ผลลัพธ์: https://google.com

การดึงค่าของตัวแปร numbers: ชุดคำสั่ง:{{ variables.numbers }} ผลลัพธ์: [100, 500, 300, 200, 400]

การดึงค่าแรกของตัวแปร numbers: ชุดคำสั่ง: {{ variables.numbers.0 }} ผลลัพธ์: 100

---

คำสั่ง JavaScript

Automation ยังรองรับ JavaScript ในการใช้คำสั่ง แต่การเขียน JavaScript คุณต้องเพิ่มเครื่องหมาย !! เป็นค่าว่างแรกในช่องข้อความของโหนด

ตัวอย่างเช่น : จาก ตัวเลขนั้นคือ: {{variables.number}} เป็น !! ตัวเลขนั้นคือ: {{variables.number}} และคุณยังสามารถใช้ฟังก์ชันที่มีอยู่ได้เหมือนกับฟังก์ชัน JavaScript

ตัวอย่างเช่น :

การใช้ฟังก์ชันที่มีอยู่ :

{{$getLength(table)}} //11
{{$randData("?d?d")}} // 99

การดึงแถวสุดท้ายของตาราง :

{{table[table.length - 1].columnName}}

การดึง timestamp ปัจจุบัน :

{{Date.now()}} //1666237704022

การเข้าถึงข้อมูลวนลูปและดัชนี :

// วนลูปตามข้อมูลของลูป
{{loopData.loopId.data}}
// วนลูปตามดัชนี
{{loopData.loopId.$index}}

---