すべて展開

すべて折りたたむ

ActiveReports 9.0J ServerのSDKに含まれているReportListコントロールを利用して、ActiveReports 9.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 9.0J Server\SDKフォルダに配置されています。

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

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

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

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

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

メモ: 設計時に、ReportListコントロールを日本語化して使用するには、グローバルアセンブリキャッシュ（GAC）に以下のアセンブリファイルをインストールする必要があります。これらのファイルは、デフォルトでは...\ActiveReports 9.0J Server\SDKフォルダ、および...\ActiveReports 9.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 9.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 9.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=9.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=9.x.xxxx.1"の箇所は、ご利用のActiveReprots 9.0J Serverのバージョン番号にあわせて変更してください。

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

Copyright © 2015 GrapeCity inc.