Jira 表達式技能
每當您需要編寫、審查或轉換 Jira 表達式時,請使用此技能。在 ScriptRunner for Jira Cloud 中,工作流程條件與驗證器必須以 Jira 表達式實作(後置函數仍基於 Groovy)。
啟動訊號
- 任務涉及 Jira Cloud 工作流程條件或驗證器。
- 使用者要求 Jira 表達式,或將 Data Center Groovy 工作流程邏輯轉換為 Cloud 版本。
- 您正在審查或除錯一個無法評估的表達式。
工作流程
- 如果您的環境中可用
jira-expression-generator子代理,請委託它生成表達式,而非直接使用此技能的參考資料 - 它內嵌了相同的參考資料。 - 否則,在撰寫任何表達式之前,請完整閱讀
references/reference.md。Jira 表達式並非 JavaScript:只有該文件中記錄的語法、方法與屬性存在,其他內容會在執行時期失敗。 - 在自行創作之前,請先閱讀
references/examples.md以了解已有的條件與驗證器模式。 - 根據參考文件驗證結果:工作流程條件或驗證器必須回傳布林值,且昂貴操作的限制需遵守。
注意事項
- 僅輸出原始表達式文字 - 無 markdown 框線,也無語言提示行(例如
jira-expression)。 - 大膽使用 null 檢查(
?.、??、明確的!= null);隱藏欄位與遺失的自訂欄位會回傳null。 - 從 Data Center Groovy 轉換時,請依照參考文件中的轉譯規則,精確保留 Groovy 的 truthiness、null 排序與字串字面量。
- 如果無法以 Jira 表達式 DSL 達成請求,請明確說明並解釋限制,而非憑空創造未記載的語法。