この双方向インテグレーションを使って、エピックやストーリーをショートカットに押し込み、エアフォーカスからその状態を追跡します。
参加するメリット
airfocusの柔軟なショートカットインテグレーションを使って、ストーリーや叙事詩の優先順位をつけて、より効果的なロードマップを作りましょう。 優先順位付けのスコアリングで協力して、正しい作業を進めましょう。私たちのショートカットインテグレーションは、ハイレベル戦略を日々の開発と同期させてくれます。
- ショートカットの叙事詩やストーリー(アイテムとして)をAirFocusにインポートしてください。
- 優先されたアイテムをShortcutにプッシュして開発し、AirFocus内からそのショートカットの状態を追跡してください。
- 柔軟なフィルターやマッピング業務フローを作成すること、例えば 複数のショートカット状態を同じエアフォーカス状態にマッピングします。
- タイトル、説明、州/車線、ラベル(双方向同期)を含むフィールドは両システム間で同期させてください。
初期設定
ショートカットを設定したいairfocusワークスペース(インテグレーション)に移動してください。 「拡張機能」に行き、「インテグレーションを追加」といった設定に行ってください。 ショートカット インテグレーションを見つけて「Connect」をクリックします。
ショートカット API トークンを入力します。生成するには、ショートカット アプリを開き、 [設定] > [アカウント] > [API トークン]に移動して、API トークンを生成します。「続行」をクリックします。
注意:
- エアフォーカスでショートカットインテグレーションを設定する際、ショートカットエピックをインポート・同期するか、エアフォーカスでショートカットストーリーを同期するかを選ばなければなりません。
- 一度に統合できるShortcut 業務フローは一つだけです。 もしa) 複数のShortcut 業務フロー、またはb) 業務フロー(プロジェクトやストーリーを含む)とエピックを同じairfocus ワークスペースに統合したい場合は、複数のインテグレーションを設定してください。
インテグレーション フィルター
まず、ショートカットからエピックとストーリーの同期を選びます。
もしストーリーを選んでいれば、シンクするアイテムの選択肢を絞り込むこともできます:
- ショートカットでこのレガシー機能を使い続けている場合は、オプションでプロジェクトを選択できます。
- インポートを制限するラベルを選ぶことも可能です。この欄を空にすると、残りのフィルターに合致するすべてのストーリーが考慮されます。
もしエピックを選んだ場合は、インポートを制限するラベルを選択することで同期対象のアイテムを絞り込むこともできます。
フィールドマッピング
マッピングを使って、ショートカット内の情報をどのようにエアフォーカスにマッピングするか(またはその逆)を定義します。ストーリー/エピック名(必須)と説明(任意)は、新しいインテグレーションを設定する際にデフォルトで必ずマッピングされます。
マッピング方向の設定方法
フィールドごとに、ショートカットと airfocus のフィールド間で一方向の同期を行うか、双方向の同期を行うかを定義できます。
「Set direction」ボタンで、すべてのフィールドのマッピング方向を一度に設定できます(技術的に可能な限り)。
デフォルトでは、マッピング方向はショートカットからエアフォーカスのみに設定されており、ユーザーがマッピング可能な方向に変更できます。
新しいフィールドマッピングの追加方法
ドロップダウンでフィールドを選択すると、反対側のドロップダウンにはフィールドタイプに一致するフィールドのみが表示されます。マッピングしたいフィールドを2つ選んだ後、フィールドのオプションとマッピング方法を選択できます。
ストーリーのフィールドマッピングオプション
| ショートカット | airfocus | エアフォーカス→ショートカット | エアフォーカス→ショートカット | エアフォーカス↔ ショートカット |
| 名前 | アイテム名 | ✅ | ✅ | ✅ |
| 説明 | アイテム説明 | ✅ | ✅ | ⚠️ |
| 状態 | ステータス/カスタムシングルセレクトフィールド | ✅ | ✅ | ✅ |
| 優先度 | カスタムシングルセレクトフィールド | ✅ | ✅ | ✅ |
| 重大度 | カスタムシングルセレクトフィールド | ✅ | ✅ | ✅ |
| ラベル | カスタム複数選択フィールド | ✅ | ✅ | ✅ |
| カスタムフィールド | カスタムシングルセレクトフィールド | ✅ | ✅ | ✅ |
| 推定 | カスタムナンバーフィールド | ✅ | ✅ | ✅ |
| 終了日 | カスタム日付フィールド | ✅ | ✅ | ✅ |
エピックのフィールドマッピングオプション
| ショートカット | airfocus | エアフォーカス→ショートカット | エアフォーカス→ショートカット | エアフォーカス↔ ショートカット |
| 名前 | アイテム名 | ✅ | ✅ | ✅ |
| 説明 | アイテム説明 | ✅ | ✅ | ⚠️ |
| 状態 | ステータス/カスタムシングルセレクトフィールド | ✅ | ✅ | ✅ |
| ラベル | カスタムマルチセレクトフィールド | ✅ | ✅ | ✅ |
| 開始日 | カスタム日付フィールド | ✅ | ✅ | ✅ |
| 終了日 | カスタム日付フィールド | ✅ | ✅ | ✅ |
| スタート + 終了日フィールド(ペアとして) | カスタム日付範囲フィールド | ✅ | ✅ | ✅ |
| 推定 | カスタムナンバーフィールド | ✅ | ✅ | ✅ |
⚠️ 警告: ユーザーは説明 欄の双方向同期を有効にすることができます。しかし、双方向同期のプロセスではショートカットの説明内容やフォーマットにわずかな変更が生じる可能性があります。 これは、すべてのショートカットスタイルがエアフォーカスでネイティブサポートされているわけではないためです。
メモ
- ショートカットからエアフォーカスに一方的にマッピングされたエアフォーカスフィールドは、ユーザーが加えた変更が次の同期で再び上書きされるため、エアフォーカスでは読み取り専用フィールドとなります。
- ショートカットの日付欄が設定されていなかったり、ショートカットのエピックの締め切りがスタート日より早いと設定されている場合、AirFocusはスタート日を締め切りの1日前の日付で埋めてくれます。
- 少なくとも1つのマルチセレクトフィールドマッピングを設定していれば、同期されたショートカット作業項目にどのラベルを付けるかをデフォルトで定義できます。(設定はそのマッピングのサブセクションとして表示されます)。
追加設定
「アーカイブ unknown items」を有効にすると、以前にインポートしたアイテムはショートカットに存在しなくなったり、インテグレーションのフィルターセットに含まれていない場合、airfocusでアーカイブとなります。
「自動同期」を有効にすると、インテグレーションは10分ごとと、そしてワークスペースにアクセスするたびに自動的に同期されます。
「ビュー logs」をクリックすると、ショートカット インテグレーションアクティビティのログをビューで確認でき、最後の同期前にどんな変更があったか確認できます。
設定を保存し、ストーリー/エピックを airfocus にインポートするには、 [更新して同期]をクリックします。
この記事へのフィードバックをお寄せください
この記事に関するフィードバックはありますか？体験の内容についてこちらから教えてください。