JIRA Service Desk Internationalization

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

プラットフォームについて: Server と Data Center のみ - この記事は、サーバーおよびデータセンター プラットフォームのアトラシアン製品にのみ適用されます。

要約

JIRA Service Desk allows for custom internationalization and localization text through the modification of the a properties file contained inside the plugin's JAR file.

  • This allows you to change text that appears in Service Desk including:
    • Field names
    • Help messages
    • Link buttons
    • Notifications / Emails to customers and participants (NOT agent notifications)
tip/resting Created with Sketch.

These instructions are for custom text. For translated versions of Service Desk visit https://translations.atlassian.com

Modification of plugin JAR files is possible however Atlassian Support does not provide assistance making these changes. Consequently, Atlassian cannot guarantee providing any support for these modifications.

If you encounter problems you should install a copy of JIRA Service Desk that has not been modified.  You can download these OBR files directly from the Marketplace version history pages below:


How to Add Internationalization

Inside of the plugin JAR file, modify sd-i18n.properties

tip/resting Created with Sketch.

The following is just one of the i18n files. There are multiple i18n files inside of the JIRA Service Desk .obr file.


Version 2.5.9 and older:

  • /jira-servicedesk-X.X.X.obr/jira-servicedesk-X.X.X.jar/i18n/sd-i18n.properties

Version 3.0.0 and newer:

  • /jira-servicedesk-application-X.X.X.obr/dependencies/jira-servicedesk-X.X.X.jar/i18n/sd-i18n.properties   

You will need to update this file each time you install a new version of JIRA Service Desk

tip/resting Created with Sketch.

How to modify plugin file:

Any method can be used, provided the plugin file is put back together correctly.

Download JIRA Service Desk

Here are two example methods for modifying the i18n files:

Method 1 (Windows Only)

  • Open the .obr file as an archive in 7zip
  • Navigate to i18n file you wish to change (double click any .jar to navigate into it)
  • Drag i18n file out of 7zip onto desktop
  • Modify i18n file and save
  • Drag i18n file back into same location in 7zip, Select Yes to confirm copy
  • Close 7zip. Be sure to click OK to update archive.

Method 2

  • Change .obr extension to .zip and unzip file
  • Now, find the .jar file inside of the unzipped folders, rename this to .zip and unzip
  • Next, find the sd-i18n.properties file and make your modifications
  • After that, re-zip the set of folders from the .jar and give this the same file name it originally had, ending with .jar
    • You can remove the unzipped folder after you have re-zipped the files
  • Finally, re-zip the set of folders from the .obr and rename this zip to be .obr.
    • The file name of the resulting .obr does not have to be the exact same as the original file name. You can add "modified" or something similar to the filename and it will not cause issues. Just make sure the resulting file is an .obr
例:

Modify these lines to change the public signup hint that appears on the customer login page:

  • cv.login.pub.signup.title=
  • cv.login.pub.signup.desc=






既知の問題点

The plugin JAR file must be reassembled after modifying the properties file. The resulting JAR must have the same folder structure as the original JAR.

If after re-zip and uploading the JAR file the changes does not affect JIRA Service Desk at all, try running the command below from inside the extracted set of folder with the modified translation:

jar cf ../<original JAR file name>.jar * 

例:

jar cf ../jira-servicedesk-application-3.8.2.jar *

最終更新日 2020 年 5 月 13 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.