ClusterCockpit/cc-backend
1
0
Fork 0
mirror of https://github.com/ClusterCockpit/cc-backend synced 2024-12-25 12:59:06 +01:00
Code Issues Packages Releases Activity

Update searchbar doc

Browse Source
This commit is contained in:
Christoph Kluge 2023-02-22 17:51:30 +01:00
parent d30dba109d
commit 816617ecb8
1 changed files with 26 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
docs/searchbar.md
View File

@ -1,42 +1,35 @@
## Docs for ClusterCockpit Searchbar # Docs for ClusterCockpit Searchbar
### Usage ## Usage
* Searchtags are implemented as `type:<query>` search-string * Searchtags are implemented as `type:<query>` search-string
* Types `jobId, jobName, projectId, username, name` for roles `admin` and `support` * Types `jobId, jobName, projectId, username, name` for roles `admin` and `support`
* `jobName` is jobName as persisted in `job.meta_data` table-column * `jobName` is jobName as persisted in `job.meta_data` table-column
* `username` is actual account identifier as persisted in `job.user` table-column * `username` is actual account identifier as persisted in `job.user` table-column
* `name` is account owners name as persisted in `user.name` table-column * `name` is account owners name as persisted in `user.name` table-column
* Types `jobId, jobName` for role `user` * Types `jobId, jobName, projectId` for role `user`
* Examples: * Examples:
* `jobName:myJob12` * `jobName:myJob12`
* `jobId:123456` * `jobId:123456`
* `username:abcd100` * `username:abcd100`
* `name:Paul` * `name:Paul`
* If no searchTag used: Best guess search with the following hierarchy * If no searchTag used: Best guess search with the following hierarchy
* `jobId -> username -> name -> projectId -> jobName` * `jobId -> username -> name -> projectId -> jobName`
* Destinations: * Destinations:
* JobId: Always Job-Table (Allows multiple identical matches, e.g. JobIds from different clusters) * JobId: Job-Table (Allows multiple identical matches, e.g. JobIds from different clusters)
* JobName: Always Job-Table (Allows multiple identical matches, e.g. JobNames from different clusters) * JobName: Job-Table (Allows multiple identical matches, e.g. JobNames from different clusters)
* ProjectId: Always Job-Table * ProjectId: Job-Table
* Username * Username: Users-Table
* If *one* match found: Opens detailed user-view (`/monitoring/user/$USER`) * **Please Note**: Only users with jobs will be shown in table! I.e., Users without jobs will be missing in table.
* If *multiple* matches found: Opens user-table with matches listed (`/monitoring/users/`) * Name: Users-Table
* **Please Note**: Only users with jobs will be shown in table! I.e., "multiple matches" can still be only one entry in table. * **Please Note**: Only users with jobs will be shown in table! I.e., Users without jobs will be missing in table.
* Name * Best guess search always redirects to Job-Table or `/monitoring/user/$USER` (first username match)
* If *one* matching username found: Opens detailed user-view (`/monitoring/user/$USER`) * Unprocessable queries will redirect to `/monitoring/jobs/?`
* If *multiple* usernames found: Opens user-table with matches listed (`/monitoring/users/`)
* **Please Note**: Only users with jobs will be shown in table! I.e., "multiple matches" can still be only one entry in table.
* Best guess search always redirects to Job-Table or `/monitoring/user/$USER` (first username match)
* Simple HTML Error if ...
* Best guess search fails -> 'Not Found'
* Query `type` is unknown
* More than two colons in string -> 'malformed'
* Spaces trimmed (both for searchTag and queryString) * Spaces trimmed (both for searchTag and queryString)
* ` job12` == `job12` * ` job12` == `job12`
* `projectID : abcd ` == `projectId:abcd` * `projectID : abcd ` == `projectId:abcd`
* `jobName`- and `name-`queries work with a part of the target-string * `jobName`- and `name-`queries work with a part of the target-string
* `jobName:myjob` for jobName "myjob_cluster1" * `jobName:myjob` for jobName "myjob_cluster1"
* `name:Paul` for name "Paul Atreides" * `name:Paul` for name "Paul Atreides"
* JobName GQL Query is resolved as matching the query as a part of the whole metaData-JSON in the SQL DB. * JobName GQL Query is resolved as matching the query as a part of the whole metaData-JSON in the SQL DB.