Web 帳票ツール PrintStream でLinear のデータを利用した帳票を作成
PrintStream は株式会社オープンストリームが提供するWeb システムでの帳票印刷、PDF 生成機能を強力にサポートする帳票ツールです。
この記事では、PrintStream と CData ODBC ドライバを使って、PrintStream でLinear のデータを利用した帳票を作成する方法を紹介します。
CData ODBC ドライバとは?
CData ODBC ドライバは、以下のような特徴を持ったリアルタイムデータ連携ソリューションです。
- Linear をはじめとする、CRM、MA、会計ツールなど多様なカテゴリの270種類以上のSaaS / オンプレミスデータソースに対応
- 多様なアプリケーション、ツールにLinear のデータを連携
- ノーコードでの手軽な接続設定
- 標準 SQL での柔軟なデータ読み込み・書き込み
CData ODBC ドライバでは、1.データソースとしてLinear の接続を設定、2.PrintStream 側でODBC Driver との接続を設定、という2つのステップだけでデータソースに接続できます。以下に具体的な設定手順を説明します。
CData ODBC ドライバのインストールとLinear への接続設定
まずは、本記事右側のサイドバーからLinear ODBC Driver の無償トライアルをダウンロード・インストールしてください。30日間無償で、製品版の全機能が使用できます。
- ODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバーのインストール時の最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
Linear への認証には、個人用 API キーまたは OAuth 2.0 を使用できます。ご自身の Linear アカウントで接続する場合は、API キーを使うのが最も手軽です。
API キーによる認証
以下の接続プロパティを設定します。
- AuthScheme:APIKey に設定します。
- APIKey:Linear の個人用 API キー。
個人用 API キーを作成するには、Linear にログインして Settings > Security & access > Personal API keys を開き、New API key を選択して作成します。キーは一度しか表示されないため、すぐにコピーしておきましょう。
OAuth による認証
OAuth を使用するには、Linear にカスタム OAuth アプリケーションを登録する必要があります(Settings > API > OAuth applications)。登録すると OAuthClientId と OAuthClientSecret が発行されます。対応しているフローは以下の 2 つです。
- Authorization code:AuthScheme を OAuth、InitiateOAuth を GETANDREFRESH に設定し、OAuthClientId、OAuthClientSecret、およびアプリケーションで定義した CallbackURL(例:http://localhost:33333)を指定します。ドライバーがブラウザで Linear を開くので、アクセスを許可してください。
- Client credentials:AuthScheme を OAuthClient に設定し、OAuthClientId と OAuthClientSecret を指定します。アプリケーション自体を認証するためブラウザ操作は不要で、マシン間(M2M)連携に適しています。
デフォルトでは、ドライバーは read,write スコープをリクエストします。アクセストークンは有効期限が切れると自動で更新されます。
- 入力後、接続テストが成功すれば設定は完了です。
PrintStream で帳票をデザインする
それでは PrintStream 側の作業を進めていきます。
- 今回はシンプルに以下のようなLinear のデータを一覧表示する帳票を作成します。
- 以下のようにリージョンを配置して、中にレコードとテキストフィールドを配置します。最終的にテキストフィールドにLinear のデータをそれぞれマッピングするイメージです。
- 詳しい手順は割愛しますが、ヘルプの「PrintStream」チュートリアルにある「一覧表作成」を参考にしてみてください。
PrintStream でODBC 接続を行う
デザインが完了したらODBC 経由でデータを読み込みます。
- 「印刷データウィザード」を使ってODBC 接続経由でLinear のデータを読み込みます。
- データの取得方法から「ODBC データベース」を選択し、「次へ」をクリック
- データベースの「参照」をクリックし
- 「コンピューターデータソース」の一覧から先ほど設定したODBC DSN を選択します。
- データベースの設定が完了したら、データの検索方法から「テーブルまたはビューを選択」もしくは「SQL を記述」を選択します。今回は「テーブルまたはビューを選択」を使ってみます。
- 「テーブルまたはビューを選択」では、最初に任意のテーブルまたはビューを選択します。ここでデータサンプルも表示されるので、Linear のデータを確認しながら選ぶことができます。
- 続いて絞り込み条件を指定します。任意の条件を指定してください。
- 併せてソート条件も指定しましょう。
- 最後に帳票デザインに配置した印刷フィールドと読み込んだデータ項目をマッピングします。
印刷プレビュー
印刷プレビューで実際に帳票へデータが取り込めているか確認してみましょう。
- 下図のアイコンもしくは「F5」を押下することでプレビューが実施できます。
- 以下のようにODBC 経由で取り込んでいるデータが表示されればOK です。
Linear からPrintStream へのデータ連携には、ぜひCData ODBC ドライバをご利用ください
このようにCData ODBC Driver for Linear とPrintStream を組み合わせることで、簡単にLinear のデータを活用した連携を実現できます。ぜひ、30日の無償評価版 をお試しください。
CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。