# mulesoft Netsuite Openair Connector - Full Documentation # NetSuite OpenAir 2.0 の例 この例は、同じ要求を使用して NetSuite OpenAir インスタンスで 2 人の顧客の追加、変更、参照、削除を行う方法を示しています。この例には次の 5 つのフローが含まれます。 1. 最初のフローでは、入力のテンプレートを設定します。 2. 2 番目のフローでは、入力から 2 人の顧客を追加します。 3. 3 番目のフローでは、2 人の顧客の顧客情報を変更します。 4. 4 番目のフローでは、2 人の顧客の変更済みの顧客情報を取得します。 5. 5 番目のフローでは、2 人の顧客を削除します。 次のスクリーンショットは、Anypoint Studio のフローを示しています。  ## [](#最初のフローの作成)最初のフローの作成 最初のフローでは、後で 2 人の顧客の追加、変更、参照、削除を行う際に使用する入力の HTML テンプレートを設定します。このフローを設定するには、新しい Mule プロジェクトの作成、HTTP **Listener** ソースの設定、**\[Parse Template\]** コンポーネントの追加を行う必要があります。 ### [](#http-listener-ソースの設定)HTTP Listener ソースの設定 デフォルトパス (`/`) へのコールが行われたときに Mule フローを開始するように HTTP **Listener** ソースを設定します。 1. Studio で新しい Mule プロジェクトを作成します。 2. **\[Mule Palette (Mule パレット)\]** ビューから、**\[HTTP\]** を選択して **\[Listener\]** ソースをキャンバスにドラッグします。 3. プロパティウィンドウで、**\[Connector configuration (コネクタ設定)\]** 項目の横にある **\[+\]** をクリックしてグローバル要素を追加します。 4. **\[Display Name (表示名)\]** 項目に、「`Listener`」と入力し、デフォルト値を受け入れます。 ### [](#parse-template-コンポーネントを追加する)Parse Template コンポーネントを追加する **\[Parse Template\]** コンポーネントを追加して、メインリソースフォルダーにある HTML フォーム (`form.html`) のテンプレートを作成します。この例ではこのフォームを使用して後で 2 人の顧客の追加、変更、参照、削除を行います。 1. **\[Mule Palette (Mule パレット)\]** ビューから、**\[Core (コア)\]** を選択して **\[Parse Template\]** コンポーネントを **\[Listener\]** ソースの横にドラッグします。 2. **\[Location (場所)\]** 項目に「`form.html`」と入力します。 ## [](#2-番目のフローの作成)2 番目のフローの作成 2 番目のフローでは、顧客名と会社の入力値から 2 人の顧客を追加します。このフローを設定するには、HTTP **Listener** ソースの設定、**\[Logger\]** コンポーネントの追加、**\[Transform Message\]** コンポーネントの追加、**Add** 操作の追加、別の **\[Transform Message\]** コンポーネントの追加、別の **\[Logger\]** コンポーネントの追加を行う必要があります。 ### [](#http-listener-ソースの設定-2)HTTP Listener ソースの設定 `/add` パスへのコールが行われたときに Mule フローを開始するように HTTP **Listener** ソースを設定します。 1. **\[Mule Palette (Mule パレット)\]** ビューから、**\[HTTP\]** を選択して **\[Listener\]** ソースをキャンバスにドラッグします。 2. プロパティウィンドウで、**\[Connector configuration (コネクタ設定)\]** 項目の横にある **\[+\]** をクリックしてグローバル要素を追加します。 3. **\[Display Name (表示名)\]** 項目に、「`Listener`」と入力します。 4. **\[Path (パス)\]** 項目に、「`/add`」と入力します。 ### [](#logger-コンポーネントを追加する)Logger コンポーネントを追加する ペイロードのログを記録するために **\[Logger\]** コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]** ビューから、**\[Core (コア)\]** を選択して **\[Logger\]** コンポーネントを **\[Listener\]** ソースの横にドラッグします。 2. **\[Message (メッセージ)\]** 項目に、「`payload`」と入力します。 ### [](#transform-message-コンポーネントを追加する)\[Transform Message\] コンポーネントを追加する 2 人の顧客の顧客名と会社の入力値を XML に変換して後で追加できるようにするために **\[Transform Message\]** コンポーネントを追加します。 1. **\[Mule Palette (Mule パレット)\]** ビューから、**\[Core (コア)\]** を選択して **\[Transform Message\]** コンポーネントを **\[Logger\]** コンポーネントの横にドラッグします。 2. プロパティウィンドウで、**\[Output (出力)\]** セクションの括弧を次の DataWeave コードで上書きします。 ```dataweave %dw 2.0 output application/xml ns ns0 http://namespaces.soaplite.com/perl --- { ArrayOfoaBase: { oaBase: { ns0#oaCustomer: { name: payload.customerName_1, company: payload.customerCompany_1 }, ns0#oaCustomer: { name: payload.customerName_2, company: payload.customerCompany_2 } } } } ``` ### [](#add-操作を追加する)Add 操作を追加する 2 人の顧客を追加するために **Add** 操作を追加します。 1. **\[Mule Palette (Mule パレット)\]** ビューから、**\[NetSuite OpenAir\]** を選択して **\[Add\]** 操作を **\[Transform Message\]** コンポーネントの横にドラッグします。 2. プロパティウィンドウで、次の項目を入力します。
| 項目 | 値 |
|---|---|
oaObject |
|
Request (要求) |
|
| 項目 | 値 |
|---|---|
oaObject |
|
Request (要求) |
|
| 項目 | 値 |
|---|---|
oaObject |
|
Request (要求) |
|
| 項目 | 値 |
|---|---|
oaObject |
|
Request (要求) |
|
| アプリケーション/サービス | バージョン |
|---|---|
Mule |
EE 4.1.0 以降 |
Anypoint Studio |
7.1 以降 |
Java |
JDK 8 |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Name (名前) |
String (文字列) |
この設定の名前。コネクタはこの名前の設定を参照します。 |
x |
|
Connection (接続) |
この設定に指定できる接続種別。 |
x |
||
Expiration Policy (有効期限ポリシー) |
動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Runtime で期限切れに相当するとみなされます。これは、インスタンスが有効期限の対象となった瞬間にプラットフォームでそのインスタンスが期限切れになるということではありません。ランタイムによって適切と判断されたときに、インスタンスが実際にパージされます。 |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Company (会社) |
String (文字列) |
x |
||
Username (ユーザー名) |
String (文字列) |
x |
||
Password (パスワード) |
String (文字列) |
x |
||
Api Namespace (API 名前空間) |
String (文字列) |
x |
||
Api Key (API キー) |
String (文字列) |
x |
||
エンドポイント |
String (文字列) |
エンドポイントを開きます。デフォルト値: |
|
|
Connection Timeout (接続タイムアウト) |
Number (数値) |
接続タイムアウト。デフォルト値: 300 秒 |
300 |
|
Read Timeout (読み取りタイムアウト) |
Number (数値) |
読み取りタイムアウト: デフォルト値: 270 秒 |
270 |
|
Reconnection (再接続) |
アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。 |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
oaObject |
String (文字列) |
追加する oaObject。 |
x |
|
Request |
Binary (バイナリ) |
add 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Request |
Binary (バイナリ) |
create account 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Request |
Binary (バイナリ) |
create user 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
oaObject |
String (文字列) |
削除する oaObject。 |
x |
|
Request |
Binary (バイナリ) |
delete 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Request |
Binary (バイナリ) |
makeURL 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
oaObject |
String (文字列) |
変更する OpenAir オブジェクト。 |
x |
|
Request |
Binary (バイナリ) |
modify 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
oaObject |
String (文字列) |
読み取る oaObject。 |
x |
|
Request |
Binary (バイナリ) |
read 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Request |
Binary (バイナリ) |
RunReport 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Request |
Binary (バイナリ) |
server time 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
oaObject |
String (文字列) |
承認申請する oaObject。 |
x |
|
Request |
Binary (バイナリ) |
Submit 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
oaObject |
String (文字列) |
更新/挿入する oaObject。 |
x |
|
Request |
Binary (バイナリ) |
upsert 要求を含む要求。 |
|
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 名前 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Configuration (設定) |
String (文字列) |
使用する設定の名前。 |
x |
|
Streaming Strategy (ストリーミング戦略) |
|
反復可能なストリームを使用するように設定します。 |
||
Target Variable (対象変数) |
String (文字列) |
操作の出力を保存する変数の名前。 |
||
Target Value (対象値) |
String (文字列) |
操作の出力に対して評価する式。その式の結果は対象変数に保存されます。 |
|
|
Reconnection Strategy (再接続戦略) |
接続エラーが発生した場合の再試行戦略。 |
型 |
Binary (バイナリ) |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Fails Deployment (デプロイメントに失敗) |
Boolean (ブール) |
アプリケーションがデプロイされると、すべてのコネクタで接続テストが実行されます。true に設定されている場合、関連する再接続戦略をすべて実行した後にテストに合格しないと、デプロイメントが失敗します。 |
||
Reconnection Strategy (再接続戦略) |
使用する再接続戦略。 |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Frequency (頻度) |
Number (数値) |
再接続する頻度 (ミリ秒)。 |
||
Count (数) |
Number (数値) |
再接続の試行回数。 |
||
blocking (ブロック) |
Boolean (ブール) |
false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。 |
true |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Frequency (頻度) |
Number (数値) |
再接続する頻度 (ミリ秒)。 |
||
blocking (ブロック) |
Boolean (ブール) |
false の場合、再接続戦略が個別の非ブロックスレッドで実行されます。 |
true |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Max Idle Time (最大アイドル時間) |
Number (数値) |
有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。 |
||
Time Unit (時間単位) |
Enumeration (列挙)。次のいずれかになります。
|
maxIdleTime 属性の時間単位。 |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Initial Buffer Size (初期バッファサイズ) |
Number (数値) |
ストリームをコンシュームしてランダムにアクセスするために割り当てられるメモリ量。ストリームに含まれているデータがこのバッファに適合できる量を超えている場合、bufferSizeIncrement 属性に従ってバッファが拡張され、上限は maxInMemorySize となります。 |
||
Buffer Size Increment (バッファサイズ増分) |
Number (数値) |
バッファサイズが初期サイズを超えた場合に、どれだけ拡張するか。値を 0 以下に設定すると、バッファが拡張されません。つまり、バッファがフルになると、STREAM_MAXIMUM_SIZE_EXCEEDED エラーが発生します。 |
||
Max Buffer Size (最大バッファサイズ) |
Number (数値) |
使用するメモリの最大量。これを超えると、STREAM_MAXIMUM_SIZE_EXCEEDED エラーが発生します。0 以下の値は無制限を意味します。 |
||
Buffer Unit (バッファ単位) |
Enumeration (列挙)。次のいずれかになります。
|
これらのすべての属性の単位 |
| 項目 | 型 | 説明 | デフォルト値 | 必須 |
|---|---|---|---|---|
Max In Memory Size (最大メモリ内サイズ) |
Number (数値) |
データをメモリ内に保持するためにストリームで使用する最大メモリを定義します。これを超えると、ディスクへのコンテンツのバッファが開始されます。 |
||
Buffer Unit (バッファ単位) |
Enumeration (列挙)。次のいずれかになります。
|
maxInMemorySize で表される単位 |