Crystal Reports にBigCommerce を連携してBigCommerce データを使った帳票を作成

Crystal Reports には、ODBC 標準向けのサポートが組み込まれています。CData ODBC Driver for BigCommerce は、Crystal Reports でレポート作成ウィザードやその他のツールを使ってBigCommerce へのアクセスを可能にします。この記事では、BigCommerce の機能を持つシンプルな帳票を作成する方法を説明します。

BigCommerce データに接続

下記の手順に従って、レポート作成ウィザードを使ってBigCommerce 接続を作成します。

1. ODBC 接続プロパティの指定がまだの場合は、DSN （データソース名）の設定を行います。Microsoft ODBC データソースアドミニストレーターを使ってODBC DSN を作成および設定できます。一般的な接続プロパティは以下のとおりです：
   • OAuthClientId
   • OAuthClientSecret
   • StoreId
   • CallbackURL

   Microsoft ODBC データソースアドミニストレーターで必要なプロパティを設定する方法は、ヘルプドキュメントの「はじめに」をご参照ください。

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

   BigCommerce への認証

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

2. 新しい帳票で、［Create New Connection］>［ODBC］をクリックします。

3. ウィザードが表示されたら［Select Data Source］をクリックし、［Data Source Name］メニューでDSN を選択します。

BigCommerce データに連携する帳票をデザイン

ODBC 接続をBigCommerce に追加したら、レポート作成ウィザードを使ってBigCommerce を帳票に追加できます。

1. 帳票に必要なテーブルやフィールドを選択して、データソースを設定します。この例では、Customers テーブルのFirstName およびLastName カラムを使います。

2. チャートの種類を設定。 例えば、LastName をFirstName で表すシンプルなチャートを作成します。 ウィザードを完了すると、Crystal Reports はBigCommerce に実行されるSQL クエリをビルドします。ドライバーは、リアル隊うBigCommerce に対してクエリを実行します。

3. 必要に応じて、ほかのフィルタやレポートテンプレートを設定します。

4. データのインポートが終わったら、レポートフィールドをサマライズもしくはソートするチャートやレポートオブジェクトを作成できます。［Insert］>［Chart］をクリックして、チャートエキスパートを開きます。Total LastName by FirstName を表すグラフを作成するには、FirstName を［On Change Of］メニューセレクションの下のボックスに追加してからLastName を［Show Values］の下のボックスに追加します。

完成した帳票をプレビューして、チャートにデータが入っていることを確認します。Null 値を取り除きたい場合は、SelectionFormula を使います。