Crystal Reports にTodoist を連携してTodoist のデータを使った帳票を作成

古川えりか
コンテンツスペシャリスト

レポート作成ウィザードを使って、最新のTodoist のデータを使った帳票を作成。

Crystal Reports には、ODBC 標準向けのサポートが組み込まれています。CData ODBC Driver for API は、Crystal Reports でレポート作成ウィザードやその他のツールを使ってTodoist へのアクセスを可能にします。この記事では、Todoist の機能を持つシンプルな帳票を作成する方法を説明します。

CData ODBC ドライバとは？

CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。

Todoist をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
多様なアプリケーション、ツールにTodoist のデータを連携
ノーコードでの手軽な接続設定
標準 SQL での柔軟なデータ読み込み・書き込み

CData ODBC ドライバでは、1.データソースとしてTodoist の接続を設定、2.Crystal Reports 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。

CData ODBC ドライバのインストールとTodoist への接続設定

まずは、本記事右側のサイドバーからAPI ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。

下記の手順に従って、レポート作成ウィザードを使ってTodoist 接続を作成します。

ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
- Profile
- Authscheme
- OAuthClientId
- OAuthClientSecret
- CallbackUrl
Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。
まず、Profile 接続プロパティにTodoist プロファイルのディスク上の場所を設定します（例：C:\profiles\Todoist.apip）。次に、ProfileSettings 接続プロパティにTodoist の接続文字列を設定します（以下を参照）。

Todoist API プロファイル設定

Todoist に認証し、自分のデータに接続したり、他のユーザーが自分のデータに接続できるようにするには、OAuth 標準を使用できます。

まず、Todoist にOAuth アプリケーションを登録します。App Management Console に移動し、新しいアプリケーションを作成して有効なOAuth リダイレクトURL を設定します。OAuth アプリケーションにはclient id とclient secret が割り当てられます。

以下の接続プロパティを設定すると、接続の準備が整います：
- AuthScheme：OAuth に設定します。
- InitiateOAuth：GETANDREFRESH に設定します。InitiateOAuth を使用してOAuthAccessToken を取得するプロセスを管理できます。
- OAuthClientId：アプリ設定で指定されているclient_id を設定します。
- OAuthClientSecret：アプリ設定で指定されているclient_secret を設定します。
- CallbackURL：アプリ設定で指定されているRedirect URI を設定します。
新しい帳票で、［Create New Connection］>［ODBC］をクリックします。
ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

Todoist のデータに連携する帳票をデザイン

ODBC 接続をTodoist に追加したら、レポート作成ウィザードを使ってTodoist を帳票に追加できます。

帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Tasks テーブルのId およびPriority カラムを使います。
チャートの種類を設定。例えば、Priority をId で表すシンプルなチャートを作成します。ウィザードを完了すると、Crystal Reports はTodoist に実行されるSQL クエリをビルドします。ドライバーは、リアル隊うTodoist に対してクエリを実行します。
必要に応じて、ほかのフィルタやレポートテンプレートを設定します。
データのインポートが終わったら、レポートフィールドをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total Priority by Id を表すグラフを作成するには、Id を［On Change Of］メニューセレクションの下のボックスに追加してからPriority を［Show Values］の下のボックスに追加します。