NetSuite
NetSuite コネクタを使用すると、NetSuite データに対して、挿入、削除、更新、読み取りオペレーションを実行できます。
始める前に
NetSuite コネクタを使用する前に、次の作業を行います。
- Google Cloud プロジェクトで次の操作を行います。
- ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
- コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
- コネクタに使用するサービス アカウントに、次の IAM ロールを付与します。
roles/secretmanager.viewer
roles/secretmanager.secretAccessor
サービス アカウントは特別なタイプの Google アカウントで、Google API のデータにアクセスするのに認証を受ける必要がある人間以外のユーザーを表します。サービス アカウントがない場合は、サービス アカウントを作成する必要があります。コネクタとサービス アカウントは同じプロジェクトに属している必要があります。詳細については、サービス アカウントを作成するをご覧ください。
- 次のサービスを有効にします。
secretmanager.googleapis.com
(Secret Manager API)connectors.googleapis.com
(Connectors API)
サービスを有効にする方法については、サービスを有効にするをご覧ください。
以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときにそれを有効にすることを求められます。
コネクタを構成する
接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。
- Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
- [+ 新規作成] をクリックして [接続の作成] ページを開きます。
- [ロケーション] セクションで、接続のロケーションを選択します。
- リージョン: プルダウン リストからロケーションを選択します
コネクタをサポートしているリージョンは次のとおりです。
サポートされているすべてのリージョンの一覧については、ロケーションをご覧ください。
- [次へ] をクリックします。
- リージョン: プルダウン リストからロケーションを選択します
- [接続の詳細] セクションで、次の操作を行います。
- コネクタ: 使用可能なコネクタのプルダウン リストから [NetSuite] を選択します。
- コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
- [接続名] フィールドに、接続インスタンスの名前を入力します。
接続名は次の条件を満たす必要があります。
- 接続名には英字、数字、ハイフンを使用できます。
- 文字は小文字のみを使用できます。
- 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
- 接続名は 49 文字以内で指定してください。
- 必要に応じて、接続インスタンスの [説明] を入力します。
- 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは
Error
に設定されています。 - サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
- 必要に応じて、接続ノードの設定を構成します。
- ノードの最小数: 接続ノードの最小数を入力します。
- ノードの最大数: 接続ノードの最大数を入力します。
ノードは、トランザクションを処理する接続の単位(またはレプリカ)です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され(可用性を高めるため)、最大ノード数は 50 に設定されます。
- Account Id: ユーザー名が NetSuite に関連付けられている企業アカウント。
- Aggregate Column Mode: 集計列の扱われ方を指定します。
- Application Id: バージョン 2020.1 以降、NetSuite へのリクエストにはアプリケーション ID が必要です。
- Custom Field Permissions: カスタム フィールド権限のカンマ区切りのリスト。includeCustomFieldColumns よりも細かく制御できます。
- Include Child Tables: 子テーブルを表示するかどうかを示すブール値。
- Include Custom Field Columns: カスタム フィールド列を含めるかどうかを示すブール値。
- Include Custom List Tables: カスタムリストに基づいてテーブルを使用するかどうかを示すブール値。
- Include Custom Record Tables: カスタム レコードタイプに基づいてテーブルを使用するかどうかを示すブール値。
- Include Reference Columns: レコード参照を表すフィールドからデータを取得する際に含める列を表すカンマ区切りのリスト。
- Maximum Concurrent Sessions: 接続で使用可能な同時セッションの最大数。
- Net Suite Date Format: NetSuite UI で設定された優先日付形式。
- Net Suite Long Date Format: NetSuite UI で設定された優先日付形式。
- Netsuite Metadata Folder: NetSuite からメタデータ ファイルをダウンロードするためのディレクトリへのパス。最適なパフォーマンスを得るには、これを設定します。
- Report Doubles As Decimal: 倍精度 10 進数としてレポートするかどうかを示します。
- Request Memorized Transactions: NetSuite からトランザクションを取得する際に記憶されたトランザクションをリクエストするかどうかを示すブール値。
- Role Id: RoleId は、NetSuite へのログインに使用されるロールの InternalId です。ユーザーのデフォルトのロールを使用するには、空のままにします。
-
スキーマ: 使用するスキーマのタイプ。 次のいずれかの値を選択できます。
- SuiteTalk - SOAP ベースの接続用。
- SuiteSQL - REST ベースの接続用。
- Use Async Services: 挿入、更新、削除時に非同期サービスを使用するかどうかを示すブール値。
- Use Internal Names For Customizations: カスタマイズに内部名を使用するかどうかを示すブール値。
- Use Upserts: 挿入オペレーションの使用時に upsert を実行するかどうかを示すブール値。
- User Timezone Offset: NetSuite の設定の [Home] > [Preferences] > [Time Zone] で定義されたユーザー タイムゾーン オフセット。例: EST。
- Row Scan Depth: テーブルの列を動的に決定するときにスキャンする行数。
- (省略可)[詳細設定] セクションで、[プロキシを使用する] チェックボックスをオンにして、接続用のプロキシ サーバーを構成し、次の値を構成します。
-
Proxy Auth Scheme: プロキシ サーバーで認証する認証タイプを選択します。次の認証タイプがサポートされています。
- 基本: 基本的な HTTP 認証。
- ダイジェスト: ダイジェスト HTTP 認証。
- Proxy User: プロキシ サーバーでの認証に使用されるユーザー名。
- プロキシ パスワード: ユーザーのパスワードの Secret Manager シークレット。
-
Proxy SSL Type: プロキシ サーバーへの接続時に使用する SSL タイプ。次の認証タイプがサポートされています。
- 自動: デフォルトの設定。URL が HTTPS URL の場合は、[トンネル] オプションが使用されます。URL が HTTP URL の場合、[なし] オプションが使用されます。
- 常に: 接続は常に SSL 対応です。
- なし: 接続は SSL に対応していません。
- トンネル: 接続はトンネリング プロキシ経由で行われます。プロキシ サーバーがリモートホストへの接続を開き、トラフィックはプロキシを経由するようになります。
- [Proxy Server] セクションで、プロキシ サーバーの詳細を入力します。
- [+ 宛先を追加] をクリックします。
- [宛先の種類] を選択します。
- Host address: 宛先のホスト名または IP アドレスを指定します。
バックエンドへのプライベート接続を確立する場合は、次のようにします。
- PSC サービス アタッチメントを作成します。
- エンドポイント アタッチメント作成してから、ホストアドレスフィールドにあるエンドポイント アタッチメントの詳細を入力します。
- Host address: 宛先のホスト名または IP アドレスを指定します。
- 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
- [次へ] をクリックします。
- [宛先] セクションに、接続するリモートホスト(バックエンド システム)の詳細を入力します。
- 宛先タイプ: 宛先の詳細は、ホストアドレスまたはサービス アタッチメントとして指定できます。次のいずれかの宛先タイプを選択します。
- ホストアドレス: 宛先のホスト名または IP アドレスを指定する場合。
- サービス アタッチメント: 内部 IP アドレスのプライベート エンドポイントを指定する場合。サービス アタッチメントを使用すると、外部ネットワークから内部 IP アドレスを非表示にできます。Private Service Connect 機能を使用して、Google Cloud でサービス アタッチメントを作成できます。Private Service Connect の構成については、マネージド サービスを公開するをご覧ください。
選択した宛先タイプに基づいて、ホストアドレスまたはサービス アタッチメント名を入力します。
他の宛先を入力するには、[+ 宛先を追加] をクリックします。
- [次へ] をクリックします。
- 宛先タイプ: 宛先の詳細は、ホストアドレスまたはサービス アタッチメントとして指定できます。次のいずれかの宛先タイプを選択します。
-
[認証] セクションで、認証の詳細を入力します。
- [認証タイプ] を選択し、関連する詳細を入力します。
NetSuite 接続でサポートされる認証タイプは次のとおりです。
- ユーザー名とパスワードを指定する
- トークンベースの認証
- OAuth 2.0 認証コード付与
- [次へ] をクリックします。
これらの認証タイプの構成方法については、認証を構成するをご覧ください。
- [認証タイプ] を選択し、関連する詳細を入力します。
- Review: 接続と認証の詳細を確認します。
- [作成] をクリックします。
認証を構成する
使用する認証に基づいて詳細を入力します。
-
ユーザー名とパスワードを指定する
ユーザー名とパスワードによる認証。これは、NetSuite バージョン 2020.2 以前でのみ有効です。
- ユーザー名: コネクタのユーザー名
- パスワード: コネクタに関連付けられたパスワードを含む Secret Manager の Secret。
-
トークンベースの認証
NetSuite のトークンベースの認証。これは
SuiteTalk
スキームとSuiteQL
スキームの両方で使用できます。- OAuth クライアント ID: アプリケーションの作成時に表示されたコンシューマ キー。
- OAuth クライアント シークレット: アプリケーションの作成時に表示されるコンシューマ シークレットを含む Secret Manager の Secret。
- OAuth アクセス トークン: アクセス トークンが作成されたときのトークン ID。
- OAuth アクセス トークン シークレット: アクセス トークンの作成時にトークン シークレットを含む Secret Manager のシークレット。
- OAuth 2.0 - 認証コード
- クライアント ID: アクセス トークンのリクエストに使用されるクライアント ID。
- スコープ: 必要なスコープのカンマ区切りのリスト。
- クライアント シークレット: アクセス トークンのリクエストに使用されるクライアント シークレット。
接続の承認は、ウェブベースのユーザー ログイン フローで行われます。これは SuiteQL
スキームでのみ有効です。
Authorization code
認証タイプの場合は、接続を作成した後、認証を構成するためにいくつかの追加手順を行う必要があります。詳しくは、接続作成後の追加手順をご覧ください。
接続作成後の追加手順
認証に OAuth 2.0 - Authorization code
を選択した場合は、接続の作成後に次の追加の手順を行う必要があります。
- 接続ページで、新しく作成された接続を見つけます。
新しいコネクタの [ステータス] は [承認が必要] になります。
- [承認が必要] をクリックします。
これにより、[承認の編集] ペインが表示されます。
- [リダイレクト URI] の値を外部アプリケーションにコピーします。
- 認可の詳細を確認します。
- [Authorize(承認)] をクリックします。
認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。
認証コードの再認可
Authorization code
認証タイプを使用していて、バックエンドの NetSuite アプリケーションの構成を変更した場合は、NetSuite 接続を再認可する必要があります。接続を再認可するには、次の手順を行います。
- [接続] ページで必要な接続をクリックします。
これにより、[接続の詳細] ページが開きます。
- [編集] をクリックして、接続の詳細を編集します。
- [認証] セクションで [OAuth 2.0 - 認証コード] の詳細を確認します。
必要に応じて必要な変更を加えます。
- [保存] をクリックします。接続の詳細ページに移動します。
- [認証] セクションで [承認の編集] をクリックします。これにより、[承認] ペインが表示されます。
- [Authorize(承認)] をクリックします。
認可が成功すると、[接続] ページの接続ステータスが「有効」に設定されます。
NetSuite を構成する
クライアント ID、クライアント シークレット、トークン ID、トークン シークレットを生成するには、次の操作を行います。
- NetSuite で新しい統合を作成します。
- 名前などの統合の詳細を指定し、トークンベースの認証を有効にします。
- コールバック URL(
https:cloud.google.com/connectors/oauth?e=ApplicationIntegrationConnectorPaginatedFieldsLaunch%3A%3AApplicationIntegrationConnectorPaginatedFieldsEnabled&project=PROJECT_NAME
など)を指定します。 - 統合を送信すると、クライアント ID とクライアント シークレットが届きます。これらの詳細を保存します。
- 統合ユーザー レコードを設定します。
- トークンとシークレットを作成するには、ホームページに移動し、[Manage Access Tokens] を選択して、[New My Access Token] をクリックします。これらの詳細情報を使用して、 Google Cloudでトークンベースの認証を作成します。
Postman の設定方法については、Postman コレクションのインポートをご覧ください。
システムの上限
FTP コネクタは、ノードごとに 1 秒あたり 1 件のトランザクションを処理することができ、この上限を超えるトランザクションはすべてthrottlesされます。 デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます(可用性を高めるため)。
Integration Connectors に適用される上限の詳細については、上限をご覧ください。
インテグレーションで NetSuite 接続を使用する
接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、Connectors タスクを介して統合で使用できます。
- Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
- Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
エンティティ オペレーションの例
このセクションでは、Netsuite コネクタでサポートされているエンティティ オペレーションを一覧表示し、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。
エンティティ | サポートされているオペレーション |
---|---|
CreditMemo | LIST、GET、CREATE、UPDATE |
顧客 | LIST、GET、CREATE、UPDATE |
CustomerPayment | LIST、GET、CREATE、UPDATE |
ItemFulfillment | LIST、GET、CREATE |
JournalEntry | LIST、GET、CREATE |
PurchaseOrder | LIST、GET、CREATE、UPDATE |
ReturnAuthorization | LIST、GET、CREATE |
SalesOrder | LIST、GET、CREATE、UPDATE |
ベンダー | LIST、GET、CREATE、UPDATE |
VendorBill | LIST、GET、CREATE、UPDATE |
VendorCredit | LIST、GET、CREATE、UPDATE |
VendorPayment | LIST、GET、CREATE、UPDATE |
CashRefund | LIST、GET、CREATE |
CashSale | LIST、GET、CREATE |
CustomerDeposit | LIST、GET |
CustomerRefund | LIST、GET |
従業員 | LIST、GET |
見積もり | LIST、GET |
ファイル | LIST、GET |
InventoryAdjustment | LIST、GET、CREATE |
InventoryItem | LIST、GET |
ItemReceipt | LIST、GET |
機会 | LIST、GET |
PaycheckJournal | LIST、GET、CREATE |
SupportCase | LIST、GET |
SupportCaseIssue | LIST、GET |
TransferOrder | LIST、GET、CREATE |
VendorReturnAuthorization | LIST、GET |
WorkOrder | LIST、GET |
AssemblyItem | LIST、GET |
ビン | LIST、GET |
CustomerCategory | LIST、GET |
ItemGroup | LIST、GET |
KitItem | LIST、GET |
LotNumberedAssemblyItem | LIST、GET |
LotNumberedInventoryItem | LIST、GET |
NonInventoryPurchaseItem | LIST、GET |
NonInventoryResaleItem | LIST、GET |
NonInventorySaleItem | LIST、GET |
OtherChargePurchaseItem | LIST、GET |
OtherChargeResaleItem | LIST、GET |
OtherChargeSaleItem | LIST、GET |
SerializedAssemblyItem | LIST、GET |
SerializedInventoryItem | LIST、GET |
ServicePurchaseItem | LIST、GET |
ServiceResaleItem | LIST、GET |
ServiceSaleItem | LIST、GET |
CreditMemo_itemList | 作成 |
Invoice_itemList | 作成 |
PurchaseOrder_itemList | 作成 |
SalesOrder_itemList | 作成 |
VendorBill_itemList | 作成 |
VendorCredit_itemList | 作成 |
VendorPayment_applyList | 作成 |
NetSuite で挿入オペレーションを実行するときに、必要なフィールドとデータがすべて指定されていない場合、エンティティが調整されている API はリクエストを拒否します。これにより、例外が発生します。例外は、挿入オペレーションで使用されるエンティティによって異なる場合があります。データを正常に挿入するには、クエリで NetSuite の項目を指定する必要があります。項目は、すべての親テーブルで使用可能な ItemListAggregate フィールドで指定できます。ItemListAggregate フィールドの形式は次のとおりです。
"`<ItemList>`\n" + " <Row>\n" + " <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" + " <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" + " <ItemList_Amount>8500.0</ItemList_Amount>\n" + " <ItemList_Quantity>17.0</ItemList_Quantity>\n" + " <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" + " <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" + " <ItemList_Rate>500.00</ItemList_Rate>\n" + " <ItemList_Location_InternalId>1</ItemList_Location_InternalId>\n" + " <ItemList_Location_Name>02: NewYork</ItemList_Location_Name>\n" + " <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" + " <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" + " <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" + " <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" + " <CustomFieldListAggregate>\n" + " <CustomField InternalId=\"4779\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" + " <Value>1</Value>\n" + " </CustomField>\n" + " </CustomFieldListAggregate>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>656</ItemList_Item_InternalId>\n" + " <ItemList_Item_Name>Iphone 15Pro</ItemList_Item_Name>\n" + " <ItemList_Line>4</ItemList_Line>\n" + " <ItemList_Description>Canon PowerShot Camera Test</ItemList_Description>\n" + " <ItemList_Amount>8500.0</ItemList_Amount>\n" + " <ItemList_Quantity>17.0</ItemList_Quantity>\n" + " <ItemList_Price_InternalId>1</ItemList_Price_InternalId>\n" + " <ItemList_Price_Name>List Price</ItemList_Price_Name>\n" + " <ItemList_Rate>500.00</ItemList_Rate>\n" + " <ItemList_Location_InternalId>2</ItemList_Location_InternalId>\n" + " <ItemList_Location_Name>01: California</ItemList_Location_Name>\n" + " <ItemList_TaxCode_InternalId>-7</ItemList_TaxCode_InternalId>\n" + " <ItemList_TaxCode_Name>-Not Taxable-</ItemList_TaxCode_Name>\n" + " <ItemList_ShipGroup>1</ItemList_ShipGroup>\n" + " <ItemList_ItemIsFulfilled>false</ItemList_ItemIsFulfilled>\n" + " <CustomFieldListAggregate>\n" + " <CustomField InternalId=\"4776\" Type=\"platformCore:StringCustomFieldRef\" ScriptId=\"custcol121\">\n" + " <Value>4</Value>\n" + " </CustomField>\n" + " </CustomFieldListAggregate>\n" + " </Row>\n" + "`</ItemList>`;"
例 - すべてのクレジット メモを一覧表示する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
からCreditMemo
を選択します。- [
List
] オペレーションを選択してから、[完了] をクリックします。 - 必要に応じて、コネクタタスクの [タスク入力] セクションでフィルタ句を指定して、結果セットをフィルタリングできます。 フィルタ句の値は、常に単一引用符(')内で指定します。
例 - CreditMemo レコードを取得する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから CreditMemo を選択します。- [
GET
] オペレーションを選択してから、[完了] をクリックします。 - エンティティ ID を 1083723 に設定します。これは渡されるキーです。エンティティ ID を設定するには、[データ マッピング] の [データマッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに「
1083723
」を入力し、EntityId をローカル変数として選択します。エンティティ ID を直接渡します。複合キーが存在する場合、エンティティ ID を渡すとエラーがスローされることがあります。このような場合は、フィルタ句を使用して ID を指定します。
例 - PurchaseOrder レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから PurchaseOrder を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "2041", "Location_InternalId": "6", " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>66500.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" + " <ItemList_Line>3</ItemList_Line>\n" + " <ItemList_Amount>16500.0</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>" + ", "Email": "222larabrown@gmail.com" }
統合が成功すると、
PurchaseOrder
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093053" }
例 - ReturnAuthorization レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから ReturnAuthorization を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "1709", "Status": "Approved", " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>2500.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" + " <ItemList_Line>3</ItemList_Line>\n" + " <ItemList_Amount>16500.0</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>" + " }
統合が成功すると、
ReturnAuthorization
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093053" }
例 - SalesOrder レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから SalesOrder を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>9990900.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>945</ItemList_Item_InternalId>\n" + " <ItemList_Amount>99900.0</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>" + ", "Entity_InternalId": "1709" }
統合が成功すると、
SalesOrder
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093053" }
例 - CreditMemo_itemList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから CreditMemo_itemList を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ItemList_Item_InternalId": "945", "Entity_InternalId": "1709", "Location_InternalId": "5", "ItemList_Amount": 7777777.0, "ItemList_Description": "Created" }
統合が成功すると、
CreditMemo_itemList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093053", "ListId": "1" }
例 - Customer レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [Customer] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "CompanyName": "Bcone8", "Email": "222larabrown@gmail.com" }
統合が成功すると、
Customer
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "4767" }
例 - Invoice_itemList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから Invoice_itemList を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ItemList_Item_InternalId": "945", "Entity_InternalId": "1709", "ItemList_Amount": 945.0, "Item": "InvoiceItem" }
統合が成功すると、
Invoice_itemList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093052", "ListId": "1" }
例 - CustomerPayment レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから CustomerPayment を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Customer_InternalId": "1714", "Payment": 9999.0 }
統合が成功すると、
CustomerPayment
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1090749" }
例 - PurchaseOrder_itemList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから PurchaseOrder_itemList を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "2041", "Location_InternalId": "6", "ItemList_Description": "Created on Jan 11", "ItemList_Item_InternalId": "979" }
統合が成功すると、
PurchaseOrder_itemList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093151", "ListId": "1" }
例 - SalesOrder_itemList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから SalesOrder_itemList を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Email": "222larabrown@gmail.com", "Entity_InternalId": "1709", "ItemList_Item_InternalId": "945", "ItemList_Amount": 1000.0 }
統合が成功すると、
SalesOrder_itemList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093351", "ListId": "1" }
例 - Vendor レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [ベンダー] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "CompanyName": "Deloitte", "LegalName": "AU Vendor" }
統合が成功すると、
Vendor
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "5067" }
例 - VendorBill_itemList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [VendorBill_itemList] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "2041", "ItemList_Item_InternalId": "1374", "ItemList_Amount": 700.0 }
統合が成功すると、
VendorBill_itemList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "5067" }
例 - VendorCredit_itemList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから VendorCredit_itemList を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "2041", "Location_InternalId": "6", "ItemList_Item_InternalId": "992", "ItemList_Description": "Created on Jan 12" }
統合が成功すると、
VendorCredit_itemList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093353", "ListId": "1" }
例 - VendorPayment_applyList レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから VendorPayment_applyList を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ApplyList_Doc": 3339.0, "ApplyList_Apply": true, "Entity_InternalId": "1471" }
統合が成功すると、
VendorPayment_applyList
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1093756", "ListId": "1" }
例 - CreditMemo レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから CreditMemo を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ItemListAggregate": " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>8800.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" + " <ItemList_Line>3</ItemList_Line>\n" + " <ItemList_Amount>9900.0</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>" + ", "Entity_InternalId": "11", "Email": "222larabrown@gmail.com" }
統合が成功すると、
CreditMemo
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "106" }
例 - Invoice レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [Invoice] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "ItemListAggregate": " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>7998500.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>6</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>6500.0</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>" + ", "Memo": "May9" }
統合が成功すると、
Invoice
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "206" }
例 - ItemFulfillment レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから ItemFulfillment を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "CreatedFrom_InternalId": "411", "ShipStatus": "_picked" }
統合が成功すると、
ItemFulfillment
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "412" }
例 - JournalEntry レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから JournalEntry を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Subsidiary_InternalId": "1", "Memo": "Journal Entry created on April 2", "LineListAggregate":" + "<LineList>\n" + " <Row>\n" + " <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" + " <LineList_Line>1</LineList_Line>\n" + " <LineList_credit>500.0</LineList_credit>\n" + " </Row>\n" + " <Row>\n" + " <LineList_Account_InternalId>1</LineList_Account_InternalId>\n" + " <LineList_Line>1</LineList_Line>\n" + " <LineList_debit>500.00</LineList_debit>\n" + " </Row>\n" + "</LineList>" + " }
統合が成功すると、
JournalEntry
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "612" }
例 - PurchaseOrder レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから PurchaseOrder を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "2041", "Location_InternalId": "6", " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>66500.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>979</ItemList_Item_InternalId>\n" + " <ItemList_Line>3</ItemList_Line>\n" + " <ItemList_Amount>16500.0</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>" + ", "Email": "222larabrown@gmail.com" }
統合が成功すると、
PurchaseOrder
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1116228" }
例 - VendorBill レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから VendorBill を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{"Entity_InternalId": "12", " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>77700.0</ItemList_Amount>\n" + + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>888888</ItemList_Amount>\n" + + " </Row>\n" + "</ItemList>;" + "}
統合が成功すると、
VendorBill
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "816" }
例 - VendorCredit レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから VendorCredit を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{"Entity_InternalId": "12", " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>77700.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>7</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>888888</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>;" + "}
統合が成功すると、
VendorCredit
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "818" }
例 - VendorPayment レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [VendorPayment] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "12", "ApplyList_Apply": true, "ApplyList_Doc": 714.0 }
統合が成功すると、
VendorPayment
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1025", "ListId": "1" }
例 - TRANSFERORDER レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから TRANSFERORDER を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Location_InternalId": "1", "TransferLocation_InternalId": "3", "ItemListAggregate": " + "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>77700.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>888888</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>;" }
統合が成功すると、
TRANSFERORDER
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1337" }
例 - CashSale レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [CashSale] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "10", "Location_InternalId": "3", "ItemListAggregate": "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>77700.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>888888</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>;" }
統合が成功すると、
CashSale
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1234" }
例 - PaycheckJournal レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから PaycheckJournal を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Employee_InternalId": "8", "Account_InternalId": "314", "EarningListAggregate": "<EarningList>\n" + " <Row>\n" + " <EarningList_PayrollItem_InternalId>2</EarningList_PayrollItem_InternalId>\n" + " <EarningList_Amount>1998</EarningList_Amount>\n" + " </Row>\n" + "</EarningList>;" }
統合が成功すると、
PaycheckJournal
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1746" }
例 - InventoryAdjustment レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [InventoryAdjustment] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Account_InternalId": "1", "AdjLocation_InternalId": "1", "Location_InternalId": "3", "InventoryListAggregate": "<InventoryList>\n" + " <Row>\n" + " <InventoryList_Item_InternalId>8</InventoryList_Item_InternalId>\n" + " <InventoryList_Line>1</InventoryList_Line>\n" + " <InventoryList_Location_InternalId>1</InventoryList_Location_InternalId>\n" + " <InventoryList_AdjustQtyBy>100</InventoryList_AdjustQtyBy>\n" + " </Row>\n" + "</InventoryList>;" }
統合が成功すると、
InventoryAdjustment
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1640" }
例 - CashRefund レコードを作成する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [CashRefund] を選択します。- [
Create
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload をローカル変数として選択します。{ "Entity_InternalId": "10", "Location_InternalId": "3", "ItemListAggregate": "<ItemList>\n" + " <Row>\n" + " <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" + " <ItemList_Line>1</ItemList_Line>\n" + " <ItemList_Amount>799.0</ItemList_Amount>\n" + " </Row>\n" + " <Row>\n" + " <ItemList_Item_InternalId>8</ItemList_Item_InternalId>\n" + " <ItemList_Line>2</ItemList_Line>\n" + " <ItemList_Amount>666</ItemList_Amount>\n" + " </Row>\n" + "</ItemList>;" }
統合が成功すると、
CashRefund
タスクのconnectorOutputPayload
レスポンス パラメータの値は次のようになります。{ "InternalId": "1232" }
例 - CreditMemo レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから CreditMemo を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Email2": "222larabrown@gmail.com" }
- データマッパーでエンティティ ID を CreditMemo のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1090651
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1090651" }
例 - Customer レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [Customer] を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Email": "222larabrown@gmail.com" }
- データマッパーでエンティティ ID を顧客のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
4767
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "4767" }
例 - 請求書レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [Invoice] を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Email2": "222larabrown@gmail.com" }
- データマッパーでエンティティ ID を請求書のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1083927
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1083927" }
例 - CustomerPayment レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから CustomerPayment を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Customer_InternalId": "1714", "Payment": 7.77777777E8 }
- データマッパーでエンティティ ID を CustomerPayment のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1090749
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1090749" }
例 - PurchaseOrder レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから PurchaseOrder を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Message": "Aspirin Updated" }
- データマッパーでエンティティ ID を PurchaseOrder のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1000
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1000" }
例 - SalesOrder レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから PurchaseOrder を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Email": "222larabrown@gmail.com", "Entity_InternalId": "1709", "Item_InternalId": "945" }
- データマッパーでエンティティ ID を SalesOrder のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1086949
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1086949" }
例 - ベンダー レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [ベンダー] を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "CompanyName": "Deloitte_Updated" }
- データマッパーでエンティティ ID をベンダーのエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
4567
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "4567" }
例 - VendorBill レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから VendorBill を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Memo": "Memo_Jan 11" }
- データマッパーでエンティティ ID を VendorBill のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
3339
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "3339" }
例 - VendorCredit レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから VendorCredit を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Memo": "16253" }
- データマッパーでエンティティ ID を VendorCredit のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1091549
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1091549" }
例 - VendorPayment レコードを更新する
- [
Configure connector task
] ダイアログで、[Entities
] をクリックします。 Entity
リストから [VendorPayment] を選択します。- [
Update
] オペレーションを選択し、[完了] をクリックします。 - [データ マッピング] タスクの [データ マッパー] セクションで、
Open Data Mapping Editor
をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。{ "Memo": "Jan8" }
- データマッパーでエンティティ ID を VendorPayment のエンティティに設定します。エンティティ ID を設定するには、[
Open Data Mapping Editor
] をクリックし、[Input Value
] フィールドに次のような値を入力し、EntityId/ConnectorInputPayload/FilterClause をローカル変数として選択します。[entityId] を指定する代わりに、[filterClause] を
1082627
に設定することもできます。この例を実行すると、コネクタタスクの
connectorOutputPayload
出力変数で次のようなレスポンスが返されます。{ "InternalId": "1082627" }
Terraform を使用して接続を作成する
Terraform リソースを使用して、新しい接続を作成できます。
Terraform 構成を適用または削除する方法については、基本的な Terraform コマンドをご覧ください。
接続作成用の Terraform テンプレートのサンプルを表示するには、サンプル テンプレートをご覧ください。
Terraform を使用してこの接続を作成する場合は、Terraform 構成ファイルで次の変数を設定する必要があります。
パラメータ名 | データ型 | 必須 | 説明 |
---|---|---|---|
account_id | STRING | True | ユーザー名が NetSuite に関連付けられている企業アカウント。 |
aggregate_column_mode | STRING | False | 集計列の扱われ方を指定します。 |
application_id | STRING | False | バージョン 2020.1 以降、NetSuite へのリクエストにはアプリケーション ID が必要です。 |
custom_field_permissions | STRING | False | カスタム フィールド権限のカンマ区切りのリスト。includeCustomFieldColumns よりも細かく制御できます。 |
include_child_tables | BOOLEAN | False | 子テーブルを表示するかどうかを示すブール値。 |
include_custom_field_columns | BOOLEAN | False | カスタム フィールド列を含めるかどうかを示すブール値。 |
include_custom_list_tables | BOOLEAN | False | カスタムリストに基づいてテーブルを使用するかどうかを示すブール値。 |
include_custom_record_tables | BOOLEAN | False | カスタム レコードタイプに基づいてテーブルを使用するかどうかを示すブール値。 |
include_reference_columns | STRING | False | レコード参照を表すフィールドからデータを取得する際に含める列を表すカンマ区切りのリスト。 |
maximum_concurrent_sessions | INTEGER | False | 接続で使用可能な同時セッションの最大数。 |
net_suite_date_format | STRING | False | NetSuite UI で設定された優先日付形式。 |
net_suite_long_date_format | STRING | False | NetSuite UI で設定された優先日付形式。 |
netsuite_metadata_folder | STRING | False | NetSuite からメタデータ ファイルをダウンロードするためのディレクトリへのパス。最適なパフォーマンスを得るには、これを設定します。 |
report_doubles_as_decimal | BOOLEAN | False | 倍精度 10 進数としてレポートするかどうかを示します。 |
request_memorized_transactions | BOOLEAN | False | NetSuite からトランザクションを取得する際に記憶されたトランザクションをリクエストするかどうかを示すブール値。 |
role_id | STRING | False | RoleId は、NetSuite へのログインに使用されるロールの InternalId です。ユーザーのデフォルトのロールを使用するには、空のままにします。 |
schema | STRING | True | 使用するスキーマのタイプ。 |
use_async_services | BOOLEAN | False | 挿入、更新、削除時に非同期サービスを使用するかどうかを示すブール値。 |
use_internal_names_for_customizations | BOOLEAN | False | カスタマイズに内部名を使用するかどうかを示すブール値。 |
use_upserts | BOOLEAN | False | 挿入オペレーションの使用時に upsert を実行するかどうかを示すブール値。 |
user_timezone_offset | STRING | False | NetSuite の設定の [Home] > [Preferences] > [Time Zone] で定義されたユーザー タイムゾーン オフセット。例: EST。 |
row_scan_depth | STRING | False | テーブルの列を動的に決定するときにスキャンする行数。 |
詳細度 | STRING | False | 接続の詳細レベルは 1~5 です。詳細レベルが高いと、すべての通信の詳細(リクエスト、レスポンス、SSL 証明書)がログに記録されます。 |
proxy_enabled | BOOLEAN | False | 接続用のプロキシ サーバーを構成するには、このチェックボックスをオンにします。 |
proxy_auth_scheme | ENUM | False | ProxyServer プロキシへの認証に使用する認証タイプです。サポートされている値は、BASIC、DIGEST、NONE です。 |
proxy_user | STRING | False | ProxyServer プロキシへの認証に使用されるユーザー名です。 |
proxy_password | SECRET | False | ProxyServer プロキシの認証に使用されるパスワード。 |
proxy_ssltype | ENUM | False | ProxyServer プロキシへの接続時に使用する SSL のタイプです。サポートされている値は AUTO、ALWAYS、NEVER、TUNNEL です。 |
Google Cloud コミュニティの助けを借りる
Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。次のステップ
- 接続を一時停止して再開する方法を確認する。
- コネクタの使用状況をモニタリングする方法を確認する。
- コネクタログを表示する方法を確認する。