การใช้งาน Confluence

เรียนรู้วิธีใช้ node Confluence ใน n8n ปฏิบัติตามเอกสารทางเทคนิคเพื่อรวม node Confluence เข้ากับ workflow ของคุณ

ใช้ node Confluence เพื่อทำงานอัตโนมัติ เมฆบรรจบกัน และรวมเข้ากับแอปพลิเคชันอื่น ๆ n8n มีการสนับสนุนในตัวสำหรับการสร้าง การอ่าน การอัปเดต และการลบหน้า การทำงานกับป้ายกำกับและความคิดเห็นของหน้า การอัพโหลดและดาวน์โหลดไฟล์แนบ รายการพื้นที่ และการค้นหาเนื้อหาด้วย CQL

ในหน้านี้ คุณจะพบรายการการดำเนินงานที่ node Confluence รองรับ คำแนะนำในการเลือกไซต์และเพจ และลิงก์ไปยังแหล่งข้อมูลเพิ่มเติม

Credentials

node มีสองวิธีในการลงชื่อเข้าใช้ โดยเลือกด้วย Authentication แบบเลื่อนลง:

• Cloud OAuth2 : เข้าสู่ระบบในฐานะบุคคลด้วย Confluence credentials . credentials จะเก็บรหัสไคลเอ็นต์และความลับของแอป OAuth
• Service Account : ลงชื่อเข้าใช้เป็นบัญชีบริการ Atlassian ด้วย Atlassian Service Account credentials สำหรับ workflow แบบอัตโนมัติที่ไม่มีผู้ใช้อยู่ ขอบเขตของ credentials ได้รับการแก้ไขเมื่อสร้างขึ้น และสิทธิ์การใช้พื้นที่จะมีผลที่ด้านบน เช่นเดียวกับผู้ใช้รายอื่น

ด้วยวิธีใดวิธีหนึ่ง คุณจะเลือกไซต์ Confluence ใน node เอง

การเลือกไซต์

ทุกการดำเนินการเริ่มต้นด้วย Site parameter ซึ่งเลือกไซต์ Confluence Cloud ที่จะทำงานกับ:

• เลือกจากรายการ (Pick from a list) (ค่าเริ่มต้น): เลือกจากไซต์ที่การเชื่อมต่อสามารถเข้าถึงได้
• By URL : วางที่อยู่ของเว็บไซต์ เป็นต้น https://example.atlassian.net.
• ปล่อยว่างไว้ (Leave it empty) : หากการเชื่อมต่อสามารถเข้าถึงไซต์เดียวได้ node จะใช้ไซต์นั้นโดยอัตโนมัติ หากสามารถเข้าถึงได้หลายรายการ node จะขอให้คุณเลือกหนึ่งรายการและแสดงรายการเหล่านั้นในข้อผิดพลาด

การเลือกหน้า

การดำเนินการที่กำหนดเป้าหมายเพจเสนอสี่วิธีในการชี้ไปที่เพจ:

• เลือกจากรายการ (Pick from a list) (ค่าเริ่มต้น): ค้นหาหน้าตามชื่อเรื่อง เลือกก Space ก่อนอื่นให้จำกัดรายการให้เหลือช่องว่างหนึ่งช่อง
• By URL : วางลิงค์ของหน้าโดยตรงจากเบราว์เซอร์หรือของ Confluence Share ปุ่ม
• By ID : วางรหัสตัวเลขของหน้า
• By Title : กรอกชื่อเพจ ชื่อต้องตรงกับหนึ่งหน้า เลือกก Space เพื่อกำหนดขอบเขตการค้นหาหากมีหลายหน้าใช้ชื่อร่วมกัน

เนื้อความของหน้า

ประกอบกิจการเขียนเพจหรือแสดงความคิดเห็นเนื้อหาต่างๆ Body Format ทางเลือก:

• Plain Text (ค่าเริ่มต้น): ป้อนข้อความธรรมดา; แต่ละบรรทัดจะกลายเป็นย่อหน้า ไม่จำเป็นต้องมาร์กอัป
• Storage : ป้อน XHTML รูปแบบการจัดเก็บข้อมูล Confluence เป็นต้น <h2>Title</h2><p>Text</p>.
• Atlas Doc Format : ใส่ดิบ รูปแบบเอกสาร Atlassian เอกสาร JSON

การดำเนินการที่อ่านเนื้อหาจะส่งคืนเนื้อหา Storage (ค่าเริ่มต้น) หรือ Atlas Doc Format หรือเป็น Plain Text แยกมาจากเอกสารซึ่งมีประโยชน์สำหรับการป้อนเนื้อหาของหน้าไปยัง AI และ workflow การค้นหา

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

สร้างและเผยแพร่แบบร่างหน้า Confluence

Confluence จะเก็บแบบร่างไว้ถัดจากเวอร์ชันที่เผยแพร่ของเพจ ดังนั้นแบบร่างจะไม่แทนที่สิ่งที่ผู้อ่านเห็น:

• Create ด้วย สร้างเป็นแบบร่าง (Create as Draft) เปิดใช้งานทำให้เพจไม่ได้เผยแพร่ ผู้เขียนเห็นมันในแผนผังอวกาศด้วยก Draft ป้ายสถานะ
• Update ด้วย Status ตั้งค่าเป็น Draft บันทึกการเปลี่ยนแปลงเป็นฉบับร่างที่ไม่ได้เผยแพร่ สิ่งนี้ไม่ได้ยกเลิกการเผยแพร่เพจ หน้าสดจะแสดงเวอร์ชันที่เผยแพร่ล่าสุดต่อไป และ Confluence จะทำเครื่องหมายหน้านั้น การเปลี่ยนแปลงที่ไม่ได้เผยแพร่ (Unpublished changes).

หากต้องการเผยแพร่ฉบับร่าง ให้เรียกใช้ Update กับมันด้วย Status ตั้งค่าเป็น Published.

การดำเนินงาน

• Attachment:
  • ลบ: ย้ายไฟล์แนบไปที่ถังขยะ หรือลบออกอย่างถาวร
  • รับหลายไฟล์: แสดงรายการไฟล์แนบบนหน้า โดยสามารถเลือกดาวน์โหลดไฟล์แต่ละไฟล์ได้
  • อัปโหลด: อัปโหลดไฟล์เป็นไฟล์แนบบนเพจ การอัปโหลดไฟล์ที่มีชื่อเดียวกันกับไฟล์แนบที่มีอยู่จะสร้างไฟล์เวอร์ชันใหม่
• Page:
  • เพิ่มความคิดเห็น: เพิ่มความคิดเห็นส่วนท้ายลงในเพจ หรือตอบกลับความคิดเห็นที่มีอยู่
  • เพิ่มป้ายกำกับ: เพิ่มป้ายกำกับหนึ่งรายการขึ้นไปในเพจ
  • ผนวก: ผนวกเนื้อหาที่ด้านล่างของหน้าที่มีอยู่
  • สร้าง: สร้างเพจใหม่ในพื้นที่ เป็นทางเลือกเป็นแบบร่าง ส่วนตัว ที่รูทของช่องว่าง หรือใต้เพจหลัก
  • ลบ: ย้ายหน้าไปที่ถังขยะหรือลบออกอย่างถาวร หน้าย่อยจะไม่ถูกลบ พวกเขาเลื่อนขึ้นไปที่พาเรนต์ของเพจที่ถูกลบ
  • ลบความคิดเห็น: ลบความคิดเห็นส่วนท้ายอย่างถาวร
  • รับ: ดึงข้อมูลเพจ (เป็นทางเลือกด้วยแผนผังย่อยแบบเต็ม โดยส่งคืนหนึ่งรายการต่อหน้าตามลำดับแผนผัง โดยให้เพจนั้นอยู่ก่อน)
  • รับความคิดเห็น: แสดงรายการความคิดเห็นส่วนท้ายระดับบนสุดบนเพจ
  • รับป้ายกำกับ: แสดงรายการป้ายกำกับบนเพจ
  • รับหลายรายการจากป้ายกำกับ: ดึงข้อมูลหน้าทั้งหมดที่มีป้ายกำกับ สามารถเลือกได้ภายในช่องว่างเดียว
  • ลบป้ายกำกับ: ลบป้ายกำกับออกจากหน้า
  • อัปเดต: แทนที่ชื่อเรื่องและเนื้อหาของเพจที่มีอยู่ หรือเปลี่ยนสถานะแบบร่าง/เผยแพร่
• Search:
  • ข้อความค้นหา: ค้นหาเนื้อหาด้วย ซีคิวแอล แบบสอบถาม โดยเลือกที่จะดึงเนื้อหาเต็มหน้าของผลลัพธ์แต่ละรายการในคำขอเดียวกัน
• Space:
  • รับ: ดึงช่องว่าง
  • รับมากมาย: ดึงช่องว่างจำนวนมาก

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

ค้นหาเทมเพลตทั้งหมด ตัวอย่างการใช้ node นี้

ทรัพยากรที่เกี่ยวข้อง

อ้างถึง เอกสาร Confluence Cloud REST API ของ Atlassian สำหรับข้อมูลเพิ่มเติมเกี่ยวกับบริการ