CDATAQUERY 関数を使って、Excel スプレッドシートにBacklog を自動挿入

CData Excel Add-In for Backlog の関数を使って、スプレッドシートにデータを取り込むことができます。下記の3つの手順では、次のタスクを自動化する方法について説明します：ユーザー定義の値でBacklog を検索し、その結果をExcel スプレッドシートに出力します。

CDATAQUERY 関数の構文は次のとおりです： =CDATAQUERY(Query, [Connection], [Parameters], [ResultLocation]);

この関数に入力する値は以下の3つです：

• Query：取得したいBacklog data レコードの宣言、もしくは修正を簡単な構文で記述。
• Connection：BacklogConnection1 のような接続名、もしくは接続文字列を入力。接続文字列は、Backlog への接続に必要なプロパティのセミコロン区切りとなります。一般的な接続文字列は次のとおりです：
  • ApiKey
  • Url

  Backlog への接続に使用できる認証方法は、API キーおよびOAuth の2つです。

  API キー認証

  ApiKey およびURL をログインクレデンシャルに設定します。 ApiKey を取得するには：

  1. Backlog の個人設定ページを開きます。
  2. 「API」セクションをクリックして、「メモ」にAPI キーについての説明を追加し、「登録」ボタンをクリックします。トークンが生成されます。
  3. ApiKey にAPI キーを指定します。
  4. URL はBacklog のテナントURL から取得できます。

  OAuth 認証

  ユーザー名やパスワードへのアクセスを保有していない場合や、それらを使いたくない場合にはOAuth ユーザー同意フローを使用します。認証方法については、ヘルプドキュメントを参照してください。
• ResultLocation：結果のアウトプットを開始するセル。

スプレッドシートのセルをクエリのインプットとして渡す

下記の処理では、すべての関数インプットをひとつ目のカラムでオーガナイズするスプレッドシートができます。

1. 関数をインプットするセルを定義します。接続インプットに加えて、Id のように、Backlog の検索に使われるフィルタ用の基準を定義する追加のインプットを入力します。
2. 別のセルに、上で定義したユーザーインプットセルからセルの値を参照する関数を書きます。住所などスペースを含む可能性のある値は、シングルクオートで囲みます。
=CDATAQUERY("SELECT * FROM Issues WHERE Id = '"&B3&"'","ApiKey="&B1&";Url="&B2&";Provider=Backlog",B4)
3. フィルタを変更してデータを変更します。