---

បង្កើតវាលកំណត់ផ្ទាល់ខ្លួន

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

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

mutation CreateTextField {
  createCustomField(input: {
    name: "Customer Name"
    type: TEXT_SINGLE
    description: "Primary customer contact name"
  }) {
    id
    uid
    name
    type
    position
  }
}

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

mutation CreateAdvancedField {
  createCustomField(input: {
    name: "Project Budget"
    type: CURRENCY
    description: "Total allocated budget for this project"
    currency: "USD"
    min: 0
    max: 1000000
  }) {
    id
    uid
    name
    type
    currency
    min
    max
    position
    createdAt
  }
}

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

CreateCustomFieldInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ពិពណ៌នា
name	String!	✅ បាទ	ឈ្មោះបង្ហាញនៃវាលកំណត់ផ្ទាល់ខ្លួន
type	CustomFieldType!	✅ បាទ	ប្រភេទវាល (មើលប្រភេទខាងក្រោម)
description	String	ទេ	ពិពណ៌នាដែលជ្រើសរើសបានដែលពន្យល់អំពីគោលបំណងនៃវាល
min	Float	ទេ	តម្លៃអប្បបរមាសម្រាប់ NUMBER, RATING, PERCENT fields
max	Float	ទេ	តម្លៃអតិបរិមាសម្រាប់ NUMBER, RATING, PERCENT fields
currency	String	ទេ	កូដរូបិយវត្ថុ ISO សម្រាប់ CURRENCY fields
prefix	String	ទេ	អក្សរសម្រាប់ UNIQUE_ID fields
isDueDate	Boolean	ទេ	តើវាល DATE តំណាងឱ្យកាលបរិច្ឆេទកំណត់ទេ
formula	JSON	ទេ	ការកំណត់រូបមន្តសម្រាប់ FORMULA fields
referenceProjectId	String	ទេ	ID គម្រោងគោលដៅសម្រាប់ REFERENCE fields
referenceMultiple	Boolean	ទេ	អនុញ្ញាតឱ្យមានជ្រើសរើសច្រើនក្នុង REFERENCE fields
referenceFilter	TodoFilterInput	ទេ	ជម្រើសត្រួតពិនិត្យសម្រាប់ REFERENCE fields
lookupOption	CustomFieldLookupOptionInput	ទេ	ការកំណត់សម្រាប់ LOOKUP fields
timeDurationDisplay	CustomFieldTimeDurationDisplayType	ទេ	ទ្រង់ទ្រាយបង្ហាញសម្រាប់ TIME_DURATION
timeDurationTargetTime	Float	ទេ	ពេលវេលាគោលដៅក្នុងវិនាទីសម្រាប់ TIME_DURATION
timeDurationStartInput	CustomFieldTimeDurationInput	ទេ	ចាប់ផ្តើមការជំរុញសម្រាប់ TIME_DURATION
timeDurationEndInput	CustomFieldTimeDurationInput	ទេ	ចុងក្រោយការជំរុញសម្រាប់ TIME_DURATION
buttonType	String	ទេ	ប្រភេទសកម្មភាពប៊ូតុងសម្រាប់ BUTTON fields
buttonConfirmText	String	ទេ	ការបញ្ជាក់សម្រាប់ BUTTON fields
useSequenceUniqueId	Boolean	ទេ	ប្រើលេខតាមលំដាប់សម្រាប់ UNIQUE_ID
sequenceDigits	Int	ទេ	ចំនួនលេខក្នុងលំដាប់ (ឧ. 5 → 00001)
sequenceStartingNumber	Int	ទេ	លេខចាប់ផ្តើមសម្រាប់លំដាប់
currencyFieldId	String	ទេ	វាលរូបិយវត្ថុយោងសម្រាប់ CURRENCY_CONVERSION
conversionDate	String	ទេ	ថ្ងៃទីបំលែងសម្រាប់ CURRENCY_CONVERSION
conversionDateType	String	ទេ	ប្រភេទថ្ងៃបំលែងសម្រាប់ CURRENCY_CONVERSION
metadata	JSON	ទេ	ព័ត៌មានមេដាតាបន្ថែមសម្រាប់វាលកំណត់ផ្ទាល់ខ្លួន

CustomFieldType Values

តម្លៃ	ពិពណ៌នា	ប៉ារ៉ាម៉ែត្រ​ត្រូវការ
TEXT_SINGLE	ការបញ្ចូលអត្ថបទជួរដេកតែមួយ	គ្មាន
TEXT_MULTI	តំបន់អត្ថបទជួរដេកច្រើន	គ្មាន
SELECT_SINGLE	បញ្ជីជ្រើសរើសតែមួយ	Create options separately
SELECT_MULTI	បញ្ជីជ្រើសរើសច្រើន	Create options separately
CHECKBOX	ប្រអប់ត្រួតពិនិត្យ Boolean	គ្មាន
RATING	វាលការវាយតម្លៃតារាង	Optional: max (default: 5)
PHONE	លេខទូរស័ព្ទដែលមានការត្រួតពិនិត្យ	គ្មាន
NUMBER	ការបញ្ចូលលេខ	Optional: min, max
CURRENCY	ចំនួនរូបិយវត្ថុ	Optional: currency, min, max
PERCENT	ភាគរយ (0-100)	Optional: min, max
EMAIL	អ៊ីមែលដែលមានការត្រួតពិនិត្យ	គ្មាន
URL	URL វេបសាយដែលមានការត្រួតពិនិត្យ	គ្មាន
UNIQUE_ID	អត្តសញ្ញាណដែលបង្កើតដោយស្វ័យប្រវត្តិ	Optional: prefix, useSequenceUniqueId
LOCATION	សមាសភាពភូមិសាស្ត្រ	គ្មាន
FILE	ការភ្ជាប់ឯកសារ	គ្មាន
DATE	ជ្រើសរើសកាលបរិច្ឆេទ	Optional: isDueDate
COUNTRY	ជ្រើសរើសប្រទេស	គ្មាន
FORMULA	វាលដែលគណនា	Required: formula
REFERENCE	តំណទៅកាន់កំណត់ត្រាផ្សេងទៀត	Required: referenceProjectId
LOOKUP	ទាញយកទិន្នន័យពីយោង	Required: lookupOption
TIME_DURATION	ការតាមដានពេលវេលា	Required: duration inputs (see below)
BUTTON	ប៊ូតុងសកម្មភាព	Optional: buttonType, buttonConfirmText
CURRENCY_CONVERSION	ការបំលែងរូបិយវត្ថុ	Special configuration

ឧទាហរណ៍ការកំណត់ប្រភេទវាល

វាលលេខដែលមានកំណត់

mutation CreateQuantityField {
  createCustomField(input: {
    name: "Quantity"
    type: NUMBER
    description: "Number of items"
    min: 1
    max: 999
  }) {
    id
    name
    min
    max
  }
}

វាលរូបិយវត្ថុ

mutation CreateBudgetField {
  createCustomField(input: {
    name: "Budget"
    type: CURRENCY
    currency: "EUR"
    min: 0
  }) {
    id
    name
    currency
    min
  }
}

វាលកាលបរិច្ឆេទដែលមានសញ្ញាកាលបរិច្ឆេទកំណត់

mutation CreateDeadlineField {
  createCustomField(input: {
    name: "Project Deadline"
    type: DATE
    isDueDate: true
    description: "When this project must be completed"
  }) {
    id
    name
    isDueDate
  }
}

វាលយោង

mutation CreateRelatedTasksField {
  createCustomField(input: {
    name: "Dependencies"
    type: REFERENCE
    referenceProjectId: "proj_abc123"
    referenceMultiple: true
    referenceFilter: {
      statusIds: ["status_open", "status_inprogress"]
    }
  }) {
    id
    name
    referenceProjectId
    referenceMultiple
  }
}

វាលស្វែងរក

mutation CreateLookupField {
  createCustomField(input: {
    name: "Customer Email"
    type: LOOKUP
    lookupOption: {
      referenceId: "field_customer_ref"
      lookupId: "field_email"
      lookupType: TODO_CUSTOM_FIELD
    }
  }) {
    id
    name
    customFieldLookupOption {
      referenceId
      lookupId
      lookupType
    }
  }
}

ID យ៉ាងហោចណាស់ជាមួយលំដាប់

mutation CreateOrderNumberField {
  createCustomField(input: {
    name: "Order Number"
    type: UNIQUE_ID
    prefix: "ORD-"
    useSequenceUniqueId: true
    sequenceDigits: 6
    sequenceStartingNumber: 1000
  }) {
    id
    name
    prefix
  }
}

វាលរយៈពេល

mutation CreateTimeTrackingField {
  createCustomField(input: {
    name: "Time to Resolution"
    type: TIME_DURATION
    timeDurationDisplay: FULL_DATE_STRING
    timeDurationStartInput: {
      type: TODO_CREATED_AT
      condition: FIRST
    }
    timeDurationEndInput: {
      type: TODO_MARKED_AS_COMPLETE
      condition: FIRST
    }
  }) {
    id
    name
  }
}

ប្រភេទរយៈពេលដែលមានសុពលភាព

• TODO_CREATED_AT - ពេលដែលកំណត់ត្រាត្រូវបានបង្កើត
• TODO_CUSTOM_FIELD - ពេលដែលវាលកំណត់ផ្ទាល់ខ្លួនផ្លាស់ប្តូរ
• TODO_DUE_DATE - ពេលដែលកាលបរិច្ឆេទកំណត់ត្រូវបានកំណត់/ផ្លាស់ប្តូរ
• TODO_MARKED_AS_COMPLETE - ពេលដែលកំណត់ត្រាត្រូវបានសម្គាល់ថាបញ្ចប់
• TODO_MOVED - ពេលដែលកំណត់ត្រាត្រូវបានផ្លាស់ទៅក្នុងបញ្ជីផ្សេង
• TODO_TAG_ADDED - ពេលដែលស្លាកត្រូវបានបន្ថែម
• TODO_ASSIGNEE_ADDED - ពេលដែលអ្នកចាត់តាំងត្រូវបានបន្ថែម

ការបង្កើតជម្រើសជ្រើសរើស

បន្ទាប់ពីបង្កើតវាល SELECT_SINGLE ឬ SELECT_MULTI សូមបន្ថែមជម្រើស៖

mutation CreateSelectOptions {
  createCustomFieldOptions(input: {
    customFieldId: "field_xyz789"
    customFieldOptions: [
      { title: "High", color: "#FF0000", position: 1 }
      { title: "Medium", color: "#FFA500", position: 2 }
      { title: "Low", color: "#00FF00", position: 3 }
    ]
  }) {
    id
    title
    color
    position
  }
}

វាលចម្លើយ

CustomField

វាល	ប្រភេទ	ពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតា
uid	String!	ID ឯកតាដែលមានមិត្តភាព
name	String!	ឈ្មោះបង្ហាញ
type	CustomFieldType!	ប្រភេទវាល
description	String	ពិពណ៌នាវាល
position	Float!	ទីតាំងលំដាប់បង្ហាញ
createdAt	DateTime!	ម៉ោងបង្កើត
updatedAt	DateTime!	ម៉ោងធ្វើបច្ចុប្បន្នភាពចុងក្រោយ
min	Float	តម្លៃអប្បបរមា (ប្រសិនបើអាចប្រើបាន)
max	Float	តម្លៃអតិបរិមា (ប្រសិនបើអាចប្រើបាន)
currency	String	កូដរូបិយវត្ថុ (ប្រភេទ CURRENCY)
prefix	String	អក្សរសម្រាប់ ID (ប្រភេទ UNIQUE_ID)
isDueDate	Boolean	សញ្ញាកាលបរិច្ឆេទកំណត់ (ប្រភេទ DATE)
formula	JSON	ការកំណត់រូបមន្ត (ប្រភេទ FORMULA)
referenceProjectId	String	គម្រោងដែលបានយោង (ប្រភេទ REFERENCE)
customFieldLookupOption	CustomFieldLookupOption	ការកំណត់ស្វែងរក (ប្រភេទ LOOKUP)

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

ការបង្កើតវាលកំណត់ផ្ទាល់ខ្លួនត្រូវការការចូលដំណើរការគម្រោង៖

តួនាទី	អាចបង្កើតវាលកំណត់ផ្ទាល់ខ្លួន
OWNER	✅ បាទ
ADMIN	✅ បាទ
MEMBER	✅ បាទ
CLIENT	❌ ទេ

ចំណាំ៖ តួនាទីកំណត់ផ្ទាល់ខ្លួនអាចមានការកំណត់បន្ថែមលើការគ្រប់គ្រងវាល។

ចម្លើយកំហុស

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

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

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

{
  "errors": [{
    "message": "Reference project not found or access denied",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

ការកំណត់ដែលត្រូវការមិនមាន

{
  "errors": [{
    "message": "REFERENCE fields require referenceProjectId",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

កំណត់សំខាន់

• ទីតាំងវាល: គណនាដោយស្វ័យប្រវត្តិដើម្បីបង្ហាញនៅចុងវាលដែលមានស្រាប់
• កំណត់វាល: គម្រោងអាចមានកំណត់លើចំនួនវាលកំណត់ផ្ទាល់ខ្លួន
• ភាពអាចប្រើបានភ្លាមៗ: វាលដែលបានបង្កើតមានភាពអាចប្រើបានភ្លាមៗ
• ផលប៉ះពាល់ខាងក្រៅ: ការបង្កើតវាលធ្វើឱ្យមាន៖
  • ការចុះបញ្ជីសកម្មភាព
  • ការអាប់ដេតពេលវេលាជាក់ស្តែងទៅអ្នកប្រើដែលភ្ជាប់
  • ការជូនដំណឹង Webhook
  • ការងារប្រព័ន្ធសម្រាប់ FORMULA, LOOKUP, និង UNIQUE_ID fields
• ការពិចារណាពិសេស:
  • វាល REFERENCE ត្រូវការការចូលដំណើរការគម្រោងគោលដៅ
  • វាល LOOKUP អាស្រ័យលើវាល REFERENCE ដែលមានស្រាប់
  • វាល FORMULA មិនអាចយោងខ្លួនឯង
  • លំដាប់ UNIQUE_ID ដំណើរការយ៉ាងសកម្ម
  • វាល SELECT ត្រូវការជម្រើសដែលបានបង្កើតឡើងដោយឡែក
• ឈ្មោះ: ឈ្មោះវាលគួរតែច្បាស់និងពិពណ៌នាដូចដែលវាបង្ហាញនៅក្នុង UI

ចំណុចចូលដែលទាក់ទង

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