---

បញ្ជីវាលកំណត់ផ្ទាល់ខ្លួនទាំងអស់

វាលកំណត់ផ្ទាល់ខ្លួនអនុញ្ញាតឱ្យអ្នកពង្រីករចនាសម្ព័ន្ធកំណត់ត្រាស្តង់ដាររបស់ Blue ជាមួយវាលទិន្នន័យបន្ថែមដែលមានលក្ខណៈពិសេសសម្រាប់តម្រូវការអាជីវកម្មរបស់អ្នក។ ចំណុចចូលនេះទាញយកវាលកំណត់ផ្ទាល់ខ្លួនដែលអាចប្រើបានក្នុងគម្រោងរបស់អ្នកដោយមានការប្រែប្រួលតាមប្រភេទវាលនិងគាំទ្រការបែងចែកទំព័រ។

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

query ListCustomFields {
  customFields(
    filter: { projectId: "project_123" }
    sort: position_ASC
    take: 20
  ) {
    items {
      id
      uid
      name
      type
      position
    }
    pageInfo {
      totalItems
      hasNextPage
    }
  }
}

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

query ListCustomFieldsAdvanced {
  customFields(
    filter: {
      projectId: "project_123"
      types: [TEXT_SINGLE, NUMBER, SELECT_SINGLE]
    }
    sort: name_ASC
    skip: 20
    take: 50
  ) {
    items {
      id
      uid
      name
      type
      position
      description
      
      # Type-specific fields
      min              # For NUMBER, RATING, PERCENT
      max              # For NUMBER, RATING, PERCENT
      currency         # For CURRENCY type
      prefix           # For UNIQUE_ID type
      isDueDate        # For DATE type
      formula          # For FORMULA type
      
      # Validation settings
      editable
      metadata
      
      # For SELECT types
      customFieldOptions {
        id
        title
        color
        position
      }
    }
    pageInfo {
      totalItems
      hasNextPage
      hasPreviousPage
    }
  }
}

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

CustomFieldFilterInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
projectId	String	មិន	ប្រែប្រួលតាម ID គម្រោងជាក់លាក់
types	[CustomFieldType!]	មិន	ប្រែប្រួលតាមប្រភេទវាលកំណត់ផ្ទាល់ខ្លួន

CustomFieldSort តម្លៃ

តម្លៃ	ការពិពណ៌នា
name_ASC	រៀបចំតាមឈ្មោះឡើង (A-Z)
name_DESC	រៀបចំតាមឈ្មោះចុះ (Z-A)
createdAt_ASC	រៀបចំតាមថ្ងៃបង្កើត (ចាស់បំផុតមុន)
createdAt_DESC	រៀបចំតាមថ្ងៃបង្កើត (ថ្មីបំផុតមុន)
position_ASC	រៀបចំតាមទីតាំង (លំនាំដើម)
position_DESC	រៀបចំតាមទីតាំងចុះ

CustomFieldType តម្លៃ

តម្លៃ	ការពិពណ៌នា
TEXT_SINGLE	វាលបញ្ចូលអត្ថបទបន្ទាត់តែមួយ
TEXT_MULTI	តំបន់អត្ថបទបន្ទាត់ច្រើន
SELECT_SINGLE	បញ្ជីជ្រើសរើសតែមួយ
SELECT_MULTI	បញ្ជីជ្រើសរើសច្រើន
CHECKBOX	វាលប្រអប់ត្រួតពិនិត្យ Boolean
RATING	ការវាយតម្លៃដោយផ្កាយ (1-5 ឬចន្លោះបន្ថែម)
PHONE	លេខទូរស័ព្ទដែលមានការត្រួតពិនិត្យ
NUMBER	វាលបញ្ចូលលេខ
CURRENCY	ចំនួនប្រាក់
PERCENT	តម្លៃភាគរយ
EMAIL	អាសយដ្ឋានអ៊ីមែលដែលមានការត្រួតពិនិត្យ
URL	URL វេបសាយដែលមានការត្រួតពិនិត្យ
UNIQUE_ID	អត្តសញ្ញាណឯកត្តភាពដែលបង្កើតដោយស្វ័យប្រវត្តិ
LOCATION	ទីតាំងភូមិសាស្ត្រ (lat/lng)
FILE	ឯកសារភ្ជាប់
DATE	កាលបរិច្ឆេទជ្រើសរើស
COUNTRY	ជ្រើសរើសប្រទេស
FORMULA	វាលដែលគណនាដោយផ្អែកលើវាលផ្សេងទៀត
REFERENCE	តំណទៅកាន់កំណត់ត្រានៅក្នុងគម្រោងផ្សេងទៀត
LOOKUP	ទាញយកទិន្នន័យពីកំណត់ត្រាដែលបានយោង
TIME_DURATION	វាលតាមដានពេលវេលា
BUTTON	វាលប៊ូតុងអាចអនុវត្តបាន
CURRENCY_CONVERSION	វាលបំលែងប្រាក់

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

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ការពិពណ៌នា
skip	Int	មិន	ចំនួនធាតុដែលត្រូវឆ្លងកាត់ (លំនាំដើម: 0)
take	Int	មិន	ចំនួនធាតុដែលត្រូវត្រឡប់ (លំនាំដើម: 20, អតិបរមា: 500)

វាលចម្លើយ

CustomField

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកត្តភាព
uid	String!	អត្តសញ្ញាណដែលមានភាពងាយស្រួល
name	String!	ឈ្មោះបង្ហាញនៃវាល
type	CustomFieldType!	ប្រភេទនៃវាលកំណត់ផ្ទាល់ខ្លួន
position	Float!	ទីតាំងលំដាប់រៀបចំ
description	String	ការពិពណ៌នាវាលជាជម្រើស
min	Float	តម្លៃអប្បបរមា (លេខ, ការវាយតម្លៃ, ភាគរយ)
max	Float	តម្លៃអតិបរមា (លេខ, ការវាយតម្លៃ, ភាគរយ)
currency	String	កូដប្រាក់ (ប្រភេទប្រាក់)
prefix	String	Prefix សម្រាប់ការបង្កើត UNIQUE_ID
isDueDate	Boolean	ថាតើវាលថ្ងៃត្រូវតំណាងឱ្យថ្ងៃកំណត់
formula	JSON	ការកំណត់រូបមន្ត (ប្រភេទរូបមន្ត)
editable	Boolean	ថាតើអ្នកប្រើបច្ចុប្បន្នអាចកែប្រែវាលនេះ
metadata	JSON	ការកំណត់វាលបន្ថែម
customFieldOptions	[CustomFieldOption!]	ជម្រើសដែលអាចប្រើបានសម្រាប់ប្រភេទជ្រើសរើស

CustomFieldOption

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកត្តភាព
title	String!	អត្ថបទបង្ហាញសម្រាប់ជម្រើស
color	String!	កូដពណ៌ Hex
position	Float!	ទីតាំងលំដាប់រៀបចំ

PageInfo

វាល	ប្រភេទ	ការពិពណ៌នា
totalItems	Int	ចំនួនសរុបនៃវាលកំណត់ផ្ទាល់ខ្លួន
hasNextPage	Boolean!	ថាតើមានទំព័រផ្សេងទៀតទេ
hasPreviousPage	Boolean!	ថាតើមានទំព័រមុនទៀតទេ
endCursor	String	ការបង្ហាញសម្រាប់ការបែងចែកទំព័រ (បានលុបចេញ - ប្រើការបែងចែកដោយផ្អែកលើការប្រែប្រួល)

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

វាលកំណត់ផ្ទាល់ខ្លួនអាចចូលបានដោយផ្អែកលើតួនាទីគម្រោងរបស់អ្នក។ ប្រសិនបើអ្នកមានតួនាទីផ្ទាល់ខ្លួនដែលមានការចូលដំណើរការវាលកំណត់តិចតួច វាលដែលមានស្លាកថាជាអាចកែប្រែបានសម្រាប់តួនាទីរបស់អ្នកនឹងត្រូវត្រឡប់មកវិញ។

តួនាទី	អាចបញ្ជីវាលកំណត់ផ្ទាល់ខ្លួន
OWNER	✅ បាទ (វាលទាំងអស់)
ADMIN	✅ បាទ (វាលទាំងអស់)
MEMBER	✅ បាទ (ផ្អែកលើការអនុញ្ញាតតួនាទី)
CLIENT	✅ បាទ (ផ្អែកលើការអនុញ្ញាតតួនាទី)

ចម្លើយកំហុស

គម្រោងមិនឃើញ

{
  "errors": [{
    "message": "Project not found.",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

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

{
  "errors": [{
    "message": "Variable \"$filter\" got invalid value \"INVALID_TYPE\" at \"filter.types[0]\"; Value \"INVALID_TYPE\" does not exist in \"CustomFieldType\" enum.",
    "extensions": {
      "code": "GRAPHQL_VALIDATION_FAILED"
    }
  }]
}

កំណត់សំខាន់

• វាលកំណត់ផ្ទាល់ខ្លួនត្រូវបានកំណត់ទៅគម្រោង - អ្នកត្រូវតែបញ្ជាក់ projectId ក្នុងការប្រែប្រួល
• ប៉ារ៉ាម៉ែត្រ take ត្រូវបានកំណត់នៅ 500 ធាតុក្នុងមួយសំណើសម្រាប់ការអនុវត្ត
• វាលត្រូវត្រឡប់មកវិញដោយផ្អែកលើការអនុញ្ញាតអ្នកប្រើ - តួនាទីផ្ទាល់ខ្លួនអាចមានការចូលដំណើរការតិចតួច
• លំដាប់រៀបចំលំនាំដើមគឺតាម position ឡើង ដែលបង្ហាញពីលំដាប់ដែលបង្ហាញនៅក្នុង UI
• សំណើនេះគាំទ្រការប្រែប្រួលគម្រោងតែមួយ - សម្រាប់សំណើគម្រោងច្រើន ប្រើចំណុចចូល CustomFieldQueries ដែលមានស្រាប់
• ប្រភេទវាលខ្លះ (ដូចជា FORMULA និង REFERENCE) អាចមានរចនាសម្ព័ន្ធទិន្នន័យបន្ថែមដែលមានស្រាប់
• វាល editable បង្ហាញថាអ្នកប្រើបច្ចុប្បន្នអាចកែប្រែតម្លៃសម្រាប់វាលកំណត់ផ្ទាល់ខ្លួននេះឬអត់

ចំណុចចូលដែលពាក់ព័ន្ធ

• បង្កើតវាលកំណត់ផ្ទាល់ខ្លួន - បន្ថែមវាលកំណត់ផ្ទាល់ខ្លួនថ្មីទៅគម្រោង
• អាប់ដេតវាលកំណត់ផ្ទាល់ខ្លួន - កែប្រែលក្ខណៈវាលកំណត់ផ្ទាល់ខ្លួនដែលមានស្រាប់
• លុបវាលកំណត់ផ្ទាល់ខ្លួន - យកវាលកំណត់ផ្ទាល់ខ្លួនចេញពីគម្រោង
• កំណត់តម្លៃវាលកំណត់ផ្ទាល់ខ្លួន - កំណត់តម្លៃលើកំណត់ត្រា