ការយោង API ពេញលេញសម្រាប់គ្រប់គ្រងវាលកំណត់ផ្ទាល់ខ្លួននៅក្នុង Blue - បង្កើត កំណត់ និងប្រើវាលកំណត់ផ្ទាល់ខ្លួនដើម្បីពង្រីករចនាសម្ព័ន្ធទិន្នន័យរបស់អ្នក
ទិដ្ឋភាពទូទៅ
វាលកំណត់ផ្ទាល់ខ្លួនអនុញ្ញាតឱ្យអ្នកពង្រីករចនាសម្ព័ន្ធកំណត់ត្រាមាតុភូមិរបស់ Blue ជាមួយវាលទិន្នន័យបន្ថែមដែលសមស្របនឹងតម្រូវការអាជីវកម្មរបស់អ្នក។ វាផ្តល់នូវវិធីដ៏មានអំណាចក្នុងការចាប់យកទិន្នន័យដែលមានរចនាសម្ព័ន្ធលើសពីវាលដែលមាននៅក្នុងដូចជា ចំណងជើង ការពិពណ៌នា និងកាលបរិច្ឆេទផុតកំណត់។
វាលកំណត់ផ្ទាល់ខ្លួនត្រូវបានកំណត់នៅកម្រិតគម្រោង ហើយអាចប្រើបាននៅក្នុងកំណត់ត្រាទាំងអស់ (ការងារ) នៅក្នុងគម្រោងនោះ។ វាលនីមួយៗមានប្រភេទជាក់លាក់ដែលកំណត់ច្បាប់ការត្រួតពិនិត្យ ការបញ្ចូលទ្រង់ទ្រាយ និងអាកប្បកិរិយាការបង្ហាញរបស់វា។
ប្រតិបត្តិការដែលអាចប្រើបាន
ការគ្រប់គ្រងវាលមូលដ្ឋាន
ប្រតិបត្តិការ |
ការពិពណ៌នា |
លីង |
List Custom Fields |
ស្វែងរក និងច្រោះវាលកំណត់ផ្ទាល់ខ្លួន |
View Details → |
Create Custom Field |
បន្ថែមវាលកំណត់ផ្ទាល់ខ្លួនថ្មីទៅគម្រោង |
View Details → |
Delete Custom Field |
លុបវាលកំណត់ផ្ទាល់ខ្លួនជាមួយការសម្អាតត្រឹមត្រូវ |
View Details → |
តម្លៃវាល
ប្រតិបត្តិការ |
ការពិពណ៌នា |
លីង |
Set Field Values |
កំណត់ និងធ្វើបច្ចុប្បន្នភាពតម្លៃវាលកំណត់ផ្ទាល់ខ្លួននៅលើកំណត់ត្រា |
View Details → |
ប្រភេទវាលកំណត់ផ្ទាល់ខ្លួន
វាលអត្ថបទ
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
TEXT_SINGLE |
ការបញ្ចូលអត្ថបទជួរតែមួយ |
Names, titles, short descriptions |
View Details → |
TEXT_MULTI |
តំបន់អត្ថបទជាច្រើនជួរ |
ការពិពណ៌នាយូរ ការយកចិត្តទុកដាក់ ការបញ្ចេញមតិ |
View Details → |
វាលជ្រើសរើស
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
SELECT_SINGLE |
បញ្ជីជ្រើសរើសតែមួយ |
Status, priority, category |
View Details → |
SELECT_MULTI |
បញ្ជីជ្រើសរើសច្រើន |
Tags, skills, categories |
View Details → |
CHECKBOX |
វាលប្រអប់ស្លាកប៊ូឡេអាន |
Flags, approvals, confirmations |
View Details → |
វាលលេខ
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
NUMBER |
ការបញ្ចូលលេខ |
Quantities, scores, measurements |
View Details → |
CURRENCY |
ចំនួនប្រាក់ |
Budgets, costs, pricing |
View Details → |
PERCENT |
តម្លៃភាគរយ |
Completion rates, discounts |
View Details → |
RATING |
ការវាយតម្លៃដោយផ្អែកលើស្កេឡា |
Performance ratings, satisfaction |
View Details → |
FORMULA |
វាលគណនាដែលផ្អែកលើវាលផ្សេងទៀត |
Totals, computations, aggregations |
View Details → |
វាលទំនាក់ទំនង
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
EMAIL |
អាសយដ្ឋានអ៊ីមែលដែលមានការត្រួតពិនិត្យ |
ព័ត៌មានទំនាក់ទំនង ការជូនដំណឹង |
View Details → |
PHONE |
លេខទូរស័ព្ទដែលមានទ្រង់ទ្រាយអន្តរជាតិ |
Contact details, emergency contacts |
View Details → |
URL |
URL វេបសាយដែលមានការត្រួតពិនិត្យ |
Links, references, resources |
View Details → |
វាលកាលបរិច្ឆេទ និងម៉ោង
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
DATE |
ជ្រើសរើសកាលបរិច្ឆេទ |
Deadlines, milestones, events |
View Details → |
TIME_DURATION |
វាលតាមដានម៉ោង |
Work hours, duration estimates |
View Details → |
ទីតាំង និងភូមិសាស្ត្រ
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
LOCATION |
ទីតាំងភូមិសាស្ត្រ (lat/lng) |
Addresses, venues, service areas |
View Details → |
COUNTRY |
ជ្រើសរើសប្រទេស |
Regional assignments, localization |
View Details → |
ឯកសារ និងមេឌា
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
FILE |
ការភ្ជាប់ឯកសារ |
Documents, images, resources |
View Details → |
វាលប្រព័ន្ធ
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
UNIQUE_ID |
អត្តសញ្ញាណឯកតាដែលបង្កើតឡើងដោយស្វ័យប្រវត្តិ |
Ticket numbers, order IDs |
View Details → |
REFERENCE |
តំណភ្ជាប់ទៅកាន់កំណត់ត្រានៅក្នុងគម្រោងផ្សេងទៀត |
Cross-project relationships |
View Details → |
LOOKUP |
ទាញយកទិន្នន័យពីកំណត់ត្រាដែលបានយោង |
Aggregate data from related records |
View Details → |
វាលអន្តរកម្ម
ប្រភេទ |
ការពិពណ៌នា |
ករណីប្រើ |
លីង |
BUTTON |
វាលប៊ូតុងដែលអាចអនុវត្តបាន |
Triggers, actions, workflows |
View Details → |
CURRENCY_CONVERSION |
វាលបម្លែងប្រាក់ |
Multi-currency calculations |
View Details → |
គំនិតសំខាន់ៗ
ការកំណត់វាល
- វាលកំណត់ផ្ទាល់ខ្លួនត្រូវបានកំណត់នៅកម្រិតគម្រោង
- វាលនីមួយៗមានឈ្មោះ និងប្រភេទឯកត្តភាព
- វាលអាចរួមបញ្ចូលច្បាប់ការត្រួតពិនិត្យ និងកំណត់
- ជម្រើសកំណត់ខុសគ្នាតាមប្រភេទវាល
តម្លៃវាល
- តម្លៃត្រូវបានរក្សាទុកនៅលើកំណត់ត្រាទីមួយ (ការងារ)
- កំណត់ត្រានីមួយៗអាចមានតម្លៃខុសគ្នាសម្រាប់វាលដូចគ្នា
- តម្លៃទទេ/សូន្យត្រូវបានអនុញ្ញាតសម្រាប់វាលដែលជាជម្រើស
- តម្លៃត្រូវបានត្រួតពិនិត្យតាមច្បាប់ប្រភេទវាល
គំរូសិទ្ធិ
វាលកំណត់ផ្ទាល់ខ្លួនគោរពសិទ្ធិនៅកម្រិតគម្រោង:
តួនាទី |
បង្កើតវាល |
កែសម្រួលវាល* |
កំណត់តម្លៃ |
មើលតម្លៃ |
OWNER |
✅ បាទ |
✅ បាទ |
✅ បាទ |
✅ បាទ |
ADMIN |
✅ បាទ |
✅ បាទ |
✅ បាទ |
✅ បាទ |
MEMBER |
❌ ទេ |
❌ ទេ |
✅ បាទ |
✅ បាទ |
CLIENT |
❌ ទេ |
❌ ទេ |
✅ កំណត់ |
✅ កំណត់ |
- កែសម្រួលវាលមានន័យថាកែប្រែការកំណត់វាល (ឈ្មោះ ប្រភេទ ជម្រើស ច្បាប់ការត្រួតពិនិត្យ) - មិនមែនកំណត់តម្លៃវាលនៅលើកំណត់ត្រាទេ
សិទ្ធិតួនាទីផ្ទាល់ខ្លួន
- គម្រោងអាចមានតួនាទីផ្ទាល់ខ្លួនដែលមានសិទ្ធិពាក់ព័ន្ធនឹងវាល
- វាលអាចត្រូវបានសម្គាល់ថាជាអាចកែប្រែ/មិនអាចកែប្រែតាមតួនាទី
- តួនាទីផ្ទាល់ខ្លួនអាចកំណត់ការចូលដំណើរការទៅកាន់វាលជាក់លាក់
លំនាំទូទៅ
បង្កើតវាលកំណត់ផ្ទាល់ខ្លួនមូលដ្ឋាន
mutation CreateCustomField {
createCustomField(input: {
name: "Priority Level"
type: SELECT_SINGLE
description: "Task priority level"
customFieldOptions: [
{ title: "Low", color: "#28a745" }
{ title: "Medium", color: "#ffc107" }
{ title: "High", color: "#fd7e14" }
{ title: "Critical", color: "#dc3545" }
]
}) {
id
name
type
customFieldOptions {
id
title
color
}
}
}
កំណត់តម្លៃវាលនៅលើកំណត់ត្រា
mutation SetFieldValue {
setTodoCustomField(input: {
todoId: "todo_123"
customFieldId: "field_456"
customFieldOptionId: "option_789" # For SELECT_SINGLE
})
}
ស្វែងរកកំណត់ត្រាជាមួយវាលកំណត់ផ្ទាល់ខ្លួន
query GetTodosWithCustomFields {
todos(projectId: "project_123") {
id
title
customFields {
id
customField {
name
type
}
# Type-specific value fields
text # TEXT_SINGLE, TEXT_MULTI, EMAIL, etc.
number # NUMBER, CURRENCY, PERCENT, RATING
selectedOption # SELECT_SINGLE
selectedOptions # SELECT_MULTI
checked # CHECKBOX
date # DATE
}
}
}
បង្កើតកំណត់ត្រាជាមួយតម្លៃវាលកំណត់ផ្ទាល់ខ្លួន
mutation CreateTodoWithCustomFields {
createTodo(input: {
title: "New task"
todoListId: "list_123"
customFields: [
{ customFieldId: "priority_field", value: "high_priority_option" }
{ customFieldId: "budget_field", value: "5000" }
{ customFieldId: "notes_field", value: "Additional context here" }
]
}) {
id
title
customFields {
customField { name }
value
}
}
}
អនុវត្តន៍ល្អបំផុត
ការរចនាវាល
- ប្រើឈ្មោះដែលពិពណ៌នាដែលច្បាស់ - ធ្វើឱ្យគោលបំណងវាលច្បាស់
- ជ្រើសប្រភេទដែលសមស្រប - ត្រូវតាមតម្រូវការទិន្នន័យ
- កំណត់ច្បាប់ការត្រួតពិនិត្យ - ប្រើតម្លៃអប្បបរមា/អតិបរមា វាលដែលត្រូវការនៅក្នុង
- រៀបចំដោយមានលក្ខណៈត្រឹមត្រូវ - រៀបចំវាលដែលពាក់ព័ន្ធគ្នា
ការពិចារណាអំពីសមត្ថភាព
- កំណត់ចំនួនវាល - វាលច្រើនពេកអាចប៉ះពាល់ដល់សមត្ថភាព
- ប្រើការបែងចែកទំព័រ - នៅពេលស្វែងរកទិន្នន័យធំ
- បង្កើនវាលសំខាន់ - សម្រាប់វាលដែលប្រើក្នុងការច្រោះ/តម្រៀប
- ចAvoid deep nesting - រក្សាទំនាក់ទំនងវាលឱ្យសាមញ្ញ
គុណភាពទិន្នន័យ
- ត្រួតពិនិត្យការបញ្ចូល - ប្រើប្រភេទវាលដែលសមស្របជាមួយការត្រួតពិនិត្យ
- ផ្តល់អត្រា - កំណត់តម្លៃអត្រាដែលមានសមត្ថភាពនៅពេលដែលសមស្រប
- ប្រើទ្រង់ទ្រាយដែលស្របគ្នា - ស្តង់ដារប្រព័ន្ធបញ្ចូលទិន្នន័យ
- ការសម្អាតជាប្រចាំ - លុបវាល និងជម្រើសដែលមិនបានប្រើ
បទពិសោធន៍អ្នកប្រើ
- ការពិពណ៌នាដែលច្បាស់ - ផ្តល់ការពិពណ៌នាវាលដែលមានប្រយោជន៍
- ការបញ្ជាក់លំដាប់ - ដាក់វាលនៅក្នុងលំដាប់ធម្មជាតិ
- លំដាប់វិជ្ជមាន - ប្រើពណ៌ និងការបង្ហាញយ៉ាងមានប្រសិទ្ធភាព
- ការបង្ហាញជាបន្តបន្ទាប់ - បង្ហាញវាលនៅពេលដែលមានសារៈសំខាន់
ការដោះស្រាយកំហុស
កំហុសទូទៅនៅពេលធ្វើការជាមួយវាលកំណត់ផ្ទាល់ខ្លួន:
កូដកំហុស |
ការពិពណ៌នា |
ដំណោះស្រាយ |
CUSTOM_FIELD_NOT_FOUND |
វាលមិនមាន |
Verify field ID and project access |
VALIDATION_ERROR |
តម្លៃមិនសមស្របនឹងប្រភេទវាល |
Check format and validation rules |
UNAUTHORIZED |
សិទ្ធិមិនគ្រប់គ្រាន់ |
Ensure proper role level |
CUSTOM_FIELD_VALUE_PARSE_ERROR |
ទ្រង់ទ្រាយតម្លៃមិនត្រឹមត្រូវ |
Review field type requirements |
ឯកសារដែលពាក់ព័ន្ធ