---

វាលខ្សែអត្ថបទច្រើនបន្ទាត់អនុញ្ញាតឱ្យអ្នករក្សាទុកមាតិកាខ្សែអត្ថបទយូរដែលមានការបំបែកបន្ទាត់ និងការកំណត់ទ្រង់ទ្រាយ។ វាជាជម្រើសល្អសម្រាប់ការពិពណ៌នា កំណត់ចំណាំ មតិយោបល់ ឬទិន្នន័យអត្ថបទណាមួយដែលត្រូវការបន្ទាត់ច្រើន។

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

បង្កើតវាលខ្សែអត្ថបទច្រើនបន្ទាត់ធម្មតា៖

mutation CreateTextMultiField($projectId: String!) {
  createCustomField(
    projectId: $projectId
    input: {
      name: "Description"
      type: TEXT_MULTI
    }
  ) {
    id
    name
    type
  }
}

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

បង្កើតវាលខ្សែអត្ថបទច្រើនបន្ទាត់ដែលមានការពិពណ៌នា៖

mutation CreateDetailedTextMultiField($projectId: String!) {
  createCustomField(
    projectId: $projectId
    input: {
      name: "Project Notes"
      type: TEXT_MULTI
      description: "Detailed notes and observations about the project"
    }
  ) {
    id
    name
    type
    description
  }
}

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

CreateCustomFieldInput

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

ចំណាំ: projectId ត្រូវបានផ្ញើជាអាគុយម៉ង់ផ្សេងទៀតទៅកាន់ការប្រែប្រួល មិនមែនជាផ្នែកនៃវត្ថុ input ទេ។ ជាជម្រើស អត្ថបទគម្រោងអាចត្រូវបានកំណត់ពី X-Bloo-Project-ID ក្បាលក្នុងការស្នើសុំ GraphQL របស់អ្នក។

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

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

mutation SetTextMultiValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    text: "This is a multi-line text value.\n\nIt can contain line breaks and longer content."
  })
}

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

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

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

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

mutation CreateRecordWithTextMulti {
  createTodo(input: {
    title: "Project Planning"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "text_multi_field_id"
      value: "Project Overview:\n\n1. Research phase\n2. Design phase\n3. Implementation phase\n\nKey considerations:\n- Budget constraints\n- Timeline requirements\n- Resource allocation"
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      text
    }
  }
}

វាលឆ្លើយតប

TodoCustomField ឆ្លើយតប

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

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

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

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

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

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

• ទទួលយកមាតិកាខ្សែណាមួយរួមមានការបំបែកបន្ទាត់
• មិនមានកំណត់ប្រវែងអក្សរ (រហូតដល់កំណត់មូលដ្ឋានទិន្នន័យ)
• គាំទ្រអក្សរ Unicode និងសញ្ញាពិសេស
• ការបំបែកបន្ទាត់ត្រូវបានរក្សាទុកក្នុងការផ្ទុក

ឧទាហរណ៍អត្ថបទដែលមានសុពលភាព

Single line text

Multi-line text with
line breaks

Text with special characters:
- Bullets
- Numbers: 123
- Symbols: @#$%
- Unicode: 🚀 ✅ ⭐

Code snippets:
function example() {
  return "hello world";
}

ចំណាំសំខាន់

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

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

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

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

TEXT_MULTI ប្រៀបធៀប TEXT_SINGLE

• TEXT_MULTI: ការបញ្ចូល textarea ច្រើនបន្ទាត់ ដែលសមស្របសម្រាប់មាតិកាយូរអង្វែង
• TEXT_SINGLE: ការបញ្ចូលអត្ថបទបន្ទាត់តែមួយ ដែលសមស្របសម្រាប់តម្លៃខ្លី
• Backend: ប្រភេទទាំងពីរជាអ្វីដែលស្មើគ្នា - វាលផ្ទុកដូចគ្នា ការត្រួតពិនិត្យ និងការប្រតិបត្តិ
• Frontend: ឧបករណ៍ UI ខុសគ្នាសម្រាប់ការបញ្ចូលទិន្នន័យ (textarea ប្រៀបធៀប input field)
• សំខាន់: ការបែងចែករវាង TEXT_MULTI និង TEXT_SINGLE មានស្រាប់សម្រាប់គោលបំណង UI ប៉ុណ្ណោះ

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

សកម្មភាព	អាជ្ញាប័ណ្ណដែលត្រូវការ
Create text field	OWNER or ADMIN project-level role
Update text field	OWNER or ADMIN project-level role
Set text value	Any role except VIEW_ONLY or COMMENT_ONLY
View text value	Any project-level role

ចម្លើយកំហុស

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

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

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

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

អនុស្សាវរីយ៍ល្អ

ការរៀបចំមាតិកា

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

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

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

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

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

ការក្រៅស៊ុម និងការស្វែងរក

ស្វែងរកមានក្នុង

វាលខ្សែអត្ថបទច្រើនបន្ទាត់គាំទ្រការស្វែងរកអក្សរប្រភេទស្រាប់តាមរយៈតម្រងវាលកុំព្យូទ័រ៖

query SearchTextMulti {
  todos(
    customFieldFilters: [{
      customFieldId: "text_multi_field_id"
      operation: CONTAINS
      value: "project"
    }]
  ) {
    id
    title
    customFields {
      customField {
        name
        type
      }
      text
    }
  }
}

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

• ការប្រកួតអក្សរប្រភេទស្រាប់នៅក្នុងវាលអត្ថបទដោយប្រើ CONTAINS អ្នកប្រើ
• ការស្វែងរកមិនគិតពីករណីដោយប្រើ NCONTAINS អ្នកប្រើ
• ការប្រកួតត្រឹមត្រូវដោយប្រើ IS អ្នកប្រើ
• ការប្រកួតអវិជ្ជមានដោយប្រើ NOT អ្នកប្រើ
• ស្វែងរកនៅលើបន្ទាត់អត្ថបទទាំងអស់
• គាំទ្រការប្រកួតពាក្យផ្នែក

ករណីប្រើទូទៅ

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

   • ការពិពណ៌នាអំពីភារកិច្ច
   • ការទាមទ្រ​គម្រោង
   • កំណត់ចំណាំកិច្ចប្រជុំ
   • ការអាប់ដេតស្ថានភាព

2. ការគាំទ្រអតិថិជន

   • ការពិពណ៌នាបញ្ហា
   • កំណត់ចំណាំដោះស្រាយ
   • មតិយោបល់ពីអតិថិជន
   • កំណត់ហេតុការទំនាក់ទំនង

3. ការគ្រប់គ្រងមាតិកា

   • មាតិកាអត្ថបទ
   • ការពិពណ៌នាផលិតផល
   • មតិយោបល់ពីអ្នកប្រើ
   • ព័ត៌មានអំពីការពិនិត្យ

4. ឯកសារ

   • ការពិពណ៌នាដំណើរការ
   • សេចក្ដីណែនាំ
   • គោលការណ៍
   • សម្ភារៈយោង

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

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

• បង្កើតសកម្មភាពពេលដែលមាតិកាអត្ថបទបានផ្លាស់ប្តូរ
• ដកពាក្យគន្លឹះពីមាតិកាអត្ថបទ
• បង្កើតសង្ខេបឬការជូនដំណឹង
• ដំណើរការមាតិកាអត្ថបទជាមួយសេវាកម្មក្រៅ

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

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

ជាមួយទម្រង់

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

ការកំណត់

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

ឯកសារដែលពាក់ព័ន្ធ

• វាលអត្ថបទបន្ទាត់តែមួយ - សម្រាប់តម្លៃអត្ថបទខ្លី
• វាលអ៊ីមែល - សម្រាប់អាសយដ្ឋានអ៊ីមែល
• វាល URL - សម្រាប់អាសយដ្ឋានគេហទំព័រ
• ទិដ្ឋភាពទូទៅនៃវាលកុំព្យូទ័រ - គំនិតទូទៅ