Skip to content
Permalink
Branch: master
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
119 lines (68 sloc) 7.25 KB

Google SheetsによるBacklog課題一括登録

(English document is here.)

Googleスプレッドシート(Google Sheets)をつかって、Backlogへ課題を一括登録するツールです。

以下のような場合に、お使いいただけます。

  • プロジェクト立ち上げ時に、定型のタスクを登録する必要があるとき
  • 運用・保守など、定期的に同じタスクを行わなければならないとき

使い方

テンプレートとなるスプレッドシートを準備します。下記リンクをクリックして、スプレッドシートをコピーしてください。

入力項目について

テンプレートを元に、スプレッドシートの内容を登録したい情報に書き換えます。1行目のヘッダー行は、登録処理に必要な情報を含んでいるため、削除したり内容を変更しないようご注意ください。また「件名」「種別」は登録に必須となる項目ですので、必ず記入するようにしてください。

親課題

親課題が既に存在する場合は課題キーを指定してください。スプレッドシート内の課題を指定する場合は課題キーがまだ存在しないので、*を入力することで直近の親課題を指定していない課題を親課題とします。

カスタム属性

プロジェクトにカスタム属性が登録されている場合、後述するSTEP1を実行することでカスタム属性が水色のカラムとして追加されます。

  • 複数選択可能なカスタム属性は追加されません。
  • ラジオボタン形式のカスタム属性は追加されません。
  • カスタム属性はプレミアムプラン以上からご利用できます。

実行方法

スプレッドシートを開いて10秒ほど待つと、スプレッドシートのメニューバーの一番右に「Backlog」というメニューが追加されます。

実行には2つのステップが必要です。下記のSTEP1から順番に実行してください。 途中で承認画面が出ることがあるかもしれませんが、こちらは”赤枠内のボタン”を押して続行後、再度課題一括登録を実行してみてください。

STEP1: Backlogからデータを取得する

STEP1では、Backlogに設定済みの定義(種別名、ユーザー名等)を取得します。

[Backlog]メニューから[STEP1:Backlogからデータを取得する]をクリックします。

下記のような入力ダイアログが表示されますので、順に必要な情報を入力してください。

デモ用Backlogプロジェクト

お試しで使いたい方はBacklogデモプロジェクト からお試しいただけます。( 大事な情報を入力しないようにご注意ください!! )

  • スペースID: demo.backlog.jp
  • APIキー: ShMb0ao0AQuwzysKGEvLu9kZ96UczRSUufi9dXVFTKAtIY4ODiljBnYs9SBBb1bj
  • プロジェクトキー: STWK

必要な情報を全て入力後、実行ボタンをクリックして定義一覧取得を実行します。
正常に完了すると、右下に完了のポップアップが表示されます。

課題種別や、カテゴリーなど、必要な情報が選択できるようになっていることをご確認ください。

スプレッドシートに課題を記入する

一括登録したい課題を1行に1課題ずつ入力してください。

STEP2: 一括登録処理を実行する

STEP2を実行することで、スプレッドシートに入力した内容で、Backlogに課題を一括登録します。

[Backlog]メニューから[STEP2:課題一括登録を実行]をクリックします。

下記のような入力ダイアログが表示されますが、STEP1で既に入力済みなので実行ボタンをクリックして一括登録処理を実行します。

登録処理実行時に、結果出力用のシートが新規作成され自動的にそのシートに遷移します。このシートで、一括登録された課題の(キー・件名)を一覧で確認することができます。

Backlogをの課題一覧を開くと、課題が登録されていることを確認できます。

一度作ったスプレッドシートを再利用する場合

Backlog側のプロジェクト設定を変更しなければ、STEP2の操作だけで課題は登録されます。 もしも課題種別やカテゴリーなど、変更がある場合はSTEP1の操作から実行してください。

カスタム属性の設定は自動的に反映されません。カスタム属性の名前やカスタム属性の形式が変更された場合は、カスタム属性の列を すべて 削除し、再度STEP1の操作から実行してください。

制限事項

  • BacklogにIPアドレスによるアクセス制限を設定している場合、本機能はご利用いただけません。
  • 発生バージョン/マイルストーンは「プロジェクトホームに表示しない」にチェックが入っていると取得されません。
  • リスト形式の最大取得個数は500個です。

困ったときは?

wikiを参照ください。

You can’t perform that action at this time.