式の例 (Reporting Services)

Visual Basic の関数を使用して、テキスト ボックスに表示されるデータや、レポートのパラメーター、プロパティ、または他の領域に使用されるデータを操作できます。ここでは、このような関数のうち、いくつかの例を紹介します。Visual Basic の定数は、DateInterval.Month のように、列挙値として指定されています。式エディターは、列挙値の IntelliSense をサポートしていませんが、式に含まれる値は正しくコンパイルされます。

Visual Basic の関数の詳細については、Visual Basic のドキュメントを参照してください。

日付関数

文字列関数

変換関数

決定関数

Reporting Services にはこの他にも、レポート内のデータの操作に使用できるレポート関数があります。ここでは、このような関数のうち 2 つの例を紹介します。レポートの関数の詳細については、「式での組み込みのレポート関数と集計関数の使用 (Reporting Services)」を参照してください。

レポートをデザインする場合、必要に応じてレポート名とページ番号をレポート フッターに表示できます。この操作を行うには、以下の式を使用できます。

• 次の式では、レポート名、およびレポートが実行された時刻が返されます。この式は、レポート フッターまたはレポート本文のテキスト ボックスで使用できます。時間の書式は、.NET Framework の短い日付用の書式設定の文字列を使用して設定されます。

  =Globals.ReportName & ", dated " & Format(Globals.ExecutionTime, "d")
  

• 次の式では、レポートのページ番号および全ページ数が返されます。この式は、レポートのフッター内のテキスト ボックスで使用できます。

  =Globals.PageNumber & " of " & Globals.TotalPages
  

以下の例では、ディレクトリの一覧の内容と同様に、ページ ヘッダーにページの最初と最後の値を表示する方法について説明します。この例では、LastName という名前のテキスト ボックスを含むデータ領域を想定しています。

• 次の式は、ページ ヘッダーの左側にあるテキスト ボックスで使用されます。この式では、そのページの LastName テキスト ボックスの最初の値が返されます。

  =First(ReportItems("LastName").Value)
  

• 次の式は、ページ ヘッダーの右側にあるテキスト ボックスで使用されます。この式では、そのページの LastName テキスト ボックスの最後の値が返されます。

  =Last(ReportItems("LastName").Value)
  

次の例では、合計ページ数の表示方法について説明します。この例では、Cost という名前のテキスト ボックスを含むデータ領域を想定しています。

• 次の式は、ページ ヘッダーまたはページ フッターで使用されます。この式では、Cost テキスト ボックスの値の合計がそのページに返されます。

  =Sum(ReportItems("Cost").Value)
  

注意
ページ ヘッダーまたはページ フッターでは、1 つの式につき 1 つのレポート アイテムしか参照できません。また、ページ ヘッダーまたはページ フッターの式では、テキスト ボックスの名前を参照することはできますが、テキスト ボックス内の実際のデータ式は参照できません。

レポートによっては、グループやレポート アイテムに改ページを設定せずに、またはグループやレポート アイテムの改ページに追加する形で、指定した行数の最後に改ページを挿入したい場合があります。この操作を行うには、必要なグループや詳細レコードを含むグループを作成し、そのグループに改ページを追加した後、指定された行数でグループ化を行うグループ式を追加します。

• 次の式をグループ式で使用すると、25 行ごとに数値が割り当てられます。グループに改ページが定義されている場合は、この式の結果として、25 行ごとに改ページが行われます。

  =CInt(Ceiling(RowNumber(Nothing)/25))
  

  ユーザーが 1 ページあたりの行数の値を設定できるようにするには、RowsPerPage という名前のパラメーターを作成し、次の式で示すように、そのパラメーターに基づいてグループ式を作成します。

  =CInt(Ceiling(RowNumber(Nothing)/Parameters!RowsPerPage.Value))
  

  グループに改ページを設定する方法の詳細については、「改ページを追加する方法 (Reporting Services)」を参照してください。

• テキスト ボックスの Color プロパティで次の式を使用すると、Profit フィールドの値に応じてテキストの色が変更されます。

  =Iif(Fields!Profit.Value < 0, "Red", "Black")
  

• データ領域にあるレポート アイテムの BackgroundColor プロパティで次の式を使用すると、各行の背景色に薄緑色と白が交互に設定されます。

  =Iif(RowNumber(Nothing) Mod 2, "PaleGreen", "White")
  

  特定のスコープに対して式を使用する場合は、次のように、集計関数に対してデータセットを指定する必要があります。

  =Iif(RowNumber("Employees") Mod 2, "PaleGreen", "White")
  

注意
使用できる色は、.NET Framework の KnownColor 列挙体の色です。

レポート アイテムの表示プロパティを使用して、レポート内のアイテムの表示/非表示を切り替えることができます。テーブルなどのデータ領域では、最初に、式の値に基づいて詳細行を非表示にできます。

• グループ内の詳細行の初期表示に次の式を使用すると、PctQuota フィールドで 90% を超えるすべての売上の詳細行が表示されます。

  =Iif(Fields!PctQuota.Value>.9, False, True)
  

• テーブルの Hidden プロパティに次の式を設定すると、テーブルの行数が 12 行を超えた場合にのみテーブルが表示されます。

  =IIF(CountRows()>12,true,false)
  

レポート データを使用して URL をカスタマイズできます。また、テキスト ボックスに対するアクションとして URL を追加するかどうかを、条件付きで制御することもできます。

• 次の式をテキスト ボックスに対するアクションとして使用すると、URL パラメーターとしてデータセット フィールド EmployeeID を指定する、カスタマイズされた URL が生成されます。

  ="http://adventure-works/MyInfo?ID=" & Fields!EmployeeID.Value
  

  詳細については、「URL へのハイパーリンクを追加する方法 (Reporting Services)」を参照してください。

• 次の式では、テキスト ボックス内に URL を追加するかどうかを、条件付きで制御します。この式では、アクティブ URL をレポートに含めるかどうかをユーザーが決定できるように、IncludeURLs という名前のパラメーターを使用しています。この式は、テキスト ボックスに対するアクションとして設定されます。パラメーターを False に設定してからレポートを表示すると、ハイパーリンクなしでレポートを Microsoft Excel にエクスポートできます。

  =IIF(Parameters!IncludeURLs.Value,"http://adventure-works.com/productcatalog",Nothing)
  

パラメーターの式を使用して、パラメーターの既定値を変更できます。たとえば、パラメーターを使用して、レポートの実行に使用されるユーザー ID に基づき、特定のユーザーに合わせてデータをフィルター処理することができます。

• パラメーターの既定値として次の式を使用すると、レポートを実行するユーザーのユーザー ID が収集されます。

  =User!UserID
  

• レポートのクエリ パラメーター、フィルター式、テキスト ボックスなどの領域でパラメーターを参照するには、Parameters グローバル コレクションを使用します。この例では、パラメーターの名前が Department であることを想定しています。

  =Parameters!Department.Value
  

• パラメーターはレポート内に作成できますが、非表示に設定されます。レポート サーバーでレポートが実行される際、パラメーターがツール バーに表示されないため、レポートを表示するユーザーは既定値を変更できません。既定値に設定された非表示パラメーターは、カスタム定数として使用できます。この値は、フィールド式など、あらゆる式で使用できます。次の式では、ParameterField という名前のパラメーターの既定値で指定されたフィールドを特定しています。

  =Fields(Parameters!ParameterField.Value).Value
  

  詳細については、「パブリッシュ済みレポートのパラメータ プロパティの設定」を参照してください。

特定のグループ スコープ内のローカルなグループ変数の値を初期化し、その変数を式の中で参照することができます。カスタム コードでグループ変数を使用するシナリオとしては、カスタム集計の実装が挙げられます。詳細については、「グループ変数を使ったカスタム集計 (Reporting Services 2008)」を参照してください。

変数の詳細については、「式におけるレポート変数コレクションとグループ変数コレクションの参照の使用 (Reporting Services)」を参照してください。

次の例では、FixSpelling という埋め込みメソッドが呼び出され、SubCategory.Value 内の "Bike" というテキストがすべて "Bicycle" に置き換えられます。

=Code.FixSpelling(Fields!SubCategory.Value)

レポート定義に埋め込んで使用する次のコードは、FixSpelling メソッドの実装を示しています。この例では、.NET Framework の System.Text..::..StringBuilder クラスを参照する方法を示しています。詳細については、「レポートにコードを追加する方法 (Reporting Services)」および「レポートにアセンブリへの参照を追加する方法 (Reporting Services)」を参照してください。

Public Function FixSpelling(ByVal s As String) As String
   Dim strBuilder As New System.Text.StringBuilder(s)
   If s.Contains("Bike") Then
      strBuilder.Replace("Bike", "Bicycle")
      Return strBuilder.ToString()
      Else : Return s
   End If
End Function

式内の一部の値は、レポート処理時に NULL または未定義と評価されることがあります。その結果、ランタイム エラーが発生して、評価した式ではなく "#Error" がテキスト ボックスに表示される場合があります。IIF 関数は特にこの動作の影響を受けます。これは、If-Then-Else ステートメントとは異なり、IIF ステートメントの各部分 (関数呼び出しを含む) が、true であるか false であるかを検証するルーチンに渡される前に評価されるためです。=IIF(Fields!Sales.Value is NOTHING, 0, Fields!Sales.Value) ステートメントを実行すると、Fields!Sales.Value が NOTHING の場合は、表示されたレポートに " #Error" と表示されます。

この状況を回避するには、次のいずれかの方法を使用します。

• フィールド B の値が 0 または未定義の場合は、分子に 0、分母に 1 を設定します。それ以外の場合は、分子にフィールド A の値、分母にフィールド B の値を設定します。

  =IIF(Field!B.Value=0, 0, Field!A.Value / IIF(Field!B.Value =0, 1, Field!B.Value))
  

• カスタム コード関数を使用して、式の値を返します。次の例では、現在の値と前の値の差がパーセンテージで返されます。これを使用すると、任意の連続する 2 つの値の差を計算できます。また、最初の比較のエッジ ケース (前の値が存在しない場合) と、前の値または現在の値が null (Visual Basic では Nothing) であるケースを処理できます。

  Public Function GetDeltaPercentage(ByVal PreviousValue, ByVal CurrentValue) As Object
      If IsNothing(PreviousValue) OR IsNothing(CurrentValue) Then
          Return Nothing
      Else if PreviousValue = 0 OR CurrentValue = 0 Then
          Return Nothing
      Else 
          Return (CurrentValue - PreviousValue) / CurrentValue
      End If
  End Function
  

  次の式では、このカスタム コードをテキスト ボックスから呼び出す方法を示しています。

  =Code.GetDeltaPercentage(Previous(Sum(Fields!Sales.Value),"ColumnGroupByYear"), Sum(Fields!Sales.Value))