セットアップ

はじめに

正常に接続を確立して NetSuite SOAP 操作に要求を送信するには、 トークン ベース (推奨) または ユーザー資格情報のいずれかの 認証 を使用して、新しいまたは既存の NetSuite 統合レコードに接続します。

[NetSuite スコープ] アクティビティが認証を行い、他のアクティビティが NetSuite SOAP 操作に要求を送信することができるようにするには、「前提条件」を満たしたうえで以下の手順を完了する必要があります。

1. [Show Internal IDs] を有効化する

2. 統合レコードを作成する

3. 次の 2 つのオプションがあります。

4. ユーザー アクセス トークンを作成する (トークンベース認証のみ)

5. ロール ID を取得する (ユーザー資格情報認証のみ)

6. 資格情報アセットを作成する

7. プロジェクトをビルドする

   

前提条件

• NetSuite アカウント
  • [NetSuite スコープ] アクティビティにはアカウント ID が必要です。
  • NetSuite アカウント ID は NetSuite URL の先頭に示されています。たとえば、URL が https://<span>1234567.app.netsuite.com</span>/ の場合、アカウント ID は 1234567 です。
    注:

    このアクティビティ パッケージを使用する場合は、NetSuite の「 SuiteApp Architectural Fundamentals & Examples (SAFE)」 ガイドと「 Concurrency governance cheat sheet 」をご覧のうえ、 記載されているベスト プラクティス に従ってください。

手順

1. [Show Internal IDs] を有効化する

NetSuite のドキュメントの手順に従って、[ Show Internal IDs] の設定を有効化します。

この設定を有効化すると、NetSuite のすべてのフィールド、レコード、リスト、ワークフロー アクション、カスタム フォームの内部 ID を表示できます。オブジェクトの内部 ID は、ほとんどの NetSuite アクティビティで必須の入力プロパティです。

2. 統合レコードを作成する

統合レコードを作成するには、NetSuite のドキュメントに記載された手順に従います。

レコードを作成する際は、以下の認証の詳細をメモしてください。[NetSuite スコープ] アクティビティの入力プロパティ要件は、使用している認証方法によって異なります。

ヒント:

トークン ベース認証は、このアクティビティ パッケージを使用するときに推奨される認証方法です。

• トークンベースの認証

  • コンシューマー キー

  • コンシューマー シークレット

    • これらの値を取得できる機会はこの時しかありません。

      

  • ユーザー資格情報

  • アプリケーション ID

    

3a. ユーザー アクセス トークンを作成する

認証方法がトークン ベースの場合は、NetSuite のドキュメントの手順に従って ユーザー アクセス トークンを作成します。

トークンが作成されたら、確認ページに表示される Token ID と Token Secret をメモします。

3a. ロール ID を取得する

認証方法がユーザー資格情報の場合は、NetSuite のドキュメントの手順に従って 、ロールに関連付けられた内部 ID を取得します。

コネクションに使用しているロールが見つかったら、[内部 ID] 列に表示される ID をメモしてください。

4. 資格情報アセットを作成する

[ NetSuite スコープ ] アクティビティでは、以下の認証プロパティに対する SecureString 入力が必要です。

• 標準認証 (ユーザー資格情報)
  • パスワード
• トークンベースの認証
  • コンシューマーシークレット
  • トークン シークレット

NetSuite のセキュリティに関するベスト プラクティス ( 「SuiteApp Architectural Fundamentals & Examples (SAFE)」 ガイドに記載) に従うために、Orchestrator テナントの [アセット ] 機能を使用して資格情報を安全に管理し、プロパティ値に対する SecureString を生成することをお勧めします。

NetSuite の資格情報用の新しいアセットを作成するには、以下の手順に従います。

1. プロジェクトで使用する Orchestrator テナントにサインインします。

2. 左側のナビゲーションで [アセット] をクリックし、[アセット] ページを開きます。

3. プラス (+) アイコンをクリックして新しいアセットを作成します ([アセットを作成] ウィンドウが開きます)。

4. 使用する認証方法 ([標準認証 ] または [トークンベースの認証]) に応じて、以下のいずれかの手順に従います。

   

標準認証

重要:

標準資格情報は非推奨とされており、今後のリリースで削除される予定です。新しいプロジェクトには標準資格情報を使用しないでください。また、既存のプロジェクトはトークン ベースの認証を使用するように更新する必要があります。

標準認証を使用する場合は、アセットを 1 つ作成します。

1. [アセット名] に入力し、 [種類] ドロップダウン リストから **[Credential]** を選択します。

2. [ユーザー名] フィールドに、認証する NetSuite ユーザーのメール アドレスを入力します。

3. [パスワード] フィールドに、NetSuite ユーザーに関連付けられた パスワードを入力します。

4. [Create] をクリックします。

   

トークンベースの認証

トークン ベースの認証を使用する場合は、2 つのアセットを作成します。

1. [アセット名] に入力し、 [種類] ドロップダウン リストから **[Credential]** を選択します。

2. [ユーザー名] フィールドに、NetSuite 統合レコードのコンシューマー キーを入力します。

3. [パスワード] フィールドに、NetSuite 統合レコードのコンシューマー シークレットを入力します。

4. [Create] をクリックします。

   

5. 手順 1 ~ 4 を繰り返して、ServiceNow のトークン ID とトークン シークレット用の別のアセットを作成します。

   

5. プロジェクトをビルドする

1. 新しいオートメーション プロジェクトを作成します。
   1. UiPath Studio を開きます。
   2. [新しいプロジェクト] の [プロセス] をクリックします ([新しい空のプロセス] ウィンドウが開きます)。
   3. プロジェクトの [名前]、[場所]、[説明] を入力します。
   4. [Create] をクリックします。
2. UiPath.NetSuite.Activities パッケージをインストールします。
   1. [デザイン] リボンの [パッケージを管理] をクリックします ([パッケージを管理] ウィンドウが開きます)。
   2. [すべてのパッケージ] の下の [Go!] をクリックします。
   3. [検索] バーに「NetSuite」と入力します。
   4. [インストール] をクリックし UiPath.NetSuite.Activities のライセンスに同意します。
      • UiPath Studio パッケージの詳細については、『Studio ガイド』の「パッケージの管理」をご覧ください。

完了です!

以上で設定が完了したので、プロジェクトへの NetSuite アクティビティの追加を開始できます。

次のステップ

NetSuite アクティビティの詳細 (プロパティの入力/出力の例を含む) については「 アクティビティ 」ページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。