ActiveXビューワを移行する

ActiveReports for .NET 1.0J／2.0J／3.0Jに含まれるActiveXビューワの移行手順について説明します。

移行が必要な条件

6.0J以降のActiveReportsにはActiveXビューワ（ARVIEW2.CAB）が製品に付属しません。このため、WebViewerのViewerTypeプロパティをActiveXViewerに設定している場合、もしくは、Webフォーム上にActiveXビューワ本体を配置して使用している場合、これらのWebアプリケーションは移行する必要があります。16.0JではActiveXビューワの代わりにPDFエクスポート機能を使用する必要があります。

メモ: 以前のバージョンに付属するActiveXビューワを16.0Jで使用する
基本的に、以前のActiveXビューワは16.0Jで作成されたレポートには対応していないため、16.0Jでは使用することはできません。レポートによっては期待通りの表示／印刷結果を得られる可能性がありますが、このような使用方法は、製品の動作保証の範囲外となりますのでご注意ください。

代替手法について

ProfessionalとStandardの場合、ActiveXビューワと同程度のプレビュー／印刷品質を得るには、PDFエクスポートを使用します。

16.0J Professional 利用時
- WebViewer（PDF）
- PDFエクスポート
16.0J Standard 利用時
- PDFエクスポート

移行に際しての注意点

上述の代替手法を用いることでActiveXビューワと同等のプレビュー／印刷品質を得ることが可能ですが、印刷に関する一部の機能が使用できなくなりますのでご注意ください。

	16.0J 利用不可		16.0J 利用可
主な機能	ActiveXビューワ	WebViewer（ActiveX）Professional	WebViewer（PDF）Professional	PDFエクスポート
クライアントに接続されたプリンタへの直接印刷	○	○	○	○
クライアントに接続されたプリンタへのプレビュー無し直接印刷	○	○	○	○
クライアントに接続されたプリンタへのプレビュー無し直接印刷（Windowsの印刷ダイアログを非表示 ※１）	○	○	×	×
クライアントに接続されたプリンタの設定（プリンタ種別、用紙サイズ、etc）を変更して直接印刷	○ （※３）	○ （※３）	○ （※２）	○ （※２）
自動拡大縮小印刷	×	×	×	×
印刷方向の自動設定	×	×	×	×

※１: 通常、クライアントからの印刷は、印刷ボタン押下時に、Windowsの印刷ダイアログが表示されますが、ActiveXビューワでは、Windowsの印刷ダイアログを非表示にした印刷が可能

※２: Windowsの印刷ダイアログ上から、一般的なOfficeアプリケーション等と同様に、用紙サイズや用紙方向を選択して印刷できる

※３: ※２に加え、ユーザーがWindowsの印刷ダイアログを表示する以前の段階に、プログラミング（クライアント側スクリプト）により開発者の意図した用紙サイズや用紙方向を、プリンタに設定可能

移行作業

WebViewerの場合

ViewerTypeプロパティがActiveXViewerに設定されている場合は、AcrobatReaderに設定します。たとえば、以下のようなコードを記述していた場合、赤字の部分を書き変える必要があります。

Visual Basic（移行前）	コードのコピー
' WebビューワのViewerTypeプロパティに選択したビューの種類を設定します。 Dim selection As String = Me.cboViewerType.Items(Me.cboViewerType.SelectedIndex).Text Select Case selection 　Case "AcrobatReader" 　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.AcrobatReader 　Case "ActiveXビューワ" 　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.ActiveXViewer 　Case "HTMLビューワ" 　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.HtmlViewer 　Case "RawHtml" 　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.RawHtml End Select

Visual Basic（移行前）

コードのコピー

' WebビューワのViewerTypeプロパティに選択したビューの種類を設定します。
Dim selection As String = Me.cboViewerType.Items(Me.cboViewerType.SelectedIndex).Text
Select Case selection
　Case "AcrobatReader"
　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.AcrobatReader
　Case "ActiveXビューワ"
　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.ActiveXViewer
　Case "HTMLビューワ"
　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.HtmlViewer
　Case "RawHtml"
　　Me.arvWebMain.ViewerType = DataDynamics.ActiveReports.Web.ViewerType.RawHtml
End Select

Visual Basic（移行後）	コードのコピー
' WebビューワのViewerTypeプロパティに選択したビューの種類を設定します。 Dim selection As String = Me.cboViewerType.Items(Me.cboViewerType.SelectedIndex).Text Select Case selection 　Case "AcrobatReader" 　　Me.arvWebMain.ViewerType = GrapeCity.ActiveReports.Web.ViewerType.AcrobatReader 　"HTMLビューワ" 　　Me.arvWebMain.ViewerType = GrapeCity.ActiveReports.Web.ViewerType.HtmlViewer 　Case "RawHtml" 　　Me.arvWebMain.ViewerType = GrapeCity.ActiveReports.Web.ViewerType.RawHtml End Select

Visual Basic（移行後）

コードのコピー

' WebビューワのViewerTypeプロパティに選択したビューの種類を設定します。
Dim selection As String = Me.cboViewerType.Items(Me.cboViewerType.SelectedIndex).Text
Select Case selection
　Case "AcrobatReader"
　　Me.arvWebMain.ViewerType = GrapeCity.ActiveReports.Web.ViewerType.AcrobatReader
　"HTMLビューワ"
　　Me.arvWebMain.ViewerType = GrapeCity.ActiveReports.Web.ViewerType.HtmlViewer
　Case "RawHtml"
　　Me.arvWebMain.ViewerType = GrapeCity.ActiveReports.Web.ViewerType.RawHtml
End Select

PDFエクスポートの場合
以下の基本操作やサンプルを参考にアプリケーションを再作成します。

すべてを作り直す必要はありません

基本的に、ActiveXビューワとPDFエクスポートで異なるのは、Webサーバーからクライアントにレスポンスされるデータ形式です。ActiveXビューワの場合、Webサーバー上ではRDFファイルが作成されます。PDFエクスポートの場合、Webサーバー上でPDF形式のバイナリデータが作成されます。これら以外の処理については、PDFエクスポート、ActiveXビューワ共通で使用可能であるため、ActiveXビューワを利用して作成した既存アプリケーションを最初から再作成しなければいけないということにはなりません。詳細については、「チュートリアル：カスタムWebのエクスポート」を参照してください。