---

បញ្ជីគម្រោងទាំងអស់

ការស្នើសុំ projectList អនុញ្ញាតឱ្យអ្នកទាញយកគម្រោងជាមួយនឹងជម្រើសការត្រួតពិនិត្យ, ការរៀបចំ, និងការបែងចែកទំព័រ។

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

query ProjectListQuery {
  projectList(filter: { companyIds: ["ENTER COMPANY ID"] }) {
    items {
      id
      uid
      slug
      name
      description
      archived
      color
      icon
      createdAt
      updatedAt
      allowNotification
      position
      unseenActivityCount
      todoListsMaxPosition
      lastAccessedAt
      isTemplate
      automationsCount
      totalFileCount
      totalFileSize
      todoAlias
    }
    pageInfo {
      totalPages
      totalItems
      page
      perPage
      hasNextPage
      hasPreviousPage
    }
  }
}

ឧទាហរណ៍កម្រិតខ្ពស់ជាមួយការត្រួតពិនិត្យនិងការរៀបចំ

query FilteredProjectList {
  projectList(
    filter: {
      companyIds: ["company-123", "company-456"]
      archived: false
      isTemplate: false
      search: "marketing"
      inProject: true
      folderId: null  # Get root-level projects only
    }
    sort: [position_ASC, name_ASC]
    skip: 0
    take: 50
  ) {
    items {
      id
      name
      slug
      position
      archived
    }
    totalCount
    pageInfo {
      totalItems
      hasNextPage
    }
  }
}

វាលគម្រោង

តារាងខាងក្រោមពិពណ៌នាអំពីវាលទាំងអស់ដែលអាចប្រើបានសម្រាប់គម្រោងនីមួយៗនៅក្នុង ProjectListQuery:

វាល	ប្រភេទ	ពិពណ៌នា
id	ID!	អត្តសញ្ញាណឯកតាសម្រាប់គម្រោង
uid	String!	អត្តសញ្ញាណឯកតាដែលងាយស្រួលសម្រាប់គម្រោង
slug	String!	ឈ្មោះដែលងាយស្រួលប្រើសម្រាប់គម្រោង
name	String!	ឈ្មោះបង្ហាញសម្រាប់គម្រោង
description	String	ពិពណ៌នាខ្លីអំពីគម្រោង
archived	Boolean	Boolean បង្ហាញថាគម្រោងត្រូវបានរក្សាទុក
color	String	ពណ៌ដែលទាក់ទងនឹងគម្រោងសម្រាប់ការកំណត់អត្តសញ្ញាណវិចិត្រ
icon	String	រូបតំណាងដែលទាក់ទងនឹងគម្រោងសម្រាប់ការកំណត់អត្តសញ្ញាណវិចិត្រ
image	Image	វត្ថុរូបភាពគម្របគម្រោង
createdAt	DateTime!	ម៉ោងដែលគម្រោងត្រូវបានបង្កើត
updatedAt	DateTime!	ម៉ោងដែលគម្រោងបានធ្វើបច្ចុប្បន្នភាពចុងក្រោយ
allowNotification	Boolean!	Boolean បង្ហាញថាតើការជូនដំណឹងត្រូវបានបើកសម្រាប់គម្រោង
position	Float!	តម្លៃលេខដែលតំណាងឱ្យទីតាំងរបស់គម្រោងក្នុងបញ្ជី
unseenActivityCount	Int!	ចំនួនសកម្មភាពដែលមិនបានឃើញនៅក្នុងគម្រោង
todoListsMaxPosition	Float!	តម្លៃទីតាំងអតិបរិមាសម្រាប់បញ្ជីធ្វើការ​នៅក្នុងគម្រោង
lastAccessedAt	DateTime	ម៉ោងដែលគម្រោងបានចូលប្រើចុងក្រោយ
isTemplate	Boolean!	Boolean បង្ហាញថាគម្រោងនេះជាគំរូ
isOfficialTemplate	Boolean!	Boolean បង្ហាញថាតើនេះជាគំរូផ្លូវការរបស់ Blue
automationsCount(isActive: Boolean)	Int!	ចំនួនសកម្មភាពស្វ័យប្រវត្តិដែលទាក់ទងនឹងគម្រោង
totalFileCount	Int	ចំនួនសរុបនៃឯកសារនៅក្នុងគម្រោង
totalFileSize	Float	ទំហំសរុបនៃឯកសារទាំងអស់នៅក្នុងគម្រោង (ក្នុងបៃតស)
todoAlias	String	ឈ្មោះផ្ទាល់ខ្លួនសម្រាប់ "todo" ដែលបានប្រើនៅក្នុងគម្រោង
category	ProjectCategory!	ប្រភេទគម្រោង (CRM, MARKETING, ល)
hideEmailFromRoles	[UserAccessLevel!]	បញ្ជីនៃតួនាទីដែលគួរត្រូវបានលាក់អាសយដ្ឋានអ៊ីមែល
hideStatusUpdate	Boolean	Boolean សម្រាប់ការលាក់ការអាប់ដេតស្ថានភាព
company	Company!	ព័ត៌មានលម្អិតអំពីក្រុមហ៊ុនពេញលេញ
accessLevel(userId: String)	UserAccessLevel	ទទួលបានកម្រិតការចូលប្រើរបស់អ្នកប្រើសម្រាប់គម្រោងជាក់លាក់
folder	Folder	ធុងដែលមានគម្រោងនេះ
features	[ProjectFeature!]	បញ្ជីនៃលក្ខណៈគម្រោងដែលបានបើក
sequenceCustomField	CustomField	វាលផ្ទាល់ខ្លួនដែលបានប្រើសម្រាប់លេខរៀង
coverConfig	TodoCoverConfig	ការកំណត់សម្រាប់រូបភាពគម្រប todo
hideRecordCount	Boolean	តើត្រូវលាក់ចំនួនកំណត់ទេ
showTimeSpentInTodoList	Boolean	តើត្រូវបង្ហាញពេលវេលាដែលបានចំណាយនៅក្នុងបញ្ជី todo ទេ
showTimeSpentInProject	Boolean	តើត្រូវបង្ហាញពេលវេលាដែលបានចំណាយនៅក្នុងគម្រោងទេ
todoFields	[TodoField]	ការកំណត់វាល todo ផ្ទាល់ខ្លួន

ចំណាំ: អ្នកអាចស្នើសុំការរួមបញ្ចូលណាមួយនៃវាលទាំងនេះនៅក្នុងការស្នើសុំ GraphQL របស់អ្នក។

វាលការបែងចែកទំព័រ

វត្ថុ pageInfo ផ្តល់ព័ត៌មានលម្អិតអំពីការបែងចែកទំព័សម្រាប់លទ្ធផលសំណើ:

វាល	ប្រភេទ	ពិពណ៌នា
totalPages	Int	ចំនួនទំព័រសរុបនៃលទ្ធផល
totalItems	Int	ចំនួនគម្រោងសរុបដែលផ្គូផ្គងនឹងការស្នើសុំ
page	Int	លេខទំព័របច្ចុប្បន្ន
perPage	Int	ចំនួនធាតុក្នុងមួយទំព័រ
hasNextPage	Boolean!	Boolean បង្ហាញថាតើមានទំព័របន្ទាប់នៃលទ្ធផលទេ
hasPreviousPage	Boolean!	Boolean បង្ហាញថាតើមានទំព័រមុននៃលទ្ធផលទេ

ប៉ារ៉ាម៉ែត្រសំណើ

ជម្រើសត្រួតពិនិត្យ (ProjectListFilter)

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការ	ពិពណ៌នា
companyIds	[String!]!	✅ បាទ	បញ្ជីអត្តសញ្ញាណក្រុមហ៊ុនឬស្លាកដែលត្រូវស្វែងរក
ids	[String!]	ទេ	ត្រួតពិនិត្យតាមអត្តសញ្ញាណគម្រោងជាក់លាក់
archived	Boolean	ទេ	ត្រួតពិនិត្យតាមស្ថានភាពរក្សាទុក (ពិត/មិនពិត)
isTemplate	Boolean	ទេ	ត្រួតពិនិត្យគម្រោងគំរូ (ពិត/មិនពិត)
search	String	ទេ	ស្វែងរកគម្រោងតាមឈ្មោះ (មិនគិតពីករណី)
folderId	String	ទេ	ត្រួតពិនិត្យតាមអត្តសញ្ញាណថត។ ប្រើ null សម្រាប់គម្រោងកម្រិតរង
inProject	Boolean	ទេ	ត្រួតពិនិត្យតាមការជាសមាជិករបស់អ្នកប្រើ។ សូមមើលចំណាំខាងក្រោម

ចំណាំអំពីត្រួតពិនិត្យ inProject:

• true ឬ undefined: ត្រឡប់មកវិញគម្រោងដែលអ្នកប្រើជាសមាជិក
• false: ត្រឡប់មកវិញគម្រោងដែលអ្នកប្រើមិនមាន (ត្រូវការអនុញ្ញាតម្ចាស់ក្រុមហ៊ុន)
• ការត្រួតពិនិត្យថត (folderId) មានប្រសិទ្ធភាពតែពេលដែល inProject មិនមែនជា false

ជម្រើសការរៀបចំ (ProjectSort)

តម្លៃ	ពិពណ៌នា
id_ASC	រៀបចំតាម ID កើនឡើង
id_DESC	រៀបចំតាម ID ក្រោម
name_ASC	រៀបចំតាមឈ្មោះកើនឡើង (A-Z)
name_DESC	រៀបចំតាមឈ្មោះក្រោម (Z-A)
createdAt_ASC	រៀបចំតាមថ្ងៃបង្កើត (ចាស់ជាងគេមុន)
createdAt_DESC	រៀបចំតាមថ្ងៃបង្កើត (ថ្មីជាងគេមុន)
updatedAt_ASC	រៀបចំតាមការអាប់ដេតចុងក្រោយ (ចាស់ជាងគេមុន)
updatedAt_DESC	រៀបចំតាមការអាប់ដេតចុងក្រោយ (ថ្មីជាងគេមុន)
position_ASC	រៀបចំតាមទីតាំងកើនឡើង*
position_DESC	រៀបចំតាមទីតាំងក្រោម*

*ការរៀបចំទីតាំងអាចប្រើបានតែពេលមើលគម្រោងដែលអ្នកប្រើជាសមាជិក (inProject !== false)

ប៉ារ៉ាម៉ែត្របែងចែកទំព័រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	តម្លៃលំនាំ	ពិពណ៌នា
skip	Int	0	ចំនួនកំណត់ដែលត្រូវឆ្លើយតប
take	Int	20	ចំនួនកំណត់ដែលត្រូវត្រឡប់មកវិញ

ចំណាំសំខាន់

1. អាកប្បកិរិយាលំនាំសម្រាប់គម្រោងដែលមិនជាសមាជិក (inProject: false):

   • លុបគម្រោងដែលបានរក្សាទុកចេញពីបញ្ជីលុះត្រាតែ archived ត្រូវបានកំណត់យ៉ាងច្បាស់
   • លុបគម្រោងគំរូចេញពីបញ្ជីលុះត្រាតែ isTemplate ត្រូវបានកំណត់យ៉ាងច្បាស់

2. កំណត់ការត្រួតពិនិត្យថត:

   • មានប្រសិទ្ធភាពតែពេលបង្ហាញគម្រោងរបស់អ្នកប្រើ
   • មិនអាចប្រើជាមួយ inProject: false
   • ប្រើ folderId: null ដើម្បីទទួលបានគម្រោងដែលមិននៅក្នុងថតណាមួយ

3. ការរៀបចំការប្រកួត:

   • ការរៀបចំទីតាំងត្រូវបានមើលរំលងពេលមើលគម្រោងដែលមិនជាសមាជិក
   • ត្រូវត្រឡប់ទៅការរៀបចំឈ្មោះក្នុងករណីនេះ

4. ប៉ារ៉ាម៉ែត្រដែលបានលុបចេញ:

   • orderBy, after, before, first, last ត្រូវបានលុបចេញ
   • ប្រើ sort, skip, និង take ជំនួស។