CData Arc:NetSuiteコネクタの基本的な使い方

本記事ではCData Arc でのNetSuiteコネクタの基本的な使い方を説明します。 NetSuiteコネクタはCData Arc 21.0.8098でベータ版として新しく追加されました。 発注書(SalesOrder)などヘッダ-明細関係のある一部のテーブルのデータ取得や更新にも対応しています。

今回は以下のサンプルとして部門(Department)情報を対象にデータの取得と更新を行います。

f:id:urabe_shintaro:20220318094125p:plain

目次

1. 接続の作成

はじめにNetSuite への接続を作成します。 メニューの[設定]を開き、[接続]タブを選択するとCData Arc に追加されている接続一覧が表示されます。 今回は新たにNetSuite への接続を追加するために[+追加]ボタンをクリックします。

f:id:urabe_shintaro:20220318094136p:plain

以下のように接続の種類を選択する画面が表示されますので、[NetSuite]を選択して[次]ボタンをクリックします。

f:id:urabe_shintaro:20220318094149p:plain

続いて接続情報を設定する画面が開きます。 NetSuite は認証方法としてBasic 認証、OAuth 認証、トークンベース認証をサポートします。 認証方法の詳細はこちらを参考にしてください。 今回はトークンベース認証で接続します。 [Auth Scheme]を「token」に設定し、トークンベース認証に必要な情報を入力します。

f:id:urabe_shintaro:20220318094233p:plain

設定が完了したら[接続のテスト]をクリックして接続を確認してください。 最後に[接続の追加]ボタンをクリックすると接続が追加されます。

2.データの取得

[NetSuite]コネクタをフローに配置し、設定画面を開きます。 [接続]で先ほど追加したNetSuite の接続を選択します。 また、今回はデータの取得を行うため、[アクション]で「Select」を選択します。

f:id:urabe_shintaro:20220318094605p:plain

続いて取得するテーブルとカラムを選択します。 [SELECTの設定]から[追加]をクリックして、取得するテーブルを選択します。 今回は部門を取得するためDepartmentテーブルを追加します。

f:id:urabe_shintaro:20220318094542p:plain

テーブルを追加すると下にカラム一覧が表示されますので取得するカラムを選択します。 今回はInternalIdNameを選択します。

f:id:urabe_shintaro:20220318094630p:plain

設定が完了したら[変更を保存]をクリックしてください。

動作確認

それではデータを取得してみます。 コネクタ設定の[アウトプット]を開き、[受信]をクリックします。 すると以下のように部門レコードごとにXML形式のメッセージファイルが受信されます。

f:id:urabe_shintaro:20220318094659p:plain

このうちの一つをダウンロードして開くと、以下のようにレコードの内容が記載されています。

xml version="1.0" encoding="UTF-8"?>
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    
        4
        Marketing
    

続いて部門のリストをNetSuite から取得してCSVファイルに出力するフローを作成してみます。 CSV の出力はCSVMapコネクタを使用します。

f:id:urabe_shintaro:20220318103142p:plain

NetSuiteコネクタの受信を実行するとCSVMapコネクタのアウトプットにCSVファイルが生成されます。 生成されたCSVファイルを見ると部門のリストが出力されていることが分かります。

f:id:urabe_shintaro:20220318103317p:plain

3.データの追加

続いてデータの追加を行います。 追加対象のテーブルは同じく部門とし、部門名のみを指定してレコードを追加します。 [アクション]Upsert 、テーブルにはDepartment、カラムにはName のみを指定します。 NetSuite の仕様として、InternalId はレコード追加時に自動的に付与されますのでデータ追加時は指定しません。

f:id:urabe_shintaro:20220318095601p:plain

設定が完了したら[変更を保存]をクリックしてください。

動作確認

データ取得時に受信したメッセージファイルと同様に、データ入力の際にもXML形式のメッセージファイルを入力します。 今回は新しい部門「Research and Development」を追加してみます。 入力メッセージとして以下のXMLファイルを作成しました。

xml version="1.0" encoding="UTF-8"?>
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    
        Research and Development
    

コネクタ設定の[インプット]を開き、[ファイルをアップロード]をクリックします。 ファイル選択ダイアログが表示されますので作成した入力メッセージファイルを選択してください。 [アップロード]をクリックすると入力ファイルが送信されます。

f:id:urabe_shintaro:20220318095620p:plain

アップロードが成功すると以下のようにステータスがSuccess と表示されます。 エラーが発生した場合はError と表示されますので、ログ等でエラー内容を確認してください。

f:id:urabe_shintaro:20220318095631p:plain

データを追加した結果を確認してみます。 NetSuiteで部門一覧を表示すると「Research and Development」が追加されていることを確認できました。

f:id:urabe_shintaro:20220318101725p:plain

続いて部門リストのCSVファイルを読み取りNetSuite に登録するフローを作成してみます。 フローはCSVファイルをXML に変換するCSVコネクタ、XML の要素をマッピングするXMLMapコネクタ、そしてNetSuiteコネクタで構成されています。

f:id:urabe_shintaro:20220318103556p:plain

入力となるCSVファイルには3件のレコードが記録されています。

f:id:urabe_shintaro:20220318095937p:plain

フローを実行すると、CSVファイルにある3件の部門が追加されました。

f:id:urabe_shintaro:20220318095824p:plain

おわりに

本記事ではCData Arc NetSuite Connectorの基本的な使い方を説明しました。 CData Arc は30日間無料でお試しいただけます。 何かご不明な点があれば、テクニカルサポートへお気軽にお問い合わせください。


この記事では CData Arc™ 2021 - 21.0.8098 を利用しています。

トライアル・お問い合わせ

関連コンテンツ