Jira ネイティブ統合：エンドユーザーガイド

ターゲットプロセスで Jira Issue 情報を表示する方法：同期作業ブロック

Jira リンクはデフォルトでエンティティ詳細ビューに表示されます。 これは、右側のサイドパネルにあるブロック（旧レイアウトビューの場合）か、「Synced Work」タブ（カスタマイズ可能なレイアウトが有効になっている場合）のいずれかになります。 同期された作業」は Jira 課題に関連する情報を表示し、エンティティがまだリンクされていない場合は、メニュー - 新規としてプッシュ / 既存にリンク - が表示されます。 このボタン(-s)の名前は、統合プロファイル(-s)の名前である

リンクされたエンティティの "Synced Work "では、2つの領域が最も重要である：

• Jira課題とアクションメニューへのハイパーリンク
• ログ・メッセージ

Jira へのリンクでボード/リストビューをカスタマイズする

追加フィールドなしでボード / リスト ビューに Jira アイコンまたはリンクを表示できます。 mapping.Simply 「同期作業」ユニットでカードをカスタマイズします。 これは Jira に共有されるカードをマークするためのクリックできない短いユニットです

また、Jira Keyとハイパーリンクされたユニットである可能性もある。 ビューカードのカスタマイズ設定で「外部ID」という名前になっている。

TargetprocessでJiraキーを検索

Targetprocess で Jira キーを検索したい場合は、Targetprocess に「Jira Link」のようなカスタムフィールドを追加し、 フィールドマッピング（JS ）に追加します

このIDをカスタムフィールドに入力して、Targetprocessにカスタムフィールドの値を問い合わせることができます。

アクションJira への/からの更新の送信、リンクの解除、Jira へのバッチ プッシュ

リンクの（解除）方法、アップデートの引き出し方、エラーの見つけ方

Jira ID の近くに 3 つの点の下にメニューがあります：

これらのアクションにより、Targetprocess で適用された変更を Jira Issue に反映させるか、Jira からの更新を Targetprocess エンティティに反映させるか、リンクを解除して同期を停止することができます。

更新のプッシュ

Jira へのプッシュ更新は、Integration がすべての変更をその都度 Jira に送信するため、あまり使用されません。 このアクションは、選択されたエンティティのすべてのマッピングされたフィールドを再同期し、Jira のフィールドは Targetprocess のフィールドと同じ値になります (違いが明らかな場合)。

プルの更新

プルアップデートは、コレクションリスト (バグ、ユーザーストーリーなどのセット) を含む、選択したエンティティのすべてのフィールドを Jira からの日付で再同期します しかし、子コレクションのフィールドは更新されません(つまり、いくつかのバグが変更された場合、そのバグをチームで反復処理します)。

リンク解除

2つの課題のリンクを解除するとすぐに同期が停止し、Targetprocess Entity を Jira の新しいものに再リンクすることができます。 しかし、自動プッシュを有効にしていて、このエンティティが変更され、まだフィルタをパスしている場合、それは再び Jira にプッシュされ、新しいアイテムとしてプッシュされることに注意することが重要です (これは Jira で重複を引き起こす可能性があります)。

コンテキストメニュー／バッチアクション（未定）

通常のタイプ (拡張可能ドメインタイプではない) のボードまたはリストビューでは、Jira メニューを見つけることができます。 現在は「Jira にプッシュ」のみが利用可能です。 どのプロファイルを使用するかを選択すると、新しい課題のバッチを Jira にプッシュしようとします。 すでに共有されているエンティティは、再度プッシュされることはない。

その後、一括プル/プッシュ更新とリンク解除のJiraメニューになります。

チーム・イテレーション・シンク チームを Jira スクラムボードにマップする

Targetprocess チームのイテレーションは、Jira スプリントとしてシームレスに同期されます。 すべてのチームスプリントは Jira スプリントにリンクされ、名前、説明、開始/終了日が同期されます。

たとえば、 ‘Q1-2021-1’ チーム反復を Jira スプリントにリンクすると、このスプリントに作成および割り当てられた Jira ストーリーが自動的に Targetprocess に追加され、同じチーム反復に割り当てられます。

チームがスクラムボードにマッピングされると、チームのイテレーションはJiraにプッシュされる。

イテレーション・ビューの同期作業ブロック/作業共有タブにボタンが表示されます：

このボタンを使用すると、反復を Jira にプッシュしたり、既存の Jira スプリントにリンクしたりできます：

他のマッピングされたエンティティタイプと同様に、チームのイテレーションはバッチでプッシュできる。

Jiraからのインポート

Jiraからインポート」は、提供されたJQLフィルターで選択されたすべての課題を、プロファイル設定（タイプマッピングとプロジェクトルーティング）に一致する場合にインポートします。 JQLクエリを終了し、[予測]ボタンを押すと、クエリで定義された銘柄数とおおよその予測時間が表示されます。

予測時間は、過去の輸入履歴に基づく数値を示す。 過去14日間輸入がなかった場合、おおよその時間はまだ計算されない。 この場合、予測時間と残り時間は未定義のままとなる。

以前にインポートされ、再度インポートしようとした課題は複製されませんが、一括で「Jira からプル」アクションを実行した場合と同様に更新されます。 ログを見ると、それらのissueはすでに同期されていることがわかります。

インポートに失敗した項目は、そのウィザードからすぐに再試行できる。

インポートキャンセル

未完了のインポートは中止できる。 輸入取消には時間がかかる。 実際のフィールド値を持つすべてのアイテムの作成と更新を停止し、実現されなかったものをすべて削除するのに数分かかることもある。

全部または一部が更新された項目は、Targetprocessに残ります。 インポートされ、 Targetprocess統合サービス（ 103084:2eb4df78-9419-4741-97ef-3d0e168cea2b:5eb3dfaa-4013-4615-86bf-de73f8fcabd3 ）で作成されたような名前のissueは、インポートがキャンセルされた結果、Targetprocessから削除されます。

手順/ステップ

1. インポートを開始し、完了する前に[キャンセル]を押す。
2. すぐに新しいインポートを開始することができます。

ワークアイテムの階層を同期する方法

他の階層についても同様である。

Feature (Jira Epic) ➜ User Story (Stories via Epic Link) ➜ Bugs、Tasks (Defects、Tasks via Parent of (またはその他の事前に選択したリンクタイプ)) の階層をマッピングしている場合、Jira Epic のみをインポートする必要があります。 残りはすべて自動的にインポートされる。

バスやストーリーを別々にインポートするには、それらがインポートされた親エンティティに接続されていない場合に必要です。

診断ログとエラー

ログフィルターには3つのレベルがある。

1. エンティティの詳細ビューでは、特定のエンティティの警告、エラー、および同期操作ログのみが表示されます：
2. 特定の統合のエラーと操作ログは、統合プロファイルの中にあります：
3. 管理者パネルの[設定] > [診断とログ]から、プロファイルを識別できなかったときのメッセージを含む、すべてのプロファイルのログが表示されます（例外的なケースに適用されます）：