（本製品は、Visual Studio 2008には対応しておりません）
.NET Framework/VB.NET/C#/Visual Studio 2005 対応
　

• 「レポートデザイナ」コンポーネントでテンプレートをデザインする
• ウィザードを使用して動的にテンプレートを作成する
• すべてプログラミングによって動的にテンプレートを作成する

テンプレートは拡張子*.xmlや*.rstを持つXML形式で保存することができます。作成されたテンプレートはNineRays.Reporting.Components.ReportGeneratorクラスのTemplateプロパティ内に配置されます。レポートで使用されるデータソースもDataSourcesプロパティによってこのクラス内で指定されます。「レポートジェネレータ」がレポートの作成を行います。レポートが生成されると（そのテンプレートにデータが入力されると）、その結果が最終ドキュメントになります。

最終ドキュメントが生成された後、プログラムによって、または「レポートデザイナ」コンポーネントを使用して修正することができます。「レポートデザイナ」コンポーネントは、「レポートビューア」コンポーネントから直接開 くことができます。

下図はレポート生成・運用過程の概念を表しています。

ウィザードを開くには、「レポートデザイナ」の「ファイル」の「新規」項目を選択します。次のようなフォームが画面に表示されます。

リストの「標準のレポート」を選択し、OKをクリックします。

左側の「ページ」パネルには項目があります。最初は「共通」タブだけが表示されています。レポートのテンプレートのパラメータ（タイトル、計測単位、スタイル、スクリプト言語、ページパラメータ、列パラメータ）を構成するには「共通」項目を使用することができます。

データセクションを追加するには、「+」ボタンを使用してください。データセクションはリストで現在選択されたセクションで入れ子になっています。「共通」タブが選択されると、セクションが一番上に追加されます。セクションを削除するには、リスト内でセクションを選択し、「-」ボタンをクリックしてください。

「ページ」パネルのリストで選択されたセクションのパラメータを構成することができます（新しいセクションの作成後に自動的に選択されます）。

データソース名を指定するには、「データソース」フィールドを使用し、フィールドのレイアウト型を指定するには「フィールドのレイアウト」のドロップダウンリストを使用します。値が「リスト」の場合、フィールドはテーブルとして表示され、値が「カード」の場合、各フィールドが新しい行に表示されます。

データソースで利用可能なフィールドは「全フィールド」のリストに表示されます。レポートにあるフィールドは「可視フィールド」タブにあります。「可視フィールド」リストからフィールドを追加および移動するには「←」ボタンや「→」ボタンを使用できます。ブランクのフィールドを追加するには、□ボタンをクリックしてください。フィールドの位置を変更するには、「↑」ボタンや「↓」ボタンを使用してください。キャプションやキャプションのフィールドの幅や「幅」入力フィールドを指定できます。「集計」の列はこのフィールドに基づいて計算される集計関数を指定できます。この場合、現在の関数が含まれる、すべてのデータセクションのLineNumberプロパティが集計グループの条件として定義されます。

デザイン時にReport Sharp Shooterのレポートデザイナを起動するには、フォームのコンポーネントトレイの「ReportGenerator」コンポーネントをダブルクリックするか、（右クリック）メニューより「RunDesigner」を選択します。

「データバンド（DataBand）」セクションは、データソースから各レコードのコンポーネントを繰り返し挿入することができます。「DataBand」のデータソースはDataSourceプロパティ で指定します。データにアクセスするには、「DataBand」に「Detail」セクションを追加します。ページ 、「DataBand」セクション、グループの各ヘッダーやフッターを作成できます。ページのオーバーレイ や「CrossBand」セクションがあります。

テキストボックス
このコンポーネントはテキスト情報を表示します。Valueプロパティに式やコードを指定することによりこの値を動的に設定できます。たとえば、データソースからフィールド値を取得できます。
  イメージ
Pictureオブジェクトはレポートにイメージを組み込むことができます。
シェープ
Shapeオブジェクトはさまざまな形状を表示できます。
バーコード
BarCodeオブジェクトはバーコードを表示できます。値はCodeプロパティで指定され、CodeTypeプロパティはコードの型を指定するために使用されます。
リッチテキスト
RichTextはRTF 形式でテキストを表示できます。
Windows Formsコントロール
このオブジェクトはレポートにWindows Formsコントロールを含むことができます。ControlTypeNameプロパティはコントロールの型を指定できます。

ラベルの作成は通常のレポートの作成とほぼ同じです。主な違いはページサイズを調整しなければならないことです。これを行うには、Pageオブジェクトの一部のプロパティを変更する必要があります。

まず、PaperKindプロパティをCustomに設定します。次にCustomSizeプロパティを使用して希望するサイズに指定します。

次の例では、バーコードを表示するBarCodeオブジェクトと同様に、品名と商品価格を表示する2つのTextBoxがdetail1オブジェクトに追加されています。同時にこれらのオブジェクトのサイズを固定しています。つまりCanGrowプロパティとCanShrinkプロパティはfalseに設定されています。

【デザイン例】

【実行画面】

バーコードの活用

JANコード、郵便カスタマバーコード、UCC/EAN-128 を含む26種類のバーコードが利用できます。

【レポートビューア】


【ツールバー】

【メニュー】


最終レポートの編集機能

「ドキュメント」メニューの「レポートの編集」を選択すると、




のように、実際のデータがバインドされた状態で（レポートビューアではなく）レポートデザイナが開きます。ここで、たとえば次のようにレポート上の特定箇所の電話番号を直接入力して変更したり、タイトルを変更しシェープの角丸四角を加えることもできます。

【デザイナで電話番号を変更】


【デザイナでタイトルを変更しシェープを追加】

【変更後のビューア】

エクスポート機能

Report Sharp Shooterは、レポートをCSV、Excel、XML、BMP、EMF、GIF、JPEG、TIFF、HTML、PDF、RTF、テキストファイル（.TXT）の各ファイル形式にエクスポートできます。

【エクスポート形式の選択】

【エクスポート時の各ファイル形式ごとのオプション指定の例】

レポートビューアのカスタマイズ

レポートビューアは外観をカスタマイズできるプロパティを持つコンポーネントです。

これらのプロパティはツールバーの特定のボタンや列グループと同様に、ステータスバー、ツールバーの表示を有効/無効にできます。これらのプロパティリストは次の通りです。

レポートビューアはすべてのコマンドへのアクセスを提供し、再定義するActionsプロパティを持っています。次はコマンドの一覧です。

デフォルトのアクションを再定義するには、Executingイベントハンドラを記述します。

レポートビューアコンポーネントの標準のインターフェースを変更する場合があります。たとえば、アプリケーションのスタイルに収まらない場合や、ツールバーを変更する必要がある場合に便利です。

例として、ツールバーなしでレポートビューアを作成し（これを行うには、レポートビューアのShowToolBarプロパティをfalseに設定してください）、レポートの前のページと次のページへ進むボタンと、印刷ボタンの3つのボタンをフォームに配置します。これを行うには、ReportGeneratorコンポーネントのActionsコレクションを使用します。たとえば、「次のページに進む」アクションを呼び出すには、reportViewer1.Actions["PrevPage"].ExecuteAction()を書くだけです。ボタンの状態を更新するためにタイマーが使用されます。タイマーのTickイベントのハンドラは次のコードを含んでいます。

button1.Enabled = reportViewer1.Actions["PrevPage"].Enabled;
button2.Enabled = reportViewer1.Actions["NextPage"].Enabled;
button3.Enabled = reportViewer1.Actions["Print"].Enabled;

したがって、対応するボタンにこのアクションを割り当てるだけです。ReportViewerで生成されたレポートのソースはReportBase型のSourceプロパティで指定されます。これを行うためにReportViewerが置かれているフォームデザイナが、ReportBase型のパラメータを取得してSourceプロパティに割り当てます。

【カスタムビューア実行例】

Report Sharp ShooterにはASP.NETアプリケーションからレポートを表示するための「SharpShooterWebViewer」（NineRays.Reporting.Web.SharpShooterWebViewer）というWeb用のビューアコンポーネントがあります。

このSharpShooterWebViewerコンポーネントはNineRays.Reporting.Web.ViewMode列挙体から下記の値を取得できる、ViewMode（レポートを表示するモード）をカスタマイズするためのプロパティがあります。

• HtmlSinglePage ?1ページを表示
• HtmlWholeReport ?レポート全体を表示
• WindowsForms ?NineRays.Reporting.View.ReportViewer のレポートを表示（Windows Formsアプリケーションのレポートを表示するためのコンポーネント）

SharpShooterWebViewerドキュメントのソースはReportGeneratorが継承されるReportBase型のSourceプロパティで指定されます。SharpShooterWebViewerはレポート全体をPDF形式で表示することもできます。

【Webフォームのデザイン例】

【SharpShooterWebViewerのプロパティ】

【Webデモの実行例】

SharpShooterWebViewerは表示されたドキュメントすべてをキャッシュし、レポートがキャッシュに保存される時間はCacheTimeOutプロパティで指定されます。Pageカテゴリからのプロパティを使用して、レポートのページを切り替える行の表示をカスタマイズすることができます。たとえば、NextTextは次のページにリンクするためのテキストを定義し、PagerPositionはレポートのページを切り替える行の表示位置を定義します。ImageFormatプロパティはレポートから送られるイメージ形式を定義します。

●「WebViewer」を使わないで、ブラウザにレポートを表示する方法

下図のMainPageはレポートのヘッダーや形式をユーザに選択させるために使用します。
「表示」ボタンがクリックされると、ClickイベントハンドラがReportPageのページへ転送します。

Response.Redirect("ReportPage.aspx?format="
　　　+DropDownList1.SelectedItem.Value.ToString()+"&title="+TextBox1.Text)

ReportPageのページのLoadイベントハンドラは必要な形式にレポートをエクスポートし、クライアントに送ります。

【実行例】

• ADO.NETオブジェクト - System.Data.DataSet、System.Data.DataView、System.Data.DataTable
• System.ComponentModel.IListSourceインターフェースまたはSystem.Collections.Ienumerableインターフェースを実装するユーザオブジェクト（Ienumerableインターフェースは、System.Array、System.Collections.ArrayList、System.Collections.CollectionBaseやその他の多数のクラスで実装されます。）
• 上述されたリストに含まれない任意のクラスのユーザオブジェクトのプロパティすべてがデータソースとして利用可能です。

レポートのデータソースはReportGeneratorクラスのDataSourcesプロパティを使用して指定されます。

以下では、デザイン時にデータソースを指定してウィザードを利用したレポート作成例を示します。

それでは、実際に既存のデータベース（MDB）の1テーブルのデータをレポートに一覧表示してみましょう。 この例では、最後にボタンのクリックイベントで実行時のデータ読み込みとビューアとデザイナの呼び出しのために5行だけコードを書きますが、それ以外は1行もコードを記述しません。

まず、Visual Studio.NET（VB.NET）の新規プロジェクト（Windowsアップリケーション）を作成します。
次に、ツールボックスの「データ」タブから「OleDbDataAdapter」をフォームにドロップします。

データアダプタ構成ウィザードが起動します。
「データ接続の選択」ダイアログで「新しい接続」ボタンを押します。



次に開く「データリンクプロパティ」ダイアログの「プロバイダ」タブで「Microsoft Jet 4.0 OLE DB Provider」を選択します。


「接続」タブでデータベース名に「Sample.MDB」を選び、「OK」を押します。


「データ接続の選択」ダイアログに戻りますので、そのまま「次へ」を押します。
次に、「クエリの種類の選択」画面が表示されますが、そのまま「次へ」を押します。


次の、「SQLステートメントの生成」ダイアログで「クエリビルダ」ボタンを押します。


「テーブルの追加」ダイアログで、「Customers」を選んで「追加」ボタンを押し、その後「閉じる」ボタンを押します。


「クエリビルダ」が表示されますので、「Customers」テーブルの「*（すべての列）」をドラッグして「列」にドロップします。「OK」ボタンを押します。


「SQLステートメントの生成」ダイアログに戻りますので、「詳細オプション」を押します。


「SQL生成の詳細オプション」ダイアログが表示されますので、「INSERT、UPDATE、およびDELETEステートメントの生成」のチェックをはずします。「OK」ボタンを押します。


「SQLステートメントの生成」ダイアログに戻りますので、「完了」ボタンを押します。

ウィザードは終了し、フォームのコンポーネントトレイには、OleDbDataAdapter1とOleDbConnection1が表示されているはずです。


次に、コンポーネントトレイのOleDbDataAdapter1を右クリックしてメニューから「データセットの生成」を選択します。「データセットの生成」ダイアログが表示されます。
データセットの選択でそのまま「新規作成」を選択して「OK」ボタンを押します。



すると、コンポーネントトレイにDataSet11が表示されます。

　

ここまでは、まだReport Sharp Shooterのコンポーネントには何も設定していません。VB.NETの機能で、レポートに使うデータを設定しただけです。 ここから先でReport Sharp Shooterのコンポーネントを利用します。

次にツールボックスからReport Sharp Shooterの「ReportGenerator」をフォームにドロップします。ReportGenerator1がコンポーネントトレイに表示されます。
次に、ReportGenerator1のDataSourcesプロパティの「...」ボタンを押します。
すると、データバインドエディタが起動します。ここで、「追加」ボタンを押します。


オブジェクト名の編集ダイアログで、「データソースのみ」にチェックを入れてから、「値」に「DataSet11」を選択して、「OK」を 押します。


データバインドエディタのデータバインドリストは次のように表示されます。「閉じる」ボタンを押します。


次に、いよいよReport Sharp Shooterのレポートデザイナを起動します。
コンポーネントトレイの「ReportGenerator」コンポーネントをダブルクリックするか、（右クリック）メニューより「RunDesigner」を選択します。


レポートデザイナが起動します。まだ、レポートはありません。
ここで、「ファイル」メニューの「新規」を選択します。


ウィザードギャラリが開きますので、新規タブの「標準のレポート」を選択して、「OK」を押します。

標準のウィザードが起動します。
ページフレームの中の「+」ボタンを押します。


すると新しいデータセクションのための設定画面が表示されます。


「データソース」でNew_NameのCustomersを設定します。


「全フィールド」のNew_Name.Customersのツリーから順に、Country、Cpmpany、Contact、Phoneの各フィールドを選び「→」ボタンで「可視フィールド」に追加していきます。その際、「キャプション」をそれぞれ、国名 、会社名、担当、電話というように入力します。
設定が終わったら、「OK」ボタンを押します。


すると、次図のようなデザインが表示されます。
このまま、レポートデザイナを閉じます。

レポートデザイナを閉じようとすると、次のようなメッセージが表示されますので、この場合は「いいえ」を選択してください。VB.NETのデザイン画面に戻ります。

ここで、VB.NETのデザイン画面でフォーム（Form1）に、2つのボタン（左からButton1、Button2）を貼って、Textプロパティにそれぞれ、"プレビュー"、"デザイン"と入力してください。


その2つのボタンのクリックイベントに次のコードを記述してください。

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
 
  OleDbDataAdapter1.Fill(DataSet11)

  ReportGenerator1.Prepare()
  Dim previewForm As NineRays.Reporting.View.PreviewForm = New NineRays.Reporting.View.PreviewForm(ReportGenerator1)
  previewForm.ShowDialog(Me)

End Sub

Private Sub Button2_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button2.Click

  ReportGenerator1.DesignTemplate()

End Sub

これで、全ての設定は終了です。
それでは、このプロジェクトを実行してください。

以下のような実行画面になります。

「プレビュー」すると、



「デザイン」ボタンを押した場合は、次のようなレポートデザイナが表示されます。

以上で、この例は終わりですが、実際のアプリケーションでは必要に応じて、色をつけ、罫線を引き、他のデータとのリレーションを設定したりと、より細かいデザインを行うことになるでしょう。
ここで重要なのは、アプリケーション開発者がほとんどコードを書かずに、ビジュアルで簡単に、データと連動したレポートを作成できるということです。 この例では、書いたコードは5行だけでした。

しかし、お客様がReport Sharp Shooterを利用して作成された「開発ツールソフトウェア」の配布は 、ランタイムライセンスフリーの適用外となります。その場合は、お客様のご要望のライセンスを受け付ける体制がございますので、お気軽に弊社までご連絡ください。ここでの「開発ツールソフトウェア」とは、統合開発環境ソフトウェア（IDE）やDLL・OCX、その他ライブラリなどのソフトウェア部品（コンポーネント）などを指します。

セットアップCD-ROM/ユーザ登録カードなど
（マニュアルなどのドキュメントはCD-ROMに含まれます）

▼パッケージイメージ
サイズ:W136×D15×H191mm(CDトールケース)

Report Sharp Shooter 1.8J　【 レポート シャープ シューター 1.8J 】

【１開発者ライセンス】

上記開発ライセンスの他に、4開発者ライセンスパック、開発者サイトライセンスパックがございます。
詳しくは、「ライセンスパック」のページをご覧ください。