RepoAgent V2.4.5 ユーザーズマニュアル - Fujitsu › jp › Images ›...

RepoAgent V2.4.5

ユーザーズマニュアル

はじめに

このたびは「RepoAgent」をお買い求めいただき、誠にありがとうございます。本製品は、各種ビジネス帳票の作成

および印刷を行うためのソフトウェアです。本書は、RepoAgent を使用して帳票の設計から印刷までを行ううえでの全

体の流れ、および基本的な操作方法の理解を目的に書かれています。

・ RepoAgent は株式会社富士通北陸システムズの登録商標です。

・ Microsoft 、Windows、Windows Server、Windows Vista および Visual Basic は米国 Microsoft Corporation の

米国およびその他の国における商標または登録商標です。

・ Oracle と Java は、Oracle Corporation およびその子会社、関連会社の米国およびその他の国における登録商標

です。

・その他の製品名等の固有名詞は各社の商標または登録商標です。

・その他、本資料に記載されているシステム名、製品名等には必ずしも商標表示(TM・R) を付記しておりません。

・本製品のサンプル等で使用している社名、商品名等の固有名称は架空のものであり、実在するものとは一切関係

ありません。

平成 27 年 9 月　初版

All Rights Reserved, Copyright © FUJITSU HOKURIKU SYSTEMS LIMITED 2001-2015

関連ドキュメント

「RepoAgent」をお使いいただくために、次の 3 種類のドキュメントを用意しています。

RepoAgent V2.4.5 ユーザーズマニュアル（本書）

「RepoAgent」の全体像を理解するためにご利用ください。

RepoAgent ヘルプ（Windows オンラインヘルプ）

「RepoAgent」の機能全般が詳細に説明されています。

帳票エディタ機能については、[スタート]メニューの[プログラム]-[RepoAgent]-[RepoAgent 帳票エデ

ィタヘルプ]をクリックすることにより、表示することができます。

帳票出力機能については、[スタート]メニューの[プログラム]-[RepoAgent]-[RepoAgent 帳票出力ヘ

ルプ]をクリックすることにより、表示することができます。

帳票ビューア機能については、[スタート]メニューの[プログラム]-[RepoAgent]-[RepoAgent 帳票ビュ

ーアヘルプ]をクリックすることにより、表示することができます。

RepoAgent V2.4.5 ソフトウェア説明書

「RepoAgent」を運用するうえでの、動作環境、インストール手順、アンインストール手順、および留

意事項について記載されています。

もくじ

第１章 RepoAgent の概要................................................................................................1

１.１ RepoAgent とは .................................................................................................................................1１.２特徴 ....................................................................................................................................................2１.３プリンタ接続形態 ..............................................................................................................................3１.３.１パソコンに直接接続されたプリンタへの印刷 .........................................................................3１.３.２共用プリンタへの印刷..............................................................................................................3１.３.３ネットワークプリンタへの印刷 ...............................................................................................3

１.４機能一覧 .............................................................................................................................................4１.４.１帳票様式定義 ............................................................................................................................4１.４.２編集機能 ...................................................................................................................................6１.４.３印刷機能 ...................................................................................................................................6１.４.４表示機能 ...................................................................................................................................7

第２章帳票の設計............................................................................................................8

２.１定義項目 .............................................................................................................................................9２.１.１データフィールド .....................................................................................................................9２.１.２アイテム .................................................................................................................................11２.１.３セクション ..............................................................................................................................13２.１.４ページオーバレイとページアンダレイ ..................................................................................13２.１.５ページフォーム.......................................................................................................................14２.１.６データソースファイルの仕様 .................................................................................................15２.１.６.１データソースファイル形式仕様.....................................................................................................15

２.１.６.２列データ形式の仕様.......................................................................................................................17

２.１.６.３データソース種別 ..........................................................................................................................19

２.１.６.４バーコードデータ ..........................................................................................................................20

２.１.６.５その他データソースファイルに関する留意事項............................................................................21

２.２帳票設計の流れ ................................................................................................................................22２.２.１事前準備 .................................................................................................................................22２.２.１.１データソースファイル形式の決定 .................................................................................................22

２.２.１.２レポート属性の決定.......................................................................................................................22

２.２.２帳票様式の定義例 ...................................................................................................................23２.２.３出力結果の確認.......................................................................................................................51２.２.３.１印刷プレビュー..............................................................................................................................51

２.２.３.２印刷................................................................................................................................................51

２.２.４サンプル帳票について............................................................................................................52

第３章帳票の印刷..........................................................................................................53

３.１環境変数 ...........................................................................................................................................53３.２帳票出力コマンドでの印刷 ..............................................................................................................55３.２.１使用方法 .................................................................................................................................55３.２.２使用例 .....................................................................................................................................59

３.３帳票出力 API での印刷 ....................................................................................................................60

３.３.１使用方法 .................................................................................................................................60３.３.２使用例 .....................................................................................................................................66

３.４帳票出力コントロールでの印刷.......................................................................................................67３.４.１使用方法 .................................................................................................................................67３.４.２使用例 .....................................................................................................................................73

３.５帳票出力クラスでの印刷..................................................................................................................74３.５.１使用方法 .................................................................................................................................74３.５.２使用例 .....................................................................................................................................85

第４章帳票の表示..........................................................................................................86

４.１環境変数 ...........................................................................................................................................86４.２帳票出力コマンドでの表示 ..............................................................................................................88４.２.１使用方法 .................................................................................................................................88４.２.２使用例 .....................................................................................................................................91

４.３帳票出力 API での表示 ....................................................................................................................92４.３.１使用方法 .................................................................................................................................92４.３.２使用例 .....................................................................................................................................97

４.４帳票出力コントロールでの表示.......................................................................................................98４.４.１使用方法 .................................................................................................................................98４.４.２使用例 ...................................................................................................................................104

４.５帳票出力クラスでの表示................................................................................................................105４.５.１使用方法 ...............................................................................................................................105４.５.２使用例 ...................................................................................................................................112

RepoAgent V2.4.5 ユーザーズマニュアル

第１章 RepoAgent の概要

ここでは、RepoAgent の概要や特徴について説明します。

１.１ RepoAgent とは

RepoAgent は各種ビジネス帳票を作成、印刷するためのソフトウェアです。

各種ビジネス帳票をワープロ感覚でビジュアルに作成でき、帳票内のデータは CSV 形式等の汎用的なテキストフ

ァイルより入力し、印刷します。

また、帳票の印刷および表示はアプリケーションから制御することができます。

帳票作成プレビュー

帳票ビューア帳票プロセッサ

アプリケーション

レポート定義ファイル

帳票エディタ

運用フェーズ

開発フェーズ

データソース

(CSV ファイル等)

帳票出力コマンド

帳票出力 API

帳票出力コントロール

帳票出力クラス


帳票出力 API



帳

は Re

- 1 -

票表示

poAgentのコンポーネント

帳票印刷


- 2 -

１.２特徴

■ ワープロ感覚の帳票エディタで帳票を作成し印刷できるので、特別なプログラムを作成する必要がありません。

■ ユーザアプリケーションから簡単な API を呼び出すだけで帳票印刷を実現できます。また、帳票の内容を表

示することもできます。

■ 運用中の帳票変更にも帳票エディタで手軽に対応でき、ユーザアプリケーションの変更は不要です。

■ 帳票に表示するデータは、CSV 形式等の汎用的なテキストフォーマットファイルを使用できますので、デー

タを作成するプラットフォームを問いません。

■ 多彩な表現手段の提供により複雑な帳票も簡単に作成できます。

・罫線、網掛け、角丸め、文字修飾、区切り線、矢印線

・表示編集（カンマ編集、日付編集など）

・バーコード（JAN、Code 3 of 9、Industrial 2 of 5、郵便用（カスタマ）バーコード、CODE128、

EAN-128 など 11 種類）

・図形、画像（ビットマップ形式(.bmp)、JPEG 形式(.jpg)）

・入力レコード件数に応じた自動改ページ

・データ内容の変化（キーブレイク）に応じた小計／見出し／改ページの自動挿入

・同一内容データ列の結合表示

・印刷日付／ページ番号／四則演算／集計演算などの各種定義式

■ 帳票に表示するデータのエンコーディング形式は、シフト JIS のみでなく、UTF-8、UTF-16 といった Unicode

もサポートしています。

■ アプリケーションとの連携など、お客様にあった帳票出力方式を選択できます。

・帳票ビューアからの印刷／表示（手動印刷）

・帳票出力コマンドによる印刷／表示（バッチによる自動出力、アプリケーションからの印刷指示）

・帳票出力 API（アプリケーション・プログラム・インタフェース）による印刷／表示

・帳票出力コントロールによる印刷／表示

・帳票出力クラスによる印刷／表示

多彩な帳票出力

多彩な帳票表現

帳票印刷プログラムの生産性を大幅に向上

従来、ユーザアプリケーションで帳票印刷を行うには、複雑かつ膨大なプログラミングを行う必要がありました。

RepoAgent を使用すれば短時間で手軽に帳票印刷を行えます。


１.３プリンタ接続形態

ここでは、RepoAgent が印刷できるプリンタの接続形態について説明します。

１.３.１パソコンに直接接続されたプリンタへの印刷

１.３.２共用プリンタへの印刷

１.３.３ネットワークプリンタへの印刷

印刷

印刷

RepoAgent

RepoAgent

ＬＡＮ

RepoAgent

共用プリンタ

プリント

サーバ

- 3 -

印刷

ＬＡＮ


- 4 -

１.４機能一覧

１.４.１帳票様式定義

機能・項目内容

サイズレター（8.5x11inch)、リーガル(8.5x14inch)、

A3、A4、A5、B4、B5、はがき（100x148mm)、

15×11inch、10×14inch、9×11inch、10×11inch、11×17inch

ユーザ指定（縦・横ともに25.4～558.0㎜[1.00～22.00inch]）

※ユーザ指定：0.1mm[0.01inch]単位で指定可能

方向縦、横

余白上余白、下余白、左余白、右余白（0～266.3mm[0～10.5inch])

※0.1mm[0.01inch]単位で指定可能

※指定可能最大値は定義範囲のサイズにより増減

定義範囲

間隔固定ピッチ指定（文字間隔[10､12､13.3CPI]、行間隔[6､8LPI]）

優先方向下方向優先、右方向優先

下方向繰返し数自動判定、指定（1～558回/ページ）

明細の繰返し

右方向カラム数自動判定、指定（1～558回/ページ）

ヘッダ種類レポートヘッダ、ページヘッダ、グループ（分類）ヘッダ

フッタ種類レポートフッタ、ページフッタ、グループ（分類）フッタ

定義可能数最大16グループ階層分類表示（キーブレイク

でのグループ化）キーブレイク検

出時動作

改ページ、改カラム、グループヘッダ挿入、グループフッタ挿入

複数フォーム定義可能数最大4フォーム

※1レコード（行）を複数様式のページフォームに分散して表

示する場合のみ可能

ページフォーム

その他機能条件指定セクション切り替え、可変セクションの自動高さ調整

同一データ列結合表示

セクション種類 RHセクション（0～1）、RFセクション（0～1）

PHセクション（0～1）、PFセクション（0～1）

GHセクション（0～20）、GFセクション（0～20）

DEセクション（1～20）

区画

ページ領域種類ページアンダレイ、ページオーバレイ

定義可能数最大10000個/1ページフォーム

データアイテム種類文字（単一行）、文字（複数行）、数値、日付、時刻、日付時刻

チェック、画像、バーコード

固定表示種類固定文字列、画像、バーコード

図形種類四角形、円・楕円、直線

角丸め四角形の四隅、アイテム枠線の四隅

区切り線数値・文字の区切り

アイテム

矢印直線の始点・終点

桁数文字（単一行）アイテム（1～255文字）

文字（複数行）アイテム（1～4096文字）

数値アイテム（1～16桁）※整数部と小数部の合計

固定文字列アイテム（1～512文字）

フォント Windowsに組み込まれているTrueTypeフォント

スタイル標準、斜体、太字、太字斜体、下線、取り消し線

フォントサイズ 3.0～256.0ポイント　※0.1ポイント単位

横倍率 1～200%

向き上向きで左から右、上向きで上から下、右向きで上から下

左向きで下から上、左向きで左から右

行方向配置上寄せ、中央、下寄せ、均等

文字方向配置左寄せ、中央、右寄せ、均等、圧縮

行間隔 0～256ポイント　※0.01ポイント単位

文字間隔 0～512ポイント　※0.01ポイント単位

タブコード展開 1～16文字　※文字（複数行）アイテムのみ

色任意

拡大・縮小標準、平体、長体、倍角、半角

文字修飾

送り数文字方向、行方向


- 5 -


種類実線、鎖線、点線、一点鎖線、二点鎖線、二重線

太さ｢0.25｣、｢0.5｣、｢0.75｣、｢1｣、｢1.5｣、｢2.25｣、｢3｣、｢4.5｣、｢6｣、｢8｣、｢10｣ポイント

線修飾

色任意

塗りつぶし任意色

右上り斜線

右下り斜線

斜め格子

水平線

垂直線

格子線

薄い

標準

濃い

任意色

種類

グレイスケール

（灰色）

5.0%、10.0%、12.5%、20.0%、25.0%、30.0%、37.5%、40.0%、50.0%、

60.0%、62.5%、70.0%、75.0%、80.0%、87.5%、90.0%

面修飾

背景色任意

配置右詰め、左詰め

０詰め有り、無し

桁数指定実際のデータにあわせる、または1～4桁で指定

全角変換有り、無し

日付時刻編集

変換タイプ西暦年、和暦年

元号（明治、大正、昭和、平成）、元号（M、T、S、H）

月、月（英語短縮）、月（英語可変長）、月（英語固定長）

日、時（24時間制）、時（12時間制）、分、秒、AM/PM展開

数値編集冒頭／末尾付加文字、ゼロ埋め桁数、カンマ区切り、ゼロ抑止

代替文字（ゼロ抑止時のみ）、空文字ゼロ置換

空白詰め、正／負符号文字、小数点文字、小数部ゼロ抑止

全角表示（ページ番号表示時のみ）

表示編集

文字編集冒頭／末尾付加文字、空白詰め

真偽値表示チェックマーク、指定文字列、指定画像

形式ビットマップ形式（.bmp）、JPEG形式（.jpg）画像

表示方法クリップ（アイテムサイズ）、拡大/縮小（アイテムサイズ）、拡大

/縮小（縦横比固定）

バーコード JAN標準、JAN短縮、Code 3 of 9、Industrial 2 of 5、Interleaved

2 of 5、NW-7、UPC-A、UPC-E、カスタマバーコード（郵便用バーコ

ード）、CODE128、EAN-128

データソース文字列、数値、日付、時刻、日付時刻、バイナリ

関数加算、減算、乗算、除算、剰余、部分文字列返却、文字列連結、文

字列繰返し

条件＝、＜、＞、≦、≧、≠

内部変数全ページ番号、ページ番号（通番、リセットキー指定）

明細番号（通番、ページ毎、計数条件指定、リセットキー指定）

印刷日付、印刷時刻、カラム番号（段組ごとの連番）

画像ファイルビットマップ形式（.bmp）、JPEG形式（.jpg）

データフィールド

集計件数、最大、最小、平均、合計

※それぞれ、全体、ページ毎、集計条件、リセットキー指定可

フォーマット CSV形式テキストファイル

任意文字区切り形式テキストファイル

エンコーディング形式シフトJIS、UTF-8、UTF-16

1行最大サイズ 40キロバイト

1列最大サイズ 16キロバイト

最大列数 1024列

最大サイズ 2ギガバイト

データソースファ

イル

量制限

読み込み可能最

大レコード数

100万件


- 6 -

１.４.２編集機能


編集元に戻す、切り取り、コピー、貼り付け、削除、全て選択、複写

順序最前面へ移動、最背面へ移動、前面へ移動、背面へ移動

定義順序前へ、後へ

グループ階層上位へ、下位へ

選択条件指定なし、固定文字列アイテムのみ、図形のみ、データアイテムのみ

編集ビューページ、セクション、オーバレイ

ページ指定 1～9999999

ルーラ表示・非表示

グリッド 0.5mm～100mm[0.02inch～4.00inch]　※0.1mm[0.01inch]単位

補正有・無

セクション境界線表示・非表示

レポートヘッダ／フッタ境界線、ページヘッダ／フッタ境界線、

グループヘッダ／フッタ境界線、ディテール境界線

アイテム境界線表示・非表示

下絵画像非表示、下絵1、下絵2、下絵3、下絵4

ズーム 50～500％

ツールバー標準、アイテム、書式、罫線、レイアウト、アイテムレイアウト

ステータスバー表示・非表示

データビュー表示・非表示

定義ビュー表示・非表示、アイテムを表示、同期

表示

プロパティグループ、ページフォーム、レポート、アイテム

アイテム配置左・右・上・下端を揃える、左・右・上・下につめる

アイテムサイズ高さ・幅・高さ／幅を揃える、自動調整

アイテム移動現在位置のセクションへ移動、ページアンダレイへ移動

レイアウト

セクション配置右方向カラム間隔、グループフッタ開始位置

その他印刷プレビュー、印刷起動、フォーマットテスト、印刷ログ出力

１.４.３印刷機能


帳票ビューア


帳票出力API


手段


定型サイズレター（8.5x11inch)、リーガル(8.5x14inch)、

A3、A4、A5、B4、B5、はがき（100x148mm)、

15×11inch、10×14inch、9×11inch、10×11inch、11×17inch

※プリンタ装置によりサポート範囲が異なります

任意サイズ幅（0.10～3276.70㎜）、高さ（0.10～3276.70㎜）

※0.1mm単位で指定可能


用紙

方向縦、横

印刷原点調整横方向（-1.00inch～1.00inch)、縦方向（-1.00inch～1.00inch）

※0.01inch単位で指定可能

印刷指定

その他両面印刷、丁合印刷、解像度、カラー、部数、拡大・縮小



- 7 -

１.４.４表示機能



帳票出力API


手段


ズーム 10～200％

その他ページ指定


- 8 -

第２章帳票の設計

帳票の設計は、「RepoAgent　帳票エディタ」で行います。RepoAgent で帳票の設計を行う場合、頻繁に使用する用語

の意味を次に説明します。

データソース

帳票に表示するためのデータを意味します。

データソースファイル

データソースを格納するテキストフォーマットのファイルを意味します。利用者アプリケーションや汎

用のパッケージソフトで出力します。

内部変数

ページ番号や明細番号など RepoAgent が管理・更新するデータを意味します。

データフィールド

データソースのデータ、関数の演算結果、集計結果、条件判定結果、画像ファイルのデータ、および内

部変数値を格納し、RepoAgent が表示のために内容を参照する領域です。

アイテム

アイテムとはデータフィールドの値、固定文字列および図形を表示する帳票上の領域です。表示用途に

応じて幾つかの種別が存在します。

セクション

アイテムを配置する区画です。目的に応じて 7 つのセクションが存在します。アイテムがどのセクショ

ンに配置されているかによって、表示されるタイミングや位置が決まります。

ページフォーム

1 帳票の様式全体を指します。ページフォーム内にセクションが定義されます。

レポート定義

データソースの定義、データフィールドの定義、アイテムの定義、セクションの定義およびページフォ

ームの定義など帳票に関する各種定義を総称してレポート定義と呼びます。

レポート定義ファイル

レポート定義が格納されているファイルです。「RepoAgent　帳票エディタ」が出力します。拡張子は

（.rpd）です。


- 9 -

２.１定義項目

２.１.１データフィールド

データフィールドには、目的に応じて以下の種別があります。

■ データソースフィールド

データソースから読み込んだデータを格納する領域です。データソースファイル中のレコード（行）を 1 件読

み込むたびに内容が更新されます。

【参照】データソースフィールド操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[データソース

フィールドの操作]トピックを参照してください。

■ 関数フィールド

指定したデータフィールドの演算結果を格納する領域です。データソースファイル中のレコード（行）を 1 件

読み込むたびに内容が更新されます。次に示す演算が行えます。

・加算

・減算

・乗算

・除算

・剰余

・部分文字列返却

・文字列連結

・文字列繰返し

【参照】関数フィールド操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[関数フィールドの操作]

トピックを参照してください。

■ 条件フィールド

特定のデータフィールドの内容をテストした結果を真偽値で格納する領域です。次に示す比較が行えます。

・＝（等しい）

・＞（より大きい）

・＜（より小さい）

・ ≧（大きいか等しい）

・ ≦（小さいか等しい）

・ ≠（等しくない）

【参照】条件フィールド操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[条件フィールドの操作]



- 10 -

■ 内部変数フィールド

当ソフトウェアが内部的に管理するデータを格納する領域です。次に示すデータを参照できます。

・全ページ番号

・ページ番号（通番、特定データフィールド値の変化でリセット）

・カラム番号（通番）

・明細番号（通番、計数条件を指定した通番、ページ毎にリセット、特定データフィールド値の変化

でリセット）

・印刷日付

・印刷時刻

【参照】内部変数フィールド操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[内部変数フィール

ドの操作]トピックを参照してください。

■ 画像ファイルフィールド

画像ファイルの内容を格納する領域です。次に示す画像フォーマットが使えます。

・ビットマップ形式のデータ（.bmp）

・ JPEG 形式のデータ（.jpg）

【参照】画像ファイルフィールド操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[画像ファイル

フィールドの操作]トピックを参照してください。

■ 集計フィールド

指定したデータフィールドの集計結果を格納する領域です。次に示す集計が行えます。また、それぞれ全体の

集計、集計条件を指定した集計、ページ毎の集計、特定のデータフィールド値が変化する時点でリセットされ

るキー集計を指定できます。

・レコード件数

・最大

・最小

・平均

・合計

【参照】集計フィールド操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[集計フィールドの操作]



- 11 -

２.１.２アイテム

アイテムには、用途に応じて以下の種別があります。

■ 固定文字列アイテム

帳票エディタで直接入力した文字列をそのまま表示します。

【参照】固定文字列アイテム操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[固定文字列の表示]


■ 図形

直線、四角形、および円・楕円を表示できます。

【参照】図形操作の詳細は、『RepoAgent　帳票エディタヘルプ』の[図形の表示]トピックを参照してく

ださい。

■ データアイテム

データフィールドに格納されているデータを内容に応じた形式で表示します。次にデータアイテムの種類を示

します。

■ 数値アイテム

数値を 1 行に表示します。

数値型データソースフィールド、数値型関数フィールド、数値型内部変数フィールドおよび集計フィール

ドの内容が表示できます。目的に応じた表示編集を指定できます。

■ 文字（単一行）アイテム

文字列データを 1 行に表示します。

文字列型データソースフィールドおよび文字列型関数フィールドの内容が表示できます。目的に応じた表

示編集を指定できます。

■ 文字（複数行）アイテム

文字列データを複数行に表示します。改行コードが含まれていればそこで行を折り返して表示することも

できます。

文字列型データソースフィールドおよび文字列型関数フィールドの内容が表示できます。

■ 日付アイテム

日付データを 1 行に表示します。

日付型データソースフィールドおよび印刷日付内部変数フィールドの内容が表示できます。

■ 時刻アイテム

時刻データを 1 行に表示します。

時刻型データソースフィールドおよび印刷時刻内部変数フィールドの内容が表示できます。

■ 日付時刻アイテム

日付時刻（タイムスタンプ）を 1 行に表示します。

日付時刻型データソースフィールドの内容が表示できます。

■ チェックアイテム

真偽値を画像や文字列で表示します。それぞれ真の場合、偽の場合の表示内容を個々に指定できます。

条件フィールドの内容が表示できます。

■ 画像アイテム

画像内容を表示します。

バイナリ型データソースフィールドおよび画像フィールドの内容が表示できます。


- 12 -

■ バーコードアイテム

データをバーコードとして表示します。

数値型データソースフィールド、文字列型データソースフィールド、関数フィールドおよび集計フィール

ドの内容が表示できます。

表示できるバーコード種別を次に示します。

・ JAN 標準

・ JAN 短縮

・ Code 3 of 9

・ Industrial 2 of 5

・ Interleaved 2 of 5

・ NW-7

・ UPC-A

・ UPC-E

・カスタマバーコード（郵便用バーコード）

・ CODE128

・ EAN-128

【参照】データアイテム操作の詳細は、『RepoAgent　帳票エディタヘルプ』の以下のトピックを参照し

てください。

[データソースの表示]トピック

[集計結果の表示]トピック

[横計算結果の表示]トピック

[ページ番号、全ページ番号、カラム番号、明細番号、印刷日付、印刷時刻の表示]トピック

[イメージの表示]トピック

[バーコードの表示]トピック

[真偽値の表示]トピック


- 13 -

２.１.３セクション

セクションには、用途に応じて以下の種別があります。

■ RH セクション（レポートヘッダ）

表紙のように帳票の 1 ページ目に印刷するアイテムを配置します。省略可能です。

最大 1 セクション定義できます。

■ RF セクション（レポートフッタ）

帳票の最終ページに印刷するアイテムを配置します。省略可能です。


■ PH セクション（ページヘッダ）

帳票名や日付など毎ページ先頭に印刷するアイテムを配置します。省略可能です。


■ PF セクション（ページフッタ）

ページ番号など毎ページ下端に印刷するアイテムを配置します。省略可能です。


■ DE セクション（ディテール）

表のように行を繰返すアイテムの 1 行目を配置します。最低 1 つの DE セクションが必要です。

最大 20 セクションまで定義できます。

■ GH セクション（グループヘッダ）

明細行を特定のデータで分類したグループの先頭に印刷するアイテム（見出しなど）を配置します。省略可能

です。


■ GF セクション（グループフッタ）

明細行を特定のデータで分類したグループの末尾に印刷するアイテム（小計など）を配置します。省略可能で

す。


２.１.４ページオーバレイとページアンダレイ

■ PO（ページオーバレイ）

毎ページ決まった位置に表示する固定文字列や図形を配置します。

■ PU（ページアンダレイ）

毎ページ決まった位置に表示するデータアイテムを配置します。アイテムを作成するときに必要に応じて自動

的に定義されます。

【参照】ページアンダレイへのアイテムの作成方法は、『RepoAgent　帳票エディタヘルプ』の[ページ

背景へのデータ表示]トピックを参照してください。


- 14 -

２.１.５ページフォーム

ページフォームは、通常 1 レポート定義に対して 1 ページフォームとなりますが、1 レコード（行）を複数様式のペ

ージフォームに分散して表示する場合には、最大 4 ページフォームまで作成できます。

【参照】複数ページフォームの作成方法は、『RepoAgent　帳票エディタヘルプ』の[複数ページフォー

ムの作成]トピックを参照してください。


- 15 -

２.１.６データソースファイルの仕様

ここでは、RepoAgent が扱えるデータソースファイルの仕様について説明します。

２.１.６.１データソースファイル形式仕様

データソースは一般的なテキストフォーマットのファイルに格納します。

■ レコードの区切り

改行コードで区切られた 1 行を 1 レコードとして扱います。

【補足】レコード（行）の読み込みに対して次のオプション機能を指定できます。

・改行のみの行を読み飛ばす

・読み込みを開始するレコード（行）位置を先頭レコード以外に設定する

■ 列データの区切り

列データの区切りは、レポート定義中で指定する特定の区切り文字で判断します。区切り文字としては、カン

マ（,）、タブ（0x09）、半角空白（0x20）および任意の半角文字を指定できます。

【補足】-区切り文字を含むデータを列データとして格納する場合、列データ全体をダブルコーテーショ

ン（"）で囲みます。但し、区切り文字としてダブルコーテーション（"）が指定されている場

合は制限となります。

（例）「¥12,345」｢¥3,000｣｢¥100｣をカンマ（,）区切りのテキストファイルに記述する場合

"¥12,345","¥3,000","¥100"

　　　　-ダブルコーテーション（"）を含むデータを列データとする場合、列データ全体をダブルコーテ

ーション（"）で囲み、さらに、列データ中の「"」を「""」と引用します。

（例）「ABC"DEF"GHI」｢"あいうえお"｣をテキストファイルに記述する場合

"ABC""DEF""GHI","""あいうえお"""

　　　　-改行コードを含むデータを列データとする場合、列データ全体をダブルコーテーション（"）で

囲みます。

　　　　-列データの読み込みに対して次のオプション機能を指定できます。

・データ前後の半角空白文字（列）およびタブ文字（列）を取り除く／取り除かない

・データ中の改行コードを許さない／許す


- 16 -

■ データのコード系（エンコーディング形式）

次のエンコーディング形式をサポートします。

・シフト JIS

・ UTF-8

・ UTF-16

【補足】 UTF-8 と UTF-16 の場合、Unicode の IVS (Ideographic Variation Sequence) を含む文字を印

刷および表示することができます。ただし、IVS に対応した OS とフォントが必要です。

■ 量的制限

レコード（行）の最大データ長：40 キロバイト（40960 バイト）

列データの最大データ長：16 キロバイト（16384 バイト）

データソースファイル最大サイズ：2 ギガバイト

最大列データ数：1024 個

読み込み可能最大レコード（行）数：100 万件（システムリソースに依存します）


- 17 -

２.１.６.２列データ形式の仕様

データソースの列定義に従い、列データを次の内容であると解釈します。

■ 文字列型

文字列として解釈します。

【補足】列データ長が 0 の場合には空文字列として扱います。

■ 数値型

以下の形式の数値として解釈します。

【補足】-整数部および小数部の構成文字は、0～9 までの数字とし、それ以外の文字が出現した場合はデ

ータエラーとなります。但し、円記号（¥）、およびカンマ（,）は読み飛ばします。

　　　　-列データ長が 0 の場合には空文字として扱います。

■ ファイル名型

画像ファイルのファイル名として解釈します。

【補足】-列データ長が 0 の場合には未指定として扱い表示されません。

　　　　-画像フォーマットとして指定できるのは、ビットマップ形式（.bmp）および JPEG 形式（.jpg）

です。

【注意】パス名ではなくファイル名のみ指定します。

■ 年次日付型

以下の形式の日付として解釈します。

【補足】- YYYY は 0000～9999 の範囲の西暦年とします。

　　　　-列データ長が 0 の場合には未指定として扱い表示されません。

■ 月次日付型


【補足】- YYYY は西暦年、MM は月とします。000001～999912 の範囲とします。


[+|-][整数部][.[小数部]]

※ []内は省略可能

※ +|-は+または-の意味

YYYY

YYYYMM


- 18 -

■ 日次日付型


【補足】- YYYY は西暦年、MM は月、DD は日とします。00000101～99991231 の範囲とします。


■ 時刻

以下の形式の時刻として解釈します。

【補足】- hh は 24 時間制での時、mm は分、ss は秒とします。000000～235959 の範囲とします。


■ 日付時刻型

以下の形式の日付時刻として解釈します。

【補足】- YYYY は西暦年、MM は月、DD は日とします。

　　　　- hh は 24 時間制での時、mm は分、ss は秒とします。

　　　　-「0000/01/01 00:00:00」～「9999/12/31 23:59:59」の範囲とします。

　　　　-個々の区切り文字（"/",":"," "）数は半角換算 1 文字と想定します。


YYYYMMDD

hhmmss

YYYY/MM/DD hh:mm:ss


- 19 -

２.１.６.３データソース種別

本製品では、次に示す種別のデータを格納したテキストファイルを 2 つ定義できます。

｢データソース｣

指定したデータ開始行から最終行まで全てを読み込み帳票に出力します。通常、明細データなどを格納

するデータソースファイルを定義します。全ての行が、同じ列構成でなければなりません。

｢カスタムデータソース｣

指定したデータ行のレコードだけを読み込みます。通常、レポートヘッダなどに表示するためのデータ

を格納します。｢データソース｣とは別のファイルを定義するか、｢データソース｣と同一ファイルの先頭

行を再定義します。

（例）｢データソース｣とは別のファイルを定義する場合

（例）｢データソース｣と同一ファイルの先頭行を再定義する場合

データソースファイルデータソース定義帳票head.txt 　　┌────┐　　┌──────────────┬──┌─────────────┐　　│カスタム│┌→│2001 年度　上半期 │RH│2001,上半期　 ├─→│データ ├┘　│ ├──└─────────────┘　　│ │　　│4 月 5 月 6 月 7 月 8 月 9 月 │ 　　└────┘　　│ ├──data.txt 　　 ┌→│ 10 10 10 10 10 10 │DE┌─────────────┐　　┌────┐│　│ ├──│4 月,5 月,6 月,7 月,8 月,9 月│　　│ │├→│ 20 20 20 20 20 20 ││10,10,10,10,10,10 │┐ │データ ├┘：│ ││20,20,20,20,20,20 │├→│ │　　│ ： ││： ││　│ │　　│ │└─────────────┘┘　└────┘　　└──────────────┘

データソースファイルデータソース定義帳票data.txt 　　　┌────┐　　┌──────────────┬──┌─────────────┐　　│カスタム│┌→│2001 年度　上半期 │RH│2001,上半期　　　　　　┼─→│データ ├┘　│ ├──│4 月,5 月,6 月,7 月,8 月,9 月│　　│　　　　│　　│4 月 5 月 6 月 7 月 8 月 9 月 ││10,10,10,10,10,10 　　│┐ └────┘　　│ ├──│20,20,20,20,20,20 　││　┌────┐┌→│ 10 10 10 10 10 10 │DE│：　│├→│ ││　│ ├──└─────────────┘┘　│ │├→│ 20 20 20 20 20 20 │　　　　　　　　　　　　　　　　　│データ ├┘：│ │　　　　　　　　　　　　　　　　　│ │　　│ ： │　　　　　　　　　　　　　　　　　│ │　　│ │　　　　　　　　　　　　　　　　　└────┘　　└──────────────┘


- 20 -

２.１.６.４バーコードデータ

バーコードに表示するデータを用意する場合は、バーコード種別に応じて以下の規則に従ったデータソースファイル

を用意してください。

バーコード種文字種文字数（※2）

JAN 標準 0～9 12(13)

JAN 短縮 0～9 7(8)

Code 3 of 9 0～9、A～Z、-(マイナス)、.(ピリオド)、半角空白

$(ドル)、/(スラッシュ)、+(プラス)、%(パーセント)

1～34

Industrial 2 of 5 0～9 1～34

Interleaved 2 of 5 0～9 1～34

NW-7 0～9、-(マイナス)、.(ピリオド)、$(ドル)、:(コロン)

/(スラッシュ)、+(プラス)

※1

3～34

UPC-A 0～9 11＋追加文字数

(12＋追加文字数)

UPC-E 0～9 7＋追加文字数

(8＋追加文字数)

カスタマバーコード 0～9、A～Z、-(マイナス) 7～20

CODE128 0～9、A～Z、記号、制御コード※3 1～124(1～125) ※4

EAN-128 0～9、A～Z、記号、制御コード※3 1～124(1～125) ※4

※1 スタートストップコード：A～E、N、T、*(アスタリスク)

※2 括弧内の数値はチェックキャラクタを自動付加しない場合

※3 制御コードは次表に示す代替文字列で指定します

※4 スタートストップコードを除く

CODE128 と EAN-128 の制御コードは以下に示す代替文字列を指定してください。

Hex 代替文字列 Hex 代替文字列 Hex 代替文字列

0x00 <NUL> 0x10 <DLE> 0x7F <DEL>

0x01 <SOH> 0x11 <DC1> 0x80 <STARTA> 注 1)

0x02 <STX> 0x12 <DC2> 0x81 <STARTB> 注 1)

0x03 <ETX> 0x13 <DC3> 0x82 <STARTC> 注 1)

0x04 <EOT> 0x14 <DC4> 0x83 <FNC1>

0x05 <ENQ> 0x15 <NAK> 0x84 <FNC2>

0x06 <ACK> 0x16 <SYN> 0x85 <FNC3>

0x07 <BEL> 0x17 <ETB> 0x86 <FNC4>

0x08 <BS> 0x18 <CAN> 0x87 <CODEA>

0x09 <HT> 0x19 <EM> 0x88 <CODEB>

0x0A <LF> 0x1A <SUB> 0x89 <CODEC>

0x0B <VT> 0x1B <ESC> 0x8A <SHIFT>

0x0C <FF> 0x1C <FS> 0x8D <BP1> 注 2)

0x0D <CR> 0x1D <GS> 0x8E <BP2> 注 2)

0x0E <SO> 0x1E <RS> 0x8F <BP> 注 2)

0x0F <SI> 0x1F <US>

注 1) 初期コードセットの指定を行います。データの先頭にある場合のみ有効です。バーコード種が EAN-128 の場

合は、<STARTA>、<STARTB>または<STARTC>のあとに必ず<FNC1>を指定してください。

●先頭データの制御文字<STARTA>、<STARTB>または<STARTC>を省略した場合

CODE128：<STARTA>が指定されたとみなします。

EAN-128：<STARTA><FNC1>が指定されたとみなします。

注 2) バーコード種が EAN-128 の場合のみ使用可能です。<BP1>、<BP2>および<BP>+区切り文字(ユーザー指定)は

バーコードのデータとして扱われませんが、指定可能文字数に含まれます。下部文字のアプリケーション識別

子(AI)と、それに基づくデータを区切る際に「()」を区切り文字として使用する場合は、<BP1>、<BP2>を使用


- 21 -

してください。<BP1>は「(」、<BP2>は「)」に相当します。「()」以外を区切り文字として使用する場合は<BP>

の後の 1 文字を下部文字での区切り文字として扱います。指定された文字はバーコードシンボル化されません。

注 3) ”<”をデータとして入力する場合は、”<<”と記述します。”>”の場合も同様です。

２.１.６.５その他データソースファイルに関する留意事項

データ内容の変化を検出する目的で使用する列データ内容をキーに予めソートしておく必要がありま

す。

ページヘッダやページフッタ、またはグループヘッダやグループフッタに表示するデータは、そのペー

ジ範囲またはグループ範囲の全てのレコード（行）に同じ内容の列データを格納しておく必要がありま

す。


- 22 -

２.２帳票設計の流れ

RepoAgent で帳票設計を行う場合の一般的な作業の流れは以下の通りです。

２.２.１事前準備

２.２.１.１データソースファイル形式の決定

RepoAgent では、予め帳票出力に使用するデータソースファイルの形式を決定しておくことにより、帳票の設計が効

率的に進められます。データソースファイルの形式は、RepoAgent が扱えるデータソースファイルの仕様に準じて設計

してください。

【参照】『２.１.６　データソースファイルの仕様』

【補足】データソースファイルの形式が前もって決められない場合は、帳票様式の定義だけを先に行う

ことも可能です。

２.２.１.２レポート属性の決定

帳票様式の定義を開始する前に、次に示すレポート属性を決定しておきます。

使用する単位系

アイテムの位置やサイズなどを指定する際に使用する単位系を決定します。次の 2 種類のうちどちらか

にします。

・ミリメートル(mm) ：小数点第 1 位（0.1mm 単位）

・インチ(inch) ：小数点第 2 位（0.01inch 単位）

【注意】使用する単位系は、帳票の新規作成後には変更することができませんので注意してください。

ページフォーム形式

ページフォームを複数使用するか否かを決定しておきます。通常は、一つのページフォームでほとんど

の帳票をカバーできます。1 レコード（行）を複数様式のページフォームに分散して表示する場合のみ、

複数のページフォームが使用できます。RepoAgent では、1 帳票につき最大 4 つのページフォームが定

義できます。

事前準備

帳票様式の定義

出力結果の確認

… ｢RepoAgent　帳票エディタ」で作業を行います。


- 23 -

２.２.２帳票様式の定義例

ここでは、「RepoAgent　帳票エディタ」を使用して帳票様式を定義するための全体像の理解を目的に、実際に帳票を

作成します。以降の説明に従って、操作してみることをお勧めします。

作成するサンプル帳票の様式、データソース内容、および特徴は以下の通りです。

■ 帳票様式

■ データソース内容

■ 特徴

・複数のレコードが 1 ページフォーム中に繰返し表示されています

・ヘッダに表示するデータ（例えば｢顧客名｣）は全てのレコードに同じ列データを格納しています

・表罫線が明細件数とは無関係に固定です

・データソース中の発注番号が変わった時点で改ページを行っています

※ここに示す帳票は、“RepoAgent インストールフォルダ ¥Sample¥納品伝票.rpd”とし

て格納されていますので、実際に帳票エディタで内容を確かめることができます。


- 24 -

1．設計用のサンプルデータソースファイルを準備する

事前準備で決定した形式と等しいサンプルデータソースファイルを設計用に用意します。サンプルデータソースファ

イルは、その形式や列の型が等しければ、データの内容は問いません。

ここでは、以下に示すデータソースファイルを用意します。

2．帳票を新規に作成する

事前準備で決定したレポート属性を帳票エディタの初期値として設定したうえで、帳票を新規作成します。

1) 「RepoAgent　帳票エディタ」を起動し、[ツール]-[初期値]メニューコマンドを選択します。

⇒ [初期値]ダイアログが表示されます。

2) [初期値]-[レポート属性]ページで以下のように設定し、[適用]ボタンをクリックします。

単位：｢ミリ(㎜)｣

ページフォーム形式：｢標準(単一ページフォーム)｣

グリッド横間隔：2.5 ㎜

グリッド縦間隔：2.5 ㎜

グリッド横原点：0.0 ㎜

グリッド縦原点：0.0 ㎜

グリッド補正する：チェックする

ページオーバレイをレポートヘッダ表示ページにも出力

：チェックしない

ページオーバレイをレポートフッタ表示ページにも出力

：チェックしない

ページオーバレイを印刷時に抑止：チェックしない

改ページ／改カラムの判断基準：｢ページフッタおよびグループフッタ分の余裕を残す｣を選択する

3) [閉じる]ボタンをクリックしダイアログを閉じます。

4) [ファイル]-[新規作成]メニューコマンドを選択します。

⇒ ｢新規レポート｣が作成されます。

発注番号,顧客名,納品先,出荷年月日,契約型名,品名,数量,単価

123456789012,㈱ＡＢＣ商事,㈱ＡＢＣ商事　本社ビル１Ｆ,20000620,FMV9ABC111,ＦＭＶ－９９９９ＴＸ５,2,150000

123456789012,㈱ＡＢＣ商事,㈱ＡＢＣ商事　本社ビル１Ｆ,20000620,TPCBL-B111,ツイストペアケーブル,2,1500

123456789012,㈱ＡＢＣ商事,㈱ＡＢＣ商事　本社ビル１Ｆ,20000620,FMX-SCS9,ＳＣＳＩカード,2,7000

123456789012,㈱ＡＢＣ商事,㈱ＡＢＣ商事　本社ビル１Ｆ,20000620,VL-1599S,カラー液晶ディスプレイ－１５,2,75000

110987654321,いろはに　商店,いろはに　商店,20000621,FMV9ABC111,ＦＭＶ－９９９９ＴＸ５,1,150000

110987654321,いろはに　商店,いろはに　商店,20000621,FMX-SCS9,ＳＣＳＩカード,1,7000

110987654321,いろはに　商店,いろはに　商店,20000621,VL-1599S,カラー液晶ディスプレイ－１５,1,75000

ここに示すデータソースファイルは、“RepoAgent インストールフォルダ ¥Sample¥納品伝票.csv”として格納されていますので、お使い

のテキストエディタで開いて内容を確かめることができます。


- 25 -

3．用紙を設定する

ページフォームに用紙情報を設定します。

1) [表示]-[ページフォームのプロパティ]メニューコマンドを選択します。

⇒ [ページフォームのプロパティ]ダイアログが表示されます。

2) [ページフォームのプロパティ]-[属性]ページで以下のように設定し、[適用]ボタンをクリックします。

フォーム名：｢FORM01｣

フォームのサイズの種類：｢A5｣

上の余白：10.0 ㎜

下の余白：10.0 ㎜

左の余白：10.0 ㎜

右の余白：10.0 ㎜

フォームの向き：｢縦｣

間隔を固定ピッチで指定する：チェックしない



- 26 -

4．データソースファイルを定義する

データソースファイルの形式および列定義を設定します。

1) [データ]-[データソース]メニューコマンドを選択します。

⇒ [データソース]ダイアログが表示されます。

2) [データソース]-[形式]ページで以下のように設定します。

ファイル名：納品伝票.csv

行指定のデータ開始行：2 行目

自動生成時の列名として使用する行を指定する：チェックする（1 行目）

区切り文字：カンマを選択する

改行のみの行を読み飛ばす：チェックする

データ前後の空白およびタブを取り除く：チェックする

データ中の改行コードを許さない：チェックする

3) [適用]ボタンをクリックします。

⇒ [5104]メッセージが表示されます。

4) [はい]ボタンをクリックします。

⇒ [データソース]-[列定義]ページに切り替わり、自動生成された列定義が表示されます。

5) 4 番目の列（出荷年月日）を選択し、[変更]ボタンをクリックします。

⇒ [列定義の設定]ダイアログが表示されます。


- 27 -

6) [列定義の設定]ダイアログで以下のように設定を変更し、[OK]ボタンをクリックします。

型：日付時刻

型詳細：日次日付(YYYYMMDD)

⇒ [データソース]-[列定義]ページで、4 番目の列が、数値型から日次日付型に変更されて表示されま

す。

7) [適用]ボタンをクリックします。

⇒ [5092]メッセージが表示されます（すでに編集時ファイル検索パスとして登録されている場合、当

メッセージは表示されません）。

8) [はい]ボタンをクリック後、[閉じる]ボタンをクリックし[データソース]ダイアログを閉じます。

⇒ 画面下端に[データ]ビューが表示され、定義に従って読み込んだデータ内容が表示されます。


- 28 -

5．セクションを調整する

新規作成直後は、PH セクション、DE セクション、および PF セクションが作成されています。必要に応じて、セクシ

ョンの高さを調整します。

【補足】デフォルトで作成されている PH セクションや PF セクションが不要な場合は削除できます。

【参照】マウス操作によるセクションの高さ調整方法は、『RepoAgent　帳票エディタヘルプ』の[マウ

ス操作]-[セクションの高さ変更]トピックを参照してください。

1) PH セクションの高さを 85.0 ㎜にします。

2) DE セクションの高さを 10.0 ㎜にします。

3) PF セクションの高さを 15.0 ㎜にします。

6．明細の繰返し形式を設定する

ページフォームのプロパティとして、明細の繰返し方法を設定します。

1) [表示]-[ページフォームのプロパティ]メニューコマンドを選択します。

⇒ [ページフォームのプロパティ]ダイアログが表示されます。

2) [ページフォームのプロパティ]-[繰返し]ページで以下のように設定し、[適用]ボタンをクリックします。

ディテールセクションの繰返し：する

繰返し優先方向：下方向優先

下方向繰返し数：｢指定する｣を選択する（16）

右方向カラム数：｢指定する｣を選択する（1）

ディテールセクション選択方法：｢最初に合致したもののみ｣を選択する



- 29 -

7．データアイテムを作成する

[データ]ビューからドラッグ・アンド・ドロップ操作でデータアイテムをセクションに配置します。

ここでの作業で作成されたレポート定義ファイルが、｢RepoAgent インストールフォルダ¥Sample¥納品伝票

_STEP01.rpd｣として収録されています。

1) 明細行として表示するデータを DE セクションにドロップします。

⇒ データアイテムがレコード件数分繰返し表示されます。

2) ヘッダに表示するデータを PH セクションにドロップします。

3) 作成されたアイテムのサイズや位置を調整します。

【補足】-繰返し表示されている DE セクション上のアイテムは、1 行目のアイテムだけ編集可能です。2

行目以降は 1 行目で行った変更内容が自動的に反映されたうえで、淡色表示されます。

　　　　-［データ]ビューのレコード行（行見出しに｢レコード 1、2…｣と表示されています）のセルをド

ラッグ・アンド・ドロップした場合は、データアイテムが作成されます。また、列名行（行見

出しに｢列名｣と表示されています）のセルをドラッグ・アンド・ドロップした場合は、固定文

字列アイテムが作成されます。

　　　　-ページ編集ビューでセクション領域の境界を表示するには、[表示]-[セクション境界線]メニュ

ーコマンドで指定します。これにより、各セクション境界が、赤色の点線で表示され、セクシ

ョン名文字列が表示されます（初期状態では表示するよう設定されています）。

　　　　-アイテム領域の境界を表示するには、[表示]-[アイテム境界線]メニューコマンドで指定します。

これにより、編集可能なアイテムの境界が、青色の実線で表示されます（初期状態では表示す

るよう設定されています）。

　　　　-定義ビューでアイテムを表示するには、[表示]-[定義ビュー]メニューコマンドで指定します。

これにより、編集可能なアイテムが表示されます（初期状態では表示されないよう設定されて

います）。


- 30 -

【参照】-ドラッグ・アンド・ドロップ操作によるデータアイテムの作成方法は、『RepoAgent　帳票エデ

ィタヘルプ』の[ドラッグ・アンド・ドロップアイテム生成]トピックを参照してください。

　　　　-マウス操作によるアイテムの操作方法は、『RepoAgent　帳票エディタヘルプ』の[マウス操作]

下の各トピックを参照してください。

　　　　-アイテムプロパティの操作方法は、『RepoAgent　帳票エディタヘルプ』の[アイテムプロパテ

ィ編集ダイアログ]下の各トピックを参照してください。


- 31 -

8．固定文字列アイテムを作成する

帳票のタイトルなどを固定文字列として作成し、位置やサイズを調整します。



1) “様”を固定文字列アイテムとして作成します。

2) “㈱北陸システムズ℡ 000-111-2345”を固定文字列アイテムとして作成します。この文字列のように、途中

に改行を含めることもできます。

3) “納品伝票”を固定文字列アイテムとして作成後、作成したアイテムを選択し、[表示]-[プロパティ]メニュー

コマンドを選択します。

⇒ [固定文字列アイテムのプロパティ]ダイアログが表示されます。

4) [固定文字列アイテムのプロパティ]-[フォント]ページで[下線]チェックボタンをチェックして下線を表示しま

す。


- 32 -

【参照】固定文字列アイテムの作成方法は、『RepoAgent　帳票エディタヘルプ』の[固定文字列の表示]



- 33 -

9．バーコードを表示する

ページヘッダに発注番号をバーコードで表示します。



1) PH セクションの領域にバーコードアイテムを作成します。

2) 作成したバーコードアイテムを選択し、[表示]-[プロパティ]メニューコマンドを選択します。

⇒ [バーコードアイテムのプロパティ]ダイアログが表示されます。

3) [バーコードアイテムのプロパティ]-[一般]ページで[データフィールド]ボタンをクリックします。

⇒ [データフィールド]ダイアログが表示されます。

4) [データフィールド]-[データソース]ページで[追加]ボタンをクリックします。

⇒ [データフィールド - データソース]ダイアログが表示されます。

5) [データフィールド - データソース]ダイアログで以下のように設定し、[OK]ボタンをクリックします。

名前：“発注番号”

型：数値

小数部丸め：｢切り捨て｣

位取り：0

ソース種別：データソース

データソースとの対応：｢列名で指定｣を選択する

列名：｢発注番号｣を選択する

⇒ [データフィールド]-[データソース]ページに、追加した発注番号フィールドが表示されます。

6) [適用]ボタンをクリック後、[閉じる]ボタンをクリックしダイアログを閉じます。

7) [バーコードアイテムのプロパティ]-[一般]ページの[データフィールド情報]ドロップダウンリストで今追加し

た｢発注番号｣を選択します。


- 34 -

8) [バーコードアイテムのプロパティ]-[バーコード]ページを表示し、以下のように設定します。

種別：｢JAN 標準｣

回転：｢なし｣を選択する

フラグキャラクタを下部に移動する：チェックしない

下部文字を表示する：チェックする

チェックキャラクタを自動付加する：チェックする

9) [適用]ボタンをクリックし、続けて[閉じる]ボタンをクリックしダイアログを閉じます。

【参照】バーコードアイテムの作成方法は、『RepoAgent　帳票エディタヘルプ』の[バーコードの表示]



- 35 -

10．明細番号を表示する

明細行に発注番号が変わるたびに振りなおされる明細番号を表示します。



1) DE セクションの領域に数値アイテムを作成します。

2) 作成した数値アイテムを選択し、[表示]-[プロパティ]メニューコマンドを選択します。

⇒ [数値アイテムのプロパティ]ダイアログが表示されます。

3) [数値アイテムのプロパティ]-[一般]ページで[データフィールド]ボタンをクリックします。


4) [データフィールド]-[内部変数]ページで[追加]ボタンをクリックします。

⇒ [データフィールド - 内部変数]ダイアログが表示されます。

5) [データフィールド - 内部変数]ダイアログで以下のように設定し、[OK]ボタンをクリックします。

名前：“明細番号（発注番号）”

種別：｢明細番号｣を選択する

開始値：1

計数条件：全て

リセット：「下記データフィールド情報の値が変化した時点でリセットする」を選択する

リセットキー：｢発注番号｣を選択する

⇒ [データフィールド]-[内部変数]ページに、追加した明細番号（発注番号）フィールドが表示され

ます。



- 36 -

7) [数値アイテムのプロパティ]-[一般]ページの[データフィールド情報]ドロップダウンリストで今追加した｢明

細番号（発注番号）｣を選択します。


【補足】明細番号は RepoAgent が計算しますので、そのためのデータを用意する必要はありません。


- 37 -

11．明細データの横計算結果を表示する

明細行に｢単価×数量｣の横計算結果を表示します。



1) DE セクションの領域に数値アイテムを作成します。





4) [データフィールド]-[関数]ページで[追加]ボタンをクリックします。

⇒ [データフィールド - 関数]ダイアログが表示されます。

5) [データフィールド - 関数]ダイアログで以下のように設定し、[OK]ボタンをクリックします。

名前：“金額”

関数種別：｢乗算｣を選択する

小数部丸め：｢切り捨て｣を選択する

位取り：0

オペランド 1 の種別：｢データフィールド情報｣を選択する

オペランド 1 のオペランド：｢単価｣を選択する

オペランド 2 の種別：｢データフィールド情報｣を選択する

オペランド 2 のオペランド：｢数量｣を選択する

⇒ [データフィールド]-[関数]ページに、追加した金額フィールドが表示されます。



- 38 -

7) [数値アイテムのプロパティ]-[一般]ページの[データフィールド情報]ドロップダウンリストで今追加した｢金

額｣を選択します。


9) 追加した金額表示用アイテムの上部の PH セクション領域に、“金額”を固定文字列アイテムとして作成しま

す。

【補足】関数フィールドは RepoAgent が計算しますので、そのためのデータを用意する必要はありませ

ん。


- 39 -

12．発注番号をキーに改ページ設定する

発注番号が変わる時点で改ページが発生するように設定します。



1) [定義]ビューで｢FORM01｣と表示されているラベルを選択します。

2) [挿入]-[グループ]メニューコマンドを選択します。

⇒ [グループの挿入]ダイアログが表示されます。

3) [グループの挿入]ダイアログで以下のように設定し、[挿入]ボタンをクリックします。

グループキー：｢発注番号｣を選択する

グループヘッダを追加する：チェックしない

グループフッタを追加する：チェックしない

⇒ [定義]ビューに挿入したグループが｢GROUP01[発注番号]｣と表示されます。

4) [定義]ビューで｢GROUP01[発注番号]｣と表示されているラベルを選択します。

5) [表示]-[グループのプロパティ]メニューコマンドを選択します。

⇒ [グループのプロパティ]ダイアログが表示されます。

6) [グループのプロパティ]-[属性]ページで以下のように設定します。

グループ化キー：｢発注番号｣を選択する（すでに選択されています）

グループ出力後の改ページ/改カラム指定：｢改ページ｣を選択する


- 40 -


⇒ [編集]ビュー右上に表示されている[編集ページセレクタ]で編集ページを切り替えることで、発注

番号が切り替わるタイミングで改ページされていることを確認できます。

編集ページセレクタ


- 41 -

13．フッタに合計を表示する

ページフッタに発注番号毎の金額合計を表示します。



1) PF セクションの領域に数値アイテムを作成します。





4) [データフィールド]-[集計]ページで[追加]ボタンをクリックします。

⇒ [データフィールド - 集計]ダイアログが表示されます。

5) [データフィールド - 集計]ダイアログで以下のように設定し、[OK]ボタンをクリックします。

名前：“金額合計”

種別：｢合計｣を選択する

小数部丸め：｢切り捨て｣を選択する

位取り：0

集計対象：｢金額｣を選択する

集計条件：｢全て｣を選択する

リセット：｢下記データフィールド情報の値が変化した時点でリセットする｣を選択する

リセットキー：｢発注番号｣を選択する

⇒ [データフィールド]-[集計]ページに、追加した金額合計フィールドが表示されます。



- 42 -

7) [数値アイテムのプロパティ]-[一般]ページの[データフィールド情報]ドロップダウンリストで今追加した｢金

額合計｣を選択します。


9) 追加した金額合計表示用アイテムの左部に、“合計”を固定文字列アイテムとして作成します。

【補足】集計フィールドは RepoAgent が計算しますので、そのためのデータを用意する必要はありませ

ん。


- 43 -

14．金額の表示編集を設定する

金額を表示しているアイテムに円記号を付加し、3 桁ずつカンマ文字で区切って表示するように設定します。



1) ｢単価｣を表示している数値アイテムを選択し、[表示]-[プロパティ]メニューコマンドを選択します。


2) [数値アイテムのプロパティ]-[表示編集]ページで以下のように設定します。

冒頭付加文字：‘¥’

末尾付加文字：何も入力しません

ゼロ埋め桁数：1

負符号文字：‘-’

正符号文字：何も入力しません

小数点文字：‘.’

ゼロ抑止：チェックしません

空文字をゼロとする：チェックします

小数部ゼロ抑止：チェックしません

カンマ区切り：チェックします

空白詰め：チェックしません



- 44 -

4) ｢金額｣を表示している数値アイテムにも上記 1)～3)までの設定操作を行います。

5) ｢合計｣を表示している数値アイテムにも上記 1)～3)までの設定操作を行います。

【補足】表示編集は RepoAgent が行いますので、データに、円記号（¥）やカンマ文字（,）を含める必

要はありません。

【参照】表示編集の詳細は、『RepoAgent　帳票エディタヘルプ』の[表示編集]トピックを参照してくだ

さい。


- 45 -

15．日付の表示編集を設定する

日付を表示しているアイテムに年月日の文字を付加し、全体を全角文字で表示するように設定します。



1) ｢出荷年月日｣を表示している日付アイテムを選択し、[表示]-[プロパティ]メニューコマンドを選択します。

⇒ [日付アイテムのプロパティ]ダイアログが表示されます。

2) [日付アイテムのプロパティ]-[表示編集]ページで以下のように設定します。

表示編集形式：“%4wY 年%2wM 月%2wD 日”


【補足】表示編集は RepoAgent が行いますので、データに、年、月、日などの文字を含めたり、データ

を全角文字で格納する必要はありません。


- 46 -

【参照】日付編集の詳細な指定形式は、『RepoAgent　帳票エディタヘルプ』の[[表示編集]ページ（日

付、時刻、日付時刻アイテム）]トピックを参照してください。


- 47 -

16．固定表罫線を設定する

表罫線をページオーバレイに作成することにより、明細の行数によらず毎ページ固定で表示することができます。



1) [編集ビュー選択タブ]の[オーバレイ]タブをクリックし、オーバレイ編集ビューを表示します。

⇒ セクションに作成されたアイテムの表示が淡くなります。

2) 淡く表示されたアイテムにあわせて、図形を使って罫線枠を作成します。

3) “当伝票の金額には消費税は含まれていません。”を固定文字列として作成します。

4) 3)で作成した固定文字列アイテムを選択し、[表示]-[プロパティ]メニューコマンドを選択します。

⇒ [固定文字列アイテムのプロパティ]ダイアログが表示されます。


- 48 -

5) [固定文字列アイテムのプロパティ]-[文字配置]ページで以下のように設定します。

文字の向き：上向きで下方向に｢文字列｣ラベルを表示しているボタンを押した状態にする

行方向配置：｢中央｣を選択する

文字方向配置：｢均等｣を選択する

文字間隔：フォントサイズと同じ値を入力する（ここでは 9Pt.）

行間隔：フォントサイズと同じ値を入力する（ここでは 9Pt.）


⇒ 設定した固定文字列が縦に表示されます。

【補足】-線の太さを変更する場合は、図形アイテムのプロパティダイアログの[線]ページで設定します。

　　　　-角丸めを表示する場合は、四角形を作成し、そのプロパティダイアログの[角丸め]ページで設

定します。

【参照】図形の作成方法は、『RepoAgent　帳票エディタヘルプ』の[図形の表示]トピックを参照してく

ださい。


17．フォーマットテスト

以上で、一通りの定義が完了しました。定義内容に問題がないかをフォーマットテストで確認します。

1) [ツール]-[オプション]メニューコマンドを選択します。

⇒ [オプション]ダイアログが表示されます。

2) [オプション]-[ログ]ページの[フォーマットテスト結果]グループボックス内の[ファイル名]エディットボック

スに結果を格納するファイル名を絶対パス名で入力します。


4) [ツール]-[フォーマットテスト]メニューコマンドを選択します。

⇒ 以下のメッセージが表示されたらフォーマットテストは完了です。

5) 2)で指定したファイルをテキストエディタで開きます。

⇒ 以下のように何もコメント表示されていなければ、定義は正常です。

【補足】

【参照】

<< フォーマットテスト開始 >><< [1] ページ開始 >>

<< [2] ページ開始 >>

<< フォーマットテスト終了 >>

- 49 -

定義に問題がある場合、以下のようにコメントが表示されますので、定義を修正します。

原因および対策に関しては、『RepoAgent　帳票エディタヘルプ』の[メッセージ一覧]トピック

中のコメントに付加された番号（上記例では 1511）の位置を参照してください。

<< フォーマットテスト開始 >><< [1] ページ開始 >>

[1511]表示内容がアイテムサイズに収まりません。

アイテム名 :Numeric00002

<< [2] ページ開始 >>

[1511]表示内容がアイテムサイズに収まりません。

アイテム名 :Numeric00002

<< フォーマットテスト終了 >>


- 50 -

18．レポート定義ファイルの保存

以下に示す手順でレポート定義ファイルに保存します。

1) [ファイル]-[名前を付けて保存]メニューコマンドを選択します。

⇒ [名前を付けて保存]ダイアログが表示されます。

2) ダイアログを操作してレポート定義ファイルを格納するフォルダへ移動します。

3) [ファイル名]エディットボックスに“納品伝票”と入力し、[保存]ボタンをクリックします。

⇒ 指定フォルダに“納品伝票.rpd”というファイル名で保存されます。


- 51 -

２.２.３出力結果の確認

２.２.３.１印刷プレビュー

作成した帳票定義を元にプレビューで出力結果を確認するには、以下の手順で操作します。

1) [ファイル]-[印刷プレビュー]メニューコマンドを選択します。

⇒ 帳票エディタの画面に印刷プレビューが表示されます。

【注意】-プリンタが設定されていない環境では、印刷プレビューは失敗します。

　　　　-印刷プレビューは、｢通常使うプリンタに設定｣されているプリンタのドライバ属性を使用して

画面表示します。実際に、運用するプリンタを｢通常使うプリンタに設定｣したうえで印刷プレ

ビューを行ってください。

２.２.３.２印刷

作成した帳票定義を元に実際にプリンタに出力して結果を確認するには、以下の手順で操作します。

1) [ファイル]-[印刷]メニューコマンドを選択します。

⇒ [印刷]ダイアログが表示されます。

2) [印刷]ダイアログでプリンタ名を指定し、[OK]ボタンをクリックします。

⇒ 印刷されます。


- 52 -

２.２.４サンプル帳票について

これまで説明してきた｢納品伝票｣以外に、幾つかのサンプルが｢RepoAgent インストールフォルダ ¥Sample｣下に格納

されています。

ここでは、サンプル帳票の概要について説明します。

給与支給明細_シングル.rpd

データソース 1 レコードを、1 ページフォームに表示する様式の例です。

給与支給明細_マルチ.rpd

データソース 1 レコードを、2 つのページフォームに表示する複数枚様式の例です。

支店別売上一覧.rpd

複数のレコードを 1 ページに繰返して表示する様式の例です。リスト形式の帳票を作成する場合に効果

的な RepoAgent の機能が数多く盛り込まれています。

納品伝票_A4.rpd

『２.２.２　帳票様式の定義』で例示した、｢納品伝票｣の A4 サイズ版です。説明の中では、紙面の関

係上、A5 サイズで帳票を作成しましたが、お使いの環境ですぐに使える A5 サイズがない場合など、こ

ちらのレポート定義ファイルで印刷などの確認を行ってください。

この場合は、『第３章　帳票の印刷』でのサンプルプログラム中の、レポート定義ファイル名を納品伝

票_A4.rpd として確認してください。

医療資材ラベル.rpd

EAN-128 バーコードを使用した医療資材用ラベルの例です。

【参照】-給与支給明細_シングル.rpd を帳票エディタで開いて確認する際は、『RepoAgent　帳票エディタ

ヘルプ』の[1 レコード－1 ページの繰返し形式]トピックを参考にしてください。

　　　　-給与支給明細_マルチ.rpd を帳票エディタで開いて確認する際は、『RepoAgent　帳票エディタ

ヘルプ』の[複数ページフォームの作成]トピックを参考にしてください。

　　　　-支店別売上一覧.rpd を帳票エディタで開いて確認する際は、『RepoAgent　帳票エディタヘル

プ』の以下のトピックを参考にしてください。

・[複数レコード－1 ページ（下方向優先）繰返し形式]トピック

・[複数レコード－1 ページ（下方向優先）繰返し形式での見出し設定]トピック

・[可変表罫線（繰返し優先方向が下方向優先の場合）]トピック

・[網がけの設定]トピック

・[結合表示の設定]トピック

・[レポートヘッダ]トピック

・[ページ番号、全ページ番号、カラム番号、明細番号、印刷日付、印刷時刻の表示]トピック

・[分類表示]トピック

　　　　-医療資材ラベル.rpd を帳票エディタで開いて確認する際は、『RepoAgent　帳票エディタヘル

プ』の[EAN-128]トピックを参考にしてください。


- 53 -

第３章帳票の印刷

帳票の印刷は、次に示す 4 つの方法で行います。

■ 「RepoAgent　帳票出力コマンド」

コマンドプロンプト画面からの起動や、バッチファイルでの連続起動に適しています。

■ 「RepoAgent　帳票出力 API」

C 言語などで記述されたプログラムからの起動に適しています。

■ 「RepoAgent　帳票出力コントロール」

Visual Basic などで記述されたプログラムからの起動に適しています。

■ 「RepoAgent　帳票出力クラス」

Java 言語で記述されたプログラムからの起動に適しています。

ここでは、それぞれの使用方法とサンプル帳票を印刷する例を示します。

【補足】ここで使用する帳票およびデータソースファイルは、以下にサンプルとして格納されています。

RepoAgent インストールフォルダ ¥Sample¥納品伝票.rpd

RepoAgent インストールフォルダ ¥Sample¥納品伝票.csv

３.１環境変数

ここでは、帳票出力時の環境を設定するために使用できる環境変数について説明します。

KRA_DEFINITION_FILE_PATH

レポート定義ファイルを検索するディレクトリパス名を指定します。複数のパス名を指定する場合は、セミコロン

（;）で区切って指定します。

［指定パスリスト］

c:¥aaa¥bbb;d:¥ddd

［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】

パス名を、ダブルクォーテーション（"）で囲んで指定しないでください。

KRA_IMAGEFILE_PATH

帳票に表示するイメージファイルを検索するディレクトリパス名を指定します。複数のパス名を指定する場合は、

セミコロン（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】



- 54 -

KRA_INPUTDATA_FILE_PATH

帳票に表示するデータソースファイルを検索するディレクトリパス名を指定します。複数のパス名を指定する場合

は、セミコロン（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】


KRA_CUSTOMDATA_FILE_PATH

帳票に表示するカスタムデータソースファイルを検索するディレクトリパス名を指定します。複数のパス名を指定

する場合は、セミコロン（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】


KRA_LOG_FILE

帳票出力時に書き出すログファイルへの絶対パス名を指定します。当設定を行うと、必ずログ出力を行うようにな

ります。以下に指定形式、および例を示します。

形式：ログファイル名／ログファイルサイズ

ログファイル名

ログファイル名を絶対パスで指定します。パスがない場合はカレントディレクトリ（ユーザが現在作業して

いるディレクトリ）にログを出力します。但し、相対パスでの指定はできません。また、ダブルクォーテー

ション（"）で囲まないでください。

ログファイルサイズ

ログファイルの最大サイズをバイト数（キロバイト単位）で指定します。半角数字のみ有効であり、"ログ

ファイル名/"の直後に指定する必要があります。指定できる範囲は、1～2097152（2 ギガバイト）までです。

但し、指定サイズを大きくした場合には性能が著しく劣化するため、2048（2 メガバイト）以内とすること

を推奨します。サイズ指定を行わない場合、または範囲外の値を指定した場合は、50 となります。

例 1）KRA_LOG_FILE=C:¥WORK.log/256

例 2）KRA_LOG_FILE=D:¥temp.log （サイズは 50 キロバイトとして扱われる）

例 3）KRA_LOG_FILE= （ログ採取しない）

【注意】

ログファイル名（パスを含む）として有効な文字数は 1～255 文字（半角文字数換算）です。256 文字（半角

文字数換算）以上となるログファイル名（パスを含む）を指定した場合には、ログファイルの作成に失敗しま

す。


- 55 -

３.２帳票出力コマンドでの印刷

３.２.１使用方法

ここでは、帳票出力コマンドの使用方法について説明します。

◆コマンド形式

raprint[.exe] レポート定義ファイル名

[-dcode {sjis | utf8 | utf16}]

[-imp イメージファイル検索パス]

[-idp データソースファイル検索パス]

[-id データソースファイル名]

[-icp カスタムデータソースファイル検索パス]

[-ic カスタムデータソースファイル名]

[-lf ログファイル名]

[-p プリンタ名]

[-sp 開始ページ]

[-ep 終了ページ]

[-cp 部数]

[-cl {sort | page}]

[-dup {hor | ver | none}]

[-n レポート名]

[-adx 横方向調整値]

[-ady 縦方向調整値]

[-e 環境情報ファイル名]

[-v]

※[]は省略可能です。

※{aaa|bbb}と表記した場合、aaa または bbb が指定可能で、aaa および bbb を同時に指定することはできません。

※オプション識別キーワードは、-xxx 形式と/xxx 形式のどちらでも可能です。

※オプション識別キーワード（-xxx）とオプション文字列の間には少なくとも 1 つの半角空白を指定します。

例） -id DataFile1 OK

-idDataFile1 NG

※指定文字列に半角空白を含める場合、ダブルクォーテーション（"）で囲って指定します。

例）raprint "FileName 00" -p "Print 01"

◆オプション引数

レポート定義ファイル名

レポート定義ファイル名を指定します。当パラメタは省略することはできません。ファイルの絶対パスを含めた指

定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序で定義ファイルを検索します。但し、相対パスでの

指定はできません。

①環境変数 KRA_DEFINITION_FILE_PATH で指定されたディレクトリ

②カレントディレクトリ（ユーザが現在作業しているディレクトリ）


- 56 -

-dcode {sjis | utf8 | utf16}

データソースの文字エンコーディング形式を指定します。省略時はシフト JIS が指定されたものとみなします。

ここでの指定と、実際に入力するデータソースの指定が一致していない場合の動作は不定です。

sjis シフト JIS

utf8 UTF-8

utf16 UTF-16

※V2.4 より前のバージョンを使用されていた方へ

　以前のバージョンの指定値「ucs2」は、V2.4 で「utf16」に変更しました。UTF-16 は、UCS-2 で表現できる文字

に加え、さらに多くの文字が表現可能となっています。従来との互換性のため、「ucs2」が指定された場合は「utf16」

が指定されたものとして動作します。

-imp イメージファイルパス

帳票に表示するイメージファイルを検索するディレクトリパス名を指定します。複数のパスを入力する場合は、セ

ミコロン（;）で区切って指定します。イメージファイルは、以下の順序で検索されます。

①当パラメタで指定されたディレクトリ

②環境変数 KRA_IMAGEFILE_PATH で指定されたディレクトリ

③レポート定義で指定されたディレクトリ

④レポート定義ファイルと同一のディレクトリ

⑤カレントディレクトリ（ユーザが現在作業しているディレクトリ）

-idp データソースファイル検索パス

データソースファイルを検索するディレクトリパス名を指定します。複数のパスを入力する場合は、セミコロン（;）

で区切って指定します。データソースファイルは、以下の順序で検索されます。


②環境変数 KRA_INPUTDATA_FILE_PATH で指定されたディレクトリ




-id データソースファイル名

データソースファイル名を指定します。省略時は、レポート定義の指定に従います。

データソースファイル名

CSV 形式などのテキストファイル名を入力データとして指定します。ファイルの絶対パスを含めた指定（［例］

C:¥Report¥売上げデータ）以外の場合は、-idp オプションの説明にある順序でファイルを検索します。但し、

相対パスでの指定はできません。

-icp カスタムデータソースファイル検索パス

カスタムデータソースファイルを検索するディレクトリパス名を指定します。複数のパスを入力する場合は、セミ

コロン（;）で区切って指定します。カスタムデータソースファイルは、以下の順序で検索されます。


②環境変数 KRA_CUSTOMDATA_FILE_PATH で指定されたディレクトリ





- 57 -

-ic カスタムデータソースファイル名

カスタムデータソースファイル名を指定します。指定形式は、-id オプションと同様です。省略時は、レポート定

義の指定に従います。

-lf ログファイル名

指定ファイルへ動作ログ情報を出力します。ログファイル名の指定形式は、環境変数 KRA_LOG_FILE で指定する場

合と同様です。

-p プリンタ名

印刷を行うプリンタ名を指定します。当オプション省略時は、デフォルトプリンタ（「通常使うプリンタ」で定義

されているもの）に出力されます。プリンタ名として、"!ReportDef"を指定した場合はレポート定義の指定に従い

ます。また、プリンタ名として、"!SelectPrinter"を指定した場合は、[印刷]ダイアログボックスを表示します。

指定プリンタがシステム上で見つからない場合、印刷は失敗します。

-sp 開始ページ

印刷を開始するページ番号を指定します。指定できる値は、1～65535 までです。省略時は、1 ページ目から印刷し

ます。ここで指定するページ番号は、物理的な用紙枚数単位で指定します。

-ep 終了ページ

印刷を終了するページ番号を指定します。指定できる値は、1～65535 までです。省略時、および最終ページ数を

超える値を指定した場合は、最終ページまで印刷します。ここで指定するページ番号は、物理的な用紙枚数単位で

指定します。

-cp 部数

コピー部数を指定します。指定できる値は 1～32767 までです。但し、プリンタドライバによっては指定どおりの

部数印刷を行えない場合があり、この場合当オプションの指定は無視されます。

省略時は、レポート定義の指定に従います。

-cl {sort | page}

2 部以上のレポートを印刷する場合に、部単位で印刷するか、ページ単位で印刷するかを指定します。また、プリ

ンタドライバによっては丁合指定が行えない場合があります。この場合は、当オプションの指定は無視されます。

省略時は、レポート定義の指定に従います。

sort 部単位で印刷します

page ページ単位で印刷します

-dup {hor | ver | none}

2 ページ以上のレポートを印刷する場合に、両面印刷するかどうかを指定します。また、プリンタドライバによっ

ては両面印刷が行えない場合があります。この場合は、当オプションの指定は無視されます。省略時は、レポート

定義の指定に従います。

hor 両面印刷（横綴じ）します

ver 両面印刷（縦綴じ）します

none 片面印刷します

-n レポート名

レポート名を指定します。ここで指定された名前はプリントジョブ名となり、プリントフォルダに表示されます。

指定できる文字数は半角文字換算で 1～64 文字までです。省略時は、レポート定義の指定に従います。


- 58 -

-adx 横方向調整値

印刷開始位置の横方向微調整量を指定します。単位は、インチであり、-1.00～1.00 の範囲で指定できます。負の

値のときは左方向、正の値のときは右方向の移動となります。省略時は、レポート定義の指定に従います。

-ady 縦方向調整値

印刷開始位置の縦方向微調整量を指定します。単位は、インチであり、-1.00～1.00 の範囲で指定できます。負の

値のときは上方向、正の値のときは下方向の移動となります。省略時は、レポート定義の指定に従います。

-e 環境情報ファイル名

レポート定義ファイルのプリント情報およびパス情報を、環境情報として移入します。他のオプションと同時に指

定された場合、他のオプション指定が優先されます。ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売

上げ）以外の場合は、以下の順序でレポート定義ファイルを検索します。但し、相対パスでの指定はできません。



当オプション指定でレポート定義ファイルから移入される情報は以下の通りです。

・イメージファイル検索パス名

・データソースファイル検索パス名

・カスタムデータソースファイル検索パス名

・プリンタ名

・印刷部数

・丁合い

・両面印刷

・横方向印刷開始位置調整値

・縦方向印刷開始位置調整値

-v

バージョン情報を表示します。当オプションを指定した場合、他のオプション指定は全て無効となります。


- 59 -

３.２.２使用例

ここでは、コマンドプロンプト画面で帳票出力コマンドを使用して、サンプル帳票の印刷を行う方法を例示します。

0) 事前準備として、システムの PATH 環境変数に以下のディレクトリパス名を設定します。

1) サンプル帳票が格納されたフォルダに移動します。

2) 次に示すコマンドを入力することによりサンプル帳票（納品伝票.rpd）が｢通常使うプリンタに設定｣されてい

るプリンタへ印刷されます。

【参照】-帳票出力コマンドのオプション引数の詳細は、『RepoAgent　帳票出力ヘルプ』の[帳票出力コ

マンド]トピックを参照してください。

　　　　-帳票出力コマンドのエラーメッセージの詳細は、『RepoAgent　帳票出力ヘルプ』の[メッセー

ジ一覧]トピックを参照してください。

set PATH=%PATH%;RepoAgent インストールフォルダ ¥Program

cd RepoAgent インストールフォルダ ¥Sample

raprint 納品伝票.rpd -id 納品伝票.csv


- 60 -

３.３帳票出力 API での印刷

３.３.１使用方法

ここでは、帳票出力 API の使用方法について説明します。

◆関数インタフェース

RA_Print()

《呼び出し形式》

#include "RAAPI.h"

RA_BOOL RA_Print(PRA_PRINT_CTLINFO pPrintCtlinfo);

《引数》

pPrintCtlinfo RA_PRINT_CTLINFO 構造体変数へのポインタ

《復帰値》

正常終了 : RA_TRUE

異常終了 : RA_FALSE

《補足》

・引数 pPrintCtlInfo が NULL の場合、WIN32API の GetLastError()にて ERROR_INVALID_PARAMETER が通知されます。

・引数 pPrintCtlInfo で指定する変数の構造体識別情報が正しくない場合（dwIDメンバ）、WIN32API の GetLastError()

にて ERROR_INVALID_LEVEL が通知されます。

・上記エラー以外で当 API が失敗（RA_FALSE 復帰）した場合のエラー詳細は、引数 pPrintCtlInfo で指定した

RA_PRINT_CTLINFO 構造体の dwErrCode メンバ、および ErrorDetail メンバを参照してください。

・ログ出力に失敗した場合は、引数 pPrintCtlInfo で指定した RA_PRINT_CTLINFO 構造体の dwLogErrCode メンバ、お

よび ErrorDetail メンバにエラー情報が設定されています。dwLogErrCode にエラー情報が設定されていても、

dwErrCode にエラー情報が設定されていない場合は、印刷は正常に行われています（ログ出力のみ異常となってい

ます）。

・引数 pPrintCtlInfo で指定する RA_PRINT_CTLINFO 構造体の dwFlag メンバに RA_PRINT_USE_PRINTING_DLG を指定す

ると、印刷ジョブのキャンセルが可能となります。

・印刷ジョブをキャンセルした場合、当 API は異常復帰（RA_FALSE 復帰）し、エラー識別コード（dwErrCode メンバ）

に 913 が通知されます。

・OS の印刷キューから印刷ジョブをキャンセルした場合の動作はプリンタドライバに依存します。


- 61 -

◆構造体

RA_PRINT_CTLINFO 構造体

《宣言形式》

typedef struct tagRA_PRINT_CTLINFO

{

unsigned long dwID; // 構造体識別情報（固定値）

const char* pRpdFileName; // レポート定義ファイル名

const char* pImageFileInputPath; // イメージファイル検索パス

const char* pDataFileInputPath; // CSV データ検索パス

const char* pCustomDataFileInputPath; // カスタムデータ検索パス

unsigned long dwDataCode; // データソースエンコーディング形式

const char* pInputDataTextName; // CSV データファイル名

const char* pCustomDataTextName; // カスタムデータファイル名

const char* pPrtName; // 出力先プリンタ名

unsigned long dwStartPage; // 印刷開始ページ番号

unsigned long dwEndPage; // 印刷終了ページ番号

unsigned long dwCopies; // 部数指定

unsigned long dwCollateFlag; // 部単位印刷指定

unsigned long dwDuplex; // 両面印刷指定

const char* pReportName; // 印刷帳票名（印刷ジョブ名）

RA_BOOL bUseAdjust; // 印刷開始位置調整使用有無

double dAdjustOffsetX; // 横方向印刷開始位置

double dAdjustOffsetY; // 縦方向印刷開始位置

const char* pEnvironmentFileName; // 環境情報移入用レポート定義ファイル名

HWND hWndOwner; // オーナーウィンドウハンドル

unsigned long dwFlag; // 印刷動作フラグ

const char* pLogFileName; // ログファイル名

int logSize; // ログファイルサイズ

unsigned long dwErrCode; // 処理結果情報

char ErrorDetail[260]; // エラーメッセージ文字列

unsigned char Reserve[32];

unsigned long dwLogErrCode; // ログ採取結果情報

char LogErrorDetail[260]; // ログ採取エラー文字列

unsigned char LogReserve[32];

} RA_PRINT_CTLINFO, *PRA_PRINT_CTLINFO;

《メンバ説明》

dwID

構造体のバージョンを識別するシグネチャとして、常に RA_PRINT_CTLINFO_SIG を呼び出し元で設定します。それ

以外の値が設定された場合の動作は不定です。

pRpdFileName

レポート定義ファイル名文字列へのポインタを指定します。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序で定義ファイルを検

索します。但し、相対パスでの指定はできません。




- 62 -

pImageFileInputPath



①当メンバで指定されたディレクトリ





pDataFileInputPath








pCustomDataFileInputPath








dwDataCode

データの文字コード系（エンコーディング形式）を指定します。当メンバの指定がない場合は、シフト JIS が指定

されたものとみなします。


RA_CODE_SJIS シフト JIS

RA_CODE_UTF8 UTF-8

RA_CODE_UTF16 UTF-16


　以前のバージョンの指定値「RA_CODE_UCS2」は、V2.4 で「RA_CODE_UTF16」に変更しました。UTF-16 は、UCS-2

で表現できる文字に加え、さらに多くの文字が表現可能となっています。従来との互換性のため、「RA_CODE_UCS2」

が指定された場合は「RA_CODE_UTF16」が指定されたものとして動作します。

pInputDataTextName

データソースファイル名文字列ポインタを指定します。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥売上げデータ）以外の場合は、以下の順序でデータソースフ

ァイルを検索します。但し、相対パスでの指定はできません。

①pDataFileInputPath メンバで指定されたディレクトリ





当メンバに NULL が指定された場合は、レポート定義の指定に従います。


- 63 -

pCustomDataTextName

カスタムデータソースファイル名文字列ポインタを指定します。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥売上げデータ）以外の場合は、以下の順序でカスタムデータ

ソースファイルを検索します。但し、相対パスでの指定はできません。

①pCustomDataFileInputPath メンバで指定されたディレクトリ






pPrtName

印刷を行うプリンタ名文字列ポインタを指定します。NULL 指定時は、デフォルトプリンタ（「通常使うプリンタ」

で定義されているもの）に出力されます。プリンタ名文字列として、"!ReportDef"を指定した場合はレポート定義

の指定に従います。プリンタ名文字列として、"!SelectPrinter"を指定した場合は[印刷]ダイアログボックスを表

示し、そこで選択されたプリンタに印刷します。

指定プリンタがシステム上で見つからない場合、印刷は失敗します。

dwStartPage

印刷を開始するページ番号を指定します。指定できる値は 0～65535 までです。0 を指定した場合は 1 ページ目か

ら印刷します。ここで指定するページ番号は、物理的な用紙枚数単位で指定します。

dwEndPage

印刷を終了するページ番号を指定します。指定できる値は 0～65535 までです。0 または最終ページを超える値を

指定した場合は、最終ページまで印刷します。ここで指定するページ番号は、物理的な用紙枚数単位で指定します。

dwCopies


部数印刷を行えない場合があり、この場合当メンバの指定は無視されます。

0 を指定した場合は、レポート定義の指定に従います。

dwCollateFlag

複数部印刷時の丁合有無を以下の値で指定します。プリンタドライバによっては丁合指定が行えない場合がありま

す。この場合は、当メンバの指定は無視されます。

RA_COLLATE_DEFAULT レポート定義の指定に従う

RA_COLLATE_TRUE 丁合印刷を行う

RA_COLLATE_FALSE 丁合印刷を行わない

dwDuplex

両面印刷するか否かを以下の値で指定します。プリンタドライバによっては両面指定が行えない場合があります。

この場合は、当メンバの指定は無視されます。

RA_DUPLEX_DEFAULT レポート定義の指定に従う

RA_DUPLEX_SIMPLEX 片面印刷

RA_DUPLEX_HORIZONTAL 両面印刷（横綴じ）

RA_DUPLEX_VERTICAL 両面印刷（縦綴じ）


- 64 -

pReportName

レポート名文字列ポインタを指定します。ここで指定された名前はプリントジョブ名となり、プリントフォルダに

表示されます。指定できる文字数は半角文字換算で 1～64 文字までです。NULL 指定時はレポート定義の指定に従

います。

bUseAdjust

dAdjustOffsetX メンバおよび dAdjustOffsetY メンバを有効にするか否かを指定します。

RA_TRUE 有効にする

RA_FALSE 無視する

dAdjustOffsetX

印刷開始位置の横方向微調整量を指定します。単位は、インチであり、-1.00～1.00 の範囲で指定できます。負の

値のときは左方向、正の値のときは右方向の移動となります。bUseAdjust メンバ値が RA_FALSE の場合はレポート


dAdjustOffsetY

印刷開始位置の縦方向微調整量を指定します。単位は、インチであり、-1.00～1.00 の範囲で指定できます。負の

値のときは上方向、正の値のときは下方向の移動となります。bUseAdjust メンバ値が RA_FALSE の場合はレポート


pEnvironmentFileName

指定されたレポート定義ファイルのプリント情報／パス情報を移入します。他のメンバと同時に指定された場合、

他のメンバ指定が優先されます。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でレポート定義ファ

イルを検索します。但し、相対パスでの指定はできません。



当メンバ指定でレポート定義ファイルから移入される情報は以下の通りです。




・プリンタ名

・印刷部数

・丁合い

・両面印刷



hWndOwner

[印刷]ダイアログ、および[印刷中]ダイアログのオーナーウィンドウハンドルを指定します。NULL 指定時はオー

ナーなしのダイアログを表示します。

当メンバの指定を有効にするには、dwFlag メンバに RA_PRINT_USE_HWNDOWNER フラグを指定してください。

RA_PRINT_USE_HWNDOWNER フラグの指定がない場合、[印刷]ダイアログ、および[印刷中]ダイアログのオーナーは、

呼び出し元アプリケーションのアクティブなウィンドウとなります。


- 65 -

dwFlag

印刷の動作モードを指定します。以下のフラグを組み合わせて使用することができます。

フラグ意味

RA_PRINT_USE_PRINTING_DLG [印刷中]ダイアログを表示します。当ダイアログから印刷中のジョブをキャ

ンセルすることができます。

RA_PRINT_USE_HWNDOWNER hWndOwner メンバを有効にします。本指定がない場合、[印刷]ダイアログ、

および[印刷中]ダイアログのオーナーは、呼び出し元アプリケーションのア

クティブなウィンドウとなります。

pLogFileName

ログファイル名を絶対パス名で指定します。相対パスでの指定はできません。ファイル名のみ場合は、カレントデ

ィレクトリ（ユーザが現在作業しているディレクトリ）に出力されます。また、当メンバに NULL を指定した場合、

環境変数 KRA_LOG_FILE で指定されているファイルに出力します。当メンバを NULL にし、環境変数にも登録されて

いない場合、ログファイルは出力されません。

logSize

ログファイルを出力する場合の最大サイズをバイト数（キロバイト単位）で指定します。指定できる範囲は、1～

2097152（2 ギガバイト）までです。但し、指定サイズを大きくした場合には性能が著しく劣化するため、2048（2

メガバイト）以内とすることを推奨します。サイズの指定を行わない場合、または範囲外の値を指定した場合は、

50 が指定されたものとみなします。

dwErrCode

関数が異常終了した場合（復帰値＝RA_FALSE）にエラー識別コードを格納します。

エラーコード一覧については『RepoAgent　帳票出力ヘルプ』の[メッセージ一覧]トピックを参照してください。

ErrorDetail

関数が異常終了した場合（復帰値＝RA_FALSE）にエラー詳細情報を格納します。

内容については『RepoAgent　帳票出力ヘルプ』の[メッセージ一覧]トピックを参照してください。

dwLogErrCode

ログ出力が異常終了した場合にエラー識別コードを格納します。


LogErrorDetail

ログ出力が異常終了した場合にエラー詳細情報を格納します。



- 66 -

３.３.２使用例

ここでは、C 言語で帳票出力 API を使用して、サンプル帳票の印刷を行う方法を例示します。


1) ソースプログラム中では以下の記述でヘッダファイルをインクルードします。

2) プログラムをビルドする場合には、以下のインポートライブラリをリンクします。

3) RepoAgent 帳票出力 API 関数を使用して、プログラムを記述します。ここでは、納品伝票を印刷するソース

例を示します。

【補足】 RAAPI.h および raapi.lib は、RepoAgent インストールフォルダ ¥Develop の下に格納されて

います。

【参照】-構造体や関数の詳細は、『RepoAgent　帳票出力ヘルプ』の[帳票出力 API]トピックを参照して

ください。

　　　　-帳票出力 API のエラーメッセージの詳細は、『RepoAgent　帳票出力ヘルプ』の[メッセージ一

覧]トピックを参照してください。


#include "RAAPI.h"

raapi.lib

#include <windows.h>#include "RAAPI.h"

int main(int argc, char* argv[]){ RA_BOOL bRet = RA_FALSE; RA_PRINT_CTLINFO pc;

ZeroMemory( &pc, sizeof(RA_PRINT_CTLINFO) ); /*RA_PRINT_CTLINFO 構造体の初期化 */ pc.dwID = RA_PRINT_CTLINFO_SIG; /*シグネチャの指定（必須） */ pc.pRpdFileName = /*レポート定義ファイル名の指定（必須）*/ "D:¥¥PGM¥¥RepoAgent¥¥Sample¥¥納品伝票.rpd"; pc.pInputDataTextName = /*データソースファイル名の指定 */ "D:¥¥PGM¥¥RepoAgent¥¥Sample¥¥納品伝票.csv"; pc.pPrtName = "!SelectPrinter"; /*[印刷]ダイアログの表示指定 */

/* 帳票印刷の実行 */ bRet = RA_Print( &pc );

/* 印刷実行結果判定 */ if( bRet == RA_TRUE ) { /* 正常復帰 */ MessageBox( NULL, "印刷終了", "納品伝票", MB_OK | MB_ICONINFORMATION ); return 0; } else { /* 異常復帰 */ TCHAR szText[512]; /* エラーコードとエラー詳細情報を表示する */ wsprintf( szText, "印刷失敗¥n¥n[%d]¥n%s", pc.dwErrCode, pc.ErrorDetail); MessageBox( NULL, szText, "納品伝票", MB_OK | MB_ICONSTOP ); return -1; }}


- 67 -

３.４帳票出力コントロールでの印刷

３.４.１使用方法

ここでは、帳票出力コントロールの使用方法について説明します。

【メソッド】

メソッド名型概要

ReportPrint BOOL レポート定義の指定に従い、プリンタに帳票を出力する。

【プロパティ】

プロパティ名型概要

・レポート定義ファイル名

RpdFileName 文字列型レポート定義ファイル名

・入力データ情報

DataCode 整数型文字コード系

InputDataTextName 文字列型データソースファイル名

CustomDataTextName 文字列型カスタムデータソースファイル名

・出力情報

PrtName 文字列型プリンタ名

ReportName 文字列型文書名

PStartPage 整数型印刷開始ページ

PEndPage 文字列型印刷終了ページ

Copies 整数型コピー部数

CollateFlag 整数型丁合印刷

Duplex 整数型両面印刷

UseAdjust 整数型印刷開始位置調整の有無

AdjustOffsetX 浮動小数点型印刷開始位置の横方向微調整量

AdjustOffsetY 浮動小数点型印刷開始位置の縦方向微調整量

・エラー通知情報

ErrCode 整数型エラーコード

ErrorDetail 文字列型エラー内容文字列

LogErrCode 整数型ログ出力のエラーコード

LogErrorDetail 文字列型ログ出力のエラー内容文字列

・環境情報

Version 文字列型バージョン情報

Mode 整数型動作モード

ImageFileInputPath 文字列型イメージファイル検索パス

DataFileInputPath 文字列型データソースファイル検索パス

CustomDataFileInputPath 文字列型カスタムデータソースファイル検索パス

EnvironmentFileName 文字列型環境情報移入ファイル

LogFileName 文字列型ログ採取ファイル名

LogSize 数値型最大ログ採取量

hWndOwner 数値型オーナーウィンドウハンドル

UsePrintingDlg BOOL [印刷中]ダイアログの表示有無

UseHwndOwner BOOL hWndOwner プロパティの使用有無


- 68 -

◆メソッド

ReportPrint


RepoAgent.ReportPrint

《引数》

なし

《復帰値》

正常終了 : 0 以外

異常終了 : 0

《補足》

・当メソッドが異常終了した場合は、異常終了の要因が ErrCode および ErrorDetail プロパティに設定されます。

・ログ出力に失敗した場合は、LogErrCode および LogErrorDetail にエラー情報が設定されます。LogErrCode にエラ

ー情報が設定されていても、ErrCode にエラー情報が設定されていない場合は、印刷は正常に行われています（ロ

グ出力のみ異常となっています）。

・当メソッドを呼び出す前に UsePrintingFlag に True を設定しておくと、印刷ジョブのキャンセルが可能となりま

す。

・印刷ジョブをキャンセルした場合、当メソッドは異常復帰し、エラーコード（ErrCode プロパティ）に 913 が通知

されます。

・OS の印刷キューから印刷ジョブをキャンセルした場合の動作はプリンタドライバに依存します。

◆プロパティ

RpdFileName

レポート定義ファイル名を指定します。当プロパティは必ず指定する必要があります。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でファイルを検索し

ます。但し、相対パスでの指定はできません。



DataCode

データの文字コード系（エンコーディング形式）を指定します。当プロパティの指定がない場合は、シフト JIS


ここでの指定と、実際に入力するデータソースの指定が一致していない場合、動作は不定です。

0 シフト JIS

1 UTF-8

2 UTF-16


　V2.4 で指定値「2」の意味を UCS-2 から UTF-16 に変更しました。UTF-16 は、UCS-2 で表現できる文字に加え、

さらに多くの文字が表現可能となっています。


- 69 -

InputDataTextName

データソースファイル名を指定します。当プロパティの指定がない場合、または、""（空文字）指定の場合は、レ

ポート定義の指定に従います。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でデータソースファ


①DataFileInputPath プロパティで指定されたディレクトリ





CustomDataTextName

カスタムデータソースファイル名を指定します。当プロパティの指定がない場合、または""（空文字）指定の場合

は、レポート定義の指定に従います。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でカスタムデータソ

ースファイルを検索します。但し、相対パスでの指定はできません。

①CustomDataFileInputPath プロパティで指定されたディレクトリ





PrtName

印刷を行うプリンタ名を指定します。指定により以下の動作を行います。

プリンタ名指定

指定したプリンタに印刷を行う。

""（空文字）指定または指定なし

デフォルトプリンタ（「通常使うプリンタ」で定義されているもの）に印刷を行う。

"!ReportDef"指定

レポート定義で指定されたプリンタに印刷を行う。

"!SelectPrinter"指定

[印刷]ダイアログを表示し、そこで選択したプリンタに印刷を行う。

指定したプリンタがシステム上で見つからなかった場合、印刷は失敗します。

ReportName

レポート名を指定します。レポート名は、プリントジョブ名として扱われます。

指定できる文字数は半角文字数換算で 1～64 文字までであり、""（空文字）を指定した場合、または当プロパティ

を指定しない場合はレポート定義の指定に従います。

PStartPage

印刷を開始するページ番号を指定します。指定できる値は 0～65535 までです。0 を指定した場合、または当プロ

パティを指定しない場合は先頭ページから出力を開始します。

PEndPage

印刷を終了するページ番号を指定します。指定できる値は 0～65535 までです。0 または最終ページを超える値を

指定した場合、または当プロパティを指定しない場合は最終ページまで出力します。


- 70 -

Copies


部数印刷を行えない場合があり、この場合当プロパティの指定は無視されます。

0 を指定した場合、または当プロパティを指定しない場合はレポート定義の指定に従います。

CollateFlag

複数部印刷時の丁合有無を以下の値で指定します。プリンタドライバによっては丁合指定が行えない場合があり、

この場合当プロパティの指定は無視されます。

0 レポート定義の指定に従う

1 丁合印刷を行う

2 丁合印刷を行わない

当プロパティを指定しない場合はレポート定義の指定に従います。

Duplex

両面印刷するか否かを以下の値で指定します。プリンタドライバによっては両面印刷指定が行えない場合があり、

この場合当プロパティの指定は無視されます。

0 レポート定義の指定に従う

1 片面印刷

2 両面印刷（横綴じ）

3 両面印刷（縦綴じ）

当プロパティを指定しない場合はレポート定義の指定に従います。

UseAdjust

印刷開始位置調整の有無を指定します。

True 印刷開始位置調整を行う。AdjustOffsetX／AdjustOffsetY の指定が有効となります。

False 印刷開始位置調整を行わない。AdjustOffsetX／AdjustOffsetY の指定が無効となります。

当プロパティを指定しない場合は印刷位置の調整を行いません。

AdjustOffsetX

印刷開始位置の横方向微調整量を指定します。単位はインチであり、-1.00～1.00 の範囲で指定できます。マイナ

スは左方向、プラスは右方向の移動となります。初期値は 0 となっています。

※当指定は、UseAdjust プロパティが True の場合のみ有効となります。

AdjustOffsetY

印刷開始位置の縦方向微調整量を指定します。単位はインチであり、-1.00～1.00 の範囲で指定できます。マイナ

スは上方向、プラスは下方向の移動となります。初期値は 0 となっています。

※当指定は、UseAdjust プロパティが True の場合のみ有効となります。

ErrCode

参照のみのプロパティであり、エラーコードが通知されます。


ErrorDetail

参照のみのプロパティであり、エラー内容を示す文字列が通知されます。



- 71 -

LogErrCode

参照のみのプロパティであり、ログ出力時のエラーコードが通知されます。ログ採取を行った場合のみ有効です。

当プロパティにエラー情報が設定されていても、ErrCode にエラー情報が設定されていない場合は、印刷等の出力

処理は正常に行われています（ログ出力のみ異常となっている）。


LogErrorDetail

参照のみのプロパティであり、ログ出力時のエラー内容を示す文字列が通知されます。


Version

参照のみのプロパティであり、帳票出力コントロールのバージョンを通知します。バージョンが 1.2.3.4 の場合は

"1.2.3.4"の文字列が設定されています。

Mode

動作モードを指定します。

必ず 0 を指定してください。

ImageFileInputPath

イメージファイルを検索するディレクトリパス名を指定します。複数のパスを指定する場合は、セミコロン（;）

で区切って指定します。イメージファイルは、以下の順序で検索されます。

①当プロパティで指定されたディレクトリ





DataFileInputPath

データソースファイルを検索するディレクトリパス名を指定します。複数のパスを指定する場合は、セミコロン（;）

で区切って指定します。データソースファイルの検索順序については、InputDataTextName プロパティの説明を参

照してください。

CustomDataFileInputPath

カスタムデータソースファイルを検索するディレクトリパス名を指定します。複数のパスを指定する場合は、セミ

コロン（;）で区切って指定します。カスタムデータソースファイルの検索順序については、CustomDataTextName

プロパティの説明を参照してください。


- 72 -

EnvironmentFileName

他のレポート定義ファイルから、プリント情報／パス情報を移入する場合に指定します。当プロパティで指定した

レポート定義ファイルのプリント情報／パス情報を移入します。他のプロパティと同時に指定された場合は、他の

プロパティの指定を優先します。





当プロパティの指定がない場合、または""（空文字）指定の場合は、環境移入を行いません。

当プロパティ指定でレポート定義ファイルから移入される情報は以下の通りです。



・カスタムデータソースファイル入力パス名

・プリンタ名

・印刷部数

・丁合い

・両面印刷



LogFileName

ログファイル名を絶対パスで指定します。パスがない場合はカレントディレクトリ（ユーザが現在作業しているデ

ィレクトリ）にログを出力します。当指定がある場合は、環境変数によるログ採取指定は無効となります。

LogSize

ログファイルの最大サイズをキロバイト単位の値で指定します。指定できる範囲は、1～2097152（2 ギガバイト）

までです。但し、指定サイズを大きくした場合には性能が著しく劣化するため、2048（2 メガバイト）以内とする

ことを推奨します。ログファイル名の指定があり、サイズの指定がない場合、または範囲外の値を指定した場合、


hWndOwner

[印刷]ダイアログ、および[印刷中]ダイアログのオーナーウィンドウハンドルを指定します。当プロパティを指

定しない場合は、オーナーなしのダイアログを作成します。

当プロパティの指定を有効にするには、UseHwndOwner プロパティに True を指定してください。

UseHwndOwner プロパティの値が False の場合、または UseHwndOwner プロパティを指定しない場合は、[印刷]ダイ

アログ、および[印刷中]ダイアログのオーナーは、呼び出し元アプリケーションのアクティブなウィンドウとなり

ます。

UsePrintingDlg

[印刷中]ダイアログを表示するか否かを指定します。当ダイアログから印刷中のジョブをキャンセルすることがで

きます。

True [印刷中]ダイアログを表示する。

False [印刷中]ダイアログを表示しない。

当プロパティを指定しない場合は、[印刷中]ダイアログを表示しません。

UseHwndOwner

hWndOwner プロパティを有効にするか否かを指定します。

True hWndOwner プロパティを有効にします。

False hWndOwner プロパティを無効にします。

当プロパティを指定しない場合は、hWndOwner プロパティを無効にします。


- 73 -

３.４.２使用例

ここでは、Visual Basic で帳票出力コントロールを使用して、サンプル帳票の印刷を行う方法を例示します。

1) Visual Basic を起動し、プロジェクトを開くか、新規作成します。

2) [プロジェクト]-[コンポーネント]メニューコマンドを選択します。

⇒ [コンポーネント]ダイアログが表示されます。

3) [コンポーネント]-[コントロール]ページで、｢RepoAgent 帳票出力コントロール｣をチェックし、[OK]ボタン

をクリックします。

⇒ ツールボックスに RepoAgent のアイコンが表示されます。

4) ツールボックスの RepoAgent アイコンをクリックし、フォーム上の任意の位置に RepoAgent 帳票出力コン

トロールを配置します。

5) 以下に示すいずれかの方法で、帳票出力コントロールのプロパティを設定します。

・ Visual Basic の[プロパティ]ウィンドウで設定を行う。

・フォーム上に配置した帳票出力コントロールをマウスで右クリックし、表示されるコンテキストメ

ニューの[プロパティ]コマンドを選択することにより表示されるプロパティページで設定を行う。

・ソースプログラムの記述で設定する。

6) RepoAgent 帳票出力コントロールのオブジェクト変数を使用して、メソッドの起動を行うプログラムを記述

します。ここでは、Command1 ボタンがクリックされた場合に納品伝票を印刷するソース例を示します。

【参照】-プロパティやメソッドの詳細は、『RepoAgent　帳票出力ヘルプ』の[帳票出力コントロール]ト

ピックを参照してください。

　　　　-帳票出力コントロールのエラーメッセージの詳細は、『RepoAgent　帳票出力ヘルプ』の[メッ

セージ一覧]トピックを参照してください。

Private Sub Command1_Click() Dim ResultMessage As String

'プロパティの設定 With RepoAgent1 .RpdFileName = "D:¥PGM¥RepoAgent¥Sample¥納品伝票.rpd" 'レポート定義ファイル名 .InputDataTextName = "D:¥PGM¥RepoAgent¥Sample¥納品伝票.csv" 'データソースファイル名 .PrtName = "!SelectPrinter" '[印刷]ダイアログ表示指定 .ReportName = "納品伝票" 'レポート名 ' '必要に応じて、ここにプロパティの設定を記述します ' End With

'印刷メソッドの実行 RepoAgent1.ReportPrint

'印刷メソッドの実行結果判定 If RepoAgent1.ErrCode = 0 Then ResultMessage = "印刷成功" Else ResultMessage = "印刷失敗" + (Chr(13) & Chr(10)) + _ RepoAgent1.ErrorDetail 'エラー詳細メッセージ文 End If '印刷結果の通知 MsgBox ResultMessageEnd Sub


- 74 -

３.５帳票出力クラスでの印刷

３.５.１使用方法

ここでは、帳票出力クラスを使用した印刷方法について説明します。印刷を行うには、以下のクラスおよびインタフ

ェースを使います。

パッケージ名クラス名概要

RaReport 帳票の印刷および表示を行うクラスcom.fujitsu.fjh.RepoAgent

RaReportException 帳票の印刷および表示実行時の例外クラス

パッケージ名インタフェース名概要

DataCode データソースエンコーディング形式指定用の定数

Collate 丁合指定用の定数com.fujitsu.fjh.RepoAgent

Duplex 両面印刷指定用の定数

◆RaReport クラス

public class RaReport

帳票プロセッサおよび帳票ビューアの機能を呼び出す際に使用するクラスです。印刷に関するメソッドの説明を以降

に記します。

《メソッド》

print

public void print( String rpdName ) throws RaReportException

レポート定義の指定に従って、帳票をプリンタに印刷します。

引数：

rpdName：[IN]

レポート定義ファイル名を指定します。

使用可能な文字は、シフト JIS エンコーディング形式で表現可能な文字集合とします。

絶対パス名指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でディレクトリを検索します。但

し、相対パス名は指定できません。

①　環境変数 KRA_DEFINITION_FILE_PATH で指定されたディレクトリ

②　カレントディレクトリ（ユーザが現在作業しているディレクトリ）

補足：

当メソッドの処理が失敗した場合、または、メソッドの処理は成功しているがログの出力に失敗した場合、

RaReportException 例外が投入されます。RaReportException クラスの説明を参照してください。

当メソッドを呼び出す前に setUsePrintingDlg()メソッドを引数 true で呼び出しておくと、印刷ジョブのキ

ャンセルが可能となります。

印刷ジョブをキャンセルした場合、RaReportException 例外が投入され、エラーコードは 913 が通知されます。

OS の印刷キューから印刷ジョブをキャンセルした場合の動作はプリンタドライバに依存します。


- 75 -

setDataCode

void setDataCode( int code )

データソースファイルおよびカスタムデータソースファイルに格納されているデータのエンコーディング形式を

指定します。ここでの指定と、実際に入力するデータソースのエンコーディング形式が一致していない場合、正

しく印刷が行われません｡

引数：

code：[IN]

以下の定数のいずれかを指定します。

DataCode.SJIS ：シフト JIS

DataCode.UTF8 ：UTF-8


補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、データの文字コード系をシフト JIS

と仮定して動作します。


　以前のバージョンの指定値「DataCode.UCS2」は、V2.4 で「DataCode.UTF16」に変更しました。UTF-16 は、UCS-2

で表現できる文字に加え、さらに多くの文字が表現可能となっています。従来との互換性のため、「DataCode.UCS2」

が指定された場合は「DataCode.UTF16」が指定されたものとして動作します。

setInputDataTextName

void setInputDataTextName( String name )

データソースファイル名を指定します。

引数：

name：[IN]


空文字列（""）または null を指定した場合、レポート定義の指定に従います。

絶対パス名指定（［例］C:¥Report¥売上げデータ）以外の場合は、以下の順序でディレクトリを検索します。

但し、相対パス名は指定できません。

①　setDataFileInputPath メソッドで指定されたディレクトリ

②　環境変数 KRA_INPUTDATA_FILE_PATH で指定されたディレクトリ

③　レポート定義で指定されたディレクトリ

④　レポート定義ファイルと同一のディレクトリ

⑤　カレントディレクトリ（ユーザが現在作業しているディレクトリ）

補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、レポート定義の指定に従います。


- 76 -

setCustomDataTextName

void setCustomDataTextName( String name )

カスタムデータソースファイル名を指定します。

引数：

name：[IN]



絶対パス名指定（［例］C:¥Report¥表題データ）以外の場合は、以下の順序でディレクトリを検索します。但


①　setCustomDataFileInputPath メソッドで指定されたディレクトリ

②　環境変数 KRA_CUSTOMDATA_FILE_PATH で指定されたディレクトリ




補足：


setPrinterName

void setPrinterName( String name )

印刷を行うプリンタ名を指定します。指定プリンタがシステム上で見つからない場合、印刷は失敗します。

引数：

name：[IN]


以下の形式のいずれかで指定します。

プリンタ名：指定されたプリンタに印刷

空文字列（""）：デフォルトプリンタ（「通常使うプリンタ」で定義されているもの）に印刷

null ：デフォルトプリンタ（「通常使うプリンタ」で定義されているもの）に印刷

"!ReportDef" ：レポート定義の指定に従う

"!SelectPrinter" ：[印刷]ダイアログボックスを表示し、そこで選択されたプリンタに印刷

補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、デフォルトプリンタ（「通常使う

プリンタ」で定義されているもの）に印刷されます。

setReportName

void setReportName( String name )

レポート名を指定します。

引数：

name：[IN]



ここで指定された名前はプリントジョブ名となり、プリントフォルダに表示されます。指定できる文字数は半

角文字換算で 1～64 文字までです。

補足：



- 77 -

setStartPage

void setStartPage( int page )

印刷を開始するページ番号を指定します。

引数：

page：[IN]

指定できる値は 0～65535 までです。0 を指定した場合は 1 ページ目から印刷を行います。ここで指定するペ

ージ番号は、用紙枚数単位で指定します。

補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、1 ページ目から印刷を行います。

setEndPage

void setEndPage( int page )

印刷を終了するページ番号を指定します。

引数：

page：[IN]

指定できる値は 0～65535 までです。0 または最終ページを超える値を指定した場合は、最終ページまで印刷

します。ここで指定するページ番号は、用紙枚数単位で指定します。

補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、最終ページまで印刷します。

setCopies

void setCopies( int copies )

コピー部数を指定します。

引数：

copies：[IN]

指定できる値は 0～32767 までです。0 を指定した場合は、レポート定義の指定に従います。

補足：

プリンタドライバによっては指定どおりの部数印刷を行えない場合があります。この場合、当指定は無視され

ます。


setCollate

void setCollate( int collate )

複数部印刷時の丁合有無を指定します。

引数：

collate：[IN]


Collate.DEFAULT ：レポート定義の指定に従う

Collate.TRUE ：丁合印刷を行う

Collate.FALSE ：丁合印刷を行わない

補足：

プリンタドライバによっては丁合指定が行えない場合があります。この場合、当指定は無視されます。



- 78 -

setDuplex

void setDuplex( int duplex )

両面印刷方法を指定します。

引数：

duplex：[IN]


Duplex.DEFAULT ：レポート定義の指定に従う

Duplex.SIMPLEX ：片面印刷を行う

Duplex.HORIZONTAL ：両面印刷（横綴じ）を行う

Duplex.VERTICAL ：両面印刷（縦綴じ）を行う

補足：

プリンタドライバによっては両面指定が行えない場合があります。この場合、当指定は無視されます。


setUseAdjust

void setUseAdjust( boolean bUse )

印刷開始左上位置の微調整量として、レポート定義の設定を有効にするか、当クラスの setAdjustOffsetX メソッ

ドおよび setAdjustOffsetY メソッドでの指定を有効にするかを指定します。

引数：

bUse：[IN]

true ：setAdjustOffsetX メソッドおよび setAdjustOffsetY メソッドでの指定を有効にする

false ：レポート定義の指定に従う

補足：


setAdjustOffsetX

void setAdjustOffsetX( double offset )

印刷開始左端位置の横方向微調整量を指定します。

引数：

offset：[IN]

指定単位はインチとし、-1.00inch～1.00inch の範囲で指定します。負の値のときは左方向、正の値のときは

右方向への移動となります。

補足：

setUseAdjust メソッドが引数 true で呼び出されていない場合、当指定は有効になりません。

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、印刷開始左端位置の横方向微調整

を行いません。


- 79 -

setAdjustOffsetY

void setAdjustOffsetY( double offset )

印刷開始上端位置の縦方向微調整量を指定します。

引数：

offset：[IN]

指定単位はインチとし、-1.00inch～1.00inch の範囲で指定できます。負の値のときは上方向、正の値のとき

は下方向への移動となります。

補足：

setUseAdjust メソッドが引数 true で呼び出されていない場合、当指定は有効になりません。

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、印刷開始上端位置の縦方向微調整

を行いません。

setImageFileInputPath

void setImageFileInputPath( String path )

帳票の印刷に使用する画像ファイルを検索するディレクトリパス名を指定します。

引数：

path：[IN]


複数のパスを指定する場合は、セミコロン（;）で区切って指定します。

空文字列（""）または null を指定した場合、当メソッドでのパス指定が行われていないものとみなします。

以下の順序でディレクトリを検索します。

①　当メソッドで指定されたディレクトリ

②　環境変数 KRA_IMAGEFILE_PATH で指定されたディレクトリ




setDataFileInputPath

void setDataFileInputPath( String path )

データソースファイルを検索するディレクトリパス名を指定します。

引数：

path：[IN]


複数のパスを入力する場合は、セミコロン（;）で区切って指定します。









- 80 -

setCustomDataFileInputPath

void setCustomDataFileInputPath( String path )

カスタムデータソースファイルを検索するディレクトリパス名を指定します。

引数：

path：[IN]










setEnvironmentFileName

void setEnvironmentFileName( String name )

プリント情報／パス情報を移入するためのレポート定義ファイル名を指定します。

レポート定義ファイルから移入される情報は以下の通りです。




・プリンタ名

・印刷部数

・丁合い

・両面印刷



移入された情報よりも、本クラスのメソッドでの指定が優先されることに注意してください。

引数：

name：[IN]


空文字列（""）または null を指定した場合、情報の移入は行われません。






- 81 -

setLogFileName

void setLogFileName( String name )

ログファイル名を指定します

引数：

name：[IN]


空文字列（""）または null を指定した場合、環境変数 KRA_LOG_FILE で指定されているファイルに出力します。

但し、環境変数にもファイル名が設定されていない場合、ログファイルは出力されません。

絶対パス名またはファイル名のみを指定します（相対パスでの指定は行えません）。ファイル名のみ指定した

場合、現在位置のディレクトリに出力されます。

補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、環境変数 KRA_LOG_FILE で指定さ

れているファイルに出力されます（環境変数にもファイル名が設定されていない場合、ログファイルは出力さ

れません）。

setLogFileSize

void setLogFileSize( int size )

ログファイルの最大サイズをバイト数（キロバイト単位）で指定します。

引数：

size：[IN]

指定できる範囲は、1～2097152（2 ギガバイト）までです。サイズ指定を行わない場合、または範囲外の値を

指定した場合は、50 となります。

補足：

指定サイズを大きくした場合には性能が著しく劣化するため、2048(2 メガバイト)以内とすることを推奨しま

す。

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、最大サイズを 50 キロバイトとし

ます。

setUsePrintingDlg

void setUsePrintingDlg( boolean bUse )

[印刷中]ダイアログを表示するか否かを指定します。当ダイアログから印刷中のジョブをキャンセルすることが

できます。

引数：

bUse：[IN]

true ：[印刷中]ダイアログを表示する

false ：[印刷中]ダイアログを表示しない

補足：

print メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、[印刷中]ダイアログを表示しませ

ん。


- 82 -

◆RaReportException クラス

public class RaReportException

エラー発生時の例外情報を保持するクラスです。

《メソッド》

getErrCode

public int getErrCode()

エラーを識別するためのコードを取得します。

戻り値：

エラーコードを返却します。エラーコード一覧については、『RepoAgent　帳票出力　ヘルプ』の[メッセージ

一覧]トピックを参照してください。

getErrDetail

public String getErrDetail()

エラー詳細情報を現すメッセージ文字列を取得します。

戻り値：

エラーメッセージ文字列を返却します。エラーメッセージ一覧については、『RepoAgent　帳票出力　ヘルプ』

の[メッセージ一覧]トピックを参照してください。

getLogErrCode

public int getLogErrCode()

ログ出力が異常終了した場合にエラーを識別するためのコードを取得します。

戻り値：

ログに関するエラーコードを返却します。エラーコード一覧については、『RepoAgent　帳票出力　ヘルプ』の

[メッセージ一覧]トピックを参照してください。

補足：

当メソッドでエラーコードが返却されていても、getErrCode メソッドの復帰値にエラー情報が返却設定され

ていない（値が 0）場合、印刷は正常に行われており、ログ出力のみ異常となっていることを示します。

getLogErrDetail

public String getLogErrDetail()

ログ出力エラー詳細情報を現すメッセージ文字列を取得します。

戻り値：

ログに関するエラーメッセージ文字列を返却します。エラーメッセージ一覧については、『RepoAgent　帳票出

力　ヘルプ』の[メッセージ一覧]トピックを参照してください。


- 83 -

◆DataCode インタフェース

public class DataCode

データソースのエンコーディング形式指定時に使用する定数です。

《フィールド》

SJIS

public static final int SJIS

シフト JIS を意味します。

UTF8

public static final int UTF8

UTF-8 を意味します。

UTF16

public static final int UTF16

UTF-16 を意味します。

UCS2

public static final int UCS2

V2.4 より前のバージョンとの互換性のために残されています。V2.4 以降のバージョンでは、UTF16 を使用してく

ださい。

◆Collate インタフェース

public class Collate

複数部印刷時の丁合有無指定時に使用する定数です。


DEFAULT

public static final int DEFAULT

レポート定義の指定に従うことを意味します。

TRUE

public static final int TRUE

丁合印刷を行うことを意味します。

FALSE

public static final int FALSE

丁合印刷を行わないことを意味します。


- 84 -

◆Duplex インタフェース

public interface Duplex

両面印刷の有無および両面印刷の方法指定時に使用する定数です。


DEFAULT

public static final int DEFAULT

レポート定義の指定に従うことを意味します。

SIMPLEX

public static final int SIMPLEX

両面印刷を行わないことを意味します。

HORIZONTAL

public static final int HORIZONTAL

横綴じで両面印刷を行うことを意味します。

VERTICAL

public static final int VERTICAL

縦綴じで両面印刷を行うことを意味します。


３.５.２使用例

ここでは、帳票出力クラスを使用して、サンプル帳票の印刷を行う方法を例示します。


1) ソースプログラム中では以下の記述で本パッケージをインポートします。

2) クラスをコンパイルまたは実行する場合には、javac コマンドまたは java コマンドの-classpath オプションに

以下のパス名を追加指定します。

3) ソースプログラム記述例を以下に示します。

set PATH=%PATH%;RepoAgent インストールフォルダ¥Program

import com.fujitsu.fjh.RepoAgent.*;

RepoAgent インストールフォルダ¥Program¥rareport.jarRepoAgent インストールフォルダ¥Program¥racom.jar


public class RaReportTest { public static void main(String[] args) { try { RaReport rp = new RaReport(); rp.setInputDataTextName("納品伝票.csv"); rp.print ("納品伝票.rpd"); } catch( RaReportException e ) { System.out.println( "scode = " + e.getErrCode() ); System.out.println( "err detail = " + e.getErrDetail() ); System.out.println( "log err code = " + e.getLogErrCode() ); System.out.println( "log err detail = " + e.getLogErrDetail() ); } }}

- 85 -


- 86 -

第４章帳票の表示

帳票の表示は、次に示す 4 つの方法で行います。

■ 「RepoAgent　帳票出力コマンド」

コマンドプロンプト画面からの起動に適しています。

■ 「RepoAgent　帳票出力 API」

C 言語などで記述されたプログラムからの起動に適しています。

■ 「RepoAgent　帳票出力コントロール」

Visual Basic などで記述されたプログラムからの起動に適しています。

■ 「RepoAgent　帳票出力クラス」

Java 言語で記述されたプログラムからの起動に適しています。

ここでは、それぞれの使用方法とサンプル帳票を表示する例を示します。

【補足】ここで使用する帳票およびデータソースファイルは、以下にサンプルとして格納されています。

RepoAgent インストールフォルダ ¥Sample¥納品伝票.rpd

RepoAgent インストールフォルダ ¥Sample¥納品伝票.csv

４.１環境変数

ここでは、帳票出力時の環境を設定するために使用できる環境変数について説明します。

KRA_DEFINITION_FILE_PATH

レポート定義ファイルを検索するディレクトリパス名を指定します。複数のパス名を指定する場合は、セミコロン

（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】


KRA_IMAGEFILE_PATH

帳票に表示するイメージファイルを検索するディレクトリパス名を指定します。複数のパス名を指定する場合は、

セミコロン（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】



- 87 -

KRA_INPUTDATA_FILE_PATH

帳票に表示するデータソースファイルを検索するディレクトリパス名を指定します。複数のパス名を指定する場合

は、セミコロン（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】


KRA_CUSTOMDATA_FILE_PATH

帳票に表示するカスタムデータソースファイルを検索するディレクトリパス名を指定します。複数のパス名を指定

する場合は、セミコロン（;）で区切って指定します。



［検索順序］

1. c:¥aaa¥bbb

2. d:¥ddd

【注意】


KRA_LOG_FILE

帳票出力時に書き出すログファイルへの絶対パス名を指定します。当設定を行うと、必ずログ出力を行うようにな

ります。以下に指定形式、および例を示します。

形式：ログファイル名／ログファイルサイズ

ログファイル名

ログファイル名を絶対パスで指定します。パスがない場合はカレントディレクトリ（ユーザが現在作業して

いるディレクトリ）にログを出力します。但し、相対パスでの指定はできません。また、ダブルクォーテー

ション（"）で囲まないでください。

ログファイルサイズ

ログファイルの最大サイズをバイト数（キロバイト単位）で指定します。半角数字のみ有効であり、"ログ

ファイル名/"の直後に指定する必要があります。指定できる範囲は、1～2097152（2 ギガバイト）までです。

但し、指定サイズを大きくした場合には性能が著しく劣化するため、2048（2 メガバイト）以内とすること

を推奨します。サイズ指定を行わない場合、または範囲外の値を指定した場合は、50 となります。

例 1）KRA_LOG_FILE=C:¥WORK.log/256

例 2）KRA_LOG_FILE=D:¥temp.log （サイズは 50 キロバイトとして扱われる）

例 3）KRA_LOG_FILE= （ログ採取しない）

【注意】

ログファイル名（パスを含む）として有効な文字数は 1～255 文字（半角文字数換算）です。256 文字（半角

文字数換算）以上となるログファイル名（パスを含む）を指定した場合には、ログファイルの作成に失敗しま

す。


- 88 -

４.２帳票出力コマンドでの表示

４.２.１使用方法

ここでは、帳票出力コマンドの使用方法について説明します。

◆コマンド形式

raview[.exe] [レポート定義ファイル名

[-dcode {sjis | utf8 | utf16}]

[-imp イメージファイル検索パス]

[-idp データソースファイル検索パス]

[-id データソースファイル名]

[-icp カスタムデータソースファイル検索パス]

[-ic カスタムデータソースファイル名]

[-lf ログファイル名]

[-sp 開始ページ]

[-e 環境情報ファイル名]

[-v]

]

※[]は省略可能です。

※オプション指定する場合は、レポート定義ファイル名を省略することはできません。

※{aaa|bbb}と表記した場合、aaa または bbb が指定可能で、aaa および bbb を同時に指定することはできません。

※オプション識別キーワードは、-xxx 形式と/xxx 形式のどちらでも可能です。

※オプション識別キーワード（-xxx）とオプション文字列の間には少なくとも 1 つの半角空白を指定します。

例） -id DataFile1 OK

-idDataFile1 NG

※指定文字列に半角空白を含める場合、ダブルクォーテーション（"）で囲って指定します。

例）raview "FileName 00" -idp "PathName 01"

◆オプション引数

レポート定義ファイル名

レポート定義ファイル名を指定します。オプション指定する場合は、当パラメタを省略することはできません。フ

ァイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序で定義ファイルを検索

します。但し、相対パスでの指定はできません。




- 89 -

-dcode {sjis | utf8 | utf16}

データソースの文字エンコーディング形式を指定します。省略時はシフト JIS が指定されたものとみなします。


sjis シフト JIS

utf8 UTF-8

utf16 UTF-16


　以前のバージョンの指定値「ucs2」は、V2.4 で「utf16」に変更しました。UTF-16 は、UCS-2 で表現できる文字

に加え、さらに多くの文字が表現可能となっています。従来との互換性のため、「ucs2」が指定された場合は「utf16」

が指定されたものとして動作します

-imp イメージファイルパス








-idp データソースファイル検索パス








-id データソースファイル名

データソースファイル名を指定します。省略時は、レポート定義の指定に従います。

データソースファイル名

CSV 形式などのテキストファイル名を入力データとして指定します。ファイルの絶対パスを含めた指定

（［例］C:¥Report¥売上げデータ）以外の場合は、-idp オプションの説明にある順序でファイルを検索しま

す。但し、相対パスでの指定はできません。

-icp カスタムデータソースファイル検索パス









- 90 -

-ic カスタムデータソースファイル名

カスタムデータソースファイル名を指定します。指定形式は、-id オプションと同様です。省略時は、レポート定

義の指定に従います。

-lf ログファイル名

指定ファイルへ動作ログ情報を出力します。ログファイル名の指定形式は、環境変数 KRA_LOG_FILE で指定する場

合と同様です。

-sp 開始ページ

帳票ビューア起動直後に表示するページ番号を指定します。指定できる値は、1～65535 までです。省略時は、1

ページ目から表示します。

-e 環境情報ファイル名

レポート定義ファイルのプリント情報およびパス情報を、環境情報として移入します。他のオプションと同時に指

定された場合、他のオプション指定が優先されます。ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売

上げ）以外の場合は、以下の順序でレポート定義ファイルを検索します。但し、相対パスでの指定はできません。



当オプション指定でレポート定義ファイルから移入される情報は以下の通りです。




・プリンタ名　※

・印刷部数　※

・丁合い　※

・両面印刷　※

・横方向印刷開始位置調整値　※

・縦方向印刷開始位置調整値　※

※帳票ビューアからの印刷の場合に有効となります。

-v

バージョン情報を表示します。当オプションを指定した場合、他のオプション指定は全て無効となります。


- 91 -

４.２.２使用例

ここでは、コマンドプロンプト画面で帳票出力コマンドを使用して、サンプル帳票の表示を行う方法を例示します。


1) サンプル帳票が格納されたフォルダに移動します。

2) 次に示すコマンドを入力することによりサンプル帳票（納品伝票.rpd）が帳票ビューア画面に表示されます。

【参照】-帳票出力コマンドのオプション引数の詳細は、『RepoAgent　帳票出力ヘルプ』の[帳票出力コ

マンド]トピックを参照してください。

　　　　-帳票出力コマンドのエラーメッセージの詳細は、『RepoAgent　帳票出力ヘルプ』の[メッセー

ジ一覧]トピックを参照してください。


cd RepoAgent インストールフォルダ ¥Sample

raview 納品伝票.rpd -id 納品伝票.csv


- 92 -

４.３帳票出力 API での表示

４.３.１使用方法

ここでは、帳票出力 API の使用方法について説明します。

◆関数インタフェース

RA_View()


#include "RAAPI.h"

RA_BOOL RA_View(PRA_VIEW_CTLINFO pViewCtlinfo);

《引数》

pViewCtlinfo RA_VIEW_CTLINFO 構造体変数へのポインタ

《復帰値》

正常終了 : RA_TRUE

異常終了 : RA_FALSE

《補足》

・パラメタ pViewCtlInfo が NULL の場合、Win32 API の GetLastError()にて ERROR_INVALID_PARAMETER が通知され

ます。

・パラメタ pViewCtlInfo バージョンが異なる場合（dwID メンバ）、Win32 API の GetLastError()にて

ERROR_INVALID_LEVEL が通知されます。

・上記エラー以外で当 API が失敗（RA_FALSE 復帰）した場合のエラー詳細は、パラメタ pViewCtlInfo の dwErrCode,

ErrorDetail メンバを参照してください。

・ログ出力に失敗した場合は、パラメタ pViewCtlInfo の dwLogErrCode,LogErrorDetail メンバにエラー情報が設定

されています。dwLogErrCode にエラー情報が設定されていても、dwErrCode にエラー情報が設定されていない場合

は、表示は正常に行われています（ログ出力のみ異常となっています）。


- 93 -

◆構造体

RA_VIEW_CTLINFO 構造体

《宣言形式》

typedef struct tagRA_VIEW_CTLINFO

{

unsigned long dwID; // 構造体識別情報（固定値）

const char* pRpdFileName; // レポート定義ファイル名

const char* pImageFileInputPath; // イメージファイル検索パス

const char* pDataFileInputPath; // CSV データ検索パス

const char* pCustomDataFileInputPath; // カスタムデータ検索パス

unsigned long dwDataCode; // データソースエンコーディング形式

const char* pInputDataTextName; // CSV データファイル名

const char* pCustomDataTextName; // カスタムデータファイル名

HWND hWndOwner; // オーナーウィンドウハンドル

unsigned long dwStartPage; // プレビュー開始ページ番号

const char* pEnvironmentFileName; // 環境情報移入用レポート定義ファイル名

unsigned long dwFlag; // 帳票ビューア動作フラグ

const char* pTitleName; // ウィンドウタイトル名

const char* pLogFileName; // ログファイル名

int logSize; // ログファイルサイズ

unsigned long dwErrCode; // エラーコード

char ErrorDetail[260]; // エラー詳細

unsigned char Reserve[32];

unsigned long dwLogErrCode; // ログ採取結果情報

char LogErrorDetail[260]; // ログ採取エラー文字列

unsigned char LogReserve[32];

} RA_VIEW_CTLINFO, *PRA_VIEW_CTLINFO;

《メンバ説明》

dwID

構造体のバージョンを識別するシグネチャとして、常に RA_VIEW_CTLINFO_SIG を呼び出し元で設定します。それ以

外の値が設定された場合の動作は不定です。

pRpdFileName

レポート定義ファイル名文字列へのポインタを指定します。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序で定義ファイルを検

索します。但し、相対パスでの指定はできません。



pImageFileInputPath









- 94 -

pDataFileInputPath








pCustomDataFileInputPath








dwDataCode

データの文字コード系（エンコーディング形式）を指定します。当メンバの指定がない場合は、シフト JIS が指定

されたものとみなします。


RA_CODE_SJIS シフト JIS

RA_CODE_UTF8 UTF-8

RA_CODE_UTF16 UTF-16


　以前のバージョンの指定値「RA_CODE_UCS2」は、V2.4 で「RA_CODE_UTF16」に変更しました。UTF-16 は、UCS-2

で表現できる文字に加え、さらに多くの文字が表現可能となっています。従来との互換性のため、「RA_CODE_UCS2」

が指定された場合は「RA_CODE_UTF16」が指定されたものとして動作します。

pInputDataTextName

データソースファイル名文字列ポインタを指定します。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥売上げデータ）以外の場合は、以下の順序でデータソースフ

ァイルを検索します。但し、相対パスでの指定はできません。

①pDataFileInputPath メンバで指定されたディレクトリ







- 95 -

pCustomDataTextName

カスタムデータソースファイル名文字列ポインタを指定します。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥売上げデータ）以外の場合は、以下の順序でカスタムデータ

ソースファイルを検索します。但し、相対パスでの指定はできません。

①pCustomDataFileInputPath メンバで指定されたディレクトリ






hWndOwner

帳票ビューア画面のオーナーウィンドウのハンドルを指定します。NULL 指定時は、オーナーなしの帳票ビューア

画面を作成します。

dwStartPage

帳票ビューア起動直後に表示するページ番号を指定します。指定できる値は 0～65535 までです。0 を指定した場

合は 1 ページ目を表示します。

pEnvironmentFileName

指定されたレポート定義ファイルのプリント情報／パス情報を移入します。他のメンバと同時に指定された場合、

他のメンバ指定が優先されます。





当メンバ指定でレポート定義ファイルから移入される情報は以下の通りです。






・丁合い　※






- 96 -

dwFlag

帳票ビューアの動作モードを指定します。以下のフラグを組み合わせて使用することができます。

フラグ意味

RA_VIEW_NOUSE_REGISTRY 帳票ビューアの各種設定（ウィンドウ位置など）をレジストリに保存しませ

ん。

RA_VIEW_USE_MSGBOX エラー発生時、メッセージボックスを表示します。本フラグの指定がない場

合はエラー発生時に帳票ビューアを終了します。

RA_VIEW_USE_OPEN_MENU 「開く」メニューを表示します。

RA_VIEW_NOUSE_VERSION_MENU 「バージョン情報」メニューを非表示にします。

pTitleName

帳票ビューアのウィンドウタイトル名を指定します。指定できる文字数は半角文字換算で 1～64 文字までです。

NULL 指定時は“RepoAgent 帳票ビューア”をタイトルとして表示します。

pLogFileName

ログファイル名を絶対パス名で指定します。相対パスでの指定はできません。ファイル名のみ場合はカレントディ

レクトリ（ユーザが現在作業しているディレクトリ）に出力されます。また、当メンバに NULL を指定した場合、

環境変数 KRA_LOG_FILE で指定されているファイルに出力します。当メンバを NULL にし、環境変数にも登録されて

いない場合、ログファイルは出力されません。

logSize

ログファイルを出力する場合の最大サイズをバイト数（キロバイト単位）で指定します。指定できる範囲は、1～

2097152（2 ギガバイト）までです。但し、指定サイズを大きくした場合には性能が著しく劣化するため、2048（2

メガバイト）以内とすることを推奨します。サイズの指定を行わない場合、または範囲外の値を指定した場合は、


dwErrCode

関数が異常終了した場合（復帰値＝RA_FALSE）にエラー識別コードを格納します。


ErrorDetail

関数が異常終了した場合（復帰値＝RA_FALSE）にエラー詳細情報を格納します。


dwLogErrCode

ログ出力が異常終了した場合にエラー識別コードを格納します。


LogErrorDetail

ログ出力が異常終了した場合にエラー詳細情報を格納します。



- 97 -

４.３.２使用例

ここでは、C 言語で帳票出力 API を使用して、サンプル帳票の表示を行う方法を例示します。


1) ソースプログラム中では以下の記述でヘッダファイルをインクルードします。

2) プログラムをビルドする場合には、以下のインポートライブラリをリンクします。

3) RepoAgent 帳票出力 API 関数を使用して、プログラムを記述します。ここでは、納品伝票を表示するソース

例を示します。

【補足】 RAAPI.h および raapi.lib は、RepoAgent インストールフォルダ ¥Develop の下に格納されて

います。

【参照】-構造体や関数の詳細は、『RepoAgent　帳票出力ヘルプ』の[帳票出力 API]トピックを参照して

ください。

　　　　-帳票出力 API のエラーメッセージの詳細は、『RepoAgent　帳票出力ヘルプ』の[メッセージ一

覧]トピックを参照してください。


#include "RAAPI.h"

raapi.lib

#include <windows.h>#include "RAAPI.h"

int main(int argc, char* argv[]){ RA_BOOL bRet = RA_FALSE; RA_VIEW_CTLINFO vc;

ZeroMemory( &vc, sizeof(RA_VIEW_CTLINFO) ); /*RA_VIEW_CTLINFO 構造体の初期化 */ vc.dwID = RA_VIEW_CTLINFO_SIG; /*シグネチャの指定（必須） */ vc.pRpdFileName = /*レポート定義ファイル名の指定（必須）*/ "D:¥¥PGM¥¥RepoAgent¥¥Sample¥¥納品伝票.rpd"; vc.pInputDataTextName = /*データソースファイル名の指定 */ "D:¥¥PGM¥¥RepoAgent¥¥Sample¥¥納品伝票.csv";

/* 帳票ビューアの実行 */ bRet = RA_View( &vc );

/* 実行結果判定 */ if( bRet == RA_TRUE ) { /* 正常復帰 */ return 0; } else { /* 異常復帰 */ TCHAR szText[512]; /* エラーコードとエラー詳細情報を表示する */ wsprintf( szText, "実行失敗¥n¥n[%d]¥n%s", vc.dwErrCode, vc.ErrorDetail); MessageBox( NULL, szText, "納品伝票", MB_OK | MB_ICONSTOP ); return -1; }}


- 98 -

４.４帳票出力コントロールでの表示

４.４.１使用方法

ここでは、帳票出力コントロールの使用方法について説明します。

【メソッド】

メソッド名型概要

ReportView BOOL レポート定義の指定に従い、画面に帳票を出力する。

【プロパティ】

プロパティ名型概要

・レポート定義ファイル名

RpdFileName 文字列型レポート定義ファイル名

・入力データ情報

DataCode 整数型文字コード系

InputDataTextName 文字列型データソースファイル名

CustomDataTextName 文字列型カスタムデータソースファイル名

・出力情報

PStartPage 整数型開始ページ

・エラー通知情報

ErrCode 整数型エラーコード

ErrorDetail 文字列型エラー内容文字列

LogErrCode 整数型ログ出力のエラーコード

LogErrorDetail 文字列型ログ出力のエラー内容文字列

・環境情報

Version 文字列型バージョン情報

Mode 整数型動作モード

ImageFileInputPath 文字列型イメージファイル検索パス

DataFileInputPath 文字列型データソースファイル検索パス

CustomDataFileInputPath 文字列型カスタムデータソースファイル検索パス

EnvironmentFileName 文字列型環境情報移入ファイル

LogFileName 文字列型ログ採取ファイル名

LogSize 数値型最大ログ採取量

・オプション情報

hWndOwner 整数型オーナーウィンドウハンドル

UseRegistry BOOL レジストリの使用有無

UseMsgBox BOOL エラー時、メッセージボックスの使用有無

UseOpenMenu BOOL 「開く」メニューの使用有無

UseVersionMenu BOOL 「バージョン情報」メニューの使用有無

TitleName 文字列型ウィンドウタイトル名


- 99 -

◆メソッド

ReportView


RepoAgent.ReportView

《引数》

なし

《復帰値》

正常終了 : 0 以外

異常終了 : 0

《補足》

・当メソッドが異常終了した場合は、異常終了の要因が ErrCode および ErrorDetail プロパティに設定されます。

・ログ出力に失敗した場合は、LogErrCode および LogErrorDetail にエラー情報が設定されます。LogErrCode にエラ

ー情報が設定されていても、ErrCode にエラー情報が設定されていない場合は、表示は正常に行われています（ロ

グ出力のみ異常となっています）。

◆プロパティ

RpdFileName

レポート定義ファイル名を指定します。当プロパティは必ず指定する必要があります。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でファイルを検索し

ます。但し、相対パスでの指定はできません。



DataCode

データの文字コード系（エンコーディング形式）を指定します。当プロパティの指定がない場合は、シフト JIS


ここでの指定と、実際に入力するデータソースの指定が一致していない場合は、動作は不定です。

0 シフト JIS

1 UTF-8

2 UTF-16


　V2.4 で指定値「2」の意味を UCS-2 から UTF-16 に変更しました。UTF-16 は、UCS-2 で表現できる文字に加え、

さらに多くの文字が表現可能となっています。


- 100 -

InputDataTextName

データソースファイル名を指定します。当プロパティの指定がない場合、または""（空文字）指定の場合は、レポ

ート定義の指定に従います。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でデータソースファ


①DataFileInputPath プロパティで指定されたディレクトリ





CustomDataTextName

カスタムデータソースファイル名を指定します。当プロパティの指定がない場合、または""（空文字）指定の場合

は、レポート定義の指定に従います。

ファイルの絶対パスを含めた指定（［例］C:¥Report¥月別売上げ）以外の場合は、以下の順序でカスタムデータソ

ースファイルを検索します。但し、相対パスでの指定はできません。

①CustomDataFileInputPath プロパティで指定されたディレクトリ





PStartPage

帳票ビューア起動直後に表示するページ番号を指定します。指定できる値は 0～65535 までです。0 を指定した場

合、または当プロパティを指定しない場合は先頭ページから出力を開始します。

ErrCode

参照のみのプロパティであり、エラーコードが通知されます。


ErrorDetail

参照のみのプロパティであり、エラー内容を示す文字列が通知されます。


LogErrCode

参照のみのプロパティであり、ログ出力時のエラーコードが通知されます。ログ採取を行った場合のみ有効です。

当プロパティにエラー情報が設定されていても、ErrCode にエラー情報が設定されていない場合は、帳票ビューア

の出力処理は正常に行われています（ログ出力のみ異常となっている）。


LogErrorDetail

参照のみのプロパティであり、ログ出力時のエラー内容を示す文字列が通知されます。


Version

参照のみのプロパティであり、帳票出力コントロールのバージョンを通知します。バージョンが 1.2.3.4 の場合は

"1.2.3.4"の文字列が設定されています。


- 101 -

Mode

動作モードを指定します。

必ず 0 を指定してください。

ImageFileInputPath

イメージファイルを検索するディレクトリパス名を指定します。複数のパスを指定する場合は、セミコロン（;）

で区切って指定します。イメージファイルは、以下の順序で検索されます。

①当プロパティで指定されたディレクトリ





DataFileInputPath

データソースファイルを検索するディレクトリパス名を指定します。複数のパスを指定する場合は、セミコロン（;）

で区切って指定します。データソースファイルの検索順序については、InputDataTextName プロパティの説明を参

照してください。

CustomDataFileInputPath

カスタムデータソースファイルを検索するディレクトリパス名を指定します。複数のパスを指定する場合は、セミ

コロン（;）で区切って指定します。カスタムデータソースファイルの検索順序については、CustomDataTextName

プロパティの説明を参照してください。

EnvironmentFileName

他のレポート定義ファイルから、プリント情報／パス情報を移入する場合に指定します。当プロパティで指定した

レポート定義ファイルのプリント情報／パス情報を移入します。他のプロパティと同時に指定された場合は、他の

プロパティの指定を優先します。





当プロパティの指定がない場合、または""（空文字）指定の場合は、環境移入を行いません。

当プロパティ指定でレポート定義ファイルから移入される情報は以下の通りです。






・丁合い　※





LogFileName

ログファイル名を絶対パスで指定します。パスがない場合はカレントディレクトリ（ユーザが現在作業しているデ

ィレクトリ）にログを出力します。当指定がある場合は、環境変数によるログ採取指定は無効となります。


- 102 -

LogSize

ログファイルの最大サイズをキロバイト単位の値で指定します。指定できる範囲は、1～2097152（2 ギガバイト）

までです。但し、指定サイズを大きくした場合には性能が著しく劣化するため、2048（2 メガバイト）以内とする

ことを推奨します。ログファイル名の指定があり、サイズの指定がない場合、または範囲外の値を指定した場合、


hWndOwner

帳票ビューア画面のオーナーウィンドウのハンドルを指定します。当プロパティを指定しない場合は、オーナーな

しの画面を作成します。

UseRegistry

レジストリ使用の有無を指定します。

True レジストリを使用する。

画面の表示位置、サイズなどを保存／復元します。

False レジストリを使用しない

画面の表示位置、サイズなどを保存／復元しません。

当プロパティを指定しない場合は、レジストリを使用します。

UseMsgBox

エラー時、メッセージボックスの使用の有無を指定します。

True メッセージボックスを使用する。

エラー発生時、メッセージボックスを表示します。

False メッセージボックスを使用しない

エラー発生時、直ちに帳票ビューアを終了します。

当プロパティを指定しない場合は、メッセージボックスを使用しません。

UseOpenMenu

「開く」メニューの使用の有無を指定します。

True 「開く」メニューを使用する。

帳票ビューアのメニューに「開く」が表示されます。

False 「開く」メニューを使用しない

帳票ビューアのメニューに「開く」が表示されません。

当プロパティを指定しない場合は、「開く」メニューを使用しません。

UseVersionMenu

「バージョン情報」メニューの使用の有無を指定します。

True 「バージョン情報」メニューを使用する。

帳票ビューアのメニューに「バージョン情報」が表示されます。

False 「バージョン情報」メニューを使用しない

帳票ビューアのメニューに「バージョン情報」が表示されません。

当プロパティを指定しない場合は、「バージョン情報」メニューを使用します。

TitleName

帳票ビューアのウィンドウタイトル名を指定します。指定できる文字数は半角文字数換算で 1～64 文字までであり、

""（空文字）を指定した場合、または当プロパティを指定しない場合は、“RepoAgent 帳票ビューア”となります。


- 103 -

帳票出力コントロールのバージョン情報画面を表示します。

◆メソッド

AboutBox


RepoAgent.AboutBox

《引数》

なし

《復帰値》

なし

《補足》

なし


- 104 -

４.４.２使用例

ここでは、Visual Basic で帳票出力コントロールを使用して、サンプル帳票の表示を行う方法を例示します。

1) Visual Basic を起動し、プロジェクトを開くか、新規作成します。

2) [プロジェクト]-[コンポーネント]メニューコマンドを選択します。

⇒ [コンポーネント]ダイアログが表示されます。

3) [コンポーネント]-[コントロール]ページで、｢RepoAgent 帳票出力コントロール｣をチェックし、[OK]ボタン

をクリックします。

⇒ ツールボックスに RepoAgent のアイコンが表示されます。

4) ツールボックスの RepoAgent アイコンをクリックし、フォーム上の任意の位置に RepoAgent 帳票出力コン

トロールを配置します。

5) 以下に示すいずれかの方法で、帳票出力コントロールのプロパティを設定します。

・ Visual Basic の[プロパティ]ウィンドウで設定を行う。

・フォーム上に配置した帳票出力コントロールをマウスで右クリックし、表示されるコンテキストメ

ニューの[プロパティ]コマンドを選択することにより表示されるプロパティページで設定を行う。

・ソースプログラムの記述で設定する。

6) RepoAgent 帳票出力コントロールのオブジェクト変数を使用して、メソッドの起動を行うプログラムを記述

します。ここでは、Command1 ボタンがクリックされた場合に納品伝票を表示するソース例を示します。

【参照】-プロパティやメソッドの詳細は、『RepoAgent　帳票出力ヘルプ』の[帳票出力コントロール]ト

ピックを参照してください。

　　　　-帳票出力コントロールのエラーメッセージの詳細は、『RepoAgent　帳票出力ヘルプ』の[メッ

セージ一覧]トピックを参照してください。

Private Sub Command1_Click() Dim ResultMessage As String

'プロパティの設定 With RepoAgent1 .RpdFileName = "D:¥PGM¥RepoAgent¥Sample¥納品伝票.rpd" 'レポート定義ファイル名 .InputDataTextName = "D:¥PGM¥RepoAgent¥Sample¥納品伝票.csv" 'データソースファイル名 ' '必要に応じて、ここにプロパティの設定を記述します ' End With

'帳票ビューアメソッドの実行 RepoAgent1.ReportView

'帳票ビューアメソッドの実行結果判定 If RepoAgent1.ErrCode = 0 Then '実行成功 Else ResultMessage = "実行失敗" + (Chr(13) & Chr(10)) + _ RepoAgent1.ErrorDetail 'エラー詳細メッセージ文 '実行失敗の通知 MsgBox ResultMessage End If

End Sub


- 105 -

４.５帳票出力クラスでの表示

４.５.１使用方法

ここでは、帳票出力クラスを使用した表示方法について説明します。表示を行うには、以下のクラスおよびインタフ

ェースを使います。

パッケージ名クラス名概要

RaReport 帳票の印刷および表示を行うクラスcom.fujitsu.fjh.RepoAgent

RaReportException 帳票の印刷および表示実行時の例外クラス

パッケージ名インタフェース名概要

com.fujitsu.fjh.RepoAgent DataCode データソースエンコーディング形式指定用の定数

◆RaReport クラス

public class RaReport

帳票プロセッサおよび帳票ビューアの機能を呼び出す際に使用するクラスです。表示に関するメソッドの説明を以降

に記します。

《メソッド》

view

public void view( String rpdName ) throws RaReportException

レポート定義の指定に従って、帳票を画面に表示します。

引数：

rpdName：[IN]

レポート定義ファイル名を指定します。






補足：

当メソッドの処理が失敗した場合、または、メソッドの処理は成功しているがログの出力に失敗した場合、

RaReportException 例外が投入されます。RaReportException クラスの説明を参照してください。


- 106 -

setDataCode

void setDataCode( int code )

データソースファイルおよびカスタムデータソースファイルに格納されているデータのエンコーディング形式を

指定します。ここでの指定と、実際に入力するデータソースのエンコーディング形式が一致していない場合、正

しく印刷が行われません｡

引数：

code：[IN]


DataCode.SJIS ：シフト JIS



補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、データの文字コード系をシフト JIS

と仮定して動作します。


　以前のバージョンの指定値「DataCode.UCS2」は、V2.4 で「DataCode.UTF16」に変更しました。UTF-16 は、UCS-2

で表現できる文字に加え、さらに多くの文字が表現可能となっています。従来との互換性のため、「DataCode.UCS2」

が指定された場合は「DataCode.UTF16」が指定されたものとして動作します。

setInputDataTextName

void setInputDataTextName( String name )

データソースファイル名を指定します。

引数：

name：[IN]



絶対パス名指定（［例］C:¥Report¥売上げデータ）以外の場合は、以下の順序でディレクトリを検索します。

但し、相対パス名は指定できません。

①　setDataFileInputPath メソッドで指定されたディレクトリ





補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、レポート定義の指定に従います。


- 107 -

setCustomDataTextName

void setCustomDataTextName( String name )

カスタムデータソースファイル名を指定します。

引数：

name：[IN]



絶対パス名指定（［例］C:¥Report¥表題データ）以外の場合は、以下の順序でディレクトリを検索します。但


①　setCustomDataFileInputPath メソッドで指定されたディレクトリ





補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、レポート定義の指定に従います。

setStartPage

void setStartPage( int page )

帳票ビューア起動直後に表示するページ番号を指定します。

引数：

page：[IN]

指定できる値は 0～65535 までです。0 を指定した場合は 1 ページ目を表示します。

補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、1 ページ目を表示します。

setImageFileInputPath

void setImageFileInputPath( String path )

帳票の表示に使用する画像ファイルを検索するディレクトリパス名を指定します。

引数：

path：[IN]


複数のパスを指定する場合は、セミコロン（;）で区切って指定します。




②　環境変数 KRA_IMAGEFILE_PATH で指定されたディレクトリ





- 108 -

setDataFileInputPath

void setDataFileInputPath( String path )

データソースファイルを検索するディレクトリパス名を指定します。

引数：

path：[IN]










setCustomDataFileInputPath

void setCustomDataFileInputPath( String path )

カスタムデータソースファイルを検索するディレクトリパス名を指定します。

引数：

path：[IN]











- 109 -

setEnvironmentFileName

void setEnvironmentFileName( String name )

プリント情報／パス情報を移入するためのレポート定義ファイル名を指定します。

レポート定義ファイルから移入される情報は以下の通りです。




・印刷部数

・丁合い

・両面印刷



移入された情報よりも、本クラスのメソッドでの指定が優先されることに注意してください。

引数：

name：[IN]


空文字列（""）または null を指定した場合、情報の移入は行われません。





補足：

移入される情報の内、以下の情報は帳票ビューアから印刷する場合に有効になります。

・印刷部数

・丁合い

・両面印刷



setLogFileName

void setLogFileName( String name )

ログファイル名を指定します

引数：

name：[IN]


空文字列（""）または null を指定した場合、環境変数 KRA_LOG_FILE で指定されているファイルに出力します。

但し、環境変数にもファイル名が設定されていない場合、ログファイルは出力されません。

絶対パス名またはファイル名のみを指定します（相対パスでの指定は行えません）。ファイル名のみ指定した

場合、現在位置のディレクトリに出力されます。

補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、環境変数 KRA_LOG_FILE で指定され

ているファイルに出力されます（環境変数にもファイル名が設定されていない場合、ログファイルは出力され

ません）。


- 110 -

setLogFileSize

void setLogFileSize( int size )

ログファイルの最大サイズをバイト数（キロバイト単位）で指定します。

引数：

size：[IN]

指定できる範囲は、1～2097152（2 ギガバイト）までです。サイズ指定を行わない場合、または範囲外の値を

指定した場合は、50 となります。

補足：

指定サイズを大きくした場合には性能が著しく劣化するため、2048(2 メガバイト)以内とすることを推奨しま

す。

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、最大サイズを 50 キロバイトとしま

す。

setUseRegistry

void setUseRegistry( boolean bUse )

帳票ビューアの各種設定（ウィンドウ位置など）をレジストリに保存するか否かを指定します。

引数：

bUse：[IN]

true ：保存する

false ：保存しない

補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、設定をレジストリに保存します。

setUseMsgBox

void setUseMsgBox( boolean bUse )

帳票ビューアでエラー発生時に、メッセージボックスを表示するか否かを指定します。

引数：

bUse：[IN]

true ：表示する

false ：表示しない

補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、メッセージボックスを表示しませ

ん。

setUseOpenMenu

void setUseOpenMenu( boolean bUse )

帳票ビューアで[開く]メニューを表示するか否かを指定します。

引数：

bUse：[IN]



補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、[開く]メニューを表示しません。


- 111 -

setUseVersionMenu

void setUseVersionMenu( boolean bUse )

帳票ビューアで[バージョン情報]メニューを表示するか否かを指定します。

引数：

bUse：[IN]



補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、[バージョン情報]メニューを表示

します。

setTitleName

void setTitleName( String name )

帳票ビューアのウィンドウタイトル名を指定します。

引数：

name：[IN]


指定できる文字数は半角文字換算で 1～64 文字までです。

空文字列（""）または null 指定時は“RepoAgent 帳票ビューア”をタイトルとして表示します。

補足：

view メソッドを呼び出す前に、当メソッドの呼び出しを行わない場合は、“RepoAgent 帳票ビューア”をタイ

トルとして表示します。

◆RaReportException クラス

public class RaReportException extends Exception

エラー発生時の例外情報を保持するクラスです。詳細は、本書『３．５　帳票出力クラスでの印刷』中の

RaReportException クラスの説明をご覧ください。

◆DataCode インタフェース

public interface DataCode

データソースのエンコーディング形式指定時に使用する定数です。詳細は、本書『３．５　帳票出力クラスでの印刷』

中の DataCode インタフェースの説明をご覧ください。


４.５.２使用例

ここでは、帳票出力クラスを使用して、サンプル帳票の表示を行う方法を例示します。


1) ソースプログラム中では以下の記述で本パッケージをインポートします。

2) クラスをコンパイルまたは実行する場合には、javac コマンドまたは java コマンドの-classpath オプションに

以下のパス名を追加指定します。

3) ソースプログラム記述例を以下に示します。

set PATH=%PATH%;RepoAgent インストールフォルダ¥Program


RepoAgent インストールフォルダ¥Program¥rareport.jarRepoAgent インストールフォルダ¥Program¥racom.jar


public class RaReportTest { public static void main(String[] args) { try { RaReport rp = new RaReport(); rp.setInputDataTextName("納品伝票.csv"); rp.view("納品伝票.rpd"); } catch( RaReportException e ) { System.out.println( "scode = " + e.getErrCode() ); System.out.println( "err detail = " + e.getErrDetail() ); System.out.println( "log err code = " + e.getLogErrCode() ); System.out.println( "log err detail = " + e.getLogErrDetail() ); } }}

- 112 -

RepoAgent V2.4.5 ユーザーズマニュアル - Fujitsu › jp › Images ›...

Documents

Transcript of RepoAgent V2.4.5 ユーザーズマニュアル - Fujitsu › jp › Images ›...