การใช้งาน Execute Sub-workflow

เอกสารประกอบสำหรับ node Execute Sub-workflow ใน n8n ซึ่งเป็นแพลตฟอร์มอัตโนมัติของ workflow รวมถึงคำแนะนำในการใช้งาน และลิงก์ไปยังตัวอย่าง

ใช้ node Execute Sub-workflow เพื่อรัน workflow อื่นบนเครื่องโฮสต์ที่รัน n8n

parameter node

Source

เลือกว่า node ควรรับข้อมูลของ workflow ย่อยจากที่ใด:

• Database : เลือกตัวเลือกนี้เพื่อโหลด workflow จากฐานข้อมูลตาม ID คุณต้องป้อนอย่างใดอย่างหนึ่ง:
  • From list : เลือก workflow จากรายการ workflow ที่มีให้กับบัญชีของคุณ
  • Workflow ID : ป้อน ID สำหรับ workflow URL ของ workflow มี ID ตามหลัง /workflow/ . ตัวอย่างเช่น ถ้า URL ของ workflow เป็น https://my-n8n-acct.app.n8n.cloud/workflow/abCDE1f6gHiJKL7 , ที่ Workflow ID คือ abCDE1f6gHiJKL7.
• Local File : เลือกตัวเลือกนี้เพื่อโหลด workflow จากไฟล์ JSON ที่บันทึกไว้ในเครื่อง คุณต้องป้อน:
  • Workflow Path : ป้อนเส้นทางไปยังไฟล์ workflow JSON ในเครื่องที่คุณต้องการให้ node ดำเนินการ
• Parameter : เลือกตัวเลือกนี้เพื่อโหลด workflow จาก parameter คุณต้องป้อน:
  • Workflow JSON : ป้อนโค้ด JSON ที่คุณต้องการให้ node ดำเนินการ
• URL : เลือกตัวเลือกนี้เพื่อโหลด workflow จาก URL คุณต้องป้อน:
  • Workflow URL : ป้อน URL ที่คุณต้องการโหลด workflow

Workflow Inputs

หากคุณเลือก workflow ย่อยโดยใช้ ฐานข้อมูล (database) และ From list ตัวเลือก รายการ input ของ workflow ย่อยจะแสดงโดยอัตโนมัติ พร้อมให้คุณกรอกหรือจับคู่ค่า

คุณสามารถเลือกลบรายการ input ที่ร้องขอได้ ซึ่งในกรณีนี้ workflow ย่อยจะได้รับ null เป็นมูลค่าของรายการ คุณยังสามารถเปิดใช้งานได้ พยายามแปลงประเภท (Attempt to convert types) เพื่อพยายามแปลงข้อมูลเป็นประเภทที่ร้องขอของรายการ workflow ย่อยโดยอัตโนมัติ

รายการ input จะไม่ปรากฏขึ้นหาก trigger node input workflow ของ workflow ย่อยใช้โหมดข้อมูล input "ยอมรับข้อมูลทั้งหมด"

Mode

ใช้ parameter นี้เพื่อควบคุมโหมดการดำเนินการสำหรับ node เลือกจากตัวเลือกเหล่านี้:

• วิ่งครั้งเดียวกับทุกรายการ (Run once with all items) : ส่งรายการ input ทั้งหมดไปยังการดำเนินการ node เดียว
• เรียกใช้หนึ่งครั้งสำหรับแต่ละรายการ (Run once for each item) : ดำเนินการ node หนึ่งครั้งสำหรับแต่ละรายการ input ตามลำดับ

ตัวเลือก node

node นี้มีทางเลือกเดียว: Wait for Sub-Workflow Completion . ซึ่งช่วยให้คุณควบคุมได้ว่า workflow หลักควรรอให้ workflow ย่อยเสร็จสิ้นก่อนที่จะไปยังขั้นตอนถัดไป (เปิดอยู่) หรือว่า workflow หลักควรดำเนินการต่อโดยไม่รอ (ปิดอยู่)

เทมเพลตและตัวอย่าง

เรียกดูเทมเพลตการรวม workflow ย่อยที่ดำเนินการ หรือ ค้นหาเทมเพลตทั้งหมด

ตั้งค่าและใช้ workflow ย่อย

ส่วนนี้จะอธิบายเกี่ยวกับการตั้งค่าทั้ง workflow หลักและ workflow ย่อย

สร้าง workflow ย่อย (Create the sub-workflow)

1. สร้าง workflow ใหม่
   

   สร้าง workflow ย่อยจาก workflow ที่มีอยู่ (Create sub-workflows from existing workflows)

   คุณสามารถเลือกสร้าง workflow ย่อยได้โดยตรงจาก workflow หลักที่มีอยู่โดยใช้ Execute Sub-workflow node ใน node เลือกไฟล์ Database และ From list ตัวเลือกและเลือก สร้าง workflow ย่อย (Create a sub-workflow) ในรายการ

   คุณยังสามารถแยก node ที่เลือกได้โดยตรงโดยใช้ การแปลง workflow ย่อย ในเมนูบริบท

2. Optional : กำหนดค่า workflow ใดที่สามารถเรียก workflow ย่อยได้:

   1. เลือก Options เมนู > Settings . n8n เปิดไฟล์ การตั้งค่า workflow (Workflow settings) เป็นกิริยาช่วย
   2. เปลี่ยน workflow นี้สามารถเรียกได้โดย (This workflow can be called by) การตั้งค่า อ้างถึง การตั้งค่า workflow สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่า workflow ของคุณ

3. เพิ่ม Execute Sub-workflow trigger node (หากคุณกำลังค้นหาภายใต้ trigger node สิ่งนี้ก็มีชื่อเช่นกัน เมื่อดำเนินการโดย workflow อื่น (When Executed by Another Workflow)).

4. ตั้งค่า โหมดข้อมูลเข้า (Input data mode) เพื่อเลือกวิธีที่คุณจะกำหนดข้อมูล input ของ workflow ย่อย:

   • กำหนดโดยใช้ช่องด้านล่าง (Define using fields below) : เลือกโหมดนี้เพื่อกำหนดชื่อ input และประเภทข้อมูลที่ workflow การโทรจำเป็นต้องมี ที่ Execute Sub-workflow หรือ Call n8n Workflow Tool ใน workflow การโทรจะดึงฟิลด์ที่กำหนดไว้ที่นี่โดยอัตโนมัติ
   • กำหนดโดยใช้ตัวอย่าง JSON (Define using JSON example) : เลือกโหมดนี้เพื่อจัดเตรียม object JSON ตัวอย่างที่แสดงรายการ input ที่คาดหวังและประเภทของรายการเหล่านั้น
   • ยอมรับข้อมูลทั้งหมด (Accept all data) : เลือกโหมดนี้เพื่อยอมรับข้อมูลทั้งหมดโดยไม่มีเงื่อนไข workflow ย่อยจะไม่กำหนดรายการ input ที่จำเป็น workflow ย่อยนี้ต้องจัดการกับความไม่สอดคล้องกันของ input หรือค่าที่หายไป

5. เพิ่ม node อื่นๆ ตามความจำเป็นเพื่อสร้างฟังก์ชัน workflow ย่อยของคุณ

6. บันทึก workflow ย่อย

workflow ย่อยต้องไม่มีข้อผิดพลาด (Sub-workflow mustn't contain errors)

หากมีข้อผิดพลาดใน workflow ย่อย workflow หลักจะไม่สามารถ trigger ได้

โหลดข้อมูลลงใน workflow ย่อยก่อนสร้าง (Load data into sub-workflow before building)

สิ่งนี้ต้องใช้ความสามารถ โหลดข้อมูลจากการดำเนินการครั้งก่อน ซึ่งพร้อมใช้งานบน n8n Cloud และแผนชุมชนที่ลงทะเบียนแล้ว

หากคุณต้องการโหลดข้อมูลลงใน workflow ย่อยเพื่อใช้ในขณะที่สร้าง:

1. สร้าง workflow ย่อยและเพิ่ม Execute Sub-workflow Trigger.
2. ตั้งค่า node โหมดข้อมูลเข้า (Input data mode) ถึง ยอมรับข้อมูลทั้งหมด (Accept all data) หรือกำหนดรายการ input โดยใช้ฟิลด์หรือ JSON หากทราบอยู่แล้ว
3. ในขั้นตอนการทำงานย่อย การตั้งค่า , ตั้ง บันทึกการดำเนินการผลิตที่ประสบความสำเร็จ (Save successful production executions) ถึง Save.
4. ข้ามไปยังการตั้งค่า workflow หลักและเรียกใช้งาน
5. ทำตามขั้นตอนเพื่อ โหลดข้อมูลจากการดำเนินการครั้งก่อน .
6. ปรับ โหมดข้อมูลเข้า (Input data mode) เพื่อให้ตรงกับ input ที่ส่งโดย workflow หลักหากจำเป็น

ตอนนี้คุณสามารถปักหมุดข้อมูลตัวอย่างใน trigger node ได้ ซึ่งช่วยให้คุณทำงานกับข้อมูลจริงไปพร้อมๆ กับกำหนดค่า workflow ที่เหลือได้

เรียก workflow ย่อย (Call the sub-workflow)

1. เปิด workflow ที่คุณต้องการเรียกใช้ workflow ย่อย

2. เพิ่ม Execute Sub-workflow node

3. ใน Execute Sub-workflow node ให้ตั้งค่า workflow ย่อยที่คุณต้องการโทร คุณสามารถเลือกเรียก workflow ตาม ID โหลด workflow จากไฟล์ในเครื่อง เพิ่ม workflow JSON เป็น parameter ใน node หรือกำหนดเป้าหมาย workflow ตาม URL
   

   ค้นหารหัส workflow ของคุณ (Find your workflow ID)

   ID workflow ย่อยของคุณคือ string ตัวอักษรและตัวเลขที่ส่วนท้ายของ URL

4. กรอกรายการ input ที่จำเป็นซึ่งกำหนดโดย workflow ย่อย

5. บันทึกขั้นตอนการทำงานของคุณ

เมื่อ workflow ของคุณดำเนินการ มันจะส่งข้อมูลไปยัง workflow ย่อยและรันมัน

คุณสามารถติดตามโฟลว์การดำเนินการจาก workflow หลักไปยัง workflow ย่อยได้โดยการเปิด node ดำเนินการ workflow ย่อยและเลือก ดูการดำเนินการย่อย (View sub-execution) ลิงค์ ในทำนองเดียวกัน การดำเนินการของ workflow ย่อยจะมีลิงก์กลับไปยังการดำเนินการของ workflow หลักเพื่อนำทางไปในทิศทางอื่น

ข้อมูลส่งผ่านระหว่าง workflow อย่างไร

ตามตัวอย่าง ลองจินตนาการว่าคุณมี node Execute Sub-workflow อยู่ Workflow A . node Execute Sub-workflow เรียก workflow อื่นที่เรียกว่า Workflow B:

1. node Execute Sub-workflow ส่งข้อมูลไปยัง node Execute Sub-workflow Trigger (ชื่อ "เมื่อดำเนินการโดย node อื่น" ในพื้นที่ทำงาน) ของ Workflow B.
2. node สุดท้ายของ Workflow B ส่งข้อมูลกลับไปยัง node Execute Sub-workflow ใน Workflow A.