search_projects
Search for projects in an organization using filters like name, status, dates, creator, or admin. Query projects you manage, participate in, or have favorited with pagination.
Instructions
[Project Management] Search for Yunxiao Project List. A Project is a project management unit that includes work items and sprints, and it is different from a code repository (Repository).
Use Cases:
Query projects I am involved in Query projects I have created
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| organizationId | Yes | Organization ID | |
| name | No | Text contained in project name | |
| status | No | Project status ID, multiple separated by commas | |
| createdAfter | No | Created not earlier than, format: YYYY-MM-DD | |
| createdBefore | No | Created not later than, format: YYYY-MM-DD | |
| creator | No | Creator | |
| adminUserId | No | Project administrator user ID, should use userId returned from getCurrentOrganizationInfoFunc or user-provided user ID, multiple IDs separated by commas | |
| logicalStatus | No | Logical status, e.g., NORMAL | |
| scenarioFilter | No | Predefined filter scenarios: 'manage' (projects I manage), 'participate' (projects I participate in), 'favorite' (projects I favorited). Will be used to construct appropriate extraConditions. Requires userId from getCurrentOrganizationInfoFunc. | |
| userId | No | User ID to use with scenarioFilter, should be the userId returned from getCurrentOrganizationInfoFunc | |
| advancedConditions | No | Advanced filter conditions, JSON format | |
| extraConditions | No | Additional filter conditions as JSON string. Should be constructed similar to the conditions parameter. For common scenarios: 1) For 'projects I manage': use fieldIdentifier 'project.admin' with the user ID; 2) For 'projects I participate in': use fieldIdentifier 'users' with the user ID; 3) For 'projects I favorited': use fieldIdentifier 'collectMembers' with the user ID. Example: JSON.stringify({conditionGroups:[[{className:'user',fieldIdentifier:'project.admin',format:'multiList',operator:'CONTAINS',value:[userId]}]]}) | |
| orderBy | No | Sort field, default is gmtCreate, supports: gmtCreate (creation time), name (name) | gmtCreate |
| page | No | Pagination parameter, page number | |
| perPage | No | Pagination parameter, page size, 0-200, default value is 20 | |
| sort | No | Sort order, default is desc, options: desc (descending), asc (ascending) | desc |