Ngôn ngữ của cụm từ tìm kiếm là cú pháp bạn sử dụng để tìm kiếm vấn đề trong Công cụ theo dõi lỗi của Google. Bạn có thể sử dụng ngôn ngữ trong các truy vấn tìm kiếm bạn nhập vào thanh tìm kiếm. Bạn cũng có thể sử dụng trình tạo tìm kiếm để chọn tiêu chí dưới dạng đồ hoạ, sau đó tiêu chí này được chuyển đổi thành ngôn ngữ truy vấn khi đóng trình tạo tìm kiếm.
Ngôn ngữ truy vấn cho phép bạn tìm kiếm theo tiêu chí sau:
- Từ khoá
- Cặp trường/giá trị
Các cụm từ tìm kiếm bạn thực hiện có thể chứa nhiều tiêu chí, bao gồm cả tổ hợp từ khoá và các cặp trường/giá trị. Cú pháp ngôn ngữ truy vấn cho phép bạn chỉ định mối quan hệ và thứ tự theo thứ tự tiêu chí được xem xét bằng cách sử dụng toán tử logic, dấu ngoặc đơn và dấu ngoặc kép.
Số lượt tìm kiếm từ khoá
Từ khoá là các chuỗi văn bản mà bạn có thể dùng để tìm kiếm trên một số trường nhất định trong các vấn đề. Các trường này là:
- Tiêu đề
- Bình luận
- Tên tệp đính kèm
- Các trường có chứa người dùng (ví dụ: Người được giao hoặc CC)
- Các trường chứa số mã nhận dạng nội bộ (ví dụ: các trường chỉ định thành phần hoặc danh sách nóng chứa vấn đề)
- Các trường chứa số phiên bản
- Trường tuỳ chỉnh
Chuỗi configuration properties là một ví dụ về tiêu chí tìm kiếm từ khoá.
Khi bạn nhập tiêu chí này vào một lượt tìm kiếm, Công cụ theo dõi lỗi sẽ tìm kiếm các vấn đề trên toàn cục trong mọi thành phần và trả về những trường có trường ở trên chứa cả hai từ khoá, do các quyền kiểm soát quyền truy cập của bạn điều chỉnh. Từ khoá có thể ở các trường khác nhau hoặc cùng các trường.
Công cụ theo dõi lỗi coi ký tự dấu cách phân tách tiêu chí tìm kiếm là một toán tử AND ngầm ẩn. Bạn có thể sử dụng dấu ngoặc kép (") để chỉ định rằng một chuỗi nhiều từ được coi là một từ khoá. Tất cả các lượt tìm kiếm trong Công cụ theo dõi lỗi đều không phân biệt chữ hoa chữ thường, cho dù bạn có sử dụng dấu ngoặc kép hay không.
Lượt tìm kiếm cặp giá trị/trường
Bạn cũng có thể chỉ định tiêu chí tìm kiếm dưới dạng một cặp trường/giá trị. Cú pháp cơ sở là [field]:[value]. Đối với các trường văn bản, cú pháp này sẽ khớp với các vấn đề mà trường được chỉ định chứa giá trị. Đối với các loại trường khác, trường này sẽ khớp với các vấn đề mà giá trị của trường là tương đương.
Ví dụ: nội dung tìm kiếm title:latency sẽ khớp với các vấn đề với từ latency trong trường Tiêu đề. Thao tác tìm kiếm priority:p0 sẽ tìm thấy các vấn đề có mức độ ưu tiên là p0.
Xin lưu ý rằng đối với trường thời gian và số lượng, bạn có thể sử dụng các ký hiệu quan hệ khác ngoài ký tự dấu hai chấm. Xem phần Toán tử quy chiếu dưới đây.
Tìm kiếm giá trị đặc biệt bằng cách sử dụng bất kỳ và không có
Bạn có thể truy vấn các trường không bắt buộc bằng các giá trị đặc biệt any và none. any khớp với mọi giá trị không rỗng. none khớp với các giá trị rỗng. Để biết danh sách tất cả các nhãn trường được hỗ trợ bằng ngôn ngữ của cụm từ tìm kiếm, hãy xem Tài liệu tham khảo về cụm từ tìm kiếm.
Toán tử logic
Toán tử logic cho phép bạn chỉ định nhiều tiêu chí và cho biết mối quan hệ giữa các tiêu chí đó. Như đã lưu ý ở trên, các ký tự dấu cách bên ngoài dấu ngoặc kép đóng vai trò là toán tử AND ngầm ẩn. Công cụ theo dõi lỗi hỗ trợ thêm các toán tử logic rõ ràng sau đây:
| Đơn vị tổ chức | Biểu tượng thay thế | Nội dung mô tả | Ví dụ: |
|---|---|---|---|
| AND | {khoảng trắng} | So khớp xem vấn đề có chứa cả hai tiêu chí hay không | star:true AND componentid:46046 |
| OR | | | So khớp xem vấn đề có chứa một trong hai tiêu chí hay không | type:(Bug|feature_request) |
| KHÔNG | - | So khớp nếu vấn đề không chứa tiêu chí | -assignee:jim |
| "..." | Khớp xem vấn đề có chứa một cụm từ được trích dẫn hay không (các từ trong dấu ngoặc kép xuất hiện theo cùng một thứ tự) | comment:"We have a problem" |
|
| ( ) | Nhóm các giá trị hoặc tiêu chí tìm kiếm lại với nhau | status:open AND (priority:(p0|p1) OR severity:(s0|s1)) |
Xin lưu ý những điều sau:
Bạn phải sử dụng tất cả chữ cái viết hoa cho
AND,ORvàNOT.Toán tử
NOTcó cùng ý nghĩa cho dù nó đứng trước tên trường hoặc giá trị trường. Điều này có nghĩa là-assignee:jimvàassignee:-jimlà tương đương.Thoải mái sử dụng dấu ngoặc đơn để nhóm rõ ràng các cụm từ trong cụm từ tìm kiếm. Theo mặc định, Công cụ theo dõi lỗi liên kết
NOTvới thuật ngữ ngay sau đó và chỉ nhómORvới hai thuật ngữ đóng ngoặc. Ví dụ: cụm từ tìm kiếmtitle:(a OR b NOT c AND d)tương đương vớititle:((a OR b) AND (NOT c) AND d).
Vạch thẳng
Ký tự dấu gạch ngang (-) có nhiều ý nghĩa tuỳ theo ngữ cảnh trong cụm từ tìm kiếm:
Công cụ theo dõi lỗi coi dấu gạch ngang trước một từ trong nội dung tìm kiếm là toán tử
NOT. Ví dụ: tiêu chí tìm kiếm-assignee:nonehoặcassignee:-nonesẽ trả về tất cả các vấn đề có người được giao.Công cụ theo dõi lỗi coi các chuỗi được kết nối bằng ký tự dấu gạch ngang là được đặt trong dấu ngoặc kép. Ví dụ: tiêu chí tìm kiếm
state-of-the-arttương đương với"state of the art".Công cụ theo dõi lỗi coi các từ có dấu gạch nối trong trường vấn đề là các từ độc lập được phân tách bằng khoảng trắng. Tức là nếu một vấn đề có từ
state-of-the-arttrong tiêu đề và bạn thực thi cụm từ tìm kiếmtitle:(of art state the)hoặctitle:("state of the art"), thì vấn đề đó sẽ được trả về trong kết quả tìm kiếm.
Toán tử quy chiếu
Cú pháp cơ sở cho một tiêu chí tìm kiếm trường/giá trị là [field]:[value], trong đó ký tự dấu hai chấm (:) chỉ định rằng trường đã cho phải bằng hoặc chứa giá trị đã chỉ định để một vấn đề được trả về trong kết quả tìm kiếm.
Các trường chứa giá trị thời gian (created, modified, resolved, verified và một số trường tuỳ chỉnh nhất định) hoặc giá trị số đếm (duplicatecount, votecount, commentcount và cccount) hỗ trợ thêm các toán tử quy chiếu sau:
| Biểu tượng | Nội dung mô tả |
|---|---|
| < | So khớp một vấn đề nếu giá trị của vấn đề đó nhỏ hơn/trước giá trị tìm kiếm. |
| <= | So khớp một vấn đề nếu giá trị của vấn đề đó nhỏ hơn/trước hoặc bằng giá trị tìm kiếm của bạn. |
| > | So khớp một vấn đề nếu giá trị của vấn đề đó lớn hơn/sau giá trị tìm kiếm của bạn. |
| >= | So khớp một vấn đề nếu giá trị của vấn đề đó lớn hơn/sau hoặc bằng giá trị tìm kiếm của bạn. |
Số lượt tìm kiếm theo thời gian
Ngôn ngữ truy vấn tìm kiếm cung cấp cú pháp đặc biệt để so khớp các trường có chứa giá trị thời gian. Điều này cho phép Công cụ theo dõi lỗi tìm kiếm trong một khoảng thời gian hoặc trong khoảng thời gian tương đối theo yêu cầu.
Định dạng thời gian tuyệt đối
Định dạng để chỉ định thời gian là:
[yyyy]-[MM]-[dd]T[HH]:[mm]:[ss].
Ở định dạng này, [yyyy] là năm có 4 chữ số, [MM] là tháng có 2 chữ số, [dd] là ngày có 2 chữ số, [HH] là giờ gồm 2 chữ số của đồng hồ 24 giờ, [mm] là phút và [ss] là ngày giây. Tất cả thời gian đều theo giờ UTC.
Bạn có thể cung cấp mức độ cụ thể mà bạn muốn khi tìm kiếm các vấn đề được tạo ra tại, trước hoặc sau một thời điểm nhất định. Ví dụ: bạn có thể chỉ định created:2014-06 để tìm các vấn đề được tạo bất kỳ lúc nào trong tháng 6 năm 2014. Để cụ thể hơn, bạn có thể tìm kiếm created:2014-06-03T04 để tìm các vấn đề được tạo vào ngày 3 tháng 6 năm 2014 trong giờ thứ 4 (từ 4 đến 5 giờ sáng theo giờ UTC).
Phạm vi thời gian
Bạn có thể sử dụng hai ký tự dấu chấm (..) để chỉ định phạm vi thời gian trong tiêu chí tìm kiếm trường/giá trị. Cú pháp là [field]:[start time]..[end time]. Thời gian bắt đầu và thời gian kết thúc có thể có bất kỳ mức độ cụ thể nào mà bạn yêu cầu. Ví dụ: verified:2013..2015 trả về tất cả vấn đề đã xác minh trong năm 2013, 2014 hoặc 2015.
Định dạng thời gian tương đối
Bạn cũng có thể chỉ định thời gian theo ngày trước hôm nay. Để thực hiện việc này, hãy sử dụng định dạng [days]d, trong đó [days] là số ngày trong quá khứ mà bạn muốn đưa vào kết quả tìm kiếm. Ví dụ: bạn có thể sử dụng modified:5d để tìm các vấn đề đã được sửa đổi trong 5 ngày qua.
Khi sử dụng định dạng thời gian tương đối, toán tử phải là ký tự dấu hai chấm (:) như created:5d. Nếu muốn tìm các vấn đề không nằm trong phạm vi, bạn có thể sử dụng toán tử NOT hoặc -.
Ví dụ: -verified:10d trả về các vấn đề chưa được xác minh trong 10 ngày qua. Nếu muốn tìm các vấn đề đã được xác minh nhưng chưa được xác minh trong 10 ngày qua, bạn có thể sử dụng (-verified:10d) AND status:verified.
Tìm kiếm "Hôm nay" với số học ngày
Bạn có thể sử dụng mã thông báo today trong các lượt tìm kiếm theo thời gian để thay thế cho ngày hiện tại. Công cụ này hỗ trợ việc sử dụng số học theo ngày như today+10 và today-2.
Bạn cũng có thể sử dụng mã thông báo today với các khoảng thời gian như today-2..today+3.
Việc sử dụng mã thông báo today trong các lượt tìm kiếm đã lưu giúp truy vấn có thể sử dụng lại được.
Ví dụ:
created:todaymodified<=today-10nearestslo:today+10resolved:2024-02-29..today+2customfield1002:today..today+5
Lưu ý: Như đã đề cập ở định dạng thời gian tuyệt đối, các lượt tìm kiếm thời gian trong Công cụ theo dõi lỗi đều theo giờ UTC. Điều này cũng áp dụng cho các lượt tìm kiếm sử dụng today.