編輯JIRA項(xiàng)目的鍵不是一個(gè)簡(jiǎn)單的任務(wù)。當(dāng)創(chuàng)建項(xiàng)目時(shí)，你應(yīng)該選擇一個(gè)滿(mǎn)足長(zhǎng)期需求的鍵，而不是根據(jù)項(xiàng)目創(chuàng)建之后再更改。不過(guò)，也有需要更改現(xiàn)有項(xiàng)目鍵的情況，如更改產(chǎn)品名稱(chēng)。

本頁(yè)面主要教大家如何更改項(xiàng)目的鍵，以及描述這種變化所帶來(lái)的影響。

首先

• 項(xiàng)目鍵的格式必須是JIRA限制規(guī)定的格式。默認(rèn)情況下，項(xiàng)目鍵格式必須至少為2個(gè)字符，并且只包含大寫(xiě)字母。
  你可以更改項(xiàng)目鍵的格式來(lái)實(shí)現(xiàn)不同的限制。
• 在低使用率期間執(zhí)行此更改—當(dāng)保存更新項(xiàng)目鍵時(shí)JIRA將啟動(dòng)后臺(tái)重新索引。這可能會(huì)對(duì)實(shí)例的性能產(chǎn)生影響。注意，不能選擇 “Lock JIRA and rebuild index”，盡管它會(huì)使后臺(tái)索引變快，但是將受限于項(xiàng)目的問(wèn)題。
• 將更改傳達(dá)給用戶(hù) - 確保你知道更改項(xiàng)目鍵的后果，且用戶(hù)已做好充分準(zhǔn)備。

編輯項(xiàng)目鍵

1. 導(dǎo)航到JIRA項(xiàng)目，并訪問(wèn)項(xiàng)目管理頁(yè)面。選擇Project Administration（項(xiàng)目導(dǎo)航欄的底部）。
2. 選擇Edit Project按鈕。
3. 選擇Key字段旁邊的edit key。
4. 更改鍵并點(diǎn)擊Update。
   

注意：

• 頁(yè)面上的其它字段，保存后可以直接看到更改后的信息。而不需要等待重新索引完成。
• 不要取消后臺(tái)重新索引。如果取消，那么搜索與項(xiàng)目有關(guān)的問(wèn)題時(shí)將出錯(cuò)。如果需要取消，你可以稍后再取消。

更新任務(wù)

• Fix the project entity links?—?當(dāng)你把JIRA和其它Atlassian應(yīng)用程序鏈接時(shí)，JIRA項(xiàng)目和其他應(yīng)用程序相關(guān)的項(xiàng)目（如Confluence spaces）之間的實(shí)體鏈接會(huì)被自動(dòng)創(chuàng)建。如果JIRA項(xiàng)目的鍵更改了，那你需要修改項(xiàng)目的實(shí)體鏈接。
• Updating JIRA Agile board filters?-?如果JIRA敏捷主板使用舊項(xiàng)目鍵，過(guò)濾器板需要更新到新的項(xiàng)目鍵。否則，版上可能不會(huì)顯示更名后的項(xiàng)目問(wèn)題。

變更管理注意事項(xiàng)

編輯項(xiàng)目的鍵是一個(gè)大的更改，多數(shù)情況下， 期望JIRA項(xiàng)目以新鍵運(yùn)行。注意以下少數(shù)情況。

• 舊的項(xiàng)目鍵可用于JQL查詢(xún) - 用戶(hù)將不必更新引用舊項(xiàng)目鍵的問(wèn)題過(guò)濾器。
• 如果將Confluence和JIRA一起使用，Confluence中的JIRA問(wèn)題宏將繼續(xù)有效。注意，如果你沒(méi)有馬上看到更改，是因?yàn)榫彺娓滦枰獣r(shí)間。
• 你不能使用舊的項(xiàng)目鍵來(lái)創(chuàng)建一個(gè)新的項(xiàng)目。但你可以將重命名的項(xiàng)目改回舊的項(xiàng)目鍵。如果刪除該項(xiàng)目，所有相關(guān)的鍵將被釋放，你就可以重新使用它們。
• 無(wú)論是來(lái)自JIRA內(nèi)部或是外部的鏈接都將正常工作。然而，鏈接別名不會(huì)被更新 - 例如，如果有一個(gè)鏈接到名為“EXAMPLE-1”的鏈接，將該項(xiàng)目的鍵“EXAMPLE”改為“DEMO”后，別名'EXAMPLE-1'不會(huì)更新為'DEMO-1'，但該鏈接還是會(huì)鏈接到DEMO-1。
• 如果你在全局過(guò)濾器使用Activity Stream小工具，你需要在項(xiàng)目重命名后更新過(guò)濾器。
• 當(dāng)項(xiàng)目的鍵更改后所有附件也可訪問(wèn)。但注意，它們的存儲(chǔ)目錄（<JIRA Home>\data\attachments）將保留舊的項(xiàng)目鍵。例如，如果把項(xiàng)目的鍵從TEST改為DEMO后，附件的存儲(chǔ)目錄仍是<JIRA Home>\data\attachments\TEST。
• 如果導(dǎo)出一個(gè)重命名的項(xiàng)目再將其導(dǎo)入，將顯示更新后的項(xiàng)目鍵，即不會(huì)保留原來(lái)的項(xiàng)目鍵。事實(shí)上，該項(xiàng)目的所有歷史鍵都將被移除。有一種解決方法，就是直接在你的數(shù)據(jù)庫(kù)修改數(shù)據(jù)。

相關(guān)話(huà)題

Changing the maximum project key length?—?你可以修改項(xiàng)目鍵的最大字符長(zhǎng)度。導(dǎo)航到JIRA管理控制臺(tái)的General Configuration頁(yè)面修改Maximum project key size字段。
Changing the project key format?—?你可以修改項(xiàng)目鍵的格式，但當(dāng)創(chuàng)建或編輯項(xiàng)目鍵時(shí)，這將限制其格式。

開(kāi)發(fā)人員注意事項(xiàng)

• 在項(xiàng)目鍵更改后REST API調(diào)用指定關(guān)鍵問(wèn)題時(shí)仍用舊的項(xiàng)目鍵。例如，項(xiàng)目鍵從EXAMPLE 改為 DEMO后，/rest/api/issue/EXAMPLE-100仍可用。
• ProjectUpdatedEvent事件被創(chuàng)建，任何時(shí)候項(xiàng)目的細(xì)節(jié)包括項(xiàng)目的鍵發(fā)生改變?cè)撌录⒈挥|發(fā)。
• 要想檢索所有問(wèn)題鍵和項(xiàng)目鍵，你可以通過(guò)以下方式：
  REST:
  • 獲取所有項(xiàng)目鍵: /rest/api/2/project/<project key>?expand=projectKeys
  Java API:
  • 獲取所有項(xiàng)目鍵: com.atlassian.jira.project.ProjectManager#getAllProjectKeys
  • 獲取所有問(wèn)題鍵: com.atlassian.jira.issue.IssueManager#getAllIssueKeys

相關(guān)產(chǎn)品購(gòu)買(mǎi)請(qǐng)咨詢(xún)""。