Excel Add-In for NetSuite

Build 25.0.9434

接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：NetSuite］> 設定済みの接続 を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいNetSuite 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

接続の前に

接続するには、特定の権限が割り当てられたロールがユーザーに付与されている必要があります。

ユーザーロールを作成または編集するには：

  1. NetSuite にログインします。
  2. 新しいロールを作成するには、NetSuite のナビゲーションメニューで設定 -> ユーザー / ロール -> ロール管理にマウスを合わせ、新規作成をクリックします。

    または

    既存のロールを編集するには、NetSuite ナビゲーションメニューで設定 -> ユーザー / ロール にマウスを合わせ、ロール管理をクリックします。ロール管理ページが開きます。


    ロール管理ページで、「名前」列に編集したいロールがある行で、「編集」列のカスタマイズをクリックします。

    どちらの操作でもロールページが開きます。
  3. 許可セクションで、設定 () ドロップダウンメニューをクリックします。
  4. 設定 () メニューで、追加ボタンの上にあるドロップダウンメニューをクリックします。
  5. SOAP Web サービスの権限を選択し、追加をクリックします。同様にREST Web サービスの権限も追加します。
  6. 必要に応じて他の権限も選択します。すべての権限とその用途、必要な場面については許可の設定 を参照してください。
  7. NetSuite ナビゲーションメニューで設定、次にユーザー / ロール にマウスを合わせ、ロール管理をクリックします。ロール管理ページが開きます。
  8. 「名前」列で、作成または編集したロールを割り当てたいユーザーの名前をクリックします。従業員ページが開きます。
  9. 従業員ページのタブバーでアクセスタブをクリックし、編集をクリックします。編集モードの従業員ページが開きます。

  10. ページ下部の追加ボタンの上にあるドロップダウンメニューから、新しい（または編集した）ロールを選択し、追加をクリックします。
  11. 保存をクリックします。

NetSuite への接続

NetSuite は、2種類の異なるAPI を通じてデータへのアクセスを提供しています。使用するAPI は、Schema 接続プロパティに以下のいずれかを設定することで指定します。

  • SuiteTalk はNetSuite との通信に使用される、SOAP ベースの旧来のサービスです。多くのエンティティを幅広くサポートし、INSERT / UPDATE / DELETE を完全にサポートします。 ただし、SuiteQL API に比べてデータを返す速度が遅くなります。このAPI ではサーバーサイドでのJOIN はサポートされていないため、これらのアクションは本製品 によって完全にクライアントサイドで実行されます。
  • SuiteQL は新しいAPI です。JOIN、GROUP BY、集計、およびカラムフィルタリングをサーバーサイドで実行できます。 そのため、データの抽出においてSuiteTalk よりも大幅に高速です。ただし、NetSuite データへのアクセスは読み取り専用です。

データを取得するだけの場合は、SuiteQL の使用をお勧めします。データの取得および変更が必要な場合は、SuiteTalk の使用をお勧めします。

SuiteTalk に接続する場合は、NetsuiteMetadataFolder を指定することをお勧めします。 NetSuite Metadata Folder は、NetSuite のメタデータファイルが格納されるフォルダです。指定しない場合は、フォルダの場所は自動的に選択されます。 テーブルに関するメタデータをリスト化する際のロード時間を速くするには、このプロパティを設定してください。

NetSuite への認証

NetSuite は、以下の認証方式をサポートしています。

  • トークンベース認証（TBA）はOAuth 1.0 に似ています。TBA は、2020.2 以降のSuiteTalk およびSuiteQL の両方で利用可能です。
  • OAuth 2.0 認証（OAuth 2.0 認可コードグラントフロー）は、SuiteQL でのみ利用できます。
  • OAuth JWT 認証は、OAuth 2.0 クライアント認証フローであり、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。
  • Basic 認証、つまり「ユーザー/パスワード」認証は、NetSuite バージョン2020.2以降、NetSuite ではサポートされなくなりました。Version 接続プロパティを2020.2 より前のバージョンに設定した場合に限り、CData Excel Add-In for NetSuite はUser / Password での接続を引き続きサポートしますが、すべてのお客様に対して 上記のOAuth またはトークンベース認証システムへの移行を推奨します。このオプションは、Schema 接続プロパティがSuiteTalk に設定されている場合にのみ使用できます。

トークンベース認証（OAuth 1.0）

トークンベース認証（TBA）は基本的にOAuth 1.0 です。この認証メカニズムは、SuiteTalk およびSuiteQL の両方でサポートされています。

トークンベース認証は、権限を持った管理者がOAuthClientId、OAuthClientSecret、 OAuthAccessToken、およびOAuthAccessTokenSecret をNetSuite UI 内で 直接作成することで実行されます。

NetSuite UI でのトークンの作成

多くのNetSuite 管理者は、NetSuite UI で直接トークンを作成して割り当てることを好みます。 トークン経由で接続することで、ユーザーはOAuth アクセストークンを生成するための通常の手順をスキップできます。 これにより、管理者はアクセス権の付与をより直接的に制御できるようになります。 しかし、新しいトークンを作成する必要があるたびに、UI で手動で操作を行う必要が生じます。

NetSuite UI で直接トークンを作成して割り当てる代わりに、次の手順に従ってください。

  1. NetSuite で、管理者権限を持つアカウントを使用してログインします。
  2. NetSuite ナビゲーションメニューで、設定 -> 会社にマウスを合わせ、次に機能の有効化をクリックします。機能の有効化ページが開きます。


  3. 機能の有効化ページのタブバーで、SuiteCloud をクリックします。
  4. 認証の管理セクションで、トークンベース認証を有効にします。
  5. ページ下部の青い保存ボタンをクリックします。
  6. NetSuite ナビゲーションメニューで、設定 -> インテグレーションにマウスを合わせ、次に統合を管理をクリックします。統合ページが開きます。
  7. 新しい統合を作成するには、新規作成をクリックします。統合ページが開きます。
  8. 認証セクションのトークンベース認証の下で、トークンベース認証チェックボックスを有効にします。
  9. ページ上部または下部の青い保存ボタンをクリックします。読み取り専用のページが表示されます。
  10. 認証 -> クライアント資格情報セクションに、消費者キー（コンシューマーキー）および消費者シークレット（コンシューマーシークレット）が表示されます。これらの値は、OAuthClientId およびOAuthClientSecret 接続プロパティに使用するために記録してください。


    • Note：コンシューマーキーとシークレットは、統合作成直後のこの画面でのみ表示されます。再度このページを開いても表示されません。
  11. 新しいトークンのロールを作成するには、NetSuite のナビゲーションメニューで設定 -> ユーザー / ロール -> ロール管理にマウスを合わせ、新規作成をクリックします。

    または

    既存のトークンのロールを編集するには、NetSuite ナビゲーションメニューで設定 -> ユーザー / ロール にマウスを合わせ、ロール管理をクリックします。ロール管理ページが開きます。


    ロール管理ページで、「名前」列に編集したいロールがある行で、「編集」列のカスタマイズをクリックします。

    どちらの操作でもロールページが開きます。
  12. 許可セクションで、設定 () ドロップダウンメニューをクリックします。
  13. 設定 () メニューで、追加ボタンの上にあるドロップダウンメニューをクリックします。
  14. 「追加」ボタンの上のドロップダウンからユーザーアクセストークンを選択し、水準をフルに設定して追加をクリックします。同様にアクセストークンの管理権限も追加します（水準も同様にフルに設定します）。
  15. 新しいトークンロールをユーザーに割り当てるには、NetSuite のナビゲーションメニューでリスト -> 従業員にマウスを合わせ、従業員をクリックします。従業員ページが開きます。

  16. 従業員ページのEDIT | VIEW列で、ロールを追加したいユーザーの行で編集をクリックします。従業員ページが開きます。
  17. 従業員ページのタブバーでアクセスタブをクリックします。追加ボタンの上にあるドロップダウンメニューから、新しい（または編集した）ロールを選択し、追加をクリックします。



  18. 新しいアクセストークンを作成するには、NetSuite のナビゲーションメニューで設定 -> ユーザー / ロールにマウスを合わせ、アクセストークンをクリックします。アクセストークンページが開きます。
  19. アクセストークンページで、青い新しいアクセストークンボタンをクリックします。アクセストークンページが開きます。


  20. アクセストークンページで：
    • アプリケーション名を、先ほど作成した統合に設定します。
    • ユーザーを作成したユーザーまたは変更したユーザーに設定します。
    • ロールを、前のステップで作成または更新したのと同じロールに割り当てます。
    • トークン名を任意の名前に設定します。
  21. 青い保存ボタンをクリックしてトークンを作成します。現在のページの読み取り専用バージョンが読み込まれます。
  22. 新しい読み取り専用ページのトークンID / シークレットセクションで、トークンID とトークンシークレットの値を、OAuthAccessToken およびOAuthAccessTokenSecret 接続プロパティに使用するために控えておきます。


    • Note：トークン ID とシークレットは、トークン作成直後のこの画面でのみ表示されます。再度このページを開いても表示されません。

アクセストークンが作成されたら、前の手順で取得した値を使用して接続することができます。接続する前に、少なくとも次の接続プロパティを指定します。

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

OAuth 2.0

NetSuite SuiteQL は、OAuth 2.0 認証をサポートしています。

以下のサブセクションでは、3つの一般的な認証フローでのNetSuite への認証について詳しく説明します。

  • デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。埋め込みOAuth またはカスタムOAuth で認証されます。
  • Web：共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
  • ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。埋め込みOAuth またはカスタムOAuth で認証されます。

カスタムOAuth アプリケーションの作成についての情報と、埋め込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成 を参照してください。

NetSuite で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

デスクトップアプリケーション
CData は、デスクトップでの認証を簡略化する埋め込みOAuth アプリケーションを提供します。 また、NetSuite コンソールで設定および登録するカスタムOAuth アプリケーションを介してデスクトップから認証することもできます。詳しくは、カスタムOAuth アプリケーションの作成 を参照してください。

接続の前に、以下の変数を設定します。

  • AuthScheme = OAuth
  • AccountId = 接続するアカウント。
  • InitiateOAuth = GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
  • カスタムOAuth アプリケーションのみ：
    • OAuthClientId = カスタムOAuth アプリケーションの登録時に割り当てられたクライアントId。
    • OAuthClientSecret = カスタムOAuth アプリケーションの登録時に割り当てられたクライアントシークレット。
    • CallbackURL = カスタムOAuth アプリケーションの登録時に定義されたリダイレクトURI。

接続すると、本製品 はデフォルトブラウザでNetSuite のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

アクセストークンの期限が切れたときは、本製品 は自動でアクセストークンをリフレッシュします。

OAuth アクセストークンの自動リフレッシュ：

本製品 がOAuth アクセストークンを自動的にリフレッシュするようにするには、次のように設定します。

  1. はじめてデータに接続する際、次の接続プロパティを設定します。
  2. その後のデータ接続では、以下を設定します。

OAuth アクセストークンの手動リフレッシュ：

OAuth アクセストークンを手動でリフレッシュするために必要な唯一の値は、OAuth リフレッシュトークンです。

  1. ExpiresIn 期間（GetOAuthAccessToken が返す）が経過した後にOAuthAccessToken を手動でリフレッシュするには、RefreshOAuthAccessToken ストアドプロシージャを呼び出します。
  2. 次の接続プロパティを設定します。

  3. RefreshOAuthAccessToken を呼び出し、OAuthRefreshToken にGetOAuthAccessToken によって返されたOAuth リフレッシュトークンを設定します。
  4. 新しいトークンが取得できたら、OAuthAccessToken プロパティにRefreshOAuthAccessToken によって返された値を設定します。これで新規接続が開かれます。

OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

OAuthJWT

本製品 は、OAuth 2.0 クライアント認証フローをサポートし、クライアント認証情報を含むJWT を使用してNetSuite データへのアクセスを要求します。

この認証方法により、本製品 はユーザーとのやりとりなし（マシン間）で使用できるようになります。

Note： OAuthJWT 認証方法は、Schema 接続プロパティがSuiteQL に設定されている場合にのみ使用できます。

証明書の生成

NetSuite のOAuth 2.0 クライアント認証フローでは、JWT がx.509 形式の証明書で署名されている必要があります。

OpenSSL を使用して有効な証明書を作成できます。以下は、ES256 暗号化を使用した証明書生成コンソールコマンドのサンプルです。 

openssl req -new -x509 -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes -days 365 -out public.pem -keyout private.pem

これにより、マシン上に公開キーと秘密キーのファイルが作成されます。これらのキーは、後で使用するために保存しておきます。

サポートされる証明書タイプの詳細については、NetSuite ドキュメント を参照してください。

統合レコードの作成

この認証方法に必要なクライアント認証情報のマッピングを作成する前に、統合レコードと呼ばれるアプリケーションを作成する必要があります。

統合レコードを作成するには：

  1. NetSuite ナビゲーションメニューで、設定 -> インテグレーション -> 統合を管理にマウスを合わせ、新規をクリックします。統合ページが開きます。
  2. 名前フィールドに、統合レコードの名前を入力します。
  3. 「状態」を有効に設定します。
  4. 認証 -> トークンベース認証の下で、トークンベース認証とTBA：認証フローを無効にします。
  5. 認証 -> OAuth 2.0の下で、クライアント資格情報（マシン間）付与を有効化し、承認コード付与を無効化します。
  6. ページを下にスクロールし、青い保存ボタンをクリックします。読み取り専用のページが表示されます。
  7. 認証 -> クライアント認証情報セクションまでスクロールダウンします。消費者キー（コンシューマーキー）の値を、後でOAuthJWTIssuer 接続プロパティで使用するために保存します。


    • Note： コンシューマーキーは、統合作成直後のこの画面でのみ表示されます。再度このページを開いても表示されません。
クライアント資格証明マッピングの作成

統合レコードを作成した後、エンティティ、統合レコード、および証明書の間に関連付けを作成する必要があります。

これを行うには：

  1. NetSuite ナビゲーションメニューで、設定 -> インテグレーションにマウスを合わせ、次にOAuth 2.0 クライアント資格証明（M2M）設定をクリックします。OAuth 2.0 クライアント資格証明（M2M）設定ページが開きます。

  2. 新規作成ボタンをクリックします。新規クライアント資格証明マッピングの作成画面が表示されます。

  3. このウィンドウの項目を以下のように設定します。
    • エンティティフィールドで、証明書に関連付けるエンティティを選択します。
    • ロールフィールドで、エンティティに割り当てるロールを選択します。
    • 適用フィールドで、統合レコードに付けた名前のアプリケーションを選択します。
    • 証明書の下にあるファイルを選択をクリックします。先ほど生成した公開キーファイルを選択します。
  4. 青い保存ボタンをクリックします。
接続プロパティの設定

これで、この認証方法を使用するように本製品 を設定するために必要なすべてのものが揃いました。

次の接続プロパティを設定します。

  • Schema：この認証方法は、この接続プロパティがSuiteQL に設定されている場合にのみ使用できます。
  • AuthScheme：OAuthJWT に設定。
  • JWTScope：これはJWT のスコープであり、NetSuite データに付与するアクセスレベルを指定します。これを"restlets"、"rest_webservices"、"suite_analytics"、またはそれらすべてに設定し、カンマで区切ります。
  • OAuthJWTHeaders："kid=XXXXX" に設定。XXXXX は以下のように取得します。NetSuite ナビゲーションメニューで、設定 -> インテグレーションにマウスを合わせ、次にOAuth 2.0 クライアント資格証明（M2M）設定をクリックします。OAuth 2.0 クライアント資格証明（M2M）設定ページが表示されます。適用列の値が先に作成された統合レコードの名前と一致する行の証明書ID 列の値を、この接続プロパティの値として使用します。
  • OAuthJWTCert：先ほど生成した秘密キーのマシン上のファイルパス。
  • OAuthJWTCertType：PEMKEY_FILE を選択。
  • OAuthJWTEncryption：証明書生成時に使用した暗号化方式を設定。
  • OAuthJWTIssuer：統合レコードの作成時に記録したコンシューマーキーの値。

同時リクエスト

NetSuite はアカウント毎に一定数の同時リクエストのみ受け付け、 接続毎に設定できます。（デフォルトは通常5です。）同時リクエストの最大数がすでに使用されているときに別のリクエストが 行われた場合、ユーザーは"Only one request may be made against a session at a time" エラーを受け取ることがあります。

CData Excel Add-In for NetSuite は、同時リクエスト制限を超えないように追加のリクエストを遅延させることで、この状況に 対処しようとします。ただし、アカウントに複数のマシンやアプリケーションから接続がある場合、 この処理を適切に実行することができないことがあります。

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

NetSuite への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理 を参照してください。

関連項目

  • データのクエリ：［データ選択］ウィザードを使用してスプレッドシートにデータをプルします。また、ここではスケジュールされたデータのリフレッシュも設定できます。
  • Excel アドインの使用：利用可能なCData Excel 関数 を使用するなど、NetSuite データとやり取りする他の方法が見つかります。

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 25.0.9434