NetSuite® JDBC コネクターを使用すると、チェーンでコマンド を使用して、NetSuite で構造化クエリ言語 (SQL) 操作を実行できます。例えば、このコネクターを使えば、次のことができる:
- NetSuite で
SELECTクエリを実行します。 - NetSuite テーブルに関するテーブルの取得
メモ: このコネクターはWorkivaによって構築され、サードパーティのシステムに接続する。Workivaサポートチームは、お客様のワークスペース内でこのコネクターの構成をヘルプすることはできますが、Workivaプラットフォーム外で発生した問題のトラブルシューティングやその他のサポートを行うことはできません。
前提条件
NetSuite に接続するために、コネクターは基本的なユーザー名とパスワード認証で保護された Java データベース接続(JDBC)を使用します。
メモ: NetSuite環境でJDBCを有効にするには、テナントのSuiteAnalytics Connect® Service を構成します。
コネクターの設定には、以下のものが必要だ:
- NetSuite Analytics Moduleに使用するコネクター用にNetSuiteで作成された統合ユーザー。
- 統合ユーザーのユーザー名とパスワード
- JDBC接続のURLは、
jdbc:ns://[server_host]:[port];ServerDataSource=[datasource];encrypted=1;CustomProperties=(アカウントID=[accountID];役割ID=[roleID])のように、NetSuiteテナントのSuiteAnalytics Connectで設定されたアカウントと役割と同じです。
メモ: NetSuite のオンプレミス インスタンスに接続するには、その環境に Java Virtual Machine (JVM) がインストールされた コネクター用のGroundRunner が必要です。NetSuite のクラウドインスタンスに接続するには、デフォルトの CloudRunner を使用します。
NetSuite JDBC コネクターの設定
組織のチェーンでコネクターを使用できるようにするには、組織のセキュリティ管理者が、まず構成 から有効にする必要があります。
それから:
- チェーンビルダー から接続 をクリックし、右上の作成 をクリックします。
-
コネクター 接続 で、NetSuite JDBC と接続で使用するランナーを選択します。
- 接続を識別するための一意の名称と説明を入力します。
-
プロパティ で、コネクターの詳細を入力します:
プロパティ 詳細 ユーザー名 コネクターの NetSuite 統合ユーザー名を入力します。 パスワード ユーザー名 プロパティのパスワードを入力します。 接続URL JDBC 接続の URL を入力し、オプションプロパティをセミコロンの後に 付記する。例:
デフォルトでは、ポートはjdbc:ns://[server_host]:[port];ServerDataSource=[datasource];encrypted=1;CustomProperties=(AccountID=[accountID];RoleID=[roleID])1708です。注:機密性の高い資格情報はすべて自動的に暗号化され、高度な暗号化標準(AES)-256暗号化で保存されます。セキュリティのため、Connection URL 入力内にカスタムプロパティとしてユーザー認証情報を含むことは避けてください。
- 接続に使用する環境を選択し、保存します。
- 接続をテストするには、 コネクターのテーブル定義を取得コマンドでチェーンを作成して実行し、有効な出力を返すことを確認します。
トラブルシューティング
カスタムフィールド
NetSuite API はカスタマイズフィールドを返却できませんので、メモしてください。別の方法として、データの準備で、Netsuite カスタムフィールドのロジックを模倣したトランスフォーメーションを作成することができます。
接続失敗
NetSuite への接続に失敗した場合:
- 統合ユーザーの認証情報の確認
- サーバーとポートを含むJDBC接続のURLを確認する。
接続がコマンドの実行に失敗した場合は、その入力(SQL構文やテーブルなど)が有効であることを確認する。