---

វាលអត្តសញ្ញាណឯកតាដែលបង្កើតឡើងដោយស្វ័យប្រវត្តិបង្កើតអត្តសញ្ញាណឯកតាដែលមានលេខរៀង និងមានភាពឯកតាសម្រាប់កំណត់របស់អ្នក។ វាដំណើរការល្អសម្រាប់ការបង្កើតលេខសំបុត្រ, លេខអត្តសញ្ញាណការបញ្ជាទិញ, លេខវិក្កយបត្រ, ឬប្រព័ន្ធអត្តសញ្ញាណលេខរៀងណាមួយក្នុងការងាររបស់អ្នក។

ឧទាហរណ៍មូលដ្ឋាន

បង្កើតវាលអត្តសញ្ញាណឯកតាដែលមានលេខរៀងដោយស្វ័យប្រវត្តិ៖

mutation CreateUniqueIdField {
  createCustomField(input: {
    name: "Ticket Number"
    type: UNIQUE_ID
    useSequenceUniqueId: true
  }) {
    id
    name
    type
    useSequenceUniqueId
  }
}

ឧទាហរណ៍កម្រិតខ្ពស់

បង្កើតវាលអត្តសញ្ញាណឯកតាដែលមានទ្រង់ទ្រាយជាមួយពាក្យបន្ថែម និងការបន្ថែមសូន្យ៖

mutation CreateFormattedUniqueIdField {
  createCustomField(input: {
    name: "Order ID"
    type: UNIQUE_ID
    description: "Auto-generated order identifier"
    useSequenceUniqueId: true
    prefix: "ORD-"
    sequenceDigits: 4
    sequenceStartingNumber: 1000
  }) {
    id
    name
    type
    description
    useSequenceUniqueId
    prefix
    sequenceDigits
    sequenceStartingNumber
  }
}

ព័ត៌មានបញ្ចូល

CreateCustomFieldInput (UNIQUE_ID)

ព័ត៌មាន	ប្រភេទ	ត្រូវការទេ	សេចក្តីពិពណ៌នា
name	String!	✅ បាទ	ឈ្មោះបង្ហាញនៃវាលអត្តសញ្ញាណឯកតា
type	CustomFieldType!	✅ បាទ	ត្រូវតែជា UNIQUE_ID
description	String	មិនត្រូវការទេ	អត្ថបទជំនួយដែលបង្ហាញទៅអ្នកប្រើ
useSequenceUniqueId	Boolean	មិនត្រូវការទេ	បើកការរៀងជាប្រព័ន្ធដោយស្វ័យប្រវត្តិ (លំនាំដើម: មិនពិត)
prefix	String	មិនត្រូវការទេ	ពាក្យបន្ថែមសម្រាប់អត្តសញ្ញាណដែលបានបង្កើត (ឧ. "TASK-")
sequenceDigits	Int	មិនត្រូវការទេ	ចំនួនលេខសម្រាប់ការបន្ថែមសូន្យ
sequenceStartingNumber	Int	មិនត្រូវការទេ	លេខចាប់ផ្តើមសម្រាប់លេខរៀង

ជម្រើសកំណត់

ការរៀងដោយស្វ័យប្រវត្តិ (useSequenceUniqueId)

• ពិត: បង្កើតអត្តសញ្ញាណលេខរៀងដោយស្វ័យប្រវត្តិពេលកំណត់ត្រូវបានបង្កើត
• មិនពិត ឬ មិនបានកំណត់: ត្រូវការបញ្ចូលដោយដៃ (ដំណើរការដូចជាវាលអត្ថបទ)

ពាក្យបន្ថែម (prefix)

• ពាក្យបន្ថែមជាជម្រើសដែលបានបន្ថែមទៅអត្តសញ្ញាណដែលបានបង្កើតទាំងអស់
• ឧទាហរណ៍: "TASK-", "ORD-", "BUG-", "REQ-"
• មិនមានកំណត់ប្រវែងទេ ប៉ុន្តែរក្សាទុកឱ្យសមរម្យសម្រាប់ការបង្ហាញ

លេខរៀង (sequenceDigits)

• ចំនួនលេខសម្រាប់ការបន្ថែមសូន្យទៅលេខរៀង
• ឧទាហរណ៍: sequenceDigits: 3 បង្កើត 001, 002, 003
• ប្រសិនបើមិនបានកំណត់ មិនមានការបន្ថែមទេ

លេខចាប់ផ្តើម (sequenceStartingNumber)

• លេខដំបូងក្នុងលេខរៀង
• ឧទាហរណ៍: sequenceStartingNumber: 1000 ចាប់ផ្តើមនៅ 1000, 1001, 1002...
• ប្រសិនបើមិនបានកំណត់ ចាប់ផ្តើមនៅ 1 (អាកប្បកិរិយាលំនាំដើម)

ទ្រង់ទ្រាយអត្តសញ្ញាណដែលបានបង្កើត

ទ្រង់ទ្រាយអត្តសញ្ញាណចុងក្រោយបញ្ចូលជម្រើសកំណត់ទាំងអស់៖

{prefix}{paddedSequenceNumber}

ឧទាហរណ៍ទ្រង់ទ្រាយ

ការកំណត់	អត្តសញ្ញាណដែលបានបង្កើត
មិនមានជម្រើស	1, 2, 3
prefix: "TASK-"	TASK-1, TASK-2, TASK-3
sequenceDigits: 3	001, 002, 003
prefix: "ORD-", sequenceDigits: 4	ORD-0001, ORD-0002, ORD-0003
prefix: "BUG-", sequenceStartingNumber: 500	BUG-500, BUG-501, BUG-502
All options combined	TASK-1001, TASK-1002, TASK-1003

ការអានតម្លៃអត្តសញ្ញាណឯកតា

សួរទិន្នន័យជាមួយអត្តសញ្ញាណឯកតា

query GetRecordsWithUniqueIds {
  todos(filter: { projectIds: ["proj_123"] }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
        prefix
        sequenceDigits
      }
      sequenceId    # The generated sequence number
      text         # The text value for UNIQUE_ID fields
    }
  }
}

ទ្រង់ទ្រាយចម្លើយ

{
  "data": {
    "todos": [
      {
        "id": "todo_123",
        "title": "Fix login issue",
        "customFields": [
          {
            "id": "field_value_456",
            "customField": {
              "name": "Ticket Number",
              "type": "UNIQUE_ID",
              "prefix": "TASK-",
              "sequenceDigits": 3
            },
            "sequenceId": 42,
            "text": "TASK-042"
          }
        ]
      }
    ]
  }
}

ការបង្កើតអត្តសញ្ញាណដោយស្វ័យប្រវត្តិ

ពេលណាដែលអត្តសញ្ញាណត្រូវបានបង្កើត

• ការបង្កើតកំណត់: អត្តសញ្ញាណត្រូវបានកំណត់ដោយស្វ័យប្រវត្តិពេលកំណត់ថ្មីត្រូវបានបង្កើត
• ការបន្ថែមវាល: ពេលបន្ថែមវាល UNIQUE_ID ទៅកំណត់ដែលមានស្រាប់ ការងារប្រព័ន្ធត្រូវបានរៀបចំ (ការអនុវត្តន៍កម្មករ​នៅពេលក្រោយ)
• ការប្រតិបត្តិការប្រព័ន្ធក្រោយ: ការបង្កើតអត្តសញ្ញាណសម្រាប់កំណត់ថ្មីកើតឡើងដោយសម្រួលតាមរយៈការជូនដំណឹងក្នុងមូលដ្ឋានទិន្នន័យ

ដំណើរការបង្កើត

1. ការជំរុញ: កំណត់ថ្មីត្រូវបានបង្កើត ឬវាល UNIQUE_ID ត្រូវបានបន្ថែម
2. ការស្វែងរកលេខរៀង: ប្រព័ន្ធស្វែងរកលេខរៀងដែលអាចប្រើបានបន្ទាប់
3. ការចាត់តាំងអត្តសញ្ញាណ: លេខរៀងត្រូវបានចាត់តាំងទៅកំណត់
4. ការអាប់ដេតកំណត់: កំណត់លេខរៀងត្រូវបានបន្ថែមសម្រាប់កំណត់អនាគត
5. ការទ្រង់ទ្រាយ: អត្តសញ្ញាណត្រូវបានទ្រង់ទ្រាយជាមួយពាក្យបន្ថែម និងការបន្ថែមពេលបង្ហាញ

ការធានាអត្តសញ្ញាណឯកតា

• ការកំណត់មូលដ្ឋានទិន្នន័យ: ការកំណត់ឯកតានៅលើលេខរៀងក្នុងមូលដ្ឋានទិន្នន័យនីមួយៗ
• ប្រតិបត្តិការតែមួយ: ការបង្កើតលេខរៀងប្រើការចាក់កំណត់ក្នុងមូលដ្ឋានទិន្នន័យដើម្បីការពារការកកើតឡើង
• ការកំណត់គម្រោង: លេខរៀងមានឯកត្តភាពក្នុងគម្រោងនីមួយៗ
• ការពារបញ្ហាជាមួយការប្រកួត: សំណើរដែលមានគ្នាត្រូវបានគ្រប់គ្រងយ៉ាងសុវត្ថិភាព

របៀបដំណើរការដោយដៃ និងដោយស្វ័យប្រវត្តិ

របៀបដោយស្វ័យប្រវត្តិ (useSequenceUniqueId: true)

• អត្តសញ្ញាណត្រូវបានបង្កើតដោយស្វ័យប្រវត្តិតាមរយៈការជូនដំណឹងក្នុងមូលដ្ឋានទិន្នន័យ
• លេខរៀងត្រូវបានធានាថាមានលេខរៀង
• ការបង្កើតលេខរៀងតែមួយការពារការកកើតឡើង
• អត្តសញ្ញាណដែលបានទ្រង់ទ្រាយបញ្ចូលពាក្យបន្ថែម + លេខរៀងដែលបានបន្ថែម

របៀបដោយដៃ (useSequenceUniqueId: false ឬ undefined)

• ដំណើរការដូចជាវាលអត្ថបទធម្មតា
• អ្នកប្រើអាចបញ្ចូលតម្លៃដែលបានកំណត់ដោយដៃតាមរយៈ setTodoCustomField ជាមួយពាក្យ text
• មិនមានការបង្កើតដោយស្វ័យប្រវត្តិ
• មិនមានការធានាអត្តសញ្ញាណឯកតានៅលើការកំណត់មូលដ្ឋានទិន្នន័យ

ការកំណត់តម្លៃដោយដៃ (របៀបដោយដៃតែប៉ុណ្ណោះ)

ពេល useSequenceUniqueId មិនពិតទេ អ្នកអាចកំណត់តម្លៃដោយដៃ៖

mutation SetUniqueIdValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    text: "CUSTOM-ID-001"
  })
}

វាលចម្លើយ

ចម្លើយ TodoCustomField (UNIQUE_ID)

វាល	ប្រភេទ	សេចក្តីពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់តម្លៃវាល
customField	CustomField!	ការកំណត់វាលដែលបានកំណត់
sequenceId	Int	លេខរៀងដែលបានបង្កើត (បំពេញសម្រាប់វាល UNIQUE_ID)
text	String	តម្លៃអត្ថបទដែលបានទ្រង់ទ្រាយ (បញ្ចូលពាក្យបន្ថែម + លេខរៀងដែលបានបន្ថែម)
todo	Todo!	កំណត់ដែលតម្លៃនេះស្ថិតនៅ
createdAt	DateTime!	ពេលណាតម្លៃនេះត្រូវបានបង្កើត
updatedAt	DateTime!	ពេលណាតម្លៃនេះត្រូវបានអាប់ដេតចុងក្រោយ

ចម្លើយ CustomField (UNIQUE_ID)

វាល	ប្រភេទ	សេចក្តីពិពណ៌នា
useSequenceUniqueId	Boolean	តើការរៀងដោយស្វ័យប្រវត្តិត្រូវបានបើកទេ
prefix	String	ពាក្យបន្ថែមសម្រាប់អត្តសញ្ញាណដែលបានបង្កើត
sequenceDigits	Int	ចំនួនលេខសម្រាប់ការបន្ថែមសូន្យ
sequenceStartingNumber	Int	លេខចាប់ផ្តើមសម្រាប់លេខរៀង

អាជ្ញាប័ណ្ណដែលត្រូវការ

សកម្មភាព	អាជ្ញាប័ណ្ណដែលត្រូវការ
Create unique ID field	OWNER or ADMIN role at project level
Update unique ID field	OWNER or ADMIN role at project level
Set manual value	Standard record edit permissions
View unique ID value	Standard record view permissions

ចម្លើយកំហុស

កំហុសកំណត់វាល

{
  "errors": [{
    "message": "Invalid sequence configuration",
    "extensions": {
      "code": "BAD_USER_INPUT"
    }
  }]
}

កំហុសអាជ្ញាប័ណ្ណ

{
  "errors": [{
    "message": "CustomField not found",
    "extensions": {
      "code": "CUSTOM_FIELD_NOT_FOUND"
    }
  }]
}

កំណត់ចំណាំសំខាន់

អត្តសញ្ញាណដែលបង្កើតឡើងដោយស្វ័យប្រវត្តិ

• អានតែ: អត្តសញ្ញាណដែលបង្កើតឡើងដោយស្វ័យប្រវត្តិមិនអាចកែប្រែដោយដៃបាន
• ថេរ: ពេលដែលបានចាត់តាំង អត្តសញ្ញាណលេខរៀងមិនផ្លាស់ប្តូរ
• តាមលំដាប់: អត្តសញ្ញាណបង្ហាញលំដាប់ការបង្កើត
• មានកំណត់: លេខរៀងមានឯកត្តភាពក្នុងគម្រោងនីមួយៗ

ការពិចារណាអំពីសមត្ថភាព

• ការបង្កើតអត្តសញ្ញាណសម្រាប់កំណត់ថ្មីគឺជាសម្រួលតាមរយៈការជូនដំណឹងក្នុងមូលដ្ឋានទិន្នន័យ
• ការបង្កើតលេខរៀងប្រើ FOR UPDATE ចាក់សម្រាប់ប្រតិបត្តិការតែមួយ
• ប្រព័ន្ធការងារប្រព័ន្ធមាន ប៉ុន្តែការអនុវត្តកម្មករនៅពេលក្រោយ
• ពិចារណាលេខចាប់ផ្តើមសម្រាប់គម្រោងដែលមានបរិមាណខ្ពស់

ការផ្លាស់ប្តូរ និងការអាប់ដេត

• ការបន្ថែមការរៀងដោយស្វ័យប្រវត្តិទៅកំណត់ដែលមានស្រាប់រៀបចំការងារប្រព័ន្ធ (កម្មករនៅពេលក្រោយ)
• ការផ្លាស់ប្តូរការកំណត់លេខរៀងមានឥទ្ធិពលតែទៅកំណត់អនាគត
• អត្តសញ្ញាណដែលមានស្រាប់នៅតែគ្មានការផ្លាស់ប្តូរ ពេលអាប់ដេតកំណត់
• កំណត់លេខរៀងបន្តពីលេខអតិបរមាបច្ចុប្បន្ន

អនុសាសន៍ល្អ

ការរចនាការកំណត់

• ជ្រើសរើសពាក្យបន្ថែមដែលពិពណ៌នាដែលមិននឹងមានការប៉ះពាល់ជាមួយប្រព័ន្ធផ្សេងទៀត
• ប្រើការបន្ថែមលេខសម្រាប់បរិមាណដែលអ្នករំពឹងទុក
• កំណត់លេខចាប់ផ្តើមសមរម្យដើម្បីជៀសវាងការប៉ះពាល់
• សាកល្បងការកំណត់ជាមួយទិន្នន័យគំរូមុនពេលបញ្ចូលប្រើប្រាស់

មគ្គុទេសក៍ពាក្យបន្ថែម

• រក្សាពាក្យបន្ថែមឱ្យខ្លី និងចងចាំបាន (2-5 តួអក្សរ)
• ប្រើតួអក្សរ​ធំសម្រាប់ភាពស្រប
• រួមបញ្ចូលឌីជីត (សញ្ញាដាក់, សញ្ញាដាក់) សម្រាប់ភាពអានយ៉ាងងាយ
• ជៀសវាងតួអក្សរសព្វដែលអាចបង្កើតបញ្ហានៅក្នុង URLs ឬប្រព័ន្ធ

ការធ្វើផែនការលេខរៀង

• ប្រមាណបរិមាណកំណត់របស់អ្នកដើម្បីជ្រើសរើសការបន្ថែមលេខសមរម្យ
• ពិចារណាការលូតលាស់អនាគតពេលកំណត់លេខចាប់ផ្តើម
• រៀបចំសម្រាប់លេខរៀងផ្សេងៗសម្រាប់ប្រភេទកំណត់ផ្សេងៗ
• ឯកសារប្រព័ន្ធអត្តសញ្ញាណរបស់អ្នកសម្រាប់ការយោងរបស់ក្រុម

ករណីប្រើប្រាស់ទូទៅ

1. ប្រព័ន្ធគាំទ្រ

   • លេខសំបុត្រ: TICK-001, TICK-002
   • លេខករណី: CASE-2024-001
   • សំណើរសម្រាប់គាំទ្រ: SUP-001

2. ការគ្រប់គ្រងគម្រោង

   • លេខកិច្ចការ: TASK-001, TASK-002
   • ធាតុ Sprint: SPRINT-001
   • លេខផលិតផល: DEL-001

3. ប្រតិបត្តិការអាជីវកម្ម

   • លេខការបញ្ជាទិញ: ORD-2024-001
   • លេខវិក្កយបត្រ: INV-001
   • ការបញ្ជាទិញ: PO-001

4. ការគ្រប់គ្រងគុណភាព

   • របាយការណ៍កំហុស: BUG-001
   • លេខករណីសាកល្បង: TEST-001
   • លេខពិនិត្យ: REV-001

លក្ខណៈពិសេសនៃការបញ្ចូល

ជាមួយការបង្កើតស្វ័យប្រវត្តិ

• ជំរុញសកម្មភាពពេលអត្តសញ្ញាណឯកតាត្រូវបានចាត់តាំង
• ប្រើលំនាំអត្តសញ្ញាណក្នុងច្បាប់ស្វ័យប្រវត្តិ
• យោងអត្តសញ្ញាណក្នុងគំរូអ៊ីមែល និងការជូនដំណឹង

ជាមួយការស្វែងរក

• យោងអត្តសញ្ញាណឯកតាពីកំណត់ផ្សេងទៀត
• ស្វែងរកកំណត់ដោយអត្តសញ្ញាណឯកតា
• បង្ហាញអត្តសញ្ញាណកំណត់ដែលពាក់ព័ន្ធ

ជាមួយការរាយការណ៍

• ក្រុម និងតម្រងតាមលំនាំអត្តសញ្ញាណ
• តាមដាននិន្នាការចាត់តាំងអត្តសញ្ញាណ
• ត្រួតពិនិត្យការប្រើប្រាស់លេខរៀង និងចន្លោះ

ការកំណត់

• តែលេខរៀង: អត្តសញ្ញាណត្រូវបានចាត់តាំងតាមលំដាប់កាលបរិច្ឆេទ
• គ្មានចន្លោះ: កំណត់ដែលបានលុបចោលទុកចន្លោះក្នុងលេខរៀង
• គ្មានការប្រើប្រាស់ឡើងវិញ: លេខរៀងមិនត្រូវបានប្រើឡើងវិញ
• មានកំណត់គម្រោង: មិនអាចចែករំលែកលេខរៀងនៅក្នុងគម្រោងផ្សេងៗ
• កំណត់ទ្រង់ទ្រាយ: ជម្រើសទ្រង់ទ្រាយមានកំណត់
• គ្មានការអាប់ដេតជាថ្មី: មិនអាចអាប់ដេតលេខរៀងដែលមានស្រាប់ជាថ្មី
• គ្មានយុត្តិធម៌ផ្ទាល់ខ្លួន: មិនអាចអនុវត្តច្បាប់បង្កើតអត្តសញ្ញាណផ្ទាល់ខ្លួន

ឯកសារទាក់ទង

• វាលអត្ថបទ - សម្រាប់អត្តសញ្ញាណអត្ថបទដោយដៃ
• វាលលេខ - សម្រាប់លេខរៀង
• ទិដ្ឋភាពទាំងមូលនៃវាលកំណត់ - គំនិតទូទៅ
• ការបង្កើតស្វ័យប្រវត្តិ - សម្រាប់ច្បាប់ស្វ័យប្រវត្តិដែលផ្អែកលើអត្តសញ្ញាណ