JasperReports Server CP User Guide JP

(1)

J ASPER R EPORTS S ERVER

コミュニティ版

ユーザガイド

R ^ELEASE 4.5

http://www.jaspersoft.com

(2)

U.S.A. Jaspersoft の出版物、Jaspersoft のロゴ、Jaspersoft iReport Designer, JasperReports Library, JasperReports Server, JasperSoft OLAP, Jaspersoft ETL は、アメリカ合衆国と各国の Jaspersoft 社の商標または登録商標です。その他のすべての会社名や製品名は、それぞれの所有者の商標名または登録商標です。

Copyright © 2012 Jaspersoft Corporation. All rights reserved. Printed in the U.S.A. Jaspersoft, the Jaspersoft logo, Jaspersoft iReport Designer, JasperReports Library, JasperReports Server, Jaspersoft OLAP, and Jaspersoft ETL are trademarks and/or registered trademarks of Jaspersoft Corporation in the United States and in jurisdictions throughout the world. All other company and product names are or may be trade names or trademarks of their respective owners.

このユーザガイドのバージョンは 0112-JS045-1 です。

This is version 0112-JS045-1 of the JasperReports Server Community Project User Guide.

(3)

第 1 章 JasperReports Server の紹介

JasperReports Server コミュニティ版は、包括的なビジネスインテリジェンス（BI）製品である JasperReports をベースにしており、堅牢かつインタラクティブなレポーティング機能やレポートサーバ機能、データ分析機能を提供します。これらの機能では共通のメタデータが使われており、セキュリティ、リポジトリ、スケジューリングなどの共通サービスが利⽤可能です。また、JasperReports Server は幅広いインターフェースを公開しているため、他のアプリケーションとシームレスに統合したり、カスタマイズ機能を簡単に追加したりすることができます。

The JasperReports Server Community Project builds on JasperReports as a comprehensive family of Business Intelligence (BI) products, providing robust static and interactive reporting, report server, and data analysis capabilities. These capabilities utilize common metadata and provide shared services, such as security, a repository, and scheduling. The server exposes comprehensive public interfaces enabling seamless integration with other applications and the capability to easily add custom functionality.

要約すると、JasperReports Server は以下の機能を提供します。

⼤量のレポートを効率的かつ安全に管理します。

パラメータ⼊⼒やドリルダウンなどの対話的レポート操作を提供します。

電子メールやリポジトリ内のストレージ経由でレポートを配布するようスケジューリングすることができます。 In a nutshell, JasperReports Server provides the ability to:

Efficiently and securely manage many reports.

Interact with reports, including entering parameters and drilling on data.

Schedule reports for distribution via email and storage in the repository BI ユーザの皆様には、サーバ上で動作する Jaspersoft OLAP がお勧めです。

Jaspersoft OLAP の詳細については、別途、専用のユーザガイドがありますのでそちらをご参照下さい。

For business intelligence users, we offer Jaspersoft OLAP, which runs on the server. This component is described in its own user guide.

Jaspersoft 社では、皆様の学習を手助けする情報をいくつか用意しています。

Jaspersoft provides several other sources of information to help extend your knowledge of JasperReports Server: Ultimate Guides は、⾼度な機能やコンフィグレーションに関するドキュメントであり、最良のプラクティスと、⼤量のサンプルが紹介されています。これらのガイドは、PDF 形式でダウンロードできます。

コミュニティ版の利⽤者は、個々のガイドや複数のガイドのドキュメントバンドルパックをJaspersoft online storeで購入できます。商用版をお使いのお客様であれば、サポートポータルサイトから自由にダウンロードすることができます。 Our Ultimate Guides document advanced features and configuration. They also include best practice recommendations and numerous examples. The guides are available as downloadable PDFs. Community project users can purchase individual guides or bundled documentation packs from the Jaspersoft online store. Commercial customers can download them freely from the support portal.

「JasperReports」「iReport」「JasperReports Server」と共に提供されるフリーのサンプルはオンライン上にもあります。サンプルに関する詳細については、「1.7 レポート設計をマスターする」（p.16）をご参照下さい。

Our free samples, which are installed with JasperReports, iReport, and JasperReports Server, are documented online. For more information about the samples, see section 1.7, “Mastering Report Design,” on page 14. 弊社のコミュニティサイトである JasperForge では、オープンソースプロジェクトやそれに関連するソースコード、バグトラッキングのためのツール、バージョンコントロール、そしてディスカッションを⾏うフォーラムを提供しています。そこでは、開発や実装に関するアドバイスや、コミュニティ中心のプロジェクトの安全な開発環境、そしてコミュニティからのフィードバックを得ることができることでしょう。

JasperForge, our community website, hosts open source projects, associated source code, tools for bug tracking, version control, and forums for community discussion. You'll find development and implementation advice, a secure development environment for community-driven projects, and community feedback.

(6)

この章では、以下のテーマについて紹介します。ログインする

リポジトリを閲覧するリポジトリを検索するリポジトリのリソースを使うフォルダを移動する

リポジトリの一覧を並べ替えるレポート設計をマスターする

This chapter contains the following sections:

Logging In

Browsing the Repository

Searching the Repository

Using Repository Resources

Moving Folders

Sorting the Repository List

Mastering Report Design

1.1 ログインする

サーバを通じてアクセスできるデータを保護するために、すべてのユーザはパスワードを用いてログインする必要があります。本節では、サーバにログインする方法について学びます。

なお、本書における各チュートリアルでは、あなたがサンプルデータをサーバにインストール済みであるということを前提にして書かれています。

To protect the data that you can access through the server, all users are required to log in with a password. This section includes a tutorial about logging into the server. The tutorials in this guide assume you’ve installed the sample data provided with the server.

サーバにログインするには：

1. ブラウザで「http://ホスト名:8080/jasperserver」にアクセスして下さい。（「ホスト名」の部分は、JasperReports Server をインストールしたコンピュータ名に置き換えて下さい。）

Jaspersoft ログインページが表示されます。

Enter http://hostname:8080/jasperserver in your browser (where hostname is the name of the computer that hosts JasperReports Server).The Jaspersoft Login page appears.

図 1-1 Jaspersoftログインページ

(7)

2. あなた（もしくはサンプルユーザ）のユーザ ID とパスワードを⼊⼒してログインします。 To log in, enter your user ID and password or a sample user name and password.

サンプルデータをインストールした場合に、サンプルユーザのユーザ ID とパスワードでログインすることができます。詳細については [ログインのお手伝いが必要ですか？] をクリックして下さい。初期状態の管理者ユーザ名とパスワードは「jasperadmin」ですので、インストールの終了後すぐに変更して下さい。

If you installed the sample data, you can log in using sample user names and passwords. For more information, click Need help logging in? The default administrator user name and password is jasperadmin; you should change it after installation

3. 異なるロケール（地域）・タイムゾーン（時刻）を使用したい場合には、「ロケールとタイムゾーンを表示する」をクリックして下さい。「ログイン」パネルに、[ローカル] と [タイムゾーン] の選択欄が表示されます。

If you want to use a different locale and time zone than the server uses, click Show locale & timezone. The Locale and Time Zone controls appear in the Login panel.

4. ドロップダウンメニューで、希望するロケールとタイムゾーンを選択します。 Select your locale and time zone from the drop-down menus.

5. [ログイン] ボタンをクリックします。

⼊⼒したユーザ ID とパスワードが正しければ、サーバにはリポジトリページが表示されます。 Click Login.

If you entered a valid user name and password, the server displays the repository page.

1.2 リポジトリを閲覧する

リポジトリとはサーバ内部にあるストレージであり、レポート、分析ビュー、その他関連ファイルを格納します。リポジトリはツリー構造を持つフォルダで構成され、フォルダには、ファイルシステムのようにたくさんのリソースが含まれます。しかしながら、ファイルシステムとは違って、リポジトリは JasperReports Server だけが直接アクセスできるプライベートなデータベースです。

The repository is the server’s internal storage for reports, analysis views, and related files. The repository is organized as a structure of folders containing resources, much like a file system. However, unlike a file system, the repository is stored as a private database that only JasperReports Server can access directly.

リポジトリを閲覧するには、[表示] > [リポジトリ] を選択します。このリポジトリページから、レポートやテーマ、その他サーバに格納されている各ファイルにアクセスします。

To browse the repository, select View > Repository. From the repository page, you access the reports, themes, and other files stored on the server

図 1-2 はリポジトリページを示しています。ルートディレクトリ（ユーザが管理者である場合に⾒ることができる）には何も

⼊っていません。リソースを⾒つけるには、フォルダパネルの中でフォルダを開いたり折りたたんだりして下さい。

Figure 1-2 shows the Repository page. The root directory, visible to administrative users, is empty. Expand and collapse folders in the Folders panel to find resources.

(8)

図 1-2 リポジトリフォルダパネル

ページトップにある⼊⼒欄にテキストを⼊⼒して、リポジトリを検索することができます。⾒つかったリソースに対しては、アクセス権限があれば操作を⾏うことができます。⼀般的に、管理者またはリソース所有者には、フォルダや他のリポジトリリソースにアクセスできる権限が設定されます。

You can search the repository by entering text in the field at the top of the page. After finding a resource you can perform operations on it, subject to your access permissions. Typically, an administrator or resource owner sets permissions to access folders and other repository resources.

一般ユーザとしてログインすると、[表示] メニューだけが表示されます。

管理者としてログインすると、[表示] メニューに加えて [管理] メニューが表示されます。アイコン、[表示] メニュー、[管理] メニューでは、以下の操作を⾏います。

Logged in as a user, you only see the View menu. Logged in as an administrator, you see the View menu and the Manage menu. The and the View and Manage menus offer these options:

メニュー説明

リポジトリページに戻ります。 Returns to the Repository page.

表示 ·検索結果 ··· フィルタパネルで選択されている抽出条件でフィルタリングしたリソースのリポジトリを表示します。

·リポジトリ ··· レポート、レポート出⼒、データソース、画像などのファイルやリソースを格納したフォルダのリポジトリを表示します。

·レポート ··· レポートリポジトリの一覧を表示します。

·OLAP ビュー ·· 分析ビューリポジトリへアクセスします。権限に従い、分析ビューは、表⽰、実⾏、編集が可能です。このメニューは Jaspersoft OLAP を使⽤しているときのみ利⽤可能です。

·メッセージ ··· システムメッセージの一覧を表示します。エラーやスケジュールレポートなどが含まれます。

·サンプル ··· テーマのデザインを変えるときに使うユーザインターフェース部品のサンプルギャラリーを紹介します。このメニューは管理者だけが利⽤可能です。

Repository – Displays the repository of files and folders containing resources, such as reports, report output, data sources, and images.

Reports – Lists the repository of reports.

(9)

OLAP Views – Accesses the repository of analysis views that you can view, run, and edit, depending on permissions. Only available with Jaspersoft OLAP.

Messages – Lists system messages, such as an error in a scheduled report.

Samples – Presents galleries of UI components that you redesign using Themes. Only available to administrators.

管理このメニューは、管理者としてログインしたときのみ利⽤可能です。 Only available if you’re logged in as an administrator.

·ユーザー ··· ユーザアカウントを追加、削除、有効・無効化、編集でき、ユーザプロパティを表示します。

·役割 ··· 役割プロパティを追加、削除、編集します。

·OLAP 設定 ··· OLAP エンジンのプロパティを設定します。このメニューは Jaspersoft OLAP を使用しているときのみ利⽤可能です。詳細については、「Jaspersoft OLAP User Guide」をご参照下さい。

·ログ設定 ··· サーバログをどれだけ多く記録するかについてログ記録レベルで設定します。このメニューは管理者だけが利⽤可能です。

Users – Adds, deletes, enables, and edits user accounts and displays user properties.

Roles – Adds, deletes, and edits roles and displays role properties.

OLAP Settings – Sets OLAP Engine properties. Only available with Jaspersoft OLAP. For more information, see the Jaspersoft OLAP User Guide

Log Settings – Sets the logging level, which determines how much information the server logs. Only available to administrators

1.3 リポジトリを検索する

権限があれば、リポジトリ全体の検索や、フィルタを使った絞り込み検索を⾏うことができます。フィルタとしては、リソースを変更したユーザ名、リソースの種類、リソースのデータ、スケジュールなどを使⽤できます。

You can search the entire repository, subject to permissions, or narrow the search using filters. Filters restrict a search by name, who changed the resource, type of resource, date of the resource, and schedule.

1.3.1 リポジトリ全体の検索

リポジトリを検索するには、[表示] > [検索結果] を選択します。すると、検索結果ページが表⽰されます。フォルダでただリソースを⾒るだけではなく、誰がいつリソースを修正したかなどの直感的な抽出条件を使って検索を⾏い、ピンポイントでリソースを検出します。

To search the repository, select View > Search Results. The search results page appears. Instead of only viewing resources by folder, use intuitive search criteria, such as who modified the resource and when, to find pinpoint resources.

検索結果ページでは、フィルタパネルまたは検索欄を使ってリソースを探し、検索またはフィルタリングの結果を表示します。 On the search results page, use either the Filters panel or Search field to find resources. The search results page displays results of searches and filters.

(10)

図 1-3 検索結果ページ

リポジトリ内のすべてのリソースを検索するには：

1. フィルタパネルで、[すべて利⽤可能]、[私が変更]、[私が参照] フィルタのいずれか一つを選択します。 2. 検索欄の中のアイコンをクリックすると、検索欄がクリアされます。

3. 図 1-3 に示されているとおり、[すべてのタイプ] を選択します。 4. をクリックします。

検索結果として、あなたが閲覧する権限を持つファイルがリストアップされます。リソースを⾒たい場合にはリスト中のリソースをクリックし、どんな機能が利⽤可能か確認する場合には右クリックしてコンテクストメニューの内容を確認します。 To search all resources in the repository:

1. Select one of these filters: All available, Modified by me, or Viewed by me. 2. Click the icon in the search field to clear the search term if there is one. 3. Select All types, as shown in Figure 1-3.

4. Click .

The search results appear, listing files that your user account has permission to view. Click a resource in the list to view it or right-click a resource to see what functions are available from the context menu.

サーバはあなたの検索結果を記憶するので、次に検索結果ページに戻ってきたときには、よく必要とするリソースが表⽰されたままになっています。

The server remembers your settings on the Search Results page, making the most commonly needed resources remain visible when you return to the page.

1.3.2 フィルタリングによる検索

任意のサーバページの上部で検索単語を⼊⼒してをクリックした場合には、サーバはフィルタを使いません。この場合の検索は、以下のような規定の設定で⾏われます。

サブフォルダを検索対象に含めます。

ユーザが閲覧可能な最上位のフォルダから検索を開始します。

レポート、レポート出⼒、OLAP ビュー、その他のリソースを検索します。名前によりアルファベット順に並べます。

If you enter a search term and click at the top of any server page, the server doesn’t use filters. The search uses these default settings:

Include subfolders

Start at the top-most folder visible to the user

Search for reports, report outputs, OLAP views, or other resources

Sort alphabetically by name

(11)

[表示] > [検索結果] をクリックして検索結果ページのをクリックした場合、サーバはフィルタパネルに設定されているフィルタを使用します。

If you click View > Search Results and click on the search results page, the server uses the filters you set in the Filters panel.

図 1-4 は、フィルタを「すべて利⽤可能」「すべてのタイプ」に設定して “account” という単語で検索した結果を示しています。

Figure 1-4 shows the results of a search for the term “account” using the filters All available and All types.

図 1-4 検索欄と検索結果

検索欄に⼊⼒した単語は、⾃動的には消去されません。検索単語を消去したい場合には、検索欄の中のアイコンをクリックして下さい。

The search term you enter in the search field isn’t cleared automatically. To clear the search term, click the icon in the search field.

フィルタを使えば、より洗練された検索が可能です。例えばあなたが最後に⾒たレポートを探すことも簡単に⾏えます。フィルタはそれぞれ、独⽴して設定することができます。フィルタの種類は以下の通りです。

ユーザフィルタリソースフィルタアクセスタイムフィルタ

スケジュール済みレポートフィルタ

You refine a search using filters. For example, filters can help you find your most recently viewed reports. You can set each filter independently of the others. You can set the following types of filters:

^User

^Resource

Access time

Scheduled report

(12)

ユーザフィルタには以下の項目があります。 The user filter has the following settings:

フィルタの選択項目説明

「すべて利⽤可能」（規定値） All Available (default)

すべてのリソースを表示します。 All resources.

「私が変更」 Modified by me

現在ログインしているユーザが最後に修正したリソースだけを表示します。 Selects only resources that were last modified by the user who’s logged in.

「私が参照」 Viewed by me

現在ログインしているユーザが実⾏して表⽰したリソースだけを表示します。このフィルタは、実際に表示されたリソースだけでなく、レポート内部に含まれている（可視化されていない）画像などのリソースにも適用されます。

Selects only resources that were run and viewed by the user who’s logged in. This filter not only applies to visualization types, but also to resources that are included in reports such as images.

リソースフィルタには以下の項目があります。 The resource type filter has the following settings:

「すべてのタイプ」（規定値） All types (default)

「レポート」 Reports

レポートだけを表示します。 Displays only reports.

「レポート出⼒」 Report outputs

スケジューリングされている、またはバックグラウンドで実⾏されているレポートからの出⼒だけを表⽰します。レポート出⼒は、HTML や PDF などの任意の拡張型をサポートします。

Displays only the output from reports that were scheduled or run in the background. Report output can be any of the supported export types, such as HTML and PDF.

「OLAP ビュー」 OLAP views

分析ビューだけを表示します。Jaspersoft OLAP が利⽤可能である必要があります。 Displays only analysis views (if you implement Jaspersoft OLAP).

「データソース」 Data sources

データソースだけを表示します。 Displays only data sources.

アクセス時刻フィルタには以下の項目があります。「任意の時刻」は、ユーザの設定しているタイムゾーンに従います。 The access time filter has the following settings. All times are relative to the user’s effective timezone:

「任意の時刻」（規定値） Any time (default)

「今日」 Today

本日閲覧または修正されたリソースを表示します。

Resources viewed or modified since the previous midnight.

「昨日」 Yesterday

前日閲覧または修正されたリソースを表示します。

Resources viewed or modified during the previous day ending at midnight.

「過去の週」 Past week

過去 7 日間（本日含む）に閲覧または修正されたリソースを表示します。 Resources viewed or modified during the past 7 days, including today.

(13)

「過去の月」 Past month

過去 30 日間（本日含む）に閲覧または修正されたリソースを表示します。 Resources viewed or modified during the past 30 days, including today. スケジュール済みレポートフィルタには以下の項目があります。

The scheduled report filter has the following settings:

「任意のスケジュール」（規定値） Any schedule (default)

「スケジュール済み」 Scheduled

スケジュール登録されたジョブを持っているレポートだけを表示します。 Only reports that have scheduled jobs.

「私がスケジュール」 Scheduled by me

現在ログインしているユーザがスケジュール登録したジョブを持っているレポートだけを表示します。

Only reports that have jobs scheduled by the currently logged in user.

「未スケジュール」 Not scheduled

スケジュール登録されたジョブを持っていないすべてのリソースを表示します。 Only reports that don't’ have scheduled jobs and all other resource types. リソースの検索には、以下の制約があることを覚えておいて下さい。

単語は断片化して下さい。

リソースの表⽰名または表⽰名の⼀部が検索できます。リソースの説明⽂に関する単語または断⽚が検索できます。複数の単語を使って検索できます。

フォルダ名は検索できません。

字句や字句間の記号に引⽤符を付けないで下さい。検索単語に、⼤⽂字・⼩⽂字の区別はありません。

Remember these do’s and don’ts when searching for resources:

Do use word fragments.

Do search for the display name or part of the display name of a resource.

Do search for words or fragments in the description of a resource.

Do use multiple words.

Don’t search for folder names.

Don’t enter quotes around terms or symbols between terms.

Don’t worry about using upper- or lower-case letters in search terms.

1.4 リポジトリのリソースを使う

リポジトリから検索したリソースに対して、以下の操作を⾏うことができます。

After finding a resource in the repository, naturally you want to do something with it. Options are: レポート名をクリックすると、レポートを実⾏して表⽰します。

Click the name of a report to run and view it.

リソース名を右クリックするとコンテクストメニューが表示され、その他の操作（「編集」など）を⾏うことができます。表示されるメニュー項目は、アクセス権限によって変わります。

Right-click the name of a resource to access other operations on the context menu, for example Edit. The menu items that you see depend on your access permissions.

リソース名以外の⾏のどこかをクリックすると、そのリソースを選択します。

Ctrl キーを押しながら⾏のどこかをクリックすると、複数のリソースを選択することができます。

コンテクストメニュー、または結果リストの上にあるボタンを使って、選択した任意個のリソースに対して、「実⾏」「編

(14)

集」「開く」「コピー」「切り取り」（移動）、「削除」といった操作が⾏えます。

もしボタンが利⽤不可であれば、そのリソースはその操作をサポートしていないか、またはあなたにその操作を⾏う権限がないことを意味します。リソース内のフォルダや関連ファイル（画像など）にアクセスする際にも権限が必要になることがあります。例えば、レポートをスケジュール登録する際には、サーバがレポート出⼒を保存するフォルダの「読み取り＋書き込み＋削除」権限が必要になります。

Click anywhere in the row except the resource name to select a resource. Ctrl-click anywhere in the rows to select multiple resources. Use the context menu or buttons above the results list: Run, Edit, Open, Copy, Cut (move), or Delete. If the button is unavailable, the resource doesn’t support the operation or you don’t have permission to do this operation. You might also need permission to access the folder or dependent file, such as an image, of a resource. For example, to schedule a report, you need to have read/write/delete permission on the folder where server saves the report output.

レポートをスケジュールに登録すると、リポジトリのそばにアイコンが現れます。をクリックすると、そのレポートの持つスケジュール登録済みジョブの一覧が表示されます。詳細については、「2.3 レポートをスケジューリングする」（p.21）を参照して下さい。

After scheduling a report, the icon appears beside it in the repository. Click to view the list of jobs scheduled for the report. For more information, see section 2.3, “Scheduling Reports,” on page 19

1.5 フォルダを移動する

フォルダとリソースに対する「読み取り」権限を持っている場合、それらに対してコピーまたは切り取りを⾏い、「書き込み」権限を持つ別のフォルダに貼り付けることができます。サーバは、コピーまたは切り取られたフォルダ内のすべてのコンテンツを、新しいフォルダに貼り付けます。

貼り付けメニューを使う代わりに、ドラッグアンドドロップを使うこともできます。複数のフォルダを⼀度に移動することができます。バッチを使って別のリソースを移動することもできます。

If you have read permission on folders and resources, you can copy and cut them from one folder and paste them to another if you have write permission on the destination folder. The server pastes all contents of the folder that you copy or cut into the new location.

You can drag-and-drop the objects instead of using the paste menu item. Move folders one at a time. You can move other resources in batches.

移動されたオブジェクトは移動先フォルダの権限を継承し、移動する前に権限を失います。オブジェクトの権限を変更するには、明⽰的に権限を設定して下さい。

Relocated objects inherit permissions from the destination folder, losing the permissions in place prior to the move. To change permissions on an object, set the permissions explicitly.

カット＆ペーストでフォルダとリソースを移動するには： 1. 以下の権限を持つユーザでログインします。

移動するフォルダやリソースに対する「読み取り」権限移動先フォルダに対する「書き込み」権限

例として、joeuser でログインします。（パスワードも joeuser です。） 2. [表示] > [リポジトリ] をクリックします。

3. フォルダパネルに存在する「Reports」フォルダをクリックして開き、中にある「Samples」フォルダを右クリックし、表示されるコンテクストメニューから [フォルダの追加] を選択します。

4. フォルダの追加ダイアログが表示されたら、”Financial Reports” という名前を⼊⼒し、[追加] ボタンをクリックします。 Financial Reports フォルダが Samples フォルダのサブフォルダとして現れ、親フォルダ（Samples）に対する joeuser ユーザの規定の権限（読み取り＋書き込み＋削除）が継承されます。

(15)

図 1-5 Financial Reports フォルダが新規作成された 5. Financial Reports フォルダを、ひとつ上のより適した場所に移動します。

a. フォルダパネルの「Financial Reports」フォルダを右クリックし、[切り取り] を選択します。 b. 「Reports」フォルダを右クリックし、[貼り付け] を選択します。

すると、「Financial Reports」フォルダが、「Reports」フォルダの中の「Samples」フォルダと同じ階層に現れます。権限があればフォルダの場所をリポジトリ内の任意の場所に変えることができますが、ひとつだけ例外があります。フォルダを同じ場所へコピーまたは貼り付けすることはできません。移動先フォルダで右クリックし、コンテクストメニューを表示したときに、もし [貼り付け] コマンドが無効な状態であったなら、そのフォルダへの「書き込み」権限がないことを意味しています。

You can relocate a folder, subject to permissions, anywhere in the repository with one exception: The server doesn’t support copying and pasting a folder to the same location. If the Paste command is disabled when you right-click a destination folder, you don’t have write permission on the folder. 1. Log into the server as a user who has these permissions:

Read permission on the folder or resource to move

Write permission on the destination folder

For example, log in as joeuser (use the password, joeuser). 2. Click View > Repository.

3. In the Folders panel, right-click Reports > Samples, and select Add Folder. 4. In the Add Folder dialog, enter a name, such as Financial Reports, and click Add.

The Financial Reports folder appears as a subfolder of Samples and inherits Joe User’s default permissions (read-write-delete) on the parent folder.

5. The Financial Reports folder deserves a more prominent location. Move it up one level: a. In Folders, right-click Financial Reports, and select Cut.

b. Right-click Reports, and select Paste.

The Financial Reports folder now appears in Reports at the same level as Samples.

1.6 リポジトリの一覧を並べ替える

レポートなどのリソースの一覧を並び方を変えるには、「ソート基準」項目を変更します。

[名前] をクリックすると、アルファベット順にソートします（A が先頭です）。これがデフォルトの並び方です。 [変更⽇] をクリックすると、最終更新⽇時順にソートします（最近のものが先頭です）。

To change the order of the list of reports and other resources, use the Sort By controls:

Click Name to sort alphabetically (A at the top). This is the default sort order.

Click Modified Date to sort by the latest modified time and date (most recent at the top)

(16)

1.7 レポート設計をマスターする

JasperReports オープンソースライブラリは、サーバのレポーティングエンジンです。標準の設定でサーバをインストールした場合、iReport と、幅広い JasperReports フリーサンプルもインストールされます。レポート設計をマスターする、または海図の作成といったようなひとつの領域について少し学習するには、これらのサンプルが有益です。

JasperReports open source library drives the reporting engine of the server. The default server installation includes iReport and an extensive set of free JasperReports samples. To master report design or to learn a little about one area, such as charting, take advantage of these samples

1.7.1 JasperReports のサンプルの場所

サンプルファイルは、サーバの「<js-install>\ireport\demo\samples」に存在しています。図 1-6 は、これらのサンプルファイルの場所を示しています。

Figure 1-6 shows the location of these sample files in <js-install>\ireport\demo\samples after installing the server..

<js-install>には、JasperReports Server がインストールされているルートフォルダのパスが入ります。

<js-install> is the root directory where JasperReports Server is installed.

図 1-6 Jasper Reports Server にインストールされた JasperReports サンプル

1.7.2 サンプルについて学ぶ

サンプルに関するドキュメントは、オンライン上にあります。 JasperReports Samples Overview

JasperReports Samples Reference

iReport ならびに JasperReports Server に関するさらなるドキュメントが欲しいなら、我々のコミュニティ Web サイトにある Docs リンクをクリックして下さい。

The samples are documented online:

JasperReports Samples Overview

JasperReports Samples Reference

Click the Docs link on our community website to find more documentation about iReport and JasperReports Server.

(17)

第 2 章レポートを実⾏する

JasperReports Server は、簡単にレポートを実⾏できます。リポジトリからレポートを探し出し、単にその名前をクリックして下さい。レポートが⼊⼒コントロールを持っている場合は、ひとつ以上のデータセットを⽤いてレポートを実⾏します。レポートスケジューラを使うと、業務時間外やその他の時間に、オペレータ不在でレポートを繰り返して実⾏することができます。この章では、以下のテーマについて紹介します。

簡単なレポートを実⾏する

⼊⼒コントロールまたはフィルタを使ってレポートを実⾏するレポートをスケジューリングする

イベントメッセージ

JasperReports Server makes it easy to run reports. Find a report in the repository, and simply click its name. If the report has input controls, you run the report with one set of data and then another. Using the report scheduler, you can run reports repeatedly and unattended during off hours or at other times. This chapter contains the following sections:

Running a Simple Report

Running a Report with Input Controls or Filters

Scheduling Reports

Event Messages

2.1 簡単なレポートを実⾏する

この節では、表形式のアカウントリストレポートの実⾏⽅法について説明します。 This section describes how to run a tabular report that lists accounts.

レポートを実⾏するには：

1. 管理者（jasperadmin など）としてサーバにログインします。 Log into the server as an administrator, such as jasperadmin. 2. [表示] > [検索結果] をクリックします。

Click View > Search Results.

3. フィルタパネルで、[レポート] をクリックします。

検索結果に、現在のユーザが閲覧可能なレポート一覧が表示されます。 In Filters, click Reports.

The search results appear, listing reports that your user account has permission to view.

図 2-1 検索結果⼀覧

スクロールバーを使えば、レポート⼀覧の全体を⾒ることができます。また、適切な権限があれば、他のユーザのレポートも⾒ることができます。

(18)

Use the scroll bar to view the entire list of reports. You can view other users’ reports if you have proper permissions.

4. レポート「Account Report」の名前をクリックしてレポートを実⾏して下さい。または、レポート⾏のどこかで右クリックしてコンテクストメニューを表示し、[実⾏] を選択して下さい。アカウントと連絡先を含んだレポートが表示されます。 Click the name, Accounts Report, to run the report. Or, right-click anywhere in the report row and select Run from the context menu. The report appears, containing accounts and contact information.

図 2-2 Accounts Report の出⼒

2.2 ⼊⼒コントロールまたはフィルタを使ってレポートを実⾏する

⼊⼒コントロールを使ってレポートを実⾏すると、レポート出⼒のデータをフィルタリングすることができます。完璧な⼊⼒コントロールは、あなたが⾒たいデータだけに絞り込んでくれる ―― ただそれだけです。

The server filters the data in the report output when you run a report with an input control. The perfect input control limits the data to what you want to see—and nothing more.

2.2.1 単一⼊⼒コントロール

Freight Report サンプルには、３つの⼊⼒コントロールがあります。国（Country）

希望日（Request Date）注文 ID（OrderID）

The Freight Report example has three input controls:

^Country

Request Date

^{Order ID}

レポートが⼊⼒コントロールを持っている場合は、ひとつ以上のデータセットを⽤いてレポートを実⾏します。 Using input controls, you run the report with one set of data and then another.

単⼀⼊⼒コントロールを持つレポートを実⾏するには：

1. 検索欄に freight と⼊⼒し、をクリックします。すると、リポジトリパネルに検索結果が表⽰されます。 In the search field, enter freight and click .

2. 検索結果の⼀覧に表⽰されている「Freight Report」の名前をクリックします。

このレポートは、1997 年 6 月 1 ⽇以降にメキシコに運送された、10600 個以上もの注文データを表示します。 In the list of search results, click the name, Freight Report.

The report shows data about orders numbered 10600 and above, shipped to Mexico after June 1, 1997.

(19)

図 2-3 メキシコのデータを示す Freight Report

3. 他の⼊⼒オプションでレポートを実⾏させるには、[オプション] をクリックして⼊⼒コントロールダイアログを表⽰させます。

To run the report with other input option values, click Options. The Input Controls dialog appears.

図 2-4 規定の⼊⼒コントロール

4. 「Country」欄で「USA」を選択し、[OK] ボタンをクリックします。 Select USA in the Country field and click OK.

[適用] ボタンをクリックすると、⼊⼒コントロールダイアログを開いたまま、新しいデータでレポートを表⽰することができます。

The Apply button refreshes the report with the new data, but keeps the Input Controls dialog open. 5. ⼊⼒コントロールダイアログの [OK] ボタンをクリックします。

すると、メキシコではなく USA のデータがレポートに表示されます。 In Input Controls, click OK

The report shows data for the USA instead of Mexico.

(20)

図 2-5 USA のデータを示す Freight Report

2.2.2 段階⼊⼒コントロール

段階⼊⼒コントロールを使うと、膨⼤な数に及ぶ選択肢を削減することができます。段階⼊⼒コントロールにおいて１つの値を選択すると、その値に従って他の選択肢が絞り込まれます。例えば、「国」「州」「区」という選択肢がある場合、ある「国」を選択すれば、「州」と「区」の選択肢は、その選択された国のものだけに絞り込まれます。詳細については、「3.4 段階入⼒コントロールをレポートに追加する」（p.68）を参照して下さい。

Cascading input controls in a report reduce a large number of choices to a manageable number. A single value chosen for a cascading input control determines which other values appear as choices for input. For example, the choice of a country determines which states or regions are listed as choices. For more information, see section 3.4, “Adding Cascading Input Controls to a Report,” on page 54.

段階⼊⼒コントロールを持つレポートを実⾏するには：

1. 任意の JasperReports Server ページの上部にある検索欄に cascading と⼊⼒し、をクリックします。リポジトリパネルに検索結果が表⽰されます。

In the Search field at the top of any JasperReports Server page, enter cascading and click . The search results are displayed in the repository.

2. 検索結果の⼀覧に表⽰されている「Cascading multi select example report」の名前をクリックします。すると、レポートが実⾏される前に、パラメータを⼊⼒するための⼊⼒コントロールダイアログが表示されます。 In the list of search results, click the name Cascading multi select example report.

Instead of running the report, you’re prompted to enter new values.

3. [Country multi select] ドロップダウンで、異なる国、例えばメキシコ（Mexico）を選択します。

すると、⼊⼒コントロールダイアログにあるその他のドロップダウンは、⾃動的にメキシコのデータに更新されます。 In the Country multi select drop-down, select a different country, for example Mexico.

The other drop-downs in the Input Controls dialog are automatically updated with Mexican data.

段階⼊⼒コントロールは、データベースにアクセスして新しい値を取り出すクエリとして実装されています。クエリが実⾏されている間、サーバはアクティビティモニタを表⽰します。クエリの実⾏時間が⻑い場合には、 [キャンセル] ボタンをクリックして別の値を選択することができます。

Cascading input controls are implemented as queries that access the database to retrieve the new values. The server displays an activity monitor while the query is running, and in the case of long queries, you can click Cancel and select different values.

4. [Cascading multi select] ドロップダウンで、別の値、例としてゲレロ（Guerrero）を選択します。

すると、[Cascading name single select] ドロップダウンはゲレロ州に存在するアカウントのリストに更新されます。 In the Cascading state multi select control drop-down, select a different state, for example Guerrero.

The Cascading name single select drop-down is updated to list accounts in Guerrero.

(21)

図 2-6 段階⼊⼒コントロール

country と state は複数選択できるようにレポート設計されていますので、Ctrl キーを押しながらクリックすることで、複数の値を選択することができます。

The report design defines country and state input controls as multi-select; users can Ctrl-click to select multiple values in this list.

5. [OK] ボタンをクリックし、選択した値でレポートを実⾏します。

レポートは、選択された「州」（state）のすべてのアカウント名のリストを作成し、「Cascading name single select」欄で選択されたアカウント名の配送リストを表示します。

Click OK to run the report with the chosen values.

The report creates a list of all account names in the chosen states. The report lists the account name chosen in the Cascading name single select input control at the top.

2.3 レポートをスケジューリングする

レポートスケジュールウィザードを使うと、ジョブ、レポートパラメータ、出⼒オプションを設定することができます。ジョブの設定··· ジョブの名前、実⾏時刻、実⾏頻度。

レポートパラメータ ··· レポートが⼊⼒コントロールを使うよう設計されていれば、ジョブはそのパラメータを使います。出⼒オプション··· 出⼒を格納する場所、フォーマット、地域情報、出⼒を添付する電⼦メールオプション。 Using the report scheduler wizard, you set up a job, report parameters, and output options:

Set up a job – A job name, when to run the job, and how often

Š Report parameters – If the report was designed with input controls, which parameters the job will use

Š Output options – Where to store the output, in which formats, the locale, and email options for sending the output as an attachment

バックグラウンドでレポートを実⾏するようにジョブをスケジューリングすれば、レポートが実⾏されている間にもサーバを試用することができます。

Jobs that you schedule run the reports in the background so you can use the server while the report runs.

ジョブをスケジューリングするユーザの権限によって、レポートで公開されるデータが限定されます。例えば、Gloria という⼥性は Southeast US 地域の目録データだけにアクセスできるものとします。このとき、彼⼥のスケジューリングしたレポートはその地域のデータだけを表示します。これは、そのレポートを他の地域のユーザが閲覧した時でさえも同じです。他の地域のユー

(22)

ザが⾃分の地域のデータを⾒たいのであれば、そのレポートを⾃分でスケジューリングする必要があります。

The permissions of the user who schedules a job determine the data that the report exposes. For example, Gloria only has access to inventory data from the Southeast US region. A report that she schedules only shows data from that region, even when the report is viewed by users in other regions. Other users schedule the report themselves to see the data for their own regions.

機密を要するデータであっても、制限のないデータを使って、管理権限を持つユーザがジョブをスケジュールすれば、権限のないユーザに公開することができます。これは、レポートは必要なすべてのデータをデータソースに持っているためです。アクセス制限にかかわらず、任意のユーザは、受け取ったレポートですべてのデータを⾒ることができます。

Sensitive data could be exposed to unauthorized users if you schedule a job as an administrative user with no data restrictions because the report will contain all requested data in the data source. Any user who receives the report can view all the data regardless of the user’s access restrictions.

2.3.1 ジョブの設定

ジョブを設定するには：

1. [表示] > [レポート] をクリックします。 Click View > Reports.

2. 検索欄を使って、またはレポートのリストを眺めて、スケジューリングしたいレポートを⾒つけます。 Use the search field or browse the list of reports to find the report you want to schedule.

既にスケジューリングされているレポートを追加・修正・削除したいのであれば、レポート名の横にあるをクリックして下さい。

If the report already has a schedule that you want to add, modify, or delete, click beside the report name.

3. レポート名を右クリックし、コンテクストメニューから [スケジュール...] を選択します。図 2-9 に示されるような、「スケジュールされているジョブ」ページが表示されます。 Right-click the report and select Schedule from the context menu.

The Scheduled Jobs page appears, as shown in Figure 2-9 on page 23. 4. [ジョブのスケジュール] ボタンをクリックします。

スケジューラウィザードの「ジョブをセットアップ」ページが表示されます。 Click Schedule Job.

The Set Up the Job page of the Scheduler wizard appears.

5. 「ジョブ名」欄にジョブの名前を記入します。ここでは「Weekly Report」という名前にします。「説明」欄は⼊⼒必須ではありません。

In the Job Name field, enter a name for the job, for example, Weekly Report. The description is optional. 6. 以下のスケジュール属性を設定します。

「開始ジョブ」 ··· すぐに開始するか、後で開始するかを設定します。をクリックすると、カレンダーから開始日と開始時刻を設定できます。

「繰り返し」属性を設定していない（「なし」を選択している）場合、レポートは、指定した開始日時に実⾏されます。週次レポートを毎週実⾏したい場合などには、「繰り返し」属性を設定して下さい。

「タイムゾーン」 ··· スケジュールのタイムゾーンを指定します。規定のタイムゾーンは、サーバにログインしたときのサーバのタイムゾーンです。異なるタイムゾーンに切り替える場合は、ここで設定して下さい。

「繰り返し」 ··· 以下の項目から選択します。

「なし」 ··· レポートは⼀度だけ実⾏されます。

「単純」 ··· ジョブを、時間・日・週単位の間隔で繰り返すようスケジューリングします。

「カレンダー」··· ジョブを、任意の月・任意の曜日に繰り返すようスケジューリングします。図 2-7 は、即座に実⾏し、繰り返さないように設定されたジョブを⽰しています。

(23)

図 2-7 ジョブのセットアップページ

Set these schedule attributes:

Start – Immediately or in the future. Click to set a future start date and time. If you don’t specify recurrence, the start date and time determines when the report runs. If you specify recurrence, you may still want to delay the first report date, for example a weekday report that you want to start next week.

Time Zone – Specify the time zone for the schedule. The default time zone is the time zone of the server, the time zone you entered at log in. If you’re in a different time zone, set this field accordingly.

Recurrence – Choose one of these settings:

None – Run the report once.

Simple – Schedule the job to recur at an hourly, daily, or weekly interval.

Calendar – Schedule the job to recur on days of the week or days of the month. Figure 2-7 shows a job set to run immediately, no recurrence

7. 指定した時刻にジョブを開始するようにスケジューリングします。 a. 「開始ジョブ」欄の「開始日」を選択します。

b. をクリックします。

すると、カレンダーが表示されます。 c. 希望する日をクリックします。

d. 開始時刻を変更するには、カレンダーの底部にある「時刻」欄の時と分を表す数字をクリック（または Shift キーを押しながらクリック）します。カレンダーを閉じるには、スケジューラページの何もないところをクリックします。選択されたジョブ開始日時が、カレンダー項目に表示されます。

e. 「繰り返し」欄を変更していなければ、レポートは⼀回だけ実⾏されます。

「繰り返し」欄で「単純」または「カレンダ－」を選択した場合、追加の⼊⼒項目が現れます。詳細については、「2.3.6 ジョブを繰り返し実⾏する」（p.28）を参照して下さい。

If you select Simple or Calendar Recurrence, additional controls appear on the page. For more information, see section 2.3.6, “Running a Job Repeatedly,” on page 24.

Schedule the job to start at a specific time: a. In Start Job, select On.

b. Click .

The calendar appears. c. Click a date.

d. To set the time for the job to run, at the bottom of the calendar, repeatedly click the hours and minutes. To close the calendar, click a blank spot on the Scheduler page.

The selected date for starting the job appears in the calendar field.

(24)

e. In Recurrence, accept the default setting, None to run the report only once. 8. [次へ] ボタンをクリックします。

スケジューリングしようとしているレポートがユーザに⼊⼒を促す⼊⼒コントロールを持っている場合は、「パラメータ値を設定」ページが表示されます。

Click Next.

If the report you’re scheduling has input controls that prompt for user input, the Set the Parameter Values page appears

9. [次へ] ボタンをクリックします。

「出⼒設定」ページが表⽰されます。（図 2-8）参照） Click Next.

The Output Settings page appears, as shown in Figure 2-8 on page 22.

10. 次節で説明するように出⼒オプションを設定し、[送信] をクリックすればジョブがスケジュールされます。 Set output options, as described in the next section, and click Submit to schedule the job.

2.3.2 出⼒オプションの設定

「出⼒設定」ページでは、以下の設定を変更することができます。 On the Output Details page, you can change these settings:

「ベース出⼒ファイル名」··リポジトリ内に出⼒されるファイルの名前です。

Base Output File Name – The name of the file as it appears in the repository.

「出⼒の説明」··· ファイルの説明です。リポジトリ内でユーザに表⽰されます。⼊⼒必須ではありません。 Output Description – The optional description of the file that appears to users who view the repository.

「出⼒フォーマット」·· 利⽤可能な出⼒フォーマットです。どれか１つを選択するか、あるいは規定の PDF のままにします。1 つ以上のフォーマットを選択すると、それぞれのフォーマットはリポジトリ内で別々のファイルとして格納され、電子メール通知の歳にも別々のファイルとして添付されます。 Output Format – The available output formats. Select one, or accept the default format, PDF. When you select more than one, each format is stored as a separate file in the repository and attached as a separate file to the email notification.

「出⼒ロケール」··· レポートを生成するロケールを指定します。

Output Locale – The locale settings for generating the report.

「宛先」··· １つ以上の電⼦メールアドレスを、カンマで区切って記⼊します。メール通知に使われます。 To – One or more email addresses separated by commas for sending email notification. デフォルトでは、JasperReports Server のインストールではメールサーバを導⼊しません。管理者は、通知メールが送信できるようにサーバを設定しておく必要があります。「JaspterReports Server インストールガイド」を参照して下さい。

By default, no mail server is configured in a JasperReports Server installation. The administrator must configure the server to send notifications, as described in the JasperReports Server Installation Guide.

「件名」··· 通知メールのタイトルです。

Subject – The subject line of the notification email.

「メッセージ」··· 通知メールの本文です。

Message – Content of the notification email.

「添付ファイル」 ··· このチェックボックスにチェックを⼊れると、レポート出⼒がメール通知にて送信されます。 Attach Files – A check box option that, if checked, sends the output of the report with the email notification.

機密データを含んだレポートをメールで送信する場合には注意が必要です。 Be careful when sending reports containing sensitive data by email.

「空のレポートをスキップ」···このチェックボックスにチェックを⼊れると、レポートの実⾏に失敗した時などにできる空のレポート出⼒ファイルをメール通知で送ってしまうことを避けられます。

Skip Empty Reports – A check box option that, if checked, prevents the server from attaching empty report output files to email notification when report execution fails.

(25)

「出⼒先」··· レポート出⼒を保存するフォルダです。この欄は⼊⼒必須であり、そしてあなたにこのフォルダの「書き込み」権限がなければなりません。

Output Location – The folder for saving the report output. This field is required and you must have write permission to the folder.

「シーケンシャルファイル名」··· 出⼒ファイルの名前の末尾にタイムスタンプを追加します。繰り返し実⾏するジョブの出⼒や、出⼒の⽇付・時刻が重要視されるレポートに対して使⽤すると便利です。出⼒ファイル名は、

<ベース出力ファイル名>-<タイムスタンプ>.<拡張子> となります。

Sequential File Names – A timestamp added as a suffix to output files. Useful for the output of recurring jobs or for time-sensitive reports where the output must be dated. When the timestamp is used, the output filename is

<basename>-<timstamp>.<extension>.

「タイムスタンプのパターン」··· タイムスタンプの形式です。Java.text.SimpleDateFormat がベースとなります。入

⼒必須ではありません。タイムスタンプ⽂字列には、英⽂字、数字、ダッシュ（ハイフン）、アンダースコア（下線）、ピリオドを使うことができます。規定の形式は yyyyMMddHHmm です（例： 200906150601）。

正しいタイムスタンプ形式の表記方法については、以下を参照して下さい。

http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html Timestamp Pattern – An optional pattern for the timestamp, based on the java.text.SimpleDateFormat. Valid timestamps contain letters, numbers, dashes, underscores, and periods. The default pattern is yyyyMMddHHmm, for example 200906150601.

For more information about the valid timestamp patterns, refer to:

http://download.oracle.com/javase/6/docs/api/java/text/SimpleDateFormat.html

「ファイルの上書き」 ·· このチェックボックスにチェックを⼊れると、出⼒ファイルと同じ名前の古いファイルがあったとき、それを上書きします。これは、シーケンシャルファイル名やファイル名を一意にするようなタイムスタンプ形式を使っていない場合に有効です。

Overwrite Files – A check box option that, if checked, overwrites old output files with newer ones of the same name. Useful when you do not have sequential filenames, or you specify a timestamp pattern that may lead to identical filenames.

(26)

図 2-8 レポートスケジューリングの出⼒設定ページ

[送信] ボタンをクリックすると、スケジュール済みジョブリストの中に今設定したジョブが現れます。 When you click Submit, the job appears in the list of scheduled jobs.

2.3.3 スケジュール済みジョブの⼀覧を⾒る

スケジュール済みのジョブは、レポート名のそばのアイコンをクリックすると、リポジトリ内に表示されます。あるレポートに対するスケジュール済みジョブのリストを表示するには、レポートをリポジトリ内に表示して右クリックし、コンテクストメニューの [スケジュール...] を選択します。すると、そのレポートに関する「スケジュールされているジョブ」ページが表示されます。

Scheduled jobs appear in the repository with a icon beside the report name. To view the list of scheduled jobs for a report, locate a report in the repository, right-click the report, and select Schedule from the context menu. The Scheduled Jobs page appears for the report.

図 2-9 Freight Report の「スケジュールされているジョブ」ページ

⼀般的なユーザは⾃分が定義したジョブだけを参照しますが、管理者は全ユーザの定義したジョブを⾒ることができます。_図 2-9 では、Freight Report に対し、joeuser と jasperadmin がそれぞれ 1 件のジョブをスケジューリングしていることが分かり