---

កន្លែងកំណត់លេខអនុញ្ញាតឱ្យអ្នករក្សាទុកតម្លៃលេខសម្រាប់កំណត់ត្រា។ វាឧបត្ថម្ភកំណត់ការត្រួតពិនិត្យ, ការពិតប្រាកដទសភាគ, ហើយអាចប្រើសម្រាប់ចំនួន, ពិន្ទុ, ការវាស់វែង, ឬទិន្នន័យលេខណាមួយដែលមិនត្រូវការទ្រង់ទ្រាយពិសេស។

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

បង្កើតកន្លែងលេខសាមញ្ញមួយ៖

mutation CreateNumberField {
  createCustomField(input: {
    name: "Priority Score"
    type: NUMBER
    projectId: "proj_123"
  }) {
    id
    name
    type
  }
}

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

បង្កើតកន្លែងលេខជាមួយនឹងកំណត់និងពុម្ព៖

mutation CreateConstrainedNumberField {
  createCustomField(input: {
    name: "Team Size"
    type: NUMBER
    projectId: "proj_123"
    min: 1
    max: 100
    prefix: "#"
    description: "Number of team members assigned to this project"
  }) {
    id
    name
    type
    min
    max
    prefix
    description
  }
}

ប៉ារ៉ាម៉ែត្រ Input

CreateCustomFieldInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
name	String!	✅ បាទ	ឈ្មោះបង្ហាញនៃកន្លែងលេខ
type	CustomFieldType!	✅ បាទ	ត្រូវតែជា NUMBER
projectId	String!	✅ បាទ	អត្តសញ្ញាណនៃគម្រោងដើម្បីបង្កើតកន្លែងនៅក្នុង
min	Float	ទេ	កំណត់តម្លៃអប្បបរមា (ការណែនាំ UI ប៉ុណ្ណោះ)
max	Float	ទេ	កំណត់តម្លៃអតិបរិមា (ការណែនាំ UI ប៉ុណ្ណោះ)
prefix	String	ទេ	ពុម្ពបង្ហាញ (ឧ. "#", "~", "$")
description	String	ទេ	អត្ថបទជំនួយដែលបង្ហាញទៅអ្នកប្រើ

កំណត់តម្លៃលេខ

កន្លែងលេខរក្សាទុកតម្លៃទសភាគជាមួយនឹងការត្រួតពិនិត្យជាជម្រើស៖

តម្លៃលេខសាមញ្ញ

mutation SetNumberValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    number: 42.5
  })
}

តម្លៃគតិ

mutation SetIntegerValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    number: 100
  })
}

SetTodoCustomFieldInput Parameters

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
todoId	String!	✅ បាទ	អត្តសញ្ញាណនៃកំណត់ត្រាដើម្បីធ្វើឱ្យទាន់សម័យ
customFieldId	String!	✅ បាទ	អត្តសញ្ញាណនៃកន្លែងកំណត់លេខ
number	Float	ទេ	តម្លៃលេខដើម្បីរក្សាទុក

កំណត់តម្លៃ

កំណត់អប្បបរមា/អតិបរិមា (ការណែនាំ UI)

សំខាន់: កំណត់អប្បបរមា/អតិបរិមាជាត្រូវបានរក្សាទុក ប៉ុន្តែមិនត្រូវបានអនុវត្តនៅលើម៉ាស៊ីនមេទេ។ វាអនុវត្តជាការណែនាំ UI សម្រាប់កម្មវិធីមុខមាត់។

mutation CreateConstrainedField {
  createCustomField(input: {
    name: "Rating"
    type: NUMBER
    projectId: "proj_123"
    min: 1
    max: 10
    description: "Rating from 1 to 10"
  }) {
    id
    name
    min
    max
  }
}

ត្រូវការការត្រួតពិនិត្យនៅខាងអតិថិជន: កម្មវិធីមុខមាត់ត្រូវតែអនុវត្តន៍យុទ្ធសាស្ត្រត្រួតពិនិត្យដើម្បីអនុវត្តកំណត់អប្បបរមា/អតិបរិមា។

ប្រភេទតម្លៃដែលគាំទ្រ

ប្រភេទ	ឧទាហរណ៍	ការពិពណ៌នា
Integer	42	លេខគ្រប់គ្រាន់
Decimal	42.5	លេខដែលមានទីតាំងទសភាគ
Negative	-10	តម្លៃអវិជ្ជមាន (ប្រសិនបើគ្មានកំណត់អប្បបរមា)
Zero	0	តម្លៃសូន្យ

កំណត់ចំណាំ: កំណត់អប្បបរមា/អតិបរិមាមិនត្រូវបានត្រួតពិនិត្យនៅលើម៉ាស៊ីនមេទេ។ តម្លៃដែលនៅក្រៅស៊ុមដែលបានកំណត់នឹងត្រូវបានទទួល និងរក្សាទុក។

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

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

mutation CreateRecordWithNumber {
  createTodo(input: {
    title: "Performance Review"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "score_field_id"
      number: 85.5
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
        min
        max
        prefix
      }
      number
      value
    }
  }
}

ទ្រង់ទ្រាយ Input ដែលគាំទ្រ

នៅពេលបង្កើតកំណត់ត្រា សូមប្រើប៉ារ៉ាម៉ែត្រ number (មិនមែន value) នៅក្នុងអារ៉េកន្លែងកំណត់៖

customFields: [{
  customFieldId: "field_id"
  number: 42.5  # Use number parameter, not value
}]

វាលឆ្លើយតប

TodoCustomField Response

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

CustomField Response

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

កំណត់ចំណាំ: ប្រសិនបើតម្លៃលេខមិនត្រូវបានកំណត់ វាល number នឹងត្រូវបាន null។

ការការពារ និងសំណួរ

កន្លែងលេខគាំទ្រការការពារទិន្នន័យលេខយ៉ាងទូលំទូលាយ៖

query FilterByNumberRange {
  todos(filter: {
    customFields: [{
      customFieldId: "score_field_id"
      operator: GTE
      number: 80
    }]
  }) {
    id
    title
    customFields {
      number
    }
  }
}

ប្រភេទប្រតិបត្តិការ

ប្រតិបត្តិការ	ការពិពណ៌នា	ឧទាហរណ៍
EQ	ស្មើនឹង	number = 42
NE	មិនស្មើនឹង	number ≠ 42
GT	ធំជាង	number > 42
GTE	ធំជាងឬស្មើ	number ≥ 42
LT	តិចជាង	number < 42
LTE	តិចជាងឬស្មើ	number ≤ 42
IN	នៅក្នុងអារ៉េ	number in [1, 2, 3]
NIN	មិននៅក្នុងអារ៉េ	number not in [1, 2, 3]
IS	គឺទទេ/មិនទទេ	number is null

ការការពារស៊ុម

query FilterByRange {
  todos(filter: {
    customFields: [{
      customFieldId: "priority_field_id"
      operator: GTE
      number: 5
    }]
  }) {
    id
    title
  }
}

ទ្រង់ទ្រាយបង្ហាញ

ជាមួយពុម្ព

ប្រសិនបើមានពុម្ពកំណត់ វានឹងត្រូវបានបង្ហាញ៖

តម្លៃ	ពុម្ព	បង្ហាញ
42	"#"	#42
100	"~"	~100
3.14	"π"	π3.14

ការពិតប្រាកដទសភាគ

លេខរក្សាទុកការពិតប្រាកដទសភាគរបស់ពួកវា៖

Input	Stored	Displayed
42	42.0	42
42.5	42.5	42.5
42.123	42.123	42.123

អាណត្តិដែលត្រូវការ

សកម្មភាព	អាណត្តិដែលត្រូវការ
Create number field	Company role: OWNER or ADMIN
Update number field	Company role: OWNER or ADMIN
Set number value	Any company role (OWNER, ADMIN, MEMBER, CLIENT) or custom project role with edit permission
View number value	Standard record view permissions
Use in filtering	Standard record view permissions

ចម្លើយកំហុស

ទ្រង់ទ្រាយលេខមិនត្រឹមត្រូវ

{
  "errors": [{
    "message": "Invalid number format",
    "extensions": {
      "code": "CUSTOM_FIELD_VALUE_PARSE_ERROR"
    }
  }]
}

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

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

កំណត់ចំណាំ: កំហុសការត្រួតពិនិត្យអប្បបរមា/អតិបរិមាមិនកើតឡើងនៅលើម៉ាស៊ីនមេទេ។ ការត្រួតពិនិត្យកំណត់ត្រូវតែអនុវត្តនៅក្នុងកម្មវិធីមុខមាត់របស់អ្នក។

មិនមែនជាលេខ

{
  "errors": [{
    "message": "Value is not a valid number",
    "extensions": {
      "code": "CUSTOM_FIELD_VALUE_PARSE_ERROR"
    }
  }]
}

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

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

• កំណត់តម្លៃអប្បបរមា/អតិបរិមាដែលមានសមត្ថភាពសម្រាប់ការណែនាំ UI
• អនុវត្តន៍ការត្រួតពិនិត្យនៅខាងអតិថិជនដើម្បីអនុវត្តកំណត់
• ប្រើកំណត់ដើម្បីផ្តល់មតិយោបល់ដល់អ្នកប្រើនៅក្នុងទម្រង់
• ពិចារណាថាតម្លៃអវិជ្ជមានមានសុពលភាពសម្រាប់ករណីប្រើប្រាស់របស់អ្នក

ការពិតប្រាកដនៃតម្លៃ

• ប្រើការពិតប្រាកដទសភាគដែលសមស្របសម្រាប់តម្រូវការរបស់អ្នក
• ពិចារណាការរ៉ោងសម្រាប់គោលបំណងបង្ហាញ
• ត្រូវមានភាពស្របគ្នានៅលើការពិតប្រាកដនៅក្នុងវាលដែលទាក់ទងគ្នា

ការកែលម្អបង្ហាញ

• ប្រើពុម្ពដែលមានអត្ថន័យសម្រាប់បរិបទ
• ពិចារណាអង្គភាពនៅក្នុងឈ្មោះវាល (ឧ. "ទម្ងន់ (គីឡូក្រាម)")
• ផ្តល់ការពិពណ៌នាស្អាតសម្រាប់ច្បាប់ការត្រួតពិនិត្យ

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

1. ប្រព័ន្ធពិន្ទុ

   • ការវាយតម្លៃសមត្ថភាព
   • ពិន្ទុគុណភាព
   • កម្រិតអាទិភាព
   • ការវាយតម្លៃការពេញចិត្តរបស់អតិថិជន

2. ការវាស់វែង

   • ចំនួន និងចំនួន
   • ទំហំ និងទំហំ
   • រយៈពេល (នៅក្នុងទ្រង់ទ្រាយលេខ)
   • សមត្ថភាព និងកំណត់

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

   • លេខប្រាក់ចំណូល
   • អត្រាបំលែង
   • ការចែកចាយថវិកា
   • លេខគោលដៅ

4. ទិន្នន័យបច្ចេកទេស

   • លេខកំណែ
   • តម្លៃកំណត់
   • មាតិកាសមត្ថភាព
   • ការកំណត់សម្រង់

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

ជាមួយតារាង និងផ្ទាំងគំនូរ

• ប្រើកន្លែងលេខក្នុងការគណនាតារាង
• បង្កើតការបង្ហាញលេខ
• តាមដាននិន្នាការនៅលើកាលបរិច្ឆេទ

ជាមួយការប្រព្រឹត្ត

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

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

• បូកលេខពីកំណត់ត្រាទាក់ទង
• គណនាចំនួនសរុប និងមធ្យម
• រកតម្លៃអប្បបរមា/អតិបរិមានៅក្នុងទំនាក់ទំនង

ជាមួយតារាង

• បង្កើតការបង្ហាញលេខ
• តាមដាននិន្នាការនៅលើកាលបរិច្ឆេទ
• ប្រៀបធៀបតម្លៃនៅក្នុងកំណត់ត្រា

ការកំណត់

• មិនមានការត្រួតពិនិត្យនៅលើម៉ាស៊ីនមេ នៃកំណត់អប្បបរមា/អតិបរមា
• ត្រូវការការត្រួតពិនិត្យនៅខាងអតិថិជន សម្រាប់ការអនុវត្តកំណត់
• មិនមានការទ្រង់ទ្រាយប្រាក់ដែលបានបង្កើតឡើង (ប្រើប្រភេទប្រាក់ជំនួស)
• មិនមានសញ្ញាអត្រាអូសស្វ័យប្រវត្តិ (ប្រើប្រភេទភាគរយជំនួស)
• មិនមានសមត្ថភាពបម្លែងអង្គភាព
• ការពិតប្រាកដទសភាគមានកំណត់ដោយប្រភេទទិន្នន័យ Decimal នៅក្នុងមូលដ្ឋានទិន្នន័យ
• មិនមានការវាយតម្លៃសមីការគណិតវិទ្យានៅក្នុងវាលផ្ទាល់

ឯកសារទាក់ទង

• ទិដ្ឋភាពទូទៅនៃកន្លែងកំណត់ - គំនិតទូទៅអំពីកន្លែងកំណត់
• កន្លែងកំណត់ប្រាក់ - សម្រាប់តម្លៃប្រាក់
• កន្លែងកំណត់ភាគរយ - សម្រាប់តម្លៃភាគរយ
• Automations API - បង្កើតការប្រព្រឹត្តដែលមានមូលដ្ឋានលើលេខ