Smartsheet Jiraコネクタは、 Smartsheetと 1 つ以上の Jira インスタンスの間で情報を同期します。この記事では、Jira Cloud と Jira セルフホスト サーバーの両方でSmartsheet Jiraコネクタ をセットアップする方法について説明します。

プラン

• Business
• Enterprise
• Smartsheet Advanceパッケージ

プラン タイプと含まれる機能の詳細については、 「Smartsheetプラン」ページを参照してください。

許可

ワークフローを作成または編集するには、次の権限が必要です。

• Smartsheet環境ではライセンスを取得したユーザーである必要があります。これには、ワークフロー内でマップされたシートに対する編集者以上の権限が含まれます。
• ワークフローを構築する Jira プロジェクトへの適切なアクセス権を持つ、機能する Jira アカウントが必要です。

Jira 環境への最初の接続が、プランのプレミアムSmartsheet Jiraコネクタを通じて確立されていることを確認します。コネクタを構成するには、 Smartsheetと Jira のシステム管理者である必要があります。 この機能がSmartsheetリージョンまたはSmartsheet Gov に含まれているかどうかを確認してください。 Smartsheet Jiraコネクタはプレミアム オファリングとして利用できます。プランでSmartsheet Jiraコネクタを購入している場合は、ログインしてSmartsheetと Jira 間のワークフローの作成を開始します。

用語と権限の種類

始める前に、役立つ用語をいくつか紹介します。

• 接続: Smartsheetと特定の Jira インスタンス間のリンク。
• ワークフロー: Jira 要素をSmartsheetシートに接続するJiraコネクタ内のリンク。

次の 3 つのレベルのユーザーがSmartsheet Jiraコネクタを操作できます。

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

権限の種類別の機能

この表は、 Jiraコネクタを使用して特定のタスクを完了できるユーザーを示しています。

*Smartsheetシステム管理者とコネクタ管理者は、アクセス リストの制限機能が有効になっている場合、ワークフローを作成および編集できます。システム管理者がJiraコネクタで [ユーザーの制限] 設定を有効にしている場合は、 Smartsheetで Jira ユーザー ロールも保持している必要があります。

接続設定

Smartsheet Jiraコネクタの使用を開始するには、まずSmartsheetと Jira インスタンスの間の接続を設定し、ユーザーがワークフローを構築してSmartsheetと Jira の特定の要素を接続できるようにする必要があります。 

注記 

この接続を設定する前に、ファイアウォールの設定と構成をセットアップする必要がある場合があります。 

Smartsheet は、 Smartsheetと Jira の両方で汎用ライセンス付き電子メール アカウント (smartsheet-jira@yourdomain.com など) を使用して接続を確立することをお勧めします。これにより、接続の所有権は変更できないため、Jira リンクを管理するユーザーが組織を離れた場合に、接続やワークフローをやり直す必要がなくなります。 

注記 

Smartsheetシステム管理者ロールまたはSmartsheet Jiraコネクタ管理者ロールのみが必要ですが、 Smartsheet、コネクタを設定するには両方のロールを持つことをお勧めします。 

セットアップに使用されるアカウントは、Jira とSmartsheetの両方で管理者権限を持つアクティブな状態を維持する必要があります。このユーザーの管理者ステータスを削除すると、「このエンドポイントのユーザー資格情報が見つかりません」というエラーが発生します。管理者権限を復元すると接続が修正され、通常のワークフロー同期が再開されます。 Jira管理者の資格情報が削除された場合は、トークンの変更によりアプリケーション リンクを再構築する必要があります。 

Smartsheet Jiraコネクタを使用すると自動ワークフローの実装が可能になるため、Jira REST API を使用して Webhook を作成または構成するには、アプリケーションに Jira システム管理者の資格情報が必要です。 Jira システム管理者の資格情報は、Webhook の作成と構成にのみ使用されます。 

ステップ 1: Smartsheet Jiraコネクタに新しい Jira サーバーを登録する 

セルフホスト型 Jira サーバーとファイアウォールを使用してコネクタを設定する場合は、 「Jiraコネクタのファイアウォール設定」の手順に従ってください。

1. Smartsheet Jiraコネクタにログインします。 Smartsheetアカウントへのアクセスを許可するように求められたら、[許可] を選択します。
2. ページの左上隅にあるメニューを選択し、 [アカウント管理者]を選択します。
3. [新しい Jira サーバーの登録] を選択します。
4. 設定ページで:
   • Smartsheet環境に接続する Jira 環境の JIRA ホスト URL を入力します (例: https://mbfcorp.atlassian.net/)。
   • JIRA API URL はおそらく JIRA ホストと同じです。
   • [名前] については、デフォルトの名前を受け入れるか、よりわかりやすい記述子に変更します。
   • JIRA バージョンを選択します。
5. [設定]ページでこれらの項目を完了したら、[続行] を選択します。
6. [構成] ページで、コンシューマ キー、コンシューマ名、および公開キーを確認します。後で必要になるので、これらの値をコピーします。

ステップ 2: Jira でSmartsheetへのアプリケーション リンク (AppLink) を作成する

1. Jira にサインインします (Jira 管理者権限が必要です)。
2. Jira設定(右上隅の歯車アイコン) に移動し、[製品] を選択します。
3. [製品] ページの [統合] で、[アプリケーション リンク] を選択します。注記
   Jira の以前の自己ホスト型バージョンでは、 [設定] (歯車アイコン) > [アプリケーション] を選択し、[アプリケーション リンク] を選択します。 4. [リンクの作成] を選択します。
4.  [リンクの作成] ボックスが表示されます。次のようにフィールドに入力します。
   • Jira Cloud の場合は、[ダイレクト アプリケーション リンク] を選択し、アプリケーション URL にhttps://app.smartsheet.comと入力して、[続行] (または[新規作成]) を選択します。

 Image showing create a new link in Jira.

• Jira セルフホスト バージョン 9 以降の場合は、Atlassian 製品を選択し、アプリケーション URL としてhttps://app.smartsheet.comに移動して、[続行] (または [新規作成]) を選択します。

  

Jira 9 and above image 

5. 次のいずれかのメッセージが表示されたら、「続行」を選択し、新しい URL を変更しないでください。
   • 入力した URL から応答がありませんでした。無効である可能性があります。必要に応じて以下の URL を修正し、「続行」を選択してください。 -または-
   • 指定されたアプリケーション URL は一度リダイレクトされています。リダイレクトされた URL フィールドをチェックして、これが信頼できる URL であることを確認してください。
6. [レビュー リンク] または [アプリケーションをリンク] ボックスがポップアップ表示されます。次のようにフィールドに入力します。 

   

   Image showing link applications

• [アプリケーション名] ボックスに「 Smartsheet 」と入力します。
• [アプリケーション タイプ] では、デフォルト値の [汎用アプリケーション] を受け入れます。
• Jira セルフホスト v9 以降の場合は、[受信リンクの作成] ボックスをオンにします。
• 「続行」を選択します。

ステップ 3: アプリケーション リンクを編集する

1. ステップ 2 で作成したばかりのアプリケーション リンクについては、アプリケーション リンクの上にマウスを置くか、[編集] アイコン (バージョンに応じて) を選択すると表示される 3 点メニューを選択します。
2. [設定] ボックスが表示されます。 「受信認証」を選択します。
3. 次のようにフィールドに入力します。
   • サービス プロバイダー名 (必要な場合): Smartsheet
   • コンシューマ名: ステップ 1 でJiraコネクタからコピーしたコンシューマ名を貼り付けます。
   • コンシューマ キー: ステップ 1 で Jira コネクタからコピーしたコンシューマ キーを貼り付けます。
   • 公開キー/共有秘密: ステップ 1 でJiraコネクタからコピーした公開キーを貼り付けます。
   • 説明: 必要に応じて説明を追加します。
   • Jira 環境でリクエスト トークン URL、アクセス トークン URL、または認証 URL が必要な場合は、次の URL を使用してこれらのフィールドに値を入力します: https://api.smartsheet.com/2.0/token
4. [受信認証] の下部で [保存] を選択し、右下隅にある [閉じる] を選択します。

ステップ 4: Smartsheet Jira 接続を完了する

1. Smartsheet Jiraコネクタ構成に戻り (キーをコピーした [構成] ページにまだあるはずです)、 [続行] を選択します。
2. [接続] 画面で [接続] を選択して、 Smartsheet側からの接続を完了します。
3. ダイアログ画面で、 Smartsheet による Jira 環境への読み取りと書き込みを許可するかどうかを尋ねられます。 「許可」を選択します。

   

   Image showing Welcome to Jira Allow or Deny message 

これで、 Smartsheetと Jira 間の接続が設定されました。アカウントのライセンスを持つユーザーは、Jira のアイテムとSmartsheetのシートの間でワークフローを作成できるようになりました。 

注記 
Smartsheet Jiraコネクタを使用して、複数の Jira 環境をSmartsheetアカウントに接続できます。登録する追加の Jira インスタンスごとに上記の手順を繰り返します。

Smartsheet Jiraコネクタへのアクセスを制限する

Smartsheet Jiraコネクタ内でワークフローを構築できるユーザーをさらに制限したい場合は、アカウントで特定のライセンスを持つユーザーにアクセスを制限できます。 Jiraコネクタでできることは、追加の制限が有効になっているかどうかに関係なく、 Smartsheet (シート共有権限) と Jira (課題フィールドの読み取り/書き込み権限) の両方のアイテムに対する権限に常に依存します。 

コネクタは、Jira とSmartsheet の両方で付与された権限を尊重します。たとえば、コネクタでワークフローを作成した人に、Jira で特定のプロジェクト データを編集する権限がないとします。その場合、ワークフローはコネクタを介してそのプロジェクトのデータを編集できません。 

アクセスを制限するには 

Jiraコネクタ を使用してワークフローを作成できるユーザーを制限するには、 Smartsheetシステム/Jira管理者が[アクセス制限] 設定をオンにします。

1. Smartsheet認証情報を使用してSmartsheet Jiraコネクタにサインインします。
2. ページの左上隅にあるメニュー アイコンを選択し、[ユーザー管理] を選択します。
3. [Smartsheet JIRA 統合にアクセスできるユーザーを制限する] チェックボックスをオンにします。

 restrict access to the Smartsheet Jira Connector

1. コネクタにアクセスしたい人の電子メール アドレスを追加します。

アクセスを削除するには 

リストから削除されたユーザーは、ワークフローを作成または編集できなくなります。

1. Smartsheet認証情報を使用してSmartsheet Jiraコネクタにサインインします。
2. ユーザー管理に移動します。
3. その人のアカウント情報の右側にある削除アイコンを選択します。

コネクタの制限事項

1. Smartsheet Jiraコネクタの最大容量は 20,000 行で、Smartsheet の行制限と一致しています。
2. 最高のパフォーマンスを得るには、データのプルを一度に 10 プロジェクトに制限します。
3. 依存関係が有効になっている場合は、終了日列へのマッピングを避けてください。
4. コネクタは実行されるたびにシートを再ソートします。カスタム並べ替えにレポートを使用します。
5. Jira タスクを手動で並べ替えるとエラーが発生する可能性があります。代わりにカスタム グループ化を使用してください。
6. 一方向の接続制限があるため、タスクをSmartsheetではなく Jira スプリントに割り当てます。
7. イニシアチブ課題タイプを導入する Jira Portfolio アドオンはサポートされていません。
8. 大規模なプロジェクト計画に接続する場合、作業レベルの問題が発生する可能性があります。
9. システム生成の一意の ID および特定のプロジェクト設定列により、コネクタをマッピングするときに複雑な問題 (一方向またはマッピングなし) が発生する可能性があります。
10. ワークフロー更新時の権限関連のエラーを避けるために、両方のプラットフォームで管理者または編集者のアクセス権があることを確認してください。