BigCommerce Connector for CData Sync

Build 24.0.9175
  • BigCommerce
    • 接続の確立
    • 高度な機能
      • SSL の設定
      • ファイアウォールとプロキシ
    • データモデル
      • テーブル
        • Brands
        • Categories
        • ChannelListings
        • Channels
        • Coupons
        • Currencies
        • CustomerAddresses
        • Customers
        • OrderItems
        • Orders
        • OrderShipments
        • PriceListRecords
        • PriceLists
        • ProductImages
        • ProductMetafields
        • ProductOptions
        • ProductOptionValues
        • ProductReviews
        • Products
        • ProductVariants
        • ShippingMethods
        • ShippingZones
      • ビュー
        • Blogposts
        • BlogTags
        • CustomerGroups
        • DownloadConsignments
        • EmailConsignments
        • GiftCertificates
        • OrderCoupons
        • OrderItemOptionValues
        • OrderMessages
        • OrderRefunds
        • OrderRefundsItems
        • OrderRefundsPayments
        • OrderShippingAddresses
        • OrderStatuses
        • OrderTaxes
        • Pages
        • PaymentMethods
        • PickupConsignments
        • PriceListAssignments
        • ProductBulkPricingRules
        • ProductCustomFields
        • ProductRules
        • ProductSkus
        • ProductVariantValues
        • ProductVideos
        • Redirects
        • ShipmentItems
        • ShippingConsignmentQuotes
        • ShippingConsignments
        • Stores
        • TaxClasses
        • Transactions
    • 接続文字列オプション
      • Authentication
        • AuthScheme
      • OAuth
        • OAuthClientId
        • OAuthClientSecret
        • OAuthAccessToken
        • StoreId
      • SSL
        • SSLServerCert
      • Firewall
        • FirewallType
        • FirewallServer
        • FirewallPort
        • FirewallUser
        • FirewallPassword
      • Proxy
        • ProxyAutoDetect
        • ProxyServer
        • ProxyPort
        • ProxyAuthScheme
        • ProxyUser
        • ProxyPassword
        • ProxySSLType
        • ProxyExceptions
      • Logging
        • LogModules
      • Schema
        • Location
        • BrowsableSchemas
        • Tables
        • Views
      • Miscellaneous
        • CustomFieldDiscovery
        • IncludeCustomFields
        • MaxRows
        • Other
        • PseudoColumns
        • RowScanDepth
        • Timeout
        • UserDefinedViews

BigCommerce Connector for CData Sync

概要

CData Sync App は、BigCommerce データをデータベース、データレイク、またはデータウェアハウスに継続的にパイプライン化する簡単な方法を提供し、分析、レポート、AI、および機械学習で簡単に利用できるようにします。

BigCommerce コネクタはCData Sync アプリケーションから使用可能で、BigCommerce からデータを取得して、サポートされている任意の同期先に移動できます。

BigCommerce バージョンサポート

The Sync App leverages the BigCommerce API to enable bidirectional access to BigCommerce.

BigCommerce Connector for CData Sync

接続の確立

BigCommerce への接続を追加

BigCommerce への接続を追加するには:

  1. アプリケーションコンソールで、接続ページに移動します。
  2. 接続の追加パネルで、追加したい接続のアイコンを選択します。
  3. BigCommerce アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからBigCommerce コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

BigCommerce への接続

BigCommerce 認証は標準のOAuth フローに基づいています。

Store ID の取得

BigCommerce Store に接続するには、StoreId が必要です。Store Id を確認するには、以下の手順に従ってください。

  1. BigCommerce アカウントにログインします。
  2. ホームページでAdvanced Settings -> API Accounts を選択します。
  3. Create API Account -> Create V2/V3 API Token をクリックします。
  4. 画面にAPI Path という名前のテキストボックスが表示されます。
  5. テキストボックス内に、次の構造のURL が表示されます:https://api.bigcommerce.com/stores/{Store Id}/v3。
  6. 上記で示したように、Store Id は'stores/' と'/v3' パスパラメータの間に位置します。
  7. Store Id を確認したら、キャンセル をクリックするか、まだAPI Account を持っていない場合は作成に進むことができます。

個人用アクセストークンの取得

加えて、自分のデータをテストおよびアクセスするには、個人用トークンを取得する必要があります。個人用トークンを取得する方法は次のとおりです。

  1. BigCommerce アカウントにログインします。
  2. ホームページでAdvanced Settings -> API Accounts を選択します。
  3. Create API Account -> Create V2/V3 API Token をクリックします。
  4. アカウント名を入力します。
  5. 作成するAPI Account のOAuth Scopes を選択します。Sync App は"None" とマークされたデータにアクセスできません。また、"read-only" とマークされたデータを変更できません。
  6. 保存をクリックします。

BigCommerce への認証

BigCommerce を認証する方法は2つあります。
  • BigCommerce ユーザーインターフェース(UI)で生成されたOAuthAccess トークンの使用
  • カスタムBigCommerce アプリケーションで作成されたOAuth 資格情報の使用

Big Commerce UI

「BigCommerce からのOAuthAccess トークンの生成」では、BigCommerce に接続するための資格情報を取得する方法について説明します。アクセストークンは、特定のアカウント情報の共有を許可します。このフローでは、BigCommerce のUI で直接アプリケーションへのアクセス許可を明示的に作成および承認するため、実行時にWeb ブラウザは必要ありません。これは最も簡単な接続方法であり、個人または会社のデータにアクセスするだけのユーザーに推奨されます。

アクセストークンの生成

BigCommerce アカウントのUI から直接OAuthAccessToken を取得する場合は:

  1. BigCommerce アカウントにログインします。
  2. ホームページでAdvanced Settings -> API Accounts を選択します。
  3. Create API Account -> Create V2/V3 API Token を選択します。
  4. アカウント名を入力します。
  5. 作成するAPI Account のOAuth Scopes を選択します。ドライバーは"None" とマークされたデータにアクセスできません。また、"read-only" とマークされたデータを変更できません。
  6. 保存をクリックします。

新しく作成したアプリのアクセストークン、およびStore Id が画面に表示されます。 これらの資格情報にアクセスできるのはこの時だけなので、必ずコピーしてください。 これらの資格情報を使用し、以下の接続プロパティを設定してBigCommerce に接続できます。

  • AuthScheme:個人用アクセストークン
  • StoreId:StoreId に設定。BigCommerce のStore Id の確認方法について、詳しくは接続の確立 を参照してください。
  • OAuthAccessToken:アクセストークン

BigCommerce のStore Id の確認方法について、詳しくは「接続の確立」を参照してください。

BigCommerce カスタムアプリの作成

BigCommerce アプリの作成 では、BigCommerce に接続するためのカスタムアプリを作成する方法について説明します。ここで詳しく説明する配布用のアプリケーションを作成する方法は、以下の各セクションで必要となります。

  • デスクトップアプリケーション
  • Web アプリケーション
  • ヘッドレスマシン

これらのすべてのケースでAuthScheme をOAUTH に設定する必要があります。以下のセクションは、すでに設定済みであることを前提として書かれています。

アプリの作成は単一のOAuthAccess トークンを生成するより複雑ですが、複数のクライアントに接続またはアクセスを許可する設計のクライアント統合や、複数のユーザーによって個別に承認されるアプリを作成する管理シナリオでは、より望ましい場合があります。

デスクトップアプリ

下記の手順に従って、カスタムOAuth アプリの資格情報を使用して認証します。詳しくは前述の「アクセストークンの生成」を参照してください。

OAuth アクセストークンの取得

次のプロパティを設定して、接続してください。

  • OAuthClientId:アプリ設定のクライアントId に設定。
  • OAuthClientSecret:アプリ設定のクライアントシークレットに設定。
  • CallbackURL:アプリ設定のリダイレクトURL に設定。
  • StoreId:StoreId に設定。BigCommerce のStore Id の確認方法について、詳しくは接続の確立 を参照してください。
接続すると、Sync App はデフォルトブラウザでOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

ヘッドレスマシン

ヘッドレスマシンのユーザーアカウントでOAuth を使用するようにドライバーを設定するには、インターネットブラウザに対応した別の端末で認証する必要があります。

  1. 以下の2つのオプションから選択します。

    • オプション1:後述の「Verifier code を取得および交換」に従い、OAuthVerifier 値を取得します。
    • オプション2:別のマシンにSync App をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送します。

  2. その後、ヘッドレスマシンからアクセストークンを自動的にリフレッシュするようにSync App を設定します。

オプション1:Verifier code を取得および交換

Verifier code を取得するには、OAuth Authorization URL で認証する必要があります。

インターネットブラウザに対応したマシンから認証してOAuthVerifier 接続プロパティを取得する方法は次のとおりです。

  1. 以下のオプションから選択します。

    • 埋め込みOAuth アプリケーションを使用する場合は、BigCommerce OAuth endpoint をクリックし、ブラウザでエンドポイントを開きます。
    • カスタムOAuth アプリケーションを使用するには、以下のプロパティを設定し、認証URL を作成します。
      • InitiateOAuth:OFF に設定。
      • OAuthClientId:アプリケーションの登録時に割り当てられたクライアントId に設定。
      • OAuthClientSecret:アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
      次に、適切なCallbackURL を指定してGetOAuthAuthorizationURL ストアドプロシージャを呼び出します。ストアドプロシージャによって返されたURL をブラウザで開きます。

  2. ログインして、Sync App にアクセス許可を与えます。すると、verifier code を含むコールバックURL にリダイレクトされます。
  3. verifier code の値を保存します。後ほどこれをOAuthVerifier 接続プロパティに設定します。
次に、OAuth verifier code をOAuth リフレッシュトークンおよびアクセストークンと交換する必要があります。次のプロパティを設定します。

ヘッドレスマシンでは、次の接続プロパティを設定してOAuth 認証値を取得します。

  • InitiateOAuth:REFRESH に設定。
  • OAuthVerifier:verifier code に設定。
  • OAuthClientId:(カスタムアプリのみ)カスタムOAuth アプリケーション設定のクライアントId に設定。
  • OAuthClientSecret:(カスタムアプリのみ)カスタムOAuth アプリケーション設定のクライアントシークレットに設定。
  • OAuthSettingsLocation:ドライバーがOAuth トークン値を保存するファイルの場所に設定。これは接続間で維持されます。

OAuth 設定ファイルが生成されたら、以下のように接続プロパティをリセットする必要があります。

  • InitiateOAuth:REFRESH に設定。
  • OAuthClientId:(カスタムアプリのみ)アプリケーションの登録時に割り当てられたクライアントId に設定。
  • OAuthClientSecret:(カスタムアプリのみ)アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
  • OAuthSettingsLocation:暗号化されたOAuth 認証値が保存される場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がSync App に読み書きのアクセス許可を与えることを確認してください。

オプション2:OAuth 設定を転送

ヘッドレスマシンでの接続に先立ち、インターネットブラウザに対応したデバイスでドライバーとの接続を作成し、インストールする必要があります。上述の「デスクトップアプリケーション」の説明に従って、接続プロパティを設定します。

「デスクトップアプリケーション」の手順が完了すると、生成された認証値は、OAuthSettingsLocation で指定された場所に暗号化されて書き込まれます。デフォルトのファイル名はOAuthSettings.txt です。

接続が正常にテストされたら、OAuth 設定ファイルをヘッドレスマシンにコピーします。

ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。

  • InitiateOAuth:REFRESH に設定。
  • OAuthClientId:(カスタムアプリのみ)アプリケーションの登録時に割り当てられたクライアントId に設定。
  • OAuthClientSecret:(カスタムアプリのみ)アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
  • OAuthSettingsLocation:OAuth 設定ファイルの場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がSync App に読み書きのアクセス許可を与えることを確認してください。

BigCommerce Connector for CData Sync

高度な機能

このセクションでは、BigCommerce Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。 このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。 カスタムビューの作成と設定の概要については、ユーザー定義ビュー を参照してください。

SSL の設定

SSL の設定 を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシ に合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、BigCommerce にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくは、クエリ処理 を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログ を参照してください。基本的なロギングに必要なのは2つの接続プロパティだけですが、より詳細なロギングをサポートする多くの機能があり、LogModules 接続プロパティを使用してロギングする情報のサブセットを指定することができます。

BigCommerce Connector for CData Sync

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

BigCommerce Connector for CData Sync

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

  • ProxyServer:HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
  • ProxyPort:プロキシサーバーが起動しているTCP ポート。
  • ProxyAuthScheme:プロキシサーバーに対して認証する際にSync App が使用する認証方法。
  • ProxyUser:プロキシサーバーに登録されているユーザーアカウントのユーザー名。
  • ProxyPassword:ProxyUser に紐付けられたパスワード。

その他のプロキシ

次のプロパティを設定します。

  • プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
  • 接続をトンネルするには、FirewallType をTUNNEL に設定します。
  • 認証するには、FirewallUser とFirewallPassword を設定します。
  • SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

BigCommerce Connector for CData Sync

データモデル

概要

このセクションでは、利用可能なAPI オブジェクトを示し、BigCommerce API へのSQL の実行について詳しく説明します。

主要機能

  • Sync App はBigCommerce のカテゴリ、顧客、および注文をリレーショナルテーブルやビューとしてモデル化し、SQL を記述してBigCommerce データをクエリできるようにします。
  • ストアドプロシージャを使用すると、オブジェクトのダウンロードやアップロードなど、BigCommerce の操作を実行できます。
  • これらのオブジェクトへのライブ接続により、Sync App を使用するとBigCommerce アカウントへのあらゆる変更が即座に反映されます。

ビュー

BigCommerce からのデータへの読み取りまたは書き込みアクセスには、事前定義されたテーブル およびビュー を使用できます。

ストアドプロシージャ

Sync App を使用すると、BigCommerce オブジェクトをリストし、ストアドプロシージャ を介してデータをダウンロード/アップロードできます。

システムテーブル

システムテーブル には、データベースに属するオブジェクトとリソースに関する情報が含まれています。

BigCommerce Connector for CData Sync

テーブル

Sync App はBigCommerce のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

BigCommerce Connector for CData Sync テーブル

Name Description
Brands Gets the collection of brands.
Categories Returns Product Categories.
ChannelListings Returns a list of all Channel Listings for a specific channel
Channels GET,CREATE,UPDATE Channels
Coupons Create,list,update or delete coupons.
Currencies Returns data from Currencies table.
CustomerAddresses Returns a list of Customer Addresses. Returns the addresses belonging to a customer.
Customers Returns data from Customers table.
OrderItems Returns Items ordered for every order.
Orders Returns data from Orders table.
OrderShipments Returns shipments and their corresponding orders.
PriceListRecords Returns a collection of price List records
PriceLists Returns a collection of price records
ProductImages Returns images registered for products.
ProductMetafields Returns a list of Product Metafields.
ProductOptions Returns data from Products table.
ProductOptionValues Returns data from Products table.
ProductReviews Returns reviews registered for products.
Products Returns data from products table.
ProductVariants Returns data from Products table.
ShippingMethods Lists all shipping methods.
ShippingZones Lists all shipping zones.

BigCommerce Connector for CData Sync

Brands

Gets the collection of brands.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, >, <, >=, <=' comparison.
  • Name supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Brands WHERE Id = 1 

SELECT * FROM Brands WHERE Id >= 1 AND Id <= 5

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The id of the brand.

Name String False

The name of the brand. Must be unique.

PageTitle String False

The title shown in the browser while viewing the brand.

MetaKeywords String False

Comma-separated list of meta keywords to include in the HTML.

MetaDescription String False

A meta description to include.

ImageFile String False

A valid image.

SearchKeywords String False

A comma-separated list of keywords that can be used to locate this brand.

BigCommerce Connector for CData Sync

Categories

Returns Product Categories.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=,<=,>=,<,>,IN, and NOT_IN' comparisons.
  • ParentId supports the '=,<=,>=,<,>,IN, and NOT_IN' comparisons.
  • Name supports the '= and LIKE' comparison.
  • PageTitle supports the '= and LIKE' comparison.
  • IsVisible supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Categories WHERE Id = 18 

SELECT * FROM Categories WHERE Id >= 18 AND Id <= 25

SELECT * FROM Categories WHERE Name = "test"

Insert

To insert a new Categories, you need to specify at least the following columns: ParentId,Name, and Description.

INSERT INTO Categories (ParentId,Name,Description) VALUES (27,'Car Interior121', 'Accessories for testing car.')

Update


UPDATE Categories SET Description='Testing123' where id=18

Delete


DELETE FROM Categories WHERE Id = 18

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The Id of this product category.

ParentId Integer False

Categories.Id

The Id of the category.

Name String False

Name of the this category.

Description String False

System name of the type of order status.

Views Integer False

Number of views the category has on the storefront.

SortOrder Integer False

Priority this category will be given when included in the menu and category pages.

PageTitle String False

Custom title for the category page.

MetaKeywords String False

Custom meta keywords for the category page.

MetaDescription String False

Custom meta description for the category page.

LayoutFile String False

A valid layout file.

ImageUrl String False

Image URL used for this category on the storefront.

IsVisible Boolean False

Flag to determine whether the product should be displayed to customers browsing the store.

SearchKeywords String False

A comma-separated list of keywords that can be used to locate the category when searching the store.

DefaultProductSort String False

Determines how the products are sorted on category page load.

UrlPath String False

URL Path.

IsCustomized Boolean False

Flag to determine whether the url is customized.

BigCommerce Connector for CData Sync

ChannelListings

Returns a list of all Channel Listings for a specific channel

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Listingid supports the '='.
  • ChannelId supports the '='.
  • Datecreated supports the '='.
  • Datemodified supports the '='.

ChannelId or (ChannelId and ListingId) are required for SELECT.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ChannelListings WHERE ChannelId = 667159 AND ListingId = 882998595

Insert

To insert a new ChannelListings, you need to specify at least the following columns: Productid, State, Variants, ChannelId and Name.

INSERT INTO ChannelListings (Productid, State, Variants, ChannelId) VALUES (12345, 'active', 'test', 667159)

Update


UPDATE ChannelListings SET name = 'Test' WHERE ChannelId = 667159

Columns

Name Type ReadOnly References Description
Listingid [KEY] Long True

The ID of the channel listing that has been created, returned, or updated

ChannelId [KEY] Integer True

Channels.Id

The ID of the channel associated with this channel listing

Datecreated Datetime True

Date on which the channel listing was first created

Datemodified Datetime True

Date on which the channel listing was most recently changed

Name String False

Name of the product for this channel listing specifically This is an optional field that can be used to override the product name in the catalog

Description String True

Description of the product for this channel listing specifically This is an optional field that can be used to override the product description in the catalog

Productid Integer False

The ID of the product associated with this channel listing

State String False

The state of the product assignment or channel listing

Variants String False

Product variant associated with the channel listing.

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
ExternalId Integer

BigCommerce Connector for CData Sync

Channels

GET,CREATE,UPDATE Channels

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with Id, which supports the '=' operator.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Channels

Insert

To insert a new Channel, you need to specify at least the following columns: Name, Type, Platform, and Status.

INSERT INTO Channels (Type, Platform, Status, Name) VALUES ('pos', 'square', 'active', 'tests');

Update


UPDATE Channels SET Name = 'tests' WHERE ID = 123

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The ID of the channel.

ConfigMetaAppId Integer False

The unique id given to an app registered in DevTools

sections String False

If set, when the app is loaded within the control panel, the navigation sections will be directly embedded in the control panel navigation

Datecreated Datetime True

Date on which the channel was first create

Datemodified Datetime True

Date on which the channel was most recently changed

Externalid String False

Associated ID within a system / platform outside of BC

Iconurl String False

Link to the platform icon

Isenabled Boolean False

Channel with status of prelaunch, active, or connected will have is_enabled set to true. Channel with status of inactive, disconnected, archived, deleted, or terminated will have is_enabled set to false

IslistableFromUi Boolean False

Indicates if a channel can create listings from the BigCommerce UI. Default value for this field is based on the channel type and platform combination if not specified on create

Isvisible Boolean False

Indicates if a channel is visible within the BigCommerce merchant admin UI (control panel). If false, the channel will not show in Channel Manager nor in any channels dropdown throughout the UI. Default value for this field is true if not specified on create

Name String False

Name of the channel as it will appear to merchants in the control panel

Platform String False

The name of the platform for the channel channel platform and type must be a valid combination

Status String False

The status of the channel channel type, platform, and status must be a valid combination. terminated is not valid for Update or Insert requests

Type String False

The type of channel channel platform and type must be a valid combinations

BigCommerce Connector for CData Sync

Coupons

Create,list,update or delete coupons.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, >, <, >=, and <=' comparisons.
  • Name supports the '=' comparison.
  • Type supports the '= and !=' comparison.
  • Code supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Coupons WHERE Id = 1 

SELECT * FROM Coupons WHERE Id >= 1 AND Id <= 5

SELECT * FROM Coupons WHERE Name = "test"

Insert

To insert a new Coupon, you need to specify at least the following columns: Name, Type, Code, Amount, AppliesToEntity and AppliesToIds.

INSERT INTO Coupons (Name, Type, Code, Amount, AppliesToEntity, AppliesToIds) VALUES ('CouponName', 'free_shipping', 'CN100', 500, 'products', '88, 80')

Update


UPDATE Coupons SET Code = 'ABC' WHERE Id = 12

Delete


DELETE FROM Coupons WHERE Id = 16

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The coupons ID.

Name String False

The name of the coupon.

Type String False

Type of the coupon. Must be one of per_item_discount,per_total_discount,shipping_discount,free_shipping or percentage_discount.

使用できる値は次のとおりです。per_item_discount, percentage_discount, per_total_discount, shipping_discount, free_shipping, promotion

Amount Decimal False

The discount to apply to an order, as either an amount or a percentage.

MinPurchase Decimal False

Specifies a minimum value that an order must have before the coupon can be applied to it.

Expires Datetime False

Specifies when a coupon expires.

Enabled Boolean False

If the coupon is enabled, this fields value is true; otherwise, false.

Code String False

The coupon code that customers uses to receive their discounts.

AppliesToEntity String False

What the discount applies to. Can be products or categories.

AppliesToIds String False

IDs of either the products or categories

NumUses Integer True

Number of times this coupon has been used.

MaxUses Integer False

Maximum number of times this coupon can be used.

MaxUsesPerCustomer Integer False

Maximum number of times each customer can use this coupon.

DateCreated Datetime False

Date Created

ShippingMethods String False

List of shipping-method names.

RestrictedToCountries String False

Countries where the coupon is restricted.

BigCommerce Connector for CData Sync

Currencies

Returns data from Currencies table.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM currencies where Id=1

Insert

To insert a new Currencies, you need to specify at least the following columns: Code,Name,ExchangeRate,Token,TokenLocation,DecimalToken,ThousandsToken, and DecimalPlaces.

INSERT INTO Currencies (Code,Name,ExchangeRate,Token,TokenLocation,DecimalToken,ThousandsToken,DecimalPlaces) VALUES ('EUR','Euro', '3.0','$','left','.',',','2')

Update


UPDATE Currencies SET Name='Testing123' where id=2

Delete


DELETE FROM Currencies WHERE Id = 3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Id of the currency.

IsDefault Boolean True

Specifies whether this is the store's default currency.

Code String False

Three-letter ISO 4217 code for this currency.

Name String False

Name of this currency.

ExchangeRate Double False

Amount of this currency that is equivalent to one U.S. dollar.

CountryIso String False

Two-letter ISO Alpha-2 code.

AutoUpdate Boolean False

Whether to autoupdate currency data.

TokenLocation String False

Symbol for this currency.

Token String False

Name of the currency.

DecimalToken String False

Symbol used as the decimal separator in this currency.

ThousandsToken String False

Symbol used as the thousands separator in this currency.

DecimalPlaces Integer False

Number of decimal places to show for this currency.

Enabled Boolean False

Indicates If the currency is active on the store.

IsTransactional Boolean False

Indicates if the currency is set as transactional or not. False means display only currency.

LastUpdated Date True

Date the currency was last updated, created or modified.

BigCommerce Connector for CData Sync

CustomerAddresses

Returns a list of Customer Addresses. Returns the addresses belonging to a customer.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' and 'IN' comparison.
  • CustomerId supports the '=' and 'IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM CustomerAddresses WHERE Id = 1 

SELECT * FROM CustomerAddresses WHERE CustomerId = 5

Insert

To insert a new CustomerAddresses, you need to specify at least the following columns: FirstName,LastName,Phone,City,PostalCode,Country,Address1,AddressType,and StateOrProvince.
INSERT INTO CustomerAddresses (FirstName,LastName,Phone,City,PostalCode,Country,Address1,AddressType,StateOrProvince) VALUES ('test','test', '3000','test','12345','test','test','residential','Washington')

Update


UPDATE CustomerAddresses SET FirstName='Testing123' where id=14

Delete


DELETE FROM CustomerAddresses WHERE Id = 3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer False

ID of this customer address.

CustomerId Integer False

ID of the associated customer.

FirstName String False

The customers first name.

LastName String False

The customers last name.

Company String False

The customers company name.

Address1 String False

The customers street address, line 1.

Address2 String False

The customers street address, line 2.

City String False

The customers city/town/suburb.

StateOrProvince String False

The customers state/province.

PostalCode String False

The customers ZIP or postal code.

Country String False

The customers country. Must be the full country name.

CountryCode String False

2-letter ISO Alpha-2 code for the customers country.

Phone String False

The customers phone number.

AddressType String False

The type of the address.

BigCommerce Connector for CData Sync

Customers

Returns data from Customers table.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, and IN' comparisons.
  • Company supports the '=, and IN' comparison.
  • Email supports the '=, and IN' comparison.
  • DateCreated supports the '=,<,>,<=,>=' comparison.
  • DateModified supports the '=,<,>,<=,>=' comparison.
  • CustomerGroup supports the '=, and IN' comparison.
  • StoreCreditAmounts supports the '=' comparison.
  • RegistrationIpAddress supports the '=, and IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Customers WHERE Id = 1 

SELECT * FROM Customers where Company = 'DemoFirst'

SELECT * FROM Customers where Email = '[email protected]'

SELECT * FROM Customers where DateCreated > '2021-09-01 11:25:37.0' 

SELECT * FROM Customers where DateModified <= '2023-10-12 02:05:43.0'

Insert

To insert a new Coupon, you need to specify at least the following columns: FirstName,LastName,Email.

INSERT INTO Customers (FirstName,LastName,Email) VALUES ('Testing4321', 'Test','[email protected]')

Update


UPDATE Customers SET FirstName='testing345' where Id=5075

Delete


DELETE FROM Customers WHERE Id = 16

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Unique numeric ID of this customer.

Company String False

The name of the company for which the customer works.

FirstName String False

First name of the customer.

LastName String False

Last name of the customer.

Email String False

Email address of the customer.

Phone String False

Phone number of the customer.

DateCreated Datetime True

Date on which the customer registered from the storefront or was created in the control panel.

DateModified Datetime True

The date on which the customer was modified.

CustomerGroup Integer False

The group to which the customer belongs.

Notes String False

Store Owner notes on the customer.

TaxExemptCategory String False

Used to identify customers who fall into special sales-tax categories.

StoreCreditAmounts String False

Amount of Store Credit

RegistrationIpAddress String False

The IP address from which this customer was registered.

AcceptsProductReviewAbandonedCartEmails Boolean False

Whether the customer is signed up to receive product review emails, abandoned cart emails, or both. True if the customer is signed up for any of these.

ForcePasswordReset Boolean True

If true, this customer will be forced to change their password on their next login.

ChannelIds String False

Array of channel ids the Customer has access to.

BigCommerce Connector for CData Sync

OrderItems

Returns Items ordered for every order.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • OrderId supports the '=, and IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderItems WHERE Id = 1 

SELECT * FROM OrderItems where OrderId=100

Inserting an Existing Product

To insert an existing product to the OrderItems for a specified Order, order options for that table must be specified. For this reason, before inserting an existing product to the OrderItems, you need to populate a temporary OrderItemOptionValues table with the desired options for the selected product and use this table as a value for the LinkedOrderOptions Pseudo-Column during insertion:

INSERT INTO OrderItemOptionValues#TEMP (Id, Value) Values (117, 177);
INSERT INTO OrderItemOptionValues#TEMP (Id, Value) Values (116, 176);
INSERT INTO OrderItems (OrderId, ProductId, QuantityOrdered, LinkedOrderOptions) VALUES (1104, 960, 3, OrderItemOptionValues#TEMP)");

Note: The OrderItemOptionValue inserted to the temporary table must belong to the product that is being inserted into OrderItems. To verify this, check the ProductOptionValues table.

Inserting a New Product

New, custom products, can be added to the OrderItems table as follows:

INSERT INTO OrderItems (OrderId, Name, CustomSKU, PriceIncTax, PriceExTax, QuantityOrdered) VALUES (1107, 'TSS Phone Case', 'PHC-232453', 6.55, 5.75, 1);

Note: OrderItems does not allow for UPDATEs or Deletes. Once items have been added to an order, they cannot be removed or modified.

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Numeric ID of this product within this order.

ProductId Integer False

Products.Id

Numeric ID of the product.

CustomSKU String False

User defined product code/stock keeping unit (SKU).

OrderId Integer False

Orders.Id

Numeric ID of the associated order.

Name String False

The product name.

PriceExTax Decimal False

The price of the product, excluding tax.

PriceIncTax Decimal False

The price of the product, including tax.

QuantityOrdered Integer False

Quantity of the product ordered.

QuantityShipped Integer True

Quantity of the product shipped.

TotalExtax Decimal True

Total base price, excluding tax.

TotalIncTax Decimal True

Total base price, including tax.

IsRefunded Boolean True

Whether the product has been refunded.

ExternalId Integer False

ID of the order in another system.

AppliedDiscounts String True

Array of objects containing discounts applied to the product.

BaseCostPrice Decimal False

The product's cost price.

BasePrice Decimal False

The product�s base price.

BaseTotal Decimal False

Total base price.

BaseWrappingCost Decimal False

The value of the base wrapping cost.

BinPickingNumber Integer False

Bin picking number for the physical product.

Brand String False

The product's brand.

ConfigurableFields String False

The price of the product, excluding tax.

CostPriceExTax Decimal False

The product's cost price excluding tax.

CostPriceIncTax Decimal False

The product's cost price including tax.

CostPriceTax Decimal False

Tax applied to the product�s cost price.

Depth Decimal False

Depth of the product.

DiscountedTotalIncTax Decimal False

Represent the correct total amount of the line item after deducting all the discounts and including the tax.

EbayItemId String False

Item ID for this product on eBay.

EbayTransactionId String False

Transaction ID for this product on eBay.

EventDate String False

Date of the promotional event/scheduled delivery.

EventName String False

Name of promotional event/delivery date.

FixedShippingCost Decimal False

Fixed shipping cost for this product.

FulfillmentSource String False

The source of the fulfillment.

GiftCertificateId String False

ID of the associated gift certificate.

Height Decimal False

Height of the product

IsBundledProduct Boolean False

Whether this product is bundled with other products.

NameCustomer String False

The product name that is shown to customer in storefront.

NameMerchant String False

The product name that is shown to merchant in Control Panel.

OptionSetId Integer False

Numeric ID of the option set applied to the product.

OrderAddressId Integer False

Numeric ID of the associated order address. Value is 0 for items that are not fulfilled by a pickup method.

OrderPickupMethodId Integer False

ID of the pickup fulfillment method for this item. Default value is 0 when the item is not fulfilled by pickup method.

ParentOrderProductId Integer False

ID of a parent product.

PriceTax Decimal False

Amount of tax applied to a single product.

RefundAmount Decimal False

The amount to be refunded.

ReturnId Integer False

Numeric ID for the refund.

TotalTax Decimal False

Total tax applied to products.

Type String False

Type of product.

使用できる値は次のとおりです。physical, digital

Upc String False

Universal Product Code. Can be written to for custom products and catalog products.

VariantId Integer False

Products variant_id.

Weight Decimal False

Weight of the product.

Width Decimal False

Width of the product.

WrappingCostExTax Decimal False

The value of the wrapping cost, excluding tax.

WrappingCostIncTax Decimal False

The value of the wrapping cost, including tax.

WrappingCostTax Decimal False

Tax applied to gift-wrapping option.

WrappingId Integer False

The price of the product, excluding tax.

WrappingMessage String False

Message to accompany gift-wrapping option.

WrappingName String False

Name of gift-wrapping option.

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
LinkedOrderOptions String

Column for the aggregate table name holding option values.

BigCommerce Connector for CData Sync

Orders

Returns data from Orders table.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=,<,>,<=,>=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Orders WHERE Id = 1 

SELECT * FROM Orders where Id > 104

SELECT * FROM Orders where Id < 104

SELECT * FROM Orders where Id >= 104

SELECT * FROM Orders where Id <= 104

Insert

To insert a new Order, at least one order item is required to be attached to the INSERT query for this order. To do so, you can first populate a temporary OrderItems table with the desired items for the order you are about to create, and later using this table as a value for the LinkedProducts Pseudo-Columns during insertion:

INSERT INTO OrderItems#TEMP (ProductId, QuantityOrdered) VALUES (961, 4);
INSERT INTO OrderItems#TEMP (ProductId, QuantityOrdered) VALUES (962, 3);
INSERT INTO Orders (CustomerId, LinkedProducts, StatusId, ItemsTotal, ItemsShipped, PaymentMethod, OrderIsDigital, BillingFirstName, BillingLastName, BillingCompany, BillingCountry, BillingZip, BillingState, BillingEmail, BillingPhone) VALUES (1, OrderItems#TEMP, 4, 6, 2, 'cash', 'true', 'TSS', 'Dev', 'London Corp.', 'United Kingdom', 23433, 'London', '[email protected]', '+355534445');

Update


UPDATE Orders SET StaffNotes='Testing123' where id=103

Delete


DELETE FROM Orders WHERE Id = 3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The Id of the order.

CustomerId String False

Customers.Id

The Id of the customer assigned to this order.

DateCreated Datetime True

The date of creation for the order.

DateModified Datetime True

The last modification date of the order.

DateShipped Datetime True

The date of shipment for the order.

StatusId String False

OrderStatuses.Id

The Id of the status for this order.

CartId String True

The Id of the cart from which this order is assigned.

Status String True

Order Statuses.

TotalTax String True

The total value of the order.

SubtotalTax String True

The value for subtotal tax.

SubtotalExTax Decimal False

The value for subtotal, excluding tax.

SubtotalIncTax Decimal False

The value for subtotal, including tax.

ShippingCostExTax Decimal False

The value of shipping cost, excluding tax.

ShippingCostIncTax Decimal False

The value of shipping cost, including tax.

HandlingCostExTax Decimal False

The value of handling cost, excluding tax.

HandlingCostIncTax Decimal False

The value of handling cost, including tax.

IpAddress String False

IPv4 Address of the customer, if known.

WrappingCostExTax Decimal False

The value of wrapping cost, excluding tax.

WrappingCostIncTax Decimal False

The value of wrapping cost, including tax.

TotalExTax Decimal False

The total value of the order, excluding tax.

TotalIncTax Decimal False

The total value of the order, including tax.

HandlingCostTax String True

The value of handling cost.

HandlingCostTaxClassId Integer True

The Id of handling cost.

ShippingCostTax String True

The value of shipping cost.

ItemsTotal Integer False

The total number of items in the order.

ItemsShipped Integer False

The total number of items that have been shipped.

PaymentMethod String False

The payment method for this order.

PaymentProviderId String False

The external Transaction ID/Payment ID within this order's payment provider (if a payment provider was used).

PaymentStatus String True

The payment status for this order.

RefundedAmount Decimal False

The amount refunded from this transaction.

GiftCertificateAmount String True

Gift Certificate Amount.

CurrencyId String True

Currencies. Id

The ID of the currency being used in this transaction.

CurrencyCode String True

The currency code of the display currency.

CurrencyExchangeRate String True

The exchange rate between the default currency and display currency of store.

DefaultCurrencyId String True

Currencies.Id

The ID of the default currency for the store.

DefaultCurrencyCode String False

The currency code of the transactional currency the shopper pays in.

StaffNotes String False

Any additional notes for staff.

CustomerMessage String False

Message that the customer entered.

DiscountAmt Decimal False

Amount of discount for this transaction.

EbayOrderId String False

Ebay order number if order is placed through Ebay.

GeoIpCountryIso2 String False

The country where the customer made the purchase, in ISO2 format.

ShippingAddressCount Integer True

The number of shipping addresses associated with this transaction.

CouponDiscount String True

Discount of the coupon.

OrderSource String True

Source of the order.

IsDeleted Boolean True

Indicates whether the order was deleted (archived).

OrderIsDigital Boolean False

Indicates whether this is an order for digital products.

ExternalSource String False

A value identifying the system used to generate the order (for orders submitted or modified via the API).

ExternalId String False

ID of the order in another system.

ExternalMerchantId String False

Id of the external merchant.

ChannelId String False

Shows where the order originated.

TaxProviderId String False

BasicTaxProvider - Tax is set to manual; AvaTaxProvider - This is for when the tax provider has been set to automatic and the order was NOT created by the API; (blank) - When the tax provider is unknown.

ProductsUrl String False

Url of the products.

ProductsResource String False

Resource of the products.

BillingFirstName String False

Addressee first name.

BillingLastName String False

Addressee last name.

BillingCompany String False

Addressee company.

BillingStreet1 String False

Street address (first line).

BillingStreet2 String False

Street address (second line).

BillingCity String False

Addressee city

BillingZip String False

ZIP or postal code

BillingCountry String False

Addressee's country

BillingCountryIso2 String False

Addressee's country code

BillingState String False

The name of the state or province. Should be spelled out in full, for example, California.

BillingEmail String False

Recipient's email address.

BillingPhone String False

Recipient's telephone number.

BaseHandlingCost String False

The value of the base handling cost.

BaseShippingCost String False

The value of the base shipping cost.

BaseWrappingCost String False

The value of the base wrapping cost.

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
LinkedProducts String

Column for the aggregate table name holding order products.

BigCommerce Connector for CData Sync

OrderShipments

Returns shipments and their corresponding orders.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • OrderId supports the '=, and IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderShipments WHERE Id = 1 

SELECT * FROM OrderShipments where OrderId=1428

Insert

To insert a new Order Shipment, at least one Shipment Item is required to be attached to the INSERT query. For this reason, you can first populate a temporary ShipmentItems table with the desired items for the shipment you are about to create, and later using this table as a value for the LinkedProducts Pseudo-Columns during insertion:

INSERT INTO ShipmentItems#TEMP (Id, Quantity) VALUES (2519, 1);
INSERT INTO OrderShipments (OrderId, OrderAddressId, LinkedProducts) VALUES (1106, 1007, ShipmentItems#TEMP);

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Numeric ID of this shipment within this order.

OrderId Integer False

Orders.Id

Numeric ID of the associated order.

DateCreated Datetime True

Creation date for the shipment.

TrackingNumber String False

Tracking number of the shipment.

TrackingCarrier String False

Tracking carrier for the shipment.

TrackingLink String True

Returns a tracking link from the shipping service.

ShippingProvider String False

Enum of the BigCommerce shipping-carrier integration/module.

ShippingMethod String False

Enum of the BigCommerce shipping-carrier integration/module.

Comments String False

Comments the shipper wishes to add.

OrderAddressId Integer False

OrderShippingAddresses.Id

ID of this shipping address.

CustomerId String False

ID of this order�s customer.

ShippingProviderDisplayName String True

The human-readable name for the shipping_provider.

MerchantShippingCost Decimal True

The shipping merchant cost.

BillingAddressCity String True

The billing address city.

BillingAddressCompany String True

The billing address company.

BillingAddressCountry String True

The billing address country

BillingAddressCountryIso2 String True

The billing address country iso2.

BillingAddressEmail String True

The email of the Addressee.

BillingAddressFirstName String True

Addressee's First Name.

BillingAddressLastName String True

Addressee's Last Name.

BillingAddressPhone String True

Addressee's Phone.

BillingAddressState String True

Addressee's State.

BillingAddressStreet1 String True

Street address (first line).

BillingAddressStreet2 String True

Street address (second line).

BillingAddressZip String True

ZIP or postal code.

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
LinkedProducts String

Column for the aggregate table name holding order products.

BigCommerce Connector for CData Sync

PriceListRecords

Returns a collection of price List records

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • CalculatedPrice supports the '=' comparison.
  • ProductId supports the '=' comparison.
  • PriceListId supports the '=' comparison.
  • VariantId supports the '=' comparison.
  • Sku supports the '=' comparison.
  • Currency supports the '=' comparison.
  • Price supports the '=' comparison.
  • SalePrice supports the '=' comparison.
  • RetailPrice supports the '=' comparison.
  • MapPrice supports the '=' comparison.

PriceListId or (PriceListId and VariantId and Currency) are required for select.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM PriceListRecords WHERE PriceListId IN (SELECT Id FROM PriceLists)

SELECT * FROM PriceListRecords WHERE PriceListId = 1 

SELECT * FROM PriceListRecords WHERE PriceListId = 1 AND SalePrice = 23

SELECT * FROM PriceListRecords WHERE PriceListId = 1 AND MapPrice = 17.99

SELECT * FROM PriceListRecords WHERE PriceListId = 1 AND VariantId = 361 AND Currency = 'USD'

Bulk Update

To Update a new PriceListRecord, you need to specify at least the following columns:VariantId, Currency, Price, PriceListId

INSERT INTO PriceListRecords#TEMP (VariantId, Currency, Price, SalePrice, PriceListId) VALUES (361, 'USD', 27, 23, 1)
INSERT INTO PriceListRecords#TEMP (VariantId, Currency, Price, SalePrice, PriceListId) VALUES (362, 'USD', 28, 24, 1)
UPDATE PriceListRecords (VariantId, Currency, Price, SalePrice) SELECT VariantId, Currency, Price, SalePrice FROM PriceListRecords#TEMP

Bulk Update Using Aggregates.

INSERT INTO PriceListRecords#TEMP (VariantId, Currency, Price, SalePrice, PriceListId, BulkPricingTiers) VALUES (361, 'USD', 27, 23, 1,
                   '{ 
                    \"quantity_min\": 10," 
                    \"quantity_max\" : 12," 
                     \"type\" : \"percent\","
                      \"amount\": 1
                    }'
UPDATE PriceListRecords ( VariantId, Currency, Price, SalePrice, BulkPricingTiers) SELECT VariantId, Currency, Price, SalePrice, BulkPricingTiers FROM PriceListRecords#TEMP

Columns

Name Type ReadOnly References Description
CalculatedPrice Double True

The price of the variant as seen on the storefront if a price record is in effect

DateCreated Datetime True

The date of creation for the Price Entry.

DateModified Datetime True

The last modification date of the Price Entry.

ProductId Integer True

The id of the Product this Price Record's variant_id is associated with.

PriceListId [KEY] Integer True

The Price List ID with which this price set is associated

VariantId [KEY] Integer False

The variant with which this price set is associated.

Sku String False

The variant with which this price set is associated

Currency [KEY] String False

The 3-letter currency code with which this price set is associated

Price Double False

The list price for the variant mapped in a Price List

SalePrice Double False

The sale price for the variant mapped in a Price List

RetailPrice Double False

The retail price for the variant mapped in a Price List

MapPrice Double False

The MAP (Manufacturers Advertised Price) for the variant mapped in a Price List

BulkPricingTiers Integer False

The minimum quantity of associated variant in the cart needed to qualify for this tiers pricing

QuantityMin Integer False

The minimum quantity of associated variant in the cart needed to qualify for this tiers pricing

QuantityMax Integer False

The maximum allowed quantity of associated variant in the cart to qualify for this tiers pricing.

QuantityType String False

The type of adjustment that is made.

QuantityAmount Double False

The maximum allowed quantity of associated variant in the cart to qualify for this tiers pricing.

BigCommerce Connector for CData Sync

PriceLists

Returns a collection of price records

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • DateCreated supports the '=' comparison.
  • DateModified supports the '=' comparison.
  • Name supports the '=,LIKE' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM PriceLists WHERE Id = 1 

SELECT * FROM PriceLists WHERE DateCreated = '2021-05-26'

SELECT * FROM PriceLists WHERE DateModified = '2021-05-26'

SELECT * FROM PriceLists WHERE Name LIKE 'Wholesale group1'

Insert

To insert a new PriceList, you need to specify the following columns: Name and Active

INSERT INTO PriceLists (Name, Active) VALUES ('Wholesalegroup', false)

Update

To Update the PriceList, you need to specify the following columns: Name and ID

UPDATE PriceLists SET Name = 'Wholesalegroup' WHERE Id = '4'

Delete

To Delete the PriceList, you need to specify the following columns:ID

DELETE From PriceLists WHERE Id = '4'

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

ID of the PriceList.

Active Boolean False

The status of the PriceList.

DateCreated Datetime True

The date of creation for the PriceList.

DateModified Datetime True

The last modification date of the PriceList.

Name String False

The name of the PriceList.

BigCommerce Connector for CData Sync

ProductImages

Returns images registered for products.

Table Specific Information

Select


SELECT * FROM ProductImages 

There are two alternatives to inserting new product images for BigCommerce, ImageFile and ImageUrl.

Insert using ImageFile

To insert a new Product Image using ImageFile, you only need the ProductId and the local path of your ImageFile written as a string using forward slashes as directory separators. BigCommerce does not allow for additional parameters when inserting an image using ImageFile. Trying to do so, will return an error.

INSERT INTO ProductImages (ProductId, ImageFile) VALUES (963, 'C:/dev/tests/v19/ProviderBigCommerce/DDHU.jpg');

Insert using ImageUrl

In addition to using ImageFiles, you can add Product Images by using ImageUrl-s of images on the Web. When inserting by ImageUrl-s, you can add additional fields to your query such as Description, SortOrder, and IsThumbnail..

INSERT INTO ProductImages (ProductId, ImageUrl) VALUES (955, 'http://oi50.tinypic.com/kexbfq.jpg');

Update


UPDATE ProductImages SET Description='Testing123' where Id=265

Delete


DELETE FROM ProductImages WHERE Id = 3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer False

The Id of the image.

ProductId [KEY] Integer False

Products.Id

The Id of the corresponding product.

ImageFile String False

The local path to the original image file uploaded to BigCommerce.

StandardUrl String False

Standard Image URL for the product.

ThumbnailUrl String False

The thumbnail URL for this image. By default, this is the image size used on the category page and in side panels.

IsThumbnail Boolean False

Flag for identifying whether the image is used as the product's thumbnail.

SortOrder Integer False

The order in which the image will be displayed on the product page.

Description String False

The description for the image.

DateModified Datetime True

The last modification date of the image.

TinyUrl String False

Tiny URL for the product.

ZoomUrl String False

Zoom URL for the product.

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
ImageUrl String

The local path to the original image file to be uploaded to BigCommerce.

BigCommerce Connector for CData Sync

ProductMetafields

Returns a list of Product Metafields.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with Id and ProductId, which supports the '=' operator.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ProductMetafields where ProductId=77
SELECT * FROM ProductMetafields where ProductId=77 and Id=2

Insert

To insert a new ProductMetafields, you need to specify at least the following columns: ProductId, Description, Namespace, Key, Value, and PermissionSet.

Insert Into ProductMetafields(ProductId,Description,Namespace,Key,Value,PermissionSet) Values(88,test,Warehouse,location,88,app_only)

Update


Update ProductMetafields Set Description ='updatedtest' where ProductId=77 and Id=3

Delete


Delete FROM ProductMetafields where ProductId=77 and Id=3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Unique ID of the Metafield.

ProductId [KEY] Integer True

Products.Id

The Id of the corresponding product.

DateCreated Datetime True

Date and time of the metafield?s creation.

DateModified Datetime True

Date and time when the metafield was last updated.

Description String False

Description for the metafields.

Key String False

The name of the field.

Value String False

The value of the field,must enter a JSON formatted string for ShipperHQ metafields.

Namespace String False

Namespace for the metafield, for organizational purposes.

OwnerClientId String True

ID of metafield's creator.

PermissionSet String False

Determines the visibility and writeability of the field by other API consumers.Must be one of app_only, read, write, read_and_sf_access or write_and_sf_access.

使用できる値は次のとおりです。app_only, read, write, read_and_sf_access, write_and_sf_access

ResourceId Integer True

The ID of the resource with which the metafield is associated.

ResourceType String True

The type of resource with which the metafield is associated.

BigCommerce Connector for CData Sync

ProductOptions

Returns data from Products table.

Table Specific Information

Select


SELECT * FROM ProductOptions

Insert

To insert a new ProductOption, a set of OptionValues are required to be inserted along with it. This can be done by populating a temporary ProductOptionValues table with the desired values for the option you are creating, and later using this table as a value for the LinkedOptionValues Pseudo-Columns during insertion:

INSERT INTO ProductOptionValues#TEMP (Label, SortOrder, IsDefault) VALUES ('Classic', 0, true);
INSERT INTO ProductOptionValues#TEMP (Label, SortOrder, IsDefault) VALUES ('Elegance', 1, false);
INSERT INTO ProductOptionValues#TEMP (Label, SortOrder, IsDefault) VALUES ('Avantgarde', 2, false);
INSERT INTO ProductOptions (ProductId, DisplayName, Type, Name, SortOrder, LinkedOptionValues) VALUES (955, 'ModelSeries', 'dropdown', 'Series', 0, ProductOptionValues#TEMP);

Update


UPDATE ProductOptions SET DisplayName='Testing123' where Id=109

Delete


DELETE FROM ProductOptions WHERE Id = 3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The ID of the option.

ProductId [KEY] Integer True

Products.Id

The ID of the product.

DisplayName String False

The name of the option shown on the storefront.

Name String False

The unique option name, auto-generated from the display name, a timestamp, and the product ID.

Type String False

The type of option, which determines how it will display on the storefront. Acceptable values: radio_buttons, rectangles, dropdown, product_list, product_list_with_images, swatch.

SortOrder Integer False

The order in which the option will be displayed on the product page.

ConfigDefaultValue String False

The default value. Shown on a date option as an ISO-8601�formatted string, or on a text option as a string.

ConfigCheckedByDefault Boolean False

Flag for setting the checkbox to be checked by default.

ConfigCheckboxLabel String False

Label displayed for the checkbox option.

ConfigDateLimited Boolean False

Flag to limit the dates allowed to be entered on a date option.

ConfigDateLimitMode String False

The type of limit that is allowed to be entered on a date option.

使用できる値は次のとおりです。earliest, range, latest

ConfigDateEarliestValue String False

The earliest date allowed to be entered on the date option, as an ISO-8601 formatted string.

ConfigDateLatestValue String False

The latest date allowed to be entered on the date option, as an ISO-8601 formatted string.

ConfigFileTypesMode String False

The kind of restriction on the file types that can be uploaded with a file upload option. Values: specific - restricts uploads to particular file types; all - allows all file types.

使用できる値は次のとおりです。specific, all

ConfigFileTypesSupported String False

The type of files allowed to be uploaded if the file_type_option is set to specific.

ConfigFileTypesOther String False

A list of other file types allowed with the file upload option.

ConfigFileMaxSize Integer False

The maximum size for a file that can be used with the file upload option. This will still be limited by the server.

ConfigTextCharactersLimited Boolean False

Flag to validate the length of a text or multi-line text input.

ConfigTextMinLength Integer False

The minimum length allowed for a text or multi-line text option.

ConfigTextMaxLength Integer False

The maximum length allowed for a text or multi line text option.

ConfigTextLinesLimited Boolean False

Flag to validate the maximum number of lines allowed on a multi-line text input.

ConfigTextMaxLines Integer False

The maximum number of lines allowed on a multi-line text input.

ConfigNumberLimited Boolean False

Flag to limit the value of a number option.

ConfigNumberLimitMode String False

The type of limit on values entered for a number option.

使用できる値は次のとおりです。lowest, highest, range

ConfigNumberLowestValue Integer False

The lowest allowed value for a number option if number_limited is true.

ConfigNumberHighestValue Integer False

The highest allowed value for a number option if number_limited is true.

ConfigNumberIntegersOnly Boolean False

Flag to limit the input on a number option to whole numbers only.

ConfigProductListAdjustsInventory Boolean False

Flag for automatically adjusting inventory on a product included in the list.

ConfigProductListAdjustsPricing Boolean False

Flag to add the optional product's price to the main product's price.

ConfigProductListShippingCalc String False

How to factor the optional product's weight and package dimensions into the shipping quote.

使用できる値は次のとおりです。none, weight, package

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
LinkedOptionValues String

Column for the aggregate table name holding option values.

BigCommerce Connector for CData Sync

ProductOptionValues

Returns data from Products table.

Table Specific Information

Select


SELECT * FROM ProductOptionValues 

Insert

To insert a new ProductOptionValues, you need to specify at least the following columns: ProductId, OptionId, Label, SortOrder, and any one among ValueDataImgUrl and ValueDataColors.

Inserting ProductOptionValues with ValueDataImgUrl.

INSERT INTO ProductOptionValues (OptionId,ProductId,Label, SortOrder,ValueDataImgUrl,ValueDataColors) VALUES ('143','77','testingexceptionfornow','2','https://cdn11.bigcommerce.com/s-dr2j9p39ga/product_images/attribute_value_images/357.preview.jpg?t=1696324267','#e35e22')

Inserting ProductOptionValues with ValueDataColors.

INSERT INTO ProductOptionValues (OptionId,ProductId,Label, SortOrder,ValueDataColors) VALUES ('143','77','toasting123','2','#e35e20')

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The ID of the option value.

OptionId [KEY] Integer True

ProductOptions.Id

The ID of the option.

ProductId [KEY] Integer True

Products.Id

The ID of the product.

Label String False

The label of the option value shown on the storefront.

IsDefault Boolean False

Whether this option value is the default for this option.

SortOrder Integer False

The order in which the option value will be displayed on the product page.

ValueDataColors String False

The colors contained in the value data.

ValueDataImgUrl String False

The image url contained in the value data.

BigCommerce Connector for CData Sync

ProductReviews

Returns reviews registered for products.

Table Specific Information

Select


SELECT * FROM ProductReviews 

Insert

To insert a new ProductReviews, you need to specify at least the following columns: Title,Status, Id,ProductId,DateReviewed.

INSERT INTO ProductReviews (Title,Status, Id,ProductId,DateReviewed) VALUES ('Car Interior121', 'approved','6','103','2019-08-24T14:15:22Z')

Update


UPDATE ProductReviews SET Title='Testing123' where Id=7

Delete


DELETE FROM ProductReviews WHERE Id = 16

Columns

Name Type ReadOnly References Description
Id [KEY] Integer False

The Id of the review.

ProductId [KEY] Integer True

Products.Id

The Id of the corresponding product.

Title String False

Title of the review.

Text String False

Text content of the review.

Status String False

The status of the product review. Must be one of approved, disapproved, or pending.

Rating Integer False

The rating of the product review. Must be one of 0, 1, 2, 3, 4, or 5.

Email String False

The email of the reviewer. Must be a valid email, or an empty string.

Name String False

The name of the reviewer.

DateCreated Datetime True

The date of creation for the review.

DateModified Datetime True

The last modification date of the review.

DateReviewed Datetime False

Date the product was reviewed.

BigCommerce Connector for CData Sync

Products

Returns data from products table.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, >=, >, <=, <' comparison.
  • Name supports the '=' comparison.
  • Sku supports the '=' comparison.
  • Description supports the '=' comparison.
  • Price supports the '=' comparison.
  • IsVisible supports the '=' comparison.
  • IsFeatured supports the '=' comparison.
  • InventoryLevel supports the '=, >=, >, <=, <' comparison.
  • DateCreated supports the '=, >=, >, <=, <' comparison.
  • BrandId supports the '=' comparison.
  • DateModified supports the '=, >=, >, <=, <' comparison.
  • Condition supports the '=' comparison.
  • DateLastImported supports the '=, >=, >, <=, <' comparison.
  • Availability supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Products WHERE Id > 5 AND Id < 10

SELECT * FROM Products WHERE IsVisible = "true" AND DateCreated >= "2020-01-01" AND DateCreated <= "2020-02-01" 

Insert

To insert a new Product, you need to specify at least the following columns: Name, Type, Description, Price, Categories, Availability and Weight

INSERT INTO Products (Name, Type, Description, Price, Categories, Availability, Weight) VALUES ("Plain T-Shirt", "physical", "This is a test description", 29.99, 18, "available", 0.5)

Inserting Products with more than one Variants using Temp table or Aggregegates.

INSERT INTO ProductVariantValues#TEMP (Label, DisplayName, id) VALUES ('Blue', 'Color', 1)
INSERT INTO ProductVariantValues#TEMP (Label, DisplayName, id) VALUES ('Yellow', 'Color', 2)

INSERT INTO ProductVariants#TEMP (SKU, LinkedOptionValues, id) VALUES ('SKU-AB', 'ProductVariantValues#TEMP', 1)
INSERT INTO ProductVariants#TEMP (SKU, LinkedOptionValues, id) VALUES ('SKU-CD', 'ProductVariantValues#TEMP', 2)

INSERT INTO Products (Name, Type, Weight, Price, ProductVariants) VALUES ('BC-8', 'physical', 60, 5700, 'ProductVariants#TEMP')

INSERT INTO Products (Name, Type, Weight, Price, ProductVariants) VALUES ('BC-95', 'physical', 99, 5800, '[{"sku": "SKU-MM","option_values": [{"option_display_name": "Song","id": "1","label": "Mary"}]}, {"sku": "SKU-DE","option_values": [{"option_display_name": "Song","id": "2","label": "Jane"}]}]')

Inserting Products with one Variant

INSERT INTO ProductVariantValues#TEMP (Label, DisplayName) VALUES ('Blue', 'Color')

INSERT INTO ProductVariants#TEMP (SKU, LinkedOptionValues) VALUES ('SKU-AB', 'ProductVariantValues#TEMP')

INSERT INTO Products (Name, Type, Weight, Price, ProductVariants) VALUES ('BC-8', 'physical', 60, 5700, 'ProductVariants#TEMP')

Bulk Update


INSERT INTO Update#TEMP (Description, id, name, sku, categories, RelatedProducts, MetaKeywords, IsCustomized, Url) VALUES ('my_details', '80', 'hello123', 'OTL', '19, 23', '1, 2', '"pqr", "xyz"', false, '/orbit-terrarium-large/'
INSERT INTO Update#TEMP (Description, id, name, sku, categories, RelatedProducts, MetaKeywords, IsCustomized, Url) VALUES ('my_details1', '86', 'example', 'ABS', '23, 21', '3, 4', '"abc", "an"', false, '/able-brewing-system/'
UPDATE products (Description, id, name, sku, categories, RelatedProducts, MetaKeywords, IsCustomized, Url) SELECT Description, id, name, sku, categories, RelatedProducts, MetaKeywords, IsCustomized, Url FROM Update#TEMP

Bulk Update Using Aggregates.

INSERT INTO Update#TEMP (Description, id, name, sku, categories, RelatedProducts, MetaKeywords, CustomUrl) VALUES ('details1', '77', 'name4456', 'SLCTBS', '23, 18', '10', '"abcd", "ab"',
            '{
			  "is_customized": False,
			  "url" : "/fog-linen-chambray-towel-beige-stripe/"
             }')
UPDATE products (Description, id, name, sku, categories, RelatedProducts, CustomUrl) SELECT Description, id, name, sku, categories, RelatedProducts, CustomUrl FROM Update#TEMP

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The Id of the product.

Name String False

The product name.

Type String False

The product type.

Sku String True

User-defined product code/stock keeping unit (SKU)

Description String False

Product description, which can include HTML formatting.

SearchKeywords String False

A comma-separated list of keywords that can be used to locate the product when searching the store.

AvailabilityDescription String False

Availability text, displayed on the checkout page under the product title, telling the customer how long it will normally take to ship this product.

Price Decimal False

The products price.

CostPrice Decimal False

The products cost price.

RetailPrice Decimal False

The products retail cost.

SalePrice Decimal False

Sale price.

MapPrice Decimal False

Map price.

ProductTaxCode String False

Tax Codes.

CalculatedPrice Decimal True

Price as displayed to guests, adjusted for applicable sales and rules.

SortOrder Integer False

Priority to give this product when included in product lists on category pages and in search results.

IsVisible Boolean False

Flag to determine whether or not the product should be displayed to customers browsing.

IsFeatured Boolean False

Flag to determine whether the product should be included in the featured products panel for shoppers viewing the store.

RelatedProducts String False

Defaults to -1, which causes the store to automatically generate a list of related products.

InventoryLevel String False

Current inventory level of the product.

InventoryWarningLevel String False

Inventory Warning level for the product.

Warranty String False

Warranty information displayed on the product page.

Weight Decimal False

Weight of the product, which can be used when calculating shipping costs.

Width Decimal False

Width of the product, which can be used when calculating shipping costs.

Height Decimal False

Height of the product, which can be used when calculating shipping costs.

Depth Decimal False

Depth of the product, which can be used when calculating shipping costs.

FixedCostShippingPrice Decimal False

A fixed shipping cost for the product.

IsFreeShipping Boolean False

Flag used to indicate whether or not the product has free shipping.

InventoryTracking String False

The type of inventory tracking for the product.

RatingTotal Integer False

The total rating for the product.

RatingCount Integer False

The total number of ratings the product has had.

ReviewsRatingSum Integer True

The total (cumulative) rating for the product.

ReviewsCount Integer True

The number of times the product has been rated.

TotalSold Integer False

Total quantity of this product sold through transactions.

DateCreated Datetime False

The date of which the product was created.

BrandId Integer True

The products brand

ViewCount Integer False

The number of times the product has been viewed.

PageTitle String False

Custom title for the products page.

MetaKeywords String False

Custom meta keywords for the product page.

MetaDescription String False

Custom meta description for the product page.

LayoutFile String False

The layout template file used to render this product category.

IsPriceHidden Boolean False

The default false value indicates that this products price should be shown on the product page.

PriceHiddenLabel String False

By default, an empty string. If is_price_hidden is true, the value of price_hidden_label will be displayed instead of the price.

Categories Int[] False

An array of IDs for the categories this product belongs to. When updating a product, if an array of categories is supplied, then all product categories will be overwritten.

DateModified Datetime False

The date that the product was last modified.

Condition String False

The products condition.

IsConditionShown Boolean False

Flag used to determine whether the products condition will be shown to the customer on the product page.

PreorderReleaseDate Datetime False

Pre-order release date.

IsPreorderOnly Boolean False

If set to false, the product will not change its availability from preorder to available on the release date.

PreorderMessage String False

Custom expected-date message to display on the product page.

OrderQuantityMinimum Integer False

The minimum quantity an order must contain in order to purchase this product.

OrderQuantityMaximum Integer False

The maximum quantity an order can contain when purchasing the product.

OpenGraphType String False

Type of product.

OpenGraphTitle String False

Title of the product. If not specified, the products name will be used instead.

OpenGraphDescription String False

Description to use for the product.

OpenGraphUseMetaDescription Boolean False

Flag to determine if product description or open graph description is used.

OpenGraphUseProductName Boolean False

Flag to determine if product name or open graph name is used.

OpenGraphUseImage Boolean False

Flag to determine if product image or open graph image is used.

IsOpenGraphThumbnail Boolean False

If set to true, the product thumbnail image will be used as the open graph image.

UPC String False

The product UPC code, which is used in feeds for shopping comparison sites.

GTIN String False

Global Trade Item Number.

OptionSetId Integer True

The ID of the option set applied to the product.

TaxClassId Integer True

The ID of the tax class applied to the product.

OptionSetDisplay String True

The position on the product page where options from the option set will be displayed.

BinPickingNumber String False

The BIN picking number for the product.

CustomUrl String False

Custom URL (if set) overriding the structure dictated in the stores settings.

CustomFields String False

200 maximum custom fields per product. 255 maximum characters per custom field.

ManufacturerPartNumber String False

Manufacturer Part Number.

IsCustomized Boolean False

Returns true if the URL has been changed from its default state (the auto-assigned URL that BigCommerce provides.

Url String False

Product URL on the storefront.

Availability String False

Availability of the product.

PrimaryImageId Integer True

Id of the primary image.

PrimaryImageProductId Integer True

ProductId of the primary image.

PrimaryImageIsThumbnail Boolean True

Primary image Is Thumbnail or not.

PrimaryImageSortOrder String True

Sort Order of the primary image.

PrimaryImageDescription String True

Description of the primary image.

PrimaryImageImageFile String True

Image file of the primary image.

PrimaryImageUrlZoom String True

Zoom Url of the primary image.

PrimaryImageStandardUrl String True

Standard url of the primary image.

PrimaryImageUrlThumbnail String True

Thumbnail url of the primary image.

PrimaryImageUrlTiny String True

Tiny url of the primary image.

PrimaryImageDateModified Datetime True

Modified Date of the primary image.

GiftWrappingOptionsType String True

Type of gift-wrapping options.

GiftWrappingOptionsList String True

Type of gift-wrapping option IDs.

BaseVariantId String True

Base Variant Id.

Pseudo-Columns

疑似カラムフィールドを使用して、ユーザーは新しいレコードの作成時に必要な読み取り不可のフィールドを挿入できます。

Name Type Description
ProductVariants String

Variants of the Products

BigCommerce Connector for CData Sync

ProductVariants

Returns data from Products table.

Table Specific Information

Select


SELECT * FROM ProductVariants

Insert

To create a new ProductVariant, a set of OptionValues are required to be inserted along with it. This can be done by populating a temporary ProductVariantValues table with the desired values for the option you are creating, and later using this table as a value for the LinkedOptionValues Pseudo-Columns during insertion:

INSERT INTO ProductVariantValues#TEMP (Id, OptionId, Label, DisplayName) VALUES (181, 118, 'Elegance', 'Series');
INSERT INTO ProductVariants (ProductId, LinkedOptionValues, SKU) VALUES (955, ProductVariantValues#TEMP, 'DSFMGG');

Update


UPDATE ProductVariants SET Weight='23' where Id=64

Delete


DELETE FROM ProductVariants WHERE Id = 3

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

The ID of the product variant.

ProductId [KEY] Integer True

Products.Id

The ID of the product.

SKU String False

User defined product code/stock keeping unit (SKU).

SKU_ID String False

The ID for User defined product code/stock keeping unit (SKU).

Price Decimal False

The price of the product variant. The price should include or exclude tax, based on the store settings.

CalculatedPrice Integer False

The variant’s calculated price on the storefront.

SalePrice Integer False

The variant’s sale price on the storefront.

RetailPrice Integer False

The variant’s retail price on the storefront.

MapPrice Integer False

The Minimum Advertised Price.

Weight String False

This variant’s base weight on the storefront. If this value is null, the product’s default weight (set in the Product resource’s weight field) will be used as the base weight.

Calculated_Weight Integer False

The variant’s calculated weight on the storefront.

Width Long False

Width of the variant, which can be used when calculating shipping costs.

Height Long False

The Height of the variant, which can be used when calculating shipping costs.

Depth Long False

The Depth of the variant, which can be used when calculating shipping costs.

Is_Free_Shipping Boolean False

The Flag used to indicate whether the variant has free shipping. If true, the shipping cost for the variant will be zero.

FixedCostShippingPrice Integer False

The fixed shipping cost for the variant. If defined, this value will be used during checkout instead of normal shipping-cost calculation.

Purchasing_Disabled String False

Accepts AvaTax System Tax Codes, which identify products and services that fall into special sales-tax categories.

Purchasing_Disabled_Message String False

Accepts AvaTax System Tax Codes, which identify products and services that fall into special sales-tax categories.

Image_Url String False

The Image url for the variant.

CostPrice Integer False

The cost price of the variant.

Upc String False

The UPC code used in feeds for shopping comparison sites and external channel integrations.

Mpn String False

The Manufacturer Part Number (MPN) for the variant.

Gtin String False

The Global Trade Item Number.

InventoryLevel Integer False

The Inventory level for the variant, which is used when the product’s inventory_tracking is set to variant.

InventoryWarningLevel Integer False

The Inventory warning level for the product

BinPickingNumber String False

Identifies where in a warehouse the variant is located.

LinkedOptionValues String False

The Option Value Id.

BigCommerce Connector for CData Sync

ShippingMethods

Lists all shipping methods.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • ZoneId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following query is processed server-side:

SELECT * FROM ShippingMethods

SELECT * FROM ShippingMethods WHERE ZoneId = 1

SELECT * FROM ShippingMethods WHERE ZoneId = 1 and Id = 1

Insert

To insert a new ShippingMethod, Name, Type, Settings and ZoneId are required to be inserted along with it. Settings has to be passed as a JSON Object.

INSERT INTO ShippingMethods (Name, Type, Enabled, ZoneId, HandlingFeesFixedSurcharge, Settings) VALUES ('Flat Rate 2', 'perorder', true, 1, 0, '{ "rate" : 7 }')

Update

To update a ShippingMethod, Name, Type, Settings, ZoneId and Id are required.
UPDATE ShippingMethods Set Name = 'Flat Rate 1', Type = 'perorder', Settings = '{ "rate" : 7 }', HandlingFeesPercentageSurcharge = 1 WHERE Id = 9 and ZoneId = 1

Delete

To delete a shipping method, Id and ZoneId are required.
DELETE FROM ShippingMethods WHERE Id = 9 and ZoneId = 1

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Shipping Method Id.

Name String False

Shipping Method name.

Type String False

Shipping Method type.

Enabled Boolean False

Minimum subtotal of the free shipping.

HandlingFeesPercentageSurcharge Decimal False

Percentage surcharge of the handling fee.

HandlingFeesFixedSurcharge Decimal False

Fixed surcharge of the handling fee.

IsFallback Boolean True

Whether or not this shipping zone is the fallback if all others are not valid for the order.

Settings String False

Shipping method settings.

ZoneId Integer True

The Shipping Zone Id

BigCommerce Connector for CData Sync

ShippingZones

Lists all shipping zones.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with Id, which supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following query is processed server-side:

SELECT * FROM ShippingZones WHERE Id = 1 

Insert

To insert a new ShippingZone, a set of Locations are required to be inserted along with it. This can be done by populating a temporary ShippingZoneLocations table with the desired values for the option you are creating, and later using this table as a value for the Locations column during insertion:

INSERT INTO ShippingZoneLocations#Temp (CountryIso2, Zip) values ('US', '11103')
INSERT INTO ShippingZones (Name, Type, locations) VALUES ('United States', 'zip', 'ShippingZoneLocations#Temp')

Update


UPDATE ShippingZones SET Enabled=true WHERE Id = 7

Delete


DELETE FROM ShippingZones WHERE Id = 7

Columns

Name Type ReadOnly References Description
Id [KEY] Integer True

Zone Id.

Name String False

Zone name.

Type String False

Zone type.

使用できる値は次のとおりです。zip, country, state, global

FreeShippingEnabled Boolean False

Indicator if free shipping is enabled.

FreeShippingMinimumSubTotal Decimal False

Minimum subtotal of the free shipping.

FreeShippingExcludeFixedShippingProducts Boolean False

Indicator whether or not to exclude fixed shipping on products.

HandlingFeesDisplaySeparately Boolean False

Indicator whether or not to display the handling fees separately.

HandlingFeesPercentageSurcharge Decimal False

Percentage surcharge of the handling fee.

HandlingFeesFixedSurcharge Decimal False

Fixed surcharge of the handling fee.

Enabled Boolean False

Whether this shipping zone is enabled.

Locations String False

Array of zone locations.

BigCommerce Connector for CData Sync

ビュー

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

BigCommerce Connector for CData Sync ビュー

Name Description
Blogposts Returns all Blog Posts.
BlogTags Returns a list of Blog Tags.
CustomerGroups Returns a list of Customer Groups.
DownloadConsignments Returns consignments and their corresponding downloads.
EmailConsignments Returns consignments and their corresponding emails.
GiftCertificates Lists all gift certificates.
OrderCoupons Lists all order coupons.
OrderItemOptionValues Returns data from OrderItems table.
OrderMessages Gets the messages associated with an order.
OrderRefunds Returns a list of refunds.
OrderRefundsItems List of Items refunded.
OrderRefundsPayments Refund payments made to payment providers.
OrderShippingAddresses Returns shipping addresses and their corresponding orders.
OrderStatuses Returns order statuses.
OrderTaxes Gets all order taxes related to an order.
Pages Lists all pages.
PaymentMethods Lists all payment methods.
PickupConsignments Returns consignments and their corresponding pickups.
PriceListAssignments Returns an array of Price List Assignments matching a particular Customer Group and Price List and Channel.
ProductBulkPricingRules Returns bulk pricing rules applied to a product.
ProductCustomFields Lists all tax classes.
ProductRules Returns rules that modify the properties of a product, such as weight, price, and product image.
ProductSkus Returns Stock Keeping Unit identifiers associated with products or product options.
ProductVariantValues Returns data from Products table.
ProductVideos Returns Embedded videos displayed on product listings.
Redirects Lists all redirect URLs.
ShipmentItems Returns data from Items within a shipment.
ShippingConsignmentQuotes Gets all shipping quotes persisted on an order for a shipping consignment.
ShippingConsignments Returns consignments and their corresponding shipping orders.
Stores Lists all Stores.
TaxClasses Lists all tax classes.
Transactions Lists all transactions.

BigCommerce Connector for CData Sync

Blogposts

Returns all Blog Posts.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • Url supports the '=' comparison.
  • IsPublished supports the '=' comparison.
  • PublishedDate supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM Blogposts WHERE Id = "1234" 

SELECT * FROM Blogposts WHERE IsPublished = "true"

Columns

Name Type References Description
Id [KEY] Integer Id of the blogpost
Title String Title of this blog post.
URL String URL for the public blog post.
PreviewURL String URL to preview the blog post.
Body String Text body of the blog post.
Summary String Summary of the blog post.
IsPublished Boolean Whether the blog post is published.
PublishedDate Datetime Date when the blogpost was published.
PublishedTimezone String Timezone when the blogpost was published.
PublishedTimezoneType String Type of the timezone.
PublishedDateISO String Published date in ISO8601 format.
MetaDescription String Description text for this blog posts meta element.
MetaKeywords String Keywords for this blog posts meta element.
Author String Name of the blog posts author.
ThumbnailPath String Local path to a thumbnail image within the product_images folder to accompany the blog post.

BigCommerce Connector for CData Sync

BlogTags

Returns a list of Blog Tags.

Columns

Name Type References Description
BlogIds [KEY] String Id of the blogpost
Tag [KEY] String Tag which belongs to the blog.

BigCommerce Connector for CData Sync

CustomerGroups

Returns a list of Customer Groups.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • Name supports the '=' comparison.
  • IsDefault supports the '=' comparison.
  • IsGroupForGuests supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM CustomerGroups WHERE Id = 1 

SELECT * FROM CustomerGroups WHERE IsDefault = "true"

SELECT * FROM CustomerGroups WHERE IsGroupForGuests = "true"

Columns

Name Type References Description
Id [KEY] Integer Id of the customer group
Name String Name of the group
IsDefault Boolean Determines whether new customers are assigned to this group by default.
CategoryAccessType String Type of the category access.
CategoryAccessCategories String An array of category IDs.
IsGroupForGuests Boolean Describes whether the group is for guests. There can only be one customer group for guests at a time.
DateCreated Date Date on which the customer group was created.
DateModified Date Date on which the customer group was last modified.
DiscountRulesAmount String A collection of discount rules that are automatically applied to customers who are members of the group.

BigCommerce Connector for CData Sync

DownloadConsignments

Returns consignments and their corresponding downloads.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with OrderId, which supports the '=' comparison.

For example, the following queries are processed server-side:

SELECT * FROM DownloadConsignments WHERE OrderId = 123 

Columns

Name Type References Description
OrderId Integer

Orders.Id

Identifier for the BigCommerce Order with which this transaction is associated.
RecipientEmail String The recipient email of the digital consignment.
DownloadLineItemResources String URL where you can use a GET request to get the downloads line items for the order consignment.
DownloadLineItemUrl String Path where you can use a GET request to get the downloads line items for the order consignment.

BigCommerce Connector for CData Sync

EmailConsignments

Returns consignments and their corresponding emails.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with OrderId, which supports the '=' comparison.

For example, the following queries are processed server-side:

SELECT * FROM EmailConsignments WHERE OrderId = 123 

Columns

Name Type References Description
OrderId Integer

Orders.Id

Identifier for the BigCommerce Order with which this transaction is associated.
RecipientEmail String The recipient email of the gift certificate.
GiftCertificatesLineItemResources String URL where you can use a GET request to get the gift certificate line items for the order consignment.
GiftCertificatesLineItemUrl String Path where you can use a GET request to get the gift certificate line items for the order consignment.

BigCommerce Connector for CData Sync

GiftCertificates

Lists all gift certificates.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, >=, >, <=, <' comparison.
  • Code supports the '=' comparison.
  • ToName supports the '=' comparison.
  • ToEmail supports the '=' comparison.
  • OrderId supports the '=' comparison.
  • FromEmail supports the '=' comparison.
  • FromName supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM GiftCertificates WHERE Id = 1 

SELECT * FROM GiftCertificates WHERE IsDefault = "true"

SELECT * FROM GiftCertificates WHERE IsGroupForGuests = "true"

Columns

Name Type References Description
Id [KEY] Integer The ID of the gift certificate.
Code String A unique string that the customer can input to redeem the gift certificate.
Amount Decimal Value of the gift certificate.
Status String Status of the gift certificate.
Balance Decimal Remaining value of the gift certificate.
ToName String Name of the recipient.
ToEmail String Email of the recipient.
OrderId Integer The ID of the order.
Template String The email theme to use in the message sent to the recipient.
Message String Text that will be sent to the recipient, such as Congratulations.
FromName String Name of the customer who purchased the gift certificate.
FromEmail String Email of the customer who purchased the gift certificate.
CustomerId Integer The id of the customer placing the order.
ExpiryDate Datetime Date on which the gift certificate is set to expire.
PurchaseDate Datetime Date the gift certificate was purchased.
CurrencyCode String The currency code.

BigCommerce Connector for CData Sync

OrderCoupons

Lists all order coupons.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • OrderId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderCoupons WHERE Id = 1 

SELECT * FROM OrderCoupons WHERE OrderId = 2

Columns

Name Type References Description
Id [KEY] Integer Numeric ID of this product within this order.
OrderId Integer Numeric ID of the associated order.
CouponId Integer The coupon id.
Code String The code of the coupon.
Amount Decimal The amount of the coupon.
Type Integer The type of the coupon.
Discount Decimal The discount of the coupon.

BigCommerce Connector for CData Sync

OrderItemOptionValues

Returns data from OrderItems table.

Table Specific Information

Select

The ID of the corresponding Order-Item is required to perform a SELECT query on OrderItemOptionValues:

SELECT * FROM [OrderItemOptionValues] WHERE OrderItemId = 2522;

Columns

Name Type References Description
Id [KEY] Integer The numerical ID of the option value within the group of ordered items.
OptionId Integer

ProductOptions.Id

The ID of the option from Product Options table.
OrderItemId [KEY] Integer

OrderItems.Id

The ID of the product.
OrderItemOptionId Integer The numerical ID of the option within the group of ordered items.
DisplayName String The name of the option shown on the storefront.
DisplayValue String The value of the option shown on the storefront.
Value String The actual value of the option.
Name String The unique option name, auto-generated from the display name, a timestamp, and the product ID.
Type String The type of option, which determines how it will display on the storefront. Acceptable values: radio_buttons, rectangles, dropdown, product_list, product_list_with_images, swatch.
DisplayStyle String The specific style which the order will be displayed as.

BigCommerce Connector for CData Sync

OrderMessages

Gets the messages associated with an order.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, <=, <, >=, >' comparison.
  • OrderId supports the '=' comparison.
  • CustomerId supports the '=' comparison.
  • Status supports the '=' comparison.
  • IsFlagged supports the '=' comparison.
  • DateCreated supports the '=, <=, <, >=, >' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderMessages WHERE Id = 1 

SELECT * FROM OrderMessages WHERE OrderId = 2

SELECT * FROM OrderMessages WHERE IsFlagged = "true"

SELECT * FROM OrderMessages WHERE DateCreated >= "2019-01-01" AND DateCreated <= "2020-01-01"

Columns

Name Type References Description
Id [KEY] Integer Numeric ID of this product within this order.
OrderId Integer Numeric ID of the associated order.
StaffId Integer The staff id.
CustomerId Integer The customer id.
Type String Type of the message.
Subject String Subject of the message.
Message String Message content.
Status String Status of the message.
IsFlagged Boolean Indicator if the message is flagged.
DateCreated Datetime Datetime when the message was first created.

BigCommerce Connector for CData Sync

OrderRefunds

Returns a list of refunds.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, IN' comparison.
  • OrderId supports the '=, IN' comparison.
  • Created supports the '=, >, <, IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderRefunds WHERE Id = 1 

SELECT * FROM OrderRefunds WHERE OrderId = 2

Columns

Name Type References Description
Id [KEY] Integer Refund resource ID.
Created [KEY] Datetime Timestamp of when this refund was created.
OrderId Integer Reference to order id.
Reason String Reason for refund.
TotalAmount Decimal A non-negative 2 decimal place rounded value that represents the amount that can be charged/refunded via payment providers.
TotalTax Decimal Total tax amount refunded back to the shopper. Note: order_level_amount does not affect tax liability.
UserId Integer Reference to the user's id who create this refund.
UsesMerchantOverrideValues Boolean Whether refund amount and tax are provided explicitly by merchant override

BigCommerce Connector for CData Sync

OrderRefundsItems

List of Items refunded.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • OrderId supports the '=, IN' comparison.
  • OrderRefundsId supports the '=, IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderRefundsItems WHERE OrderRefundId = 2

SELECT * FROM OrderRefundsItems WHERE OrderId = 2

Columns

Name Type References Description
ItemId [KEY] Integer order_product.id corresponding to the item_types of PRODUCT, GIFT_WRAPPING. order_address.id corresponding to the item_types of SHIPPING, HANDLING. order.id corresponding to the item_type of ORDER.
OrderRefundId [KEY] Integer

OrderRefunds.Id

The ID of the order refund.
OrderId Integer

OrderRefunds.OrderId

Reference to order id.
ItemType String Type of item that was refunded.
Quantity Integer Quantity of item refunded. Note: this will only be populated for item_type PRODUCT
Reason String Reason for refunding an item.
RequestedAmount Decimal A non-negative 2 decimal place rounded value that represents the amount that can be charged/refunded via payment providers..

BigCommerce Connector for CData Sync

OrderRefundsPayments

Refund payments made to payment providers.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • OrderId supports the '=, IN' comparison.
  • OrderRefundsId supports the '=, IN' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderRefundsItems WHERE OrderRefundId = 2

SELECT * FROM OrderRefundsPayments WHERE OrderId = 2

Columns

Name Type References Description
Id [KEY] Integer The ID of the refund payment.
OrderRefundId Integer

OrderRefunds.Id

The ID of the order refund.
OrderId Integer

OrderRefunds.OrderId

Reference to order id.
ProviderId String Reference to payment provider.
Amount Decimal A non-negative 2 decimal place rounded value that represents the amount that can be charged/refunded via payment providers.
Offline Boolean Indicate whether payment was offline.
IsDeclined Boolean Indicate if this payment has been declined by payment provider.
DeclinedMessage String Message indicate why payment was declined.

BigCommerce Connector for CData Sync

OrderShippingAddresses

Returns shipping addresses and their corresponding orders.

Columns

Name Type References Description
Id [KEY] Integer ID of this shipping address.
OrderId Integer ID of the order.
FirstName String Addressee first name.
LastName String Addressee last name.
Company String Addressee company.
Street1 String Street address (first line).
Street2 String Street address (second line).
City String Addressee city.
Zip String ZIP or postal code.
Country String Addressee's country.
State String The name of the state or province. Should be spelled out in full, for example, California.
Email String Recipient's email address.
Phone String Recipient's telephone number.
BaseCost Decimal The base value of the order's items.
BaseHandlingCost Decimal The base handling charge.
CostExTax Decimal The value of the order's items, excluding tax.
CostIncTax Decimal The value of the order's items, including tax.
CostTax Decimal The tax amount on the order.
CostTaxClassId String The ID of the tax class applied to the product.
CountryIso2 String 2-letter ISO Alpha-2 code for the country.
HandlingCostExTax Decimal The handling charge, excluding tax.
HandlingCostIncTax Decimal The handling charge, including tax.
HandlingCostTax Decimal The handling charge.
HandlingCostTaxClassId String A read-only value. Do not attempt to set or modify this value in a POST or PUT operation.
ItemsShipped Integer The number of items that have been shipped.
ItemsTotal Integer The total number of items in the order.
ShippingMethod String Text code identifying the BigCommerce shipping module selected by the customer.
ShippingZoneId Integer Numeric ID of the shipping zone.
ShippingZoneName String Name of the shipping zone.

BigCommerce Connector for CData Sync

OrderStatuses

Returns order statuses.

Columns

Name Type References Description
Id [KEY] Integer The Id of the type of order status
Name String Name of the type of order status.
Systemlabel String System name of the type of order status.
CustomLabel String Custom order status label given in the Control Panel.
SystemDescription String System description of the order status.

BigCommerce Connector for CData Sync

OrderTaxes

Gets all order taxes related to an order.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • OrderId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM OrderTaxes WHERE Id = 1 

SELECT * FROM OrderTaxes WHERE OrderId = 2

Columns

Name Type References Description
Id [KEY] Integer Numeric ID of this product within this order.
OrderId Integer Numeric ID of the associated order.
OrderAddressId Integer The unique numeric identifier of the order address object associated with the order.
TaxRateId Integer The unique numeric identifier of the tax rate.
TaxClassId Integer The unique numeric identifier of the tax class object.
Name String The name of the tax class object.
Class String The name of the type of tax that was applied.
Rate Decimal The tax rate.
Priority Integer The order in which the tax is applied.
PriorityAmount Decimal The amount of tax calculated on the order.
LineAmount Decimal The line amount.
OrderProductId String If the line_item_type is item or handling then this field will be the order product id. Otherwise the field will return as null.
LineItemType String Type of tax on item.

BigCommerce Connector for CData Sync

Pages

Lists all pages.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with Id, which supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following query is processed server-side:

SELECT * FROM Pages WHERE Id = 1 

Columns

Name Type References Description
Id [KEY] Integer Id of the page.
ChannelId Integer

Channels.Id

Channel Id of the page.
Name String Name of the page.
Email String Email of the page.
MetaTitle String Title of the page.
Body String Body of the page.
IsVisible Boolean Indicator if page is visible.
ParentId Integer Parent id of the page.
SortOrder Integer Sort order of the page.
MetaKeywords String Keywords of the page.
Type String Type of the page.
MetaDescription String Description of the page.
IsHomepage Boolean Indicator if the page is homepage.
IsCustomersOnly Boolean Indicator if the page is customer only.
SearchKeywords String Search keywords of the page.
Url String Url of the page.

BigCommerce Connector for CData Sync

PaymentMethods

Lists all payment methods.

Columns

Name Type References Description
Code [KEY] String The code of the payment method.
Name String The name of the payment method.
TestMode Boolean Indicator if the payment method is in test mode.

BigCommerce Connector for CData Sync

PickupConsignments

Returns consignments and their corresponding pickups.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with OrderId, supports the '=' comparison.

For example, the following queries are processed server-side:

SELECT * FROM PickupConsignments WHERE OrderId = 123 

Columns

Name Type References Description
Id Integer The ID of the pickup consignment to update.
OrderId Integer

Orders.Id

Identifier for the BigCommerce Order with which this transaction is associated.
PickupMethodId Integer The ID of the pickup consignment to update.
PickupMethodDisplayName String A name for the pickup method that can be displayed to shoppers.
CollectionInstructions String A message for shoppers explaining how to collect their pickup order.
CollectionTimeDescription String A message for shoppers indicating the estimated time their pickup order will be ready for collection.
LocationId Integer ID of the location.
LocationName String The name of the pickup location.
LocationCode String The code of the pickup location.
LocationAddressLine1 String Pickup location's Street address (first line)
LocationAddressLine2 String Pickup location's Street address (second line).
LocationCity String Pickup location's city.
LocationState String Pickup location's state.
LocationPostalCode String Pickup location's postal code.
LocationCountryAlpha2 String 2-letter ISO Alpha-2 code for the country.
LocationEmail String Pickup location's email address
LocationPhone String Pickup location's phone number.
PickupsLineItemResources String URL where you can use a GET request to get the pickups line items for the order consignment.
PickupsLineItemUrl String Path where you can use a GET request to get the pickups line items for the order consignment.

BigCommerce Connector for CData Sync

PriceListAssignments

Returns an array of Price List Assignments matching a particular Customer Group and Price List and Channel.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • CustomerGroupId supports the '=,IN' comparison.
  • PriceListId supports the '=,IN' comparison.
  • ChannelId supports the '=,IN' comparison.

The rest of the filter is executed client-side within the Sync App.


SELECT * FROM PriceListAssignments WHERE CustomerGroupId IN (1, 2)

SELECT * FROM PriceListAssignments WHERE PriceListId IN (1, 2)

SELECT * FROM PriceListAssignments WHERE PriceListId = 1

SELECT * FROM PriceListAssignments WHERE CustomerGroupId = 1

Columns

Name Type References Description
Id Integer The ID of the PriceList Assignment.
CustomerGroupId Integer The ID of the customer group.
PriceListId Integer The ID of the PriceList.
ChannelId Integer ID of the Channel.

BigCommerce Connector for CData Sync

ProductBulkPricingRules

Returns bulk pricing rules applied to a product.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • ProductId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ProductBulkPricingRules WHERE ProductId = 77

SELECT * FROM ProductBulkPricingRules WHERE ProductId = 77 AND Id = 1

Columns

Name Type References Description
Id [KEY] Integer The ID of the bulk discount rule.
ProductId [KEY] Integer The ID of the product associated with this bulk discount rule.
Min Integer The minimum inclusive quantity of a product to satisfy this rule. Must be greater than or equal to zero.
Max Integer The maximum inclusive quantity of a product to satisfy this rule.
Type String Type of the discount.
TypeValue Decimal The value of the discount

BigCommerce Connector for CData Sync

ProductCustomFields

Lists all tax classes.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • ProductId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ProductCustomFields WHERE Id = 1 

SELECT * FROM ProductCustomFields WHERE ProductId = 2

Columns

Name Type References Description
Id [KEY] Integer Numeric ID of the custom field.
ProductId Integer Id of the product that the custom field belongs to.
Name String Name of the custom field.
Text String Value of the custom field.

BigCommerce Connector for CData Sync

ProductRules

Returns rules that modify the properties of a product, such as weight, price, and product image.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • ProductId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ProductRules WHERE Id = 1 

SELECT * FROM ProductRules WHERE ProductId = 2 

Columns

Name Type References Description
Id [KEY] Integer The ID of the rule.
ProductId [KEY] Integer The ID of the product to which the rule belongs.
SortOrder Integer The order in which the rule will be displayed on the product page.
IsEnabled Boolean If set to true, the rule will be evaluated when a customer configures a products options.
IsStop Boolean If set to true and the rule evaluates to true, no more rules with a higher sort_order will be processed.
PriceAdjusterName String Price adjuster name.
PriceAdjusterValue Decimal Price adjuster value.
WeightAdjusterName String Weight adjuster name.
WeightAdjusterValue Decimal Weight adjuster value.
IsPurchasingDisabled Boolean If true this rule prohibits purchasing the product with the configured option values.
PurchasingDisabledMessage String The message to display if the rule disabled purchasing the product.
IsPurchasingHidden Boolean If true the rule hides the options on the product.
ImageFile String A path to an rule already uploaded via FTP in the import directory and the path should be relative from the import directory.

BigCommerce Connector for CData Sync

ProductSkus

Returns Stock Keeping Unit identifiers associated with products or product options.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=, >=, >, <=, <' comparison.
  • ProductId supports the '=' comparison.
  • Sku supports the '=' comparison.
  • Upc supports the '=' comparison.
  • InventoryLevel supports the '=' comparison.
  • InventoryWarningLevel supports the '=' comparison.
  • BinPickingNumber supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ProductSkus WHERE Id = 1 

SELECT * FROM ProductSkus WHERE Id >= 1 AND Id <= 4

SELECT * FROM ProductSkus WHERE ProductId = 2

SELECT * FROM ProductSkus WHERE InventoryLevel = "test"

Columns

Name Type References Description
Id [KEY] Integer ID of this sku.
ProductId [KEY] Integer ID of the associated product.
Sku String The unique SKU (stock keeping unit).
Price Decimal This SKUs base price on the storefront.
AdjustedPrice Decimal The SKUs price on the storefront, after the products base price is inherited, or any option set or any product rules are applied.
CostPrice Decimal The products cost price.
UPC String
InventoryLevel Integer The inventory level for the product.
InventoryWarningLevel Integer The inventory warning level for the product .
BinPickingNumber String The BIN picking number.
Weight Decimal This SKUs base weight on the storefront.
AdjustedWeight Decimal This SKUs weight on the storefront, after the products base weight is inherited, or any option set or any product rules are applied.
IsPurchasingDisabled Boolean If true, this prohibits purchasing of the SKU.
PurchasingDisabledMessage String The message to display if purchasing is disabled on this SKU.
ImageFile String The image that will be displayed when this SKU is selected on the storefront. When updating a SKU image, send the publicly accessible URL. Supported image formats are JPEG, PNG, and GIF.

BigCommerce Connector for CData Sync

ProductVariantValues

Returns data from Products table.

Columns

Name Type References Description
Id [KEY] Integer The ID of the option value.
VariantId [KEY] Integer

ProductVariants.Id

The ID of the corresponding variant.
OptionId [KEY] Integer

ProductOptions.Id

The ID of the option.
Label String The label of the option value shown on the storefront.
DisplayName String The label of the option value shown on the storefront.
ProductId String

Products.Id

The Id of the product

BigCommerce Connector for CData Sync

ProductVideos

Returns Embedded videos displayed on product listings.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • Id supports the '=' comparison.
  • ProductId supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries are processed server-side:

SELECT * FROM ProductVideos WHERE Id = 1 

SELECT * FROM ProductVideos WHERE ProductId = 1 

Columns

Name Type References Description
Id [KEY] String ID of this video.
ProductId [KEY] Integer ID of the associated product.
SortOrder Integer Sort order for this video.
Name String The title for the video.
Length String The duration of the video.
Description String The description for the video.
VideoId String The ID of the video on a host site.
Type String The video type (a short name of a host site)

BigCommerce Connector for CData Sync

Redirects

Lists all redirect URLs.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with Id, which supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following query is processed server-side:

SELECT * FROM Redirects WHERE Id = 1 

Columns

Name Type References Description
Id [KEY] Integer Numeric ID of the redirect.
SiteId Integer Site ID of the redirect.
FromPath String The path from which to redirect.
ToType String The type of redirect.
ToEntityId Integer EntityId of the redirect.
ToURL String URL of the redirect.
URL String Full destination URL for the redirect. Must be explicitly included via URL parameter.

BigCommerce Connector for CData Sync

ShipmentItems

Returns data from Items within a shipment.

Columns

Name Type References Description
Id [KEY] Integer

OrderItems.Id

Id of the Product within the order.
ProductId [KEY] Integer

Products.Id

Numerical Id of the product.
OrderShipmentId [KEY] String

OrderShipments.Id

Id of the shipment.
Quantity Integer Quantity of product shipped.

BigCommerce Connector for CData Sync

ShippingConsignmentQuotes

Gets all shipping quotes persisted on an order for a shipping consignment.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • OrderId supports the '=' comparison.
  • ShippingConsignmentId supports the '=' comparison.

For example, the following queries are processed server-side:

SELECT * FROM ShippingConsignmentQuotes WHERE OrderId = 123 and ShippingConsignmentId=234

Columns

Name Type References Description
Id Integer ID of the shipping quote.
OrderId Integer

Orders.Id

Identifier for the BigCommerce Order with which this transaction is associated.
ShippingConsignmentId Integer

ShippingConsignments.Id

ID of the shipping consignment.
UUID String UUID of the shipping quote.
Timestamp String Time the order was created in RFC 2822 format.
ProviderCode String Code of the shipping provider.
CarrierCode String Code of the shipping carrier.
RateCode String Type of delivery. This can vary based on shipping quote.
RateId String This can vary based on shipping quote.
MethodId Integer Shipping method ID.
ProviderQuoteRateValue Integer Provider quote's rate_value.
ProviderQuoteRateUnit String Provider quote's rate_unit.
ProviderQuoteName String Provider quote's name.
ProviderQuoteTransitTime Integer Provider quote's transitTime.
ProviderQuoteSignatureConfirmationFee String Provider quote's signatureConfirmationFee.
ProviderQuoteCarrierName String Provider quote's CarrierName.
ProviderQuoteDeliveryMessage String Provider quote's deliveryMessage.
ProviderQuoteLabelSizes String Provider quote's label sizes.
ProviderQuoteDates String Provider quote's dates.
ProviderQuoteInsuredMailFee String Provider quote's insuredMailFee.
ProviderQuoteRateId String Provider quote's rateId.
ProviderQuoteDescription String Provider quote's description.
ProviderQuoteAdditionalInfo String Provider quote's additionalInfo.

BigCommerce Connector for CData Sync

ShippingConsignments

Returns consignments and their corresponding shipping orders.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with the following columns and operators:

  • OrderId supports the '=' comparison.

For example, the following queries are processed server-side:

SELECT * FROM ShippingConsignments WHERE OrderId = 123 

Columns

Name Type References Description
Id Integer ID of the shipping consignment.
OrderId Integer

Orders.Id

Identifier for the BigCommerce Order with which this transaction is associated.
FirstName String First name.
LastName String Last name.
Company String company.
Street1 String Street address (first line).
Street2 String Street address (second line).
Country String country
State String State
Email String Recipient?s email address.
Phone String Recipient?s telephone number.
ItemsTotal String The total number of items in the order.
ItemsShipped String The number of items that have been shipped.
ShippingMethod String Text identifying the BigCommerce shipping module selected by the customer.
BaseCost Integer The base shipping cost value.
CostExTax Integer The shipping cost value excluding tax.
CostIncTax Integer The shipping cost value including tax.
CostTax Integer The tax amount on the shipping cost.
CostTaxClassId Integer The ID of the tax class applied to the shipping cost. Ignored if automatic tax is enabled.
BaseHandlingCost Integer The base handling charge.
HandlingCostExTax Integer The handling charge, excluding tax.
HandlingCostIncTax Integer The handling charge, including tax.
HandlingCostTax Integer The handling charge, including tax number.
HandlingCostTaxClassId Integer The ID of the tax class applied to the handling charge. Ignored if automatic tax is enabled.
ShippingZoneId Integer The numeric ID of the shipping zone.
ShippingZoneName String The name of the shipping zone.
ShippingQuotesResources String URL where you can use a GET request to get the shipping quotes for the order consignment.
ShippingQuotesUrl String Path where you can use a GET request to get the shipping quotes for the order consignment.
ZipCode String zip code of the shipping quotes.
ShippingLineItemResources String URL where you can use a GET request to get the shipping line items for the order consignment.
ShippingLineItemUrl String Path where you can use a GET request to get the shipping line items for the order consignment.
City String Path where you can use a GET request to get the shipping line items for the order consignment.
CountryIso String Path where you can use a GET request to get the shipping line items for the order consignment.

BigCommerce Connector for CData Sync

Stores

Lists all Stores.

Columns

Name Type References Description
Id [KEY] String Unique store identifier.
Domain String Primary domain name.
SecureUrl String Stores current HTTPS URL.
Status String Status of the store.
Name String Stores name.
FirstName String Primary contacts first name
LastName String Primary contacts last name
Address String Display address.
Country String Country where the store is located
CountryCode String Country code.
Phone String Display phone number.
AdminEmail String Email address of the store administrator/owner.
OrderEmail String Email address for orders and fulfillment.
FaviconUrl String URL of the favicon.
TimezoneName String A string identifying the time zone, in the format: /.
TimezoneRawOffset Integer A negative or positive number, identifying the offset from UTC/GMT, in seconds, during winter/standard time.
Language String Default language code.
Currency String Default currency code
CurrencySymbol String Default symbol for values in the currency.
DecimalSeparator String Default decimal separator for values in the currency.
ThousandsSeparator String Default thousands separator for values in the currency.
DecimalPlaces Integer Default decimal places for values in the currency.
CurrencySymbolLocation String Default position of the currency symbol (left or right).
WeightUnits String Default weight units (metric or imperial).
DimensionUnits String Default dimension units (metric or imperial).
DimensionDecimalPlaces Integer The number of decimal places.
DimensionDecimalToken String The symbol that separates the whole numbers from the decimal points.
DimensionThousandsToken String The symbol used to denote thousands.
PlanName String Name of the BigCommerce plan to which this store is subscribed.
PlanLevel String Level of the BigCommerce plan to which this store is subscribed.
Industry String Industry, or vertical category, in which the business operates.
LogoUrl String URL of the logo.
IsPriceEnteredWithTax Boolean A Boolean value that indicates whether or not prices are entered with tax.
FeaturesStencilEnabled Boolean Indicates whether a store is using a Stencil theme.
FeaturesSitewideHttpsEnabled Boolean Indicates if there is sitewide https.
FeaturesFacebookCatalogId String Id of the facebook catalog. If there is none, it returns an empty string.
FeaturesCheckoutType String What type of checkout is enabled on the store.

BigCommerce Connector for CData Sync

TaxClasses

Lists all tax classes.

Table Specific Information

Select

The Sync App uses the BigCommerce API to process WHERE clause conditions built with >Id, which supports the '=' comparison.

The rest of the filter is executed client-side within the Sync App.

For example, the following queries is processed server-side:

SELECT * FROM TaxClasses WHERE Id = 1 

Columns

Name Type References Description
Id [KEY] Integer Numeric ID of the tax class.
Name String Name of the tax class.
DateCreated Date The date when tax class was created.
DateModified Date The data when tax class was modified.

BigCommerce Connector for CData Sync

Transactions

Lists all transactions.

Columns

Name Type References Description
Id [KEY] Integer Unique identifier for the transaction.
OrderId String Identifier for the BigCommerce Order with which this transaction is associated.
Event String Store event that created the transaction.
Method String The payment method.
Amount Decimal Amount of money in the transaction.
Currency String Currency used for the transaction.
Gateway String The payment gateway.
Status String Status of the transaction.
GatewayTransactionId String The transaction ID returned by the payment gateway for this transaction item.
DateCreated Datetime The datetime of the transaction.
Test Boolean True if the transaction performed was a test, or if the gateway is in test mode.
FraudReview Boolean Result of gateway fraud review, if any.
ReferenceTransactionId Integer Identifier for an existing transaction upon which this transaction acts.
OfflineDisplayName String Display name for the offline payment.
CustomPaymentMethod String Custom payment from manual order.
PaymentMethodId String The payment method ID used for this transaction.
PaymentInstrumentToken String Internal BigPay token for stored card.
AVSResultCode String AVS code from the payment gateway.
AVSResultMessage String AVS message from the payment gateway.
AVSResultStreetMatch String AVS Code for street matching result.
AVSResultPostalMatch String AVS Code for postal matching result.
CVVResultCode String CVV Code from the payment Gateway.
CVVResultMessage String CVV Message from the payment Gateway.
CreditCardType String Type of credit-card.
CreditCardIIN String The IIN of a credit-card number.
CreditCardLast4 String The last 4 digits of a credit-card number.
CreditCardExpiryMonth Integer The expiry month of a credit-card.
CreditCardExpiryYear Integer The expiry year of a credit-card.
GiftCertificateCode String The gift-certificate code.
GiftCertificateOriginalBalance Decimal The balance on a gift certificate when it was purchased.
GiftCertificateStartingBalance Decimal The balance on a gift certificate at the time of this purchase.
GiftCertificateRemainingBalance Decimal The remaining balance on a gift certificate.
GiftCertificateStatus String The status of a gift certificate.
StoreCreditRemainingBalance Decimal Remaining balance of shopper's store credit.

BigCommerce Connector for CData Sync

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication


プロパティ説明
AuthSchemeThe type of authentication to use when connecting to BigCommerce.

OAuth


プロパティ説明
OAuthClientIdカスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecretカスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthAccessTokenOAuth ネットワークへの認証後に受け取ったトークンで、ユーザーにアクセス権を付与します。 アクセストークンはユーザーのログインID とパスワードの代わりに使用され、サーバーに保持されます。
StoreIdThe store hash for this BigCommerce account.

SSL


プロパティ説明
SSLServerCertTLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

Firewall


プロパティ説明
FirewallTypeprovider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServerファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPortプロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUserプロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPasswordプロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

Proxy


プロパティ説明
ProxyAutoDetectprovider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServerHTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPortクライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。
ProxyAuthSchemeProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUserProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPasswordProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxySSLTypeProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
ProxyExceptionsProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

Logging


プロパティ説明
LogModulesログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

Schema


プロパティ説明
Locationテーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemasレポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tablesレポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Viewsレポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Miscellaneous


プロパティ説明
CustomFieldDiscoveryUse this property to specify whether to merge customfields by name or create unique customfields by id to the Products table.
IncludeCustomFieldsA boolean indicating if you would like to include custom fields in the column listing.
MaxRows集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Other特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
PseudoColumnsテーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
RowScanDepthテーブルで利用可能なカラムを探すためにスキャンする行数の最大値。
Timeoutprovider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
UserDefinedViewsカスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
BigCommerce Connector for CData Sync

Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。


プロパティ説明
AuthSchemeThe type of authentication to use when connecting to BigCommerce.
BigCommerce Connector for CData Sync

AuthScheme

The type of authentication to use when connecting to BigCommerce.

解説

  • OAuth: Set this when you want to autheticate using OAuth Credentials Created from BigCommerce App.
  • PersonalAccessToken: Set this when you want to autheticate using OAuthAccess Token generated from BigCommerce UI.

BigCommerce Connector for CData Sync

OAuth

このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。


プロパティ説明
OAuthClientIdカスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecretカスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthAccessTokenOAuth ネットワークへの認証後に受け取ったトークンで、ユーザーにアクセス権を付与します。 アクセストークンはユーザーのログインID とパスワードの代わりに使用され、サーバーに保持されます。
StoreIdThe store hash for this BigCommerce account.
BigCommerce Connector for CData Sync

OAuthClientId

カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。(コンシューマーキーとも呼ばれます。)このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。

解説

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。

BigCommerce Connector for CData Sync

OAuthClientSecret

カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。( コンシューマーシークレット とも呼ばれます。)このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。

解説

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。

BigCommerce Connector for CData Sync

OAuthAccessToken

OAuth ネットワークへの認証後に受け取ったトークンで、ユーザーにアクセス権を付与します。 アクセストークンはユーザーのログインID とパスワードの代わりに使用され、サーバーに保持されます。

解説

OAuth アクセストークンにはサーバーに依存する時間制限があり、ユーザーのアクセスを制限します。これは、OAuthExpiresIn プロパティを使用して設定します。ただし、ユーザーが操作を続けている限り、リクエスト間で再発行することでアクセスを維持することができます。

InitiateOAuth がREFRESH に設定されている場合、OAuthExpiresIn とOAuthTokenTimestamp の両方を設定することを推奨します。 Sync App は、これらのプロパティを使用してトークンの有効期限を判断し、最も効率的にリフレッシュできるようにします。

OAuthExpiresIn およびOAuthTokenTimestamp が指定されていない場合、Sync App はトークンを直ちにリフレッシュします。

BigCommerce Connector for CData Sync

StoreId

The store hash for this BigCommerce account.

解説

The store hash for this BigCommerce account.

BigCommerce Connector for CData Sync

SSL

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。


プロパティ説明
SSLServerCertTLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。
BigCommerce Connector for CData Sync

SSLServerCert

TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります:

説明 例
フルPEM 証明書(例では省略されています) -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。 C:\cert.cer
公開鍵(例では省略されています) -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
MD5 Thumbprint (hex 値はスペースおよびコロン区切り) ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint (hex 値はスペースおよびコロン区切り) 34a929226ae0819f2ec14b4a3d904f801cbb150d

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

BigCommerce Connector for CData Sync

Firewall

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。


プロパティ説明
FirewallTypeprovider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServerファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPortプロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUserプロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPasswordプロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。
BigCommerce Connector for CData Sync

FirewallType

provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Note:デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。

次の表は、サポートされている各プロトコルのポート番号情報です。

プロトコル デフォルトポート 説明
TUNNEL 80 Sync App がBigCommerce への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。
SOCKS4 1080 Sync App がBigCommerce への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。
SOCKS5 1080 Sync App がBigCommerce にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

BigCommerce Connector for CData Sync

FirewallServer

ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

BigCommerce Connector for CData Sync

FirewallPort

プロキシベースのファイアウォールで使用するTCP ポートを指定します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

BigCommerce Connector for CData Sync

FirewallUser

プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

BigCommerce Connector for CData Sync

FirewallPassword

プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

解説

プロキシベースのファイアウォール(またはプロキシファイアウォール)は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。 プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

BigCommerce Connector for CData Sync

Proxy

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。


プロパティ説明
ProxyAutoDetectprovider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServerHTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPortクライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。
ProxyAuthSchemeProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUserProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPasswordProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxySSLTypeProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
ProxyExceptionsProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。
BigCommerce Connector for CData Sync

ProxyAutoDetect

provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。

解説

この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします(プロキシサーバーの詳細を手動で入力する必要はありません)。

この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を手動で構成する場合は、False に設定します。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

BigCommerce Connector for CData Sync

ProxyServer

HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。

BigCommerce Connector for CData Sync

ProxyPort

クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー(ProxyServer 接続プロパティで設定)のTCP ポート。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーポートを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。

その他のプロキシタイプについては、FirewallType を参照してください。

BigCommerce Connector for CData Sync

ProxyAuthScheme

ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。

解説

認証タイプは次のいずれかです。

  • BASIC:Sync App はHTTP BASIC 認証を行います。
  • DIGEST:Sync App はHTTP DIGEST 認証を行います。
  • NTLM:Sync App はNTLM トークンを取得します。
  • NEGOTIATE:Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
  • NONE:ProxyServer が認証を必要としない場合に設定します。

"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

BigCommerce Connector for CData Sync

ProxyUser

ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。

ProxyAuthScheme の値 ProxyUser に設定する値
BASIC プロキシサーバーに登録されているユーザーのユーザー名。
DIGEST プロキシサーバーに登録されているユーザーのユーザー名。
NEGOTIATE プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。
NTLM プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。user@domain またはdomain\user の形式で指定。
NONE ProxyPassword 接続プロパティは設定しないでください。

Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。

BigCommerce Connector for CData Sync

ProxyPassword

ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。

ProxyAuthScheme の値 ProxyPassword に設定する値
BASIC ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
DIGEST ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
NEGOTIATE ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NTLM ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NONE ProxyPassword 接続プロパティは設定しないでください。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。ProxyAutoDetect がTrue に設定されている場合(デフォルト)、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。

BigCommerce Connector for CData Sync

ProxySSLType

ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。

AUTOデフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。
ALWAYS接続は、常にSSL 有効となります。
NEVER接続は、SSL 有効になりません。
TUNNEL接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。

BigCommerce Connector for CData Sync

ProxyExceptions

ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

解説

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。

BigCommerce Connector for CData Sync

Logging

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。


プロパティ説明
LogModulesログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。
BigCommerce Connector for CData Sync

LogModules

ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

解説

このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。 ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。 各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。

例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。 複数のモジュールを含めるには、次のように名前をセミコロンで区切ります:INFO;EXEC;SSL。

Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。 利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。

利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログ の「高度なログの記録」セクションを参照してください。

BigCommerce Connector for CData Sync

Schema

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。


プロパティ説明
Locationテーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemasレポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tablesレポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Viewsレポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。
BigCommerce Connector for CData Sync

Location

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。

解説

Location プロパティは、定義をカスタマイズしたり(例えば、カラム名を変更する、カラムを無視するなど)、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

指定しない場合、デフォルトの場所は%APPDATA%\\CData\\BigCommerce Data Provider\\Schema となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます:

プラットフォーム %APPDATA%
Windows APPDATA 環境変数の値
Linux ~/.config

BigCommerce Connector for CData Sync

BrowsableSchemas

レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

BigCommerce Connector for CData Sync

Tables

レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。

解説

データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。

BigCommerce Connector for CData Sync

Views

レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

解説

データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。 接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。 例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

Note:複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。

BigCommerce Connector for CData Sync

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。


プロパティ説明
CustomFieldDiscoveryUse this property to specify whether to merge customfields by name or create unique customfields by id to the Products table.
IncludeCustomFieldsA boolean indicating if you would like to include custom fields in the column listing.
MaxRows集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Other特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
PseudoColumnsテーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
RowScanDepthテーブルで利用可能なカラムを探すためにスキャンする行数の最大値。
Timeoutprovider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
UserDefinedViewsカスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
BigCommerce Connector for CData Sync

CustomFieldDiscovery

Use this property to specify whether to merge customfields by name or create unique customfields by id to the Products table.

解説

  • ByID: Set this when you want to create a unique customfields name by comparing the Ids of the custom fields. There are different customfields added for the various products as the customfields Id is unique across products.
  • ByName: Set this when you want to create customfields by name.

BigCommerce Connector for CData Sync

IncludeCustomFields

A boolean indicating if you would like to include custom fields in the column listing.

解説

Setting this to true will cause custom fields to be included in the column listing, but may cause poor performance when listing metadata.

BigCommerce Connector for CData Sync

MaxRows

集計やGROUP BY を使用しないクエリで返される最大行数を指定します。

解説

このプロパティは、集計やGROUP BY 句を含まないクエリに対してSync App が返す行数の上限を設定します。 この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。

このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。

BigCommerce Connector for CData Sync

Other

特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。

解説

このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。 これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。 複数のプロパティをセミコロン区切りのリストで定義できます。

Note: 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット

DefaultColumnSizeデータソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename基底のソケットデータ転送を指定のファイルに記録します。

BigCommerce Connector for CData Sync

PseudoColumns

テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。

解説

このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。

個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"

すべてのテーブルのすべての擬似カラムを含めるには、次のようにします:"*=*"

BigCommerce Connector for CData Sync

RowScanDepth

テーブルで利用可能なカラムを探すためにスキャンする行数の最大値。

解説

テーブルのカラムはテーブル行をスキャンすることで決定される必要があります。この値はスキャンされる行数の最大値を設定します。

大きい値を設定すると、パフォーマンスが低下する場合があります。小さい値を設定すると、特にnull データがある場合には、データ型を正しく判定できない場合があります。

BigCommerce Connector for CData Sync

Timeout

provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。

解説

このプロパティは、Sync App が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。 操作の完了前にタイムアウト時間が経過すると、Sync App は操作をキャンセルして例外をスローします。

タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。

このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。 このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

BigCommerce Connector for CData Sync

UserDefinedViews

カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

解説

このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。 これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。


{
	"MyView": {
		"query": "SELECT * FROM Customers WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。 例:UserDefinedViews=C:\Path\To\UserDefinedViews.json。 このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。

詳しくは、ユーザー定義ビュー を参照してください。

Copyright (c) 2025 CData Software, Inc. - All rights reserved.
Build 24.0.9175