---

វាលផ្ទាំងអត្រាអនុញ្ញាតឱ្យអ្នករក្សាទុកអត្រាឌីជីថលនៅក្នុងកំណត់ត្រាជាមួយតម្លៃអប្បបរមានិងអតិបរមាដែលអាចកំណត់បាន។ វាពេញនិយមសម្រាប់ការអត្រាប្រសិទ្ធភាព, អត្រាសេចក្តីពេញចិត្ត, កម្រិតអាទិភាព, ឬទិន្នន័យដែលមានមូលដ្ឋានលើស្កេឡាឌីជីថលណាមួយនៅក្នុងគម្រោងរបស់អ្នក។

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

បង្កើតវាលអត្រាដែលមានស្កេឡាដើម ០-៥៖

mutation CreateRatingField {
  createCustomField(input: {
    name: "Performance Rating"
    type: RATING
    projectId: "proj_123"
    max: 5
  }) {
    id
    name
    type
    min
    max
  }
}

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

បង្កើតវាលអត្រាដែលមានស្កេឡាដែលកំណត់ដោយខ្លួនឯង និងការពិពណ៌នា៖

mutation CreateDetailedRatingField {
  createCustomField(input: {
    name: "Customer Satisfaction"
    type: RATING
    projectId: "proj_123"
    description: "Rate customer satisfaction from 1-10"
    min: 1
    max: 10
  }) {
    id
    name
    type
    description
    min
    max
  }
}

ប៉ារ៉ាម៉ែត្រ​បញ្ចូល

CreateCustomFieldInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ពិពណ៌នា
name	String!	✅ បាទ	ឈ្មោះបង្ហាញនៃវាលអត្រា
type	CustomFieldType!	✅ បាទ	ត្រូវតែជា RATING
projectId	String!	✅ បាទ	លេខសម្គាល់គម្រោងដែលវាលនេះនឹងត្រូវបានបង្កើត
description	String	ទេ	អត្ថបទជំនួយដែលបង្ហាញទៅអ្នកប្រើ
min	Float	ទេ	តម្លៃអត្រាអប្បបរមា (គ្មានតម្លៃដើម)
max	Float	ទេ	តម្លៃអត្រាអតិបរមា

ការកំណត់តម្លៃអត្រា

ដើម្បីកំណត់ឬធ្វើបច្ចុប្បន្នភាពតម្លៃអត្រានៅលើកំណត់ត្រា៖

mutation SetRatingValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    value: "4.5"
  })
}

SetTodoCustomFieldInput Parameters

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ពិពណ៌នា
todoId	String!	✅ បាទ	លេខសម្គាល់នៃកំណត់ត្រាដែលត្រូវធ្វើបច្ចុប្បន្នភាព
customFieldId	String!	✅ បាទ	លេខសម្គាល់នៃវាលអត្រាដែលកំណត់ដោយខ្លួនឯង
value	String!	✅ បាទ	តម្លៃអត្រាជាអក្សរ (នៅក្នុងជួរដែលកំណត់)

ការបង្កើតកំណត់ត្រាជាមួយតម្លៃអត្រា

ពេលបង្កើតកំណត់ត្រាថ្មីជាមួយតម្លៃអត្រា៖

mutation CreateRecordWithRating {
  createTodo(input: {
    title: "Review customer feedback"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "rating_field_id"
      value: "4.5"
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
        min
        max
      }
      value
    }
  }
}

វាលឆ្លើយតប

TodoCustomField Response

វាល	ប្រភេទ	ពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់តម្លៃវាល
customField	CustomField!	ការកំណត់វាលដែលកំណត់ដោយខ្លួនឯង
value	Float	តម្លៃអត្រាដែលបានរក្សាទុក (ចូលដំណើរការតាមរយៈ customField.value)
todo	Todo!	កំណត់ត្រាដែលតម្លៃនេះមានស្រាប់
createdAt	DateTime!	ពេលដែលតម្លៃត្រូវបានបង្កើត
updatedAt	DateTime!	ពេលដែលតម្លៃត្រូវបានកែប្រែចុងក្រោយ

ចំណាំ: តម្លៃអត្រាត្រូវបានចូលដំណើរការតាមរយៈ customField.value.number ក្នុងសំណើ។

CustomField Response

វាល	ប្រភេទ	ពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់វាល
name	String!	ឈ្មោះបង្ហាញនៃវាលអត្រា
type	CustomFieldType!	តែងតែ RATING
min	Float	តម្លៃអត្រាអប្បបរមាដែលអនុញ្ញាត
max	Float	តម្លៃអត្រាអតិបរមាដែលអនុញ្ញាត
description	String	អត្ថបទជំនួយសម្រាប់វាល

ការត្រួតពិនិត្យអត្រា

ការកំណត់តម្លៃ

• តម្លៃអត្រាត្រូវតែជាលេខ (ប្រភេទ Float)
• តម្លៃត្រូវតែនៅក្នុងជួរអប្បបរមា/អតិបរមាដែលកំណត់
• ប្រសិនបើគ្មានអប្បបរមាត្រូវបានកំណត់ គ្មានតម្លៃដើម
• តម្លៃអតិបរមាគឺជាជម្រើស ប៉ុន្តែបានណែនាំ

ច្បាប់ការត្រួតពិនិត្យ

សំខាន់: ការត្រួតពិនិត្យត្រឹមត្រូវតែកើតឡើងនៅពេលបញ្ជូនទម្រង់ មិនមែននៅពេលប្រើ setTodoCustomField ដោយផ្ទាល់។

• ការបញ្ចូលត្រូវបានបញ្ជាក់ជាលេខទ្រង់ទ្រាយ (ពេលប្រើទម្រង់)
• ត្រូវតែធំជាង ឬស្មើនឹងតម្លៃអប្បបរមា (ពេលប្រើទម្រង់)
• ត្រូវតែតិចជាង ឬស្មើនឹងតម្លៃអតិបរមា (ពេលប្រើទម្រង់)
• setTodoCustomField អាចទទួលយកតម្លៃអក្សរណាមួយដោយគ្មានការត្រួតពិនិត្យ

ឧទាហរណ៍តម្លៃអត្រាត្រឹមត្រូវ

សម្រាប់វាលដែលមានអប្បបរមា=១, អតិបរមា=៥:

1       # Minimum value
5       # Maximum value
3.5     # Decimal values allowed
2.75    # Precise decimal ratings

ឧទាហរណ៍តម្លៃអត្រាដែលមិនត្រឹមត្រូវ

សម្រាប់វាលដែលមានអប្បបរមា=១, អតិបរមា=៥:

0       # Below minimum
6       # Above maximum
-1      # Negative value (below min)
abc     # Non-numeric value

ជម្រើសកំណត់

ការកំណត់ស្កេឡាអត្រា

# 1-5 star rating
mutation CreateStarRating {
  createCustomField(input: {
    name: "Star Rating"
    type: RATING
    projectId: "proj_123"
    min: 1
    max: 5
  }) {
    id
    min
    max
  }
}

# 0-100 percentage rating
mutation CreatePercentageRating {
  createCustomField(input: {
    name: "Completion Percentage"
    type: RATING
    projectId: "proj_123"
    min: 0
    max: 100
  }) {
    id
    min
    max
  }
}

ស្កេឡាអត្រាដែលគេប្រើប្រាស់ជាញឹកញាប់

• ១-៥ ផ្កាយ: min: 1, max: 5
• ០-១០ NPS: min: 0, max: 10
• ១-១០ ប្រសិទ្ធភាព: min: 1, max: 10
• ០-១០០ ភាគរយ: min: 0, max: 100
• ស្កេឡាដែលកំណត់ដោយខ្លួនឯង: ជួរដែលមានលេខណាមួយ

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

ប្រតិបត្តិការវាលកំណត់ដោយអាជ្ញាប័ណ្ណដែលមានមូលដ្ឋានលើតួនាទីស្តង់ដារ៖

សកម្មភាព	តួនាទីដែលត្រូវការ
Create rating field	Project member with appropriate role
Update rating field	Project member with appropriate role
Set rating value	Project member with field edit permissions
View rating value	Project member with view permissions

ចំណាំ: តួនាទីជាក់លាក់ដែលត្រូវការពឹងផ្អែកលើការកំណត់តួនាទីកំណត់ដោយខ្លួនឯងនិងអាជ្ញាប័ណ្ណកម្រិតវាល។

ការឆ្លើយតបកំហុស

កំហុសការត្រួតពិនិត្យ (ទម្រង់តែប៉ុណ្ណោះ)

{
  "errors": [{
    "message": "Validation error message",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

សំខាន់: ការត្រួតពិនិត្យតម្លៃអត្រា (កំណត់អប្បបរមា/អតិបរមា) ត្រឹមតែកើតឡើងនៅពេលបញ្ជូនទម្រង់ មិនមែននៅពេលប្រើ setTodoCustomField ដោយផ្ទាល់។

វាលកំណត់ដោយខ្លួនឯងមិនឃើញ

{
  "errors": [{
    "message": "Custom field was not found.",
    "extensions": {
      "code": "CUSTOM_FIELD_NOT_FOUND"
    }
  }]
}

អនុវត្តន៍ល្អបំផុត

ការរចនាស្កេឡា

• ប្រើស្កេឡាអត្រាដែលមានភាពស្រដៀងគ្នានៅក្នុងវាលដែលស្រដៀងគ្នា
• ពិចារណាអំពីការស្គាល់របស់អ្នកប្រើ (១-៥ ផ្កាយ, ០-១០ NPS)
• កំណត់តម្លៃអប្បបរមាដែលសមស្រប (០ ប្រៀបធៀប ១)
• កំណត់ន័យច្បាស់សម្រាប់កម្រិតអត្រាទាំងអស់

គុណភាពទិន្នន័យ

• ត្រួតពិនិត្យតម្លៃអត្រាមុនពេលរក្សាទុក
• ប្រើភាពត្រឹមត្រូវទ្រង់ទ្រាយយ៉ាងសមស្រប
• ពិចារណាអំពីការកែតម្រូវសម្រាប់គោលបំណងបង្ហាញ
• ផ្តល់ការណែនាំច្បាស់អំពីន័យអត្រា

បទពិសោធន៍អ្នកប្រើ

• បង្ហាញស្កេឡាអត្រាដោយវិជ្ជាជីវៈ (ផ្កាយ, បន្ទាត់កំណត់)
• បង្ហាញតម្លៃបច្ចុប្បន្ននិងកម្រិតស្កេឡា
• ផ្តល់បរិបទសម្រាប់ន័យអត្រា
• ពិចារណាតម្លៃដើមសម្រាប់កំណត់ត្រាថ្មី

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

1. ការគ្រប់គ្រងប្រសិទ្ធភាព

   • អត្រាប្រសិទ្ធភាពនៃបុគ្គលិក
   • អត្រាគុណភាពគម្រោង
   • អត្រាបញ្ចប់ភារកិច្ច
   • ការប៉ាន់ប្រមាណកម្រិតជំនាញ

2. មតិយោបល់ពីអតិថិជន

   • អត្រាសេចក្តីពេញចិត្ត
   • អត្រាគុណភាពផលិតផល
   • អត្រាបទពិសោធន៍សេវាកម្ម
   • អត្រាអ្នកណែនាំសុីស៊ី (NPS)

3. អាទិភាព និងសារៈសំខាន់

   • កម្រិតអាទិភាពភារកិច្ច
   • អត្រាអន្ទាក់
   • អត្រាប៉ាន់ប្រមាណហានិភ័យ
   • អត្រាឥទ្ធិពល

4. ការធានាគុណភាព

   • អត្រាពិនិត្យកូដ
   • អត្រាគុណភាពសាកល្បង
   • គុណភាពឯកសារ
   • អត្រាប្រតិបត្តិការទំនាក់ទំនង

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

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

• បង្កើតសកម្មភាពដោយផ្អែកលើកម្រិតអត្រា
• ផ្ញើការជូនដំណឹងសម្រាប់អត្រាប្រហែល
• បង្កើតភារកិច្ចបន្តសម្រាប់អត្រាខ្ពស់
• ផ្លូវការងារតាមតម្លៃអត្រា

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

• គណនាអត្រាមធ្យមនៅក្នុងកំណត់ត្រា
• ស្វែងរកកំណត់ត្រាដោយជួរអត្រា
• យោងទៅកាន់ទិន្នន័យអត្រាពីកំណត់ត្រាផ្សេងទៀត
• បូកសរុបស្ថិតិអត្រា

ជាមួយផ្នែកមុខងារ Blue

• ការត្រួតពិនិត្យជួរដោយស្វ័យប្រវត្តិនៅក្នុងបរិបទទម្រង់
• គ្រប់គ្រងការបញ្ចូលអត្រាដោយវិជ្ជាជីវៈ
• ការត្រួតពិនិត្យត្រឹមត្រូវនៅពេលពិត
• ជម្រើសបញ្ចូលផ្កាយឬស្លាយ

ការតាមដានសកម្មភាព

ការផ្លាស់ប្តូរវាលអត្រាត្រូវបានតាមដានដោយស្វ័យប្រវត្តិ៖

• តម្លៃអត្រាដែលចាស់និងថ្មីត្រូវបានកត់ត្រា
• សកម្មភាពបង្ហាញការផ្លាស់ប្តូរលេខ
• ម៉ោងសម្រាប់ការអាប់ដេតអត្រាទាំងអស់
• ការចាត់ទុកអ្នកប្រើសម្រាប់ការផ្លាស់ប្តូរ

ការកំណត់

• តម្លៃត្រឹមតែជាលេខប៉ុណ្ណោះដែលគាំទ្រ
• គ្មានការបង្ហាញអត្រាវិជ្ជាជីវៈដែលមានក្នុង (ផ្កាយ, ល។)
• ភាពត្រឹមត្រូវទ្រង់ទ្រាយអាស្រ័យលើការកំណត់មូលដ្ឋានទិន្នន័យ
• គ្មានការរក្សាទុកមេតាតិន្នន័យអត្រា (មតិយោបល់, បរិបទ)
• គ្មានការបូកសរុបអត្រាដោយស្វ័យប្រវត្តិឬស្ថិតិ
• គ្មានការបម្លែងអត្រាដែលមានក្នុងស្កេឡា
• សំខាន់: ការត្រួតពិនិត្យអប្បបរមា/អតិបរមាគឺត្រឹមតែធ្វើការនៅក្នុងទម្រង់ មិនមែនតាមរយៈ setTodoCustomField

ឯកសារដែលទាក់ទង

• វាលលេខ - សម្រាប់ទិន្នន័យលេខទូទៅ
• វាលភាគរយ - សម្រាប់តម្លៃភាគរយ
• វាលជ្រើស - សម្រាប់ការអត្រាជ្រើសជាក់លាក់
• ទិដ្ឋភាពទាំងមូលនៃវាលកំណត់ដោយខ្លួនឯង - គំនិតទូទៅ