การดำเนินการคิวงาน
คิวงาน ใน Power Automate สามารถใช้เพื่อจัดเก็บข้อมูลที่เกี่ยวข้องกับกระบวนการและจัดเตรียมวิธีการแยกกระบวนการที่ซับซ้อนและระบบอัตโนมัติออก ทำให้สามารถสื่อสารแบบอะซิงโครนัสได้
คิวงานสามารถมีบทบาทสำคัญในการปรับปรุงประสิทธิภาพ ความสามารถในการปรับขนาด และความยืดหยุ่นของระบบอัตโนมัติ และช่วยจัดลำดับความสำคัญของงาน คิวงานช่วยให้คุณทำรายการที่มีลำดับความสำคัญสูงสุดให้เสร็จก่อน โดยไม่คำนึงว่าจะดำเนินการโดยพนักงานดิจิทัล พนักงานที่เป็นมนุษย์ หรือผ่านการผสานรวม
หมายเหตุ
- การสนับสนุนระดับการผลิตสำหรับการดำเนินการที่เกี่ยวข้องกับคิวงานชุดแรกต้องใช้ Power Automate Desktop เวอร์ชัน 2.37 หรือใหม่กว่า
- การดำเนินการคิวงานใน Power Automate สำหรับเดสก์ท็อปเป็นคุณลักษณะระดับพรีเมียม ซึ่งต้องมี การสมัครใช้งาน Power Automate
- ขณะนี้มีเพียงการดำเนินการ ประมวลผลรายการคิวงาน และ อัปเดตรายการคิวงาน เท่านั้นที่สามารถจัดประเภทและอนุญาตหรือจำกัดผ่านนโยบายการป้องกันการสูญหายของข้อมูล (DLP) และการดำเนินการอื่นๆ จะตามมาเร็วๆ นี้ โปรดทราบว่าการใช้คิวงานตามโฟลว์ระบบคลาวด์ไม่สามารถจำกัดได้ด้วยนโยบาย DLP
ประมวลผลรายการคิวงาน
การดำเนินการ ประมวลผลรายการคิวงาน บ่งชี้ถึงระบบจัดการและควบคุมคิวว่าเครื่องพร้อมที่จะประมวลผลรายการคิวงานตั้งแต่หนึ่งรายการขึ้นไป บริบทผู้ใช้ที่ร้องขอรายการใหม่จำเป็นต้องมีสิทธิ์เพียงพอในคิวงานและตารางรายการคิวงานเพื่อประมวลผลคิวงาน
คิวงาน ที่อ้างอิงในการดำเนินการก่อนหน้านี้ถูกใช้โดยผู้ประสานรวมคิวเพื่อกำหนดรายการถัดไปที่พร้อมใช้งานในคิวงานนั้นซึ่งอยู่ในสถานะ อยู่ในคิว เมื่อโฟลว์เดสก์ท็อปดำเนินขั้นตอนผ่านการดำเนินการภายในรายการคิวงานกระบวนการวนซ้ำที่การดำเนินการนี้แสดงผล คุณสามารถเรียกใช้ค่าได้โดยใช้ตัวแปรที่คุณกำหนดไว้สำหรับการดำเนินการพร้อมกับคุณสมบัติ .Value ในกรณีนี้ คุณสามารถเรียกค่าของรายการคิวงานโดยใช้ตัวแปร %WorkQueueItem.Value%
สำคัญ
ด้วยการระบุนิพจน์ FetchXML ในฟิลด์ "กรองแถว" คุณจะข้ามตรรกะ FIFO ของตัวประสานคิวงานเริ่มต้นสำหรับรายการที่อยู่ในคิว ซึ่งช่วยให้คุณสามารถตั้งค่าลำดับการยกเลิกคิวแบบกำหนดเองและละเว้นวันหมดอายุของรายการและการตั้งค่าอื่นๆ ที่จะนำไปใช้โดยอัตโนมัติเมื่อไม่มีการแสดงนิพจน์ตัวกรอง
Processworkqueueitemaction
การดำเนินการ การดำเนินการประมวลผลรายการคิวงาน จำเป็นต้องมีอาร์กิวเมนต์ต่อไปนี้
พารามิเตอร์อินพุต
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|---|
| คิวงาน | ไม่ | ข้อความ | รหัสคิวงานของคิวงานที่มีรายการที่ต้องประมวลผล | |
| กรองแถว | ใช่ | ข้อความ | นิพจน์การสอบถาม FetchXML ที่ใช้ในการดึงข้อมูลรายการจากคิวงาน | |
| เขียนทับการกำหนดค่าการลองใหม่อัตโนมัติของคิวงาน | ใช่ | Boolean | False | เมื่อเปิดใช้งาน ฟิลด์จะปรากฏขึ้นเพื่อให้คุณสามารถตั้งค่าหรือเขียนทับจำนวนการลองใหม่สูงสุดสำหรับ IT Exceptions |
| จำนวนครั้งที่ลองใหม่สูงสุด | ไม่ | ค่าข้อความ ค่าตัวเลข | เมื่อไม่ได้เขียนทับ จะใช้จำนวนการลองใหม่สูงสุดเริ่มต้นที่กำหนดไว้ในเรกคอร์ดคิวงาน | จำนวนสูงสุดของการลองใหม่ที่อนุญาตสำหรับ IT Exceptions พารามิเตอร์นี้ให้คุณปรับจำนวนการลองใหม่เป็นค่าที่สูงขึ้นหรือต่ำลง หรือแม้แต่ปิดใช้งานกลไกการลองใหม่โดยตั้งค่าจำนวนเป็น 0 |
ตัวแปรที่สร้าง
| อาร์กิวเมนต์ | ชนิด | Description |
|---|---|---|
| WorkQueueItem | ไม่ | ข้อมูลที่จัดเก็บไว้ในรายการคิวงานที่กำลังดำเนินการ |
ข้อยกเว้น
| ข้อยกเว้น | คำอธิบาย |
|---|---|
| ไม่พบคิวงาน | ค่าที่ป้อนในพารามิเตอร์คิวงานไม่ถูกต้อง |
| คิวงานหยุดชั่วคราวหรือหยุดทำงาน | คิวงานถูกหยุดชั่วคราวหรือถูกหยุด ซึ่งไม่ใช่สถานะที่ถูกต้องเมื่อประมวลผลรายการ |
| FetchXML ที่ไม่ถูกต้อง | นิพจน์ FetchXML ที่ระบุไม่ถูกต้อง |
| ไม่สามารถประมวลผลคิวงานได้ | คำขอไม่ถูกต้อง - ข้อผิดพลาดในไวยากรณ์ของการสอบถาม |
การสอบถาม FetchXML คืออะไร
Microsoft Dataverse FetchXML เป็นภาษาที่ใช้สำหรับการดึงข้อมูลจากฐานข้อมูล Dataverse ซึ่งออกแบบมาให้สร้าง ใช้งาน และทำความเข้าใจได้ง่าย ตัวอย่างเช่น คุณอาจต้องการขอให้ตัวประสานรวมประมวลผลรายการในลำดับที่แตกต่างจากการเข้าก่อนออกก่อน (FIFO) และภายในกรอบเวลาหมดอายุที่เฉพาะเจาะจง
เมื่อต้องการจำกัดการสนับสนุนการสอบถาม FetchXML ในการประมวลผลรายการคิวงาน จะมีการรองรับชุดข้อกำหนดและนิพจน์ FetchXML ที่จำกัด ข้อกำหนดเหล่านี้รวมถึงตัวกรอง เงื่อนไข และนิพจน์การสั่งซื้อ ซึ่งทั้งหมดจำกัดอยู่ในตารางรายการคิวงาน (workqueueitem) เฉพาะรายการที่อยู่ในสถานะ Queued เท่านั้นที่จะแสดง
ตัวอย่างการสอบถาม FetchXML
ต่อไปนี้เป็นตัวอย่างนิพจน์การสอบถามสำหรับวิธีการกรองใน name และเรียงลำดับผลลัพธ์ตามเรกคอร์ดที่หมดอายุก่อน (FEFO)
<filter type="and">
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
<condition attribute="name" operator="eq" value="MyNonUniqueNameString" />
</filter>
<order attribute="expirydate" descending="false" />
รายละเอียดการสนับสนุนการสอบถามและข้อมูลอ้างอิง
- รายชื่อ ตัวดำเนินการการสอบถาม ที่พร้อมใช้งาน รวมถึงตัวดำเนินการ เช่น ในหรือก่อน ระหว่าง และเดือนสุดท้าย
- รายการแอตทริบิวต์ที่มีอยู่ใน ตารางรายการคิวงาน
อัปเดตรายการคิวงาน
การดำเนินการ อัปเดตรายการคิวงาน ทำให้ผู้ใช้สามารถเปลี่ยนสถานะและผลการประมวลผลของรายการคิวงานที่เลือก
Updateworkqueueitemaction
การดำเนินการ การดำเนินการอัปเดตรายการคิวงาน จำเป็นต้องมีอาร์กิวเมนต์ต่อไปนี้
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|---|
| รายการคิวงาน | ไม่ | ข้อความ | ตัวแปรรายการคิวงานที่ส่งคืนก่อนหน้านี้โดยระบบจัดการและควบคุมคิว | |
| สถานภาพ | ไม่ | ประมวลผล ข้อยกเว้นทั่วไป | ประมวลผลแล้ว | อัปเดตรายการคิวงานที่กำลังดำเนินการโดยใช้สถานะจากรายการตัวเลือก |
| บันทึกย่อของการประมวลผล | ใช่ | ข้อความ | บันทึกย่อหรือค่าการประมวลผลแบบกำหนดเองเพื่อต่อท้ายรายการคิวที่กำลังประมวลผล | |
| ล้างบันทึกย่อของการประมวลผล | ใช่ | Boolean | False | เมื่อเปิดใช้งาน ระบบจะซ่อนล้างฟิลด์บันทึกย่อการประมวลผลบนหน้าจอนี้ และลบบันทึกย่อการประมวลผลใดๆ ออกจากฐานข้อมูลที่บันทึกไว้ก่อนหน้านี้สำหรับรายการนี้ |
ข้อยกเว้น
| อาร์กิวเมนต์ | Description |
|---|---|
| ไม่พบรายการคิวงาน | รายการคิวงานที่กำลังดำเนินการถูกลบหรือไม่ได้อยู่ในคิวที่ถูกเรียกใช้อีกต่อไป |
| รายการคิวงานถูกระงับ | รายการคิวงานที่กำลังดำเนินการมีสถานะเป็น on hold ในระบบจัดการและควบคุมคิวและไม่สามารถอัปเดตได้อีกต่อไป |
| ไม่สามารถอัปเดตรายการคิวงานได้ | รายการคิวงานที่กำลังอัปเดตพบข้อผิดพลาดที่ไม่คาดคิด ตรวจสอบข้อความแสดงข้อผิดพลาดเพื่อดูรายละเอียดเพิ่มเติม |
เพิ่มรายการคิวงาน
การดำเนินการ เพิ่มรายการคิวงาน ช่วยผู้ใช้เติมข้อมูลรายการคิวงานลงในคิวงานซึ่งได้รับการตั้งค่าในพอร์ทัลโฟลว์
Enqueueworkqueueitemaction
การดำเนินการ เพิ่มรายการคิวงาน จำเป็นต้องมีอาร์กิวเมนต์ต่อไปนี้
พารามิเตอร์อินพุต
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|---|
| คิวงาน | ไม่ | ค่าข้อความ | รายการคิวงานที่จะเพิ่มรายการเข้าไป | |
| ลำดับความสำคัญ | ไม่ | สูง, ปกติ, ต่ำ | ปกติ | ลำดับความสำคัญในการตั้งค่ารายการคิวงานเป็น |
| ชื่อ | ไม่ | ค่าข้อความ ค่าตัวเลข | ชื่อหรือ ID แบบกำหนดเองสำหรับรายการคิวงานใหม่ | |
| ข้อมูลป้อนเข้า | ไม่ | ค่าข้อความ ค่าตัวเลข | ข้อมูลที่อยู่ในคอลัมน์ค่าที่จะประมวลผล | |
| หมดอายุ | ใช่ | Datetime | ค่าวันที่และเวลาที่กำหนดให้รายการคิวหมดอายุ มิฉะนั้นจะใช้ค่าเริ่มต้นหากมีการตั้งค่าไว้สำหรับคิว | |
| บันทึกย่อของการประมวลผล | ใช่ | ค่าข้อความ ค่าตัวเลข | บันทึกการประมวลผลแบบกำหนดเองที่จะเพิ่มในรายการคิวใหม่ | |
| มีรหัสหรือการอ้างอิงที่ไม่ซ้ำกัน | ใช่ | ค่าข้อความ ค่าตัวเลข | เมื่อเปิดใช้งาน ควรระบุค่าที่ไม่ซ้ำกันภายในคิวนี้ หากเว้นว่างไว้ ระบบจะระบุค่าที่ไม่ซ้ำในรูปแบบ system-<GUID> ให้โดยอัตโนมัติ |
ตัวแปรที่สร้าง
| อาร์กิวเมนต์ | ชนิด | Description |
|---|---|---|
| WorkQueueItem | ไม่ | ข้อมูลที่จัดเก็บไว้สำหรับรายการคิวงานที่กำลังเพิ่ม |
ข้อยกเว้น
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| ไม่พบคิวงาน | ค่าที่ป้อนในพารามิเตอร์คิวงานไม่ถูกต้อง |
| ไม่สามารถเพิ่มรายการในคิวงาน | ไม่สามารถเพิ่มรายการคิวงานลงในคิวงานได้ คำขอไม่ถูกต้อง - ข้อผิดพลาดในไวยากรณ์ของแบบสอบถาม |
เพิ่มรายการคิวงานหลายรายการ
การดำเนินการ เพิ่มรายการคิวงานหลายรายการ ช่วยให้ผู้ใช้สามารถเพิ่มรายการคิวงานอย่างน้อยหนึ่งรายการลงในคิวงานตามข้อมูลที่ให้ไว้เป็นตารางข้อมูลรายการคิวงาน
การดำเนินการนี้จำเป็นต้องมีตารางข้อมูลแบบกำหนดเองที่เก็บรายการคิวงานอย่างน้อยหนึ่งรายการ ตารางข้อมูลต้องมีแปดคอลัมน์และสอดคล้องกับสคีมาต่อไปนี้:
| ชื่อคอลัมน์ | Description | ต้องมี | ค่าที่อนุญาต |
|---|---|---|---|
| Name | ชื่อของรายการ | ไม่ | สตริงตัวอักษรและตัวเลขใดๆ |
| การป้อนข้อมูล | ป้อนรายละเอียดหรือข้อมูลของรายการ | ใช่ | สตริงตัวอักษรและตัวเลขใดๆ |
| หมดอายุใน | ระบุระยะเวลาจนกว่ารายการจะหมดอายุ | ไม่ | ค่าวันที่และเวลา |
| บันทึกย่อของการประมวลผล | บันทึกย่อการประมวลผลที่เกี่ยวข้องกับรายการ | ไม่ | สตริงตัวอักษรและตัวเลขใดๆ |
| ลำดับความสำคัญ | ลำดับความสำคัญของรายการ | ใช่ | ค่าตัวเลขของ 100 (สูง), 200 (ปกติ), 300 (ต่ำ) |
| การอ้างอิงเฉพาะ | รหัสเฉพาะหรือค่าอ้างอิงสำหรับรายการ | ไม่ | สตริงตัวอักษรและตัวเลขหรือการอ้างอิงเฉพาะ |
| Status | สถานะของรายการเมื่อรับเข้า | ใช่ | ค่าตัวเลขของศูนย์ (อยู่ในคิว), หนึ่ง (ระงับ) |
| หน่วงเวลาจนถึง | ระบุวันที่และเวลาจนกว่ารายการคิวงานควรถูกละเว้นสำหรับการประมวลผล | ไม่ | ค่าวันที่และเวลา |
ส่วนย่อยของโค้ด Robin สำหรับการสร้างตารางข้อมูล
ตัวอย่างต่อไปนี้เป็นส่วนย่อยของโค้ด Robin (ที่ใช้ในโฟลว์แบบดั้งเดิม) ที่คุณสามารถคัดลอกและวางลงในหน้าต่างตัวออกแบบเดสก์ท็อป Power Automate ได้โดยตรง ส่วนย่อยนี้จะเพิ่มการดำเนินการ สร้างตารางข้อมูลใหม่ พร้อมชุดฟิลด์ที่คาดไว้ลงในโฟลว์ของคุณ
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $'''''', $''''''] } DataTable=> DataTable
ส่วนย่อยของโค้ด PowerFx สำหรับการสร้างตารางข้อมูล
ตัวอย่างต่อไปนี้เป็นส่วนย่อยของโค้ด PowerFx ที่คุณสามารถคัดลอกและวางลงในหน้าต่างตัวออกแบบเดสก์ท็อป Power Automate ได้โดยตรง ส่วนย่อยนี้จะเพิ่มการดำเนินการ สร้างตารางข้อมูลใหม่ พร้อมชุดฟิลด์ที่คาดไว้ลงในโฟลว์ของคุณ
Variables.CreateNewDatatable InputTable: { ^['Name', 'Input', 'Expires in', 'Processing notes', 'Priority', 'Unique reference', 'Status', 'Delay until'], [$fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx'', $fx''] } DataTable=> DataTable
Batchenqueueworkqueueitemsaction
การดำเนินการ เพิ่มรายการคิวงานหลายรายการ จำเป็นต้องมีอาร์กิวเมนต์ต่อไปนี้
พารามิเตอร์อินพุต
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|---|
| คิวงาน | ไม่ | ค่าข้อความ | รายการคิวงานที่จะเพิ่มรายการเข้าไป | |
| ข้อมูลรายการคิวงาน | ใช่ | ตารางข้อมูล | ตารางข้อมูลแบบกำหนดเองที่เก็บรายการคิวงานที่จะเพิ่มลงในคิวงาน |
ตัวแปรที่สร้าง
| อาร์กิวเมนต์ | ชนิด | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|
| FailedWorkQueueItems | ไม่ | เปิดใช้งาน | หากมีความล้มเหลว ออบเจ็กต์นี้จะเก็บดัชนีของรายการที่ไม่สามารถแทรกพร้อมกับรหัสข้อผิดพลาด ดัชนีที่ส่งกลับคือตำแหน่ง (ดัชนี) ของรายการในตารางข้อมูลคิวงานที่ให้ไว้ของการดำเนินการ เพิ่มรายการคิวงานหลายรายการ |
| HasFailedItems | ไม่ | เปิดใช้งาน | ตัวบ่งชี้ว่าการดำเนินการพบข้อผิดพลาดในการนำเข้าเนื่องจากปัญหาข้อมูลรายการคิวงานหรือไม่ |
| SuccessfulWorkQueueItems | Disabled | ไม่ | ออบเจ็กต์แบบกำหนดเองที่เก็บดัชนีและรายการคิวงานที่เพิ่มเข้าในคิวงานได้สำเร็จ |
ข้อยกเว้น
| อาร์กิวเมนต์ | Description |
|---|---|
| ไม่พบคิวงาน | ค่าที่ป้อนในพารามิเตอร์คิวงานไม่ถูกต้อง |
| คิวงานหยุดชั่วคราวหรือหยุดทำงาน | ไม่สามารถเพิ่มรายการคิวงานลงในคิวงานได้เนื่องจากคิวงานถูกหยุดชั่วคราวหรือถูกหยุด |
| ไม่สามารถจัดคิวรายการของรายการคิวงานเป็นชุดงานได้ | ไม่สามารถเพิ่มรายการคิวงานลงในคิวงานได้เนื่องจากข้อผิดพลาดของคำขอหรือการสื่อสาร |
จัดคิวรายการใหม่พร้อมการหน่วงเวลา
การดำเนินการ เข้าคิวใหม่ที่มีความล่าช้า ทำให้ผู้ใช้สามารถเพิ่มรายการคิวที่กำลังประมวลผลในโฟลว์เดสก์ท็อปกลับเข้าไปในคิวเริ่มต้นได้ นอกจากนี้ รายการที่จัดคิวแล้วสามารถระงับและปล่อยได้จนกว่าจะถึงเวลาที่กำหนด
Requeueworkqueueitemaction
การดำเนินการ จัดคิวรายการใหม่พร้อมการหน่วงเวลา ต้องการอาร์กิวเมนต์ต่อไปนี้
พารามิเตอร์อินพุต
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|---|
| รายการคิวงาน | ไม่ | รายการคิวงาน | รายการคิวงานที่จะเพิ่มรายการเข้าไป | |
| หน่วงเวลาจนถึง | ไม่ | ค่าวันที่และเวลา | ปกติ | ค่าวันที่เวลาที่ใช้เพื่อหน่วงเวลารายการคิวจนกระทั่ง |
| หมดอายุ | ใช่ | ค่าวันที่และเวลา | เวลาหมดอายุที่กำหนดเองสำหรับรายการที่กำลังจัดคิวใหม่ | |
| บันทึกย่อของการประมวลผล | ใช่ | ค่าข้อความ ค่าตัวเลข | บันทึกการประมวลผลแบบกำหนดเองที่จะเพิ่มในรายการคิวใหม่ | |
| ล้างบันทึกย่อของการประมวลผล | ใช่ | Boolean | False | เมื่อเปิดใช้งาน ระบบจะซ่อนล้างฟิลด์บันทึกย่อการประมวลผลบนหน้าจอนี้ และลบบันทึกย่อการประมวลผลใดๆ ออกจากฐานข้อมูลที่บันทึกไว้ก่อนหน้านี้สำหรับรายการนี้ |
ข้อยกเว้น
| อาร์กิวเมนต์ | Description |
|---|---|
| ไม่พบคิวงาน | ค่าที่ป้อนในพารามิเตอร์คิวงานไม่ถูกต้อง |
| ไม่พบรายการคิวงาน | ค่ารายการคิวไม่ถูกต้อง |
| ไม่สามารถเข้าคิวใหม่ให้กับรายการคิวงานได้ | ไม่สามารถเพิ่มรายการคิวงานลงในคิวงานได้ คำขอไม่ถูกต้อง - ข้อผิดพลาดในไวยากรณ์ของแบบสอบถาม |
อัปเดตบันทึกย่อการประมวลผลรายการคิวงาน
การดำเนินการ อัปเดตบันทึกย่อการประมวลผลรายการคิวงาน ทำให้ผู้ใช้สามารถอัปเดตหรือล้างบันทึกย่อการประมวลผลของรายการคิวงานที่เลือกได้โดยไม่ต้องเปลี่ยนสถานะหรือคุณสมบัติอื่นใด
updateprocessingnotesaction
การดำเนินการ อัปเดตบันทึกย่อการประมวลผลของรายการคิวงาน จำเป็นต้องมีอาร์กิวเมนต์ต่อไปนี้
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|---|
| รายการคิวงาน | ไม่ | ข้อความ | ตัวแปรรายการคิวงานที่ถูกส่งคืนก่อนหน้านี้โดยผู้จัดเตรียมคิว | |
| บันทึกย่อของการประมวลผล | ใช่ | ข้อความ | ผลลัพธ์หรือค่าการประมวลผลแบบกำหนดเองเพื่อต่อท้ายรายการคิวที่กำลังประมวลผล | |
| ล้างบันทึกย่อของการประมวลผล | ใช่ | Boolean | False | เมื่อเปิดใช้งาน ระบบจะซ่อนและล้างฟิลด์บันทึกย่อการประมวลผลบนหน้าจอนี้ และลบบันทึกย่อการประมวลผลใดๆ ออกจากฐานข้อมูลที่บันทึกไว้ก่อนหน้านี้สำหรับรายการนี้ |
ข้อยกเว้น
| อาร์กิวเมนต์ | Description |
|---|---|
| ไม่พบคิวงาน | คิวงานที่เกี่ยวข้องกับรายการถูกลบไปแล้วหรือไม่สามารถเข้าถึงได้อีกต่อไป |
| ไม่พบรายการคิวงาน | รายการคิวงานไม่ถูกต้อง |
| ไม่สามารถผนวกผลการประมวลผล | รายการคิวงานที่กำลังอัปเดตพบข้อผิดพลาดที่ไม่คาดคิด ตรวจสอบข้อความแสดงข้อผิดพลาดเพื่อดูรายละเอียดเพิ่มเติม |
เรียกรายการคิวงานตามตัวกรอง
การดำเนินการ รับรายการคิวงานตามตัวกรอง ช่วยให้ผู้ใช้สามารถเรียกข้อมูลรายการคิวงานอย่างน้อยหนึ่งรายการตามนิพจน์ตัวกรอง FetchXML
Getworkqueueitemsaction
การดำเนินการ รับรายการคิวงานตามตัวกรอง จำเป็นต้องมีอาร์กิวเมนต์ต่อไปนี้
พารามิเตอร์อินพุต
| อาร์กิวเมนต์ | ระบุหรือไม่ก็ได้ | ยอมรับ | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|---|
| คิวงาน | ไม่ | ข้อความ | คิวงานที่จะใช้เรียกดูรายการ | |
| กรองแถว | ไม่ | ข้อความ | นิพจน์การสอบถาม FetchXML ที่ใช้ในการดึงข้อมูลรายการจากคิวงาน | |
| จำนวนแถวที่จะแสดง | ไม่ | ตัวเลข | 5000 | จำนวนสูงสุดของรายการคิวงานที่ส่งคืนโดยตัวประสานรวม |
ตัวแปรที่สร้าง
| อาร์กิวเมนต์ | ชนิด | ค่าตามค่าเริ่มต้น | Description |
|---|---|---|---|
| WorkQueueItems | ไม่ | เปิดใช้งาน | รายการของคิวงานที่ตรงกับนิพจน์ตัวกรอง |
ข้อยกเว้น
| อาร์กิวเมนต์ | Description |
|---|---|
| คิวงาน | คิวงานที่จะใช้เรียกดูรายการ |
| กรองแถว | นิพจน์การสอบถาม FetchXML ที่ใช้ในการดึงข้อมูลรายการจากคิวงาน |
| จำนวนแถวที่จะแสดง | จำนวนสูงสุดของรายการคิวงานที่ส่งคืนโดยตัวประสานรวม (ค่าเริ่มต้นคือ 5,000) |
การสอบถาม FetchXML คืออะไร
Microsoft Dataverse FetchXML เป็นภาษาที่ใช้สำหรับการดึงข้อมูลจากฐานข้อมูล Dataverse ซึ่งออกแบบมาให้สร้าง ใช้งาน และทำความเข้าใจได้ง่าย ตัวอย่างเช่น คุณอาจต้องการขอให้ Dataverse แสดงรายการคิวงานทั้งหมดที่อยู่ในสถานะ IT Exception
หากต้องการจำกัดการสนับสนุนการสอบถาม FetchXml ในการดึงข้อมูลรายการคิวงาน เราสนับสนุนเฉพาะชุดข้อกำหนดและนิพจน์ FetchXml ที่จำกัดเท่านั้น ข้อกำหนดและนิพจน์เหล่านี้รวมถึงแอตทริบิวต์ ตัวกรอง เงื่อนไข และนิพจน์การสั่งซื้อ ซึ่งทั้งหมดจำกัดอยู่ในตารางรายการคิวงาน (workqueueitem) คุณต้องระบุอย่างชัดเจนว่าคุณสมบัติใดที่จะส่งคืนจากตารางรายการคิวงานและลำดับการจัดเรียงที่ต้องการ
ตัวอย่างการสอบถาม FetchXML
ตัวอย่างต่อไปนี้เป็นนิพจน์การสอบถามสำหรับวิธีการดึงข้อมูลคุณสมบัติต่างๆ กรองรายการที่ผิดพลาดที่ทำเครื่องหมายเป็น IT Exceptions และเรียงลำดับผลลัพธ์ตามเรกคอร์ดเหล่านั้นที่หมดอายุก่อน (FEFO)
<attribute name="statecode" />
<attribute name="uniqueidbyqueue" />
<attribute name="createdon" />
<attribute name="completedon" />
<attribute name="workqueueitemid" />
<attribute name="executioncontext" />
<attribute name="name" />
<attribute name="expirydate" />
<attribute name="processingresult" />
<attribute name="priority" />
<attribute name="statuscode" />
<attribute name="modifiedon" />
<attribute name="processingstarttime" />
<attribute name="retrycount" />
<attribute name="requeuecount" />
<attribute name="input" />
<attribute name="delayuntil" />
<filter type="and">
<condition attribute="statecode" operator="eq" value="4" />
<condition attribute="statuscode" operator="eq" value="5" />
<condition attribute="expirydate" operator="on-or-before" value="2024-10-18" />
</filter>
<order attribute="expirydate" descending="false" />
รายละเอียดการสนับสนุนการสอบถามและข้อมูลอ้างอิง
- รายชื่อ ตัวดำเนินการการสอบถาม ที่พร้อมใช้งาน รวมถึงตัวดำเนินการ เช่น ในหรือก่อน ระหว่าง และเดือนสุดท้าย
- รายการแอตทริบิวต์ที่มีอยู่ใน ตารางรายการคิวงาน
สถานะ (statecode)
| Status | โค้ด | Description |
|---|---|---|
| อยู่ในคิว | 12 | รายการอยู่ในคิว |
| กำลังประมวลผล | 1 | รายการกำลังได้รับการประมวลผล |
| ประมวลผลแล้ว | 2 | รายการได้รับการประมวลผล |
| ระงับ | 3 | รายการถูกระงับ |
| Error | 4 | รายการพบข้อผิดพลาด |
คำอธิบายรายการของสถานะ (statuscode)
| คำอธิบายสถานะ | โค้ด | Description |
|---|---|---|
| อยู่ในคิว | 12 | รายการอยู่ในคิว |
| กำลังประมวลผล | 1 | รายการกำลังได้รับการประมวลผล |
| ประมวลผลแล้ว | 2 | รายการได้รับการประมวลผล |
| OnHold (หยุดชั่วคราว) | 3 | รายการถูกระงับ (หยุดชั่วคราว) |
| ข้อยกเว้นทั่วไป | 4 | รายการพบข้อยกเว้นทั่วไป |
| ข้อยกเว้นด้านไอที | 5 | รายการพบข้อยกเว้นด้าน IT |
| ข้อยกเว้นด้านธุรกิจ | 6 | รายการพบข้อยกเว้นทางธุรกิจ |
| การทำไม่สำเร็จ | 7 | รายการถูกระงับ |
| ProcessingTimeout | 8 | การประมวลผลรายการหมดเวลา |