ชนิดข้อมูลของตัวแปร
เมื่อคุณสร้างตัวแปรในโฟลว์ของคุณ Power Automate แปลงเป็นประเภทเฉพาะตามเนื้อหา
ข้อมูลบางชนิดเหล่านี้มีการใช้กันอย่างแพร่หลายทั่วทั้งแอปพลิเคชัน เช่น ตัวเลข ในขณะที่แอปอื่น ๆ เช่น อินสแตนซ์เบราว์เซอร์ ต้องการการดำเนินการที่ชัดเจนหรือกลุ่มของการดำเนินการ
ชนิดข้อมูลอย่างง่าย
ชนิดข้อมูลอย่างง่ายแสดงถึงค่าเดียว เช่น ข้อความและตัวเลข คุณสามารถใช้ชนิดข้อมูลเหล่านี้ได้อย่างอิสระหรือใช้เพื่อสร้างโครงสร้างข้อมูลที่ซับซ้อนมากขึ้น เช่น รายการและตารางข้อมูล
ค่าข้อความ
ซึ่งเป็นข้อความประเภทใดก็ได้ ตั้งแต่ที่อยู่อีเมลไปจนถึงเนื้อหาข้อความของไฟล์ .txt
ในการสร้างตัวแปร ค่าข้อความ ให้ใช้การดำเนินการ ตั้งค่าตัวแปร และเติมพารามิเตอร์อินพุตด้วยข้อความที่ต้องการโดยไม่มีสัญกรณ์ใดๆ
ค่าตัวเลข
ตัวเลขเป็นชนิดที่ใช้กับตัวเลข สามารถใช้ได้เฉพาะชนิดข้อมูลนี้ในการดำเนินการทางคณิตศาสตร์
ในการสร้างตัวแปร ค่าตัวเลข ให้ใช้การดำเนินการ ตั้งค่าตัวแปร และเติมพารามิเตอร์อินพุตด้วยตัวเลขโดยไม่มีสัญกรณ์ใดๆ
ยกเว้นค่าตัวเลขแบบฮาร์ดโค้ด คุณสามารถใช้นิพจน์ทางคณิตศาสตร์กับตัวแปรภายในเครื่องหมายเปอร์เซ็นต์ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับนิพจน์ทางคณิตศาสตร์ ไปที่ ใช้ตัวแปรและสัญกรณ์ %
ค่าแบบบูลีน
ค่าสามารถเป็นได้ทั้ง จริง หรือ เท็จ
ในการสร้างตัวแปร ค่าแบบบูลีน ให้ใช้การดำเนินการ ตั้งค่าตัวแปร และเติมพารามิเตอร์อินพุตด้วยนิพจน์ %True% หรือ %False%
นอกจากนี้ คุณสามารถสร้างนิพจน์ที่ซับซ้อนโดยใช้ตัวดำเนินการเชิงตรรกะ ตัวแปร และสัญกรณ์เปอร์เซ็นต์ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับนิพจน์ทางตรรกะ ไปที่ ใช้ตัวแปรและสัญกรณ์ %
ชนิดข้อมูลขั้นสูง
ชนิดข้อมูลขั้นสูงแสดงถึงโครงสร้างข้อมูลที่ซับซ้อน โดยจะทำหน้าที่เป็นคอลเลกชันของชนิดข้อมูลอื่นๆ ที่คุณสามารถเข้าถึงได้เป็นเอนทิตีเดียว
รายการ
รายการเป็นคอลเลกชันของข้อมูล ขึ้นอยู่กับชนิดของรายการแต่ละรายการ อาจมีรายการค่าข้อความ รายการค่าตัวเลข และอื่น ๆ ชนิดข้อมูลรายการเทียบเท่ากับอาร์เรย์มิติเดียวในเงื่อนไขการเขียนโปรแกรม
คุณสามารถสร้างรายการผ่านการดำเนินการ สร้างรายการใหม่ และเพิ่มรายการในรายการนั้นผ่านทางการดำเนินการ เพิ่มรายการในรายการ
คุณยังสามารถสร้างรายการผ่านการดำเนินการที่สร้างรายการเป็นผลลัพธ์ ตัวอย่างเช่น การดำเนินการ อ่านข้อความจากไฟล์ สามารถส่งคืนรายการค่าข้อความและการดำเนินการ รับไฟล์ในโฟลเดอร์ ส่งคืนรายการไฟล์
ในการดึงข้อมูลเฉพาะในรายการ ให้ใช้สัญกรณ์ต่อไปนี้: %VariableName[ItemNumber]%
ในตัวอย่างด้านล่าง โฟลว์จะเก็บหมายเลขแรกของรายการที่แสดงก่อนหน้านี้ไปยังตัวแปรใหม่ โปรดทราบว่าดัชนีควรเป็น 0 สำหรับรายการแรกของรายการ
แนวทางปฏิบัติทั่วไปคือการใช้การดำเนินการ แต่ละรายการ เพื่อวนซ้ำผ่านรายการของรายการ
หากคุณต้องการเข้าถึงเฉพาะบางส่วนของรายการ ให้ใช้สัญกรณ์ %VariableName[StartIndex:StopIndex]% ตัวอย่างเช่น นิพจน์ %List[2:4]% ดึงข้อมูลรายการที่สามและสี่ของรายการ รายการในตำแหน่ง StopIndex เป็นขอบเขตของการแบ่งและไม่สามารถดึงออกมาได้
หากต้องการแบ่งรายการตั้งแต่ต้นไปยังรายการใดรายการหนึ่ง อย่าตั้งค่าค่า StartIndex เช่น %List[:4]% หากต้องการแบ่งรายการตั้งแต่ดัชนีเฉพาะไปจนจบ อย่าตั้งค่าค่า StopIndex เช่น %List[2:]%
ตารางข้อมูล
ตารางข้อมูลมีข้อมูลในรูปแบบตาราง และเทียบเท่ากับอาร์เรย์สองมิติในเงื่อนไขการเขียนโปรแกรม
ตารางข้อมูลประกอบด้วยแถวและคอลัมน์ที่อธิบายตำแหน่งของแต่ละรายการโดยไม่ซ้ำกัน ตารางข้อมูล ถือได้ว่าเป็นรายการที่มี แถวข้อมูล เป็นรายการ
Power Automate ให้การดำเนินการ สร้างตารางข้อมูลใหม่ เพื่อสร้างตารางข้อมูลใหม่ หลังจากปรับใช้การดำเนินการ คุณสามารถใช้ตัวสร้างภาพเพื่อเติมค่าและเปลี่ยนชื่อส่วนหัวของคอลัมน์
นอกเหนือจากการดำเนินการ สร้างตารางข้อมูลใหม่ มีการดำเนินการอีกสามอย่างในการสร้างข้อมูลเพื่อจัดเก็บข้อมูลที่แยกมา ได้แก่: การดำเนินการ อ่านจากเวิร์กชีต Excel ดำเนินการคำสั่ง SQL และ ดึงข้อมูลจากหน้าเว็บ
นอกจากนี้ คุณสามารถสร้างตารางข้อมูลโดยใช้การดำเนินการ ตั้งค่าตัวแปร และสัญกรณ์อาร์เรย์การเขียนโปรแกรม สัญกรณ์นี้ประกอบด้วยอาร์เรย์มิติเดียวหลายอันคั่นด้วยเครื่องหมายจุลภาคและอยู่ในวงเล็บปีกกา นิพจน์สุดท้ายต้องมีรูปแบบต่อไปนี้: %{['Product1', '10 USD '], ['Product2 ', '20 USD']}%
หากคุณต้องการเพิ่มส่วนหัวของคอลัมน์ในขณะที่สร้างตารางข้อมูลใหม่ โดยใช้สัญกรณ์อาร์เรย์ ให้ใช้นิพจน์ ^['ColumnName1', 'ColumnName2'] สำหรับแถวแรก
ในการเพิ่มแถวใหม่ให้กับตารางที่มีอยู่ ให้ใช้การดำเนินการ แทรกแถวลงในตารางข้อมูล หรือ ให้สร้างนิพจน์ที่มีชื่อตัวแปรของตารางข้อมูล ซึ่งเป็นอักขระบวก (+) และค่าที่คุณต้องการเพิ่มในวงเล็บ
นอกจากการแทรกแถวลงในตารางข้อมูลแล้ว โฟลว์เดสก์ท็อปยังมีการดำเนินการต่างๆ ที่จัดการตารางข้อมูลอีกด้วย คุณสามารถค้นหารายการที่มีการดำเนินการเหล่านี้ทั้งหมดใน การอ้างอิงการดำเนินการของตัวแปร
ในการดึงรายการเฉพาะของ แถวข้อมูล ให้ใช้สัญกรณ์ต่อไปนี้: %VariableName[RowNumber][ColumnNumber]% โปรดทราบว่า RowNumber และ ColumnNumber ควรเป็น 0 สำหรับรายการแรก (แถวหรือคอลัมน์)
ตัวอย่างเช่น สมมติว่าโฟลว์ดึงเนื้อหาของเวิร์กชีต Excel และเก็บไว้ในตัวแปร ExcelData ในการเข้าถึงเซลล์แรกในแถวที่สองของตารางที่ดึงข้อมูล ให้ใช้นิพจน์ที่แสดงด้านล่าง
หมายเหตุ
ตัวแปร ExcelData ประกอบด้วยตารางค่าที่ดึงมาจากเวิร์กชีต Excel โดยใช้การดำเนินการ อ่านจากแผ่นงาน Excel ประกอบด้วยค่าบางอย่างของเวิร์กชีตเฉพาะไม่ใช่ทั้งไฟล์ Excel
หากคุณต้องการเข้าถึงคอลัมน์เฉพาะในตารางข้อมูลที่มีส่วนหัวของคอลัมน์ ให้ใช้สัญกรณ์ %ExcelData[rowNumber]['ColumnName']%
หากคุณวนซ้ำตารางข้อมูลด้วยการดำเนินการ สำหรับแต่ละ ตัวแปรที่มีข้อมูลการวนซ้ำปัจจุบันถือเป็นแถวข้อมูล
เช่นเดียวกับรายการ คุณใช้สัญกรณ์ %VariableName[StartRow:StopRow]% เพื่อเข้าถึงส่วนเฉพาะของตารางข้อมูล นิพจน์ดึงเฉพาะแถวที่กำหนดโดยดัชนีทั้งสองในขณะที่ตำแหน่ง StopRow เป็นขอบเขตของการแบ่งและไม่สามารถดึงออกมาได้
หากต้องการแบ่งตารางข้อมูลจากแถวแรกไปยังแถวเฉพาะ อย่าใช้ค่า StartRow เช่น %Datatable[:4]% เช่นเดียวกัน หากต้องการแบ่งตารางข้อมูลจากแถวเฉพาะไปจนจบ อย่าใช้ค่า StopRow เช่น %Datatable[2:]%
คุณสมบัติชนิดข้อมูลตารางข้อมูล
แถวข้อมูล
แถวข้อมูลมีค่าของแถวเดียวของตารางข้อมูล เมื่อคุณวนซ้ำตารางข้อมูลด้วยการดำเนินการ For Each ตัวแปรที่จะมีข้อมูลการวนซ้ำปัจจุบันเป็นแถวข้อมูล
ในการดึงรายการเฉพาะของ แถวข้อมูล ให้ใช้สัญกรณ์ต่อไปนี้: %VariableName[ItemNumber]%
หรือคุณสามารถใช้สัญกรณ์ %VariableName['ColumnName']% ชื่อของแต่ละคอลัมน์ถูกกำหนดโดยตารางข้อมูลที่คุณดึงแถวข้อมูล
ออบเจ็กต์ที่กำหนดเอง
ประกอบด้วยคู่ของคุณสมบัติและค่า ซึ่งสามารถแปลงเป็นรูปแบบ JSON ได้อย่างง่ายดาย
เพื่อสร้าง ออบเจ็กต์ที่กำหนดเอง ที่ว่างเปล่าใหม่ ให้ใช้การดำเนินการ ตั้งค่าตัวแปร และเติมนิพจน์ต่อไปนี้ %{{ }}% เพื่อสร้าง ออบเจ็กต์แบบกำหนดเอง ใหม่ และเริ่มต้นด้วยคุณสมบัติและค่า ให้ใช้โครงสร้างนิพจน์ต่อไปนี้: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%
สำคัญ
คำสำคัญที่สงวนไว้ไม่สามารถใช้เป็นคุณสมบัติออบเจ็กต์ที่กำหนดได้ หากต้องการดูรายการคำสำคัญที่สงวนไว้ทั้งหมด ให้ไปที่ คำสำคัญที่สงวนไว้ในโฟลว์เดสก์ท็อป
หากต้องการอัปเดตค่าของคุณสมบัติที่มีอยู่หรือเพิ่มคุณสมบัติใหม่ ให้ปรับใช้การดำเนินการ ตั้งค่าตัวแปร เติมชื่อคุณสมบัติในฟิลด์ ตั้งค่า และป้อนค่าในฟิลด์ เป็น
นอกเหนือจากค่าตามตัวอักษรแล้ว คุณสามารถใช้ตัวแปรเพื่อตั้งค่าคุณสมบัติและค่าของออบเจกต์แบบกำหนดเองแบบไดนามิกได้ ตัวอย่างเช่น โฟลว์ต่อไปนี้ใช้สองตัวแปรเพื่อเพิ่มคุณสมบัติใหม่ให้กับออบเจกต์ใหม่ที่ว่างเปล่า
ออบเจ็กต์ตัวเชื่อมต่อ
ออบเจ็กต์ตัวเชื่อมต่อเก็บข้อมูลจากตัวเชื่อมต่อระบบคลาวด์และทำงานคล้ายกับออบเจ็กต์ที่กำหนดเอง คุณสมบัติของพวกเขามักจะมีรายการของออบเจ็กต์ตัวเชื่อมต่ออื่นๆ การเข้าถึงค่าทำงานเหมือนกับในออบเจ็กต์แบบกำหนดเอง แม้ว่าการเข้าถึงค่าที่ซ้อนกันอาจต้องใช้นิพจน์ที่ซับซ้อนมากขึ้น
รายการของข้อมูลตาราง PDF
ตัวแปรของชนิดข้อมูลนี้สามารถสร้างได้ผ่านการดำเนินการ แยกตารางจาก PDF เท่านั้น
แต่ละรายการในรายการจะอธิบายตารางที่แยกออกมาและให้ข้อมูลที่จำเป็นทั้งหมดเกี่ยวกับตารางนั้น ในการเข้าถึงรายการข้อมูลของตารางข้อมูลเฉพาะ ให้ใช้สัญกรณ์ %VariableName[ItemNumber]%
ทุกรายการมีคุณสมบัติสี่ประการที่ช่วยให้คุณได้รับรายละเอียดเฉพาะอย่างเป็นอิสระ คุณสมบัติที่พร้อมใช้งานมีดังต่อไปนี้:
- DataTable – ส่งคืนตารางที่แยกออกมา
- TableStartingPage – ส่งคืนดัชนีของหน้าไฟล์ที่ประกอบด้วยส่วนต้นของตาราง
- TableEndingPage – ส่งคืนดัชนีของหน้าไฟล์ที่ประกอบด้วยส่วนท้ายของตาราง
- TableOrderInPage – ส่งคืนลำดับของตารางในหน้า
คุณสามารถค้นหาข้อมูลเพิ่มเติมเกี่ยวกับคุณสมบัติของชนิดข้อมูลนี้ได้ใน คุณสมบัติ Variables datatype
ในการเข้าถึงค่าของคุณสมบัติเฉพาะ ให้ใช้สัญกรณ์ %VariableName[ItemNumber].PropertyName% ตัวอย่างเช่น นิพจน์ต่อไปนี้คืนค่าตารางข้อมูลของรายการแรกของตัวแปร ExtractedPDFTables
ปัญหาและข้อจำกัดที่ทราบ
- ปัญหา: เมื่อตารางข้อมูลหรือเซลล์แถวข้อมูลมีรายการแบบหลายบรรทัด โปรแกรมดูตัวแปรจะแสดงเฉพาะบรรทัดแรกของเซลล์นั้น
- วิธีแก้ปัญหา: ไม่มี
อินสแตนซ์
อินสแตนซ์เว็บเบราว์เซอร์ – มีอินสแตนซ์เบราว์เซอร์ที่สร้างผ่าน เปิด Internet Explorer ใหม่หรือการดำเนินการเปิดเบราว์เซอร์อื่นๆ
อินสแตนซ์หน้าต่าง - มีอินสแตนซ์หน้าต่างที่สร้างผ่านการดำเนินการ รับหน้าต่าง
อินสแตนซ์ Excel - มีอินสแตนซ์ Excel ที่สร้างผ่านการดำเนินการ เปิด Excel
อินสแตนซ์ Outlook – มีอินสแตนซ์ Outlook ที่สร้างผ่านการดำเนินการ เปิด Outlook
การเชื่อมต่อ
การเชื่อมต่อ SQL – มีการเชื่อมต่อกับฐานข้อมูล SQL ที่สร้างขึ้นผ่านการดำเนินการ เปิดการเชื่อมต่อ SQL
การเชื่อมต่อ Exchange – มีการเชื่อมต่อกับ Exchange Server ที่สร้างขึ้นผ่านการดำเนินการ เชื่อมต่อกับ Exchange Server
การเชื่อมต่อ FTP – มีการเชื่อมต่อ FTP ที่สร้างผ่านการดำเนินการ เปิดการเชื่อมต่อ FTP และการดำเนินการ เปิดการเชื่อมต่อ FTP ที่ปลอดภัย
อื่นๆ
ส่วนนี้แสดงชนิดข้อมูลที่มีอยู่ทั้งหมดซึ่งไม่อยู่ในประเภทใดๆ ก่อนหน้านี้
ค่าทั่วไป
- ค่าทั่วไป – ชนิดข้อมูลนี้ใช้ในช่วงเวลาออกแบบเมื่อ Power Automate ไม่สามารถกำหนดชนิดข้อมูลของตัวแปรหรือพารามิเตอร์อินพุตได้ ค่าทั่วไปจะถูกแปลงเป็นชนิดข้อมูลอื่นระหว่างรันไทม์ตามข้อมูล
Active Directory
- รายการ Active Directory – มีการเชื่อมต่อกับเซิร์ฟเวอร์ Active Directory ที่สร้างขึ้นผ่านการดำเนินการ เชื่อมต่อกับเซิร์ฟเวอร์
- ข้อมูลกลุ่ม – ประกอบด้วยชื่อ ชื่อที่แสดง คำอธิบาย และสมาชิกของกลุ่ม Active Directory ที่ระบุ
- สมาชิกกลุ่ม – แสดงถึงสมาชิกของกลุ่ม Active Directory ที่ระบุ
- ข้อมูลผู้ใช้ – ประกอบด้วยข้อมูลเกี่ยวกับผู้ใช้ Active Directory ที่ระบุ เช่น ชื่อแรกและนามสกุล ชื่อย่อและชื่อเฉพาะ รายละเอียดงาน (บริษัท แผนก และตำแหน่ง) ข้อมูลติดต่อ (หมายเลขโทรศัพท์ นามสกุล และอีเมล) และที่ตั้ง (ประเทศ/ภูมิภาค เมือง, รัฐ, ที่อยู่ และรหัสไปรษณีย์)
คุณสมบัติชนิดข้อมูล Active Directory
Amazon Web Services (AWS)
- ไคลเอ็นต์ EC2 – มีเซสชัน EC2 ที่สร้างขึ้นผ่านการดำเนินการ สร้างเซสชัน EC2
- อินสแตนซ์ EC2 – แสดงถึงอินสแตนซ์ EC2 ที่ดึงมา
- ข้อมูลอินสแตนซ์ EC2 – มีข้อมูลเกี่ยวกับอินสแตนซ์ EC2
- การเปลี่ยนแปลงสถานะอินสแตนซ์ – มีข้อมูลเกี่ยวกับอินสแตนซ์ EC2 ที่เริ่มหรือหยุดทำงาน
- สแนปช็อตของ EBS – แสดงถึงสแนปช็อตของ EBS
- ระดับเสียง EBS – แสดงถึงระดับเสียง EBS
Azure
- ไคลเอนต์ Azure – มีเซสชัน Azure ที่สร้างขึ้นผ่านการดำเนินการ สร้างเซสชัน Azure
- กลุ่มทรัพยากร Azure – แสดงถึงกลุ่มทรัพยากร Azure ที่ดึงมา
- ดิสก์ที่มีการจัดการ Azure – แสดงถึงดิสก์ Azure ที่ดึงมา
- สแนปช็อตของ Azure – แสดงสแนปช็อตของ Azure
- เครื่องเสมือน Azure – แสดงถึงเครื่องเสมือน Azure ที่ดึงมา
- ข้อมูลเครื่องเสมือน Azure – มีข้อมูลเกี่ยวกับเครื่องเสมือน Azure
- การสมัครใช้งาน Azure – แสดงถึงการสมัครใช้งาน Azure ที่ดึงมา
CMD
- เซสชัน CMD – มีเซสชัน CMD ที่สร้างขึ้นผ่านการดำเนินการ เปิดเซสชัน CMD
วันที่และเวลา
วันเวลา – มีข้อมูลวันที่และเวลา ในการสร้างตัวแปรวันที่เวลาผ่านการดำเนินการ ตั้งค่าตัวแปร ให้เติมพารามิเตอร์อินพุตด้วยนิพจน์ %d"yyyy-MM-dd HH: mm: ss.ff + zzz"% โดยที่:
เครื่องหมาย คำอธิบาย yyyy ปี MM เดือน dd วัน HH ชั่วโมง mm นาที ss วินาที ff มิลลิวินาที zzz ส่วนต่างเวลา UTC ตัวอย่างเช่น %d"2022-03-25"% กำหนดวันที่ 25 มีนาคม 2022 ให้กับตัวแปรเป้าหมาย
คุณสมบัติชนิดข้อมูลวันที่และเวลา
- ข้อความจดหมาย – แสดงถึงข้อความอีเมล การดำเนินการ ดึงอีเมล เติมตัวแปรเหล่านี้
Exchange
- ข้อความอีเมล Exchange – แสดงถึงข้อความอีเมลที่ดึงมาจาก Exchange Server การดำเนินการ ดึงข้อมูลข้อความอีเมล Exchange เติมตัวแปรเหล่านี้
ไฟล์และโฟลเดอร์
- ไฟล์ – หมายถึงไฟล์
- โฟลเดอร์ – หมายถึงโฟลเดอร์
- FileSystemObject – หมายถึงโฟลเดอร์หรือไฟล์ ชนิดข้อมูลนี้ใช้ในพารามิเตอร์อินพุตที่ยอมรับโฟลเดอร์และไฟล์
คุณสมบัติชนิดข้อมูลไฟล์และโฟลเดอร์
FTP
- ไฟล์ FTP – หมายถึงไฟล์ FTP
- ไดเรกทอรี FTP – แสดงถึงไดเรกทอรี FTP
OCR
- กลไกการจัดการ OCR - มีกลไกการจัดการ OCR ที่สร้างขึ้นผ่านการดำเนินการ สร้างกลไกการจัดการ OCR
Outlook
- ข้อความเมล Outlook – แสดงถึงข้อความอีเมล Outlook การดำเนินการ ดึงข้อมูลข้อความอีเมลจาก Outlook เติมตัวแปรเหล่านี้
เทอร์มินัล
- เซสชันเทอร์มินัล – มีเซสชันเทอร์มินัลที่สร้างขึ้นผ่านการดำเนินการ เปิดเซสชันเทอร์มินัล
XML
- โหนด XML – มีเนื้อหาของเอกสาร XML การดำเนินการ อ่าน XML จากไฟล์ เติมตัวแปรเหล่านี้
Error
- ข้อผิดพลาด – มีข้อมูลเกี่ยวกับข้อผิดพลาดที่เกิดขึ้นล่าสุดในโฟลว์เดสก์ท็อป การดำเนินการ รับข้อผิดพลาดล่าสุด จะสร้างตัวแปรชนิดนี้