シーオーリポーツ 帳票クリエータでNetSuite のデータを利用した帳票を作成

シーオーリポーツ 帳票クリエータは株式会社エイチ・オー・エスが提供する帳票作成ツールです。GUI ベースで各種データソースと紐付いた帳票を作成することが可能です。

この記事では、シーオーリポーツ 帳票クリエータとCData ODBC ドライバを使って、シーオーリポーツ 帳票クリエータでNetSuite のデータを利用した帳票を作成する方法を紹介します。

CData ODBC ドライバとは？

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

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

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

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

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

1. ODBC DSN に必要な接続プロパティの値を入力します。 組み込みのMicrosoft ODBC データソースアドミニストレーターを使用してDSN を構成できます。 これは、ドライバのインストールじの最後のステップでも可能です。 Microsoft ODBC データソースアドミニストレータを使用してDSN を作成および設定する方法については、ヘルプドキュメントの「はじめに」の章を参照してください。
   
   

   NetSuiteへの接続

   NetSuite では、2種類のAPI でデータにアクセスできます。どちらのAPI を使用するかは、Schema 接続プロパティで以下のいずれかを選択して指定してください。

   • SuiteTalk は、NetSuite との通信に使用されるSOAP ベースの従来から提供されているサービスです。幅広いエンティティをサポートし、INSERT / UPDATE / DELETE の操作も対応しています。ただし、SuiteQL API と比べるとデータの取得速度が劣ります。また、サーバーサイドでのJOIN に対応していないため、これらの処理はCData 製品がクライアントサイドで実行します。
   • SuiteQL は、より新しいAPI です。JOIN、GROUP BY、集計、カラムフィルタリングをサーバーサイドで処理できるため、SuiteTalk よりもはるかに高速にデータを取得できます。ただし、NetSuite データへのアクセスは読み取り専用となります。

   データの取得のみが目的でしたらSuiteQL をお勧めします。データの取得と変更の両方が必要な場合は、SuiteTalk をお選びください。

   NetSuite への認証

   CData 製品では、以下の認証方式がご利用いただけます。

   • トークンベース認証（TBA）はOAuth1.0に似た仕組みです。2020.2以降のSuiteTalk とSuiteQL の両方で利用できます。
   • OAuth 2.0 認証（OAuth 2.0 認可コードグラントフロー）は、SuiteQL でのみご利用いただけます。
   • OAuth JWT 認証は、OAuth2.0 クライアント認証フローの一つで、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。

   トークンベース認証（OAuth1.0）

   トークンベース認証（TBA）は、基本的にOAuth 1.0 の仕組みです。この認証方式はSuiteTalk とSuiteQL の両方でサポートされています。管理者権限をお持ちの方がNetSuite UI 内でOAuthClientId、OAuthClientSecret、OAuthAccessToken、OAuthAccessTokenSecret を直接作成することで設定できます。 NetSuite UI でのトークン作成手順については、ヘルプドキュメントの「はじめに」セクションをご参照ください。

   アクセストークンを作成したら、以下の接続プロパティを設定して接続してみましょう。

   • AuthScheme = Token
   • AccountId = 接続先のアカウント
   • OAuthClientId = アプリケーション作成時に表示されるコンシューマーキー
   • OAuthClientSecret = アプリケーション作成時に表示されるコンシューマーシークレット
   • OAuthAccessToken = アクセストークン作成時のトークンID
   • OAuthAccessTokenSecret = アクセストークン作成時のトークンシークレット

   その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。


2. 入力後、接続テストが成功すれば設定は完了です。

フォームの作成

最初にデータをマッピングするためのベースとなるフォームを作成します。

1. まず、帳票クリエータ フォームエディタを立ち上げます。

2. 今回は単純に一覧を表示する帳票を作成するので、右ナビゲーションからリストフィールドをフォーム上に配置します。

3. 以下のようにフォームを作成後、保存を実行し、任意のフォルダにフォームを保存します。

マッピングの作成

次に帳票クリエータ マッピングツールを使って、事前に作成したフォームにNetSuite のデータをマッピングします。

1. 帳票クリエータ マッピングツールを立ち上げます。

2. マッピングツールの左上のリボンから「新規作成」をクリックします。

3. 設定ファイル新規作成ウィザードが開始されるので、各種情報を任意の値で入力し、「参照」ボタンから先ほどのフォームを指定します。

4. 次に任意の出力設定を入力し「完了」をクリックします。

5. 「引き続き、レコードセットの編集を行いますか？」というダイアログが表示されるので「はい」をクリックします。

6. このダイアログでCData ODBC ドライバからのデータ取得設定を行っていきます。「新しいデータソースでレコードセットを作成する」の中から「データベース」を選択し、「次へ」をクリックすると

7. データ取得実行時のSQL とODBC Datasource に接続するための各種プロパティ入力画面が表示されるので、下記のとおり入力を行います。

8. 以下のような形で入力できればOKです。「次へ」をクリックします。

9. この画面で先ほど入力したSQL を元にしたデータ取得結果のプレビューを確認できます。内容を確認し、問題がなければ「次へ」をクリックします。

10. 以上でレコードセットの作成が完了します。

11. 作成完了後、右ナビゲーションに作成されたレコードセットのカラム一覧が表示されます。

12. それでは実際に各カラムをマッピングしていきたいと思います。なお、フォームで事前に作成していたリストはそのままだと各セルが独立してしまっているため、一覧表示を行う仕様になっていません。事前に対象のリストを選択し「明細リストに設定」を実行しておきましょう。

13. 以下のように、「上から下」の明細リストとして設定します。

14. 明細リストとして設定すると、各行に対してレコードセットをマッピングすることができるようになります。ドラッグアンドドロップで、レコードセットから各カラムを紐づけます。

15. これでフォームとデータセットのマッピングが完了です。

プレビュー

それでは実際にどのように表示されるかプレビューを実行してみます。

1. リボンから「プレビュー」をクリックします。

2. 以下のようにプレビュー画面に切り替わり、NetSuite からデータが取得できていることが確認できました。

おわりに

このようにCData ODBC ドライバと併用することで、270を超えるSaaS、NoSQL データをシーオーリポーツからコーディングなしで扱うことができます。30日の無償評価版が利用できますので、ぜひ自社で使っているクラウドサービスやNoSQL と合わせて活用してみてください。

CData ODBC ドライバは日本のユーザー向けに、UI の日本語化、ドキュメントの日本語化、日本語でのテクニカルサポートを提供しています。