---

វាលកំណត់ម៉ាស៊ីនចុចផ្តល់នូវការបញ្ចូលបូកសាមញ្ញ (ពិត/មិនពិត) សម្រាប់ភារកិច្ច។ វាពេញលេញសម្រាប់ជម្រើសពីរនាក់, សញ្ញាស្ថាន, ឬតាមដានថាតើអ្វីមួយត្រូវបានបញ្ចប់ហើយឬអត់។

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

បង្កើតវាលម៉ាស៊ីនចុចសាមញ្ញ:

mutation CreateCheckboxField {
  createCustomField(input: {
    name: "Reviewed"
    type: CHECKBOX
  }) {
    id
    name
    type
  }
}

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

បង្កើតវាលម៉ាស៊ីនចុចជាមួយការពិពណ៌នានិងការត្រួតពិនិត្យ:

mutation CreateDetailedCheckbox {
  createCustomField(input: {
    name: "Customer Approved"
    type: CHECKBOX
    description: "Check this box when the customer has approved the work"
  }) {
    id
    name
    type
    description
  }
}

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

CreateCustomFieldInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
name	String!	✅ បាទ	ឈ្មោះបង្ហាញនៃម៉ាស៊ីនចុច
type	CustomFieldType!	✅ បាទ	ត្រូវតែជា CHECKBOX
description	String	មិន	អត្ថបទជំនួយដែលបង្ហាញទៅអ្នកប្រើ

ការកំណត់តម្លៃម៉ាស៊ីនចុច

ដើម្បីកំណត់ឬអាប់ដេតតម្លៃម៉ាស៊ីនចុចនៅលើភារកិច្ច:

mutation CheckTheBox {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    checked: true
  })
}

ដើម្បីដកចេញម៉ាស៊ីនចុច:

mutation UncheckTheBox {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    checked: false
  })
}

SetTodoCustomFieldInput Parameters

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
todoId	String!	✅ បាទ	ID នៃភារកិច្ចដើម្បីអាប់ដេត
customFieldId	String!	✅ បាទ	ID នៃវាលម៉ាស៊ីនចុចកំណត់
checked	Boolean	មិន	ពិតដើម្បីចុច, មិនពិតដើម្បីដកចេញ

ការបង្កើតភារកិច្ចជាមួយតម្លៃម៉ាស៊ីនចុច

នៅពេលបង្កើតភារកិច្ចថ្មីជាមួយតម្លៃម៉ាស៊ីនចុច:

mutation CreateTaskWithCheckbox {
  createTodo(input: {
    title: "Review contract"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "checkbox_field_id"
      value: "true"  # Pass as string
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      checked
    }
  }
}

តម្លៃខ្សែអក្សរទទួលយក

នៅពេលបង្កើតភារកិច្ច, តម្លៃម៉ាស៊ីនចុចត្រូវតែផ្ទុកជាខ្សែអក្សរ:

តម្លៃខ្សែអក្សរ	លទ្ធផល
"true"	✅ ចុច (អក្សរធ្វើការប្រៀបធៀប)
"1"	✅ ចុច
"checked"	✅ ចុច (អក្សរធ្វើការប្រៀបធៀប)
Any other value	❌ មិនចុច

កំណត់ចំណាំ: ការប្រៀបធៀបខ្សែអក្សរនៅពេលបង្កើតភារកិច្ចគឺអាស្រ័យលើករណី។ តម្លៃត្រូវតែផ្ទៀងផ្ទាត់ជាមួយ "true", "1", ឬ "checked" ដើម្បីបង្កើតស្ថានភាពចុច។

វាលឆ្លើយតប

TodoCustomField Response

វាល	ប្រភេទ	ការពិពណ៌នា
id	ID!	អត្តសញ្ញាណឯកតាសម្រាប់តម្លៃវាល
uid	String!	អត្តសញ្ញាណឯកតាផ្សេងទៀត
customField	CustomField!	ការកំណត់វាលកំណត់
checked	Boolean	ស្ថានភាពម៉ាស៊ីនចុច (ពិត/មិនពិត/ទទេ)
todo	Todo!	ភារកិច្ចដែលតម្លៃនេះជាប់នឹង
createdAt	DateTime!	ពេលដែលតម្លៃត្រូវបានបង្កើត
updatedAt	DateTime!	ពេលដែលតម្លៃត្រូវបានកែប្រែចុងក្រោយ

ការបញ្ចូលស្វ័យប្រវត្តិ

វាលម៉ាស៊ីនចុចបង្កើតព្រឹត្តិការណ៍ស្វ័យប្រវត្តិខុសគ្នាដោយផ្អែកលើការផ្លាស់ប្តូរស្ថានភាព:

សកម្មភាព	ព្រឹត្តិការណ៍ដែលត្រូវបានបង្កើត	ការពិពណ៌នា
Check (false → true)	CUSTOM_FIELD_ADDED	ត្រូវបានបង្កើតនៅពេលម៉ាស៊ីនចុចត្រូវបានចុច
Uncheck (true → false)	CUSTOM_FIELD_REMOVED	ត្រូវបានបង្កើតនៅពេលម៉ាស៊ីនចុចត្រូវបានដកចេញ

នេះអនុញ្ញាតឱ្យអ្នកបង្កើតស្វ័យប្រវត្តិដែលឆ្លើយតបនឹងការផ្លាស់ប្តូរស្ថានភាពម៉ាស៊ីនចុច ដូចជា:

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

ការនាំចូល/នាំចេញទិន្នន័យ

ការនាំចូលតម្លៃម៉ាស៊ីនចុច

នៅពេលនាំចូលទិន្នន័យតាមរយៈ CSV ឬទ្រង់ទ្រាយផ្សេងទៀត:

• "true", "yes" → ចុច (មិនអាស្រ័យលើករណី)
• តម្លៃផ្សេងទៀតណាមួយ (រួមទាំង "false", "no", "0", ទទេ) → មិនចុច

ការនាំចេញតម្លៃម៉ាស៊ីនចុច

នៅពេលនាំចេញទិន្នន័យ:

• ម៉ាស៊ីនចុចដែលបានចុចនាំចេញជា "X"
• ម៉ាស៊ីនចុចដែលមិនបានចុចនាំចេញជា ខ្សែអក្សរទទេ ""

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

សកម្មភាព	អាជ្ញាប័ណ្ណដែលត្រូវការ
Create checkbox field	OWNER or ADMIN role at project level
Update checkbox field	OWNER or ADMIN role at project level
Set checkbox value	Standard task edit permissions (excluding VIEW_ONLY and COMMENT_ONLY roles)
View checkbox value	Standard task view permissions (authenticated users in company/project)

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

ប្រភេទតម្លៃមិនត្រឹមត្រូវ

{
  "errors": [{
    "message": "Invalid value type for checkbox field",
    "extensions": {
      "code": "CUSTOM_FIELD_VALUE_PARSE_ERROR"
    }
  }]
}

វាលមិនបានរកឃើញ

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

អនុសាសន៍ល្អ

ស្តង់ដារឈ្មោះ

• ប្រើឈ្មោះដែលច្បាស់និងមានសកម្មភាព: "បានអនុម័ត", "បានពិនិត្យ", "បានបញ្ចប់"
• ជៀសវាងឈ្មោះអវិជ្ជមានដែលធ្វើឱ្យអ្នកប្រើច្រឡំ: ជ្រើសរើស "មានសកម្មភាព" ជាង "មិនមានសកម្មភាព"
• ត្រូវតែច្បាស់អំពីអ្វីដែលម៉ាស៊ីនចុចតំណាងឱ្យ

ពេលណាដែលគួរប្រើម៉ាស៊ីនចុច

• ជម្រើសពីរនាក់: បាទ/មិនបាទ, ពិត/មិនពិត, បានធ្វើ/មិនបានធ្វើ
• សញ្ញាស្ថាន: បានអនុម័ត, បានពិនិត្យ, បានបោះពុម្ព
• ពាក្យសម្គាល់មុខងារ: មានការគាំទ្រលំដាប់ខ្ពស់, ត្រូវការការចុះហត្ថលេខា
• ការតាមដានសាមញ្ញ: អ៊ីមែលបានផ្ញើ, វិក័យប័ត្របានបង់, ធាតុបានផ្ញើ

ពេលណាដែលមិនគួរប្រើម៉ាស៊ីនចុច

• ពេលដែលអ្នកត្រូវការជម្រើសច្រើនជាងពីរ (ប្រើ SELECT_SINGLE ជំនួស)
• សម្រាប់ទិន្នន័យលេខឬអក្សរ (ប្រើវាលលេខ ឬអក្សរ)
• ពេលដែលអ្នកត្រូវតាមដានថានរណាបានចុចវា ឬពេលណា (ប្រើកំណត់ហេតុ)

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

1. ដំណើរការអនុម័ត

   • "អ្នកគ្រប់គ្រងបានអនុម័ត"
   • "ការចុះហត្ថលេខារបស់អតិថិជន"
   • "ការពិនិត្យផ្នែកច្បាប់បានបញ្ចប់"

2. ការគ្រប់គ្រងភារកិច្ច

   • "ត្រូវបានរាំងខ្ទប់"
   • "ត្រៀមសម្រាប់ពិនិត្យ"
   • "មានអាទិភាពខ្ពស់"

3. ការត្រួតពិនិត្យគុណភាព

   • "QA បានឆ្លើយតប"
   • "ឯកសារបានបញ្ចប់"
   • "ការធ្វើតេស្តបានសរសេរ"

4. សញ្ញាដែលគ្រប់គ្រង

   • "វិក័យប័ត្របានផ្ញើ"
   • "កិច្ចសន្យាបានចុះហត្ថលេខា"
   • "ត្រូវការការតាមដាន"

ការកំណត់

• វាលម៉ាស៊ីនចុចអាចរក្សាតម្លៃពិត/មិនពិតតែប៉ុណ្ណោះ (មិនមានតម្លៃបីស្ថានភាព ឬទទេបន្ទាប់ពីកំណត់ដំបូង)
• មិនមានការកំណត់តម្លៃលំនាំដើម (តែងតែចាប់ផ្តើមជាទទេរហូតដល់បានកំណត់)
• មិនអាចរក្សាទិន្នន័យបន្ថែមដូចជានរណាបានចុចវា ឬពេលណា
• មិនមានការមើលឃើញលើកម្រិតដែលមានលក្ខខណ្ឌដោយផ្អែកលើតម្លៃវាលផ្សេងទៀត

ធនធានដែលពាក់ព័ន្ធ

• ទិដ្ឋភាពទូទៅនៃវាលកំណត់ - គំនិតទូទៅអំពីវាលកំណត់
• Automations API - បង្កើតស្វ័យប្រវត្តិដែលត្រូវបានបង្កើតដោយការផ្លាស់ប្តូរម៉ាស៊ីនចុច