BizTalk でBigCommerce にストアドプロシージャを実行する
CData BizTalk Adapter が提供するストアドプロシージャを使用して、BizTalk のBigCommerce を自動化できます。ストアドプロシージャは、基盤となるAPI で使用できるアクションを実装しています。
加藤龍彦
デジタルマーケティング
最終更新日:2021-07-17
こんにちは!ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。
ストアドプロシージャは、SELECT 、INSERT 、UPDATE 、DELETE としては表すことができないBigCommerce アクションを実装します。この記事では、ストアドプロシージャ用のスキーマを作成する方法を説明します。このスキーマを使用して、送信ポートからストアドプロシージャを実行できます。
プロジェクトにアダプターを追加する
[Add Adapter] ウィザードから、アダプターをVisual Studio のBizTalk サーバープロジェクトに追加します。このアダプターは、ストアドプロシージャへの入力とその結果に関するメタデータを返します。このメタデータを使用してスキーマを作成します。
- [Solution Explorer] の[project] で右クリックし、[Add] -> [Add Generated Items] と進みます。
- [resulting dialog box] の[Add Adapter Metadata] を選択します。
- 表示される[Add Adapter] ウィザードで、リストからアダプターを選択します。
- [Port menu] では、選択を空白のままにします。もしくは、BigCommerce アダプターを使用するように構成されている受信場所や送信ポートを選択します。
送信ポートまたは受信場所に、認証資格情報と他の接続プロパティが構成されていない場合、[Connection String] ページで、それらを入力します。下は一般的な接続文字列です。
OAuthClientId=YourClientId; OAuthClientSecret=YourClientSecret; StoreId='YourStoreID'; CallbackURL='http://localhost:33333'
BigCommerce 認証は標準のOAuth フローに基づいています。
Store ID の取得
BigCommerce Store に接続するには、StoreId が必要です。Store Id を確認するには、以下の手順に従ってください。
- BigCommerce アカウントにログインします。
- ホームページから「Advanced Settings」->「API Accounts」 を選択します。
- 「Create API Account」->「Create V2/V3 API Token」をクリックします。
- 画面にAPI Path という名前のテキストボックスが表示されます。
- テキストボックス内に、次の構造のURL が表示されます:https://api.bigcommerce.com/stores/{Store Id}/v3。
- 上記で示したように、Store Id は'stores/' と'/v3' パスパラメータの間にあります。
- Store Id を取得したら、「キャンセル」 をクリックするか、まだ持っていない場合はAPI Account の作成に進むことができます。
パーソナルアクセストークンの取得
加えて、自分のデータをテストおよびアクセスするには、個人用トークンを取得する必要があります。個人用トークンを取得する方法は次のとおりです。
- BigCommerce アカウントにログインします。
- ホームページから「Advanced Settings」->「API Accounts」 を選択します。
- 「Create API Account」->「Create V2/V3 API Token」をクリックします。
- アカウント名を入力します。
- 作成するAPI Account の「OAuth Scopes」を選択します。CData 製品 は"None" とマークされたデータにアクセスできません。また、"read-only"
とマークされたデータを変更できません。
- 「保存」をクリックします。
BigCommerce への認証
次に、以下を設定してデータに接続できます。
- StoreId:API Path テキストボックスから取得したStore ID に設定。
- OAuthAccessToken:生成したトークンに設定。
- InitiateOAuth:OFF に設定。
スキーマを作成する
[Add Adapter] ウィザードで接続プロパティを入力すると、[Schema] ウィザードが表示されます。
- 次の[Schema Information] のページでは、BigCommerce アダプターを使用するために構成した送信ポートを選択します。
- CData BigCommerce アダプターが要請応答送信ポートで構成されている場合、[One-Way] オプションを無効にします。
- [Command Type] メニューで、ストアドプロシージャを選択します。
- メニューからストアドプロシージャを選択し、インプットパラメータの値を入力します。
- ウィザードで表示される概要の設定を確認して[Finish] をクリックし、schema.xsd ファイルを作成します。
スキーマを処理する
BizTalk アプリでスキーマを使用する際は、こちらのチュートリアルをご覧ください。