Smartsheet Jira Connector は、プレミアム サービスとして提供されています。ご利用のプランで Smartsheet Jira コネクタを購入している場合は、ログインしてSmartsheet と Jira 間のワークフローを作成します。
USM Content
同期エラーを特定し修正する
ワークフローのエラーを特定し解決するために以下のリソースを使用できます。
- 実行履歴:このページでは、ワークフローに関する同期エラーの件数や、エラー メッセージ、問題の詳細などを確認できます。
- エラー レポート:問題が発生すると、ワークフロー所有者および問題の原因となったフィールドやワークフロー行を編集したユーザーに電子メールが送信されます。
- エラー列:同期エラーが発生している行のメッセージを表示するには、お使いのシートでこの列を確認します。
実行履歴
ワークフローを作成すると、Run History (実行履歴)ページで同期履歴や発生したエラーの情報を見ることができます。Run History (実行履歴)にアクセスするには、Last Run (最終実行日)にあるワークフローのタイムスタンプを選択します。
実行履歴には、以下の実行タイプがあります。
- Sync to Smartsheet (Smartsheet に同期): Smartsheet に同期された Jira からの変更に対してワークフローが実行されます。
- Sync to Jira (Jira に同期): Jira に同期された Smartsheet からの変更に対してワークフローが実行されます。
- Filtered Row Finder (フィルターされた行の検索):ワークフローは、ワークフロー構成に従って除外する必要がある課題に対する変更に対して実行されます。Filtered Row Finder (フィルターされた行の検索)は、2 時間ごとに実行されるバックグラウンド プロセスです。フィルターで除外された課題は、シートのFiltered Out by Connector—Not Synced (コネクタによってフィルターから除外—非同期)階層に追加されます。Filtered Row Finder (フィルターされた行の検索)プロセスは、自動化されたワークフロー タイプでのみ実行されます。このプロセスは、ワークフローでフィルターを指定していない場合でも実行されます。
一般的なエラー
問題が発生すると、ワークフローの所有者および問題の原因となったワークフローの問題/行を編集したユーザーに、エラー レポートが電子メールで送信されます。一般的なエラーと課題をいくつかご紹介します。
フィールド [グループ] が設定されていません
件名 | 詳細 |
|---|---|
詳細 | Jira でグループの値が設定されていない課題は、「Field group not set (フィールド グループ未設定)」という名前の階層に表示されます。 |
トラブルシューティング | Jira の課題にグループ化の価値を与える |
Filtered out by connector - Not Synced (コネクタによってフィルターから除外 - 非同期)
件名 | 詳細 |
|---|---|
詳細 | これは、Salesforce コネクタと Jira コネクタで発生します。Filtered out by connector - Not Synced (コネクタによってフィルターから除外 - 非同期) 行を選択しても、同期の問題が発生している行は追加されません。Jira で削除されたアイテム、または Jira フィルター条件を満たさなくなったため Jira と同期していない行のみが表示されます。 |
トラブルシューティング |
|
フィールド を設定できません。適切な画面上にないか、不明です。)
件名 | 詳細 |
|---|---|
詳細 | このエラーは、設定したいフィールド値が Jira の Edit (編集) 画面にない場合に表示されます。Jira の Edit (編集) 画面のフィールドのみが、Smartsheet Jira Connector から編集可能です。 |
トラブルシューティング |
|
通知の設定に失敗しました
件名 | 詳細 |
|---|---|
詳細 | Jira コネクタで、Webhook を介して Jira から変更通知を受信できません。この場合、コネクタは Jira で更新を検出して Smartsheet に同期できません。 |
トラブルシューティング | Jira で Webhook の登録を確認する:
Jira システム管理者の権限を確認します。
コネクタを再認証します。
Jira ファイアウォールまたはネットワークの制限を確認します (セルフホスト型 Jira のみ)。
Jira アプリケーションの更新で Webhook が壊れていないことを確認します。
|
上記の手順を実行しても問題が解決しない場合は、Smartsheet サポートに連絡し、ワークフロー実行サポート情報 (WEX) ファイルを提供して、迅速に解決できるようにします。以下の「サポート用の WEX ファイルの生成」をご覧ください。
サポート用の WEX ファイルを生成
上記のトラブルシューティング手順を実行してもサポートが必要な場合は、サポートに連絡する前にワークフロー実行サポート情報 (WEX) ファイルを生成すると、チームが問題をより迅速に診断し、やり取りを減らすことができます。
WEX ファイルには、フィールド マッピング、同期方向、フィルター設定など、ワークフローに関する詳細情報が含まれています。Smartsheet や Jira のデータは含まれません。
Smartsheet システム管理者やコネクタ管理者は、次の手順で WEX ファイルを生成できます。
- https://connectors.smartsheet.com/c/jiraでログインします。
- Jira コネクタ ダッシュボードで、影響を受けるワークフローの「Run Date (実行日)」列にあるタイムスタンプを選択します。これにより、ワークフローの実行履歴が開きます。
- 最新の実行の[Last Run (最終実行日)] にあるタイムスタンプを選択します。
- 次のページで、ハンバーガー メニュー (左上の 3 本の横線) を開き、 [Download Workflow Execution Support Info (ワークフロー実行サポート情報のダウンロード)]を選択します。
サポート チケットを送信する際、または Smartsheet サポートと共有する際に、このファイルを添付してください。
WEX ファイルは JSON 形式です。サポートはサポート側でそれを解析するため、自分で解釈する必要はありません。
よくあるご質問
問題が発生すると、エラー レポートがワークフローの所有者と、問題の原因となったワークフローの問題/行を編集したユーザーに電子メールで送信されます。一般的なエラーと課題をいくつかご紹介します。
Issue: Row order is not as expected (課題: 行の順序が正しくない)
自動化されたワークフローを実行する際、課題は Jira で異なる並べ替えが行われている場合でも、課題キーの昇順で並べ替えられます。自動ワークフローで同期された課題を並べ替えるには、 [Row Grouping (行のグループ化)]を利用します。
手動のワークフローの場合、「Filtered Row Finder (フィルターされた行の検索)」プロセスは実行されません。この場合、シートの行を手動で並べ替えることができます。
自動化されたワークフローを使用しながら、課題を手動で並べ替える場合は、次の手順に従います。
- Jira を別のシートに同期させます。
- シート間のインデックス/一致または VLOOKUP の数式を使用して、課題キーを使用してメインのシートに値を取り込みます。数式の例: =INDEX({返される値を含む範囲}, MATCH([Search Value]@row, {検索値を含む範囲}, 0))
課題を Jira に保存できない
データを保存するには、関連づけられた Jira プロジェクトへの書き込み権限が必要です。
フィルターの更新後にデータがシートから削除されない
各行に重要な列データ、添付ファイル、またはコメントが含まれている可能性があるため、Smartsheet は Jira から取得したデータを削除しません。
シートの Jira の課題がワークフローのフィルター条件を満たさなくなった場合、Smartsheet は上部に[Filtered out by connector — not synced (コネクタによってフィルターから除外 — 非同期) ] セクションを作成し、コネクタがフィルターで除外した情報を保持します。フィルターで除外された行は、フィルター条件を再度満たすまで同期されません。これらの行は、チームがシートに含める必要がなくなった場合に削除できます。
Smartsheet のエラー列の更新中にエラーが発生した
関連づけられたシートから「同期エラー」列を削除すると、エラーが表示されます。シートに「同期エラー」列が含まれていることを確認します。これは必須です。ワークフローを編集して「同期エラー」列をシートにマッピングし直すことができます。詳細については、ワークフローの変更に関する記事をご覧ください。
エラー列
この列は、コネクタによって自動的にシートに追加され、列で発生した同期の問題に関する詳細が表示されます。
..is not a valid user for the given JIRA project (指定された JIRA プロジェクトの有効なユーザーではありません)
このメッセージは、Jira に同期された Smartsheet フィールドに無効な電子メールが入力された場合に表示され、連絡先の同期で問題が発生する可能性があります。
さらに、Jira Cloud では、ユーザーが Jira のプロジェクトに割り当てられていない場合や、Jira で外部サービス (Smartsheet Jira コネクタなど) がメール アドレスを表示できない場合に、このエラーが発生することがあります。ユーザーごとの設定は、 [Profile (プロファイル)] > [Manage your account (アカウントの管理)] > [Profile and visibility (プロファイルと表示設定)] にアクセスし、 [Who can see this (これを表示できるユーザーは？)]を変更します。一番下の連絡先フィールドの設定です。これが[Only you and the admins (自分と管理者のみ)]に設定されている場合、Jira コネクタはこの設定のユーザーのメール アドレス情報にアクセスできず、[メール アドレス] フィールドに入力されません。
Jira コネクタにアクセスしようとすると、このアクションを実行する権限がありませんと表示されます。どうすればよいですか？
Jira コネクタにアクセスするために必要な権限をまだ持っていない可能性があります。サポートが必要な場合は、Smartsheet システム管理者にお問い合わせください。
システム管理者へのお問い合わせ方法をご確認ください。