差し込み印刷レポート

概要

差し込み印刷機能は、事前に定義されたテンプレートにデータレコードを適用することにより、一度に複数の文書を生成する方法です。ActiveReportsJSでは、さまざまな方法を使用して差し込み印刷レポートを作成できます。文書のテンプレートをHTMLフラグメントとして表現できる場合、MixedFormatTextコントロールをListデータ領域と一緒に使用して、このようなレポートを作成できます。差し込み印刷レポートの例としては、レター、クーポンなどがあります。

このチュートリアルでは、クーポンコード一覧を含むレポートを作成する手順を説明します。

• 新しいレポートを作成する

• レポートをデータ連結しデータセットを追加する

• Listデータ領域を追加する

• Listデータ領域を構成する

• リストをグループ化する

• MixedFormatTextコントロールを追加する

前提条件

次の内容は、デザイナアプリを使用することを前提としています。詳細については、チュートリアルを参照してください。また、データソースとして利用するGrapeCity Data Serviceにアクセスするには、インターネット接続環境が必要です。

新しいレポートを作成する

デザイナアプリにて、［ファイル］メニューをクリックし、 ［RDLレポート］ を選択して、新しいレポートを作成します。デザイン面の周囲にあるグレーの領域をクリックし、表示されるより、 ［余白］ セクションの ［スタイル］ に 「狭い」 を設定し、余白を設定します。

レポートをデータ連結しデータセットを追加する

レポートとデータの接続を行うため、データ連結を行います。このチュートリアルでは、データソースとして「GrapeCity Data Service」のContoso Retail Data Serviceを使用します。

• データソースを追加する

  
  

  データに接続するため、「Contoso Retail Data Service」のWebAPIを使用します。このチュートリアルではDimPromotionsのデータを使用します。データソースを作成するには、次の手順を実行します。

  • データタブを開き、 ［データソース］ の横の ［+ 追加］ アイコンをクリックします。

  • ［データソースの編集］ ダイアログで、 ［名前］ に 「Contoso」 と入力し、 ［エンドポイント］ に 「https://demodata-jp.grapecity.com/contoso/odata/v1」 と入力します。

  • ［変更を保存］ ボタンをクリックします。

• データセットを追加する

  
  

  データセットは、データソースの1つ以上のエンドポイントを表します。このチュートリアルでは「クーポンコード一覧」を作成するため、先ずDimPromotionsの値を取得します。以下の手順に従って Promotions データセットを追加します。

  • データタブをクリックし、 「Contoso」 データソースの横の ［+ 追加］ アイコンをクリックします。

  • ［新規データセット］ ダイアログで、 ［名前］ に 「Promotions」 と入力、 ［URI/パス］ に 「/DimPromotions」 と入力し、 ［JSONパス］ に 「$.value.*」 と入力します。

  • そのままですと 「Promotions」 には不要なデータが含まれています。以下のようにクエリパラメータを使用して必要なフィールドのみ取得します。

    • ［パラメータ］ の右側にある ［+ 項目追加］ アイコンをクリックします。

    • 新しく追加された［パラメータ］に 「$select」 と入力します。

    • ［値］ に 「PromotionKey, PromotionName, DiscountPercent, StartDate, EndDate」 と入力します。

  • ［検証］ ボタンをクリックします。

  • ［データベースフィールド］ に ［5項目］ というテキストが表示されていることを確認します。

  • ［データベースフィールド］ セクションを展開し、 ［StartDate］ フィールドのDataFieldプロパティを 「StartDate[Date]」 に、 ［EndDate］ フィールドのDataFieldプロパティを 「EndDate[Date]」 に設定します。

  • ［変更を保存］ ボタンをクリックします。

Listデータ領域を追加する

クーポンコード一覧を表示するには、Listデータ領域を使用します。

• ツールバーの左側のツールボックスからListコントロールをドラッグ＆ドロップしてレポートの左上隅に配置します。

• 配置したListを選択します。

• ［データセット名］ プロパティにドロップダウンリストから ［Promotions］ を選択し、 ［幅］ プロパティを 「7.5in」 に設定します。これによってBandedListはレポートのページサイズと余白によって定義されるレポートの印刷可能領域に適合します。

• ［高さ］ プロパティを 「5in」 に設定します。

• ［データ］ セクションの［フィルタ］プロパティの横の ［+ 追加］ アイコンをクリックします。

• ［+ 追加］ ボタンをクリックし、リストから ［DiscountPercent］ を選択します。

• フィルタ演算子では 「>」 を選択し、右側にあるテキスト領域に 「0」 と入力します。

リストをグループ化する

各クーポンコードを別々のページに表示するには、リストをグループ化します。

• ［←］ アイコンをクリックし、 ［フィルタ］ エディタを終了します。

• ［グループ］ セクションの［式］プロパティの右側にあるリストアイコンをクリックします。

• 新しく追加された項目の右側にあるグレーのボックスをクリックし、ドロップダウンリストで 「PromotionKey」 を選択します。

• ［改ページ］ プロパティを 「Between」 に設定します。

MixedFormatTextコントロールを追加する

MixedFormatTextコントロールを使用して、クーポンコードの詳細を表示します。

• ツールバーの左側のツールボックスからMixedFormatTextコントロールをドラッグ＆ドロップしてListデータ領域の左上隅に配置します。

• 配置したMixedFormatTextをクリックし、以下のプロパティを設定します。

［値］ プロパティの右側にあるグレーのボックスをクリックし、 ［式］ を選択します。式エディタでは次の値を設定し、 ［保存］ ボタンをクリックします。

<h2 style="text-align:center;">{PromotionName}</h2>
<h1 style="color:red;text-align:center;>{Format(DiscountPercent, "P0")} OFFクーポン<sup>*</sup></h1>
<h3 style="text-align:center;"><sup>*</sup>利用期間： <b>{Format(StartDate, "d")}</b> ～ <b>{Format(EndDate, "d")}</h3>
<p style="text-align:justify;"><sup>*</sup>ほかのクーポンとの併用はできません。</p>
<p style="text-align:justify;"><sup>*</sup>クーポンコードには金銭的な価値はありません。</p>
<p style="text-align:justify;"><sup>*</sup>Northwind Tradersは、クーポンをいつでも中止する権利を留保します。</p>

サポートされているHTMLタグとCSSスタイルの完全なリストについては、MixedFormatTextを参照してください。

レポートを表示する

レポートをプレビューし、クーポンコードのリストをナビゲートできます。レポートを印刷したり、PDFにエクスポートしたりできます。 ［改ページ］ プロパティを 「Between」 に設定したので、各クーポンは別々のページに表示されます。