--- title: "XPathによるXMLレポートの機能拡張" date: "2012-04-17" categories: - "xpath" tags: - "charts" - "localization" - "stylevision" - "xpath" description: Altova StyleVisionを使って、XPathを活用してGPS XMLレポートをより効果的に活用する方法を学びましょう。数値の計算、日付のフォーマット、そしてグラフのカスタマイズについて、実践的な知識を習得できます。 --- Status: #blog Tags: #charts #localization #stylevision #xpath Categories: [xpath+xquery](/blog/ja/category/xpathxquery.md) # XPathによるXMLレポートの機能拡張 前回の記事では、...について解説しました [GPS XMLデータを用いた、洗練されたレポートの作成](https://www.altova.com/blog/2012/04/creating-elegant-reports-for-gps-xml.html) 標高線グラフを作成するために、XMLドキュメントから特定のノードを選択するためにXPath式を使用しました。XPathは、値の計算にも利用できます。 [Altova StyleVision](https://www.altova.com/ja/stylevision.html) XPathに対する強力なサポートが含まれており、XPath式を利用することで、GPSのXMLレポートに興味深い情報を追加することができます。例えば、GPSデバイスが記録した標高データをメートル単位から読み込み、それをフィート単位に変換して、海抜からの高さをグラフで表示することができます。 ![Altova StyleVision の折れ線グラフ](https://lh5.ggpht.com/-gSbmsmf1ZRY/T6FNDIQzqkI/AAAAAAAAAyg/1u_NWXO1IlM/clip_image001%25255B1%25255D.png?imgmax=800 "Altova StyleVision line chart") メートルをフィートに変換する式は、(メートル × 3.2808399) = フィート です。この計算は、グラフ設定ダイアログで利用できます 次に、取得したデータに基づいて計算を行い、その結果を用いてグラフを作成します。 **XPathの時間関数** 当社のグラフには、X軸の目盛りの定義が含まれていないことに気づかれたかもしれません。これは意図的なものです。GPSデバイスは、数秒ごとに位置情報を記録するため、X軸から目盛りと値を意図的に省略しました。今回の氷上登山に関するデータファイルには、1,800以上の高度データが含まれており、その膨大なデータ量によって、目盛りが連続した線として表示されてしまいました。また、値の表示スペースも十分ではありませんでした。 しかし、ハイキングにかかった時間を知ることができれば、もっと興味深いレポートになるでしょう。StyleVisionの自動計算機能を活用することで、その情報をレポートに組み込むことができます。以下に示すデザインの例では、レポートに「挿入」→「自動計算」→「値」というメニューオプションから3つの自動計算要素を追加し、説明的なテキストを追加しています。 ![StyleVisionの自動計算機能を持つ要素](https://lh5.ggpht.com/-uXZIbSXcnbw/T41tCgrdCqI/AAAAAAAAAys/4EJATOgpRFI/clip_image003%25255B1%25255D.png?imgmax=800 "StyleVision AutoCalc elements") 任意の自動計算要素を右クリックすると、メニューが表示され、その中に「XPathの編集」ダイアログへのアクセスが可能です。以下に、縮小表示したダイアログの例を示します。このウィンドウにXPath式を直接入力することもできますし、要素、演算子、関数の一覧から選択してXPath式を構築することもできます。 旅行の経過時間を計算するには、XPathの関数 `max(anyAtomicType)` と `min(anyAtomicType)` を使用し、各トラップポイントの `time` 要素に対してXPath式を適用することで、トラックに記録された最も早い時間と最も遅い時間を特定できます。最も遅い時間から最も早い時間を差し引くことで、経過時間を計算できます。 ![StyleVision XPath エディタのダイアログボックス](https://lh4.ggpht.com/-6far6GBn_X0/T41tDmS8KpI/AAAAAAAAAyw/y3OtXvCrqRc/clip_image004%25255B1%25255D.png?imgmax=800 "StyleVision XPath edit dialog") オート計算の右クリックメニューにある別の項目を選択すると、「値の書式設定」ダイアログが開き、計算結果のデータ型に適した様々な書式をすぐに選択できます。 ![AutoCalcの結果に対する、StyleVisionの書式設定ダイアログ](https://lh6.ggpht.com/-kH8H4z9bW6Q/T41tEVMLc7I/AAAAAAAAAy0/NaG1nrLMQZY/clip_image005%25255B1%25255D.png?imgmax=800 "StyleVision Value Formatting dialog for AutoCalc result") また、`min()`関数や`max()`関数を使って、出発時刻と到着時刻を選択することも可能ですが、GPSデバイスが記録するデータは協定世界時（GMT）で、今回のハイキングはアメリカ合衆国の東部標準時（Eastern Standard Time）で行われ、現地時間は5時間遅れています。 幸いなことに、XPathには、dateTime値を別のタイムゾーンに調整するための特別な関数 `adjust-dateTime-to-timezone()` が用意されています。以下に、出発時刻を調整するために使用した式を示します **`adjust-dateTime-to-timezone(最小( $XML/n1:gpx/n1:trk/n1:trkseg/n1:trkpt/n1:time ), xs:dayTimeDuration('-PT5H') )`** 注意点として、調整期間は文字列として入力する必要があり、かつ、明示的に「dayTimeDuration」というデータ型として宣言する必要があります。 値の書式設定ダイアログを使用することで、出発時刻と到着時刻を、より馴染みのある形式で表示することができます ![日付と時刻のデータ形式の設定](https://lh5.ggpht.com/-iRof_1PEOr0/T41tFgbR_oI/AAAAAAAAAy4/0x1-QSpyFIE/clip_image006%25255B1%25255D.png?imgmax=800 "Value Formatting a dateTime result") GPS XMLレポートに関して、XPathの機能強化をさらに一つ追加しました。弊社の [以前の投稿について](https://www.altova.com/blog/2012/04/creating-elegant-reports-for-gps-xml.html) スタイルビジョンプロジェクトと標準化されたファイル名を使用することで、SPSファイルを変更することなく、複数のデータファイルに対してレポートを生成する手法について説明しました。また、StyleVisionBatchユーティリティや、さらにStyleVision APIを利用することで、SPSスタイルシートを通じて処理を自動化し、様々な形式のレポートを作成することも可能です。 **グラフファイル名** HTML形式の出力を作成し保存する場合、メインのレポートはHTMLドキュメントであり、グラフは個別の画像ファイルとして保存されます。グラフのファイル名を「グラフ設定」ダイアログで指定できますが、サーバー上の同じフォルダに複数のHTMLレポートを保存したい場合は、それぞれのグラフに対して異なるファイル名が必要になります。そうしないと、新しいグラフが作成されるたびに、デフォルトのファイル名が使用され、以前のバージョンが上書きされてしまいます。 ![スタイルビジョン チャート ファイル名 指定ダイアログ](https://lh6.ggpht.com/-AgmhHehVq4Q/T41tGeEH85I/AAAAAAAAAy8/58M0UkyBBgs/clip_image007%25255B1%25255D.png?imgmax=800 "StyleVision chart file name dialog") 「カスタムファイル名」オプションを使用すると、XPath式を使って、画像ファイルの名前を別の名前に指定することができます。簡単な解決策としては、ランダムな数値を生成し、それを文字列に変換して、その文字列をファイル名に挿入する方法が考えられます。 しかし、それはできません。なぜなら、XPathには乱数を生成する`random()`関数が含まれていないからです。 代わりに、2つの追加のXPath時間関数を組み合わせることで、疑似乱数文字列を生成できます。`seconds-from-time()`関数は、任意の値を秒とミリ秒で返します。また、`current-time()`関数は、現在のシステム時間を時間、分、秒、ミリ秒で返します。 画像ファイルの設定ダイアログで、XPath式に「現在時刻からの秒数 (current-time())」という情報を埋め込むことで、HTMLの結果が生成された正確な秒数とミリ秒に基づいてファイル名を生成することができます。ファイル名を生成するためのXPath式の完全な記述は以下のようになります ![XPath式に基づいて、カスタムチャートのファイル名を指定します](https://lh3.ggpht.com/-eKYGKDgTE3Y/T41tG5rSf_I/AAAAAAAAAzA/mfzA2xHPfCs/clip_image008%25255B1%25255D.png?imgmax=800 "Custom chart file name based on an XPath expression") 生成されたHTMLファイルを保存すると、StyleVisionは、メインのドキュメントと共に作成されたすべての追加ファイルを報告します ![XPath式に基づいて生成された疑似乱数ファイル名](https://lh5.ggpht.com/-lFtknXRCRx0/T41tHYy-d4I/AAAAAAAAAzE/rXLms4KlLFE/clip_image009%25255B1%25255D.png?imgmax=800 "Pseudo-random file name generated based on XPath expression") **ルートマップの画像ファイル名** 旅行レポート用の複数のHTMLページを作成する場合、それぞれの旅行に対応した異なるルートマップの画像を参照する必要があります。XPathはこの作業にも役立ちます。当初、私たちは特定のファイル名を用いたURLで地図画像を挿入していましたが、代わりに、スタイルシートが処理される際に渡されるパラメータとして、画像ファイル名を定義することができます。 「編集 / スタイルシートパラメータ」メニューを選択すると、「パラメータ編集」ダイアログが開きます。このダイアログでは、スタイルシートのすべてのパラメータを一元的に管理できます。以下に示すスクリーンショットでは、「routeMapFile」というパラメータを追加し、そのデフォルト値を設定しています。 ![スタイルビジョン編集パラメータウィンドウ](https://lh4.ggpht.com/-RNgIJCRUynk/T41tJ9qjtbI/AAAAAAAAAzI/xRMtQEP7KUs/clip_image010%25255B1%25255D.png?imgmax=800 "StyleVision Edit Parameters window") これで、このパラメータを使って、ルートマップファイルを指定することができます。画像編集ダイアログには、画像の配置場所を定義するための4つのオプションがあります。以下に示すスクリーンショットでは、特定のフォルダパスと動的なファイル名に対して、「静的」と「動的」のタブを選択しています。 ![画像ファイル名にパラメータを割り当てる](https://lh4.ggpht.com/-Fpvq94Ozbhw/T41tKTSpdvI/AAAAAAAAAzM/4niINvq5I7U/clip_image011%25255B1%25255D.png?imgmax=800 "Assigning a parameter to an image file name") レポートを任意の形式で生成する際に、`routeMapFile` パラメータに新しい値を指定することができます。新しい値を指定しない場合、編集パラメータダイアログで定義されているデフォルト値が使用されます。 さて、ここで、StyleVisionをバッチモードで実行し、異なるルートマップ画像を使用するためのコマンドラインを作成できます ![スタイルビジョンをバッチモードで実行するためのコマンドライン（パラメータ付き）](https://lh6.ggpht.com/-9pYl5bC12Bs/T41tLKn4VnI/AAAAAAAAAzQ/ByarXQ-ZdcE/clip_image012%25255B1%25255D.png?imgmax=800 "Command line to execute StyleVision in batch mode with a parameter") また、パラメータを使用してグラフの背景色を指定することも可能です。さらに、コマンドラインオプションを使用することで、スタイルシートで定義されている既存のXMLファイルを、別の入力XMLファイルに置き換えることもできます。これらのパラメータとコマンドラインオプションにより、StyleVisionBatchは、同じスタイルシートを使用して、さまざまなデータセットに対してレポートを生成するのに非常に優れたツールとなります。 以下に、XPathによる改善をすべて適用した、アイスクライミングツアーのデータに関するHTMLプレビューを示します ![XPathの機能拡張を施したレポートのHTMLプレビュー](https://lh5.ggpht.com/--MSr3CqE-Uo/T41tLuthPCI/AAAAAAAAAzU/RyC_Ff9hN6M/clip_image014%25255B1%25255D.jpg?imgmax=800 "HTML preview of the report with XPath enhancements") GPSのXMLファイルに基づいて独自のレポートを作成したり、その他のXMLレポート、電子フォーム、またはマルチチャネルでの公開といった要件を洗練された方法で実現したりするには、[Altova StyleVisionの無料トライアルをこちらからお試しください](https://www.altova.com/ja/download/stylevision/db_xslt_stylesheet_designer_enterprise.html)