SAP Crystal Reports で GMO MakeShop ののデータをレポートに出力

Crystal Reports にはリモートデータへのデータ処理をオフロードするためのさまざまなオプションが用意されており、リアルタイムレポートを実現できます。Crystal Reports がJDBC に対応しているため、CData JDBC Driver for GMO MakeShop によってこの機能をCrystal Reports で利用できるようになります。この記事では、レポート実行時にデータを更新するGMO MakeShop のデータレポートを作成する方法を紹介します。

以下の表は、この記事で使用するツールとバージョンです。

JDBC Driver のデプロイ

Crystal Reports のクラスパスにドライバーJAR を含めて、CData JDBC Driver for GMO MakeShop をインストールします。DataDriverCommonElement の下にあるClassPath 要素のパスに、.jar を含むフルファイルパスを追加します。

CRConfig.xml ファイルのデフォルトの場所はC:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\java ですが、インストールによって多少異なる場合があります。ドライバーJAR はインストールディレクトリのlib サブフォルダにあります。

ClassPath にJAR を追加したら、Crystal Reports を再起動します。

GMO MakeShop のデータに接続

GMO MakeShopのJDBC Driver をデプロイしたら、レポートウィザードを使用して新しいレポートにGMO MakeShop のデータを追加できます。

1. File -> New -> Standard Report をクリックします。
2. Create New Connection の下にあるJDBC (JNDI) を展開し、Make a New Connection をダブルクリックします。
3. CData JDBC Driver for GMO MakeShop を使用して接続文字列を作成します。

JDBC URL の構成については、GMO MakeShop JDBC Driver に組み込まれている接続文字列デザイナーを使用してください。JAR ファイルをダブルクリックするか、コマンドラインからjar ファイルを実行します。

java -jar cdata.jdbc.gmomakeshop.jar

GMO MakeShop に接続するには、MembersAccessCode、OrdersAccessCode、ProductsAccessCode、およびShopId が必要です。

GMO MakeShop へのアクセスの設定

MembersAccessCode、OrdersAccessCode、ProductsAccessCode、およびShopId を取得するには、以下の手順に従ってください。

• GMO MakeShop には各API のAccessCode が必要です。
• GMO MakeShop Store Manager にログインし、メニューの「ショップ作成」をクリックします。
• 左ナビゲーションメニューの「外部システム連携」から任意の連携対象設定ををクリックします（メニューに表示されない場合は別途GMO MakeShop にご確認ください）。
• 商品データ連携設定の場合：認証コードの「発行」ボタンをクリックし、ProductsAccessCode を取得します。
• 注文データ連携設定の場合：最初に「注文情報参照」と「注文情報変更」の設定を選択します。選択後、認証コードの「発行」ボタンをクリックし、OrdersAccessCode を取得します。
• 会員データ連携設定の場合：最初に「会員情報の（参照・登録・変更・削除）」の設定を選択します。選択後、認証コードの「発行」ボタンをクリックし、MembersAccessCode を取得します。
• 会員認証連携設定の場合：認証コードの「発行」ボタンをクリックし、ProductsAccessCode を取得します。

GMO MakeShop アカウントの認証

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

• ShopId：接続先のGMO MakeShop Store ID を設定。GMO MakeShop Store ID はログイン用の ID と同じです。
• OrdersAccessCode：「注文データ連携設定」から取得した「認証コード」を設定。このプロパティは Orders テーブルにアクセスする場合に必要です。
• ProductsAccessCode：「商品データ連携設定」から取得した「認証コード」を設定。このプロパティは Products テーブルにアクセスする場合に必要です。
• MembersAccessCode：「会員データ連携設定」から取得した「認証コード」を設定。このプロパティは Members テーブルにアクセスする場合に必要です。
• MemberAuthenticationCode：「会員認証連携設定」から取得した「認証コード」を設定。このプロパティは MemberAuthenticationConfirm を実行する場合に必要です。
• Password：GMO MakeShop Store Manager のログインユーザーのパスワードを指定。このプロパティは ProductCategoryRegistrationOrModification,ProductMemberGroupPriceRegistrationOrModification,ProductOptionRegistrationOrModification,ProductRegistrationOrModification を実行する場合に必要です。

接続プロパティを入力し、接続文字列をクリップボードにコピーします。



JDBC URL を設定する際に、Max Rows 接続プロパティを設定することもできます。これにより返される行数が制限され、レポートやビジュアライゼーションをデザインする際のパフォーマンス向上に役立ちます。

4. ウィザードでJDBC 接続URL を入力します。

   jdbc:gmomakeshop:ShopId=MyShopId;ProductsAccessCode=MyProductsAccessCode;MembersAccessCode=MyMembersAccessCode;OrdersAccessCode=MyOrdersAccessCode;
   

5. ドライバークラス名を設定します。

   cdata.jdbc.gmomakeshop.GMOMakeShopDriver
   

   
6. レポートに必要なテーブルを選択します。
7. SAP Crystal Reports でGMO MakeShop のデータのテーブルをリンクすることもできます。テーブル間のリンクを追加したら、NEXT をクリックします。
8. テーブルを選択したら、選択したテーブルからレポートに表示するフィールドを選び、NEXT をクリックします。
9. レポート上の情報をグループ化するために「Group By」フィールドを選択します。
10. 集計合計に基づいてグループを並べ替え、NEXT をクリックします。

その後、グループ化、並べ替え、集計を設定できます。集計とサマリーを使用してチャートを作成するには、次のセクションを参照してください。

チャートの作成

グループ化するカラムを選択した後、標準レポート作成ウィザードでチャートを作成するオプションが表示されます。以下の手順に従って、BrandCode カラムの値を集計するチャートを作成します。

1. 標準レポート作成ウィザードで、Bar Chart オプションを選択し、「On change of」メニューでグループ化したカラムを選択します。
2. Show Summary メニューで、作成した集計を選択します。
3. 必要に応じてフィルターとテンプレートを選択し、ウィザードを完了します。

レポートのテンプレートを選択すると、完成したレポートをプレビューし、データが入力されたチャートを表示できます。

完成したレポート

レポートに最初に指定したすべてのフィールドが含まれていることを確認できます。

リモートデータの操作

データの更新を確認するには、File をクリックし、「Save Data with Report」オプションをオフにします。レポートを操作すると（例えば、詳細にドリルダウンすると）、Crystal Reports はレポートの表示に必要なデータを取得するためにSQL クエリを実行します。すでに取得したデータを再読み込みするには、レポートを更新または再実行します。

詳細要素を非表示にし、サーバー側グループ化を有効にすることで、ドライバーに処理をオフロードできます。これを行うには、レポート作成ウィザードでグループ化するカラムを選択する必要があります。

1. File -> Report Options をクリックし、「Perform Grouping On Server」オプションを選択します。
2. Report -> Section Expert をクリックし、レポートのDetails セクションを選択します。「Hide (Drill-Down OK)」オプションを選択します。

詳細を非表示にしてレポートをプレビューすると、Crystal Reports はGROUP BY クエリを実行します。チャートのカラムをダブルクリックして詳細にドリルダウンすると、Crystal Reports は必要なデータのみを取得するSELECT WHERE クエリを実行し、読み込み時間を短縮します。

これで、SAP Crystal Reports とCData JDBC Driver を使用して、GMO MakeShop のデータに基づくSAP Crystal レポートが作成できました。CData JDBC Driver for GMO MakeShop の詳細と無料トライアルのダウンロードについては、GMO MakeShop JDBC Driver ページをご覧ください。ご不明な点がございましたら、サポートチームまでお問い合わせください。