Zen レポート・クラスの構築

クラス・パラメータ

クラス・パラメータは、Zen レポート・クラスで使用可能な ObjectScript の規約です。概要については、"Caché オブジェクトの使用法" の “Caché クラス” の章の “クラス・パラメータ” を参照してください。

“Zen レポートの概要” の章の “Zen レポートのチュートリアル” のセクションでは、クラス・パラメータの APPLICATION、DEFAULTMODE、および REPORTXMLNAMESPACE を紹介しました。これらは、スタジオで新しく Zen レポート・クラスを作成する際に、Zen レポート・ウィザードによって自動的に指定されます。Zen レポート・クラスでは、他にも多くのクラス・パラメータがサポートされています。詳細は、付録 “Zen レポート・クラスのパラメータ” の以下のセクションを参照してください。

• “一般的に使用するクラス・パラメータ” では、Zen レポートの一般的な処理命令について説明します。

• “XSLT スタイルシートのクラス・パラメータ” では、その他の特殊な XSLT 処理命令について説明します。この一連のパラメータにより、ブラウザが Internet Explorer の場合で、Zen レポート・クラスの CSP クラス・パラメータ PRIVATE を 1 (True) に設定することによって、Zen レポート・クラスをプライベートとしてマークしている場合に発生する問題に対処できます。このような問題がない場合は、これらの特殊なクラス・パラメータを使用する必要はありません。

SQL クエリ・パラメータ

Zen レポートにデータを入力する SQL クエリを指定する場合、クエリには SQL パラメータを含めることができます。これは、Zen ページと同様に Zen レポートでもサポートされています。以下は、パラメータを取る SQL クエリの例です。? 文字は、クエリ内のパラメータのプレースホルダです。

SELECT ID,Customer,Num,SalesRep,SaleDate
    FROM ZENApp_Report.Invoice
    WHERE (Month(SaleDate) = ?) OR (? IS NULL)
    ORDER BY SalesRep,SaleDate

以下は、? プレースホルダに値を提供するために <parameter> 要素で sql 属性を使用してデータを指定する、Zen レポートの例です。

<report
  xmlns="http://www.intersystems.com/zen/report/definition"
  name="myReport"
  sql="SELECT ID,Customer,Num,SalesRep,SaleDate
    FROM ZENApp_Report.Invoice
    WHERE (Month(SaleDate) = ?) OR (? IS NULL)
    ORDER BY SalesRep,SaleDate"
    orderby="SalesRep,Customer" >
    <!-- Supply values to the ? query parameters here -->
    <parameter expression='..Month'/>
    <parameter expression='..Month'/>
  <!-- Other report contents appear here -->
</report>

SQL クエリとそのパラメータに関する詳細は、“Zen レポートのデータの収集” の章の “<report> または <group> でのクエリの作成” のセクションを参照してください。

データ型パラメータ

データ型パラメータは、Zen レポート・クラスで使用可能な ObjectScript の規約です。概要については、"Caché オブジェクトの使用法" の “データ型” の章の “パラメータ” を参照してください。

Zen レポートの最も便利なデータ型パラメータは、ZENURL です。開発者が ZENURL パラメータを Zen レポート・クラスのプロパティに割り当てると、ユーザは Zen レポートを呼び出す際に URI にクエリ・パラメータを指定することで、実行時にそのプロパティの値を設定することができます。ZENURL 値により、URI クエリ・パラメータに名前を付けます。規約により、ドル記号 (“$”) で始まる ZENURL 値は、定義済みの URI クエリ・パラメータ ($MODE など) のために予約されています。次に例を示します。

Property employeeID As %ZEN.Datatype.string(ZENURL="ID");

詳細は、“Zen レポートの実行” の章の “URI による Zen レポート・クラスのプロパティの設定” を参照してください。

XSLT スタイルシート・パラメータ

ユーザは、Zen レポート・クラスを呼び出す際に URI クエリ・パラメータを使用して、XSLT スタイルシート・パラメータ値を Zen レポートに渡すことができます。この方法で定義されたパラメータは、XData ReportDisplay の <report> 要素内の XSLT グローバル変数になります。この規約では、XData ReportDisplay ブロック内の <xslt> 要素と、ZENURL データ型パラメータが定義された少なくとも 1つのプロパティを持つ Zen レポート・クラスのプロパティとの調整を慎重に行う必要があります。

詳細と完全な例は、“Zen レポートのページのフォーマット” の章の “<xslt>” を参照してください。

URI クエリ・パラメータ

ZENURL を使用して定義できる URI クエリ・パラメータに加え、Zen レポートでは定義済みの URI クエリ・パラメータがいくつか用意されています。これらを実行時に使用して、対応する Zen レポート・クラスのパラメータによって設定されている値をオーバーライドすることができます。規約により、これらのパラメータの名前はドル記号 (“$”) で始まります。

次の例では、URI 文字列に $MODE パラメータを使用して、Zen レポート・クラス内の DEFAULTMODE パラメータに設定されているすべての値をオーバーライドします。以下の $MODE=pdf の値により、出力のタイプを PDF に変更します。

http://localhost:57772/csp/myPath/myApp.myReport.cls?$MODE=pdf

使用可能な URI パラメータおよびそれらに対応するクラス・パラメータの概要は、“Zen レポートの実行” の章の “Zen レポートの URI クエリ・パラメータ” を参照してください。

メッセージ・ディクショナリへのエントリの追加

Zen レポートのコードの中で Zen のデータ型 %ZEN.Datatype.captionOpens in a new tab または $$$Text マクロを使用している場所であれば、対応するテキスト値は該当の Caché ネームスペースでメッセージ・ディクショナリのエントリになります。そこから翻訳するテキスト値をエクスポートできます。翻訳したテキストを Caché メッセージ・ディクショナリにインポートして戻し、アプリケーションのローカライズに使用できます。

Zen レポート・コンポーネントの多くの属性は既に %ZEN.Datatype.captionOpens in a new tab タイプになっているので、自動的にローカライズがサポートされています。このドキュメントの各属性の説明では、この扱いに該当するかどうかを示しています。ObjectScript がサポートされている場所であれば、Zen レポートの実行時式の値などの $$$Text マクロを使用できます。さらに、Zen レポート・クラスには、$$$Text マクロを呼び出すショートカットが用意されています。このショートカットは、Zen レポート・クラスの XData ReportDisplay ブロックでのみ使用可能です。

その構文は以下のとおりです。

<item value="@footertime@Created on: " />

以下を使用して、該当の Caché ネームスペースで使用するメッセージ・ディクショナリのエントリを作成します。

• メッセージ・テキスト "Created on: " — 他の言語に翻訳するテキストです。

• メッセージ識別子 "footertime" — Caché のローカライズ機能では、この識別子を使用して翻訳済みテキストを検索します。

$$$Text マクロを使用する場合とは異なり、2 つの @ を記述したショートカットを使用する場合は、各メッセージ識別子 (この例では "footertime") がローカライズ DOMAIN 全体で一意であることをユーザ側で確認する必要があります。

Method %OnBeforeReport() As %Status
{
  Set %response.Language =
    ##class(%MessageDictionary).MatchLanguage($$$SessionLanguage,"ZenReport")
  Quit $$$OK
}

Excel 出力のローカライズ

“Excel スプレッドシート出力向け Zen レポートの設定” のセクションでは、Zen レポートを使用して Excel スプレッドシートを作成する方法について説明します。スプレッドシートを作成すると、<element> の excelName 属性によりスプレッドシートの列ヘッダにテキストが提供されます。必要な特殊構造を持つ ReportDefinition ブロックを使用すると、excelName により自動的に列ヘッダのテキストをメッセージ・ディクショナリに置くことでローカライズがサポートされます。ReportDisplay ブロックを使用して任意の形式で XML から Excel スプレッドシートを作成する場合、列ヘッダのテキストをローカライズするのにいくつかの追加手順を行う必要があります。

1. このようなレポートには出力モード displayxlsx が必要なため、DEFAULTMODE または $MODE を適切に設定する必要があります。また DOMAIN パラメータを設定する必要もあります。DOMAIN は任意のテキスト文字列であり、メッセージ・ディクショナリ内のエントリとそれらエントリを生成したクラスとを一致させるのに使用します。DOMAIN を設定しないとローカライズは機能しません。

   Parameter DEFAULTMODE As STRING = "displayxlsx";
   Parameter DOMAIN As STRING = "SKISC"; 
   

   

2. 以下のサンプル・コードにあるように、レポートの XML を指定する ReportDefinition ブロックを作成します。

   XData ReportDefinition 
   [ XMLNamespace = "http://www.intersystems.com/zen/report/definition" ]
   {
   <report xmlns="http://www.intersystems.com/zen/report/definition"
    name="MyReport" 
    sql="SELECT TOP 10 Name,DOB,Age FROM Sample.Person" 
    runtimeMode="0">
     <group name="Person">
      <attribute name="name" field="Name"/>
      <attribute name="dob" field="Dob" 
       expression="..ToExcelDate(%val)"/>
      <attribute name="age" field="Age"/>
     </group>
   </report>
   }
   

   

3. Excel 出力のレポートのフォーマット処理を行う ReportDisplay ブロックを定義します。excelName の値の最初にある “$$$” はローカライズの当該テキスト値を表します。

   XData ReportDisplay 
   [ XMLNamespace ;= "http://www.intersystems.com/zen/report/display" ]
   {
   <report xmlns="http://www.intersystems.com/zen/report/display"
    name="MyReport">
     <body>
      <table group="Person" excelSheetName="Persons" 
       excelGroupName="Person" oldSummary="false">
       <item field="@name" excelName="$$$Name" />
       <item field="@dob" isExcelDate="true" 
        excelName="$$$Date of Birth" />
       <item field="@age" isExcelNumber="true" 
        excelName="$$$Age">
       </item>
      </table>
     </body>
   </report>
   }
   

   

   ReportDefinition と ReportDisplay でレポートの名前は同じである必要があります。

4. $$$ 式の ^CacheMsg グローバルのエントリを生成するには、ヘルパー ClassMethod を記述します。レポートのコンパイル時にエントリが生成されます。

   ClassMethod Translations() 
   {
       set x=$$$Text("Name")
       set x=$$$Text("Date of Birth")
       set x=$$$Text("Age")
   } 
   

   

5. CacheMsg をエクスポートします。

   DO ##class(%Library.MessageDictionary).ExportDomainList("C:\Temp\local.xml","SKISC") 
   

   

6. エクスポートしたメッセージ・ディクショナリ・ファイルを変換し、ローカライズ・バージョンを保存します。

7. 変換をインポートします。

   DO ##class(%Library.MessageDictionary).Import("C:\Temp\local_de.xml")
   

   

スタイルを定義する複合クラスの作成

以下の図では、<document> コンテナに配置するスタイル・クラスの定義を目的とする %ZEN.Report.Display.compositeOpens in a new tab クラスの主要部分を取り上げています。この図の後に詳しい説明があります。

• 複合クラスは、%ZEN.Report.Display.compositeOpens in a new tab クラスの拡張とする必要があります。

• クラスによって NAMESPACE パラメータを定義する必要があります。このパラメータには、任意の値を指定できます。

• XData ブロックの名前は必ず Display とします。

• XData Display ブロックでは、XMLNamespace キーワードに以下の値を指定する必要があります。

  http://www.intersystems.com/zen/report/display

• XData Display の最上位コンテナ要素は、<composite> である必要があります。xmlns 属性値を指定できますが、値は XMLNamespace キーワードと同じでも異なっていてもかまいません。

• <composite> コンテナの補足の XML ネームスペース名を、以下のように xmlns: 属性構文を使用して定義します。この新しいネームスペースは、別のクラスからこの複合クラスを参照する場合に重要になります。これは NAMESPACE パラメータで使用した値と同じ値になります。以下の例では、この新しいネームスペースを mystyle としています。

• この例に示す複合クラスの目的は、Zen レポートの <document> コンテナで指定する各種スタイルを定義することです。時間と共に、スタイルの複合クラスのライブラリがしだいに大きなサイズになる可能性があります。これらのクラスとその参照を容易に管理できるようにクラスの命名規則を簡潔にするには、クラス自体の単純な名前に基づいてスタイル名を作成することをお勧めします。この例では、テーブル・ヘッダのスタイルの名前 th.mygroupheader は、そのクラスの単純な名前 mygroupheader に基づいています。

• 複合クラスをコンパイルすると、その単純なクラス名 (この例では、mygroupheader) は、Zen レポート・クラスの XData ReportDisplay ブロックに記述できる XML 要素の名前になります。これにより、複合クラスを参照し、そのコンテンツを XData ReportDisplay ブロックの該当位置に配置できます。参照を記述する際の正しいネームスペースの使用などの構文に関する詳細は、“Zen レポートでの複合クラスの参照” セクションを参照してください。

レイアウトを定義する複合クラスの作成

以下の図では、<report> に配置する <pagefooter> の定義を目的とする %ZEN.Report.Display.compositeOpens in a new tab クラスの主要部分を取り上げています。この図の後に詳しい説明があります。

• ベース・クラス、XData ブロックの名前、XMLNamespace キーワードの値、最上位コンテナ、および xmlns 属性の基本特性は、“スタイルを定義する複合クラスの作成” のセクションにおける説明と同じです。

• この例に示す複合クラスの目的は、<report> の <pagefooter> で指定する場所に適用するレイアウトを定義することです。複合クラスには、3 つのプロパティが用意されています。複合クラスのすべてのプロパティは、例で示すように、Zen データ型で定義する必要があります。以下のように、このプロパティを単純に定義した場合は、その複合クラスを参照する際にそれらを属性として扱います。

  Property username As %ZEN.Datatype.string;
  

  

  以下のように、プロパティに XMLPROJECTION を割り当てて "element" に設定した場合は、複合クラスを参照する際にそれらを要素として扱います。

  Property username As %ZEN.Datatype.string(XMLPROJECTION = "element");
  

  

  プロパティの投影方法に関係なく、複合クラスの XData Display ブロックの中では各プロパティの参照は以下の形式になります。

  #(..property_name)#
  

  

  この参照を指定する #()# 構文は複合クラス独特のものではなく、これが Zen レポートの式であることを示す構文です。構文に関する詳細は、“Zen レポートでの実行時式の使用法” を参照してください。#()# コンテナでは、二重ドット構文でクラスのプロパティを参照します。property_name はプロパティの名前です。例に挙げた複合クラスの XData Display ブロックで username プロパティを参照する行の全体は以下のようになります。

  <item field="#(..username)#" />
  

  

  複合クラスでこのような実行時式を使用する場合、その複合クラスでは、<item> の field 属性の値として適切に機能する username プロパティの値が呼び出し元の Zen レポートから送信されることを想定しています。次のセクション “Zen レポートでの複合クラスの参照” では、この関係の正しい例を示します。Zen レポートから複合クラスに送信したプロパティ値がその複合クラスに適していない場合、対応するレポートのセクションは正常に機能しません。

• Zen レポートを他の言語にローカライズする必要がある場合は、複合クラスのローカライズを有効にする必要があります。そのためには、DOMAIN パラメータを空ではない値に設定し、テキストの値でローカライズ構文を必要に応じて使用します。例にある 2 つの @ を使用した構文の詳細は、“Zen レポートのローカライズ” を参照してください。

• 複合クラスをコンパイルすると、その単純なクラス名 (この例では、ReportFooter) は、Zen レポート・クラスの XData ReportDisplay ブロックに記述できる XML 要素の名前になります。これにより、複合クラスを参照し、そのコンテンツを XData ReportDisplay ブロックの該当位置に配置できます。参照を記述する際の正しいネームスペースの使用や複合クラスのプロパティ値の指定方法などの構文に関する詳細は、“Zen レポートでの複合クラスの参照” セクションを参照してください。

Zen レポートでの複合クラスの参照

以下の図では、いくつかの複合クラスを参照する Zen レポート・クラスの XData ReportDisplay ブロックを取り上げています。この複合クラスには、前のセクションの “スタイルを定義する複合クラスの作成” および “レイアウトを定義する複合クラスの作成” で定義したものもあります。図の後の説明では、図中の番号の部分について詳しく説明しています。

• <report> 要素では、参照する複合クラスごとに NAMESPACE パラメータ値と一致する XML ネームスペース接頭語を定義する必要があります。そのためには、xmlns: 属性構文を使用します。この例では、スタイル複合クラスにネームスペース接頭語 mystyle を指定し、レイアウト複合クラスにネームスペース接頭語 my を指定しています。この使い分けは任意ですが、複合クラスの構成方法として合理的です。

  各ネームスペース接頭語に割り当てる URI の値は、対応する複合クラスで指定している NAMESPACE および <composite> の定義に沿ったものとする必要があります。“スタイルを定義する複合クラスの作成” および “レイアウトを定義する複合クラスの作成” に示す値と、ここに示す値を比較してください。

  XData ReportDisplay 
    [ XMLNamespace = "http://www.intersystems.com/zen/report/display" ]
  {
    <report xmlns="http://www.intersystems.com/zen/report/display"
      xmlns:mystyle="http://www.intersystems.com/zen/report/display/my/style"
      xmlns:my="http://www.intersystems.com/zen/report/display/my">
      <!-- CONTENTS OF REPORT HERE -->
    </report>
  }
  

  

• 複合クラスを参照する場合、その名前を XData ReportDisplay の中の XML 要素として使用します。複合クラス名の前にネームスペース接頭語とコロン文字を付加します。以下の例では、ネームスペース接頭語 mystyle と複合クラス名 mygroupheader を使用しています。mygroupheader 複合クラスで使用する構文を確認するには、“スタイルを定義する複合クラスの作成” を参照してください。以下のとおり、この複合クラスにプロパティはありません。

  <mystyle:mygroupheader />
  

  

  この参照によって、mygroupheader 複合クラスの <composite> と </composite> の間にあるコード全体が、XData ReportDisplay ブロックの指定の場所に配置されます。

• ここでは、ネームスペース名 my と複合クラス名 ReportFooter を使用しています。ReportFooter 複合クラスで使用する構文を確認するには、“レイアウトを定義する複合クラスの作成” を参照してください。この複合クラスには、class、timestamp、および username の 3 つのプロパティがあります。

  <my:ReportFooter class="table.mygroupfooter" 
                   timestamp="@timestamp" 
                   username="@username" />
  

  

  この参照によって、ReportFooter 複合クラスの <composite> と </composite> の間にあるコード全体が、XData ReportDisplay ブロックの指定の場所に配置されます。ReportFooter から配置するとき、複合クラスで class、timestamp、および username の各プロパティを参照している場所には、XData ReportDisplay で割り当てた値が代入されます。

• XML 属性として投影される ReportFooter クラスのすべてのプロパティについて、その名前の属性を指定し、プロパティに必要な値を設定します。以下はその例です。

  <my:ReportFooter class="table.mygroupfooter" 
                   timestamp="@timestamp" 
                   username="@username" />
  

  

  この例では、class の値はリテラル文字列です。timestamp および username の値は、同じ Zen レポート・クラスにある XData ReportDefinition ブロックで生成した XML の属性から取得します。そのため、これらには XPath @ 構文を使用します。また、複合クラスのどの属性の値にも Zen レポートの実行時式を使用できます。

  Zen データ型を指定して定義した複合クラスのプロパティは、自動的に属性として XML に投影されます。これらのプロパティを XML 要素として投影するには、プロパティの定義方法と参照方法を変更する必要があります。複合クラスで以下を指定しているとします。

  Property username As %ZEN.Datatype.string;
  

  

  これを以下の指定に変更します。

  Property username As %ZEN.Datatype.string(XMLPROJECTION = "element");
  

  

  要素としてプロパティを投影している場合は、複合クラスを参照する構文が異なります。ReportFooter のプロパティが以下のようになっているとします。

  Property class As %ZEN.Datatype.string;
  Property timestamp As %ZEN.Datatype.string;
  Property username As %ZEN.Datatype.string(XMLPROJECTION = "element");
  
  

  

  この場合、XData ReportDisplay で ReportFooter 複合クラスを参照するには以下のように記述します。

  <my:ReportFooter class="table.mygroupfooter" timestamp="@timestamp">
    <my:username>@username</my:username>
  </my:ReportFooter>
  

  

Zen レポートのテンプレートの作成

Zen レポートのテンプレートは、XData ブロックを含む %ZEN.Report.Display.reportTemplateOpens in a new tab のサブクラスです。XData ブロック内には、テンプレート名と定義が含まれます。以下は、Header1 というテンプレートを定義する Zen レポートのテンプレート・クラスの例です。

Class ZENApp.HeaderTemplate Extends %ZEN.Report.Display.reportTemplate
{
  XData Header1
        [ XMLNamespace = "http://www.intersystems.com/zen/report/display" ]
  {
    <template>
      <header>
        <p class="banner1">HelpDesk Sales1 Report</p>
        <fo><line pattern="empty"/><line pattern="empty"/></fo>
        <table orient="row" width="3.45in" class='table1'>
          <item value="Sales by Sales Rep" width="2in">
            <caption value="Title:" width="1.35in"/>
          </item>
          <item field="@month" caption="Month:"/>
          <item field="@author" caption="Author:"/>
          <item field="@runBy" caption="Prepared By:"/>
          <item field="@runTime" caption="Time:"/>
        </table>
      </header>
    </template>
  }
} 

テンプレートは、実行時にのみインスタンス化されます。テンプレートを定義するときに実行時式やデータ項目を使用できます。ただし、テンプレートに使用している実行時式やデータ項目は、テンプレート・クラス自体では評価できず、テンプレートを呼び出すレポートや複合クラスのコンテキストで評価されます。前述のテンプレート例は、参照しているデータ項目 (@month、@author、@runBy、および @runTime) が、対応する XData ReportDefinition ブロックで生成した XML データに実際に存在する場合にのみ機能します。

Zen レポートのテンプレートの参照

以下の構文例は、前のセクションで取り上げたサンプル・テンプレートを参照しています。

<header template="ZENApp.HeaderTemplate:Header1" />

レポートに表示するコンテンツを指定する各要素、つまり <body> ブロックで指定できる各要素では、template 属性がサポートされています。表示要素のリストを確認するには、“Zen レポートのページのフォーマット” の章の <report> および <body> のセクションを参照してください。以下のテーブルでは、これらすべての要素でサポートされている template 属性を説明します。

通常、テンプレートを参照する場合、要素には template 以外の属性を指定しません。Zen では、template 属性と共に指定されたその他の属性の値は無視されるためです。上記の例の <header> 要素で、次のように width 属性も指定したとしましょう。

<header template="ZENApp.HeaderTemplate:Header1" width="7.25in" />

Zen では、この width 属性の値は無視され、代わりに Header1 テンプレート定義で指定されている幅の特性が、内容にかかわらず使用されます。テンプレートに width 値が見つからない場合、<header> 要素に指定した width 属性ではなく、Zen の既定値の幅が使用されます。

次の XData ReportDisplay ブロックのサンプルでは、この <header> 要素例を完全なコンテキストで示します。また、目的の出力が PDF であるため、この例では <document> 要素も指定しています。

XData ReportDisplay
      [ XMLNamespace = "http://www.intersystems.com/zen/report/display" ]
{
  <report xmlns="http://www.intersystems.com/zen/report/display"
          name='myReport' title='HelpDesk Sales Report' style='standard'>
    <document width="8.5in" height="11in"
              marginLeft="1.25in" marginRight="1.25in"
              marginTop="1.0in" marginBottom="1.0in"
              referenceOrientation="0">
    </document>
    <body>
      <header template="ZENApp.HeaderTemplate:Header1"/>
      <!-- OTHER ELEMENTS OF THE REPORT DISPLAY -->
    </body>
  </report>
}

スタイルを適用する XSLT テンプレートの呼び出し

XSLT テンプレートの一般的な使用方法の 1 つに、スタイルを適用するテンプレートを呼び出すことがあります。呼び出す適切な XSLT テンプレートは、出力形式によって異なります。以下のように、両方の出力固有ブロックで同じ名前を使用してテンプレートを定義します。

• XHTML 用には、ブロックの名前を XData HtmlXslt にします。

• PDF 用には、ブロックの名前を XData XslFoXslt にします。

次に例を示します。

XData HtmlXslt
{
  <xsl:template name="redeven" >
    <xsl:param name="num"/>
    <xsl:if test="$num mod 2 = 0">
      <xsl:attribute name='style'>color:red</xsl:attribute>
    </xsl:if>
  </xsl:template>
}

XData XslFoXslt
{
  <xsl:template name="redeven" >
    <xsl:param name="num"/>
    <xsl:if test="$num mod 2 = 0">
      <xsl:attribute name='color'>red</xsl:attribute>
    </xsl:if>
  </xsl:template>
}

これらのテンプレートを定義することによって、同じ Zen レポート・クラス内の XData ReportDisplay ブロックに、以下のような <item> を定義することができます。

<item field="@id" width=".7in" 
 style="border:none;padding-right:4px"
 stylecall="redeven" styleparams="@id" 
 styleparamNames="num" > </item>

以下はその説明です。

• stylecall 属性には、<xsl:template> の名前を指定しています。

• styleparamNames 属性には、<xsl:template> で指定した <xsl:param> の名前を指定しています。その他の名前を指定するには、セミコロンで区切ります。

• styleparams 属性には、そのパラメータに割り当てる値を指定する式を指定しています。styleparams 式には、リテラル値、ノード・セット、XPath 式、または XSLT 関数呼び出しを使用できます。XSLT の <xsl:with-param> の値として有効な値であれば、styleparams にも使用できます。複数の式を指定するには、セミコロンで区切ります。styleparamNames と styleparams の数は必ず一致しなければなりません。

結果として、偶数の ID を持つエントリは赤色になります。これらの属性の詳細は、“レポートの表示属性” セクションにある属性のテーブルを参照してください。

項目のレンダリング時の XSLT テンプレートの呼び出し

XSLT テンプレートを定義するには、Zen レポート・クラスの AllXslt、HtmlXslt、または XslFoXslt という XData ブロックにそのテンプレートを記述します。以下に例を示します。

XData AllXslt
{
<xsl:template name="sum">
  <!-- Initialize nodes to empty node set -->
  <xsl:param name="nodes"/>
  <xsl:param name="result" select="0"/>
  <xsl:choose>
    <xsl:when test="not($nodes)">
      <xsl:value-of select="$result"/>
    </xsl:when>
    <xsl:otherwise>
      <xsl:variable name="value" select="$nodes[1]"/>
       <!-- recursively sum the rest of the nodes -->
      <xsl:call-template name="sum">
        <xsl:with-param name="nodes" select="$nodes[position( ) != 1]"/>
        <xsl:with-param name="result" select="$result + $value"/>
      </xsl:call-template>
    </xsl:otherwise>
  </xsl:choose>
</xsl:template>
}

このテンプレートを定義することによって、同じ Zen レポート・クラス内の XData ReportDisplay ブロックに、以下のような <item> を定義することができます。

<item call="sum" params="Sale/@amount" paramNames="nodes">
  <caption value="Total Sales"/>
</item>

以下はその説明です。

• call 属性には、<xsl:template> の名前を指定しています。

• paramNames 属性には、<xsl:template> で指定した <xsl:param> の名前を指定しています。その他の名前を指定するには、セミコロンで区切ります。

• params 属性には、そのパラメータに割り当てる値を指定する式を指定しています。params 式には、リテラル値、ノード・セット、XPath 式、または XSLT 関数呼び出しを使用できます。XSLT の <xsl:with-param> の値として有効な値であれば、params にも使用できます。複数の式を指定するには、セミコロンで区切ります。paramNames と params の数は必ず一致しなければなりません。

call を使用して <item> の値を取得する場合、<item> 文の中で formatNumber 属性を使用して結果をフォーマットすることはできません。代わりに、call 属性で参照している <xsl:template> の中で XSLT の format-number 関数を使用します。以下の XData AllXslt ブロックの例では、この規則を示しています。

XData AllXslt
{
<xsl:template name="mypct">
    <xsl:param name="num"/>
    <xsl:param name="denom"/>
    <xsl:variable name="v1" select="$num[1]"/>
    <xsl:variable name="v2" select="$denom[1]"/>
    <xsl:choose>
        <xsl:when test="$v2 != 0">
            <xsl:value-of 
    select="format-number(round(($v1 div $v2)*10000) div 10000,'##,###.00%')"/>
        </xsl:when>
        <xsl:otherwise>
             <xsl:value-of select="format-number(0,'##,###.00%')"/>
         </xsl:otherwise>
     </xsl:choose>
</xsl:template>
}

call、paramNames、および params の各プロパティは、<item> 要素でのみサポートされています。これらの属性の詳細は、“<item>” セクションにある属性のテーブルを参照してください。