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

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



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

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

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

JDBC Driver のデプロイ

Crystal Reports のクラスパスにドライバーJAR を含めて、CData API Driver for JDBC をインストールします。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 を再起動します。

Google Translate のデータに接続

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

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

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

    java -jar cdata.jdbc.api.jar

    認証

    Google Cloud Translation API では、翻訳サービス、データセット、用語集、適応型 MT リソースへの安全なアクセスを確保するために、OAuth 2.0 認証が必要です。この認証方式により、Google Cloud プロジェクトに安全に接続し、適切な認可のもとで翻訳リソースを管理できます。

    OAuth 2.0 のセットアップと設定

    ステップ 1：Google Cloud プロジェクトの作成と API の有効化

    OAuth 認証をセットアップするには、以下のステップで進めます：

    1. Google Cloud Console にアクセスします
    2. 新しいプロジェクトを作成するか、既存のプロジェクトを選択します
    3. Project ID を控えておきます（すべての API 呼び出しで必要です）
    4. 「APIs & Services」 > 「Library」に移動します
    5. 「Cloud Translation API」を検索して有効化します
    6. 「APIs & Services」 > 「Credentials」に移動します
    7. 「Create Credentials」をクリックし、「OAuth Client ID」を選択します
    8. プロンプトが表示されたら OAuth 同意画面を設定します
    9. 用途に応じて「Desktop application」または「Web application」を選択します
    10. 承認済みリダイレクト URI（CallbackURL）を設定します
    11. 接続で使用する Client ID と Client Secret をコピーします

    必須の接続プロパティ

    • AuthScheme：OAuth に設定します（必須）
    • OAuthClientId：Google Cloud Console の Client ID（必須）
    • OAuthClientSecret：Google Cloud Console の Client Secret（必須）
    • CallbackURL：OAuth アプリケーションで指定したリダイレクト URI（必須）
    • InitiateOAuth：トークンを自動管理するには GETANDREFRESH に設定します（推奨）
    • ProjectId：Google Cloud のプロジェクト ID またはプロジェクト番号（クエリに必須）

    必須の OAuth スコープ

    Google Cloud Translation API プロファイルでは、以下の OAuth スコープが必要です：

    • https://www.googleapis.com/auth/cloud-translation - 翻訳、データセット、用語集、適応型 MT を含む Cloud Translation API リソースへのフルアクセス

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

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

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

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

    jdbc:api:Profile=C:\profiles\GoogleTranslate.apip;AuthScheme=OAuth;InitiateOAuth=GETANDREFRESH;OAuthClientId=your_client_id;OAuthClientSecret=your_client_secret;CallbackUrl=your_callback_url;

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

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

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

チャートの作成

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

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

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

API Driver で Google Translate のライブデータに接続

Google Translate に接続

この記事の内容

関連記事