Altova XMLSpy 2021 Professional Edition

Altova 拡張関数はXPath/XQuery 式で使用することができ、 XPath、 XQuery、および XSLT 関数の標準ライブラリで使用可能な機能に更なる機能性を与えます。 Altova 拡張関数はAltova 拡張関数名前空間、 http://www.altova.com/xslt-extensions に収められており、 altova:プレフィックスが、このセクションでは使用されます。製品の今後のバージョンが拡張機能への継続的サポート、または個別の関数の振る舞いは変更する可能性があることに注意してください。 Altova 拡張機能へのサポートに関しては、今後のリリースのドキュメントを参照してください。

altova:distinct-nodes(node()*) を node()* とする   XSLT1 XSLT2 XSLT3

入力として１つ以上のノードを必要とし、同じセットから重複した値を持つノードを除いたノードを返します。 XPath/XQuery 関数 fn:deep-equal を使用して比較を行うことができます。

サンプル

altova:evaluate(XPathExpression as xs:string[, ValueOf$p1, ... ValueOf$pN])   XSLT1 XSLT2 XSLT3

XPath 式を必要とし、必須引数として文字列をパスします。評価された式の出力を返します。 例えば: altova:evaluate('//Name[1]') は、ドキュメント内の最初の Name 要素のコンテンツを返します。式 //Name[1] は、一重引用符を使用することにより、文字列としてパスされます。

altova:evaluate 関数は、オプションとして追加の引数を持つことができます。これらの引数は、 p1, p2, p3... pN の名前を持つスコープ内の変数の値です。使用に関して以下の点に注意してください: (i) 変数は、 X が整数である箇所のフォーム pX の名前と共に定義される必要があります。(ii) altova:evaluate 関数の引数は、 (上の署名参照) 2 番目の引数からは、数値順の変数のシーケンスに対応した引数のシーケンス変数の値を与えます: p1 to pN: 第 2 引数は変数 p1 の値で、第 3 引数は、変数 p2 の値です。 (iii) 変数の値は型 item* である必要があります。

サンプル

変数の使用方法を更に説明するサンプル

altova:evaluate() 拡張関数は、 XSLT  スタイルシート内のXPath 式が動的に評価される必要のあるシチュエーションで役に立ちます。例えば、ユーザーが並べ替えの必要条件をリクエストする場合、このシチュエーションは属性 UserReq/@sortkey に保管されます。スタイルシートでは、以下の式が使用できます: <xsl:sort select="altova:evaluate(../UserReq/@sortkey)" order="ascending"/>。 altova:evaluate() 関数は、コンテキストノードの親の UserReq 子要素の sortkey 属性を読み込みます。 sortkey 属性の値が Price の場合、 Price は、altova:evaluate() 関数により返され、 select 属性 <xsl:sort select="Price" order="ascending"/> の値になります。この sort 命令が、 Order という要素のコンテキスト内で発生する場合、 Order 要素は Price の子の値に従い並べ替えられます。また、 @sortkey の値が、 Date の場合、 Order 要素は、 Date の子の値に従い並べ替えられます。ですから、 Order の並べ替えの条件は、ランタイムでの sortkey 属性から選択されます。これは、以下の式などでは達成することはできません: <xsl:sort select="../UserReq/@sortkey" order="ascending"/>。上の場合、並べ替え条件は sortkey 属性自身であり、 Price または Date (または、現在の sortkey のコンテンツ) ではありません。

追加サンプル

altova:encode-for-rtf(input as xs:string, preserveallwhitespace as xs:boolean, preservenewlines as xs:boolean) を xs:string とする XSLT2 XSLT3

RTF のためのコードに入力文字列を変換します。空白と新しい行は、それぞれの引数により指定される boolean の値に基づき保管されます。

altova:xbrl-footnotes(node()) を node()* とする XSLT2 XSLT3

ノードを入力引数として必要とし、入力ノードに参照される XBRL フットノート ノードを返します。

altova:xbrl-labels(xs:QName, xs:string) を node()* とする XSLT2 XSLT3

以下の 2 つの入力引数を必要とします: ノード名とノードを含むタクソノミファイルロケーション。関数は、入力ノードと関連した XBRL ラベルノードを返します。