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

インポートユーティリティを使用すると、他のレポートツールからレポートを変換することができます。すべてのファイルタイプには、独自のインポートユーティリティがあります。インポートユーティリティを実行するには、以下の手順に従います。
 
ステップ1：ウェブブラウザを開き、https://github.com/stimulsoft/Importing.Toolsにアクセスします。

ステップ2：インポートプロジェクトが入ったアーカイブをダウンロードし、解凍します。

ステップ3：Visual Studioなどの開発環境を使用して、プロジェクトをコンパイルします。

ステップ4： Stimulsoftのレポートに変換したいレポートを選択し、変換後のレポートの保存場所を指定します。

ステップ5：「変換」ボタンをクリックします。変換の結果はユーザーに表示されます。

 
 
変換したレポートをStimulsoft製品で使用することができます。

このユーティリティは、Crystal Reportsのテンプレート（.rpt-files）をStimulsoft Reportsのレポートテンプレート形式（.mrt-files）に変換するものです。本ツールはC#のソースコードのみで提供され、Visual Studio 2010、.NET Framework 4.0以降で正常にビルドするには、いくつかのCrystal Reportsランタイムライブラリを参照することが必要です。以下のリンクからアーカイブをダウンロードし、解凍してVisual Studioで開いてください。Visual Studioで必要なDLLがすべて参照され、見つかると、プロジェクトは正常にビルドされます。

プロジェクトは、必要なすべてのアセンブリがGAC（Global Assembly Cache）から自動的に取得されるように作成されています。Stimulsoft Reportsの*.dllライブラリがGACにない場合、それらはNuGetから自動的にプロジェクトに追加されます。インターネットに接続されていない場合、手動でStimulsoft.Base.dllとStimulsoft.Report.dllをプロジェクトに追加する必要があります。

Crystal Reportsのレポートテンプレートのファイル形式は、独自の形式です。したがって、このツールはいくつかのCrystal Reports特別管理アセンブリを必要とします。ツールは、特別なVisual StudioマネージドDLL用のいくつかの特別なCrystal Reportsインタフェースを介してこれらのアセンブリと相互作用します。

これらのアセンブリは必ずしもCrystal Reportsと一緒にシステムにインストールされるとは限りません。通常、インポートツールで正しく動作させるためには、これらのアセンブリの追加インストールと正式なインストールが必要です。

例えば、Crystal Reports 2013の場合、Support Pack（VS: Updates & Runtimeの開発版）が必要で、最初にインストールする必要があり、その後初めてインポートツールが正常にビルドされることになります。

現在のCrystal Reportsのバージョンでは、「SAP Crystal Reportsランタイムエンジン」（32ビットまたは64ビット）の追加インストールが必要です。自動インストーラは、必要なアセンブリをGACにコピーします。しかし、このインストーラは個別にダウンロードする必要があり、標準のCrystal Reportsインストールパッケージの一部ではありません。

このプロジェクトでは、以下のCrystal Reportsアセンブリを使用します。

CrystalDecisions.CrystalReports.Engine
CrystalDecisions.ReportAppServer.DataDefModel
CrystalDecisions.ReportAppServer.ReportDefModel
CrystalDecisions.Shared
CrystalDecisions.Web
CrystalDecisions.Windows.Forms

これらのアセンブリはツールに含まれていません。Crystal Reportsの公式インストーラで適切にインストールすることなく、パッケージを参照し、プロジェクトにコピーしただけでは動作しません。

必要なインストール方法については、こちらをご覧ください。

上記のインストーラーは、以下のリンクからダウンロードできます。

http://www.crystalreports.com/crvs/confirm/

http://downloads.businessobjects.com/akdlm/cr4vs2010/CRforVS_redist_install_32bit_13_0_20.zip
http://downloads.businessobjects.com/akdlm/cr4vs2010/CRforVS_redist_install_64bit_13_0_20.zip

これらの追加インストールに関する要件は、Crystal Reports社からの公式回答をご覧ください。

https://archive.sap.com/discussions/thread/3675145

ランタイムパッケージをインストールせずに、クライアントマシン上でCrystal Reportsを実行できますか？

いいえ、アプリを動作させる唯一の方法は、ユーザーの PC で レディストパッケージの 1つを実行することです。ランタイムを手動でデプロイする方法はサポートしていません。レジストリエントリやDLLの登録が多すぎるため、手動で行うことはできません。

LineとBoxにShapeの代わりにプリミティブを使用する

このフラグが有効でない場合、LineとBoxのコンポーネントは、通常のプリミティブ（shapes、VerticalLine/HorizontalLine、Rectangle/RoundedRectangle）に変換されます。このフラグを有効にすると、LineとBoxのコンポーネントは、特殊なプリミティブ（VerticalLinePrimitive/HorizontalLinePrimitiveとRectanglePrimitive/RoundedRectanglePrimitive）に変換されるようになります。レポートを表示・印刷する場合、グラフィックプリミティブと特殊プリミティブの間に大きな違いはありません。グラフィックプリミティブは、書き出し時に画像として書き出されます。そのため、特殊プリミティブの方が作業しやすい。しかし、Crystal Reportsの特性上、複雑なレポートでは特殊プリミティブは正しく動作しません。そのため、オプションで選択する機能があります。

フォーミュラフィールドでの関数の使用

各フォーミュラフィールドには、式またはデータストリングを置くことができます。各フォーミュラフィールドはデータ辞書の変数に変換されます。Use functions for Formula Fields フラグが有効な場合、Function フラグが変数に設定されます。つまり、レポート レンダリングの際、Stimulsoft Reportsは変数の値を式として使用し、この式の値を計算しようとします。式フィールドに関数を使用するフラグが有効でない場合、変数の値はデータ文字列として使用されます。

変換の主な問題の1つは、マネージドDLLで作業する場合、すべてのオブジェクトプロパティが利用できるわけではないことです。2つ目の問題は、データ構造、バンドでの作業など、レポートツールの構造が異なることです。したがって、レポートを自動的に変換できるとは限らず、レポートを手動で修正する必要があります。

データべース

Crystal Reportsでは、データベースを操作する際に、しばしば内部ライブラリを使用します。.NETから取得できるのは一部のプロパティのみで、ConnectionStringを取得することは不可能です。そのため、すべてのデータベースを識別できるわけではありません。デフォルトでは、識別されないデータ ベースに対して、プロバイダーを指定しない StiOleDbDatabase タイプと ConnectionString テンプレートが使用されます。

データ・ベース

CrystalReportsでは、各レポート/サブレポートに独自のデータ辞書があり、サブレポートではデータ基盤の記述が異なってきます。Stimulsoft Reportsでは、共通のデータ辞書が使用されます。そのため、変換後はすべての辞書が統一されます。データベースが繰り返される場合、それは共通の辞書に含まれません。

画像

画像のサイズと位置を指定することができますが、レポートテンプレートに保存されている場合、画像の内容を取得することは不可能です。

FormulaField

式や数式を入れることができるフィールド。現時点では、これらの式の解析と構文は「そのまま」記述されています。そのため、多くの場合、さらに手動で修正する必要があります。

{Crystal Reportsでは、FormulaFieldsで式と数式を使用することができます。現時点では構文解析と構文変換ができないため、式は「そのまま」記述されます。そのため、多くの場合、さらに手動で式を修正する必要があります。｝

このセクションでは、サードパーティのフォーマットをStimulsoft Reportsの内部フォーマットに変換するためのツールについて説明します。以下に説明するツールは、http://www.stimulsoft.com/en/downloadsのツールセクションからダウンロードすることができます。