BizTalk でBigCommerce にストアドプロシージャを実行する

こんにちは！ウェブ担当の加藤です。マーケ関連のデータ分析や整備もやっています。

ストアドプロシージャは、SELECT 、INSERT 、UPDATE 、DELETE としては表すことができないBigCommerce アクションを実装します。この記事では、ストアドプロシージャ用のスキーマを作成する方法を説明します。このスキーマを使用して、送信ポートからストアドプロシージャを実行できます。

プロジェクトにアダプターを追加する

［Add Adapter］ ウィザードから、アダプターをVisual Studio のBizTalk サーバープロジェクトに追加します。このアダプターは、ストアドプロシージャへの入力とその結果に関するメタデータを返します。このメタデータを使用してスキーマを作成します。

1. ［Solution Explorer］ の［project］ で右クリックし、［Add］ -> ［Add Generated Items］ と進みます。
2. ［resulting dialog box］ の［Add Adapter Metadata］ を選択します。
3. 表示される［Add Adapter］ ウィザードで、リストからアダプターを選択します。
4. ［Port menu］ では、選択を空白のままにします。もしくは、BigCommerce アダプターを使用するように構成されている受信場所や送信ポートを選択します。

5. 送信ポートまたは受信場所に、認証資格情報と他の接続プロパティが構成されていない場合、［Connection String］ ページで、それらを入力します。下は一般的な接続文字列です。

   OAuthClientId=YourClientId; OAuthClientSecret=YourClientSecret; StoreId='YourStoreID'; CallbackURL='http://localhost:33333'

   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」を選択します。CData 製品 は"None" とマークされたデータにアクセスできません。また、"read-only" とマークされたデータを変更できません。
   6. 「保存」をクリックします。

   BigCommerce への認証

   次に、以下を設定してデータに接続できます。
   • StoreId：API Path テキストボックスから取得したStore ID に設定。
   • OAuthAccessToken：生成したトークンに設定。
   • InitiateOAuth：OFF に設定。

スキーマを作成する

［Add Adapter］ ウィザードで接続プロパティを入力すると、［Schema］ ウィザードが表示されます。

1. 次の［Schema Information］ のページでは、BigCommerce アダプターを使用するために構成した送信ポートを選択します。
2. CData BigCommerce アダプターが要請応答送信ポートで構成されている場合、［One-Way］ オプションを無効にします。
3. ［Command Type］ メニューで、ストアドプロシージャを選択します。
4. メニューからストアドプロシージャを選択し、インプットパラメータの値を入力します。
5. ウィザードで表示される概要の設定を確認して［Finish］ をクリックし、schema.xsd ファイルを作成します。

スキーマを処理する

BizTalk アプリでスキーマを使用する際は、こちらのチュートリアルをご覧ください。