---

វាលអត្ថបទតែមួយជួរអនុញ្ញាតឱ្យអ្នករក្សាទុកតម្លៃអត្ថបទខ្លីដែលមានគោលបំណងសម្រាប់ការបញ្ចូលតែមួយជួរ។ វាជាការល្អសម្រាប់ឈ្មោះ, ចំណងជើង, ស្លាក, ឬទិន្នន័យអត្ថបទណាមួយដែលគួរត្រូវបានបង្ហាញនៅលើជួរតែមួយ។

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

បង្កើតវាលអត្ថបទតែមួយជួរងាយស្រួល៖

mutation CreateTextSingleField {
  createCustomField(input: {
    name: "Client Name"
    type: TEXT_SINGLE
  }) {
    id
    name
    type
  }
}

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

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

mutation CreateDetailedTextSingleField {
  createCustomField(input: {
    name: "Product SKU"
    type: TEXT_SINGLE
    description: "Unique product identifier code"
  }) {
    id
    name
    type
    description
  }
}

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

CreateCustomFieldInput

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

ចំណាំ: បរិបទគម្រោងត្រូវបានកំណត់ដោយស្វ័យប្រវត្តិពីក្បាលសម្ភាសន៍អត្តសញ្ញាណរបស់អ្នក។ មិនត្រូវការប៉ារ៉ាម៉ែត្រ projectId។

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

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

mutation SetTextSingleValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    text: "ABC-123-XYZ"
  }) {
    id
    customField {
      value  # Returns { text: "ABC-123-XYZ" }
    }
  }
}

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

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
todoId	String!	✅ បាទ	ID នៃកំណត់ត្រាដែលត្រូវធ្វើបច្ចុប្បន្នភាព
customFieldId	String!	✅ បាទ	ID នៃវាលអត្ថបទតែមួយ
text	String	មិនត្រូវការ	មាតិកាអត្ថបទតែមួយជួរដែលត្រូវរក្សាទុក

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

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

mutation CreateRecordWithTextSingle {
  createTodo(input: {
    title: "Process Order"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "text_single_field_id"
      value: "ORD-2024-001"
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
        value  # Text is accessed here as { text: "ORD-2024-001" }
      }
    }
  }
}

វាលឆ្លើយតប

TodoCustomField ឆ្លើយតប

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

សំខាន់: តម្លៃអត្ថបទត្រូវបានចូលដំណើរការតាមរយៈវាល customField.value.text មិនមែនតាមរយៈ TodoCustomField ដោយផ្ទាល់ទេ។

ការស្វែងរកតម្លៃអត្ថបទ

នៅពេលស្វែងរកកំណត់ត្រាជាមួយវាលអត្ថបទតែមួយ, ចូលដំណើរការអត្ថបទតាមផ្លូវ customField.value.text:

query GetRecordWithText {
  todo(id: "todo_123") {
    id
    title
    customFields {
      id
      customField {
        name
        type
        value  # For TEXT_SINGLE type, contains { text: "your text value" }
      }
    }
  }
}

ការឆ្លើយតបនឹងរួមបញ្ចូលអត្ថបទក្នុងរចនាសម្ព័ន្ធដែលមានស្រទាប់៖

{
  "data": {
    "todo": {
      "customFields": [{
        "customField": {
          "name": "Product SKU",
          "type": "TEXT_SINGLE",
          "value": {
            "text": "ABC-123-XYZ"
          }
        }
      }]
    }
  }
}

ការត្រួតពិនិត្យអត្ថបទ

ការត្រួតពិនិត្យទម្រង់

នៅពេលដែលវាលអត្ថបទតែមួយជួរត្រូវបានប្រើនៅក្នុងទម្រង់៖

• សំឡេងដើម និងសំឡេងចុងត្រូវបានកាត់ដោយស្វ័យប្រវត្តិ
• ការត្រួតពិនិត្យត្រូវការត្រូវបានអនុវត្តបើវាលត្រូវបានសម្គាល់ថាត្រូវការ
• មិនមានការត្រួតពិនិត្យទម្រង់ជាក់លាក់ណាមួយដែលត្រូវបានអនុវត្ត

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

• ទទួលយកមាតិកាអត្ថបទណាមួយរួមទាំងការបំបែកជួរ (ទោះបីជាមិនបានណែនាំ)
• មិនមានកំណត់ប្រវែងអក្សរ (រហូតដល់កំណត់មូលដ្ឋានទិន្នន័យ)
• គាំទ្រអក្សរ Unicode និងសញ្ញាពិសេស
• ការបំបែកជួរត្រូវបានរក្សាទុក ប៉ុន្តែគ្មានគោលបំណងសម្រាប់ប្រភេទវាលនេះ

ឧទាហរណ៍អត្ថបទធម្មតា

Product Name
SKU-123-ABC
Client Reference #2024-001
Version 1.2.3
Project Alpha
Status: Active

ចំណាំសំខាន់

សមត្ថភាពស្តុក

• ត្រូវបានរក្សាទុកដោយប្រើ MySQL MediumText ប្រភេទ
• គាំទ្រទៅដល់ 16MB នៃមាតិកាអត្ថបទ
• ស្តុកដូចគ្នានឹងវាលអត្ថបទច្រើនជួរ
• កូដ UTF-8 សម្រាប់អក្សរអន្តរជាតិ

API ដោយផ្ទាល់ ប្រៀបធៀបនឹងទម្រង់

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

TEXT_SINGLE ប្រៀបធៀប TEXT_MULTI

• TEXT_SINGLE: ការបញ្ចូលអត្ថបទតែមួយជួរ, ល្អសម្រាប់តម្លៃខ្លី
• TEXT_MULTI: ការបញ្ចូលអត្ថបទច្រើនជួរ, ល្អសម្រាប់មាតិកាយូរ
• Backend: ទាំងពីរប្រើស្តុក និងការត្រួតពិនិត្យដូចគ្នា
• Frontend: ឧបករណ៍ UI ផ្សេងគ្នាសម្រាប់ការបញ្ចូលទិន្នន័យ
• គោលបំណង: TEXT_SINGLE មានន័យសម្រាប់តម្លៃតែមួយជួរ

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

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

ចម្លើយកំហុស

ការត្រួតពិនិត្យវាលដែលត្រូវការ (ទម្រង់ប៉ុណ្ណោះ)

{
  "errors": [{
    "message": "This field is required",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

វាលមិនឃើញ

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

អនុវត្តន៍ល្អ

គោលការណ៍មាតិកា

• រក្សាអត្ថបទឱ្យខ្លី និងសមស្របសម្រាប់ជួរតែមួយ
• ជៀសវាងការបំបែកជួរសម្រាប់ការបង្ហាញតែមួយជួរ
• ប្រើទម្រង់ស្ថិតិដូចគ្នាសម្រាប់ប្រភេទទិន្នន័យដូចគ្នា
• ពិចារណាអំពីកំណត់អក្សរតាមគោលការណ៍ UI របស់អ្នក

ការបញ្ចូលទិន្នន័យ

• ផ្តល់ការពិពណ៌នាវាលច្បាស់ដើម្បីណែនាំអ្នកប្រើ
• ប្រើទម្រង់សម្រាប់ការបញ្ចូលរបស់អ្នកប្រើដើម្បីធានាការត្រួតពិនិត្យ
• ត្រួតពិនិត្យទម្រង់មាតិកានៅក្នុងកម្មវិធីរបស់អ្នកបើត្រូវការ
• ពិចារណាអំពីការប្រើប្រាស់ជួរជ្រើសរើសសម្រាប់តម្លៃស្តង់ដារ

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

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

ការការប្រែប្រួល និងស្វែងរក

ស្វែងរកដែលមាន

វាលអត្ថបទតែមួយជួរគាំទ្រការស្វែងរកអក្សរផ្នែក៖

query SearchTextSingle {
  todos(
    customFieldFilters: [{
      customFieldId: "text_single_field_id"
      operation: CONTAINS
      value: "SKU"
    }]
  ) {
    id
    title
    customFields {
      customField {
        value  # Access text via value.text
      }
    }
  }
}

សមត្ថភាពស្វែងរក

• ការប្រកួតអក្សរផ្នែកដែលមិនមានការប្រែប្រួលករណី
• គាំទ្រការប្រកួតពាក្យផ្នែក
• ការប្រកួតតម្លៃត្រឹមត្រូវ
• មិនមានការស្វែងរកអត្ថបទពេញឬការតម្រៀប

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

1. អត្តសញ្ញាណ និងកូដ

   • SKU ផលិតផល
   • លេខការបញ្ជាទិញ
   • កូដយោង
   • លេខកំណែ

2. ឈ្មោះ និងចំណងជើង

   • ឈ្មោះអតិថិជន
   • ចំណងជើងគម្រោង
   • ឈ្មោះផលិតផល
   • ស្លាកប្រភេទ

3. ការពិពណ៌នាខ្លី

   • សង្ខេបខ្លី
   • ស្លាកស្ថានភាព
   • សញ្ញាសំខាន់
   • ស្លាកចែកประเภท

4. យោងក្រៅ

   • លេខសំបុត្រ
   • យោងវិក្កយបត្រ
   • ID ប្រព័ន្ធក្រៅ
   • លេខឯកសារ

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

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

• យោងអត្ថបទពីកំណត់ត្រាផ្សេងទៀត
• ស្វែងរកកំណត់ត្រាដោយមាតិកាអត្ថបទ
• បង្ហាញព័ត៌មានអត្ថបទដែលពាក់ព័ន្ធ
• ប្រមូលតម្លៃអត្ថបទពីប្រភពច្រើន

ជាមួយទម្រង់

• ការកាត់សំឡេងដោយស្វ័យប្រវត្តិ
• ការត្រួតពិនិត្យវាលដែលត្រូវការ
• UI បញ្ចូលអត្ថបទតែមួយជួរ
• បង្ហាញកំណត់អក្សរ (បើបានកំណត់)

ជាមួយការនាំចូល/នាំចេញ

• ការបញ្ជាក់ជួរ CSV ដោយផ្ទាល់
• ការបែងចែកតម្លៃអត្ថបទដោយស្វ័យប្រវត្តិ
• គាំទ្រការនាំចូលទិន្នន័យជាបន្ទាត់
• នាំចេញទៅទ្រង់ទ្រាយតារាង

ការកំណត់

ការកំណត់ស្វ័យប្រវត្តិ

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

ការកំណត់ទូទៅ

• មិនមានការត្រួតពិនិត្យទម្រង់អត្ថបទឬស្ទីលដែលបានបង្កើតឡើង
• មិនមានការត្រួតពិនិត្យស្វ័យប្រវត្តិលើវាលដែលត្រូវការ
• មិនមានការបង្ហាញអត្តសញ្ញាណដែលមានភាពឯកត្តភាព
• មិនមានការបង្ហាប់មាតិកាសម្រាប់អត្ថបទធំៗ
• មិនមានការបង្កើតកំណែឬការតាមដានការផ្លាស់ប្តូរ
• សមត្ថភាពស្វែងរកមានកំណត់ (មិនមានការស្វែងរកអត្ថបទពេញ)

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

• វាលអត្ថបទច្រើនជួរ - សម្រាប់មាតិកាអត្ថបទយូរ
• វាលអ៊ីមែល - សម្រាប់អាសយដ្ឋានអ៊ីមែល
• វាល URL - សម្រាប់អាសយដ្ឋានគេហទំព័រ
• វាល ID ឯកត្តភាព - សម្រាប់អត្តសញ្ញាណដែលបង្កើតឡើងដោយស្វ័យប្រវត្តិ
• ទិដ្ឋភាពទូទៅនៃវាលកំណត់ - គំនិតទូទៅ