データ接続と統合利用可能なコネクターOracle NetSuiteNetSuite SuiteTalk (JDBC)

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

Oracle NetSuite SuiteTalk

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

サポートされている機能

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

セットアップ

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

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

認証

NetSuite SuiteTalk ソースは、トークンベース認証(TBA)↗を使用します。

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

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

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

  1. 適切な権限を持つ専用のロールを作成します。

    1. NetSuite のツールバーで、セットアップ > ユーザー/ロール > ロールを管理 > 新規を選択し、ロールに明確な名前を入力します。foundry-role の使用を推奨します。
      • 必要に応じて、Web サービスのみの設定チェックボックスをオンにできます。
    2. ロールのページの下部に移動し、権限 > セットアップを選択して、ロールにシステム全体の権限を追加します。最低限追加する必要がある権限は、次のとおりです。
      • アクセストークンを使用してログイン、
      • SOAP Web サービス、
      • その他のカスタムフィールド、
      • カスタム本文フィールド、
      • カスタム項目フィールド、
      • 忘れずに権限を保存してください。
    3. ロールのページの下部に移動し、権限 > リストを選択して、Foundry からクエリできるようにするテーブルの権限をロールに追加します。必要なテーブルを選択し、追加、保存の順に選択します。
  2. 新しいロールをユーザーに割り当てます。

    1. NetSuite のツールバーで、セットアップ > ユーザー/ロール > ユーザーの管理を選択します。Foundry への接続に使用するユーザーを選択し、編集を選択します。
    2. アクセスタブに移動し、アクセスを付与チェックボックスがオンになっていることを確認します。
    3. ロールタブで、ドロップダウンリストから新しく作成したロール(foundry-role)を選択し、追加、保存の順に選択します。

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

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

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

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

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

  1. 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 ワーカーで接続を実行する場合は、これらのドメインごとにポート443の対応するエグレスポリシーを追加します。

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

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

接続情報

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

同期を作成する

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