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

Dibyendu Datta
Dibyendu Datta
Lead Technology Evangelist
レポートウィザードを使用して、Shopify のデータに基づいたレポートを作成します。

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

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

アプリケーション名バージョン
SAP Crystal Reports 2020SP3
JDBC Driver23.0.8565

JDBC Driver のデプロイ

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

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

CRConfig.xml ファイルにJDBC ファイルパスを追加

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

Shopify のデータに接続

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

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

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

    java -jar cdata.jdbc.shopify.jar

    それでは、Shopify への接続・認証について説明していきましょう。Shopify では、アクセストークンとOAuth の2つの接続方法をサポートしています。

    アクセストークンによる接続

    アクセストークン経由の接続には、以下の2つのステップが必要です。

    1. Shopify の管理画面でアクセストークンを作成
    2. アクセストークンを使用して認証

    アクセストークンの作成

    まず、アプリを登録してアクセストークンを取得してみましょう。手順は以下のとおりです。

    1. 管理画面からShopify にログインし、Apps → Apps and sales channels に進みます
    2. Develop apps をクリックしてCreate an app を選択します
    3. Overview タブのConfiguration で、Admin API integration をクリックし、アプリに許可するストアのアクセス権を選択してください。CData製品が必要とするAdmin API 権限については、 href="/kb/help/" target="_blank">ヘルプドキュメントの「はじめに」セクションをご確認ください
    4. Save をクリックします
    5. Overview タブのConfiguration で、Storefront API integration をクリックし、アプリに許可するストアのアクセス権を選択します。CData製品が必要とするStorefront API 権限は以下のとおりです：
      • unauthenticated_read_content
    6. Save をクリックします
    7. API Credentials を選択します
    8. "Access tokens" の下でInstall app をクリックします。これでアクセストークンが作成されます
    9. Admin API Access token のアクセストークンをコピーします。注意：トークンの公開およびコピーは1回のみ可能ですので、必ず保存してください

    アクセストークンによる認証

    続いて、アクセストークンで認証するには、以下のプロパティを設定してください。

    • AuthScheme：AccessToken に設定
    • AccessToken：カスタムアプリからコピーしたアクセストークンの値に設定

    OAuth 認証を介した接続については、ヘルプドキュメントの「OAuth 認証の使用」をご確認ください。

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

    組み込みの接続文字列デザイナーを使用してJDBC URL を生成（例はSalesforce）

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

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

    jdbc:shopify:AppId=MyAppId;Password=MyPassword;ShopUrl=https://yourshopname.myshopify.com;

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

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

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

チャートの作成

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

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

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

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

はじめる準備はできましたか？

Shopify Driver の無料トライアルをダウンロードしてお試しください：

 ダウンロード

詳細：

Shopify Icon Shopify JDBC Driver お問い合わせ

Shopify EC データに連携するJava アプリケーションを素早く、簡単に開発できる便利なドライバー。

この記事の内容

関連記事