Windows アプリケーションでの SOAP API の使用

[アーティクル]
12/15/2008

Reporting Services SOAP API からは、レポートサーバーのすべての機能にアクセスできます。SOAP API は Web サービスです。したがって、SOAP API に容易にアクセスし、エンタープライズレポート機能をカスタムビジネスアプリケーションに取り入れることができます。Windows アプリケーションの Web サービスにアクセスするには、サービスへの呼び出しを作成するコードを記述します。Microsoft .NET Framework を使用すると、プロキシクラスを生成して、Web サービスのプロパティとメソッドを表示し、使い慣れたインフラストラクチャとツールを使用して Reporting Services の技術に基づいたビジネスアプリケーションを構築できます。

Windows フォームを使用したレポート管理機能の統合

SOAP API は、URL アクセスとは異なり、レポートサーバーで使用できる管理機能の完全なセットを提供します。つまり、SOAP を使用すれば、開発者はレポートマネージャのすべての管理機能を利用することができます。したがって、Windows フォームを使用して完全な管理ツールを開発できます。たとえば、Windows アプリケーションにおいて、レポートサーバー名前空間のコンテンツをユーザーが取得できるようにするとします。そのためには、Web サービス ListChildren メソッドを使用してレポートサーバーデータベースの全アイテムを一覧表示した後、Listview、Treeview、または Combobox コントロールを使用してアイテムをユーザーに表示します。次の Web サービスコードを使用した場合、ユーザーがフォームのボタンをクリックすると、ユーザーの [個人用レポート] フォルダ内にある使用可能なレポートの現在の一覧を取得できます。

' Button click event that retrieves a list of reports from
' the My Reports folder and displays them in a combo box
Private Sub listReportsButton_Click(sender As Object, e As System.EventArgs)
   ' Create a new Web service object and set credentials
   ' to Windows Authentication
   Dim rs As New ReportingService2005()
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials

   ' Return the list of items in My Reports
   Dim items As CatalogItem() = rs.ListChildren("/Adventureworks Sample Reports", False)

   Dim ci As CatalogItem
   For Each ci In  items
      ' If the item is a report, add it to 
      ' a combo box
      If ci.Type = ItemTypeEnum.Report Then
         catalogComboBox.Items.Add(ci.Name)
      End If
   Next ci
End Sub 'listReportsButton_Click

// Button click event that retrieves a list of reports from
// the My Reports folder and displays them in a combo box
private void listReportsButton_Click(object sender, System.EventArgs e)
{
   // Create a new Web service object and set credentials
   // to Windows Authentication
   ReportingService2005 rs = new ReportingService2005();
   rs.Credentials = System.Net.CredentialCache.DefaultCredentials;

   // Return the list of items in My Reports
   CatalogItem[] items = rs.ListChildren("/Adventureworks Sample Reports", false);

   foreach (CatalogItem ci in items)
   {
      // If the item is a report, add it to 
      // a combo box
      if (ci.Type == ItemTypeEnum.Report)
         catalogComboBox.Items.Add(ci.Name);
   }
}

その後で、ユーザーがコンボボックスからレポートを選択し、Web ブラウザコントロールまたは画像コントロールを使用してフォームのレポートをプレビューできるようにします。

Windows フォームを使用したレポートの表示とナビゲーション

レポートを Windows フォームアプリケーションに統合する場合に使用できるメソッドは、2 つあります。

SOAP API を使用してサポートされている表示形式でレポートを表示するには、Render メソッドを使用します。SOAP を使用してレポートの表示とナビゲーションを有効化する方法には、次のようなわずかな欠点があります。

URL アクセスによる HTML ビューアで使用できるレポートツールバーの組み込み機能を利用できません。
HTML で表示する場合は、RenderStream メソッドを使用して画像やリソースを追加ストリームとして個別に表示する必要があります。
URL アクセスによってレポートを表示した場合、SOAP API を使用する場合よりもパフォーマンスが多少向上します。

ただし、SOAP API の Render メソッドを使用すると、プログラムによってさまざまな出力形式でレポートを表示および保存できます。これは、ユーザーとの対話を必要とする URL アクセスよりも優れた点です。SOAP API の Render メソッドを使用してレポートを表示すると、サポートされている出力形式のいずれでも表示できます。

Microsoft Visual Studio 2005 に含まれている配信可能な ReportViewer コントロールも自由に使用できます。ReportViewer コントロールでは、Reporting Services 機能をカスタムアプリケーションに容易に埋め込むことができます。ReportViewer コントロールは、事前にデザインして完全な形に仕上げたレポートを、アプリケーションの機能セットの一部として提供することを予定している開発者を対象にしています (たとえば、Web サイト管理アプリケーションであれば、企業の Web サイトに関するクリックストリーム分析を表示するレポートなどが考えられます)。これらのコンロトールをアプリケーションに組み込む方法は、アプリケーションの配置に Reporting Services サーバーコンポーネントを組み込む方法を簡略化したものといえます。これらのコントロールではレポート機能が提供されますが、Reporting Services に含まれる他の機能 (レポートの作成、パブリケーション、配布、配信のためのサポート) はありません。

ReportViewer コントロールには 2 つのバージョンがあります。1 つは Windows リッチクライアントアプリケーション、もう 1 つは ASP.NET アプリケーションを対象にしています。また、これらのコントロールは、ローカル処理モードとリモート処理モードの両方をサポートしています。ローカル処理モードの場合は、アプリケーションによってレポートの定義とデータセットを提供し、レポートの処理を起動します。リモート処理モードの場合は、データの取得とレポートの処理をレポートサーバー側で実行し、これらのコントロールをレポートの表示とナビゲーションのために使用します。このモデルを使用すれば、デスクトップの規模にもエンタープライズの規模にも対応できるスケーラビリティの高いリッチアプリケーションを作成できます。

ReportViewer コントロールは、Visual Studio 2005 オンラインヘルプに記載されています。詳細については、Visual Studio 2005 製品ドキュメントを参照してください。

参照

Share via

Windows アプリケーションでの SOAP API の使用

Windows フォームを使用したレポート管理機能の統合

Windows フォームを使用したレポートの表示とナビゲーション

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース