Find my custom field ID number in Jira

お困りですか?

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

コミュニティに質問

プラットフォームについて: Cloud、Server、および Data Center - この記事はすべてのプラットフォームに等しく適用されます。

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Fisheye および Crucible は除く

要約

There are multiple methods to obtain custom field IDs for Jira and Jira Service Management products.
Having the custom field ID can be useful when working with API payloads or running SQL queries (Server or Data Center), which require the ID instead of the field name.

Inspect the custom field in the Issue View page

Using Chrome or Firefox, we can utilize the Developer Tools panel in order to quickly identify the ID of a custom field that's present on an issue page.
(info) This option does not require Jira Admin rights.

  1. Access an issue that has the custom field you want to find the ID for.
  2. Make sure that the field is filled, so that it shows on the issue view.
  3. Right-click on the field name and select "Inspect."
  4. 開発者ツールのパネルのスレッド末尾でカスタム フィールドの名前と ID を確認できます。例:

    issue-field-heading-styled-field-heading.customfield_XXXXXX

    a screenshot of a browser window. The left side shows Jira's issue view with a custom field highlighted. The right side shows developer tools including the custom field's ID value.

Search with Advanced JQL view

Using a combination of the List View and advanced JQL, we can identify the ID of a custom field that's listed on the results.
(info) This option does not require Jira Admin rights.

  1. Create a simple JQL to return an issue that includes the field you want.
  2. After running this query, switch to the "List View."
  3. 対象のフィールドを結果の列として追加します。
  4. 列でフィールド名をクリックし、対象のカスタム フィールドで結果を並べ替えます。
  5. JQL タイプが高度な検索ではない場合はそれに切り替えます。
  6. フィールドの ID がORDER BY 句に記載されます。
    Screenshot of issue search which includes an order by JQL clause. This clause includes the field ID number.

Use Jira Home Directory and DB Browser plugin

この手順はサーバーまたは Data Center 製品でのみ利用できます。

  1. 以降の手順を実行するには Jira 管理者の権限が必要です。
  2. Jira Home Directory And DB Browser をインストールします。  
  3. Db Console にナビゲートします。

  4. customfield テーブルを選択して実行します。

Check the URL in the custom fields list

以降の手順を完了するには Jira 管理グローバル権限が必要です。

  1. Navigate to Settings () > Issues > Custom fields under the Fields section.
  2. Click on the More () icon to the right of the custom field you want the ID for.
  3. Select the View field information option.
  4. ブラウザで URL を確認します。フィールドの ID が含まれています。
https://<your_jira_site>/secure/admin/ConfigureCustomField!default.jspa?customFieldId=10026

上記の例のカスタム フィールドの ID は 10026 です。

Use Jira REST API

The "Get Fields" endpoint

The Get Fields Jira Cloud API endpoint returns custom fields in a list. Please see the Cloud REST API documentation or the JIRA Server REST API references 8.13.9/8.18.1 and earlier or 8.13.10/8.18.2 and later for additional examples and rules relating to using this endpoint. The returned JSON data will need to be filtered to identify the field you are looking for and its ID.

ブラウザにペーストする、<JIRA_BASE_URL> を置き換える URL は次のとおりです。

  • <JIRA_BASE_URL>/rest/api/latest/field 

API からのレスポンスの例

{  
    "id": "customfield_10026",
    "key": "customfield_10026",
    "name": "Approvals",
    "untranslatedName": "Approvals",
    "custom": true,
    "orderable": true,
    "navigable": true,
    "searchable": true,
    "clauseNames": [
        "Approvals",
        "Approvals[Approvals]",
        "cf[10026]"
    ],
    "schema": {
        "type": "sd-approvals",
        "custom": "com.atlassian.servicedesk.approvals-plugin:sd-approvals",
        "customId": 10026
    }
}

The "Get Issue" endpoint

Get Issue REST API エンドポイントを利用して特定の課題の詳細情報を取得し、?expand=names パラメーターを追加して、スコープ内のすべてのカスタム フィールド名の一覧を取得できます。BS-1 の場合の例です。

  • <JIRA_BASE_URL>/rest/api/latest/issue/BS-1?expand=names 

出力の最後のセクションでフィールドを見つけ、"customfield_XXXXX" で ID を記録します (ここでは Sprint カスタム フィールドの ID が 10105、Story Points の ID が 10106 であることがわかります)。

names: {
...
customfield_10105: "Sprint",
customfield_10106: "Story Points",
...
}

XML へのエクスポート

課題で利用されているカスタム フィールドの ID は、Jira や Jira Service Management のユーザー インターフェイス内で課題を XML にエクスポートすることで取得できます。この方法では、課題に存在するフィールドについてのみフィールド ID が表示されます。

  1. Open the issue that you want to get the custom field ID for
  2. 右上の [アクション] () アイコンをクリックします。
  3. [XML にエクスポート] オプションを選択します。新しいタブが開き、課題の詳細が XML 形式で表示されます。
  4. フィールド名を検索してカスタム フィールド ID を取得します。


<customfield id="customfield_10026" key="com.atlassian.servicedesk.approvals-plugin:sd-approvals">
    <customfieldname>Approvals</customfieldname>
    <customfieldvalues> </customfieldvalues>
</customfield>

上記の例では、Approvals フィールドのカスタム フィールド ID が 10026 です。

データベースから

Please note, the Jira database can only be accessed directly while using Jira Server or Data Center products.

次の DB クエリを使います。

jiradb=# select id from customfield where cfname='Approvals' ;
  id   
-------
 10026
(1 row)

jiradb=#
最終更新日 2024 年 11 月 7 日

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

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