Oracle NetSuiteアダプターを使うための事前準備とコネクションの作成方法について説明します。
Oracle NetSuiteアダプターで使えるコンポーネントは下記の通りです。
| Oracle NetSuiteへSELECT文を発行して結果セットをストリームとして出力します。 | |
| Oracle NetSuiteのテーブルに対して更新を行います。 | |
| 任意のSQLの実行を行います。 |
今回は、Oracle NetSuiteアダプターを使うための事前準備とコネクションの作成方法についてご紹介いたします。
■事前準備
[Oracle NetSuite]
Oracle NetSuiteへToken認証で接続するため必要な情報の取得を行います。
-
アカウントIDの取得
[設定]メニューから[会社]→[会社情報]をクリックし、確認することができます。
OAuthクライアントID、OAuthクライアントシークレットの取得
- [設定]メニューから[インテグレーション]→[統合を管理]→[新規]をクリックします。
-
以下の通り設定します。
名前:任意の名前(例:ASTERIA_Warp_Connection)
状態:有効
トークンベース認証:チェックを入れる※今回はトークンベース認証の設定なので、OAuth2.0などの項目にチェックが入っている場合、チェックを外します。
-
「保存」 ボタンをクリックします。
-
保存直後、画面下部に消費者キー/クライアントID、消費者のシークレット/クライアントのシークレットが表示されます。ページを移動すると確認できなくなりますので、テキストエディタなどにコピーして控えてください。
ロールの作成
- [設定」メニューから[ユーザー/ロール]→[ロール管理]→[新規] をクリックします。
- 任意の名前(例:ASTERIA_Warp_TokenBase_Role)を入力します。
-
「権限」→「設定」 サブタブを開き、以下のアクセス権を「フル」で追加します。
アクセス・トークンの管理
アクセス・トークンを使用してログイン
SOAP Webサービス
REST Webサービス
(※その他、さまざまなエンティティやトランザクションを扱うために必要な権限を追加します。) -
「保存」 ボタンをクリックします。
ユーザーへのロール割り当て
- [リスト]メニューから→[従業員]→[従業員] を開き、従業員の一覧画面を表示します。
- 連携用として使用するユーザーの左側にある [編集] リンクをクリックして、編集画面を開きます。
- 画面下部にある [アクセス]タブ を選択します。
- [ロール]サブタブ の一覧の最下行(空欄の行)をクリックし作成したロール(例:ASTERIA_Warp_TokenBase_Role)を選択します。
- [追加] ボタンをクリックし、一覧にロールが追加されたことを確認します。
-
[保存] ボタンをクリックします。
トークンID、トークン・シークレットの取得
- [設定]メニューから[ユーザー/ロール]→[アクセストークン]→[新規] をクリックします。
-
以下の項目を選択します:
アプリケーション名: OAuthクライアントID、OAuthクライアントシークレットの取得 で作成したインテグレーション名を選択(例:ASTERIA_Warp_Connection)
ユーザー: ユーザーへのロール割り当てでロールを割り当てたユーザーを選択
ロール: ロールの作成作成したロールを選択(例:ASTERIA_Warp_TokenBase_Role)
トークン名: 自動入力のままで可 -
「保存」 ボタンをクリックします。
-
保存直後、画面下部にトークンID、トークン・シークレットが表示されます。ページを移動すると確認できなくなりますので、テキストエディタなどにコピーして控えてください。
※上記内容について詳しくは下記のCData社のオンラインヘルプも合わせてご参考ください。
・CData NetSuiteのオンラインヘルプ - 接続の確立
・CData NetSuiteのオンラインヘルプ - 許可の設定
[ASTERIA WARPサーバー]
Oracle NetSuiteアダプターを利用するためには事前にインストールしておく必要があります。
アダプターは[FSMC]→[システム]→[アップデート]画面にてダウンロードするか、ユーザーサイトからダウンロードしたアダプターをサーバーにアップロードすることで適用することができます。
アダプターのインストールについて詳しくは下記弊社のオンラインヘルプをご参考ください。
・[FSMC > システム > アップデート]のオンラインヘルプ
※アダプターのインストール後設定を有効にするためにはフローサービス全体の再起動が必要となります。
[フローデザイナー]
ASTERIA WARPサーバー側でOracle NetSuiteアダプターが正常にインストールされたら、フローデザイナー側でコンポーネントを取得する必要があります。
手順は下記になります。
- フローデザイナーをフローサービスに接続
- メニューの「ツール > コンポーネント/マッパー関数の取得」でjarファイルを取得
- フローデザイナーを再起動
※今回の例でダウンロードするファイルはfccdatanetsuite-1703.6381.jarとなります。
※ファイル名の数値部分(1703.6381など)は、ダウンロードする時期やアダプターのバージョンによって異なります
■コネクションの作成
事前準備が終わりましたら、コネクションを作成します。
FSMCでコネクションを作成する手順は下記になります。
- FSMC画面の[設定]→[コネクション]→[NetSuite]メニューから「新規」ボタンをクリックします。
- コネクション作成画面が表示されますので、下記の通り項目を設定します。
-
基本情報
- 接続名:任意の名前を設定します。
- 認証スキーム:Token
- アカウントId:アカウントIDの取得 で確認した「アカウントId」を設定します。
- イニシエートOAuth:OFF
- OAuthクライアントID:OAuthクライアントID、OAuthクライアントシークレットの取得 で取得した「消費者キー/クライアントID」を設定します。
- OAuthクライアントシークレット:OAuthクライアントID、OAuthクライアントシークレットの取得 で取得した「消費者のシークレット/クライアントのシークレット」を設定します。
- OAuthアクセストークン:トークンID、トークン・シークレット で取得した「トークンID」を設定します。
- OAuthアクセストークンシークレット:トークンID、トークン・シークレット で取得した「トークン・シークレット」を設定します。
※ログ、プロキシの設定については必要に応じて設定してください。
詳細情報
※必要に応じて詳細プロパティを設定します。
※デザイナーからもコネクションの設定が可能です。
■コネクションの接続テスト
Oracle NetSuiteアダプターのコネクションが作成されたので、コネクションの接続テストを実行してみます。
ご覧の通り、接続テストが成功したメッセージが確認できます。
■最後に
Oracle NetSuiteアダプターを利用するために必要な事前準備、およびコネクションの作成方法についてご紹介いたしました。
コネクションの作成後接続テストが正常に行われるとNetSuiteGetコンポーネント、NetSuitePutコンポーネント、NetSuiteSQLCallコンポーネントが使えます。
各コンポーネントの使い方については既存のRDB系のコンポーネントと同様です。
つまり、RDBGetコンポーネントの付属ツールである「SQLビルダー」、RDBPutコンポーネントの付属ツールである「テーブルの選択」ツールについても同様に使えます。
-
NetSuiteGetコンポーネントのSQLビルダー
-
NetSuitePutコンポーネントのテーブルの選択
なお、Oracle NetSuiteアダプターで使えるSQL文、またはデータモデルについては下記、CData社のオンラインヘルプも合わせてご確認ください。
その他、Oracle NetSuiteアダプターに関しては、下記 をご確認ください。
今回の紹介はここまでです。