---

កន្លែងផ្ទុក URL អនុញ្ញាតឱ្យអ្នករក្សាទុកអាសយដ្ឋានវេបសាយ និងតំណភ្ជាប់នៅក្នុងកំណត់ហេតុរបស់អ្នក។ ពួកវាដំណើរការល្អសម្រាប់តាមដានវេបសាយគម្រោង, តំណភ្ជាប់យោង, URL ឯកសារ, ឬធនធានអ៊ីនធឺណិតណាមួយដែលពាក់ព័ន្ធនឹងការងាររបស់អ្នក។

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

បង្កើតកន្លែងផ្ទុក URL ងាយស្រួលមួយ៖

mutation CreateUrlField($projectId: String!) {
  createCustomField(
    projectId: $projectId
    input: {
      name: "Project Website"
      type: URL
    }
  ) {
    id
    name
    type
  }
}

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

បង្កើតកន្លែងផ្ទុក URL ជាមួយការពិពណ៌នា៖

mutation CreateDetailedUrlField($projectId: String!) {
  createCustomField(
    projectId: $projectId
    input: {
      name: "Reference Link"
      type: URL
      description: "Link to external documentation or resources"
    }
  ) {
    id
    name
    type
    description
  }
}

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

CreateCustomFieldInput

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

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

កំណត់តម្លៃ URL

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

mutation SetUrlValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    text: "https://example.com/documentation"
  })
}

SetTodoCustomFieldInput Parameters

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

បង្កើតកំណត់ហេតុជាមួយតម្លៃ URL

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

mutation CreateRecordWithUrl {
  createTodo(input: {
    title: "Review documentation"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "url_field_id"
      value: "https://docs.example.com/api"
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      text
    }
  }
}

វាលឆ្លើយតប

TodoCustomField Response

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

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

ការអនុវត្តន៍បច្ចុប្បន្ន

• API ដោយផ្ទាល់: មិនមានការត្រួតពិនិត្យទ្រង់ទ្រាយ URL ដែលបានអនុវត្តនៅពេលនេះ
• ទម្រង់: ការត្រួតពិនិត្យ URL ត្រូវបានគ្រោងទុក ប៉ុន្តែមិនមានសកម្មភាពនៅពេលនេះ
• ការផ្ទុក: តម្លៃអត្ថបទណាមួយអាចត្រូវបានរក្សាទុកនៅក្នុងកន្លែងផ្ទុក URL

ការត្រួតពិនិត្យដែលគ្រោងទុក

កំណែអនាគតនឹងរួមបញ្ចូល:

• ការត្រួតពិនិត្យប្រព័ន្ធ HTTP/HTTPS
• ការត្រួតពិនិត្យទ្រង់ទ្រាយ URL ដែលមានសុពលភាព
• ការត្រួតពិនិត្យឈ្មោះដែន
• ការបន្ថែមកូដប្រព័ន្ធដោយស្វ័យប្រវត្តិ

ទ្រង់ទ្រាយ URL ដែលបានណែនាំ

ទោះបីមិនមានការអនុវត្តន៍នៅពេលនេះទេ សូមប្រើទ្រង់ទ្រាយស្តង់ដានេះ៖

https://example.com
https://www.example.com
https://subdomain.example.com
https://example.com/path
https://example.com/path?param=value
http://localhost:3000
https://docs.example.com/api/v1

ចំណាំសំខាន់

ទ្រង់ទ្រាយការផ្ទុក

• URL ត្រូវបានរក្សាទុកជាអត្ថបទធម្មតាដោយគ្មានការកែប្រែ
• មិនមានការបន្ថែមប្រព័ន្ធដោយស្វ័យប្រវត្តិ (http://, https://)
• ការពារទ្រង់ទ្រាយត្រូវបានរក្សាទុកដូចដែលបានបញ្ចូល
• មិនមានការកូដ/បកប្រែ URL ធ្វើឡើង

API ដោយផ្ទាល់ និង ទម្រង់

• ទម្រង់: ការត្រួតពិនិត្យ URL ដែលគ្រោងទុក (មិនមានសកម្មភាពនៅពេលនេះ)
• API ដោយផ្ទាល់: មិនមានការត្រួតពិនិត្យ - អត្ថបទណាមួយអាចត្រូវបានរក្សាទុក
• ការណែនាំ: ត្រួតពិនិត្យ URL នៅក្នុងកម្មវិធីរបស់អ្នកមុននឹងរក្សាទុក

URL និង កន្លែងផ្ទុកអត្ថបទ

• URL: មានគោលបំណងសម្រាប់អាសយដ្ឋានវេបសាយ
• TEXT_SINGLE: អត្ថបទទូទៅមួយបន្ទាត់
• Backend: ការផ្ទុក និងការត្រួតពិនិត្យស្មើគ្នាបច្ចុប្បន្ន
• Frontend: ធាតុ UI ផ្សេងគ្នាសម្រាប់ការបញ្ចូលទិន្នន័យ

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

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

សកម្មភាព	តួនាទីដែលត្រូវការ
Create URL field	OWNER or ADMIN role in the project
Update URL field	OWNER or ADMIN role in the project
Set URL value	User must have edit permissions for the record
View URL value	User must have view permissions for the record

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

ចម្លើយកំហុស

វាលមិនឃើញ

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

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

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

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

ស្តង់ដារទ្រង់ទ្រាយ URL

• តែងតែបញ្ចូលប្រព័ន្ធ (http:// ឬ https://)
• ប្រើ HTTPS នៅពេលអាចធ្វើទៅបានសម្រាប់សុវត្ថិភាព
• សាកល្បង URL មុននឹងរក្សាទុកដើម្បីធានាថាពួកវាអាចចូលប្រើបាន
• ពិចារណាអំពីការប្រើប្រាស់ URL ដែលបានកាត់បន្ថយសម្រាប់គោលបំណងបង្ហាញ

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

• ត្រួតពិនិត្យ URL នៅក្នុងកម្មវិធីរបស់អ្នកមុននឹងរក្សាទុក
• ពិនិត្យសម្រាប់កំហុសទូទៅ (ប្រព័ន្ធខ្វះ, ដែនមិនត្រឹមត្រូវ)
• ស្តង់ដារទ្រង់ទ្រាយ URL នៅទូទាំងអង្គភាពរបស់អ្នក
• ពិចារណាអំពីការចូលប្រើ និងភាពអាចរកបានរបស់ URL

ការពិចារណាសុវត្ថិភាព

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

ការត្រួតពិនិត្យ និងស្វែងរក

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

កន្លែងផ្ទុក URL គាំទ្រការស្វែងរក substring:

query SearchUrls {
  todos(
    customFieldFilters: [{
      customFieldId: "url_field_id"
      operation: CONTAINS
      value: "docs.example.com"
    }]
  ) {
    id
    title
    customFields {
      text
    }
  }
}

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

• ការប្រកួត substring ដែលមិនគិតពីករណី
• ការប្រកួតដែនផ្នែក
• ការស្វែងរកផ្លូវ និងប៉ារ៉ាម៉ែត្រ
• មិនមានការត្រួតពិនិត្យជាក់លាក់ប្រព័ន្ធ

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

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

   • វេបសាយគម្រោង
   • តំណភ្ជាប់ឯកសារ
   • URL ធនធាន
   • គេហទំព័របង្ហាញ

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

   • សម្ភារៈយោង
   • តំណភ្ជាប់ប្រភព
   • ធនធានមេឌា
   • អត្ថបទខាងក្រៅ

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

   • វេបសាយអតិថិជន
   • ឯកសារគាំទ្រ
   • អត្ថបទមូលដ្ឋានចំណេះដឹង
   • វីដេអូសិក្សា

4. ការលក់ និងទីផ្សារ

   • វេបសាយក្រុមហ៊ុន
   • ទំព័រផលិតផល
   • សម្ភារៈទីផ្សារ
   • ប្រវត្តិរូបបណ្តាញសង្គម

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

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

• URL យោងពីកំណត់ហេតុផ្សេងទៀត
• ស្វែងរកកំណត់ហេតុតាមដែនឬទំរង់ URL
• បង្ហាញធនធានវេបសាយដែលពាក់ព័ន្ធ
• ប្រមូលតំណភ្ជាប់ពីប្រភពច្រើន

ជាមួយទម្រង់

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

ជាមួយការរាយការណ៍

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

ការកំណត់

ការកំណត់បច្ចុប្បន្ន

• មិនមានការត្រួតពិនិត្យទ្រង់ទ្រាយ URL សកម្ម
• មិនមានការបន្ថែមប្រព័ន្ធដោយស្វ័យប្រវត្តិ
• មិនមានការបញ្ជាក់តំណភ្ជាប់ឬការត្រួតពិនិត្យភាពអាចចូលប្រើ
• មិនមានការកាត់បន្ថយឬពង្រីក URL
• មិនមានការបង្កើត favicon ឬមើលមុន

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

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

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

• មិនមានមុខងារមើលមុនតំណភ្ជាប់ក្នុងខាងក្នុង
• មិនមានការកាត់បន្ថយ URL ដោយស្វ័យប្រវត្តិ
• មិនមានការតាមដានចុចឬវិភាគ
• មិនមានការត្រួតពិនិត្យកាលបរិច្ឆេទផុតកំណត់ URL
• មិនមានការស្កេន URL ដែលមានគ្រោះថ្នាក់

ការកែលម្អអនាគត

លក្ខណៈពិសេសដែលគ្រោងទុក

• ការត្រួតពិនិត្យប្រព័ន្ធ HTTP/HTTPS
• លំនាំត្រួតពិនិត្យ regex ផ្ទាល់ខ្លួន
• ការបន្ថែមកូដប្រព័ន្ធដោយស្វ័យប្រវត្តិ
• ការត្រួតពិនិត្យភាពអាចចូលប្រើ URL

ការកែលម្អដែលអាចមាន

• ការបង្កើតមើលមុនតំណភ្ជាប់
• ការបង្ហាញ favicon
• ការបញ្ចូលការកាត់បន្ថយ URL
• សមត្ថភាពតាមដានចុច
• ការស្គាល់តំណភ្ជាប់ខូច

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

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

ការផ្លាស់ប្តូរពីកន្លែងផ្ទុកអត្ថបទ

ប្រសិនបើអ្នកកំពុងផ្លាស់ប្តូរពីកន្លែងផ្ទុកអត្ថបទទៅកន្លែងផ្ទុក URL៖

1. បង្កើតកន្លែងផ្ទុក URL ជាមួយឈ្មោះ និងការកំណត់ដូចគ្នា
2. នាំចេញតម្លៃអត្ថបទដែលមានស្រាប់ ដើម្បីបញ្ជាក់ថាពួកវាជា URL ដែលមានសុពលភាព
3. ធ្វើបច្ចុប្បន្នភាពកំណត់ហេតុ ដើម្បីប្រើកន្លែងផ្ទុក URL ថ្មី
4. លុបកន្លែងផ្ទុកអត្ថបទចាស់ បន្ទាប់ពីការផ្លាស់ប្តូរដែលជោគជ័យ
5. ធ្វើបច្ចុប្បន្នភាពកម្មវិធី ដើម្បីប្រើធាតុ UI ដែលជាក់លាក់ URL

ឧទាហរណ៍ការផ្លាស់ប្តូរ

# Step 1: Create URL field
mutation CreateUrlField {
  createCustomField(input: {
    name: "Website Link"
    type: URL
    projectId: "proj_123"
  }) {
    id
  }
}

# Step 2: Update records (repeat for each record)
mutation MigrateToUrlField {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "new_url_field_id"
    text: "https://example.com"  # Value from old text field
  })
}