[帳票開発ツール]Stimulsoft レポート＆ダッシュボード ユーザーマニュアル

レポートデザイナからリソースを保存するには、データ辞書でリソースを選択し、コンテキストメニューの保存をクリックする必要があります。この場合、ファイルを保存する場所を指定するためのダイアログが呼び出されます。その後、保存ボタンをクリックすると、リソースはソースファイルのフォーマットで保存されます。また、リソースに *.mrt ファイルが追加されている場合は、このリソースを保存する際に *.mrt ファイルも保存されます。

レポートを設計する場合、データファイル（CSV、Excel、JSON、XML、Dbase）を使用することが多い。これらのファイルをもとに、データディクショナリーでデータソースを作成すると、レポートテンプレートの作成に使用されます。この場合、データソースには実データは含まれず、実データにアクセスするためのメソッドやパラメータ、方法などが記述されるだけとなる。ファイルからデータソースへのデータの転送、およびそれに伴うレポートの実データの記入は、このレポートのレンダリング時に行われます。

この場合、CSV、Excel、JSON、XML、Dbaseファイルへのデータソースの指定パスを常に考慮し、必要であれば編集を行う必要があります。また、レポートのテンプレートを他のユーザーに転送する場合、このレポートを正しくレンダリングするためのデータファイルを提供する必要があります。

このような場合、レポート作成時に、データファイル（CSV、Excel、JSON、XML、DBF）をレポートリソースに追加することができます。

データファイルがリソースとしてレポートに追加され、それを元にデータソースを作成した後、データソースを作成することができます。

[新規アイテム]メニューまたは[データ辞書]コンテキストメニューで[新規データソース...]を選択し、リソースへのパスを指定して、または単にリソースギャラリーから選択して、適切なソースタイプを定義します。

データ辞書でリソースを選択し、コンテキストメニューから新規データソース[リソース名]を選択します。

以下は、Excelデータソースを作成するためのメニューです。

このフィールドは、データソースの名前を指定します。

このフィールドは、データソースのエイリアスを指定します。

このフィールドは、データを含むExcelファイルへのパスを指定します。この場合、レポート内のリソースへのリンクが指定されます。リンクはテンプレートresource://file nameを使用して手動で指定するか、リソースリストからリソースを選択すると、リンクが自動的に生成されます。

Excelファイルの最初の行をデータのヘッダーとして使用するかどうかのパラメータです。これを有効にすると、最初の行がデータのヘッダーになります。

リソースギャラリーをベースに、特定のタイプのデータソースを作成することができます。

OKをクリックすると、生成されたデータソースを使用してレポートを作成することができます。

レポート内の画像は、直接アップロード、ファイル、データソース、ハイパーリンクなど、さまざまなリソースから取得することができます。レポートを別の人に送信したり、レポート（または画像）を別の媒体に移動したりする場合、（レポートと一緒に）画像を送信し、これらの画像へのパスを編集する必要があります。ただし、画像を直接画像コンポーネントにアップロードする場合は除きます。ただし、画像を画像コンポーネントに読み込むたびに、レポートファイルのサイズは画像ファイルのサイズ分だけ大きくなります。

したがって、同じ画像を複数の画像コンポーネントで使用する場合や、様々なレポートページのウォーターマークで使用する場合は、この画像をリソースにアップロードする方がよいでしょう。そして、画像コンポーネントやウォーターマークコンポーネントの中で、このリソースへのリンクを指定する必要があります。また、リソースに追加された画像は、画像またはウォーターマークコンポーネントの画像ギャラリーに表示されます。画像をリソースにアップロードした場合、レポートファイルのサイズは画像ファイルのサイズだけ大きくなり、別の人に送信するとき（またはレポートを別のメディアに移動するとき）、画像コンポーネントを追加編集する必要はありません。

リソースに画像を追加した後は、レポートのウォーターマークとして、または画像コンポーネントで使用することができます。

サブレポートコンポーネントは、このコンポーネント内の同じレポートページに別のレポートを表示するために使用されます。この別のレポートは、このレポート・テンプレートの別のページまたは別のレポート・テンプレート・ファイルにあることができるネストされたレポートです。サブレポートコンポーネントを使用すると、レンダリングされたレポートを表示することもできます。

サブレポートコンポーネントで表示したいレポートが別のファイル（*.mrt、*.mrz、*.mdc、*.mdz）の場合、それをレポートリソースに追加することができます。リソースに追加した後は、以下のことが可能です。

リソースをレポートページにドラッグします。この場合、このリソースへのリンクがあるサブレポートコンポーネントが作成されます。

レポートテンプレートにサブレポートコンポーネントを追加する。このコンポーネントを編集する際、リソースへのリンクを指定する必要があります。

また、サブレポートコンポーネントエディターでパラメータを渡すことができます。例えば、ネストされたレポートのデータをフィルタリングする場合などです。ただし、これはレンダリングされていないレポート（*.mrt、*.mrz）にのみ関係します。

レポートでは、リッチテキストを使用する必要がある場合があります。レポートデザイナには、このテキストを表示するための特別なコンポーネント、リッチテキストが用意されています。リッチテキストをレポートに追加するには、次の方法があります。

リッチテキスト・エディターでテキストを入力する。この場合、テキストの書式を編集する必要があります。

テキストを取得するファイルまたはハイパーリンクを指定する。この場合、レポートやファイルを移動する際に、ソーステキストへのパスを編集する必要があります。

そのため、レポートリソースにリッチテキストファイルを追加することも選択肢の一つです。リソースからリッチテキストを出力する場合。

リソースをレポートテンプレートにドラッグする必要があります。

リッチテキストエディタで、リソースへのリンクを指定するか、単にギャラリーからリソースを選択する必要があります。

また、必要に応じて、リソースから取得したテキストをリッチテキストエディタで編集することも可能です。