Jira

Smartsheet for Jira コネクタを使用すると、Jira で追跡管理している IT プロジェクトやソフトウェア開発プロジェクトの進捗状況を確認できます。タスクや問題は、Smartsheet で編集しても Jira で編集しても自動的に同期されるため、レコードを常に最新の状態に保つことが可能です。

Jira コネクタとは?

Smartsheet for Jira コネクタ: 概要

Smartsheet for Jira を使用して、Smartsheet で Jira の課題を追跡および管理できます。 管理者が Smartsheet とJira (クラウドまたはセルフ ホスト サーバー) 間の接続を確立すると、適切な権限を持つユーザーは誰でも、ワークフローの追跡、進行状況の監視、2 つのサービス間での更新を行うことができます。

Smartsheet for Jira をお持ちではありませんか? 入手方法については、当社ウェブサイトの Smartsheet for Jira ページをご覧ください。

Smartsheet for Jira にログインする

Smartsheet for Jira を購入したら、次の URL からログインし、コネクタを設定します: https://connectors.smartsheet.com/c/jira

ブラウザーの互換性については、「Smartsheet を使用するためのシステム要件とガイドライン」を参照してください。

次のステップに関するリソース

管理者向け

コネクタのセットアップの詳細な手順については、Smartsheet ヘルプ センターの次の記事を参照してください。

同期ワークフローを作成したい人向け

Smartsheet for Jira コネクタでワークフローを作成して、2 つのシステム間のデータの自動同期を制御できます。

ワークフローを作成または編集するには、Smartsheet のライセンス ユーザーである必要があります。 また、接続しているプロジェクトにアクセス可能な Jira のアカウントも必要です。

ガイダンスとベスト プラクティスについては、Smartsheet ヘルプ センターの次の記事を参照してください。

Jira コネクタの設定方法をご覧ください。

Smartsheet for Jira コネクタ: 管理のセットアップ (クラウドおよびセルフ ホスト型)

Smartsheet for Jira コネクタを使用して、Smartsheet と 1 つ以上の Jira インスタンス間で情報を同期するワークフローを作成できます。コネクタは、製品およびソフトウェア開発者間のコラボレーション、IT チケットの発行およびケース管理、技術チームと非技術チーム間のプロジェクトのロールアップおよびエグゼクティブ レポート作成など、さまざまなビジネス プロセスの自動化と合理化に役立ちます。

この記事では、Jira Cloud および Jira セルフホスト型サーバーで Smartsheet for Jira コネクタをセットアップする手順について説明します。

Smartsheet for Jira コネクタは、プレミアムサービスとしてご購入いただけます。 その機能およびメリットの詳細については、「Smartsheet for Jira コネクタでチームを統合する」を参照してください。 プランと価格およびご購入に関する詳細については、当社のセールスチームにお問い合わせください

セルフホスト型 Jira サーバーでコネクタを設定し、ファイアウォールを使用する場合は、記事「Jira コネクタファイアウォールの要件」を参照してください。この記事では、接続を構成する前に満たす必要のあるサーバーとファイアウォールの要件について説明しています。

このページの内容

Smartsheet for Jira コネクタにログインする
はじめる前に: 要件
Jira と Smartsheet 間の接続をセットアップする
Smartsheet で使用するために Jira ホストを設定する
統合アクセスを管理する

はじめる前に: 要件

Smartsheet for Jira コネクタが 2 つのシステム間のデータの自動同期を制御できるようにするワークフローを作成します。 これを行う前に、コネクタを購入して構成する必要があります。プランと価格およびご購入に関する詳細については、当社のセールスチームにお問い合わせください

Cloud ユーザーは、Atlassian が最近行ったプライバシーの変更を確認する必要があります。 詳細については、Smartsheet for Jira: Jira Cloud プライバシーの重要な変更をご覧ください。

必要な権限タイプ

Smartsheet for Jira コネクタをセットアップするには、Jira アプリケーションの管理者である必要があります。 また、次のいずれかの役割も必要です。

  • Smartsheet システム管理者 詳細については、「ユーザー タイプ」をご覧ください。
    -または-
  • コネクタ管理者 (このアカウント レベルの役割は、Smartsheet for Jira コネクタに固有のものです。詳細については、「Smartsheet for Jira の権限タイプ」を参照してください)。

FAQ: Jira 管理者がログインして Smartsheet for Jira コネクタを構成する必要があるのはなぜですか?

セットアップを確実に完了するためには、以下のものが必要です。

  • 使用する予定の Jira ホストへのパス (URL)
  • Smartsheet が Jira に提供するコンシューマー キーとパブリック キー これらを取得するには、「Jira と Smartsheet 間の接続をセットアップする」の下の手順に従ってください。
  • Jira Cloud、またはセルフホスト型 Jira サーバー用 Jira バージョン 7.2 以降。
  • スプリント フィールドのサポート。 スプリント フィールドは、6.7.7 より前のバージョンではサポートされていないことに注意してください。 (お使いの Jira バージョンがスプリント フィールドをサポートできない場合、スプリント フィールドはコネクタに表示されません。)
  • 2 つの管理者レベルのアカウント:
    • Smartsheet システム管理者: コネクタの管理機能にアクセスするには
      -および-
    • Jira 管理者: Jira にアクセスして設定するには

Smartsheet for Jira コネクタにログインする

Smartsheet for Jira を購入したら、次の URL からログインし、コネクタを設定します: https://connectors.smartsheet.com/c/jira 

重要: セルフホスト型 Jira サーバーでコネクタを設定し、ファイアウォールを使用する場合は、記事「Jira コネクタファイアウォールの要件」を参照してください。この記事では、接続を構成する前に満たす必要のあるサーバーとファイアウォールの要件について説明しています。

Jira と Smartsheet 間の接続をセットアップする

Smartsheet で使用する Jira のインスタンスを登録するには、Smartsheet および関連づける Jira インスタンスの両方で管理者レベルの権限が必要です。

Jira インスタンスをコネクタに登録する

Jira インスタンスをコネクタに登録するには:

  1. Web ブラウザーから、Smartsheet for Jira コネクタのログイン ページに移動し、[Log In with Smartsheet (Smartsheet でログイン)] をクリックします。
  2. Smartsheet アカウントへのアクセスを許可するように求められたら、[許可] をクリックします。

    [Add Workflow (ワークフローの追加)] ページが表示されます。
     
  3. 左上のメニューをクリックし、[アカウント管理] をクリックします。

    アカウント管理
     
  4. [Register New Jira Server (新規 Jira サーバーの登録)] を選択します。

  5. 表示されるフォームに、使用する Jira ホストの URL を入力します。

  6. デフォルト名を受け入れるか変更し、Jira のバージョンを選択して、[続行] をクリックします。

Jira の複数のインスタンスを同時にコネクタに登録できます。 登録する追加の Jira インスタンスごとに上記の手順を繰り返します。

Smartsheet for Jira コネクタは、Jira で2つのサービス間の安全な接続を確立するために使用するパブリック キーとコンシューマー キーを提供します。 次のセクションの手順に従って、Smartsheet で使用する Jira ホストを構成し、セットアップを完了してください。

Smartsheet と Jira の両方で汎用サービス アカウント (例: smartsheet-jira@yourdomain.com) を使用して、Jira への接続をセットアップすることをお勧めします。 接続所有者は変更できないため、汎用アカウントを使用すれば、Jira への接続を管理する個人が組織を離れる場合に接続またはワークフローを再構築する必要がなくなります。

Smartsheet で使用するために Jira ホストを設定する

Jira と Smartsheet 間の接続を有効にするには、2 つのシステム間にアプリケーション リンク (Jira ドキュメントでは AppLink とも呼ばれます) を確立して構成します。

重要: セルフホスト型 Jira サーバーでコネクタを設定し、ファイアウォールを使用する場合は、記事「Jira コネクタファイアウォールの要件」を参照してください。この記事では、接続を構成する前に満たす必要のあるサーバーとファイアウォールの要件について説明しています。

アプリケーション リンクを作成する

Jira アプリケーションで AppLink を生成するには:

  1. Jira の管理者権限で Jira にサインインします。
  2. [Jira Settings (Jira の設定)] に移動します。
  3. [Products (製品)] を選択し、[Integrations (統合)] で [Application Links (アプリケーションリンク)] をクリックします。
    注: Jira の以前のセルフ ホスト型バージョンでは、Jira 歯車アイコン (Jira-Gear-Icon) > [Applications (アプリケーション)] を選択後、[Application Links (アプリケーション リンク)] を選択します。
  4. リンクしたいアプリケーションの URL (https://app.smartsheet.com) を入力し、[Create new link (新しいリンクを作成)] をクリックします。

    注: 次のいずれかのメッセージが表示されたら、[続行] をクリックして、新しい URL をそのままにします。 (これは後で修正します):
    • 入力した URL から応答がありませんでした - URL が有効でない可能性があります。必要に応じて以下の URL を修正し、[続行] をクリックしてください。


      -または-
       
    • 指定されたアプリケーション URL は一度リダイレクトされています。 リダイレクトされた URL フィールドをチェックして、これが信頼できる URL であることを確認してください。
       
  5. [Link applications (アプリケーションのリンク)] ダイアログ ボックスの [Application Name (アプリケーション名)] ボックスに「Smartsheet」と入力します。 [アプリケーションのタイプ (Application Type)] は、デフォルト値の [Generic Application (ジェネリック アプリケーション)] をそのまま使用し、[続行] をクリックします。

    applinks

アプリケーション リンクが正常に作成されたことを示すメッセージが表示されます。 次のセクションの手順に従って、アプリケーション リンクを設定してください。

アプリケーション リンクを設定する

これらの手順を完了するには、Smartsheet for Jira コネクタのパブリック キーとコンシューマー キーをご用意ください。 これらを取得するには、「Jira と Smartsheet 間の接続をセットアップする」の上の手順に従ってください。

  1. Jiraの [アプリケーション リンクの設定] ページ (jira-system-dashboard> [設定] > [アプリケーション] を選択し、メニューで [アプリケーション リンク] を選択) で、前のセクションで作成した Smartsheet アプリケーション リンクを見つけ、[編集] アイコン Jira-edit-icon をクリックします。

    注: Jira の以前のセルフ ホスト型バージョンでは、Jira-Gear-Icon > [Applications (アプリケーション)] を選択後、[Application Links (アプリケーション リンク)] を選択します。
     
  2. [Configure (設定)] ダイアログボックスで [Incoming Authentication (受信認証)] をクリックし、適切なボックスにパブリック キーとコンシューマー キーを貼り付けます。

    ヒント: パブリック キー ボックスを見つけるには、スクロールする必要があります。
     
  3. Jira 環境でトークン リクエスト URL、トークン アクセス URL、または認証 URL が必要な場合は、次の URL を使用してこれらのフィールドに入力してください。

    https://api.smartsheet.com/2.0/token

    注: コンシューマ キーと共有シークレットが必要な場合は、Jira コネクタの設定ウィンドウからコンシューマー キーとパブリック キーを使用します。
     
  4. ダイアログ ボックスのスクロールを続行し、[保存] ボタンをクリックして、[閉じる] をクリックします。

その他のアプリケーション リンク Jira ドキュメント

Jira のアプリケーション リンクの詳細については、Jira のドキュメントを参照してください。

内容参照先
AppLinks の動作と Jira 内での AppLinks の作成プロセスを説明する Atlassian の公式サポート記事Using AppLinks to link to other applications (AppLinks を使用して他のアプリケーションにリンクする) -
接続、診断、トラブルシューティング、およびアプリケーション リンクを使用したセキュリティに関連する、Atlassian が提供しているその他のドキュメントApplication Links Documentation (アプリケーション リンクに関するドキュメント)

コネクタのアクセスとワークフローのアクセス権限を管理する

コネクタでできることは、有効になっている制限、およびSmartsheet (シートの共有権限) と Jira (フィールドの読み取り/書き込み権限の発行) の両方のアイテムに対して持っている権限によって異なります。

コネクタ ワークフローはアプリケーション固有の権限を尊重します

コネクタは、Jira アプリケーションと Smartsheet アプリケーションの両方で許可された権限を尊重します。 このため、コネクでは両方のアプリケーションでそのユーザーに付与された権限に従って、データの読み取り、書き込み、更新、および削除を行うことができます。

たとえば、コネクタでワークフローを作成した人が Jira アプリケーションで特定のプロジェクトのデータを編集する権限を持っていない場合、作成したワークフローでコネクタを介してそのプロジェクトのデータを編集できません。

FAQ: Smartsheet は Jira コネクタを使用してどの Jira データにアクセスしますか?

コネクタにアクセスできるユーザーを管理する

Smartsheet システム管理者とコネクタ管理者は、コネクタにアクセスできるユーザーを制御できます。 Smartsheet システム管理者は、特定のユーザーのみが独自のワークフローを作成および編集できるように、コネクタへのアクセスを制限する設定を有効にする必要があります。

ヒント: コネクタ ユーザーは、作成したコネクタ ワークフローを介して Smartsheet および Jira のデータを変更できます。 このため、システム管理者とコネクタ管理者は、Smartsheet と Jira の両方のアプリケーションに関する深い実務知識を持つ組織内のユーザーのみにアクセスを制限することをお勧めします。

Smartsheet システム管理者がコネクタへのアクセスを制限する手順は次のとおりです。

  1. Smartsheet の資格情報で、Smartsheet for Jira コネクタ (https://connectors.smartsheet.com/c/Jira) にサインインします。
  2. 左上のメニューをクリックし、[ユーザー管理] を選択します。
  3. [Restrict which users can access the Smartsheet for Jira integration (Smartsheet for Jira の統合機能にアクセスできるユーザーを制限する)] の横にあるチェックボックスにチェックを入れます。

    Jira へのアクセス制限
    以前にワークフローを作成したことがあるユーザーのメール アドレスは、
    統合機能へのアクセスが許可されているユーザーのリストに追加されます。
     
  4. コネクタにアクセスするユーザーのメール アドレスを追加します。

注: ユーザーの制限の設定を有効にすると、Smartsheet のユーザー管理フォーム内で Jira コネクタへのアクセスをユーザーに許可できるようになります。 Jira コネクタ ユーザーというユーザー レベルのアクセス許可が Smartsheet システム管理者に表示され、Smartsheet システム管理者は Smartsheet からコネクタへのアクセス権をユーザーに付与できます。

ユーザー管理 Jira チェックボックス

コネクタへのアクセスを取り消す

Smartsheet システム管理者とコネクタ管理者は、そのユーザーのアカウント情報の右側にある [削除] アイコン delete-user-icon をクリックして、コネクタ ユーザーを削除することもできます。
リストから削除されたユーザーは、独自のワークフローを作成したり編集したりすることができなくなります。

注: アクセス リストから削除されたユーザーが以前にワークフローを作成していた場合、そのワークフローは最大で 10 分間有効なままになります。 それ以降は、そのワークフローは自動的に無効になります。

Smartsheet システム管理者は、Smartsheet アプリケーションで Jira コネクタ管理者と Jira コネクタ ユーザーを管理することもできます。 Smartsheet アプリケーションからユーザーを管理する方法の詳細については、記事「ユーザーの管理」を参照してください。

FAQ: Jira パスワードは保存されますか?


Smartsheet for Jira コネクタの権限タイプ

Smartsheet for Jira コネクタを操作できるのは、次の 3 つのユーザー タイプです。

  • Smartsheet システム管理者 — Smartsheet アプリケーションで Jira コネクタ管理者と Jira コネクタ ユーザーを管理できます。システム管理者は、コネクタへのアクセスを制限する設定を有効にすることもできます。
  • Jira コネクタ管理者 — コネクタに対する一意のユーザー タイプ。 Jira コネクタ ユーザーを指定し、アクセス制限リストにユーザーを追加できます (システム管理者がこの設定を有効にした後)。
  • Jira コネクタ ユーザー — コネクタに対する一意のユーザー タイプ。 Smartsheet と Jira の間で情報を同期するワークフローを作成できます。 (これは、ユーザー制限リストの設定がコネクタで有効になった後にのみ使用可能です。)

ユーザー タイプ別の機能

次の表は、ユーザー タイプに応じた Smartsheet for Jira コネクタでの操作レベルの概要を示しています。

 Smartsheet システム管理者Jira 管理者Jira ユーザー
コネクタでワークフローを作成するはい*はい*はい
独自のワークフローを編集するはい*はい*はい
独自のワークフローを無効化するはい*はい*はい
全員のワークフローを表示するはいはいいいえ
他のユーザーのワークフローを無効化するはいはいいいえ
他のユーザーのワークフローを有効化または実行するいいえいいえいいえ
どのユーザーのワークフローで使用されている Jira プロジェクトとシートも表示できるはいはいいいえ
コネクタで Jira サーバーを表示および構成するはいはい 
誰かを Jira ユーザーにするはいはいいいえ
誰かを Jira 管理者にするはいいいえいいえ
誰かを Smartsheet システム管理者にするはいいいえいいえ
アクセス制限設定を有効にするはいいいえいいえ
アクセス制限リストにユーザーを追加する (制限を有効にした後)はいはいいいえ

* Smartsheet システム管理者およびコネクタ管理者は、アクセス リストの制限機能が無効になっている場合、独自のワークフローを作成および編集できます。 アクセス制限リストが有効になっている場合は、コネクタ ユーザーの役割が必要です。 アクセス制限リストの詳細については、「コネクタにアクセスできるユーザーを管理する」を参照してください。


Jira コネクタ に関する FAQ

Jira 管理者がログインして Smartsheet for Jira コネクタを構成する必要があるのはなぜですか?

Smartsheet は、webhook と呼ばれるテクノロジーを活用しています。これにより、コネクタは Jira で作成または更新されている課題について Jira から通知を受け取り、自動ワークフローを実装できます。 Jira の権限モデル (webhook に関する Jira サポート記事を参照) では、Jira REST API を使用して webhook を作成または構成するには、アプリケーション (この場合は Smartsheet) に Jira システム管理者の資格情報が必要です。 以下の点について留意してください。

  • Jira システム管理者の資格情報は、webhook の作成と構成にのみ使用されます。
  • Smartsheet ライセンス ユーザーは Smartsheet for Jira コネクタでワークフローを作成するたびに、OAuth プロトコルを使用して自分の Jira アカウントでログインする必要があります。 これにより、ユーザーが Jira プロジェクトとフィールドを選択し、Smartsheet から Jira データを取得または編集しようとするときに、Jira でユーザーに対して既に設定されている権限が適用されます。
  • webhook 通知からトリガーされた場合でも、Smartsheet がワークフローの実行中に Jira のデータを読み取りまたは編集する場合、これは常にワークフローを作成した人の資格情報を使用して実行されます。
  • すべての「資格情報」は標準化された OAuth プロトコルから取得され、Smartsheet は Jira のユーザー名またはパスワードにはアクセスできません。

統合機能の初期セットアップで使用した Jira システム管理者アカウントは、共同作業者が引き続きワークフローを作成して webhook を作成できるように、アクティブなアカウントかつ Jira システム管理者のままにする必要があります

注: システム管理者が Smartsheet から削除されると、次のようなエラーが返されます。「このエンドポイントのユーザー資格情報がありません。」 同じユーザーに対して Smartsheet システム管理者権限が回復されると、接続が復旧し、すべてのワークフローが期待どおりに同期を開始します。 Jira 側で管理者資格情報が削除された場合、トークンが変更されるため、アプリケーション リンクを再構築する必要があります。

Smartsheet は Jira コネクタを使用してどの Jira データにアクセスしますか?

Smartsheet は、誰かが作成したワークフローで指定されたデータのみを取得します。 ワークフロー作成者は、Jira プロジェクトの関連フィールドを Smartsheet のシートと列にマッピングし、フィルターする特定のフィールドを選択することにより、同期するデータを指定します。

Smartsheet は、ワークフローの作成時に選択された Jira プロジェクトのすべてのフィールドのリストなど、特定の種類のメタデータを取得します。 これによりユーザーは Jira コネクタにアクセスできるようになり、そのプロジェクトで利用可能な任意のフィールドをマッピングできます。 他のメタデータには、指定された Jira プロジェクトで使用可能なユーザーのリストなどが含まれます。これにより、Smartsheet アプリケーション内から Jira で課題を割り当てることができます。

注: メタデータとデータの取得はすべて、システム管理者の資格情報ではなく、Jira ユーザーの OAuth 資格情報を使用して行われます。 これにより、ユーザーがプロジェクトとフィールドを選択する際、および Smartsheet から Jira データを取得または編集しようとする際に、Jira の権限が強制的に適用されます。

Jira パスワードは保存されますか?

すべての「資格情報」は標準化された OAuth プロトコルを介して取得され、Smartsheet は Jira ユーザーのパスワードにアクセスできません。


ワークフローを作成および編集して Smartsheet と Jira を同期する

Smartsheet for Jira コネクタのセットアップが完了しました。2 つのシステム間の同期プロセスの詳細については、「ワークフローの作成と編集」に関する記事を参照してください。