機械翻訳について

接続の作成の前提条件

環境に固有の次の前提条件を満たし、「Oracle NetSuiteアダプタ」との接続を作成します。

トピック:

• 接続を作成するための一般的な前提条件

• トークン・ベース認証セキュリティ・ポリシーの前提条件

• ユーザー資格証明セキュリティ・ポリシーの前提条件

• TBA承認フロー・セキュリティ・ポリシーの前提条件

接続を作成するための一般的な前提条件

Oracle IntegrationからOracle NetSuiteインスタンスに正常に接続するには、特定の前提条件を満たす必要があります。 この項では、Oracle IntegrationからOracle NetSuiteを使用して作成するすべてのタイプの接続に適用される一般的な前提条件について説明します。

これらの一般的な前提条件に加えて、Oracle NetSuiteへの接続に使用できる各security-policyオプションに固有の前提条件があります。これについては、後のセクションで詳しく説明します。

トピック:

• Oracle NetSuiteに登録して機能を有効にします

• Oracle NetSuite WSDL URLのアセンブル

• カスタム・フィールドとレコードの作成

• 統合で複合タイプのカスタム・フィールドを使用するための前提条件

Oracle NetSuiteに登録して機能を有効にします

Oracle NetSuiteに接続するには、Oracle NetSuiteに登録し、Oracle NetSuiteインスタンスで有効なキー機能(SOAPやREST webサービスなど)を有効にする必要があります。

Oracle NetSuiteに登録していない場合は、次のステップに従ってアカウントを作成し、必要な機能を有効にします。

1. http://www.netsuite.comにアクセスして、Oracle NetSuiteに登録します。 管理者権限を持つアカウントを取得していることを確認してください。
2. Oracle NetSuiteインスタンスで接続関連の機能を有効にします。
   1. NetSuiteホームページで、「設定」、「会社」、「機能の有効化」の順に選択します。
   2. SuiteCloudサブタブをクリックします。
   3. SuiteScriptセクションで、次のボックスを選択します:
      1. CLIENT SUITESCRIPT。 SuiteCloud利用規約ページで「同意」をクリックします。
      2. SERVER SUITESCRIPT。 SuiteCloud利用規約ページで「同意」をクリックします。
   4. SuiteTalkセクションで、次のボックスを選択します:
      1. SOAP WEB SERVICES。 SuiteCloud利用規約ページで「同意」をクリックします。
      2. REST WEB SERVICES。 SuiteCloud利用規約ページで「同意」をクリックします。
   5. 「認証の管理」セクションで、TOKEN-BASED AUTHENTICATIONボックスを選択します。 SuiteCloud利用規約ページで「同意」をクリックします。
      TBA認証ポリシーを使用して外部アプリケーションからOracle NetSuiteに接続する場合は、TBA機能を有効にする必要があります。
   6. 「保存」をクリックします。

Oracle NetSuite WSDL URLのアセンブル

Oracle IntegrationでOracle NetSuite接続を作成するには、Oracle NetSuite webサービス記述言語(WSDL)ファイルのURLが必要です。

Oracle NetSuite WSDL URLの一般的な構文は次のとおりです : https://webservices.netsuite.com/wsdl/<OracleNetSuite_application_version>/netsuite.wsdl。

Oracle NetSuiteインスタンスのバージョンを検索し、インスタンスに対応するURLを組み立てます。

1. NetSuiteホームページで、ページの下部までスクロールして、Oracle NetSuiteインスタンスのバージョンを検索します。
2. 以前に提供されたURL構文にバージョン情報を挿入します。
   インスタンスのバージョンが2019.1の場合、WSDL URLは次のようになります:

   https://webservices.netsuite.com/wsdl/v2019_1_0/netsuite.wsdl

   詳細は、「NetSuiteバージョニングおよびWSDLのバージョン管理の概要」を参照してください。

   ノート:

   Oracle NetSuiteヘルプ・センターにアクセスするには、Oracle NetSuiteアカウントが必要です。 アプリケーション内では、任意のページの右上隅にある「ヘルプ」リンクをクリックして、Oracle NetSuiteヘルプ・センターにアクセスすることもできます。

カスタム・フィールドとレコードの作成

統合用にOracle NetSuiteのカスタム・フィールド・タイプおよびカスタム・レコード・タイプが必要な場合は、Oracle NetSuiteインスタンスで事前に作成する必要があります。

カスタム・フィールドとレコード・タイプを作成する手順については、「カスタム・フィールドの作成」および「カスタム・レコードのタイプの作成」を参照してください。

カスタム・フィールドとレコード・タイプの作成は1回かぎりのタスクです。 作成後は、「アダプタ・エンドポイント構成ウィザード」の操作ページで選択できます。

統合で複合タイプのカスタム・フィールドを使用するための前提条件

統合でOracle NetSuiteの複合タイプのカスタム・フィールドを使用する場合は、複合フィールドに関連付けられたNetSuite内部IDのいずれかを取得する必要があります。

統合の設計中に、データ・マッパー内のフィールドに関連付けられた内部ID値を渡す必要があります。

ノート:

統合フローでOracle NetSuiteの単純なタイプのカスタム・フィールドを使用している場合、データ・マッパーで内部ID値を渡す必要はありません。

参照として、Oracle NetSuite複合タイプのカスタム・フィールドの内部ID値を検索する方法を示すプロシージャの例を次に示します。

1. NetSuiteホームページで、「カスタマイズ」、「リスト、レコード、&フィールド」、「リスト」の順に選択します。
2. 「カスタム・リスト」ページで、LIST列の下にあるリンクをクリックしてカスタム・リストを開きます。

   この例では、次のイメージに示すように、「広告の設定」カスタム・リストが選択されています。 「内部ID」列の4つの値のいずれも、マッパーのターゲットcustomFieldList internalId要素に渡すことができます。

   
   「図netsuite_application.pngの説明」

ノート:

カスタム・フィールドのサポートのリリース前に作成された「Oracle NetSuiteアダプタ」接続を使用する場合は、まず、統合で使用する接続に対して接続ページの「アクション」メニューから「メタデータのリフレッシュ」を選択する必要があります。 「統合メタデータのリフレッシュ」を参照してください。 このタスクは、新しいOracle NetSuiteアダプタ接続には必要ありません。

トークン・ベース認証セキュリティ・ポリシーの前提条件

トークン・ベース認証(TBA)セキュリティ・ポリシーを「Oracle NetSuiteアダプタ」とともに使用する場合は、一般的な前提条件に加えて、このセキュリティ・ポリシー固有の前提条件を満たす必要があります。

TBAでOracle NetSuite接続を作成するには、Oracle NetSuiteインスタンスから次の詳細が必要です:

• コンシューマ・キー / クライアントID: Oracle Integration用に作成された統合レコードに関連付けられたキー/ID。
• コンシューマ・シークレット / クライアント・シークレット: Oracle Integrationに対して作成された統合レコードに関連付けられたシークレット。
• トークン: Oracle Integrationユーザー・アカウント、ロールおよび統合レコードに対して作成されたアクセス・トークンに関連付けられたトークンID。
• トークン・シークレット: Oracle Integrationユーザー・アカウント、ロールおよび統合レコードに対して作成されたアクセス・トークンに関連付けられたトークン・シークレット。
• アカウントID: Oracle NetSuiteアカウントID。

これらの詳細を作成して取得するには、「管理者」としてOracle NetSuiteインスタンスにログインし、次のタスクを実行します。

ノート:

この項に記載されているTBA関連の構成タスクを実行するには、最初にOracle NetSuiteアカウントのTBA機能を有効にする必要があります。 「Oracle NetSuiteに登録して機能の有効化」を参照してください。

トピック:

• トークン・ベース認証権限を持つロールの作成

• Oracle Integrationのユーザー・アカウントの作成

• Oracle Integrationの統合レコードの作成

• ユーザー・アカウントのアクセス・トークンの作成

• NetSuiteアカウントIDのノートの作成

トークン・ベース認証権限を持つロールの作成

新しいロールを作成し、(統合に固有の)他の必要な権限とともにTBA権限を割り当てます。 Oracle Integrationユーザー・アカウント(後で作成する)をこのロールに割り当てます。

ノート:

ベスト・プラクティスとして、TBAセキュリティ・ポリシーを使用するOracle NetSuite接続で管理者およびフル・アクセスのロール/ユーザーを使用しないでください。

新しいロールを作成するには:

1. NetSuiteホームページで、「設定」、「ユーザー/ロール」、「ロールの管理」、「新規」の順に選択します。
2. ロール・ページで、次の手順を実行します:
   1. ロールの名前を入力します(例: Oracle Integration Role)。
   2. CENTER TYPEドロップダウン・フィールドで、「システム管理者センター」を選択します。
   3. 「子会社の制限」セクションで、「すべて」を選択します。 子会社の制限については、「子会社へのロール・アクセスの制限」を参照してください。
   4. 権限タブで、使用可能な4つのサブタブからロールに必要な権限を追加: トランザクション、レポート、リストおよび設定。

      権限を追加するには、いずれかのサブタブを選択した後、次のアクションを実行します:

      1. 「許可」ドロップダウン・フィールドから権限を選択します。
      2. 「レベル」フィールドから権限のアクセス・レベルを選択します。
      3. 「追加」をクリックします。

         TBA権限を新しいロールに指定するには、フル・アクセス権を持つロールに「ユーザー・アクセス・トークン」権限を追加する必要があります。 この権限は、「権限」タブの「設定」サブタブにあります。

         このロールを割り当てられたユーザーに実行を許可するタスクに応じて、他の権限をロールに追加できます。 カスタム・ロールの場合は、「完全」レベルのSOAP webサービス権限を明示的に追加する必要があります。 「ロールへのSOAP Webサービス権限の割当て」を参照してください。

   5. 必要なすべての権限を追加したら、「保存」をクリックして新しいロールを作成します。

Oracle Integrationのユーザー・アカウントの作成

Oracle Integrationのユーザー・アカウントを作成し、このアカウントを以前に作成したTBAロールに割り当てます。 このユーザー・アカウントに関連付けられた資格証明を使用して、Oracle IntegrationからNetSuiteに接続します。

Oracle Integrationのユーザー・アカウントをすでに作成している場合は、既存のアカウントを新しいTBAロールに割り当てることができます。 「既存のユーザー・アカウントのロールへの割り当て」を参照してください。 このようにして、別のオープン・ユーザー・アカウント・ライセンスを使用する必要はありません。

newユーザーを作成してTBAロールに割り当てる必要がある場合は、次の手順に従ってください:

1. NetSuiteホームページで、「リスト」、「従業員」、「従業員」、「新規」の順に選択します。
2. 従業員ページで、次の手順を実行します:
   1. NAMEフィールドに、ユーザーの名と姓を入力します(例: Integration User05)。
   2. EMAILフィールドに、有効な電子メール・アドレスを入力します。
   3. SUBSIDIARYドロップダウン・フィールドで、選択した子会社を選択します。
   4. 下にスクロールし、「アクセス」タブをクリックして追加の構成を実行します。
      1. GIVE ACCESSおよびMANUALLY ASSIGN OR CHANGE PASSWORDチェック・ボックスを選択します。
      2. PASSWORDフィールドに、ユーザー・アカウントのパスワードを入力します。
      3. CONFIRM PASSWORDフィールドにパスワードを再入力します。
      4. このユーザーを前に作成したTBAロールに割り当てるには:
         • 「ロール」サブタブを選択した状態で、ROLEドロップダウン・フィールド(Oracle Integration Roleなど)からTBAロールを選択します。
         • 「追加」をクリックします。
   5. 「保存」をクリックして、新しいユーザー・レコードを作成します。

ノート:

既存のOracle Integrationユーザー・アカウントを新規ロールに割り当てるには:

1. NetSuiteホームページから、従業員ページにナビゲート: リスト、従業員、従業員の順に選択します。
2. Oracle Integrationユーザー・アカウント名の横にある「編集」をクリックします。
3. アカウント・ページでスクロール・ダウンし、「アクセス」タブをクリックします。
4. 「ロール」サブタブを選択した状態で、ROLEドロップダウン・フィールド(Oracle Integration Roleなど)から以前に作成したロールを選択します。
5. 「追加」をクリックし、「保存」を次にクリックします。

Oracle Integrationの統合レコードの作成

APIトークン(TBA用)を作成してユーザー・アカウントに割り当てる前に、このユーザー・アカウントを使用してNetSuiteにアクセスするアプリケーションの統合レコードを作成する必要があります。

Oracle Integrationアプリケーションの統合レコードを作成します。

ノート:

Oracle IntegrationのTBA対応統合レコードをすでに作成している場合は、この項をスキップできます。 既存のレコードを再利用して、新しいアクセス・トークンを生成します。 このようにして、同じアプリケーションの複数の統合レコードと、関連するコンシューマ・キーおよびシークレットを管理する必要はありません。

1. NetSuiteホームページで、「設定」、「統合」、「統合の管理」、「新規」の順に選択します。
2. 統合ページで、次の操作を行います:
   1. 統合レコードの名前を入力します(例: Oracle Integration TBA)。
   2. 必要に応じて、レコードの説明を入力します。
   3. STATEドロップダウン・フィールドで「有効」オプションを選択したままにします。
   4. 認証タブで次の操作を行います:
      1. TOKEN-BASED AUTHENTICATIONチェックボックスを選択したままにします。
      2. TBA: AUTHORIZATION FLOWおよびAUTHORIZATION CODE GRANTチェック・ボックスの選択を解除します。
   5. 「保存」をクリックします。

   確認ページに、この統合レコードまたはアプリケーションのクライアント資格証明が表示されます。

3. 「コンシューマ・キー / クライアントID」および「コンシューマ・シークレット / クライアント・シークレット」の値をノートにとります。 これらの資格証明を使用して、Oracle IntegrationからNetSuiteに接続します。

   ノート:

   統合レコードを初めて保存したときのみ、クライアント資格証明が表示されます。 これらの資格証明が失われたり保存に失敗した場合、資格証明をリセットする必要があります。 統合レコードを編集し、「資格証明のリセット」をクリックしてクライアント資格証明の新しいセットを生成します。

ユーザー・アカウントのアクセス・トークンの作成

アクセス・トークンを作成してOracle Integrationユーザー・アカウントに割り当てます。

1. NetSuiteホームページで、「設定」、「ユーザー/ロール」、「アクセス・トークン」、「新規」の順に選択します。
2. 「アクセス・トークン」ページで、次の手順を実行します:
   1. APPLICATION NAMEフィールドで、以前に作成した統合レコードを選択します。
   2. USERフィールドで、Oracle Integrationユーザー・アカウントを選択します。
   3. ROLEフィールドで、適切なTBAロールを選択します。
   4. TOKEN NAMEフィールドは変更しないままにします。
   5. 「保存」をクリックします。

   確認ページに、ユーザー・アカウントのトークン値が表示されます。

3. 「トークンID」および「トークン・シークレット」の値をノートにとります。 これらの資格証明を使用して、Oracle IntegrationからNetSuiteに接続します。

   ノート:

   これは、トークンIDおよびトークン・シークレットの値が表示される唯一の時間です。 これらの値を保存しない場合、新しいトークンを作成し、新しい値のセットを取得する必要があります。

NetSuiteアカウントIDのノートの作成

他の資格証明とともに、Oracle IntegrationからNetSuiteに接続するにはNetSuiteアカウントIDが必要です。

アカウントIDを表示するには:

1. NetSuiteホームページで、「設定」、「統合」、「SOAP Webサービス・プリファレンス」の順に選択します。
2. ページ上部に表示される「アカウントID」をノートにとります。
3. 「取消」をクリックしてページを終了します。

ユーザー資格証明セキュリティ・ポリシーの前提条件

「Oracle NetSuiteアダプタ」でユーザー資格証明セキュリティ・ポリシーを使用する場合は、一般的な前提条件に加えて、このセキュリティ・ポリシー固有の前提条件を満たす必要があります。

ユーザー資格証明を使用してOracle NetSuite接続を作成するには、Oracle NetSuiteインスタンスから次の詳細が必要です:

• 電子メール・アドレス: Oracle Integration用に作成されたユーザー・アカウントに関連付けられた電子メール・アドレス。
• パスワード: Oracle Integration用に作成されたユーザー・アカウントに関連付けられたパスワード。
• ロール: Oracle Integration用に作成されたユーザー・アカウントに関連付けられたロールのID。
• アカウントID: Oracle NetSuiteアカウントID。
• アプリケーションID: Oracle Integration用に作成された統合レコードに関連付けられたアプリケーションID。

これらの詳細を作成して取得するには、「管理者」としてOracle NetSuiteインスタンスにログインし、次のタスクを実行します。

ノート:

ユーザー資格証明セキュリティ・ポリシーに関連する構成タスクを実行するには、まずOracle NetSuiteアカウントでSOAPおよびREST webサービスを有効にする必要があります。 「Oracle NetSuiteに登録して機能の有効化」を参照してください。

1. webサービス権限を持つ新規ロールを作成します。 Oracle NetSuiteで新しいカスタム・ロールを作成するステップは、「新規ロールの作成」を参照してください。
   統合に固有の必要な権限とともに、フル・アクセスを持つ新しいロールに次の権限を追加します:

   • REST Webサービス
   • SOAP Webサービス
   これらの権限は、「権限」タブの「設定」サブタブにあります。

   ノート:

   ベスト・プラクティスとして、ユーザー資格証明セキュリティ・ポリシーを使用するOracle NetSuite接続で管理者およびフル・アクセスのロール/ユーザーを使用しないでください。
2. Oracle Integrationのユーザー・アカウントを作成し、前のステップで作成したwebサービス対応ロールにこのアカウントを割り当てます。 このユーザー・アカウントの資格証明を使用して、Oracle IntegrationからNetSuiteに接続します。 Oracle NetSuiteに新しいユーザー・アカウントを作成するステップについては、「Oracle Integrationのユーザー・アカウントの作成」を参照してください。

   電子メール・アドレスとパスワードを書き留めます。

   ノート:

   Oracle Integrationのユーザー・アカウントをすでに作成している場合は、既存のアカウントを新しいwebサービス対応ロールに割り当てることができます。 「既存のユーザー・アカウントのロールへの割り当て」を参照してください。 このようにして、別のオープン・ユーザー・アカウント・ライセンスを使用する必要はありません。
3. Oracle Integrationユーザー・アカウントのデフォルト・ロールを設定します。
   1. NetSuiteホームページで、「設定」、「統合」、「SOAP Webサービス・プリファレンス」の順に選択します。
   2. 表示されるページで、次のオプションを選択します。
      1. NAMEフィールドで以前に作成したユーザー・アカウントを選択します。
      2. WEB SERVICES DEFAULT ROLEフィールドで、ユーザー・アカウントに関連付けられたwebサービス対応ロールを選択します。
      3. 「追加」をクリックします。

         追加したロールのIDが行に表示されます。

      4. この「ロールID」およびページの上部に表示される「アカウントID」も書き留めます。
      5. 「保存」をクリックします。
4. Oracle Integrationアプリケーションの統合レコードを作成します。 Oracle NetSuiteに新しい統合レコードを作成するステップについては、「Oracle Integrationの統合レコードの作成」を参照してください。
   1. 統合ページの「認証」タブで、USER CREDENTIALSチェック・ボックスを選択し、TOKEN-BASED AUTHENTICATION、TBA: AUTHORIZATION FLOWおよびAUTHORIZATION CODE GRANTチェック・ボックスの選択を解除します。
   2. 「保存」をクリックします。

      レコードを保存すると、APPLICATION IDが表示されます。 このIDを書き留めます。

   ノート:

   Oracle Integrationのユーザー資格証明対応の統合レコードをすでに作成している場合は、このステップをスキップできます。 既存のレコード・アプリケーションIDを書き留めます。 このようにして、同じアプリケーションについて複数の統合レコードを管理する必要はありません。

TBA承認フロー・セキュリティ・ポリシーの前提条件

「Oracle NetSuiteアダプタ」でTBA認証フロー・セキュリティ・ポリシーを使用する場合は、一般的な前提条件に加えて、このセキュリティ・ポリシーに固有の前提条件を満たす必要があります。

TBA認可フローでOracle NetSuite接続を正常に作成するには、次を実行する必要があります:

• 接続で管理者ロールを持つOracle NetSuiteアカウントを使用します。 「管理者ロール」を参照してください。
• Oracle NetSuiteアカウントのTBA機能を有効にします。 「Oracle NetSuiteに登録して機能の有効化」を参照してください。

ノート:

TBA認可フロー・セキュリティ・ポリシーは、Oracle Integrationのカスタム・エンドポイントでは機能しません。 「Oracle Integration Generation 2のプロビジョニングと管理」の「インスタンスのカスタム・エンドポイントの構成」を参照してください。