Infragistics Reveal で NetSuite ののデータを分析・可視化
Reveal は Infragistics が提供するデータ可視化ソリューションで、CData API Server と組み合わせることで、リアルタイムのNetSuite のデータから動的なダッシュボードを構築できます。CData API Server は NetSuite 用の OData API を生成し、Reveal からネイティブに利用できます。この記事では、API Server で NetSuite に接続し、Infragistics Reveal から API Server に接続してシンプルなダッシュボードを作成する方法を説明します。
NetSuite データ連携について
CData は、Oracle NetSuite のライブデータにアクセスし、統合するための最も簡単な方法を提供します。お客様は CData の接続機能を以下の目的で使用しています:
- Standard、CRM、OneWorld を含む、すべてのエディションの NetSuite にアクセスできます。
- SuiteTalk API(SOAP ベース)のすべてのバージョンと、SQL のように機能し、より簡単なデータクエリと操作を可能にする SuiteQL に接続できます。
- Saved Searches のサポートにより、事前定義されたレポートとカスタムレポートにアクセスできます。
- トークンベースおよび OAuth 2.0 で安全に認証でき、あらゆるユースケースで互換性とセキュリティを確保します。
- SQL ストアドプロシージャを使用して、ファイルのアップロード・ダウンロード、レコードや関連付けのアタッチ・デタッチ、ロールの取得、追加のテーブルやカラム情報の取得、ジョブ結果の取得などの機能的なアクションを実行できます。
お客様は、Power BI や Excel などのお気に入りの分析ツールからライブ NetSuite データにアクセスするために CData ソリューションを使用しています。また、CData Sync を直接使用するか、Azure Data Factory などの他のアプリケーションとの CData の互換性を活用して、NetSuite データを包括的なデータベースやデータウェアハウスに統合しています。CData は、Oracle NetSuite のお客様が NetSuite からデータを取得し、NetSuite にデータをプッシュするアプリを簡単に作成できるよう支援し、他のソースからのデータを NetSuite と統合することを可能にしています。
当社の Oracle NetSuite ソリューションの詳細については、ブログをご覧ください:Drivers in Focus Part 2: Replicating and Consolidating ... NetSuite Accounting Data
はじめに
API Server から NetSuite に接続
CData API Server は、シンプルなポイント&クリック操作のインターフェースでデータソースに接続し、API を生成できます。
- API Server を開き、Settings -> Connection -> Add Connection をクリックします。
- 「NetSuite」を選択します。
- NetSuite に接続するために必要な認証プロパティを入力します。
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 = アクセストークン作成時のトークンシークレット
その他の認証方法については、ヘルプドキュメントの「はじめに」をご確認ください。
API Server で NetSuite のリソース定義を追加
NetSuite に接続したら、NetSuite のデータ の API エンドポイントとなるリソースを作成します。
- Settings -> Resources -> Add Resource をクリックします。
- NetSuite の接続を選択します。
- 取得したいテーブルを選択し、「次へ」をクリックします。
- (オプション) リソースを編集して、特定のフィールドを選択するなどの設定を行います。
- 設定を保存します。
API Server ユーザーの追加
API Server 経由で Reveal から NetSuite に接続するためのユーザーを作成します。
- Settings -> Users をクリックします。
- Add をクリックします。
- NetSuite の接続とリソースにアクセス可能なユーザーを設定します。
(オプション) クロスオリジンリソースシェアリング (CORS) の設定
Ajax などのアプリケーションから複数の異なるドメインにアクセス・接続する場合、クロスサイトスクリプティングの制限に抵触する可能性があります。その場合は、Settings -> Server で CORS 設定を行います。
- Enable cross-origin resource sharing (CORS): ON
- Allow all domains without '*': ON
- Access-Control-Allow-Methods: GET, PUT, POST, OPTIONS
- Access-Control-Allow-Headers: Authorization
設定の変更を保存します。
Reveal でダッシュボードを作成
API Server の設定が完了したら、Reveal でNetSuite のデータを可視化していきましょう。
- Reveal にログインし、Dashboards -> New をクリックします。
- Data Source -> OData Feed をクリックします。
- API Server の API エンドポイント URL を指定します。例: https://serverurl/api.rsc
- Generic Credentials を選択し、API Server のユーザー名と認証トークンを指定します。
- 可視化したいエンティティを選択します。
- フィールドを選択し、チャートタイプを選びます。
詳細情報と無償トライアル
これで、リアルタイムのNetSuite のデータからシンプルなダッシュボードを作成できました。NetSuite (および 150 以上のデータソース) から OData フィードを作成する方法の詳細については、API Server ページをご覧ください。30日間の無償トライアルをダウンロードして、OData API を利用するツールでリアルタイムのNetSuite のデータを活用してみてください。