Oracle NetSuite SuiteQL

SuiteQL フレームワークを使用して Foundry を Oracle NetSuite に接続し、NetSuite ERP から Foundry へのデータ同期を開始します。

サポートされている機能

機能	ステータス
探索	🟢 一般提供
バッチ同期	🟢 一般提供
インクリメンタル（差分連携）	🟢 一般提供

セットアップ

Data Connection アプリケーションを開き、画面の右上にある + 新規ソースを選択します。
利用可能なコネクターの種類から NetSuite SuiteQL を選択します。
追加の設定プロンプトに従い、以下のセクションの情報を使用してコネクターのセットアップを続行します。

Foundry でのコネクターのセットアップについては、詳しくはこちらをご覧ください。

認証

NetSuite SuiteQL ソースは、トークンベース認証（TBA）↗を使用します。

アカウントでトークンベース認証機能を有効にする必要があります。TBA を有効にするには、NetSuite ドキュメント ↗を参照してください。

NetSuite でユーザーロールと権限を設定する

NetSuite のアクセス制御は、ユーザーへのロールの割り当てによって設定します。各ロールには、ユーザーが実行できるタスクとアクセスできるデータを定義する権限が含まれます。Foundry に接続するユーザーには、以下の設定を推奨します。

適切な権限を持つ専用のロールを作成します。
1. NetSuite のツールバーから、セットアップ > ユーザー/ロール > ロールを管理 > 新規を選択し、ロールにわかりやすい名前を入力します。foundry-role を推奨します。
  - 必要に応じて、Web サービスのみの設定チェックボックスをオンにできます。
2. ロールページの下部に移動し、権限 > セットアップを選択して、システム全体の権限をロールに追加します。追加する必要がある最小限の権限は次のとおりです。
  - アクセストークンを使用してログイン
  - REST Web サービス
  - カスタムレコードタイプ
  - カスタムフィールド
  - 必要な権限を追加した後は、必ず保存してください。
3. ロールページの下部に移動し、権限 > レポートを選択して、レポートの権限をロールに追加します。次を選択します。
  - SuiteAnalytics Workbook、
  - 必ず権限を追加してから保存してください。
4. ロールページの下部に移動し、権限 > リストを選択して、Foundry からクエリできるようにするテーブルの権限をロールに追加します。必要なテーブルを選択し、追加、保存の順に選択します。
新しいロールをユーザーに割り当てます。
1. NetSuite のツールバーから、セットアップ > ユーザー/ロール > ユーザーの管理を選択します。Foundry への接続に使用するユーザーを選択し、編集を選択します。
2. アクセスタブに移動し、アクセス権を付与チェックボックスがオンになっていることを確認してください。
3. ロールタブで、ドロップダウンリストから新しく作成したロール（foundry-role）を選択し、追加、保存の順に選択します。

適切な権限を追加できたことを確認するには、新しいロールを割り当てたユーザーとしてログインし、想定しているすべてのデータを表示できることを確認します。

NetSuite で統合とアクセストークンを設定する

NetSuite では、統合レコードを使用して外部システムへの接続を管理します。Foundry への接続には、以下の設定を推奨します。

TBA を使用する新しい統合レコードを作成します（詳細 ↗を参照）。
1. NetSuite のツールバーから、セットアップ > 統合 > 統合を管理 > 新規を選択し、統合にわかりやすい名前を入力します。foundry-integration を推奨します。
2. 状態が有効になっており、トークンベース認証のみがオンになっていることを確認してください。それ以外のチェックボックスはすべてオフにしてください。
3. 保存した後、CLIENT ID と CLIENT SECRET を控えます。これらは Foundry の設定に必要です。

CLIENT ID と CLIENT SECRET は、統合レコードを初めて保存したときにのみ表示されます。新しい値を取得するにはリセットする必要があり、以前の値は無効になります。

TBA トークンを作成して割り当てます。
1. NetSuite のツールバーから、セットアップ > ユーザー/ロール > アクセストークン > 新規を選択します。
  - 他のユーザーのトークンを管理できない場合は、NetSuite のホームページの左下にある設定パネルに移動し、アクセストークンを管理を選択します。
2. 新しく作成したアプリケーション（この例では foundry-integration）、新しく作成したロール（foundry-role）を割り当てたユーザー、および新しく作成したロールを選択します。
  - 他のユーザーのトークンを管理できない場合は、ご自身のユーザーがデフォルトで選択されます。このユーザーに、新しく作成したロール（foundry-role）が割り当てられていることを確認してください。
3. 保存した後、TOKEN ID と TOKEN SECRET を控えます。これらは Foundry の設定に必要です。

TOKEN ID と TOKEN SECRET は、トークンを初めて保存したときにのみ表示されます。新しい TOKEN ID と TOKEN SECRET を取得するには、新しいトークンを作成する必要があります。

NetSuite のトークン管理について、詳しくはこちら。↗

ネットワーク

以下のテーブルに、ソースの実行に必要なアクセス先のドメインを示します。

Foundry ワーカー接続の場合は、ドメインごとにエグレスポリシーを追加します。

ドメインが別のネットワークにあり、Agent プロキシエグレスポリシー（推奨）または Agent ワーカー（非推奨）を使用する場合は、Agent がそれらのドメインに到達できる必要があります。また、それらのドメイン上のシステムが Agent からの接続を許可している必要があります。Agent のネットワークについて、詳しくはこちら。

ドメイン	必須
`<ACCOUNT_ID>.suitetalk.api.netsuite.com`	常に必須です。アカウントIDは、NetSuite に接続したときの URL で確認できます。

接続情報

オプション	必須？	説明
アカウントID	はい	NetSuite インスタンスの URL に接頭辞として含まれる NetSuite アカウントID
クライアントID	はい	`foundry-integration` の作成時にコピーした `CLIENT ID`
クライアントシークレット	はい	`foundry-integration` の作成時にコピーした `CLIENT SECRET`
アクセストークン	はい	TBA トークンの作成時にコピーした `TOKEN ID`
アクセストークンシークレット	はい	TBA トークンの作成時にコピーした `TOKEN SECRET`

同期を作成する

NetSuite SuiteQL ソースを探索して、テーブルを発見し、新しい同期を作成できます。ソースの概要ページから新しい同期を手動で作成することもできます。

注意事項

SuiteQL テーブルのスキーマ定義

ネイティブの SuiteQL テーブルのスキーマはドライバー内にハードコードされていますが、お使いのアカウントやロールには、一部の列を表示する権限がない場合があります。デフォルトでは、テーブルから抽出された最初の1000行を使用して、お使いのロールで表示できる列を正確に特定します。

RowScanDepth 接続プロパティを変更することで、この動作を変更できます。特に、RowScanDepth を 0 に設定すると、すべての列を表示できますが、権限に関する例外が発生する場合があります。

ネイティブの SuiteQL テーブルのスキーマ定義について詳しくは、JDBC Driver for NetSuite の SuiteQL に関するドキュメント ↗を参照してください。

RowScanDepth の値を変更するには、ソースの接続情報ページに移動し、追加オプション、JDBC プロパティの順に進みます。

追加オプション、JDBC プロパティの順に移動する

JDBC プロパティから RowScanDepth を追加し、目的の値を設定できます。

RowScanDepth の値を設定する

←

PREVIOUSNetSuite SuiteAnalytics

NEXTNetSuite SuiteTalk (JDBC)

→