すべて展開

すべて折りたたむ

重要: ReportListコントロールは、ActiveReports 9.0J Serverとの互換性のために残されています。本コントロールは将来的に今後のバージョンアップで使用できなくなる可能性があります。新規でActiveReports 11.0J Serverとの連携するアプリケーション等を開発する場合は、REST APIを使用してください。

ActiveReports 11.0J ServerのSDKに含まれているReportListコントロールを利用して、ActiveReports 11.0J Serverをインストールしたサイトからレポートの一覧を取得し、各レポートをPDF、Word、Excel形式にエクスポートする機能を、ユーザーが開発した独自のアプリケーションの中に組み込むことができます。このチュートリアルでは、ログイン画面から資格情報を入力し、その情報をもとにサイトからレポートリストを取得する方法を紹介します。また、資格情報をWeb.configファイル内に埋め込んでリストを取得する方法も紹介します。

ログインページを作成する

メモ: 資格情報をWeb.configファイルに埋め込んで実行する場合は、このセクションの手順は省略してください。

1. Visual Studioで、新しいASP.NET Webサイトを作成します。
2. 既定のWebフォーム（Default.aspx）のデザインビューを開き、ツールボックスの［標準］セクションから以下のコントロールをドラッグしてWebフォームのボディセクションにドロップしてから、各コントロールのプロパティを下の表のように設定します。

   ログインページのコントロール

   コントロール	Textプロパティ
   Label	ユーザー名:
   TextBox	?
   Label	パスワード:
   TextBox	?
   Button	ログイン

3. Visual Studioの［Webサイト］メニューから［新しい項目の追加］を選択します。
4. ［新しい項目の追加］ダイアログが表示されたら、［クラス］を選択して、名前を「SessionStorage.vb／SessionStorage.cs」として［追加］をクリックします。
5. 「SessionStorage.vb／SessionStorage.cs」内のコードを以下に置き換えます。

   Visual Basic

   Visual Basicコード 　（SessionStorage.vb内に貼り付けます。）

   コードのコピー

   Imports System Imports System.Web Namespace App_Code Public Class SessionStorage Private Const SecurityTokenKey As String = "{DEBDB016-040A-48f4-B568-897E6D410919}" Public Shared Property SecurityToken() As String Get Return TryCast(HttpContext.Current.Session(SecurityTokenKey), String) End Get Set(value As String) HttpContext.Current.Session(SecurityTokenKey) = value End Set End Property End Class End Namespace

   C#

   C#コード　（SessionStorage.cs内に貼り付けます。）	コードのコピー
   using System; using System.Web; namespace App_Code { public static class SessionStorage { private const string SecurityTokenKey = "{DEBDB016-040A-48f4-B568-897E6D410919}"; public static string SecurityToken { get { return HttpContext.Current.Session[SecurityTokenKey] as string; } set { HttpContext.Current.Session[SecurityTokenKey] = value; } } } }

6. 「Default.aspx.vb／Default.aspx.cs」の先頭にあるImports／usingディレクティブのリストに、Servicing名前空間とApp_Code名前空間を使用する以下のコードを貼り付けます。

   Visual Basic

   Visual Basicコード 　（ファイルの先頭に貼り付けます。）	コードのコピー
   Imports ActiveReports.Server.ReportControls.Servicing Imports App_Code

   C#

   C#コード （ファイルの先頭に貼り付けます。）	コードのコピー
   using ActiveReports.Server.ReportControls.Servicing; using App_Code;

   注意: 後述の「ReportListコントロールをWebフォームに追加する」の手順を必ず実行し、「ActiveReports.Server.ReportControls.dll」への参照を追加してください。この参照を追加しないと、以下の行でエラーが発生します。 using ActiveReports.Server.ReportControls.Servicing;

7. Default.aspx上で、手順2で追加したボタンをダブルクリックしてボタンクリックイベントを作成します。ボタンクリックイベント内にカーソルが配置されます。
8. ログイン画面で入力されたユーザーの資格情報からセキュリティトークンを取得するためのコードをボタンクリックイベントに貼り付けます。以下がそのサンプルコードです。

   Visual Basic

   Visual Basicコード（ボタンクリックイベント内に貼り付けます。）	コードのコピー
   Dim username = TextBox1.Text Dim password = TextBox2.Text Dim reportService = New ReportServiceProxy() SessionStorage.SecurityToken = Nothing Dim securityToken = reportService.Login(username, password, Nothing, False) SessionStorage.SecurityToken = securityToken Server.Transfer("Default2.aspx")

   C#

   C#コード（ボタンクリックイベント内に貼り付けます。）	コードのコピー
   var username = TextBox1.Text; var password = TextBox2.Text; var reportService = new ReportServiceProxy(); SessionStorage.SecurityToken = null; var securityToken = reportService.Login(username, password, null, false); SessionStorage.SecurityToken = securityToken; Server.Transfer("Default2.aspx");

   注意: 後述の「ReportListコントロールをWebフォームに追加するには」の手順を必ず実行し、「ActiveReports.Server.ReportControls.dll」への参照を追加してください。この参照を追加しないと、以下の行でエラーが発生します。 Dim reportService = New ReportServiceProxy() または var reportService = new ReportServiceProxy();

9. Web.configファイルで、以下のようなコードを使用して互換モードを有効にします。

   ASP.NETの互換モードを有効にする

   ASP.NETコード （<configuration>タグと</configuration>タグの間に貼り付けます。）	コードのコピー
   <system.serviceModel> <serviceHostingEnvironment aspNetCompatibilityEnabled="true" /> </system.serviceModel>

WCFサービス用の.svcファイルを作成する

メモ: このセクションの手順は、ASP.NET Webサイトを使用する場合に必要です。ASP.NET Webアプリケーションを使用する場合は、ReportListコントロールをWebフォーム上にドロップしたときに、自動でサービスファイルが追加されるので、このセクションの手順は省略してください。

1. Visual Studioの［Webサイト］メニューから［新しい項目の追加］を選択します。
2. ［新しい項目の追加］ダイアログが表示されたら、［WCFサービス］を選択して、名前を「ReportService.svc」として［追加］をクリックします。
3. 「ReportService.svc」内のコードを以下に置き換えます。

   WCFサービス用の.svcファイルを作成する

   ASP.NETコード	コードのコピー
   <%@ ServiceHost Service="ActiveReports.Server.ReportControls.Servicing.ReportServiceProxy" Factory="ActiveReports.Server.ReportControls.Servicing.ReportServiceHostFactory" %>

4. 以下のファイルがApp_Codeフォルダに追加されていますが、不要なので削除します。
   • IReprotService.vb／IReprotService.cs
   • ReprotService.vb／ReprotService.cs

ReportListコントロールをWebフォームに追加する

1. 2つ目のWebフォーム（Default2.aspx）をプロジェクトに追加します。（ログインページを作成しない場合は、既定のWebフォームに追加。）
2. Webフォームのデザインビューを開き、ツールボックスからReportListコントロールをドラッグしてWebフォームのボディセクションにドロップします。

   ReportListコントロールをツールボックスに追加する手順

   1. ［全般］タブを右クリックして［アイテムの選択］を選択します。
   2. 表示された［ツールボックスアイテムの選択］ダイアログでは、［.NETフレームワークコンポーネント］タブが既定で選択されています。［参照］ボタンをクリックし、ActiveReports.Server.ReportControls.dllファイルを選択すると、［ReportList］がコンポーネントの一覧に追加されるので、横のチェックボックスをオンにして［OK］をクリックします。
   3. ReportListコントロールがVisual Studioツールボックスに表示されます。

   メモ: ActiveReports.Server.ReportControls.dllは、デフォルトでは...\ActiveReports 11.0J Server\SDKフォルダに配置されています。

3. メッセージボックスが表示されたら、［はい］をクリックします。.svcファイルがWebサイトに自動的に追加され、レポートリストからプロキシサービスにアクセスできるようになります。

   メモ: ASP.NET Webサイトを使用する場合、.svcファイルは自動で追加されません。前述の「WCFサービス用の.svcファイルを作成するには」の手順を行い、「ReportService.svc」を手動で追加してください。

4. ［プロパティ］ウィンドウで、ServerEndpointRootPathプロパティを、サイト内のすべてのURLのベースとして使用するURLに設定します。これで、サイト内のURLを相対URLとして設定できます（"localhost:8080"の部分は、ActiveReports 11.0J Serverをインストールしたサイトのアドレスとポートに置き換えます）。
   

   メモ: ASP.NET Webサイトを使用する場合、ReportServicePathプロパティは自動で設定されないので、手動で「ReportService.svc」のファイルのパスを設定してください。

5. コントロールのサイズを変更する場合は、［プロパティ］ウィンドウでWidthプロパティを変更します。

メモ: 設計時に、ReportListコントロールを日本語化して使用するには、グローバルアセンブリキャッシュ（GAC）に以下のアセンブリファイルをインストールする必要があります。これらのファイルは、デフォルトでは...\ActiveReports 11.0J Server\SDKフォルダ、および...\ActiveReports 11.0J Server\SDK\jaフォルダに配置されています。 　・ActiveReports.Server.ReportControls.dll 　・ActiveReports.Server.ReportControls.resources.dll グローバルアセンブリキャッシュへのインストール方法は、以下のMSDNライブラリ等を参照してください。 　MSDNライブラリ 　[方法 : グローバル アセンブリ キャッシュにアセンブリをインストールする] 　https://msdn.microsoft.com/ja-jp/library/default.aspx

サーバーから取得したレポートの一覧をReportListコントロールで表示する

方法1: グローバルアプリケーションクラスのコードを使用してセキュリティトークンとActiveReports 11.0J Serverホストを指定する

メモ: ログインページを作成した場合は、こちらの手順を行います。

1. Visual Studioの［Webサイト］メニューから［新しい項目の追加］を選択します。
2. ［新しい項目の追加］ダイアログが表示されたら、［グローバルアプリケーションクラス］を選択して［追加］をクリックします。
3. 作成された「Global.asax」の先頭にあるApplication Languageタグの下で、次のようなディレクティブを使用してServicing名前空間をインポートします。これでReportServiceProxyが使用できるようになります。

   Servicing名前空間をインポートする

   ASP.NETコード （Application Language行の下に貼り付けます。）	コードのコピー
   <%@ Import Namespace="ActiveReports.Server.ReportControls.Servicing" %> <%@ Import Namespace="App_Code" %>

   メモ: ASP.NET Webアプリケーションを使用する場合は、「Global.asax.vb／Global.asax.cs」ファイルにディレクティブを追加します。 Visual Basicコード （Global.asax.vbファイルの先頭に追加します） コードのコピー Imports ActiveReports.Server.ReportControls.Servicing Imports App_Code C#コード （Global.asax.csファイルの先頭に追加します） コードのコピー using ActiveReports.Server.ReportControls.Servicing; using App_Code;

4. Application Startイベントの下で、以下のようなコードを使用してResolveRemoteEndpointイベントを作成します。URLは実際に使用するものに置き換えてください。

   Visual Basic

   Visual Basicコード（Global.asaxファイル内の、Application_Startイベントの直後に貼り付けます。）	コードのコピー
   Private Shared Sub ResolveRemoteEndpoint(remoteEndpoint As RemoteEndpoint) remoteEndpoint.Address = "http://localhost:8080" remoteEndpoint.SecurityToken = SessionStorage.SecurityToken End Sub

   C#

   C#コード （Global.asaxファイル内の、Application_Startイベントの直後に貼り付けます。）	コードのコピー
   static void ResolveRemoteEndpoint(RemoteEndpoint remoteEndpoint) { remoteEndpoint.Address = "http://localhost:8080"; remoteEndpoint.SecurityToken = SessionStorage.SecurityToken; }

5. Application Startイベント内で以下のようなコードを使用して、ResolveRemoteEndPointイベントのハンドラを提供します。

   Visual Basic

   Visual Basicコード（Application_Startイベント内に貼り付けます。）	コードのコピー
   AddHandler ReportServiceProxy.ResolveRemoteEndpoint, AddressOf ResolveRemoteEndpoint

   C#

   C#コード （Application_Startイベント内に貼り付けます。）	コードのコピー
   ReportServiceProxy.ResolveRemoteEndpoint += ResolveRemoteEndpoint;

方法2: Webアプリケーションのweb.configファイルでユーザー名、パスワード、およびActiveReports 11.0J Serverホストを指定する

メモ: ログインページを作成せず、資格情報などをWeb.configファイル内に埋め込む場合は、こちらの手順を行います。

1. Web.configファイルで、以下のようなコードを使用して資格情報を埋め込みます。

   ASP.NETコード （web.configファイル内の<configuration>タグの直下に貼り付けます。）

   コードのコピー

   <configSections> <sectionGroup name="activereports.server"> <section name="reportServiceProxy" type="ActiveReports.Server.ReportControls.Configuration.ActiveReportsServerSection, ActiveReports.Server.ReportControls, Version=11.x.xxxx.1, Culture=neutral, PublicKeyToken=d557f2f30a260da2" allowDefinition="Everywhere" /> </sectionGroup> </configSections> <activereports.server> <reportServiceProxy remoteReportServicePath="http://localhost:8080/" username="MyUserName" password="MyPassword" /> </activereports.server>

   メモ: "Version=11.x.xxxx.1"の箇所は、ご利用のActiveReports 11.0J Serverのバージョン番号にあわせて変更してください。

実行時に、ReportListコントロールはActiveReports 11.0J Serverからすべてのレポートを取得し、各レポートをPDF、Word、およびExcelにエクスポートするボタンが作成されます。

©2017 GrapeCity inc. All rights reserved.