วงจรของป้ายกํากับ

ป้ายกำกับ ฟิลด์ และตัวเลือกจะผ่านสถานะที่เฉพาะเจาะจงตลอดอายุการใช้งาน นอกจากนี้ ป้ายกำกับอาจมีการแก้ไขที่แตกต่างกัน แผนภาพต่อไปนี้แสดงวงจรของป้ายกำกับ รวมถึงการแก้ไขเวอร์ชัน

แผนภาพวงจรการใช้งานป้ายกำกับ
รูปที่ 3 วงจรของป้ายกำกับ
  1. สร้างป้ายกำกับ (create()) - ระบบจะสร้างป้ายกำกับและจัดเก็บไว้ใน ฐานข้อมูลเป็น revision_id=1 ป้ายกำกับมีสถานะเป็น UNPUBLISHED_DRAFT ในรัฐนี้
    • ผู้ใช้ดูป้ายกำกับไม่ได้
    • ผู้ใช้จะใช้ป้ายกำกับกับรายการในไดรฟ์ไม่ได้
  2. (ไม่บังคับ) อัปเดตป้ายกำกับ ฟิลด์ หรือตัวเลือก (delta()) - การอัปเดตทุกครั้ง แม้จะยังไม่ได้เผยแพร่จะได้รับการจัดเก็บไว้ในฐานข้อมูล และการแก้ไขของป้ายกำกับ จะเพิ่มขึ้น
  3. เผยแพร่ป้ายกำกับ (publish()) - ป้ายกำกับมีสถานะเป็น PUBLISHED และ ผู้ใช้สามารถใช้ป้ายกำกับได้ การเผยแพร่ป้ายกำกับจะเพิ่มการแก้ไข
  4. (ไม่บังคับ) อัปเดตป้ายกำกับ ฟิลด์ หรือตัวเลือก (delta()) - ระบบจะอัปเดตป้ายกำกับ ฟิลด์ หรือตัวเลือก แล้วจัดเก็บไว้ในฐานข้อมูลเป็นป้ายกำกับฉบับร่าง ป้ายกำกับมีสถานะเป็น PUBLISHED โดย hasUnpublishedChanges=true หมายความว่า มีการเปลี่ยนแปลงฉบับร่าง แต่ผู้ใช้จะใช้งานไม่ได้ การอัปเดตแต่ละครั้ง จะเพิ่มการแก้ไขป้ายกำกับ
  5. (ไม่บังคับ) เผยแพร่ป้ายกำกับ (publish()) - หากมี ระบบจะเผยแพร่ฉบับร่างล่าสุด ป้ายกำกับมีสถานะเป็น PUBLISHED และผู้ใช้สามารถ ใช้ป้ายกำกับได้ การเผยแพร่ป้ายกำกับจะเพิ่มเวอร์ชันของป้ายกำกับ
  6. ปิดใช้ป้ายกำกับ (disable()) - ป้ายกำกับมีสถานะเป็น DISABLED แม้ว่าผู้ใช้จะใช้ป้ายกำกับผ่าน API ได้ก็ตาม อย่างไรก็ตาม ป้ายกำกับที่ปิดใช้จะไม่แสดงใน UI เว้นแต่จะกำหนดค่าให้แสดง การเลิกใช้งานป้ายกำกับ จะเพิ่มการแก้ไข
  7. เปิดใช้ป้ายกำกับ (enable()) - ระบบจะเปลี่ยนป้ายกำกับเป็นสถานะ PUBLISHED และผู้ใช้จะใช้ป้ายกำกับได้ การเผยแพร่ป้ายกำกับจะเพิ่มการแก้ไข
  8. ลบป้ายกำกับ (delete()) - ป้ายกำกับมีสถานะเป็น DELETED และ ใช้ไม่ได้ ระบบจะล้างข้อมูลป้ายกำกับที่ลบในที่สุด

โปรดทราบว่าการอัปเดตป้ายกำกับทุกครั้งจะเพิ่มการแก้ไขของป้ายกำกับ และหากเผยแพร่ป้ายกำกับไปแล้ว การเผยแพร่อีกครั้ง หลังจากอัปเดต n ครั้งหมายความว่าหมายเลขการแก้ไขที่เผยแพร่จะเป็นการแก้ไข + n + 1 จำนวนการอัปเดตที่ต่อเนื่อง