wrc designer 導入ガイドƒーコードのバイナリデータについて.....130...

134
WRC Designer 導入ガイド

Upload: lekhanh

Post on 29-May-2018

262 views

Category:

Documents


1 download

TRANSCRIPT

WRC Designer 導入ガイド

目次 2

Copyright(C) SIOS Technology, Inc.

目次

第1章 はじめに............................................................................. 5

Designer.................................................................................................................................................. 5 Engine....................................................................................................................................................... 5 Server....................................................................................................................................................... 5 Print Client (Java版のみ)........................................................................................................ 5

第 2 章 Designerのインストール ........................................... 6

Javaモード データベース接続設定 ..........................................................................................10 サンプルデータベースの設定 .......................................................................................................12 ● Javaモード ....................................................................................................................................15 ◆ 帳票フォーム読み込みテスト(CSVデータソース) ........................ 15 ◆ Javaモード PDFプレビューテスト(CSVデータソース ) ................. 17 ◆ Javaモード PDFプレビューテスト(SQLデータソース) ................... 18

● .NETモード ....................................................................................................................................19 ◆ 帳票フォーム読み込みテスト......................................... 19 ◆ .NETモード PDFプレビューテスト .................................... 21

イメージプレビューテスト(Javaモード/.NETモード共通)....................................................23 ダイレクト印刷テスト(Javaモード/.NETモード共通) .............................................................24 Designerのアンインストール ..........................................................................................................25

第 3 章 はじめての帳票作成.................................................26

WRC Designerを用いた帳票フォーム作成 ...............................................................................27 Step 1 レポートプロパティの設定 ....................................... 27 Step 2 ヘッダー情報の作成............................................. 29 Step 3 ディテール情報の作成........................................... 32 Step 4 フッター情報の作成............................................. 34 Step 5 PDFプレビュー.................................................. 36

第 4 章イメージファイルから帳票フォームを作成する...37

概要 .........................................................................................................................................................37 動的セクションレイヤーと固定フォームレイヤー .....................................................................37 イメージファイルから帳票フォームを作成する手順 ...............................................................39 Step 1 帳票イメージ画像の準備 .......................................... 39 Step 2 イメージファイルの解析 .......................................... 40 Step 3 レポートプロパティの設定 ........................................ 41 Step 4 固定フォームレイヤーの編集 ...................................... 42 Step 5 動的セクションレイヤーの編集 .................................... 45 Step 6 PDFプレビュー................................................... 48

目次 3

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成

.............................................................................................................49

概要 .........................................................................................................................................................49 下絵イメージファイルから帳票フォームを作成する手順 .....................................................49 Step 1 下絵イメージ画像の準備 .......................................... 49 Step 2 下絵イメージファイルの読み込み .................................. 50 Step 3 レポートプロパティの設定 ........................................ 51 Step 4 固定フォームレイヤーの編集 ...................................... 51 Step 5 動的セクションレイヤーの編集 .................................... 54 Step 6 PDFプレビュー................................................... 54

第 6 章 いろいろな帳票サンプル .........................................55

製品別売上リスト .................................................................................................................................56 製品別売上リスト 2 .............................................................................................................................59 社員別見積リスト 1 .............................................................................................................................62 社員別見積リスト 2 .............................................................................................................................66 社員別見積リスト 2(あふれデータ設定) ...................................................................................70 見積書 1 .................................................................................................................................................72 見積書 2 .................................................................................................................................................75 XML Schemaファイルを使用したPDF生成 ..................................................................................78 複数のCSVファイルを使用したPDF生成(Javaモードのみ) .................................................81 製品見積リスト ......................................................................................................................................83 製品売上リスト(しおり付き) ............................................................................................................86 見積ラベル ............................................................................................................................................89 販売予定表 ...........................................................................................................................................93 社員別見積実績リスト .......................................................................................................................96 御見積票(正、副綴り) ......................................................................................................................99 中国漢字、ハングル文字対応帳票 .......................................................................................... 102 複数ページの帳票レイアウト ....................................................................................................... 105 部署別実績リスト .............................................................................................................................. 108 PDFフォームを利用した見積書 ................................................................................................... 111

第 7 章 帳票フォーム(XMLファイル) ................................ 115

も簡単な帳票フォーム............................................................................................................... 115 オブジェクトを追加した帳票フォーム ....................................................................................... 116 オブジェクトの種類 .......................................................................................................................... 117

補足説明 ...................................................................................... 121

◆ Javaモードと.NETモードの切り替え方法......................................................................... 121 ◆ Javaモードと.NETモードの差異について ....................................................................... 121

目次 4

Copyright(C) SIOS Technology, Inc.

◆ フォントについて ....................................................................................................................... 121 ◆ イメージ及びJAIについて(Javaモードのみ) ................................................................ 122 ◆ オブジェクトの位置、幅、高さなどの指定について ..................................................... 122 ◆ サブレポート内でのグループセクションの利用について .......................................... 122 ◆ サブレポート機能の入れ子について ................................................................................ 122 ◆ SQLのコメントについて ............................................................................................................ 122 ◆ 外字フォントの埋め込み機能について............................................................................ 123 ◆ ページヘッダー及びページフッター使用時の注意事項 .......................................... 123 ◆ 下絵機能の注意事項 ............................................................................................................. 123 ◆ 中国語及び韓国語対応について...................................................................................... 124 ◆ データ定義 XMLファイルとCSVファイルについて ......................................................... 125 データ定義XML作成方法................................................. 125 データ定義CSV作成方法 (Javaモードのみ) ............................. 129

◆ しおりについて(Javaモードのみ)...................................................................................... 130 ◆ 非定型用紙へのダイレクト印刷について ........................................................................ 130 ◆ PDF417 バーコードのバイナリデータについて .............................................................. 130 ◆ その他 ........................................................................................................................................... 130

資料................................................................................................ 131

サンプルデータベースの構築 .................................................................................................... 131 サンプルデータベース テーブル詳細(ER図) .................................................................. 132

第 1 章 はじめに 5

Copyright(C) SIOS Technology, Inc.

第1章 はじめに

WebReportCafe(以下 WRC)は、 PDF 出力、画像出力、プリンタ印刷、メール配信などを実現する

電子帳票ソリューションを提供します。

製品構成は次のとおりです。

Designer WRC の帳票アプリケーション設計ツール ビジュアルな操作で高度な帳票アプリケーションが設計可能

PDF でのプレビューも可能

OCR 読取機能、電子署名機能を標準搭載

Engine 帳票生成コアライブラリ(Java 版、Microsoft .NET 版の2つのプラットフォームをサポート)

Web アプリケーション、アプリケーション等に組込で利用

PDF 生成、ダイレクト印刷、画像出力(JPEG,PNG など)、PDF フォームをサポート

Server WebReportCafe Server は、Web ブラウザのコンソールにて運用に必要な各種設定が簡単にでき、

プログラミングレスで運用可能な帳票サーバーアプリケーションです。

Microsoft.NET、Java、PHP、HTML などのマルチアーキテクチャのクライアントや Web サービスからレポートサービスを

要求できます。

メール配信、PDF 管理など開発工数を必要とする運用管理機能をプログラミングレスで提供します。

業務システムと帳票システムを明確に分離して、帳票システムとして独立させることで、再利用性の高い帳票運用環境

を短期間で構築できます。

Print Client (Java 版のみ) J2EE/Web アプリケーション環境からクライアントのプリンタへ対して直接印刷を行うライブラリ デフォルトのプリンタへ直接印刷することや印刷ダイログを表示して印刷することが可能

このドキュメントでは、WRC Designer についての説明を行います。

又、WRC Designer の「開発環境」、「各種ダイアロボックス」、「オブジェクトリファレンス」など操作方法につきまして

は、Designer のオンラインヘルプをご参照下さい。

※WebReportCafe のプログラミング方法、「WebReportCafe プログラミングガイド」を参照して下さい。

※プログラミングで使用するクラス・メソッドの詳細につきましては、「API リファレンス」を参照して下さい。

※電子署名の設定方法につきましては、「電子署名について」を参照して下さい。

Designer 帳票アプリケーション設計ツール

WebReportCafe の帳票生成コアライブラリ

マルチアーキテクチャー対応帳票アプリケーションサーバー

Engine

Server

Print Client クライアント環境からプリンタへ直接印刷を行うライブラリ

第 2 章 Designer のインストール 6

Copyright(C) SIOS Technology, Inc.

第 2 章 Designer のインストール ① Microsoft .NET Framework 1.1 のインストール (Java モードのみ利用する場合でも必要です)

Microsoft .NET Framework 1.1 がインストールされていない場合、

CD_ROOT\Microsoft.NET\dotNetFramework\dotnetfx.exe(Microsoft .NET Framework 本体)及び

langpack.exe(日本語化パック)を起動して、.NET Framework のインストールを行ってください。また、Windows

Update で .NET Framework の重要な更新があるかどうかを確認してください。

② Microsoft Visual J# .NET Version 1.1 のインストール (Java モードのみ利用する場合でも必要です)

Microsoft Visual J# .NET Redistributable Package Version 1.1 がインストールされていない場合、

CD_ROOT\Microsoft.NET\JSharpRedist\vjredist.exe を起動して Visual J# .NET Redistributable Package の

インストールを行ってください。

<注意事項 1>

.NET Framework1.1、 2.0 を共存させる場合、1.1 と 2.0 両方の Microsoft Visual J#のライブラリをインストール

して下さい。

<注意事項 2>

Windows Update にて、マシンに.NET Framework2.0 がインストールされている可能性があります。

その場合は、以下のサイトから Microsoft Visual J# .NET 再配布パッケージ 2.0 を

取得してインストールしてください。 http://www.microsoft.com/downloads/details.aspx?familyid=F72C74B3-ED0E-4AF8-AE63-2F0E42501BE1

&displaylang=ja <注意事項 3>

Microsoft .NET Framework 2.0 SP1/3.0/3.0 SP1/3.5 のいずれかがインストールされている場合、

WebReportCafe Designer は動作いたしません。Microsoft .NET Framework 2.0 SP1/3.0/3.0 SP1/3.5 がインストー

ルされていないマシンに、WebReportCafe Designer をインストールしてください。これらの.NET Framework が一度

でもインストールされた場合、.NET Frameworkをアンインストールしても動作しない場合がありますので、ご注意くだ

さい。

③ JDK のインストール(Java モードを使用する場合)

Java モードを使用場合は、JDK をインストールする必要があります。J2SE 1.3.x 、1.4.x 又は、JDK 1.5.x をイン

ストールしてください。

④ RD.xml のバックアップ

すでに Designer がインストールされている場合は、[インストールディレクトリ]\bin\RD.xml ファイルを事前にバ

ックアップしておいてください。

⑤ Designer のアンインストール

すでに Designer がインストールされている場合は、アンインストールをして下さい。

アンインストール方法は本章の[Designer のアンインストール]を参照して下さい。

⑥ Designer のセットアップ

[CD_ROOT]\Designer\Setup.exe を起動し、画面の指示に従ってインストール作業を行ってください。

第 2 章 Designer のインストール 7

Copyright(C) SIOS Technology, Inc.

⑦ モード選択

インストール中に起動するモード選択アプリケーションでは、Designerの起動モード(Java又は.NET)を選択し

ます。起動モードは、インストールされるモード選択アプリケーション(WRCDSelect.exe)を使用することにより、

インストール後にいつでも変更することができます。

第 2 章 Designer のインストール 8

Copyright(C) SIOS Technology, Inc.

⑧ Path の設定(Java モードを使用する場合)

Java モードを使用する場合、インストール中に起動する Path 設定アプリケーションで Java の Path を設定する

必要があります。

※Path はユーザー環境変数に設定されます。他のログインユーザーで WRC Designer を使用す

る場合、ユーザー毎に環境変数の設定を行う必要があります。

尚、手動で Path を設定する場合は下記の手順で行って下さい。

Path に JRE の jvm.dll へのパスを追加します。

JDK1.3.1 の場合は“<JAVA_HOME>\jre\bin\classic” JDK1.4.x/1.5.0 の場合は、”<JAVA_HOME>\jre\bin\client” 以下、JDK1.5.0_15 を C ドライブ直下にインストールした場合を例に説明します。

[コントロールパネル]にある[システム]をクリックします。または、[マイコンピュータ]を右クリックし、

[プロパティ]を選択します。 [詳細]タブをクリックし、[環境変数]ボタンをクリックします。

システム環境変数にある変数[Path]をクリックします。

[値]に、“C:\jdk1.5.0_15\jre\bin\client”を追加します。

[設定]ボタンを押し、[OK]ボタンを押します。

⑨ RD.xml の復元

④で RD.xml をバックアップしておいた場合、RD.xml を[インストールディレクトリ]\bin\RD.xml ファイルに上書き

してください。

⑩ Designer の起動

・ [スタート]→[プログラム]→[WebReportCafe 2006]→[WebReportCafe Designer]

をクリックしてアプリケーションを起動します。 初の起動では試用版として起動されます。初回起動後、30 日

まで試用版として使用できます。製品版として無期限で使用するには、続く工程を行い、ライセンス登録を行っ

てください。

・ もし、アプリケーションが起動しない場合、またはエラーが表示された場合は、①~⑥までの作業をもう一度確

認してください。

第 2 章 Designer のインストール 9

Copyright(C) SIOS Technology, Inc.

⑪ Designer 製品版ライセンスキーの取得と入力

・ 製品版ライセンスキーの取得には、製品 CD に添付されたシリアル番号と、申請コードを、ユーザー登録サイト

で登録する必要があります。ライセンス選択ダイアログのラジオボタン[製品版のライセンスキーを取得する]を

選択して[OK]ボタンをクリックしてください。

なお、既に製品版ライセンスキーを取得している場合、[ライセンスキーの入力]を選択してライセンスキーの入

力を行ってください。

・ [ライセンス選択ダイアログで製品版のライセンスキーを取得する]を選択した場合、続いてライセンスキー発行

依頼ダイアログが表示されます。

・ ダイアログのリンク URL https://www.tenartni.com/studio_regist/top をクリックするとブラウザが起動され、ユ

ーザー登録サイトが表示されます。リンクをブラウザが起動しない場合は、Windows のスタートメニューからブラ

ウザを起動し、URL を入力してください。

・ 表示されたサイトより、ユーザー登録を行ってください。ユーザー登録の際に、出力された申請コードと CD に

添付されたシリアル番号が必要です。

・ [ライセンスキー入力画面を表示]をクリックしますと、再度ライセンス選択ダイアログ画面が表示されますので、

弊社から返信しましたメールに記載されているライセンスキーを入力してください。

・ 正しいライセンスキーが入力されますと、ライセンス入力の完了を示すダイアログが表示されます。これで、準

備作業は全て終了しました。

第 2 章 Designer のインストール 10

Copyright(C) SIOS Technology, Inc.

Java モード データベース接続設定

Java モードで使用する場合のデータベース接続設定手順を説明します。データベースを使用しない場合は必要

ありません。

① JDBC ドライバの用意

データベースを使用する場合はお使いのデータベースに合った JDBC ドライバを用意してください。

JDBC ドライバは、“<インストールディレクトリ>\lib”に配置します。

※CSV ファイルを使用する場合は必要ありません。

② 環境設定

Java クラスパス、Java ライブラリ、JDBC データソースを以下のように設定します。なお、インストールしたディレクトリや、

JDBC ドライバなど下記と異なる場合、修正して設定を行ってください。

メニューバーの[ツール]をクリックし、[環境設定]をクリックします。

以下の画面が表示されます。

Java クラスパスの設定を行います。

“<INSTALLDIR>\lib“ディレクトリに存在する.jar、.zip ファイルに対してクラスパスが自動設定されます。

例:[RD.EXE]が(C:\Program Files\sios\WebReportCafe\bin)で実行されている場合、

(C:\Program Files\sios\ WebReportCafe\lib)内に存在する.jar、.zip ファイルに対してクラスパスを設定します。 Java クラスパス

(Designer を C:\Program Files\sios\ WebReportCafe にインストールした場合)

C:\Program Files\sios\ WebReportCafe\lib\WRC_RD.jar

C:\Program Files\sios\ WebReportCafe\lib\10ART-NI_SCRIPT.jar

C:\Program Files\sios\ WebReportCafe\lib\xerces.jar(JDK1.4.0 以上は不要)

C:\Program Files\sios\ WebReportCafe\lib\ojdbc14.jar

JDBC ドライバの設定(上記の ojdbc14.jar は ORACLE の場合の例です。)

第 2 章 Designer のインストール 11

Copyright(C) SIOS Technology, Inc.

C:\Program Files\sios\ WebReportCafe\lib\jai_codec.jar

JAI を使用する場合は設定して下さい。(備考 1)

C:\Program Files\sios\ WebReportCafe\lib\jai_core.jar

JAI を使用する場合は設定して下さい。(備考 1)

C:\Program Files\sios\ WebReportCafe\lib\cryptix32.jar

PDF 設定のセキュリティ機能を使用する場合は設定して下さい。(備考 2)

C:\Program Files\sios\ WebReportCafe\lib\jakarta-oro-2.0.8.jar

PDF フォーム機能を使用する場合は設定して下さい。

(備考 1)JAI の詳細は、補足説明の [イメージ及び JAI について]を参照して下さい。

(備考 2) PDF 設定の詳細は、オンラインヘルプ[開発環境]の[各種ダイアログボックス:PDF 設定]を参照して下さい。

Java ライブラリパス

・使用するRDBがDB2の場合、パスを設定する必要があります。

・[参照]ボタンを押すと、「ディレクトリの選択」ダイアログが表示されます。

(DB2をC:\Program Filesにインストールした場合)

C:\Program Files\SQLLIB\bin

Adobe Reader パス

(Adobe Reader 8.0 を C:\Program Files にインストールした場合)

C:\Program Files\Adobe\Reader 8.0\AcroRd32.exe

※この欄が未入力の場合、拡張子「pdf」に関連づいている Adobe Reader が起動します。

JDBC データソース (ORACLE の例)

データソース名 maido_test

JDBC ドライバ名 oracle.jdbc.OracleDriver

(ORACLE の場合)

JDBC URL jdbc:oracle:thin:@localhost:1521:ORCL

(ORACLE の場合)

ユーザー名 user

パスワード pass

後に JDBC データソースの設定画面で、[接続テスト]ボタンをクリックし、データベースへの接続テストを行います。

成功すると、「接続に成功しました」と表示されます。失敗した場合はエラーの内容を確認し、上記情報を再設定し

てください。

第 2 章 Designer のインストール 12

Copyright(C) SIOS Technology, Inc.

サンプルデータベースの設定 WebReportCafe Designer では Microsoft Access 形式のサンプルデータベースを提供しております。この節では、

サンプルデータベースからデータを取得するための設定手順を説明します。

① ODBC データソースの設定

製品サンプル、PDF プレビューテストで使用する ODBC データソースの設定を行います。

[Windows のスタートメニュー]→[コントロールパネル]→[管理ツール]→[データソース(ODBC)]

を選択します。

①[ODBC データソースアドミニストレータ]で[追加]ボタンを押します

第 2 章 Designer のインストール 13

Copyright(C) SIOS Technology, Inc.

②[Microsoft Access Driver (*.mdb)]を選択して、[完了]ボタンを押します

③データソース名に「WRC_SAMPLE」と入力して、[選択]ボタンを押します

④[インストールディレクトリ]\sample\data\SampleData.mdb を選択して、[OK]ボタン

を押してください。以上で ODBC データソースの設定は終了です。

第 2 章 Designer のインストール 14

Copyright(C) SIOS Technology, Inc.

② JDBC 設定(Java モードのみ)

Java モードでは ODBC を直接扱えないため、JDBC 経由でアクセスするように設定する必要があります。

スタートメニューからデザイナーを起動し、[ツール]メニューから[環境設定]を選択し、環境設定ダイアロ

グを選択してください。環境設定ダイアログの[JDBC データソース]タブをクリックし、追加ボタンを押し、各フ

ィールドに以下の情報を入力します。

JDBC データソース

データソース名 WRC_SAMPLE

JDBC ドライバ名 sun.jdbc.odbc.JdbcOdbcDriver

JDBC URL jdbc:odbc:WRC_SAMPLE

(WRC_SAMPLE はデータソースに設定した名前)

ユーザー名 sa

パスワード なし

[接続テスト]ボタンをクリックし接続をテストしてください。テストが成功したら、[適用]ボタンをクリックして

登録し、[OK]ボタンでダイアログを閉じてください。

第 2 章 Designer のインストール 15

Copyright(C) SIOS Technology, Inc.

● Java モード ◆ 帳票フォーム読み込みテスト(CSV データソース) java モードでは、SQL によるデータ取得の他に、XML、CSV によるデータの取得もサポートします。ここでは、

CSV による帳票フォーム読み込みテストを行います。 メニューバーの[ファイル]から、[開く]をクリックします。

または、[標準]ツールバーの[フォームを開く]をクリックします。 ショートカットキー[Ctrl + O]でも同様です。

次に “<INSTALLDIR>¥sample¥form¥java¥welcome_CSV.xml”を指定して[開く]ボタンを押します。 成功すると、以下の画面が表示されます。

第 2 章 Designer のインストール 16

Copyright(C) SIOS Technology, Inc.

welcome.xml を開くと、画像を表示するイメージオブジェクトが配置されています。イメージオブジェクトのパスが正し

くない場合は PDF のプレビューをすることができない為、以下の手順でイメージオブジェクトにパスを設定して下さ

い。

【図 1.正しいパスが設定されている場合】

【図 2.不正なパスが設定されている場合】

◆イメージのパスの設定方法

①文字列[JPEG]の右にある[Image1]をクリックします。

②画面左にある[プロパティエディタ]のプロパティ名[イメージの場所]をクリックします。すると値に が表示されま

す。これをクリックすると、[ファイルを開く]ダイアログが表示されます。

③“[インストールディレクトリ]\sample\form\image\10art-ni_logo.jpg”を選択し、[開く]ボタンを押します。

④確認ダイアログで「イメージデータを帳票フォームに格納しますか?」と表示されます。

“はい”を選択しますと、帳票フォーム XML ファイルにイメージデータが格納されます。

※イメージのデータを帳票フォームに格納することで、イメージのパスを意識することなく、異なる開発環境・運用環

境でもそのまま帳票フォームを使用することが可能です。

⑤記と同じ操作を、[Image2]、[Image3]に対しても行います。

[イメージの場所]プロパティに、

“[インストールディレクトリ]\sample\form\image\10art-ni_logo.gif”

“[インストールディレクトリ]\sample\form\image\10art-ni_logo.png

を設定します。

⑥【図 1.正しいパスが設定されている場合】の表示になることを確認して下さい。

第 2 章 Designer のインストール 17

Copyright(C) SIOS Technology, Inc.

◆ Java モード PDF プレビューテスト(CSV データソース ) WebReportCafe では、Designer上から PDF プレビュー、イメージプレビュー、ダイレクト印刷を実行すること

が出来ます。 ◆PDF プレビュー [標準]ツールバーの[PDF プレビュー]をクリックします。ショートカットキー[F9]でも同様です。

PDF の生成に成功すると、Adobe Reader が起動し、以下の画面が表示されます。

第 2 章 Designer のインストール 18

Copyright(C) SIOS Technology, Inc.

◆ Java モード PDF プレビューテスト(SQL データソース) 次に “<INSTALLDIR>¥sample¥form¥java¥welcome.xml”を指定して[開く]ボタンを押します。 この帳票は、先程の帳票フォームと同じですがデータソースに SQL を使用します。 メニューバーの[ファイル]から、[PDF プレビュー]をクリックします。

または、[標準]ツールバーの[PDF プレビュー]をクリックします。ショートカットキー[F9]でも同様です。

次に JDBC ログインのダイアログが表示されます。 [ソース選択]から、先ほど設定したサンプルデータソース”WRC_SAMPLE”を選択します。 ※サンプルデータソースが表示されない場合は、前節の[サンプルデータベース設定]をご確認下さい。 選択しますと、[JDBC ドライバ]、[JDBC URL]、[ユーザー]が表示されますので、 [パスワード]は空のまま [OK]ボタンを押します。

PDF の生成に成功すると、Adobe Reader が起動し、PDF が表示されます。 以上で SQL データソース帳票フォーム動作確認作業は終了です。

第 2 章 Designer のインストール 19

Copyright(C) SIOS Technology, Inc.

● .NET モード ◆ 帳票フォーム読み込みテスト

.NET モードでは、SQL によるデータ取得の他に、XML によるデータの取得もサポートします。ここでは、SQL によ

る帳票フォーム読み込みテストを行います。 メニューバーの[ファイル]から、[開く]をクリックします。 または、[標準]ツールバーの[フォームを開く]をクリックします。 ショートカットキー[Ctrl + O]でも同様です。

次に “[インストールディレクトリ]¥ sample¥form¥dNET¥welcome.xml”を指定して[開く]ボタンを押します。 読み込みに成功すると、以下の画面が表示されます。

第 2 章 Designer のインストール 20

Copyright(C) SIOS Technology, Inc.

welcome.xml を開くと、画像を表示するイメージオブジェクトが配置されています。イメージオブジェクトのパスが正し

くない場合は PDF のプレビューをすることができない為、以下の手順でイメージオブジェクトにパスを設定して下さ

い。

【図 1.正しいパスが設定されている場合】

【図 2.不正なパスが設定されている場合】

◆イメージのパスの設定方法

①文字列[JPEG]の右にある[Image1]をクリックします。

②画面左にある[プロパティエディタ]のプロパティ名[イメージの場所]をクリックします。すると値に が表示されま

す。これをクリックすると、[ファイルを開く]ダイアログが表示されます。

③“[インストールディレクトリ]\sample\form\image\10art-ni_logo.jpg”を選択し、[開く]ボタンを押します。

④確認ダイアログで「イメージデータを帳票フォームに格納しますか?」と表示されます。

“はい”を選択しますと、帳票フォーム XML ファイルにイメージデータが格納されます。

※イメージのデータを帳票フォームに格納することで、イメージのパスを意識することなく、異なる開発環境・運用環

境でもそのまま帳票フォームを使用することが可能です。

⑤記と同じ操作を、[Image2]、[Image3]に対しても行います。

[イメージの場所]プロパティに、

“[インストールディレクトリ]\sample\form\image\10art-ni_logo.gif”

“[インストールディレクトリ]\sample\form\image\10art-ni_logo.png

を設定します。

⑥【図 1.正しいパスが設定されている場合】の表示になることを確認して下さい。

第 2 章 Designer のインストール 21

Copyright(C) SIOS Technology, Inc.

◆ .NET モード PDF プレビューテスト

メニューバーの[ファイル]から、[PDF プレビュー]をクリックします。

または、[標準]ツールバーの[PDF プレビュー]をクリック

します。ショートカットキー[F9]でも同様です。

次に ODBC ログインのダイアログが表示されます。

[ソース選択]から、接続する ODBC データソースを選択します。

[データソース]ボタンを押すと[Microsoft ODBC データソースアドミニストレータ]が表示され、ODBC データソースの

内容が確認できます。

[ソース選択]から、先ほど設定したサンプルデータソース”WRC_SAMPLE”を選択します。 ※サンプルデータソースが表示されない場合は、前節の[サンプルデータベース設定]をご確認下さい。

[ユーザー]及び[パスワード]は空欄のままで[OK]ボタンを押します。

第 2 章 Designer のインストール 22

Copyright(C) SIOS Technology, Inc.

PDF の生成に成功すると、AdobeReader が起動し、以下の画面が表示されます。

以上で SQL データソース帳票フォーム動作確認作業は終了です。

第 2 章 Designer のインストール 23

Copyright(C) SIOS Technology, Inc.

イメージプレビューテスト(Java モード/.NET モード共通) PDF プレビュー同様、イメージプレビュー、ダイレクト印刷を Designer 上から実行することが出来ます。 [標準]ツールバーの[イメージプレビュー]をクリックします。ショートカットキー[F6]でも同様です。

<注意> Java モードの場合は JDK1.4 以上が必要になります。 画像の生成に成功すると、イメージビューワーが起動し以下の画面が表示されます。

第 2 章 Designer のインストール 24

Copyright(C) SIOS Technology, Inc.

ダイレクト印刷テスト(Java モード/.NET モード共通) [標準]ツールバーの[ダイレクト印刷]をクリックします。ショートカットキー[F7]でも同様です。

<注意> Java モードの場合は JDK1.4 以上が必要になります。 プリンタ出力ダイアログが表示されますので、テストを行うプリンタ名を指定して「OK」ボタンを押しますと印刷処理が

開始されます。

第 2 章 Designer のインストール 25

Copyright(C) SIOS Technology, Inc.

Designer のアンインストール アンインストールの手順は以下の通りです。 ① Path を削除

[Designer のインストール:Path の設定]で設定した Path を削除します。 ② アンインストーラー起動

[コントロールパネル]の[アプリケーションの追加と削除]をダブルクリックします。 [WebReportCafe xxxx]を選択し、[追加と削除]ボタンをクリックします。

③ ディレクトリの削除 インストール時に指定したディレクトリ以下を全て削除します。

以上でアンインストール作業は終了です。

第 3 章 はじめての帳票作成 26

Copyright(C) SIOS Technology, Inc.

第 3 章 はじめての帳票作成

帳票「製品リスト」の作成 ここでは、帳票「製品リスト」を例に、チュートリアル形式で帳票作成の手順を説明します。帳票「製品リスト」は、デー

タベースに登録されている「製品名称」、「原価」、「定価」データを一覧形式で表示する簡単な帳票のサンプルです。

このチュートリアルで帳票作成の手順を理解してください。 帳票の仕様を決定 まず、どのような帳票を作成するかを決めます。ここでは以下の仕様を満たす帳票を作成することにします。

・ 用紙サイズは A4、横向き ・ ページヘッダーにタイトル「製品リスト」を表示 ・ ページヘッダーにイメージ(テンアートニロゴ)を表示 ・ データベースから取得するデータは、製品名称、原価、定価 ・ 原価、定価データには通貨フォーマットを適用 ・ データに対する見出しを作成し、背景色をグレーにする ・ ページフッターにページ番号を表示 ・ ページフッターに出力日(西暦)を表示

次に、データベースからデータを取得するための Select 文を作成します。 表示するデータは、製品名称、原価、定価ですので、Select 文は、以下のようになります。

CSV ファイルを使用する場合は、下記のファイルをご使用下さい。(Java モードのみ) “<INSTALLDIR>¥sample¥data¥product_list.csv” これで WRC Designer を用いて帳票フォームを作成する準備が整いました。

SELECT PRODUCT_NAME, ← 製品名称

COST, ← 原価

LIST_PRICE ← 定価

FROM PRODUCT

第 3 章 はじめての帳票作成 27

Copyright(C) SIOS Technology, Inc.

WRC Designer を用いた帳票フォーム作成

帳票の仕様が決定したので、WRC Designer を用いて上図の帳票「製品リスト」の帳票フォームを作成します。ここ

で WRC Designer の基本的な操作および、オブジェクトの利用方法を身に付けてください。 Step 1 レポートプロパティの設定

まず、レポートオブジェクトのプロパティを設定します。ここで帳票全

体に関する情報を設定します。標準フォント、用紙サイズなど、レイア

ウトに関する設定と、帳票全体で利用するデータソースの設定を行い

ます。プロパティエディタの詳しい操作方法など、開発環境について

の詳細は、WRC Designer のオンラインドキュメントを参照して下さ

い。

第 3 章 はじめての帳票作成 28

Copyright(C) SIOS Technology, Inc.

Step 1-1 レイアウトに関する設定 レポートオブジェクトのプロパティの値を以下のように変更します。 プロパティ名 値 標準フォント MS ゴシック 横用紙 はい 標準文字サイズ 20

上記設定で、用紙イメージが横向きに変わります。 Step 1-2 データソースの設定 WebReportCafe では、SQL によるデータ取得の他に、XML、CSV(java モードのみ)によるデータの取得もサポ

ートします。 ここでは、SQL と CSV ファイルの使用方法についてご説明します。 データベースの場合 以下の手順で SQL の設定を行います。 なお、SQL エディタについての詳細は WRC Designer のオンラインドキュメントを参照して下さい。 ① [データソースタイプ]を SQL に設定します。SQL のプロパティから JDBC ログインダイアログを表示させます。

② [ソース選択]から、インストール時に設定したデータソース「maido_test」を選択します。すると、

[JDBC ドライバ]、[JDBC URL]、[ユーザー]の情報が表示されます。 後に[パスワード]を入力して [OK]ボタンを押します。

③ SQL エディタに以下の SQL 文を入力します。 SELECT PRODUCT_NAME, COST, LIST_PRICE, FROM PRODUCT

④ [実行]ボタンを押し、データを取得します。 エラーが生じた場合、エラーの内容を確認してください。

⑤ 後に[OK]ボタンを押します。 CSV ファイルの場合(Java モードのみ) 以下の手順で CSV ファイルの設定を行います。

① [データソースタイプ]を CSV に設定します。

② [データソースファイル]から、 “<INSTALLDIR>¥sample¥data¥product_list.csv”のファイルを開きます。

※データ定義 CSV ファイルの詳細及び記述方法につきましては

「補足説明 : データ定義 XML ファイルと CSV ファイルについて」を参照して下さい。

上記操作により、データソースの設定及び、サンプルデータの取得が行われました。サンプルデータの利用につい

ては後ほど説明します。 次に、テキスト、イメージなどの表示オブジェクトを配置していきます。

第 3 章 はじめての帳票作成 29

Copyright(C) SIOS Technology, Inc.

Step 2 ヘッダー情報の作成 ここでは、ヘッダーに出力するオブジェクトの作成、設定を行います。 Step 2-1 ページヘッダーの編集 ページヘッダーにオブジェクトを配置する前に、ページヘッダーの高さを変更します。値はプロパティエディタから

入力します。 また、イメージビュー上でページヘッダーを選択し、中央下にある青いサイズ変更ボックスを上下にドラッグしても変

更することができます。 プロパティ名 値 高さ 5cm ※ WRC Designer は、内部で cm からピクセルへの変換が行われています。

上記設定([5cm]と設定すると、[5.01cm]になる)のように、指定した数値によっては誤差が生じる場合があ

ります。 Step 2-2 タイトルの作成 タイトル「製品リスト」をテキストオブジェクトで作成します。 ① テキストオブジェクトのアイコンをクリックします。

② イメージビュー上の[PageHeader1]をクリックすることで、テキストオブジェクトが配置されます。配置場所は

適当な位置で構いません。

③ 以下のプロパティを変更します。 プロパティ名 値 上位置 1cm 幅 12cm 横配置 均等 文字サイズ 50 太字 はい 文字列 製品リスト

④ テキストボックス上で右クリックをして、[位置合わせ]をクリックします。

⑤ [水平位置合わせ]にある[セクション中央に置く]を選択し、[OK]ボタンを押します。

第 3 章 はじめての帳票作成 30

Copyright(C) SIOS Technology, Inc.

Step 2-3 イメージの追加 先ほど作成したタイトル「製品リスト」の右横にイメージロゴを配置します。 ① イメージオブジェクトを[PageHeader1]にあるタイトル「製品リスト」の右横に配置します。

② 以下のプロパティを変更します。 プロパティ名 値 上位置 1cm 幅 2cm

② [イメージの場所]プロパティから、[ファイルを開く]ダイアログを表示します。

③ “<INSTALLDIR>¥sample¥form¥image¥10art-ni_logo.jpg” を選択し、[開く]ボタンを押します。すると画像イメージが表示されます。

④ タイトル「製品リスト」を選択し、Shift を押しながら、イメージオブジェクトを選択します。なお、選択枠で2つの

オブジェクトを囲うことでも選択できます。

⑤ 右クリックメニューで[位置合わせ]ダイアログを表示します。

⑥ [水平位置合わせ]にある[セクション中央に置く]と、[垂直位置合わせ]にある [上に寄せる]を選択し、[OK]ボタンを押します。これにより、タイトルとイメージが中央に配置されます。

ここまでの作業が無事終了すると、下図のようになります。

第 3 章 はじめての帳票作成 31

Copyright(C) SIOS Technology, Inc.

Step 2-4 見出しの作成 データベースから取得したデータの見出しを作成します。 作成する見出しは、「製品名称」、「原価」、「定価」の3つです。 ① テキストオブジェクトを[PageHeader1]上の適当な位置に配置します。

② 以下のプロパティを変更します。

プロパティ名 値 幅 16.5cm 高さ 1cm 横配置 中央 縦配置 中央 内部の色 0XC0C0C0(グレー) 枠線の太さ 1 太字 はい 文字列 製品名称

③ テキストオブジェクト[製品名称]を左下に配置します。

③ テキストオブジェクトをコピーし、ペーストを2回行います。

④ 複製した2つのテキストオブジェクトを選択し、[幅]プロパティを“6cm”に変更します。

④ 複製したテキストオブジェクトの[文字列]プロパティを、それぞれ ”原価”、”定価”に変更します。

⑤ テキストオブジェクト[原価]をテキストオブジェクト[製品名称]の右側に配置し、その 右側にテキストオブジェ

クト[定価]を配置します。 以上でヘッダ情報が作成されました。 ここまでの作業が無事終了すると、下図のようになります。

第 3 章 はじめての帳票作成 32

Copyright(C) SIOS Technology, Inc.

Step 3 ディテール情報の作成 ここでは、ページディテールにデータオブジェクトを配置します。 データオブジェクトは、データベースから取得したデータを表示するために利用します。 Step 3-1 データオブジェクトの配置 ① データオブジェクトを[PageDetail1]上の適当な位置に配置します。

② 以下のプロパティを変更します。 プロパティ名 値 縦配置 中央 左右余白 0.5cm 枠線の太さ 1

③ データオブジェクトを左上に移動します。

④ データオブジェクトと、ページヘッダーにあるテキストオブジェクト[製品名称]を選択し、右クリックメニューで

[サイズ]ダイアログを表示します。

⑤ [ 大の幅に合わせる]と、[ 大の高さに合わせる]を選択し、[OK]ボタンを押します。見出しのテキストオブ

ジェクト[製品名称]と同じサイズになります。

⑥ データオブジェクトをコピーし、ペーストを2回行います。

⑦ ページヘッダーにあるテキストオブジェクト[原価]と、複製した2つのデータオブジェクトを選択し、右クリックメ

ニューで[サイズ]ダイアログを表示します。

⑧ [ 小の幅に合わせる]を選択し、[OK]ボタンを押します。見出しのテキストオブジェクト[原価]と2つのデータ

オブジェクトが同じサイズになります。

⑨ 複製した2つのデータオブジェクトをそれぞれテキストオブジェクト[原価]、[定価]の下に来るように配置しま

す。 ⑩ ページディテールを選択し、[高さ]プロパティを ”1cm”に変更します。

第 3 章 はじめての帳票作成 33

Copyright(C) SIOS Technology, Inc.

Step 3-2 フォーマットパターンの設定 見出し[原価]、[定価]に対応したデータオブジェクトに通貨フォーマットパターンを適用します。 ① 見出し[原価]、[定価]に対応した2つのデータオブジェクトを選択します。

② プロパティエディタの[フォーマット]をクリックし、[フォーマットの設定]ダイアログを表示します。

③ [通貨]タブを選択して、以下を設定します。

項目 値 記号 ¥

※ 上記設定により、データ 150000 が、¥150,000 となります。

④ [OK]ボタンを押してダイアログを閉じます。 Step 3-3 フィールドの設定とサンプルデータの表示 データオブジェクトにフィールド名を設定し、サンプルデータを表示します。 データオブジェクトをクリックし、プロパティエディタから「フィールド名」をクリックします。すると、設定可能なフィール

ド名がコンボボックスに表示されるので、それぞれの見出しに対応した以下のフィールド名を設定します。 見出し 見出しに対応したデータオブジェクトのフィールド名 製品名称 PRODUCT_NAME 原価 COST 定価 LIST_PRICE

このフィールド名は、前述のデータソースの設定で取得したフィールド名です。 データオブジェクトにフィールド名を指定することでデータソースを実行した際に取得したサンプルデータが表示さ

れます。 [サンプルデータ]ツールバーの[次のデータ]ボタンを押すと、データベースから取得したサンプルデータがデータ

オブジェクトに表示されます。サンプルデータを表示することで、実際に生成される帳票に近い形でデザインをする

ことができます。 ここまでの作業が無事終了すると、下図のようになります。 なお下図は、データオブジェクトにサンプルデータが表示されている状態です。

第 3 章 はじめての帳票作成 34

Copyright(C) SIOS Technology, Inc.

Step 4 フッター情報の作成

後にフッター情報を作成します。ここでは、ページフッターにページ No オブジェクトと、日時オブジェクトを配置し

ます。 ページ No オブジェクトは、各ページにページ番号を表示することができます。 日時オブジェクトは、現在の時刻を表示することができます。 Step 4-1 ページ No オブジェクトの配置 ① ページ No オブジェクトを[PageFooter1]上の適当な位置に配置します。

② 以下のプロパティを変更します。 プロパティ名 値 横配置 中央 フォーマット (%)

※ フォーマットで指定した % の部分にページ番号が表示されます。

③ 右クリックメニューで[位置合わせ]ダイアログを表示します。

④ [水平位置合わせ]及び、[垂直位置合わせ]にある [セクション中央に置く]を選択し、[OK]ボタンを押します。

これにより、セクションの水平、垂直方向の中央にページ No オブジェクトが配置されます。 Step 4-2 作成日の作成 帳票を出力した日時を表示するようにします。 ① 日時オブジェクトを[PageFooter1]上の適当な位置に配置します。

② 以下のプロパティを変更します。 プロパティ名 値 幅 13cm

③ [フォーマット]プロパティから、[フォーマットの設定]ダイアログを表示させます。

④ [ユーザー定義]タブをクリックし、[yyyy 年 MM 月 dd 日 HH 時 mm 分 ss 秒]を選択します。次に、テキス

トボックスの先頭に「作成日:」を追加し、 「作成日:yyyy 年 MM 月 dd 日 HH 時 mm 分 ss 秒」とします。

後に[OK]をクリックします。

⑤ 日時オブジェクトを一番右に移動します。

⑥ 日時オブジェクトを選択し、右クリックをして、[位置合わせ]をクリックします。

⑥ [垂直位置合わせ]にある[セクション中央に置く]を選択し、[OK]ボタンを押します。

第 3 章 はじめての帳票作成 35

Copyright(C) SIOS Technology, Inc.

ここまでの作業が無事終了すると、下図のようになります。

第 3 章 はじめての帳票作成 36

Copyright(C) SIOS Technology, Inc.

Step 5 PDF プレビュー 以上で帳票「製品リスト」が完成しましたので、PDF プレビューを行って、デザインなどの確認を行ってください。

[PDF プレビュー]ツールバーの[プレビュー]ボタン(または F9キー)を押して、実際の帳票を PDF で表示してみま

す。すると以下のように表示されます。

以上で WRC Designer を用いて帳票「製品リスト」の作成が完了しました。

後に作成した帳票フォームを保存します。 メニュー[ファイル]にある[名前をつけて保存]で保存することができます。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 37

第 4 章イメージファイルから帳票フォームを作成する

概要

OCRデータ読み込み機能を使用すると、画像ファイルを解析し抽出した罫線及び文字情報を、固定フォームレイヤ

ーに取り込むことができます。動的セクションレイヤーにデータなど動的に変化する情報を配置することにより簡単

に帳票を作成することができます。

この章では、スキャナーで取り込んだ、モノクロビットマップ形式の帳票のイメージファイルから、帳票フォームを生成

する方法を説明します。

動的セクションレイヤーと固定フォームレイヤー

WRC では帳票のフォームのレイヤーとして動的セクションレイヤーと固定フォームレイヤーがあります。

・動的セクションレイヤー

動的セクションレイヤーはページヘッダー、ページディテール、ページフッターの 3 つのセクションから構成されま

す。

ページヘッダーは各ページの先頭に必ず出力されるセクションです。帳票名や表項目など、各ページの先頭に必

ず出力したいオブジェクトを配置します。

ページディテールはページヘッダーの下部に、データの件数分繰り返し出力されます。但し、取得した件数が多数

で1ページに収まらない場合、ページフッターが出力され、新しいページが自動的に作成されます。新しいページ

にページヘッダー出力された後、残りのページディテールが出力されます。主にデータに関係するものを配置しま

す。

ページフッターはページの下部に必ず出力されるセクションです。改ページ時やページディテールの出力が終了し

た際に出力されます。ページ番号等ページの下部に出力したいオブジェクトを配置します。

ページヘッダー

ページディテール

ページフッター

帳票化

データが4件の場合 ページディテールが4件出力

される

4件目を出力する余白がない

のでページフッターを出力し

改ページ

全てのページディテール出

力後、ページフッターを出

力し終了

ページヘッダー

ページディテール1

ページフッター

ページディテール2

ページディテール3

ページヘッダー

ページディテール4

ページフッター

ページディテールと改ページ

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 38

・固定フォームレイヤー

固定フォームレイヤーとは、ページ全体の固定のレイアウトを定義するレイヤーです。一つのページフォームから構

成されます。このセクションに配置したオブジェクトは、帳票の各ページに必ず表示されます。

OCR 読み取り機能を使用すると、モノクロビットマップ形式の画像ファイルを解析し、認識した文字情報や罫線情報

を、固定フォームレイヤーに取り込むことができます。

・動的セクションレイヤーと固定フォームレイヤー

動的セクションレイヤーと固定フォームレイヤーを合成して帳票が作成されます。固定フォームレイヤーに、ページ

全体のレイアウトを作成し、動的セクションレイヤーにデータを配置することにより、ページのレイアウトが固定な帳票

を簡単に設計することができます。

固定フォームレイヤーと動的セ

クションレイヤーの合成概念図固定フォームレイヤー 動的セクションレイヤー

帳票生成

ページヘッダー

ページフッター

ページディテール

データ データ

項目名1 項目名2

帳票

ページヘッダー

ページフッター

ページディテール

データ データ

ページディテール

データ データ

ページディテール

データ データ

項目名1 項目名2

帳票

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 39

イメージファイルから帳票フォームを作成する手順

Step 1 帳票イメージ画像の準備

帳票のイメージデータを用意します。イメージデータは既存帳票を印刷した用紙をイメージスキャナーで取り込んで

作成してください。

OCR データ読込機能で処理できる画像形式はモノクロビットマップ形式(bmp)のファイルです。400dpi で取り込んだ

画像データに 適化されています。

処理できる領域の 大の大きさは、A3 サイズ(432mm×304mm)の原稿が、600dpi の解像度で読み取られた大きさ

( 大 10368×7296 画素)です。また、 小の大きさは128×128 画素です。幅又は高さがこの大きさより小さい場合

エラーが出ます。

カラー又はグレースケールで取り込んだデータを、アプリケーションで白黒ビットマップに変更した画像を解析する

場合、著しく解析能力が低下する場合があります。スキャナーで取り込む際は白黒データとして取り込むことをお勧

めします。

この手順ではサンプル画像として<INSTALLDIR>¥sample¥ocr¥product_list.bmpを使用します。

イメージデータの例[product_list.bmp]

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 40

Step 2 イメージファイルの解析

Step1 で準備したイメージファイルを解析し、固定フォームレイヤーに取り込みます。

WRC Designer の[ツール]メニューより[OCR データ読込]を選択し、[原稿データ読み取りダイアログ]を表示します。

次に、ダイアログの[Open]ボタンをクリックし、表示されたファイル選択ダイアログより、Step1 で準備したイメージファ

イル product_list.bmp を選択します。続いて、[横用紙を使用する]チェックボックスをチェックし[解析実行]ボタンをク

リックし解析を開始します。「解析を終了しました」というメッセージダイアログを表示されたら、[原稿データ読み取り

ダイアログ]の[OK]ボタンをクリックします。

原稿データ読み取りダイアログ

固定フォームレイヤーに画像から取得した文字及び罫線情報が表示されます。固定フォームレイヤーを表示してい

る時は、動的セクションレイヤー上のオブジェクトは水色で背景に表示されます。

固定フォームレイヤー

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 41

Step 3 レポートプロパティの設定

レポートオブジェクトのプロパティを設定します。ここで帳票全体に関する情報を設定します。標準フォント、用紙サ

イズなど、レイアウトに関する設定と、帳票全体で利用する SQL の設定を行います。プロパティエディタの詳しい操

作方法など、開発環境についての詳細は、WRC Designer のオンラインドキュメントを参照して下さい。

Step 3-1 レイアウトに関する設定 レポートオブジェクトのプロパティの値を以下のように変更します。 プロパティ名 値 標準フォント MS ゴシック 標準文字サイズ 20

Step 3-2 データソースの設定 WebReportCafe では、SQL によるデータ取得の他に、XML、CSV(Java モードのみ)によるデータの取得もサポ

ートします。 ここでは、SQL と CSV ファイルの使用方法についてご説明します。 データベースの場合 以下の手順で SQL の設定を行います。 なお、SQL エディタについての詳細は WRC Designer のオンラインドキュメントを参照して下さい。 ① [データソースタイプ]を SQL に設定します。SQL のプロパティから JDBC ログインダイアログを表示させます。

② [ソース選択]から、インストール時に設定したデータソース「maido_test」を選択します。すると、

[JDBC ドライバ]、[JDBC URL]、[ユーザー]の情報が表示されます。 後に[パスワード]を入力して [OK]ボタンを押します。

③ SQL エディタに以下の SQL 文を入力します。 SELECT PRODUCT_NAME, COST, LIST_PRICE, FROM PRODUCT

④ [実行]ボタンを押し、データを取得します。 エラーが生じた場合、エラーの内容を確認してください。

⑤ 後に[OK]ボタンを押します。 CSV ファイルの場合(Java モードのみ) 以下の手順で CSV ファイルの設定を行います。

① [データソースタイプ]を CSV に設定します。

② [データソースファイル]から、 “<INSTALLDIR>¥sample¥data¥product_list.csv”のファイルを開きます。

※データ定義 CSV ファイルの詳細及び記述方法につきましては

「補足説明 : データ定義 XML ファイルと CSV ファイルについて」を参照して下さい。

上記操作により、データソースの設定及び、サンプルデータの取得が行われました。サンプルデータの利用につい

ては後ほど説明します。次に、テキスト、イメージなどの表示オブジェクトを配置していきます。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 42

Step 4 固定フォームレイヤーの編集

固定フォームレイヤーを編集します。OCR データ読込機能で生成した情報の、認識できなかった文字、オブジェク

トの場所、大きさ等を修正し、体裁を整えます。またロゴマークの画像、ページ番号、及び作成日を追加します。

Step 4-1 タイトルの修正

読み込んだ画像にタイトルとして「製品リスト」と描画されていましたが、固定セクションレイヤーには「製品リ ト」と誤

認識されています。文字列やフォントの大きさ等を修正し見栄えを整えます。 ① ツリービューより[_OCR_Text0]という名称のオブジェクトをクリックし選択します。

② 以下のプロパティを変更します。

プロパティ名 値 横配置 均等 文字サイズ 50 太字 はい 文字列 製品リスト

Step 4-2 イメージの追加 先ほど修正したタイトル「製品リスト」の右横にイメージロゴを配置します。 ① イメージオブジェクトを「製品リスト」テキストオブジェクトの右横に配置します。

② 以下のプロパティを変更します。

プロパティ名 値 上位置 1.7cm 幅 2cm

② [イメージの場所]プロパティから、[ファイルを開く]ダイアログを表示します。

③ “<INSTALLDIR>¥sample¥form¥image¥10art-ni_logo.jpg” を選択し、[開く]ボタンを押します。すると画像イメージが表示されます。

④ タイトル「製品リスト」を選択し、Shift を押しながら、イメージオブジェクトを選択します。なお、選択枠で2つの

オブジェクトを囲うことでも選択できます。

⑤ 右クリックメニューで[位置合わせ]ダイアログを表示します。

⑥ [水平位置合わせ]にある[セクション中央に置く]と、[垂直位置合わせ]にある [上に寄せる]を選択し、[OK]ボタンを押します。これにより、タイトルとイメージが中央に配置されます。

Step 4-3 見出しの修正 表の見出しを修正します。表の見出しとして、「製品名称」、「原価」、「定価」の3つが表示されています。文字の太

さと幅を調節し、体裁を整えます。 ① Shift を押しながら「製品名称」、「原価」及び「定価」の3つのテキストオブジェクトをクリックし選択します。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 43

② 以下のプロパティを変更します。 プロパティ名 値 縦配置 中央 太字 はい

③ 選択されているテキストオブジェクト[製品名称]上で右クリックし「サイズ」ダイアログを表示します。

③ [幅]にある[ 大の幅に合わせる]選択し、[OK]ボタンを押します。

Step 4-4 表の内容を消去

表にはデータベースから取得した情報を表示するので、イメージデータから取得した表の内容を消去します。

① ツリービュー上の「_OCR_Text4」というテキストオブジェクトをクリックします。

② ツリービュー上の「_OCR_Text39」というテキストオブジェクトを、Shift を押しながらクリックします。

「_OCR_Test4」オブジェクトから「_OCR_Text39」オブジェクトまでの36個のオブジェクトが選択されます。

③ 選択されているテキストオブジェクト上で右クリックし、表示されたメニューより削除を選択します。

Step 4-5 ページ No オブジェクトの配置 ① ページ No オブジェクトを表の下の適当な位置に配置します。

② 以下のプロパティを変更します。

プロパティ名 値 横配置 中央 フォーマット (%)

※ フォーマットで指定した % の部分にページ番号が表示されます。

③ 右クリックメニューで[位置合わせ]ダイアログを表示します。

④ [水平位置合わせ]にある [セクション中央に置く]を選択し、[OK]ボタンを押します。これにより、セクションの水

平中央にページ No オブジェクトが配置されます。

Step 4-6 作成日の配置 帳票を出力した日時を表示するようにします。 ① 日時オブジェクトを表の右下の適当な位置に配置します。 ② 以下のプロパティを変更します。

プロパティ名 値 幅 13cm

③ [フォーマット]プロパティから、[フォーマットの設定]ダイアログを表示させます。 ④ [ユーザー定義]タブをクリックし、[yyyy 年 MM 月 dd 日 HH 時 mm 分 ss 秒]を選択します。次に、テキス

トボックスの先頭に「作成日:」を追加し、 「作成日:yyyy 年 MM 月 dd 日 HH 時 mm 分 ss 秒」とします。

後に[OK]をクリックします。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 44

⑤ 日時オブジェクトを一番右に移動します。

以上の作業を行うと固定フォームレイヤーは以下の図のようになります。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 45

Step 5 動的セクションレイヤーの編集

動的セクションレイヤーを編集します。動的セクションレイヤーを編集する場合はイメージビューの上部にある「動的

セクションレイヤー」タブをクリックし、編集するレイヤーを変更してください。

Step 5-1 ヘッダー情報の作成

ヘッダー情報を編集します。データ以外の表示する項目は全て固定フォームレイヤーに作成されているので、ここ

ではページヘッダーの高さのみ設定します。

ページの先頭からデータ項目が表示される直前(表項目の下部)までの高さをヘッダーの高さとして指定します。ペ

ージヘッダーの高さのプロパティを下記のように変更してください。

プロパティ名 値 高さ 5.7cm

Step 5-2 ディテール情報の作成

データを表示するディテール情報を作成します。ディテール情報はデータの件数分、繰り返して表示されます。

Step 5-2-1 ページディテールの設定

ページディテールの高さを設定します。高さは固定フォームレイヤーに作成した表の一行の高さと同様にします。

ページディテールのプロパティを下記のように変更してください。

プロパティ名 値 高さ 1cm

Step 5-2-2 データオブジェクトの配置 ① データオブジェクトを[PageDetail1]上の適当な位置に配置します。

② 以下のプロパティを変更します。

プロパティ名 値 縦配置 中央 左右余白 0.5cm 高さ 1cm

③ 固定フォームレイヤーに表示されている、表の項目名[製品名称]のセルの下部に配置し、同じ長さになるよう

にマウスで調整します。

④ データオブジェクトをコピーし、ペーストを2回行います。

⑤ ペーストした作成したデータ二つのオブジェクトをそれぞれ、固定フォームレイヤーに表示されている、表の

項目名[原価]と[定価]のセルの下部に配置し、それぞれ同じ長さになるようにマウスで調整します。 Step 5-2-3 フォーマットパターンの設定 見出し[原価]、[定価]に対応したデータオブジェクトに通貨フォーマットパターンを適用します。 ① 見出し[原価]、[定価]に対応した2つのデータオブジェクトを選択します。

② プロパティエディタの[フォーマット]をクリックし、[フォーマットの設定]ダイアログを表示します。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 46

③ [通貨]タブを選択して、以下を設定します。 項目 値 記号 ¥

※ 上記設定により、データ 150000 が、¥150,000 となります。

④ [OK]ボタンを押してダイアログを閉じます。

Step 5-2-4 フィールドの設定とサンプルデータの表示 データオブジェクトにフィールド名を設定し、サンプルデータを表示します。 データオブジェクトをクリックし、プロパティエディタから「フィールド名」をクリックします。すると、設定可能なフィール

ド名がコンボボックスに表示されるので、それぞれの見出しに対応した以下のフィールド名を設定します。 見出し 見出しに対応したデータオブジェクトのフィールド名 製品名称 PRODUCT_NAME 原価 COST 定価 LIST_PRICE

このフィールド名は、前述のデータソースの設定で取得したフィールド名です。 データオブジェクトにフィールド名を指定することでデータソースを実行した際に取得したサンプルデータが表示さ

れます。 [サンプルデータ]ツールバーの[次のデータ]ボタンを押すと、データベースから取得したサンプルデータがデータ

オブジェクトに表示されます。サンプルデータを表示することで、実際に生成される帳票に近い形でデザインをする

ことができます。 Step 5-3 フッター情報の作成

表の下部からページの下部までの高さをページフッターの高さとして設定します。ページフッターのプロパティを下

記のように設定してください。

プロパティ名 値 高さ 3.35cm

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 47

以上で動的セクションレイヤーの編集は完了です。下図のようなレイアウトが作成されることを確認してください。

Copyright(C) SIOS Technology, Inc.

第 4 章 イメージファイルから帳票フォームを作成する 48

Step 6 PDF プレビュー 以上で帳票「製品リスト」が完成しましたので、PDF プレビューを行って、デザインなどの確認を行ってください。 [PDF プレビュー]ツールバーの[プレビュー]ボタン(または F9キー)を押して、実際の帳票を PDF で表示してみま

す。すると以下のように表示されます。

以上でイメージファイルからの帳票の作成が完了しました。

後に作成した帳票フォームを保存します。 メニュー[ファイル]にある[名前をつけて保存]で保存することができます。

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成 49

第 5 章 下絵イメージファイルから帳票フォームを作成

概要

下絵イメージ読み込み機能を使用すると、bmpファイルの画像をイメージビューに直接表示することが出来ます。OCR イメージ

読込機能とは異なり、オブジェクトの作成は行いませんが、イメージビューに画像を直接表示する事によって帳票作成の効率化が図れ

ます。

この章では、カラービットマップ形式の帳票のイメージファイルを下絵イメージとして、帳票フォームを生成する方法

を説明します。

下絵イメージファイルから帳票フォームを作成する手順

Step 1 下絵イメージ画像の準備

帳票の下絵イメージデータを用意します。

この手順ではサンプル画像として[インストールディレクトリ]¥sample¥draft¥ product_list_draft.bmpを使用します。

イメージデータの例[product_list_draft.bmp]

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成 50

Step 2 下絵イメージファイルの読み込み

Step1 で準備した下絵イメージファイルを読み込み、イメージビューに表示します。

WebReportCafe Designer の[ツール]メニューより[下絵イメージ]を選択し、[下絵イメージダイアログ]を表示します。

次に、ダイアログの[Open]ボタンをクリックし、表示されたファイル選択ダイアログより、Step1 で準備したイメージファ

イル product_list_draft.bmp を選択します。続いて、[下絵イメージを表示する]、[画像の大きさを調整する]の 2 つの

チェックボックスをチェックしたのちに、[下絵イメージダイアログ]の[OK]ボタンをクリックします。

原稿データ読み取りダイアログ

イメージビューに下絵イメージファイルの画像が表示されます。なお、この帳票は用紙向きが横向きなので、レポー

トオブジェクトのプロパティ[横用紙]を[はい]に変更します。

イメージビュー

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成 51

Step 3 レポートプロパティの設定

レポートオブジェクトのプロパティを設定します。ここで帳票全体に関する情報を設定します。標準フォント、用紙サ

イズなど、レイアウトに関する設定と、帳票全体で利用する SQL の設定を行います。プロパティエディタの詳しい操

作方法など、開発環境についての詳細は、WebReportCafe Designer のオンラインドキュメントを参照して下さい。

Step 3-1 レイアウトに関する設定

レポートオブジェクトのプロパティの値を以下のように変更します。 プロパティ名 値

標準フォント MS ゴシック

標準文字サイズ 20

横用紙 はい

Step 3-2 データソースの設定

データソースは「第 4 章 イメージファイルから帳票フォームを作成する」の Step 3-2 「データソースの設定」をご覧

の上設定を行ってください。

Step 4 固定フォームレイヤーの編集

固定フォームレイヤーを編集します。下絵イメージ読込機能でイメージビューに表示された帳票イメージを元に各種

オブジェクトを配置して帳票を作成します。

レイヤーの編集中に、[下絵イメージダイアログ]にて下絵イメージの表示や消去を繰り返し行う事により、配置したオ

ブジェクトの位置を把握しやすくなります。

Step 4-1 タイトルの作成

タイトル「製品リスト」をテキストオブジェクトで作成します。

① テキストオブジェクトのアイコンをクリックします。

② 固定フォームレイヤー上にクリックすることで、テキストオブジェクトが配置されます。配置場所は適当な位置

で構いません。

③ 以下のプロパティを変更します。

プロパティ名 値

横配置 均等

文字サイズ 50

太字 はい

文字列 製品リスト

④ 配置したテキストオブジェクトを選択して、イメージビューに表示された下絵イメージにあわせます。

Step 4-2 イメージの追加

先ほど修正したタイトル「製品リスト」の右横にイメージロゴを配置します。

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成 52

① イメージオブジェクトを「製品リスト」テキストオブジェクトの右横に配置します。

② [イメージの場所]プロパティから、[ファイルを開く]ダイアログを表示します。

③ “[インストールディレクトリ]\sample\form\image\10art-ni_logo.jpg”

を選択し、[開く]ボタンを押します。すると画像イメージが表示されます。

④ 配置したイメージオブジェクトを選択して、イメージビューに表示された下絵イメージにあわせます。

Step 4-3 見出しの作成

データベースから取得したデータの見出しを作成します。

作成する見出しは、「製品名称」、「原価」、「定価」の3つです。 ① 固定フォームレイヤー上にテキストオブジェクトを配置します。

② 以下のプロパティを変更します。

プロパティ名 値

横配置 中央

縦配置 中央

内部の色 0XC0C0C0(グレー)

枠線の太さ 1.0

太字 はい

文字列 製品名称

③ テキストオブジェクト[製品名称]を左下に配置します。

③ テキストオブジェクトをコピーし、ペーストを2回行います。

④ 複製したテキストオブジェクトの[文字列]プロパティを、それぞれ

”原価”、”定価”に変更します。

⑤ 配置した 3 つのテキストオブジェクトを選択して、イメージビューに表示された下絵イメージにあわせます。

以上でタイトル、見出しが作成されました。

Step 4-4 表の枠線を作成

帳票の枠線を作成します。枠線を手動で一本ずつ作成するのは手間が掛かかりますが、ここで紹介する[罫線オブ

ジェクト]と[指定位置に貼り付け]の二つの機能を駆使する事により枠線が簡単に作成できます。

① 固定フォームレイヤー上に罫線オブジェクトを配置します。

② 以下のプロパティを変更します。

プロパティ名 値

線の太さ 1.0

③ 配置した罫線オブジェクトを選択して、イメージビューに表示された下絵イメージの適当な枠線にあわせま

す。

④ 罫線オブジェクトをコピーします。

⑤ ツールバーから[指定位置に貼り付け]を選択して、罫線オブジェクトを貼り付けたい位置にマウスカーソルを

移動して左クリックすると、コピーした罫線オブジェクトがマウスカーソルの位置に貼り付けられます。この作業

を残りの枠線に対しても行います。

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成 53

Step 4-5 ページ No オブジェクトの配置

① ページ No オブジェクトを表の下の適当な位置に配置します。

② 以下のプロパティを変更します。

プロパティ名 値

横配置 中央

フォーマット (%)

※ フォーマットで指定した % の部分にページ番号が表示されます。

③ 配置したページNoオブジェクトを選択して、イメージビューに表示された下絵イメージのページにあわせます。

Step 4-6 作成日の配置

帳票を出力した日時を表示するようにします。

① 日時オブジェクトを表の右下の適当な位置に配置します。

② 以下のプロパティを変更します。

プロパティ名 値

幅 13cm

③ [フォーマット]プロパティから、[フォーマットの設定]ダイアログを表示させます。

④ [ユーザー定義]タブをクリックし、[yyyy 年 MM 月 dd 日 HH 時 mm 分 ss 秒]を選択します。次に、テキストボ

ックスの先頭に「作成日:」を追加し、

「作成日:yyyy 年 MM 月 dd 日 HH 時 mm 分 ss 秒」とします。

後に[OK]をクリックします。

⑤ 日時オブジェクトを一番右に移動します。

⑥ 日時オブジェクトを選択し、shift キーを押しながらページ No オブジェクトをクリックし 2 つのオブジェクトを選

択します。

⑦ 右クリックをして、[位置合わせ]をクリックします。

[垂直位置合わせ]にある[セクション中央に置く]を選択し、[OK]ボタンを押します。

以上の作業を行うと固定フォームレイヤーは以下の図のようになります。

Copyright(C) SIOS Technology, Inc.

第 5 章 下絵イメージファイルから帳票フォームを作成 54

Step 5 動的セクションレイヤーの編集

動的セクションレイヤーは、「第 4 章 イメージファイルから帳票フォームを作成する」の「Step5 動的セクションレイヤ

ーの編集」をご覧の上編集を行ってください。

Step 6 PDF プレビュー

PDF プレビューについては、「第 4 章 イメージファイルから帳票フォームを作成する」の「Step6 PDF プレビュー」を

ご覧ください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 55

第 6 章 いろいろな帳票サンプル

● 概要 ここでは、様々な帳票サンプルを例に Designer の機能について説明します。 ここで使用する帳票フォーム(XML ファイル)は以下の場所にあります。

Java サンプル <INSTALLDIR>¥sample¥form¥java¥….xml .NET サンプル <INSTALLDIR>¥sample¥form¥dNET¥….xml ● サンプル一覧 ◆ 製品別売上リスト

主な機能:グループヘッダー、グループフッター、合計オブジェクト カウントオブジェクト、バーコードオブジェクト

◆ 製品売上リスト 2 主な機能:グループヘッダー(改ページ時に再出力)、罫線、QR コード、イメージの格納機能 ◆ 社員別見積リスト 1 主な機能:サブレポートセクション ◆ 社員別見積リスト 2 主な機能:サブレポートエリア、行番号オブジェクト ◆ 社員別見積リスト2(あふれデータ設定) 主な機能:サブレポートエリアのあふれデータ無視の利用方法 ◆ 見積書 1 主な機能:暗号機能 ◆ 見積書 2 主な機能:JavaScript 機能 ◆ XML Schemaファイルを使用したPDF生成 主な機能:XML Schema ファイルの利用方法 ◆ 複数のCSVファイルを使用したPDF生成

主な機能:複数のCSVファイルを使用したPDF生成

◆ 製品見積リスト

主な機能:固定フォームレイヤーと動的セクションレイヤーの合成

◆ 製品別売上リスト(しおり付き)

主な機能:しおりオブジェクト

◆ 見積ラベル

主な機能:幅を指定したページディテール、表示条件

◆ 販売予定表

主な機能:計算オブジェクト

◆ 社員別見積実績リスト

主な機能:高さ予約

◆ 御見積票(正、副綴り)

高さ予約、あふれデータ無視、固定フォームレイヤーを活用した帳票サンプル

◆ 中国漢字、ハングル文字対応帳票

中国漢字、ハングル文字を使用した帳票フォームのサンプル

◆ 複数ページの帳票レイアウト

1 つの帳票フォームに複数のページレイアウトが含まれるサンプル、郵政カスタマバーコード

◆ 部署別実績リスト

グループ総ページ、ページ No/行番号のリセット

◆ PDFフォームを利用した見積書

PDF フォームを利用した入力可能な PDF

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 56

製品別売上リスト ◆ サンプルで使用するファイル product_list_sales.xml (SQL の場合) product_list_sales_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の帳票「製品別売上リスト」は、グループセクションを用いて、製品名別に「見積管理番号」、「数量」、「売価」を

表示する帳票です。さらに、グループ化したデータの合計を表示しています。 ◆ レポート構成 ① ページヘッダー ② グループヘッダー ③ ページディテール ④ グループフッター1 ⑤ グループフッター2 ⑥ ページフッター

カウント

合計バーコード

② ③

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 57

◆ 解説 ● グループヘッダーについて ・グループヘッダーの [コントロールキー]プロパティにフィールド名を設定して下さい。これにより、設定されたフィ

ールド名の値が変わるごとにグループヘッダーが表示されるようになります。サンプル製品別売上リストでは“製

品名”のフィールド名を設定しています。 ● グループフッターについて ・グループフッターも同様に [コントロールキー] プロパティにフィールド名を設定して下さい。これにより、フィールド

名の値が変わるごとにグループフッターが表示されるようになります。サンプル製品別売上リストでは“製品名”の

フィールド名を設定しています。 ● グループセクションその他の機能 ・改ページ処理

グループセクションのプロパティ[改ページ(表示前)or 改ページ(表示後)]を“はい”にすることにより、改ページを

設定することができます。 又、グループヘッダーには[改ページ後に再出力]プロパティがあり、“はい”にすることにより、改ページ時後に

必ずグループヘッダーを出力することができます。※詳細は後述の「製品別売上リスト2」を参照して下さい。 サンプル製品別売上リストでは“グループフッター1”で設定しています。

・その他 グループセクションの[コントロールキー]プロパティに値を設定しない場合。 ・ グループヘッダーは 初のページのみ表示されます。 ・ グループフッターは 後のページのみ表示されます。 サンプル製品別売上リストでは“グループフッター2”で使用しています。

● 合計オブジェクトとカウントオブジェクトについて ・合計オブジェクトを使用するとフィールドの合計を取得することができます。但し、DB のデータ型が数値の場合の

み使用可能です。 ・カウントオブジェクトを使用すると、レコードの件数を取得することができます。DB のデータ型に依存しません。 ● バーコードオブジェクトについて ・WebReportCafe では、4種類のバーコードをサポートしています。

1、 CODE39 2、 JAN8 3、 JAN13 4、 CODE128( TYPE-A, TYPE-B, TYPE-C )

・サンプル製品別売上リストでは“CODE39”を使用しています。 ※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 58

◆ PDF プレビュー ☆ 製品名別に各項目や合計が表示されることを確認して下さい。

☆ 終頁に総合計が表示されるのを確認して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 59

製品別売上リスト 2

◆ サンプルで使用するファイル product_list_sales2.xml (SQL の場合) product_list_sales2_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の帳票「製品別売上リスト 2」は、グループヘッダーに「製品情報」、ページディテールに「見積情報」を表示す

る帳票です。グループヘッダーの「改ページ時に再出力」プロパティを利用して、改ページ時に必ずグループヘッ

ダーを表示させています。 ◆ レポート構成 ① ページヘッダー ② グループヘッダー ③ ページディテール ④ グループフッター1 ⑤ ページフッター ◆ 解説

QR コード

イメージ

罫線

※イメージを帳票フォームに格

納しています。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 60

● グループヘッダーの「改ページ時に再出力」プロパティについて ・グループヘッダーは [コントロールキー]プロパティに設定されたフィールド名の値が変わるごとに表示されるオブ ジェクトです。 このサンプルでは、「改ページ時に再出力」プロパティを“はい”に設定して、改ページが発生した際にも強制的に グループヘッダーを表示させています。 (注意)

1.「改ページ(表示後)」プロパティと「改ページ時に再出力」プロパティの両方に“はい”に設定されている場合は、 「改ページ(表示後)」が優先的に使用されます。

2.サブレポートエリアでのグループヘッダーでは「改ページ時に再出力」プロパティを使用することが出来ません。

● QR コードオブジェクトについて ・QR コードのモデル2を描画することができます。

・以下の QR コードを描画することができます。

● バージョン 1 – 20

バージョンと誤り訂正レベルの値によって、QR コードに格納できるデータ数が決まります。

※詳細はオンラインヘルプの「QR コード」を参照して下さい。

● 誤り訂正レベル L, M, Q, H

QR コードの一部分が損傷した場合に復元できるレベルを設定することが出来ます。

L ・・・・・・ 7%

M ・・・・・・ 15%

Q ・・・・・・ 25%

H ・・・・・・ 30%

● エンコードモード

[数字モード] 0 から 9

[英数字モード] 0 から 9、A~Z、 スペース、$、%、*、+、-、.、/、:

[8 ビットバイトモード]JIS X 0201 に基づく文字

※漢字モード、混在モードは使用できません(8 ビットバイトモードをご使用ください 。)

● 罫線オブジェクトと直線オブジェクトについて ・罫線オブジェクトは線を描画するオブジェクトです。引かれた線は必ず垂直又は水平になるのが特徴です。 ・直線オブジェクトはユーザーが任意の方法(縦、横、斜め)に線を引くことが可能なオブジェクトです。

● イメージの格納 機能について ・イメージ(jpg,gif 等)のデータを帳票フォーム(XML)に埋め込むことが可能な機能です。 イメージのデータを帳票フォームに埋め込むことで、異なる開発環境・運用環境でもそのまま帳票フォームを使用す

ることが可能です。 イメージオブジェクトのプロパティ「イメージの格納」を“はい”に設定することでイメージを帳票フォーム(XML)に格

納することが出来ます。 ※「イメージの格納」はデータをエンコードして帳票フォームに埋め込みを行います。その為、帳票フォームのサイズ

は指定されたイメージサイズの約1.5倍のデータになります。 ※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 61

◆ PDF プレビュー ☆1つのグループ(製品名)で2頁にまたがるデータの場合に同じヘッダーが出力されること確認して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 62

社員別見積リスト 1 ◆ サンプルで使用するファイル estimate_list_emp1.xml (SQL の場合) estimate_list_emp1_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の社員別見積リスト 1 は、サブレポートセクションを利用して社員別の見積情報(見積名、顧客名称、売価、見

積価格)を一覧にした帳票です。また、前述の製品別売上リストで利用したグループフッターを利用して、売価、見

積価格の合計も表示しています。 ◆ レポート構成 ① ページヘッダー ② ページディテール ③ サブレポートセクション

④ ページヘッダー ⑤ ページディテール ⑥ グループフッター ⑦ ページフッター

⑧ ページフッター

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 63

◆ 解説 (Java モードの場合) <注意>

サブレポートの使用方法は、Java モードと.NET モードでは設定方法が異なりますのでご注意意下さい。

.NET モードの解説は次頁を参照して下さい。

● サブレポート機能について ・サブレポートセクションとサブレポートエリアは、他のセクションオブジェクトと異なり、ページヘッダー、ページディ

テール、ページフッターなどを持つことができる帳票フォームを小型化したオブジェクトです。このオブジェクトは、

社員別見積リスト 1 のように、あるデータ(社員コード)にぶら下がるデータ(見積名など)を表示する際に利用し

ます。又、SQL を記述することもできます。 サブレポートセクションとサブレポートエリアでは以下の2点が異なります。 1 サブレポートセクションは、幅の指定をすることができません。これに対してサブレポートエリアはテキスト、

データなどと同様に、任意の場所、大きさでサブレポートを出力することができます。 2

サブレポートセクションは、出力する場所がなくなると改ページが行われますが、サブレポートエリアは、エ

リアをはみだした分は無視されます。 ● サブレポートセクションの使用方法 サンプル社員別見積リスト 1 では上記の SQL を設定しています。 上記の太字部分でパラメータを指定しています。この「:EMPLOYEE_CODE」は、親レポートの SQL に記述され

ているカラム名と同じです。このように、サブレポートに親レポートの SQL に記述されているカラム名をコロン「:」つき

で記述することで、親レポートとのデータの関連付けを行うことができます。 ※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

SELECT TITLE,

CUSTOMER_NAME,

TOTAL_PRICE,

GRAND_TOTAL

FROM ESTIMATE

WHERE CREATE_USERID = :EMPLOYEE_CODE ← 社員コード

ORDER BY CREATE_USERID

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 64

◆ 解説 (.NET モードの場合)

● サブレポート機能について

・サブレポートセクションとサブレポートエリアは、他のセクションオブジェクトと異なり、ページヘッダー、ページデ

ィテール、ページフッターなどを持つことができる帳票フォームを小型化したオブジェクトです。このオブジェクトは、

社員別見積リスト 1 のように、あるデータ(社員コード)にぶら下がるデータ(見積名など)を表示する際に利用し

ます。又、SQL を記述することもできます。

・サブレポートセクションとサブレポートエリアでは以下の2点が異なります。

1 サブレポートセクションは、幅の指定をすることができません。これに対してサブレポートエリアはテキスト、

データなどと同様に、任意の場所、大きさでサブレポートを出力することができます。

サブレポートセクションは、出力する場所がなくなると改ページが行われますが、サブレポートエリアは、エ

リアをはみだした分は無視されます。

● サブレポートセクションの使用方法

サブレポートのプロパティ「リレーションキー」のダイアログを表示させて下さい。

親レポートのカラム一覧とサブレポートのカラム一覧が表示されます。

リレーションを設定するカラムを選択して追加することでリレーションを設定することが出来ます。

※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 65

◆ PDF プレビュー ☆ 社員コード別に見積名などの情報が表示されることを確認してください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 66

社員別見積リスト 2 ◆ サンプルで使用するファイル estimate_list_emp2.xml (SQL の場合) estimate_list_emp2_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の帳票は、サブレポートエリアを利用して、社員別の見積価格及び値引金額のベスト3を表示する帳票を作成

します。サブレポートエリアは、テキストやイメージオブジェクトと同様に、セクションの中に配置するオブジェクトで

す。 ◆ レポート構成 ①ページヘッダー

②ページディテール ③サブレポートエリア 1 ・ページヘッダー ・ページディテール ・ページフッター ④サブレポートエリア 2 ・ページヘッダー ・ページディテール ・ページフッター

⑤ページフッター

サブレポートエリア

③ ④

行番号

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 67

◆ 解説 (Java モード) <注意>

サブレポートの使用方法は、Java モードと.NET モードでは設定方法が異なりますのでご注意意下さい。

.NET モードの解説は次頁を参照して下さい。 ● サブレポートエリアについて ・サブレポートエリアはテキスト、データなどと同様に、任意の場所、大きさで出力することができますが、エリア(サ

ブレポートのサイズ)をはみだした分は無視されます。サンプル社員別見積リスト 2 ではこの特性を活かして、サ

ブレポートエリアをデータが3件分表示されるサイズに調節しています。 この例のように、出力したいデータや大きさが予測可能な場合や、任意の場所に配置したい場合などにサブレポ

ートエリアは有効です。(エリアをはみ出した分を無視しない設定も可能です。詳しくは次節をご覧下さい。)

● サブレポートエリアの使用方法

サブレポートエリアの使用方法はサブレポートセクションと同じです。 サンプル社員別見積リスト 2 の”サブレポートエリア 1”では上記の SQL を設定しています。 上記の太字部分でパラメータを指定しています。この「:EMPLOYEE_CODE」は、親レポートの SQL に記述され

ているカラム名と同じです。このように、サブレポートに親レポートの SQL に記述されているカラム名をコロン「:」つき

で記述することで、親レポートとのデータの関連付けを行うことができます。 ● 行番号オブジェクトについて ・行番号オブジェクトは、設定されている SQL の実行結果の行番号を取得します。 ※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

SELECT CUSTOMER_NAME,

GRAND_TOTAL

FROM ESTIMATE

WHERE CREATE_USERID = :EMPLOYEE_CODE

ORDER BY TOTAL_PRICE DESC

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 68

◆ 解説 (.NET モード) ● サブレポートエリアについて

・サブレポートエリアはテキスト、データなどと同様に、任意の場所、大きさで出力することができますが、エリア

(サブレポートのサイズ)をはみだした分は無視されます。サンプル社員別見積リスト 2 ではこの特性を活かして、

サブレポートエリアをデータが3件分表示されるサイズに調節しています。

この例のように、出力したいデータや大きさが予測可能な場合や、任意の場所に配置したい場合などにサブレポ

ートエリアは有効です。(エリアをはみ出した分を無視しない設定も可能です。詳しくは次節をご覧下さい。)

● サブレポートエリアの使用方法

サブレポートエリアのプロパティ「リレーションキー」のダイアログを表示させて下さい。

親レポートのカラム一覧とサブレポートのカラム一覧が表示されます。

リレーションを設定するカラムを選択して「追加」することでリレーションを設定することが出来ます。

● 行番号オブジェクトについて

・行番号オブジェクトは、設定されている SQL の実行結果の行番号を取得します。

※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 69

◆ PDF プレビュー ☆ 社員コード別に見積価格、値引き金額などの情報が表示されることを確認してください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 70

社員別見積リスト 2(あふれデータ設定) 前節で説明した社員別見積リスト2は、サブレポートエリア(サブレポートのサイズ)をはみだした分を

無視して表示されますが、[あふれデータ無視]プロパティを指定する事により、エリアをはみ出した分を無視

せず表示させることが出来ます。 サブレポートエリアの[あふれデータ無視]プロパティを設定して、サブレポートエリア(サブレポートのサイ

ズ)をはみ出した分を無視しないように設定します。 データを全件表示する為、ページディテール内の「Best-3」の表記を削除します。

◆ 解説 ● あふれデータを無視しないサブレポートエリア

通常サブレポートエリアはエリアをはみだした(あふれた)データは無視されますが、あふれデータを無視しない

場合、エリアをはみだしたデータは親のページディテールを再描画して出力されます。 注意事項 あふれデータ無視の設定は、ページディテールに置かれたサブレポートエリアのみ可能です。ページディテー

ル以外でのあふれデータ無視の設定はサポートしません。

サブレポートエリアのプロパティ[あふれデータ無視]

を「いいえ」に設定します。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 71

◆ PDF プレビュー ☆ サブレポートエリア(サブレポートのサイズ)をはみ出した分を無視されていないことを確認してく

ださい。

2 ページ目以降には、サブレポートエリア(サブレポートのサイズ)をはみ出したデータが表示されます。

親のディテールが再描画され、

4 件目以降のデータが出力されます

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 72

見積書 1 ◆ サンプルで使用するファイル estimate_list1.xml (SQL の場合) estimate_list1_CSV.xml (※Java モードのみ CSV ファイルの場合)

◆ 概要 上記の見積書 1 は、見積管理番号別の見積書です。この帳票は今まで説明してきた機能に加えて、セキュリティ機

能を加えています。PDF を開く際にパスワードが必要になります。 ◆ レポート構成 ① ページヘッダー ② ページディテール ③ サブレポートセクション ④ ページフッター

角丸四角形

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 73

◆ 解説 ● セキュリティ機能について ・PDF 設定の[セキュリティ]画面で、セキュリティの設定を行うことが出来ます。 サンプル見積書 1 では[パスワード設定]の[文書を開く時]のパスワードを“password” で設定しています。PDF が

開く際に、パスワード認証ダイアログが表示されますので、“password”と入力すると PDF を開くことができます。 又、セキュリティ設定では以下の項目を設定することが出来ます。 ・印刷の許可 ・文書の変更を許可 ・テキストとグラフィックの選択の許可 ・注釈とフォームフィールドの追加と変更を許可 又、セキュリティ設定を変更するためのパスワードを設定することも出来ます。 このようにセキュリティ機能を使用することで、帳票の秘密保持および改ざんを防ぐことができます。 ※PDF 設定の詳細は、オンラインヘルプ[開発環境]の[各種ダイアログボックス:PDF 設定]を参照してください。 ※セキュリティ機能を使用する場合は、cryptix32.jar のライブラリが必要です。詳細は、[第2章 Designer のインス

トール]を参照して下さい。(Java モードを使用する場合)

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 74

◆ PDF プレビュー ☆ PDF プレビューを行うと以下の画面が表示されることを確認して下さい。

文書パスワードに“password”と入力して OK を押して下さい。 ☆ PDF が表示されることを確認して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 75

見積書 2 ◆ サンプルで使用するファイル estimate_list2.xml (SQL の場合)

◆ 概要 上記の帳票は先程説明した“見積書 1”に、JavaScript 機能を追加したサンプルです。PDF を開く際に

JavaScript が実行され、【PDF を印刷しますか】のダイアログが表示されます。【はい】を押すと印刷を開始します。 ◆ レポート構成 ① ページヘッダー ② ページディテール ③ サブレポートセクション ④ ページフッター

角丸四角形

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 76

◆ 解説 ● JavaScript 機能について ・PDF 設定の[JavaScript]画面で、JavaScript を登録することができます。

サンプル見積書 2 では、[JavaScript 名]に“script1”、[JavaScript の編集]には下記の JavaScript を登録しま

した。

上記の方法で、複数の JavaScript を登録するとことが

出来ます。 ● JavaScript 使用方法について 登録した JavaScript を使用する場合は、PDF 設定の[アクション]画面で呼び出すタイミング [操作] を選択しま

す。 ・ページを開く時 ・ページを閉じる時 [操作] を選択した後、[追加]ボタンを押し、[アクション設定]、[JavaScript の編集]で呼び出す JavaScript を記述

します。 サンプル見積書 2 では、[操作] にページを開く時を選択し、[アクション名]に“action1”[JavaScript の編集]には

下記の通り記述しました。 上記のように設定すると PDF が開いた際に JavaScript が実行されます。 ※PDF 設定の詳細は、オンラインヘルプ[開発環境]の[各種ダイアログボックス:PDF 設定]を参照してください。

function showMsg(){

if(app.alert('PDFを印刷しますか', 2, 2)== 4){

app.alert('印刷を実行します');

this.print(false, 0, 0, true);

}else{

app.alert('印刷を中止しました');

}

showMsg();

<< JavaScript の説明 >>

この JavaScript が実行されると

【PDF を印刷しますか】のダイアログが表示されます。

・“はい”を押すと印刷が開始します。

( 初の1頁が印刷されます)

・“いいえ”を押すと【印刷を中止しました】

と表示されます。

ここで指定するのは、JavaScript の関数名を指定します。

(注) JavaScript 名ではありません。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 77

◆ PDF プレビュー ☆ PDF プレビューを行うと以下の画面が表示されることを確認して下さい。 “はい”を押すと印刷が開始します。 ☆ 印刷後、PDF が表示されることを確認して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 78

XML Schema ファイルを使用した PDF 生成 ◆ サンプルで使用するファイル

estimate_list_emp1_XML.xml

◆ 概要

上記の帳票は先程説明した“社員別見積リスト 1”です。レポートの構成及び各機能の説明は

“社員別見積リスト 1”をご覧下さい。ここでは、データソースに XML Schema ファイルを使用した PDF 生成の方法に

ついて説明します。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 79

◆ 解説(Java モード) <注意>

XML データソースの使用方法は、Java モードと.NET モードでは設定方法が異なりますのでご注意意下さい。

.NET モードの解説は次頁を参照して下さい。 ● XML Schema ファイル WebReportCafe では、レポートで使用するデータソースに XML Schema ファイルを使用することが出来ます。

データ定義 XML ファイルは複数の RowSet オブジェクト、データベースで言うところのテーブルデータを、保持する

ことができます。データ定義部では、保持する RowSet オブジェクトに所属する、カラムの名称と型の情報と、RowSet

同士の外部参照キーを、XMLSchema 形式で記述し定義します。

※データ定義 XML ファイルの詳細及び記述方法につきましては、「補足説明 : データ定義 XML ファイルと CSV

ファイルについて」を参照して下さい。

● データソースの設定

● データソースファイルの設定

● データ行セット名の設定

サンプル「社員別見積リスト 1」はサブレポートセクションを使用していますので、サブレポートセクションのプロパティ

も同様に[データ行セット名]を指定する必要があります。 PDF プレビューを行い、SQL データソースと同様の PDF が作成されることを確認して下さい。

レポートのプロパティ[データソースタイプ]

を「XML データソース」を選択します。

レポートのプロパティ[データソースファイル]

に使用する XML Schema ファイルを指定します。

レポートのプロパティ[データ行セット名]

に使用する RowSet オブジェクト名(テーブルデータ名)を

指定します。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 80

◆ 解説 (.NET モード) XML Schema ファイル

WebReportCafe では、レポートで使用するデータソースに XML Schema ファイルを使用することが出来ます。XML

Schema ファイルは「ADO.NET」の DataSet オブジェクトから出力された XML Schema ファイルを使用することができ

ます。XML Schema ファイルには、データとスキーマが含まれている必要があります。又、複数のテーブルを使用す

る場合は、リレーション情報も含まれている必要があります。

データソースの設定

データソースファイルの設定

データセットテーブル名の設定

サンプル「社員別見積リスト 1」はサブレポートセクションを使用していますので、サブレポートセクションのプロパティ

も同様に[データ行セット名]を指定する必要があります。 PDF プレビューを行い、SQL データソースと同様の PDF が作成されることを確認して下さい。

レポートのプロパティ[データソースタイプ]

を「XML データソース」を選択します。

レポートのプロパティ[データソースファイル]

に使用する XML Schema ファイルを指定します。

レポートのプロパティ[データセットテーブル名]

に使用する RowSet オブジェクト名(テーブルデータ名)を

指定します。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 81

複数の CSV ファイルを使用した PDF 生成(Java モードのみ) ◆ サンプルで使用するファイル estimate_list1_CSV.xml

◆ 概要 上記の帳票は先程説明した“見積書 1”です。レポートの構成及び各機能の説明は“見積書 1”をご覧下さい。

ここでは、データソースに複数の CSV ファイルを使用した PDF 生成の方法について説明します。

角丸四角形

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 82

◆ 解説 ● CSV ファイル WebReportCafe では、レポートで使用するデータソースに CSV ファイルを使用することが出来ます。

又、複数の CSV ファイルを使用してリレーションを設定することが可能です。リレーションの設定は Designer 上から

GUI コンポーネントを利用して簡単に設定することが出来ます。

※データ定義 CSV ファイルの詳細及び記述方法につきましては、「補足説明 : データ定義 XML ファイルと CSV

ファイルについて」を参照して下さい。

● データソースの設定

● データソースファイルの設定

● サブレポートセクション リレーションの設定

PDF プレビューを行い、SQL データソースと同様の PDF が作成されることを確認して下さい。

レポートのプロパティ[データソースタイプ]

を「CSV データソース」を選択します。

レポートのプロパティ[データソースファイル]

に使用する CSV ファイルを指定します。

サブレポートセクションで使用するデータソースファイルを

指定した後、プロパティ[リレーションキー]に

親の CSV データとのリレーションを設定します。

親レポートとサブレポートのリレーション

のマッピングを GUI コンポーネントから

設定することが出来ます。

※使用方法につきまして、Designer の オンライ

ンドキュメントを参照して下さい

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 83

製品見積リスト ◆ サンプルで使用するファイル product_estimate.xml (SQL の場合) product_estimate_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の製品見積リストは、動的セクションレイヤーのページディテールにデータ項目を配置し、固定フォームレイヤ

ーにレイアウトされた表に重ねて表示する帳票です。

固定フォームレイヤーにデータ項目以外の表示オブジェクトが配置されています。動的セクションレイヤーのページ

ヘッダーは、固定フォームレイヤーに作成した表の、見出しの下までのエリアが高さに設定され、データが表示され

るページディテールの開始位置を決定しています。動的セクションレイヤーのページディテールには、データ項目

が配置され、表の行と同じ高さが設定されています。動的セクションレイヤーのページフッターは表の下部の罫線ま

での高さが設定され、ページディテールの終了位置を決定しています。

◆ レポート構成 ① 固定フォームレイヤー(ページフォーム)

② 動的セクションレイヤー:ページヘッダー

③ 動的セクションレイヤー:ページディテール

④ 動的セクションレイヤー:ページフッター

ページディテールに配置

されているデータ項目

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 84

◆ 解説 ● 固定フォームレイヤーと動的セクションレイヤーの合成 固定フォームレイヤーと動的セクションレイヤーを組み合わせることにより、簡単に帳票を作成することができます。

固定フォームレイヤーには、毎ページ必ず表示する、オブジェクトを配置し、ページ全体のレイアウトを設計します。

動的セクションのページディテールにデータ項目を配置し、データの表示位置が固定フォームレイヤーに作成した

レイアウトに合うように、ページヘッダーとページフッター、ページディテールの高さを調節します。

固定フォームレイヤーと動的セク

ションレイヤーの合成概念図

項目名1 項目名2

帳票

ページヘッダー

ページフッター

ページディテール

データ データ

ページヘッダー

ページフッター

ページディテール

データ データ

ページディテール

データ データ

ページディテール

データ データ

項目名1 項目名2

帳票

固定フォームレイヤー 動的セクションレイヤー

帳票生成

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 85

◆ PDF プレビュー ☆ 下図のようなPDFが生成されます。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 86

製品売上リスト(しおり付き) ◆ サンプルで使用するファイル product_list_sales_outline.xml

◆ 概要 上記の帳票「製品別売上リスト」は、グループセクションを用いて、製品名別に「見積管理番号」、「数量」、「売価」を

表示する帳票です。さらに、グループ化したデータの合計を表示しています。 また、グループヘッダーにしおりオブジェクトを配置し、グループセクションが表示されるごとに、製品名を PDF の

「しおり」として出力しています。 ◆ レポート構成 ① ページヘッダー ② グループヘッダー ③ ページディテール ④ グループフッター1 ⑤ グループフッター2 ⑥ ページフッター

しおりオブジェクト

② ③

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 87

◆ 解説 ● しおりオブジェクトについて

しおりオブジェクトはPDFのしおりを作成するオブジェクトです。しおりオブジェクトを配置したセクションが出力さ

れるページにリンクする、しおりを作成します。しおりの文字列は、数式プロパティに設定した計算式の戻り値とし

て、動的に生成することができます。しおりオブジェクトはデザイナ上ではアイコンとして表示されていますが、作

成された PDF には表示されません。 ● 計算式について

しおりオブジェクトは、しおりの文字列を生成する計算式を指定することができます。計算式プロパティのボタン

をクリックすると下記のような「数式入力」ダイアログが表示されます。

[フィールド名]リストボックスには、使用できる DB のフィールドのリストが表示されます。ダブルクリックすると選択し

たフィールドが大括弧(“[ ]”)に囲まれて[計算式]テキストボックスに表示されます。これにより、計算式の結果、また

は計算する一つの項としてデータベースフィールドの値を使用することができます。 [関数名]リストボックスには使用できる関数が表示されます。[関数名]リストボックスで任意の関数を選択すると、説

明欄に選択した関数の説明が表示されます。ダブルクリックすると、選択した関数が[計算式]テキストボックスに追

加されます。 オペランド欄には、使用できるオペランドがボタンとして表示されています。ボタンをクリックすると、オペランドが

[計算式]テキストボックスに追加されます。

※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 88

◆ PDF プレビュー ☆ 製品名がPDFのしおりとして出力されることを確認します。

しおり

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 89

見積ラベル ◆ サンプルで使用するファイル estimate_label.xml (SQL の場合) estimate_label _CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の見積もりラベル 1 は、幅を指定したページディテールを使用し、ディテールセクションを2列で出力する帳票

です。また、ページディテールに配置した画像には表示条件が設定してあり、画像の表示、非表示を、データを元

に動的に決定しています。 ◆ レポート構成 ① ページヘッダー ② ページディテール ③ ページフッター

表示条件付画像オブジェクト

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 90

◆ 解説 ● 幅を指定したページディテール

ページディテールに幅を指定すると、ページディテールを横に並べることができます。通常、ページディテール

はデータ毎に縦に並びますが、ページディテールに幅を指定すると、横にできた余白が埋まるまで、横に出力さ

れます。横の余白がページディテールの幅よりも少ない時に改行され、高さが足りなくなると改ページされます。

幅を指定したディテールの改行、改ページ

デフォルトではデザイナを使用してページディテールの幅を指定することはできません。幅を指定するために下

記の手順でデザイナの設定を変更します。 2. デザイナの[ツール]メニューから[環境設定]を選択します。 3. 表示された、「環境設定」ダイアログの[デザイナー]タブをクリックします。 4. チェックボックス[詳細セクションの水平繰り返しを可能にする]をチェックし[OK]ボタンを押します。

注意事項

幅を指定したページディテールと高さを予約したページディテールの同時設定は出来ません。 幅を指定したページディテールを使用した場合、ページディテールを複数配置できません(サブレポートエリ

アのページディテールは複数配置可能です)。

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

PageDetail

右余白が足りないので改行

右 余 白 が 足 り なく、且つ、下余白が足りないので改ページ

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 91

● 表示条件の指定 ページヘッダー、ページディテール等のセクションや、テキストオブジェクトや画像等の表示オブジェクトに表示

条件を設定できます。データベースのフィールドのデータを表示条件の論理式に含むことができるので、動的に

表示条件を決定することができます。 表示条件を設定するには、各オブジェクトの「表示条件」プロパティをクリックすると、「表示条件設定」ダイアログ

が表示されます。

[フィールド名]リストボックスには、使用できる DB のフィールドのリストが表示されます。ダブルクリックすると選択し

たフィールドが大括弧“[]”に囲まれて[計算式]テキストボックスに表示されます。これにより、表示条件の論理式の

計算する一つの項としてデータベースフィールドの値を使用することができます。 [関数名]リストボックスには使用できる関数が表示されます。[関数名]リストボックスで任意の関数を選択すると、説

明欄に選択した関数の説明が表示されます。ダブルクリックすると、選択した関数が[計算式]テキストボックスに追

加されます。 オペランド欄には、使用できるオペランドがボタンとして表示されています。ボタンをクリックすると、オペランドが

[計算式]テキストボックスに追加されます。 データフィールド、関数、及びオペランドを使用して、表示条件の論理式を作成します。

※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 92

◆ PDF プレビュー ☆ ディテールセクションが2列に並び、承認されたレコードだけ画像が表示されている事を確認してください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 93

販売予定表 ◆ サンプルで使用するファイル sales_plan_list.xml (SQL の場合) sales_plan_list _CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の販売予定表は、ページディテール、及びグループフッターに計算オブジェクトが配置された帳票です。ペー

ジディテールの計算オブジェクトでは、対応するデータ行のフィールドの値を使用して計算しています。また、グル

ープフッターの計算オブジェクトでは、合計オブジェクト及び、カウントオブジェクトの値を使用して計算しています。 ◆ レポート構成

① ページヘッダー ② ページディテール ③ グループフッター ④ ページフッター

計算式オブジェクト

合計項目(非表示)

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 94

◆ 解説 ● 計算オブジェクト

計算オブジェクトは、計算式プロパティに設定した式を計算し、結果を文字列として表示するオブジェクトです。

計算式プロパティをクリックし表示した、計算式ダイアログを使用して式を作成します。計算式ダイアログの使用方

法は、しおりオブジェクトの計算式ダイアログと同様です。前述の「製品売上リスト(しおり付き)」の「機能説明」を参

照してください。

● データフィールドを使用した計算 計算オブジェクトの計算式には、データフィールドの値を使用できます。 計算式ダイアログの[メインレポート項目]タブに、XReport に設定したデータソースの全てのデータフィールドが

列挙されます。サブレポートセクション又はサブレポートエリア内の、セクションに計算項目を配置した場合は、[サブレポート項目]タブにサブレポートに設定されているデータソースの全てのデータフィールドが列挙されます。サ

ブレポート内に配置された計算オブジェクトからは、[メインレポート項目]タブに列挙されているメインレポートのデ

ータフィールドにもアクセスできます。 データフィールドは、メインレポートの場合は”MainReport.” + [データフィールド名]、サブレポートの場合

は”SubReport.”+ [データフィールド名]という名称で、各タブに列挙されます。 列挙されたデータフィールドをダブルクリックすると、[式]テキストエリアに大括弧”[]”で囲まれて、クリックした文

字列が表示されます。計算式では大括弧で囲まれた文字列を、データフィールド名だと解釈しフィールドの値と

置き換えます。

● 合計オブジェクト及びカウントオブジェクトの値を使用した計算式 グループフッターに計算オブジェクトが配置されている場合、グループフッターに配置されている、合計オブジ

ェクト及びカウントオブジェクトの値を計算式で使用できます。メインレポート内のグループフッターの場合は[メイ

ンレポート項目]タブに、サブレポート内のグループフッターの場合は、[サブレポート項目]タブに、使用できるカウ

ントオブジェクト及び合計オブジェクトが列挙されます。 カウントオブジェクトは“GroupFooter.Count”、合計オブジェクトは“GroupFooter.Sum.”+[合計フィールド

名]で列挙されます。 GroupFooter に合計オブジェクト又はカウントオブジェクトが配置されていない場合は使用できません。

● 数値計算について 計算式で数値を扱う場合、データベースのカラム又は記述した数値が、double 型でも、WRC Engine 内部で

は java.lang.BigDecimal 型で扱われます。桁溢れによる数値誤差や、表示形式にご注意ください。

● 割り算について 割り算は小数点以下 32 桁まで求めます。解の小数点以下の桁数が 33 桁以上になる場合、33 桁目が四捨五

入され 32 桁に丸められます。

※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 95

◆ PDF プレビュー ☆ 計算項目に正しい値が表示されていることを確認してください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 96

社員別見積実績リスト ◆ サンプルで使用するファイル estimate_employee.xml(SQL の場合) estimate_employee_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 社員別見積実績リストは、ページディテールの高さが予約された帳票です。ページフォームで表の罫線、キャプショ

ンを配置して、グループフッター部分にて実績情報の合計オブジェクトを配置します。 ◆ レポート構成

① ページヘッダー ② ページディテール ③ ページディテール高さ予約部分 ④ グループフッター ⑤ ページフッター ⑥ ページフォーム

固定フォームレイヤー

動的セクションレイヤー

④ ページディテールの高さを予約(緑色斜線部分)

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 97

◆ 解説 ● 高さを予約したページディテール

ページディテールの高さを予約すると、予約した領域には他のセクションが出力されず、ページディテールを独

占的に出力します。この機能を活用して、ディテールに表示する件数を指定する帳票を作成することができます。

● 高さを予約したディテール出力イメージ 1.ディテールのデータを 5 件固定で表示する

2.上記レイアウトにて、ディテールのデータが 3 件の場合

デフォルトではページディテールの高さを予約することはできません。高さを予約するために下記の手順でデザ

イナの設定を変更します。

1.デザイナの[ツール]メニューから[環境設定]を選択します。 2.表示された、「環境設定」ダイアログの[デザイナー]タブをクリックします。 3.チェックボックス[詳細セクションの高さを予約する]をチェックし[OK]ボタンを押します。

● 注意事項

高さを予約したページディテールと幅を指定したページディテールの同時設定は出来ません。 高さを予約したページディテールを使用した場合、ページディテールを複数配置できません(サブレポートエ

リアのページディテールは複数配置可能です)。

ページヘッダー

ページディテール

ページディテール予約領域

グループフッター

データ出力時

ページヘッダー

ページディテール

ページディテール

ページディテール

ページディテール

ページヘッダー

グループフッター

ページディテール 5 件分の高さを予約する

ページディテール

ページディテール

ページディテール

グループフッター

グループフッターは、予約された領域の後にコントロールキーを確認して出力する。

ページディテール予約領域

5 件分の高さが予約されている為、グループフッターは予約された領域の後にコントロールキーを確認して出力する。

ページディテール

ページフッター ページフッター

ページフッター

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 98

◆ PDF プレビュー ☆ 予約高さの機能が動作していることを確認してください。

1 ページ

2 ページ

高さ予約領域

グループフッターにて合計を出力

改ページ処理の為、合計の出力を行わない

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 99

御見積票(正、副綴り) ◆ サンプルで使用するファイル estimate_list3.xml(SQL の場合)

動的セクションレイヤー

固定フォームレイヤー

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 100

◆ 概要 御見積票(正、副綴り)はページディテール、サブレポートエリア及びページフォームから構成される帳票です。ペ

ージディテールには 2 つのサブレポートエリアが配置されており、高さ予約及びあふれデータを無視しない設定が

されています。ページフォームには表の罫線とキャプションが配置されています。 ◆ レポート構成

① ページディテール ② サブレポートエリア

・ページディテール(高さ予約を使用、あふれデータを無視しない) ・グループフッター

③ サブレポートエリア2 ・ページディテール(高さ予約を使用、あふれデータを無視しない) ・グループフッター

④ ページフォーム ◆ 解説 サブレポートエリアの[あふれデータ無視]及びページディテールの[高さ予約]の 2 つの機能を使用しています。 高さ予約を使用する事により、出力位置が固定されている帳票の出力が容易になります。 サブレポートエリアで [あふれデータ無視]、[高さ予約]機能を使うことにより、御見積票(正、副綴り)のような複雑な

レイアウトの帳票の出力を可能にします。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 101

◆ PDF プレビュー ☆ 帳票が正しく出力されるいるか確認してください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 102

中国漢字、ハングル文字対応帳票 ◆ サンプルで使用するファイル chaina_Korea_sample.xml (SQL の場合) chaina_Korea_sample_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の帳票は、ハングル文字、及び中国漢字(簡体、繁体)を含んでいます。日本語、英字以外の文字を含む帳

票フォームは UTF-8 モードで作成する必要があります。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 103

◆ レポート構成 ① ハングル文字 ② 中国繁体漢字 ⑤ 中国簡体漢字

◆ 解説 ● UTF-8モードへ変更

テキストとして、帳票フォームに中国語、韓国語文字を埋め込みたい場合は、帳票フォームファイルのエンコード

を UTF-8 にする必要があります。

エンコードを変更するには下記の手順を行ってください。

1. [ツール]メニューの[環境設定]を選択し[環境設定]ダイアログを表示する

2. [環境設定]ダイアログの[デザイナータブ]をクリックする

3. [UTF-8 モード]チェックボックスをオンにし、[OK]ボタンをクリックする

※モードの変更は帳票を作成する 初に行ってください。途中からモードを変更すると、不正な帳票フォームとして

保存され、開けなくなる場合があります。

環境設定ダイアログ

● フォント名の指定 中国漢字及びハングル文字を使用する場合は、適切なフォントを指定する必要があります。WRC では指定さ

れたフォント名により、文字のエンコーディングを決定します。文字種、フォント名、エンコードの関係は下記の表

のようになります。

文字種 フォント名 エンコード

ハングル GulimChe MS949

繁体字中国語 MingLiU MS950

簡体字中国語 SimSun GBK

● その他注意点

UTF-8 モードをオンにした状態でテキストを入力する場合は、必ずプロパティエディタの[文字列]プロパティに対

する[…]ボタンをクリックし、テキストエディタダイアログを開いて入力してください。テキストエディタを使用せず、プロ

パティ上から直接入力した場合、UTF-8 で保存できずに、帳票フォームを開けなくなる場合があります。

※プロパティ上は文字化けして表示されますが、値としては保存されます。

※バーコード及び QR コードの[データ]プロパティに対しても同様の作業をしてください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 104

◆ PDF プレビュー ☆ ハングル、中国語繁体漢字、中国語簡体漢字が文字化けせずに表示されることを確認してください。

※PDF でハングル文字や中国漢字を表示する場合は、それぞれの言語に対するフォントセットをダウンロードする

必要があります。通常は、AdobeReader で PDF ファイルを開く際に、自動的にダウンロードされます。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 105

複数ページの帳票レイアウト ◆ サンプルで使用するファイル complex_form.xml(SQL の場合) complex_form_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

1ページ目 「宛先ラベル」

2 ページ目 「見積書先」

3 ページ目 「FAX 注文書」

全体イメージ

郵政カスタマバーコード

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 106

◆ 概要 上記の帳票では、1つの帳票フォームに3つのページレイアウトを作成しています。又、1ページ目の「宛先ラベル」

では、郵政カスタマバーコードを使用しています。 ◆ レポート構成

① グループヘッダー (「宛先ラベル」) ② サブレポートセクション 1 (「見積書」)

③ サブレポートセクション 2 (「FAX 注文書」)

◆ 解説

● 複数ページのレイアウト

WebReportCafe Designer では、複数ページのレイアウトを作成することが出来ます。サンプルでは、グループヘ

ッダーとサブレポートセクションを使用して、3つのページレイアウトを作成しています。

<注意事項>

1つのセクション(ページディテール、グループセクション、サブレポートセクションなど)は複数ページにまたがるこ

とはできません。

● 郵政カスタマバーコード

WebReportCafeで郵便カスタマバーコードを使用する場合、郵便番号及び番地から抜き出される、半角英数文字

か、ハイフンの文字列を入力データとして渡す必要があります。

はじめの7桁はハイフンなしの郵便番号の英数字を指定します。それ以降は丁番号、番地、号、部屋番号等を示

す英数字をハイフンで区切って指定します。

例)〒101-0021 東京都千代田区外神田二丁目十五番地二号 新神田ビルA6 の場合、

「101 0021 2 15 2 A6」を抜き出しハイフンで編集する。

「10100212-15-2-A6」を入力データとして使用する

バーコード内部では、数字とハイフンを1桁、英字を2桁として扱われ、20桁目以降は切り捨てられます。切り捨て

はWRC内部ので処理されますので、ユーザが意識する必要はありません。

下記のような場合は、入力データエラーとなり例外が発生します。

・入力データが7桁未満

・上7桁に、数字以外の文字が設定されている

・上7桁以降の文字に、英数字とハイフン以外の文字が指定されている

カスタマバーコードの詳しい仕様については、郵便ホームページ(http://www.post.yusei.go.jp)の「郵便番号制マ

ニュアル」を参考にしてください。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 107

◆ PDF プレビュー

1ページ目に「宛先ラベル」が表

示されます。

2 ページ目に「見積書」が表示

されます。

3 ページ目に「FAX 注文書」が

表示されます。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 108

部署別実績リスト ◆ サンプルで使用するファイル estimate_dept.xml(SQL の場合) estimate_dept_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 部署別実績リストは、部署別にグループ化された一覧の帳票です。この帳票ではグループ総ページ、ページ番号

のグループリセット機能を利用して、グループ毎の総合計ページとページ番号を表示します。又、行番号もグルー

プ毎にリセットしています。 ◆ レポート構成

① ページヘッダー ② グループヘッダー ③ ページディテール ④ グループフッター ⑤ ページフッター

動的セクションレイヤー

グループ総ページオブジェクト

ページ No オブジェクト

※この帳票ではグループ毎にリセット

されます。

行番号オブジェクト

※この帳票ではグループ毎にリセットさ

れます。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 109

◆ 解説

● グループ総ページ

グループ毎の総ページを表示するためのオブジェクトです。グループフッターが出力される毎のページ数が出

力されます。使用方法は、[グループフッターリセット]プロパティに、グループ化するグループフッターを指定しま

す。[グループフッターリセット]プロパティに値を設定しない場合は[-1]と表示されます。

<注意事項>

・グループ総ページオブジェクトは、対象データを捜索してグループ総ページを取得します。大量帳票などを扱

う場合は処理時間がかかる場合があります。

・プログラムでセクションの表示・非表示を切り替えた場合や、セクションオブジェクトの高さを動的に変更した場

合は、グループ総ページを正しく取得できない場合があります。

● ページ No オブジェクトのリセット

ページNoオブジェクトは現在のページ番号を表示するオブジェクトです。グループ毎のページ番号を表示した

い場合は、グループフッターセクションの[ページ番号リセット]プロパティを“はい”に設定することで、対象のグ

ループフッターが表示された時にページ番号のリセットが行われます。

● 行番号オブジェクトのリセット

行番号オブジェクトはデータソースから取得したデータの行番号を表示するオブジェクトです。グループ毎の行

行番号を表示したい場合は、グループフッターセクションの[行番号リセット]プロパティを“はい”に設定するこ

とで、対象のグループフッターが表示された時に行番号のリセットが行われます。

又、レポートの[新規ページ行番号リセット]プロパティを“はい”に設定することで、改ページが発生した際に

行番号のリセットを行うことも出来ます。

<注意事項>

サブレポートセクションで発生する改ページでは、親の行番号はリセットされません。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 110

◆ PDFプレビュー

グループ毎の総ページと、ページ

番号が表示されています。

グループ毎の総ページと、ページ

番号が表示されています。

グループが変わると行番号がリセ

ットされます。

部署が「営業」から「マーケティング事業部」へと変更

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 111

PDF フォームを利用した見積書 ◆ サンプルで使用するファイル estimate_formlist.xml (SQL の場合) estimate_formlist_CSV.xml (CSV ファイルの場合 ※Java モードのみ)

◆ 概要 上記の見積書は、PDF フォーム機能を利用した入力可能な PDF です。テキストフィールド、リストボックスなどの入

力インターフェースを持つ PDF フォームオブジェクトを設定することで、入力可能な対話型の PDF 文書を作成する

ことが出来ます。 ◆ レポート構成 ① ページヘッダー ② ページディテール ③ サブレポートセクション ④ ページフッター

テキストフィールドオブジェクト

リストボックスオブジェクト 計算テキストフィールドオブジェクト

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 112

◆ 解説 ● PDF フォームとは

PDF にテキストフィールド、ボタン(サブミットボタン、リセットボタン)などの入力インターフェースを設定すること

ができます。従来の PDF では、閲覧、印刷とういう利用方法でしたが、PDF フォームを活用することで入力可能

な対話型の PDF 文書を作成することが出来ます。 又、PDF フォームでは入力された値をサーバーに送受信するようなリッチクライアント文書も作成することが出来

ます。 [PDF フォームオブジェクト] ・ テキストフィールド ・ 計算テキストフィールド ・ サブミットボタン ・ リセットボタン ・ リストボックス ・ コンボボックス ・ ラジオボタン ・ チェックボックス

<注意事項> PDF フォームオブジェクトはダイレクト印刷及びイメージ出力の際には評価されません。

● PDF フォームオブジェクトのフォームフィールド名

サーバーにデータを送信する際、計算を行う際にオブジェクトを特定するためのプロパティが[フォームフィール

ド名]です。PDF では [フォームフィールド名]が同一の場合は1つのオブジェクトとして扱われる為、名前が重複

した場合は正しく値を送信・計算できない場合があります。[連続番号]プロパティを“はい”に設定することで[フォ

ームフィールド名]に識別番号(メインレポートの行番号_サブレポートの行番号 )をつけることが可能です。

● PDF フォームオブジェクトのデータ連携

PDF フォームオブジェクトは Data オブジェクトなどと同じように、データフィールドの値を取得することが出来ま

す。PDF フォームオブジェクトの[フィールド名]プロパティにデータフィールド名を設定することで、データソースか

ら取得した値を PDF フォームオブジェクトに表示することが出来ます。 ◆ ラジオボタン、チェックボックス ラジオボタン、チェックボックスの場合は、データソースから取得した値が[書き出し値]プロパティと一致する場合

にチェックが付きます。 ◆ コンボボックス、リストボックス

コンボボックス、リストボックスの場合は、データソースから取得した値が[選択肢]プロパティに設定した[送信値]と一致する場合に対応する[表示値]が表示されます。

● PDF フォームオブジェクトのデータ送受信

PDF フォームオブジェクトは表示オブジェクト(Data、Text、Image)とは異なり、入力された値をサーバーに送

受信することができます。送信方法は、HTML と同様に POST、GET を指定することや、FDF、XFDF、PDF な

どのデータ形式で送信することも可能です。 ※FDF、XFDF につきましては、Adobe 社のホームページをご参照下さい。 サーバー側にデータを送る際には[フォームフィールド名]がキーとなり、入力された値、データが送信されます。

[フォームフィールド名]が同一の場合は1つのオブジェクトとして扱われる為、名前が重複した場合は正しく値を送

信できない場合があります。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 113

● PDF フォームオブジェクトの計算

テキストフィールドの[計算タイプ]プロパティを使用することで、入力された値を計算することが出来ます。

図:計算設定ダイアログ

計算タイプには和、積、平均、 大、 小などの関数に加え、独自の計算スクリプト(JavaScript)を設定する

ことが出来ます。式の計算は値の入力後に計算が行われます。レポートの「フォーム自動計算」プロパティが

“はい”の場合は、PDF 表示時にも計算が行われます。 ◆ 計算式テキストフィールドオブジェクト 計算式テキストフィールドオブジェクトは、グループフッターに配置することの出来る特殊なオブジェクトです。

グループ化されたデータの合計値を計算したいときなどに使用します。使用方法はテキストフィールドと同じ

です。 ◆ 連続番号を使用した計算 [連続番号]プロパティが“はい”のオブジェクトに関しては、実行時に識別番号が付加されます。 又、計算スクリプト中に getField("フォームフィールド名")という記述がある場合も同様に実行時に識別番号

が付加されます。 ※[連続番号]プロパティが“はい”に設定されているオブジェクトを計算する時は、計算タイプを設定する側の

オブジェクトの[連続番号]プロパティも“はい”に設定する必要があります。 ※使用方法はサンプル帳票を参照して下さい。

※PDF フォームで使用する Javascript につきましては、Adobe 社のホームページを参照して下さい。 ※各機能の詳細はオンラインヘルプの[オブジェクトリファレンス]を参照して下さい。

Copyright(C) SIOS Technology, Inc.

第 6 章 いろいろな帳票サンプル 114

◆ PDF プレビュー

計算タイプが指定されてい

るテキストフィールド

入力可能なテキストフィールド

Copyright(C) SIOS Technology, Inc.

第 7 章 帳票フォーム(XML ファイル) 115

第 7 章 帳票フォーム(XML ファイル) 帳票フォームは、帳票のレイアウト情報を持つ XML 形式のファイルです。この帳票フォームを元に PDF は生成さ

れます。XML の各要素は、WebReportCafe が持つ xreport パッケージの各クラスに対応しています。プログラム

の組み込みを行う際には、以下の情報が必要になりますので、よく理解してください。 なお、帳票フォームの具体的な作成方法については、[第3章 はじめての帳票作成]を参照してください。まずは、

も簡単な帳票フォームを元に、帳票フォームの構造について説明します。

も簡単な帳票フォーム Designer を起動すると、右図の帳票イメージが表示されます。全ての帳

票は必ずページヘッダー、ページディテール、ページフッターの3つの

セクションオブジェクトが存在します。これらのセクションオブジェクトに、

線、四角形、テキストなど、さまざまなオブジェクトを配置していきます。 作成した帳票イメージを保存すると、XML形式の帳票フォームが出来上

がります。この XML にあるレイアウト情報を元に、PDF の生成が行われ

ます。 右下の図は、右図の帳票イメージから作成された帳票フォームの情報で

す。各オブジェクトには、名前、幅、高さなどのプロパティがあります。 ①帳票フォーム全体の情報

<?xml version="1.0" encoding="Shift_JIS" ?>

<XReport DesignByCraft="true"

DefaultBaseFont="ms mincho"

DefaultCharSize="10"

DefaultDateFormat="yyyy/MM/dd"

Width="561" Height="808" Size="a4"

PageWidth="595"PageHeight="842"

Horizontal="false" MarginLeft="17"

MarginTop="17" SQL="" >

<PageHeader Name="PageHeader1" Height="72" />

<PageDetail Name="PageDetail1" Height="72" />

<PageFooter Name="PageFooter1" Height="72" />

</XReport>

PageHeader1

PageDetail1

PageFooter1

ページヘッダー

ページディテール

ページフッター

オブジェクト

プロパティ

②ページヘッダーの情報

③ページディテールの情報 ④ページフッターの情報

Copyright(C) SIOS Technology, Inc.

第 7 章 帳票フォーム(XML ファイル) 116

オブジェクトを追加した帳票フォーム 次に、オブジェクトを追加した帳票フォームについて説明します。 先ほどの も簡単な帳票フォームとは異なり、4つのオブジェクトが新たに追加されています。 下記は、右図の帳票イメージから作成された帳票フォームの情報です。

先ほどの帳票フォームとの違いは、テキスト(Text)、線(Graphics)、四角

形(Graphics)、ページディテール(PageDetail)のオブジェクトが新たに

追加されている点です。 帳票フォームに記述されている各オブジェクトの情報は、階層構造をとり

ます。レポート(Xreport)の下に、ページセクションの PageHeader、

PageDetail、PageFooter があり、PageDetail の下に、表示オブジェク

トの Text,Graphics が記述されていることに注目してください。 なお、ここで紹介したオブジェクト以外にも、さまざまな機能を持った多く

のオブジェクトがあります。各オブジェクトの機能は次に説明します。

PageHeader XReport

Text

Graphics

Graphics

PageFooter

PageDetail

PageDetail

(線)

(四角形)

PageHeader1

PageDetail1

PageFooter1

PageDetail1

テキスト

四角形

ページディテール

あいうえお

<?xml version="1.0" encoding="Shift_JIS" ?>

<XReport DesignByCraft="true"DefaultBaseFont="ms mincho"

DefaultCharSize="10" DefaultDateFormat="yyyy/MM/dd"

Width="561" Height="808" Size="a4" PageWidth="595"

PageHeight="842" Horizontal="false" MarginLeft="17"

MarginTop="17" SQL="" >

<PageHeader Name="PageHeader1" Height="72" />

<PageDetail Name="PageDetail1" Height="404" >

<Text Name="Text1" Top="49" Left="43" Width="156" Height="30"

CharSize="30" Length="156" >あいうえお</Text>

<Graphics Name="Line1" Top="119" Left="43"

Width="72"Height="0" Style="hline" />

<Graphics Name="Rect1" Top="163" Left="43"

Width="72" Height="36" Style="srect" />

</PageDetail>

<PageDetail Name="PageDetail2" Height="72" />

<PageFooter Name="PageFooter1" Height="72" />

</XReport>

Copyright(C) SIOS Technology, Inc.

第 7 章 帳票フォーム(XML ファイル) 117

オブジェクトの種類 WebReportCafe には、帳票フォームを作成するためのさまざまなオブジェクトが用意されています。これらを組み

合わせることで、ユーザーの用途に合った帳票フォームを作成することができます。 基本 帳票の基本構成は、帳票全体の情報を持つ[レポート]があり、その子供として、[ページヘッダー]などのページセク

ション情報があり、その子供として[テキスト]などの表示オブジェクトがあるという構造です。 [レポート]

+ [ページヘッダー] + [ページディテール]

+ [テキスト] + [ページフッター]

レポート(XReport) オブジェクト名 対応クラス 簡単な説明 レポート XReport 帳票フォーム全体の情報(用紙サイズ、横用紙、余白、標準フ

ォント、SQL など)を扱う。 ページセクション(PageSection) オブジェクト名 対応クラス 簡単な説明 ページヘッダー PageHeader ページの題名、出力日、ページ No などを配置する。 ページディテール PageDetail 図形、イメージ、テキスト、データ、サブレポートエリアなどを配

置できる。 ページフッター PageFooter 出力日、ページ No、などを配置する。

表示オブジェクト(PrintObject) オブジェクト名 対応クラス 簡単な説明 直線 Graphics 実線、破線を描画できる。 四角形 Graphics 四角形を描画できる。内部、外枠の色を指定できる。

楕円 Circle 楕円を描画できる。内部、外枠の色を指定できる。 角丸四角形 Graphics 角丸四角形を描画できる。内部、外枠の色を指定できる。 バーコード Barcode バーコードを描画できる。

CODE39,CODE128,JAN8,JAN13 を指定できる。 イメージ Image JPEG、GIF 形式の画像を利用できる。 テキスト Text さまざまな書式の文字列を扱うことができる。複数行の文字列

を扱うこともできる。 データ Data データベースからのデータを表示できる。 日時 Now 現在の時刻を表示できる。 ページ No PageNo ページ No を表示できる。 総ページ番号 TotalPageNo 総ページ No を表示できる。 行番号 RowNo SQL の行番号を表示できる。 キャプション Caption フィールド名に指定した見出しを表示できる。 しおり Outline しおりを作成する。 計算式 Expression 指定された式を計算し結果を表示できる。 QR コード QRcode QR コードモデル2を描画できる。 イメージデータ ImageData イメージを描画できる。

※データソースから取得したフィールドの値をイメージのパスに

設定することが出来ます。 郵政カスタマバーコ

ード CustomerBarcode 郵便カスタマバーコードを表示できる。

PDF417 バーコード PDF417Barcode PDF417 バーコードを表示できる。

Copyright(C) SIOS Technology, Inc.

第 7 章 帳票フォーム(XML ファイル) 118

グループ総ページ GroupTotalPageNo グループ総ページ番号を表示できる。 グループフッターが出力される毎のページ数が出力されます。

サブミットボタン FormSubmit PDFフォームのサブミットボタンを表示できる。 リセットボタン FormReset PDFフォームのリセットボタンを表示できる。 ラジオボタン FormRadio PDFフォームのラジオボタンを表示できる。 チェックボタン FormCheck PDFフォームのチェックボックスを表示できる。 テキストフィールド FormText PDFフォームのテキストフィールドを表示できる。 コンボボックス FormCombo PDFフォームのコンボボックスを表示できる。 リストボックス FormList PDFフォームのリストボックスを表示できる。 計算テキストフィール

ド FormCalcText PDFフォームの計算テキストフィールドを表示できる。

計算テキストフィールドとは、グループフッターに配置できる、

ディテールセクションに配置されたフィールド内の数値を計算

できるフィールドです。

Copyright(C) SIOS Technology, Inc.

第 7 章 帳票フォーム(XML ファイル) 119

グループ 以下のオブジェクトを用いることで、データをグループ化して表示することができます。 [レポート]

+ [ページヘッダー] + [グループヘッダー] + [ページディテール] + [グループフッター] + [合計] + [カウント] + [ページフッター]

ページセクション(PageSection) オブジェクト名 対応クラス 簡単な説明 グループヘッダー GroupHeader コントロールキーとして指定したデータが切り替わるかどうか

を調べ、切り替わった際、グループヘッダーを表示する。こ

れにより、データをグループ化して表示することができる。 グループフッター GroupFooter コントロールキーとして指定したデータが切り替わるかどうか

を調べ、切り替わった際、グループフッターを表示する。これ

により、データをグループ化して表示することができる。 合計、カウントを配置できる。

表示オブジェクト(PrintObject) オブジェクト名 対応クラス 簡単な説明 合計 Sum 指定したフィールド名の合計値を表示できる。 カウント Count 指定したフィールド名の行数を表示できる。

Copyright(C) SIOS Technology, Inc.

第 7 章 帳票フォーム(XML ファイル) 120

サブレポート 以下のオブジェクトを用いることで、サブレポート化することができます。サブレポートとは、ページヘッダー、ページ

ディテール、ページフッターなどのページセクションを持つことができる帳票フォームを小型化したオブジェクトです。

特殊なものとして、サブレポートエリアがあります。 [レポート]

+ [ページヘッダー] + [ページディテール]

+ [サブレポートエリア] + [ページヘッダー] + [ページディテール] + [ページフッター]

+ [サブレポートセクション] + [ページヘッダー] + [ページディテール] + [ページフッター]

+ [ページフッター] ページセクション(PageSection) オブジェクト名 対応クラス 簡単な説明 サブレポートセクション SubReportSection ページヘッダー、ディテール、フッターを持つ、サブレポ

ート化したセクション。 SQL を持つことが出来る。

表示オブジェクト(PrintObject) オブジェクト名 対応クラス 簡単な説明 サブレポートエリア SubReportArea サブレポートセクションをエリア化したもの。大きさ、配置を

自由に指定できる。 SQL を持つことが出来る。

上記オブジェクトに付属したプロパティについては、オンラインヘルプの[オブジェクトリファレンス]及び API ドキュ

メントをご覧ください。

Copyright(C) SIOS Technology, Inc.

121 補足説明 121

補足説明 ◆ Java モードと.NET モードの切り替え方法 WebReportCafe では1つの Designer で、Java、Microsoft.NET 環境で利用できる帳票レイアウトを作成することが出

来ます。モードを切り替える場合は、<INSTALL_DIR>\bin\WRCDSelect.exe を起動して下さい。WRC デザイナセレ

クタというアプリケーションが起動しますので、[Java]又は[,NET]のオプションを選択して、設定ボタンを押しますとモ

ードを切り替えることが出来ます。

◆ Java モードと.NET モードの差異について 基本的な使用方法は同じですが、2つのモードでは以下の差異があります。

・ データ接続に JDBC(Java モード)、ODBC(.NET モード)を利用しています。

・ サブレポート(サブレポートエリア、サブレポートセクション)のリレーション方法が異なります。

※ 詳細につきましては帳票サンプルの解説をご参照下さい。

・ Java モードのみに、レポートの[データソースタイプ] プロパティに CSV ファイルを設定可能です。。

・ Java モードのみに、PDF フォームのリストボックス、コンボボックスに[SQL]を設定できるプロパティがあります。

・ Java モードのみに、レポートの[JAI]を設定できるプロパティがあります。

◆ フォントについて WebReportCafe は、以下のフォントをサポートしています。もし、下記フォントを指定しているのにも関わらず、フォ

ントが正しく表示されない場合は、これらのフォントが[コントロールパネル]の[フォント]に含まれているか調べてくだ

さい。 又、下記のフォント以外のフォントを指定したい場合は、 Text/Data オブジェクトの[フォント]プロパティに直接フォ

ント名を指定することが出来ます。 (例) OCRB、GPGyoshotai など << フォントを指定した場合の注意事項 >> 1.指定されたフォント名が OS に存在しない場合は正しく表示されない場合があります。 2.指定されたフォントは全て等幅フォントで出力されます。その為、指定するフォントによっては出力位置や文字幅

などが正しく出力されない場合があります。 ・ MS 明朝 ・ MSP ゴシック ・ MS ゴシック ・ MSP 明朝 ・ DFPOP 体 ・ DFPPOP 体 ・ DFP 特太ゴシック体 ・ DF 特太ゴシック体 ・ HG ゴシック E-PRO ・ HG 丸ゴシック M-PRO ・ HG 正楷書体-PRO ・ Courier ・ Helvetica ・ Times-Roman ・ GulimChe (ハングル文字フォント) ・ MingLiU (繁体字中国語フォント) ・ SimSun (簡体字中国語フォント)

Copyright(C) SIOS Technology, Inc.

122 補足説明 122

◆ イメージ及び JAI について(Java モードのみ) WebReportCafe で扱えるイメージ形式は GIF, JPEG, PNG, TIFF, BMP の 5 種類です。 ・ TIFF, BMP を使用する場合は、JAI(Java Advanced Imaging)をインストールする必要があります。 ・ JAI を使用する場合は、レポートの[JAI]プロパティを”はい”にする必要があります。 ・ JAI(Java Advanced Imaging)の入手方法について http://java.sun.com/products/java-media/jai/ よりJAIをダウンロードしてください。

ダウンロードしたファイルを展開すると jai_core.jar と jai_codec.jar ファイルが取得できます。・ ・ jai_codec.jar,jai_core.jar ファイルを[環境設定]で設定することで Designer で有効となります。 ◆ オブジェクトの位置、幅、高さなどの指定について Designer は、内部でセンチメートルとピクセルの変換を行っているため、指定した数値によっては誤差が生じる場

合があります。例えば、オブジェクトの幅を、[1cm]と設定しても、実際には[0.99cm]になってしまう、などです。 ◆ サブレポート内でのグループセクションの利用について コントロールキーに設定できる[選択できる項目]には、グループセクションを追加したレポートが取得したカラム名が

表示されます。よって、サブレポートセクションにグループセクションを追加した場合、サブレポートセクションが取得

したカラム名が[選択できる項目]に表示されます。

◆ サブレポート機能の入れ子について サブレポートセクション及び、サブレポートエリアの入れ子はできません。 サブレポートセクション及び、サブレポートエリア自身の入れ子はもちろん、 サブレポートセクションにサブレポートエリアを挿入することや、サブレポートエリアにサブレポートセクションを挿入

することもできません。 ◆ SQL のコメントについて コメントの記述は、「/* 文字列 */」のみ有効です。「-- 文字列」は利用できません。 OK SELECT SHAIN_ID /* 社員 ID */ FROM SHAIN NG SELECT SHAIN_ID -- 社員 ID FROM SHAIN

Copyright(C) SIOS Technology, Inc.

123 補足説明 123

◆ 外字フォントの埋め込み機能について

WRC では、Windows 上で作成した外字フォント(EUDC.TTE)を PDF に埋め込むことが出来ます。

外字フォントを埋め込むことによって、PDF を閲覧するクライアントに外字をインストールする必要はありません。

外字の使用領域は、Unicode の使用領域 E000~F8FF までの 6400 文字を使用することが出来ます。

埋め込まれた外字ファイルは、WRC Engine 内で Unicode でマッピングされます。

Windows(EUDC.TTE ファイル)

外字を出力できるオブジェクトは、Text オブジェクトと Data オブジェクトです。外字を出力したい場合は、

プロパティ「外字」を“はい”に設定することで外字を出力することができます。外字ファイルの読込み方法につきまし

ては、WRC Engine のドキュメント及び API ドキュメントを参照して下さい。

◆ ページヘッダー及びページフッター使用時の注意事項 計算式オブジェクト・Data オブジェクト使用時の注意事項

ページヘッダー及びページフッター内に Data オブジェクト及び計算式オブジェクト(表示条件プロパティ)を使用し

てデータフィールド内の値を参照・取得することは推奨されていません。

又、計算式オブジェクトの getCurrentRowIndex()関数を使用してデータフィールドの行番号の値を参照・取得するこ

とも推奨されていません。

※レイアウト・条件によって期待する値を取得することが出来ない可能性があります。

ページヘッダー、ページフッターではデータフィールド内の値を参照・取得しないようにして下さい。

※サブレポートエリアをページヘッダー、ページフッターで使用した場合も、SQL のバインドパラメーター、計算式等

を使用して親レポートのデータの値を参照することは推奨されていません。

表示条件の注意事項(ページフッターのみ)

表示条件が設定されたプリントオブジェクト、セクションなどは通常そのオブジェクトが表示する前に表

示条件式の評価を行います。ページフッターに関しましては、表示条件の評価をページヘッダーと同様の

タイミングで行います。その為、前述の「計算式オブジェクト使用時の注意事項」と同様、データフィール

ド内の値を参照・取得することは推奨されていません。

◆ 下絵機能の注意事項

表示する下絵イメージファイルのサイズが大きい場合、レイアウト作成に支障をきたす場合があります。マシンスペッ

クにもよりますが、下絵機能で利用するイメージファイルのサイズは 600kbyte 以下を推奨しています。

Unicode E000

WRC Engine

外字ファイル

の取り込みDB

XML

CSV

ファイル

PDF

デ ー タ の 取 込

読み込んだデータに「E000」

の文字が含まれている場合、

Windows上で登録された文字

とマッピングされ PDF に出力

されます

Copyright(C) SIOS Technology, Inc.

124 補足説明 124

◆ 中国語及び韓国語対応について

データの値として中国語及び韓国語文字を使用し、帳票に表示したい場合は、それぞれに対するフォントを指定

する必要があります。それぞれの言語に対するフォントを指定してください。中国語及び韓国語フォントを指定した

場合、PDFにはフォントに対応するエンコードで文字データが埋め込まれます。

文字種、フォント、エンコードの関係は下記の表になります。

文字種 フォント名 エンコード

ハングル GulimChe MS949

繁体字中国語 MingLiU MS950

簡体字中国語 SimSun GBK

テキストとして、帳票フォームに中国語、韓国語文字を埋め込みたい場合は、フォントの指定及び、帳票フォーム

事態のファイルのエンコードモードを使用する必要があります。

エンコードモードを変更するには下記の手順を行ってください。

4. [ツール]メニューの[環境設定]を選択し[環境設定]ダイアログを表示する

5. [環境設定]ダイアログの[デザイナータブ]をクリックする

6. [UTF-8 モード]チェックボックスをオンにし、[OK]ボタンをクリックする

※モードの変更は帳票を作成する 初に行ってください。途中からモードを変更すると、不正な帳票フォームとして

保存され、開けなくなる場合があります。

環境設定ダイアログ

UTF-8 モードをオンにした状態でテキストを入力する場合は、必ずプロパティエディタの[文字列]プロパティに対

する[…]ボタンをクリックし、テキストエディタダイアログを開いて入力してください。テキストエディタを使用せず、プロ

パティ上から直接入力した場合、UTF-8 で保存できずに、帳票フォームを開けなくなる場合があります。

※プロパティ上は文字化けして表示されますが、値としては保存されます。

※バーコード及び QR コードの[データ]プロパティに対しても同様の作業をしてください。

Copyright(C) SIOS Technology, Inc.

125 補足説明 125

◆ データ定義 XML ファイルと CSV ファイルについて

帳票で使用するデータソースに、データベース、CSV ファイル、XML ファイルを使用することが出来ます。ここでは、

XML ファイルと CSV ファイルのデータ定義方法についてご説明します。

データ定義 XML 作成方法

● .NET モードの場合

WebReportCafe では、レポートで使用するデータソースに XML Schema ファイルを使用することが出来ます。XML

Schema ファイルは「ADO.NET」の DataSet オブジェクトから出力された XML Schema ファイルを使用することができ

ます。XML Schema ファイルには、データとスキーマが含まれている必要があります。又、複数のテーブルを使用す

る場合は、リレーション情報も含まれている必要があります

● Java モードの場合

データ定義 XML ファイルは、定義名タグで囲んだ、「データ定義部」と「データ部」の二つの部分に分割できます。

「データ定義部」はデータの項目名と型を XMLSchema 形式で記述します。

「データ部」は帳票で使用するデータを「データ定義部」で宣言した形式で記述します。

データ定義部」を「データ部」よりも上部に記述する必要があります。

<?xml version="1.0" encoding="Windows-31J" ?> <EmpDataSet xmlns="http://www.10art-ni.co.jp/EmpDataSet.xsd"> <!—定義名タグ <!--データ定義部--> <xs:schema id="EmpDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" > <xs:element name="EmpDataSet"> <xs:complexType> <xs:choice maxOccurs="unbounded"> <xs:element name="EMP_DPT"> <xs:complexType> <xs:sequence> <xs:element name="EMPLOYEE_NAME" type="xs:string" /> <xs:element name="EMPLOYEE_CODE" type="xs:string" /> <xs:element name="DEPARTMENT_NAME" type="xs:string" /> <xs:element name="ADDRESS" type="xs:string" minOccurs="0" /> </xs:sequence> </xs:complexType> </xs:element> </xs:choice> </xs:complexType> <xs:unique name="EmpDataSetKey1" > <xs:selector xpath=".//EMP_DPT" /> <xs:field xpath="EMPLOYEE_CODE" /> </xs:unique> </xs:element> </xs:schema> <!--データ部--> <EMP_DPT> <EMPLOYEE_NAME>松田 清文</EMPLOYEE_NAME> <EMPLOYEE_CODE>20010010</EMPLOYEE_CODE> <DEPARTMENT_NAME>営業部</DEPARTMENT_NAME> </EMP_DPT> <EMP_DPT> <EMPLOYEE_NAME>長嶋 幸宏</EMPLOYEE_NAME> <EMPLOYEE_CODE>20010011</EMPLOYEE_CODE> <DEPARTMENT_NAME>製品開発部</DEPARTMENT_NAME> </EMP_DPT> </EmpDataSet>

Copyright(C) SIOS Technology, Inc.

126 補足説明 126

データ定義部

データ定義 XML ファイルは複数の RowSet オブジェクト、データベースで言うところのテーブルデータを、保持す

ることができます。データ定義部では、保持する RowSet オブジェクトに所属する、カラムの名称と型の情報と、

RowSet 同士の外部参照キーを、XMLSchema 形式で記述し定義します。

実際の定義部の記述方法は下記の通りです。

1. schema タグで囲み、XMLSchema の宣言を行います。

schema タグの属性としてスキーマタグの名前空間の名前付けをします。名前付け方法は schema タグの属

性として、

“xmlns:[名称]=”http://www.w3.org/2001/XMLSchemna””

を記述します。[名称]にはデータ定義部の名称として任意の文字列を指定します。この文字列を定義部で

記述される全てのタグ名の先頭に必ず記述し、タグ名と名称の間には“:”(コロン)を記述します。

2. element タグを記述します。

name 属性には定義名タグとに使用した文字列を記述してください。

3. complexType タグを記述します。

4. choice タグを記述します。

5. element タグを記述します。

この element タグの間に RowSet のカラム定義を行います。name 属性には、定義する RowSet の名称を指

定します。この名称は、データ部で行を囲むタグの名称になります。

6. complexType タグを記述します。

7. sequence タグを記述します。

8. element タグにカラム情報を記述します。

name 属性にカラム名、type 属性に型を記述します。minOccurs 属性に0を指定すると NULL 不可のカラム

を作成することができます。name と type 属性は必須で、minOccurs 属性はオプションです。このタグは 後

にスラッシュを入れてタグ自身を閉じてください。type に指定できる型名は「型名とマッピング」を参照してく

ださい。

また type によって、追加属性(文字列の長さ等)を指定することができます。詳しくは「型名とマッピング」を

参照してください。

9. 同じ RowSet に定義したいカラムの数だけ 8 の element タグを記述します。

10. 7 の sequence タグを閉じます。

11. 6 の complexType タグを閉じます。

12. 5 の element タグを閉じます。

13. 他に定義したい RowSet がある場合、5~12 の工程を行います。

14. 5の element タグを閉じます。

15. 4の choice タグを閉じます。

16. 3 の complexType タグを閉じます。

3~16での定義した RowSet のリレーション(関係)を定義したい場合 17~25 までの工程を行います。

17. unique タグを記述します。

他の RowSet から参照される、一意キーを定義します。name 属性に名称を指定します。

18. selector タグを記述します。

xpath 属性に一意キーを指定する RowSet を特定するためのパスを指定します。サンプルを参考にしてく

ださい。このタグは 後にスラッシュを入れてタグ自身を閉じます。

19. field タグを記述します。

xpath 属性に一意キーのカラム名を特定するためのパスを指定します。サンプルを参考にしてください。こ

のタグは 後にスラッシュを入れてタグ自身を閉じます。

20. 一意キーとなるカラムが複数ある場合は 19 の field タグを記述します。

21. 17 の unique タグを閉じます。

22. keyref タグを記述します。

このタグでは、外部参照キーを定義します。name 属性に適当な外部参照名をつけ、refer 属性に、17 で定

義した参照される一意キーでの定義ある、unique タグの name 属性の値を指定します。

23. selector タグを記述します。

xpath 属性に、参照元のカラムの所属する RowSet を特定するためのパスを指定します。サンプルを参考

にしてください。このタグは 後にスラッシュを入れてタグ自身を閉じます。

24. field タグを記述します。

xpath 属性に参照元カラム名を特定するためのパスを指定します。サンプルを参考にしてください。このタ

Copyright(C) SIOS Technology, Inc.

127 補足説明 127

グは 後にスラッシュを入れてタグ自身を閉じます。

25. 他に設定したいリレーションがある場合は17から24を行います。

26. 2 の element タグを閉じます。

27. 1のスキーマタグを閉じます。

以上で定義部の記述が完了します。

データ定義部の例 <?xml version="1.0" encoding="Windows-31J" ?> <EmpDataSet xmlns="http://www.10art-ni.co.jp/EmpDataSet.xsd"> <xs:schema id="EmpDataSet" xmlns:xs="http://www.w3.org/2001/XMLSchema" > <xs:element name="EmpDataSet" > <xs:complexType> <xs:choice maxOccurs="unbounded"> <xs:element name="EMP_DPT"> <xs:complexType> <xs:sequence> <xs:element name="EMPLOYEE_NAME" type="string" /> <xs:element name="EMPLOYEE_CODE" type="string" /> <xs:element name="DEPARTMENT_NAME" type="string" /> <xs:element name="ADDRESS" type="string" minOccurs="0" /> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="ESTIMATE"> <xs:complexType> <xs:sequence> <xs:element name="TITLE" type="xs:string" /> <xs:element name="CUSTOMER_NAME" type="string" minOccurs="0" /> <xs:element name="TOTAL_PRICE" type="decimal" length=”7” /> <xs:element name="GRAND_TOTAL" type="decimal" minOccurs="0" /> <xs:element name="CREATE_USERID" type="string" /> </xs:sequence> </xs:complexType> </xs:element> </xs:choice> </xs:complexType> <xs:unique name="EmpDataSetKey1"> <xs:selector xpath=".//EMP_DPT" /> <xs:field xpath="EMPLOYEE_CODE" /> </xs:unique> <xs:keyref name="EMP_DPTESTIMATE" refer="EmpDataSetKey1"> <xs:selector xpath=".//ESTIMATE" /> <xs:field xpath="CREATE_USERID" /> </xs:keyref> </xs:element> </xs:schema>

Copyright(C) SIOS Technology, Inc.

128 補足説明 128

データ部

データパートは RowSet に取り込むデータを定義します。データは RowSet の名称のタグで、カラム名称のタグで

値を挟んだものを、さらに挟んだものを一行のデータとなります。複数の行を指定することができます。複数の

RowSet が定義されている場合は、複数の形式の行を混在させることも可能です。

データ部の例 <EMP_DPT> ←RowSet の名称 <EMPLOYEE_NAME>松田 清文</EMPLOYEE_NAME> ←カラム名 EMPLOYY_NAME の値 <EMPLOYEE_CODE>20010010</EMPLOYEE_CODE> ←カラム名 EMPLOYEE_CODE の値 <DEPARTMENT_NAME>営業部</DEPARTMENT_NAME>←カラム名 DEPARTMENT_NAME の値 <ADDRESS>東京都千代田区 1-1</ADDRESS> ←カラム名 ADDRESS の値 </EMP_DPT> ←行終了 <EMP_DPT> <EMPLOYEE_NAME>長嶋 幸宏</EMPLOYEE_NAME> <EMPLOYEE_CODE>20010011</EMPLOYEE_CODE> <DEPARTMENT_NAME>製品開発部</DEPARTMENT_NAME> <ADDRESS>神奈川県茅ヶ崎市 4-4-5</ADDRESS> </EMP_DPT> <ESTIMATE> ←上とは違う RowSet の行を指定する <TITLE>新島産業様向け PC の導入</TITLE> <CUSTOMER_NAME>新島産業</CUSTOMER_NAME> <TOTAL_PRICE>750000</TOTAL_PRICE> <GRAND_TOTAL>787500</GRAND_TOTAL> <CREATE_USERID>20010010</CREATE_USERID> </ESTIMATE>

データ型とマッピング

定義部で使用できるデータ型とRowSetのカラム型マッピング情報、及び、同時に指定できる追加属性の情報を下

記に示します。

一行のデータ

No. XMLデータ型 Java型 追加属性 追加属性内容

1 string java.lang.String length 入力できる 大バイト数

2 boolean boolean

3 byte byte

4 short short

5 int int

6 long long

7 float float

8 double double

precision 数値全体の桁数

scale 小数点以下の桁数

10 dateTime java.sql.Timestamp format フォーマット

11 date java.sql.Date format フォーマット

12 time java.sql.Time format フォーマット

java.matn.BigDecimaldecimal9

Copyright(C) SIOS Technology, Inc.

129 補足説明 129

データ定義 CSV 作成方法 (Java モードのみ) ◆CSV データの入出力について

CSV データを扱う場合、1行目[カラム名] + 2行目[カラムタイプ] + 3行目以降[データ]の形式で指定する必要

があります。

1行目 カラム名 PRODUCT_NAME COST LIST_PRICE

2行目 カラムタイプ STRING INT INT

3行目以降

データ

キーボード 150000 150000

データ

ノートPC 150000 150000

タイプ文字列と型の対応は下記の通りです。

Java の型 カラムタイプ文字列

STRING 型 STRING

SHORT 型 SHORT

LONG 型 LONG

INT 型 INT

FLOAT 型 FLOAT

DOUBLE 型 DOUBLE

BOOLEAN 型 BOOLEAN

BIGDECIMAL 型 BIGDECIMAL

DATE 型 DATE

TIME 型 TIME

TIMESTAMP 型 TIMESTAMP

サンプルCSVファイル(product_list.csv)

PRODUCT_NAME,COST,LIST_PRICE

STRING,INT,INT

フェニック 12 基本セット CSV,150000,300000

Xe-one 2GHD,1000,200000

Xe-one 1.7GHD,40000,80000

512M メモリモジュール,30000,60000

17inc 液晶ディスプレイ,15000,30000

15inc 液晶ディスプレイ,20000,40000

10inc 液晶ディスプレイ,1000,5000

フェニックス PC サーバ 年間サポートB,35000,70000

マウス,10000,20000

キーボード,7700,89000

スケルトンキーボード,65000,75000

Copyright(C) SIOS Technology, Inc.

130 資料 130

◆ しおりについて(Java モードのみ) WebReportCafe (以下 WRC)3.0 以下のバージョンでは、「PDF 設定」の「ページモード」で「しおり」が設定されて

いる場合、PDF のしおりとして、「“Page” + [ページ番号]」の形式(例:「Page1」「Page2」…)で自動にしおりが作成

されました。WRC3.5 以上では、しおりの作成がカスタマイズする機能が追加されたため、以前のバージョンのよう

に自動的にしおりが作成されなくなりました。

WRC3.0 以下で自動的に作成されるしおりを、WRC3.5 以上の Engine のライブラリを使用して作成するためには、

「ページモード」を「しおり」に設定し、JVM システムプロパティ「jp.co.tenartni.pdf.auto_outline」の値を

「true」に設定してください。

JVM システムプロパティに値を設定するには、java コマンドのオプション“-D”を使用して設定します。

例: java –Djp.co.tenartni.pdf.auto_outline=true ....... クラス名

◆ 非定型用紙へのダイレクト印刷について

非定型(任意サイズ)の用紙を使用する場合、Designer からダイレクト印刷することは出来ません。

◆ PDF417 バーコードのバイナリデータについて

PDF417 バーコードで漢字データを含むバイナリデータを扱うことはできません。英数字のみをご使用ください。

◆ その他

本製品では株式会社リコーより提供を受ける文書画像処理機能を使用しています。

Copyright(C) SIOS Technology, Inc.

131 資料 131

資料

サンプルデータベースの構築 セットアップ手順 WebReportCafe Designer では Microsoft Access 形式のサンプルデータベースを提供しております。この節では、

Oracle を使用したサンプルデータベースの設定手順を説明します。

・ データベースのセットアップ手順は、次のとおりです。(以下の SQL は Oracle8i (8.1.7)で動作確認をしていま

す。その他のデータベースを使用する場合は、各データベース用にSQLを編集してください。) ・ データベースのセットアップで利用する SQL は、以下にあります。

[INSTALL_DIR] ¥samples¥db 1. データベースに管理者権限でアクセスし、create_user.sql を実行してください。新しいユーザー"maido"が

作成されます。 2. 次に、作成したユーザー"maido"でデータベースにアクセスし、 create_table.sql を実行してください。サ

ンプルプログラム用の各テーブル(部署、社員など)が作成されます。尚、作成したテーブルを削除したい場

合は、drop_table.sql を実行してください。 3. サンプルデータを作成するためには、ユーザー"maido"でデータベースにアクセスし、sample_data.sql を

実行してください。サンプルデータが各テーブルにセットアップされます。

Copyright(C) SIOS Technology, Inc.

132 資料 132

サンプルデータベース テーブル詳細(ER図)

Copyright(C) SIOS Technology, Inc.

133 資料 133

Copyright(C) SIOS Technology, Inc.

134 資料 134

当ドキュメント中の会社名、製品名などは各社の商標および登録商標です。

Adobe および Acrobat は、Adobe Systems Incorporated(アドビシステムズ社)の商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by (c)2003 Y.Swetake(http://www.swetake.com/)

This product includes software developed by the Cryptix Foundation Limited (http://www.cryptix.org/).

Cryptix General License

Copyright (c) 1995-2005 The Cryptix Foundation Limited. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE CRYPTIX FOUNDATION LIMITED AND CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE CRYPTIX FOUNDATION LIMITED OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.