Scope (root node, context) of XSLT "key" Element - xslt

I have an XSLT key defined. I need to access the key from within a for-each loop, where that loop is processing a node-set that is outside the scope of where the key was defined.
Snippet, where I've marked two lines, one which works and one which does not:
<xsl:value-of select="key('name', 'use')"/> <!-- works -->
<xsl:for-each select="$outOfScopeNodeSet">
<xsl:value-of select="key('name', 'use')"/> <!-- does not work -->
</xsl:for-each>
Is there a way to access the key from within the for-each loop?
XSLT 1.0, msxsl engine.
(I could not think of a reasonable way to provide a full working example for this. I'm also not sure of the correct terminology, such as "scope" - perhaps if I knew the correct terminology I'd be able to find my answer already. If the question is not clear enough please let me know and I'll try to edit it into better shape.)

In XSLT 1.0, keys do not work across documents. It seems that your $outOfScopeNodeSet contains a node-set whose root node is different from the root node of the XML document being processed (probably created by the exsl:node-set() function?) - while the key is supposed to fetch a value from the processed XML document.
To resolve this problem, you need to return the context back to the processed XML document before calling the key() function, for example:
<xsl:variable name="root" select="/" />
<xsl:for-each select="$outOfScopeNodeSet">
<xsl:variable name="use" select="some-value" />
<xsl:for-each select="$root">
<xsl:value-of select="key('name', $use)"/>
</xsl:for-each>
</xsl:for-each>

Related

Passing a node as parameter to a XSL stylesheet

I need to pass a node as a parameter to an XSL stylesheet. The issue is that the parameter gets sent as a string. I have seen the several SO questions regarding this topic, and I know that the solution (in XSLT 1.0) is to use an external node-set() function to transform the string to a node set.
My issue is that I am using eXist DB I cannot seem to be able to get its XSLT processor to locate any such function. I have tried the EXSLT node-set() from the namespace http://exslt.org/common as well as both the Saxon and Xalan version (I think eXist used to use Xalan but now it might be Saxon).
Are these extensions even allowed in the XSLT processor used by eXist? If not, is there something else I can do?
To reference or transform documents from the database, you should pass the path as a parameter to the transformation, and then refer to it using a parameter and variable
(: xquery :)
let $path-to-document := "/db/test/testa.xml"
let $stylesheet :=
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:param name="source" required="no"/>
<xsl:variable name="error"><error>doc not available</error></xsl:variable>
<xsl:variable name="theDoc" select="if (doc-available($source)) then doc($source) else $error"/>
<xsl:template match="/">
<result><xsl:value-of select="$source"/> - <xsl:value-of select="node-name($theDoc/*)"/></result>
</xsl:template>
</xsl:stylesheet>
return transform:transform(<dummy/>,$stylesheet, <parameters><param name="source" value="xmldb:exist://{$path-to-document}"/></parameters>)
As per Martin Honnen's comments I don't think it is possible to pass an XML node via the <parameters> structure of the transform:transform() function in eXist. The function seems to strip away any XML tags passed to it as a value.
As a workaround I will wrap both my input XML and my parameter XML into a root element and pass that as input to the transform function.

XSLT 1.0: Passing _all_ parameters in 'pass-through' template (ie tunneling)

Please forgive the poor nomenclature in this, probably why I'm struggling to google an answer.
Basically I am asking if parameter tunneling from xslt 2.0 has any analogue in 1.0, or if there is a clever way to get 'some way there'. I'm using msxsl
Suppose I have a template like so:
<xsl:template name="outer">
<xsl:apply-templates>
<xsl:with-param name="x" select="y"/>
</xsl:apply-templates>
</xsl:template>
If the apply-templates call gets picked up directly by a template that knows about the parameter then all is good, but suppose we have some general templates to ignore certain elements and process their children:
<xsl:template match="tag_to_ignore">
<xsl:apply-templates/>
</xsl:template>
if these are 'hit' OR when the tag_to_ignore is not explicitly matched and XSLT does its default apply templates to children behaviour
the parameters are 'lost'
is there anyway to tell a template to 'accept' all parameters it was passed and pass them down?
(ie the real code there are many, many, params that could come in and potentially need to be passed out, trying to avoid a maintenance issue of having to accept every possible para and explicitly pass it on)
In XSLT 2.0 you can use tunnel parameters but in XSLT 1.0 there is no such feature.
Actually, I had a similar issue before I heard about tunnelling parameters and solved it by adding the same parameters to the one-off template, then passing it back out in that apply-templates. For instance, in your case
<xsl:template match="tag_to_ignore">
<xsl:param name="x"/>
<xsl:apply-templates>
<xsl:with-param name="x" select="$x" />
</xsl:apply-templates>
</xsl:template>
I THINK this will work in XSLT 1.0, but I'm fairly new to all this myself.

Is there a way to remove all attributes from an XSLT attribute set when overriding that attr set?

I'm working with some third-party XSLT that makes heavy use of attribute sets for transforming XML to various forms of XSL:FO. Example:
notes.xsl:
<xsl:template match="note">
<fo:block xsl:use-attribute-sets="noteAttrs">
<!-- This is a pretty big template with lots of xsl:choose/xsl:if/etc. -->
</fo:block>
<xsl:template>
<xsl:attribute-set name="noteAttrs">
<xsl:attribute name="margin-left">10px</xsl:attribute>
<xsl:attribute name="margin-right">8px</xsl:attribute>
<xsl:attribute name="margin-top">5px</xsl:attribute>
<xsl:attribute name="font-size">10pt</xsl:attribute>
<!-- several other attributes -->
</xsl:attribute>
The idea is that I import this XSLT, redefining the attribute sets as I see fit. If I just need a different font size for a given .fo document...
<xsl:import href="notes.xsl"/>
<xsl:attribute-set name="noteAttrs">
<xsl:attribute name="font-size">12pt</xsl:attribute>
</xsl:attribute>
The problem is that sometimes I need to flat out remove attributes (i.e. so I inherit from the containing fo:block), or a given fo document is going to be so different that it would be easier to start fresh instead of merge my attribute set with the one from notes.xsl. Is there a way in XSLT 2.0 to do that without reproducing the entire template for note and specifying a different attribute set on the fo:block? I guess I'm looking to be able to do something like this:
<xsl:import href="notes.xsl"/>
<xsl:attribute-set name="noteAttrs" merge_with_imported_attr_set="false">
<xsl:attribute name="font-size">12pt</xsl:attribute>
</xsl:attribute>
I can't switch to an XSLT 3.0 processor immediately, but if there's something new in 3.0 that enables this, I'd love to know about it.
Thanks!
Attribute sets are not very widely used and to answer your question I had to look at the spec to refresh my memory. I don't think there is any way of achieving what you are wanting; you can't really override an attribute set in an importing stylesheet, you can only supplement it. In a well-designed XML vocabulary there is usually an attribute value you can set that is equivalent to omitting the attribute, but if that's not the case then you are stuck.

BizTalk HL7 send pipeline error due to line breaks in empty XML elements

I am mapping to an HL7 A31 message using the BizTalk mapper. The map has several inline XSLT scripting functoids.
When the XML is put through the HL7 send pipeline, it generates an error:
The element 'ROL_11_OfficeHomeAddress' has an invalid structure
If I look at the suspended message, I can see why this has happened. The ROL_11 element is empty, and looks like this:
<ROL_11_OfficeHomeAddress>
</ROL_11_OfficeHomeAddress>
Between the opening and closing tags, there is a line break and several spaces/tabs due to indenting. This is exactly as generated by the XSLT and I believe it is the line break that is causing the error.
I could wrap the XSLT in an <xsl:if> statement to check for a value before writing the XML. However this problem is occurring in many places and it seems overkill to wrap every single element like this.
What I really want is for BizTalk to automatically convert the element to an empty one, like this:
<ROL_11_OfficeHomeAddress />
I believe this would solve the problem. Is there any way I can tell it to do that?
Things I have already tried:
Using <xsl:strip-space> but that raised its own error. I think this is because BizTalk wraps the inline XSLT in its own code and thus strip-space was specified in the wrong place.
Changing the map's grid properties to set Indent to No in the hope the whitespace would be removed. This had no effect on the XML seen in the suspended message.
Adding the registry key for legacy whitespace handling as per this guidance. Again, this appeared to have no effect at all.
If you convert your entire map into XSLT, the below will strip out newlines and whitespace and leave you with an empty tag if there isn't anything but whitespace:
<xsl:element name="ROL_11_OfficeHomeAddress">
<xsl:if test="normalize-space(ROL_11_OfficeHomeAddress)">
<xsl:value-of select="normalize-space(ROL_11_OfficeHomeAddress)" />
</xsl:if>
</xsl:element>
Edit:
Biztalk usually generates XSLT like the following in a typical 1:1 nillable element mapping
<xsl:variable name="var:v2" select="string(ns0:ROL_11_OfficeHomeAddress/#xsi:nil) = 'true'" />
<xsl:if test="string($var:v2)='true'">
<ns0:ROL_11_OfficeHomeAddress>
<xsl:attribute name="xsi:nil">
<xsl:value-of select="'true'" />
</xsl:attribute>
</ns0:ROL_11_OfficeHomeAddress>
</xsl:if>
<xsl:if test="string($var:v2)='false'">
<ns0:ROL_11_OfficeHomeAddress>
<xsl:value-of select="ROL_11_OfficeHomeAddress/text()" />
</ns0:ROL_11_OfficeHomeAddress>
</xsl:if>
So if you did use <xsl:strip-space> it would mean that the element would map to <ROL_11_OfficeHomeAddress></ROL_11_OfficeHomeAddress> if whitespace only, unless you went through the map changing it back to <xsl:element>.
What you could try is to use a call template like the below (nodeXfrm is a node)
<xsl:template name="StripElement">
<xsl:param name="nodeXfrm"></xsl:param>
<xsl:variable name="nodeName">
<xsl:value-of select="local-name($nodeXfrm)"></xsl:value-of>
</xsl:variable>
<xsl:element name="{$nodeName}">
<xsl:if test="normalize-space($nodeXfrm)!=''">
<xsl:value-of select="$nodeXfrm/text()"/>
</xsl:if>
</xsl:element>
</xsl:template>
And then within your map you can call the template for each element you need stripped in this way
<xsl:call-template name="StripElement">
<xsl:with-param name="nodeXfrm" select="ROL_11_OfficeHomeAddress"></xsl:with-param>
</xsl:call-template>
An XSLT guru might be able to do this more elegantly
I too was recently having this problem, but in BizTalk 2013. We moved everything to custom XSLT files for mapping our HL7v2. Upon upgrading to 2013, suddenly the <xsl:strip-space> that previously worked, no longer worked.
This is because BizTalk 2013 now uses the XslCompiledTransform class rather than the now obsoleted XslTransform class and it doesn't allow the <xsl:strip-space>. So I too was faced with no global way to strip the whitespace.
However, after much searching and head scratching, I found an obscure blog post with something that worked for my solution:
http://geekswithblogs.net/peterbrouwer/archive/2012/08/17/biztalk-2010ndashlegacy-whitespace-behaviour.aspx
An option in the the Host's settings, for using legacy whitespace did it for us (so far at least).

How do I check for the existence of an external file with XSL?

I've found a lot of examples that reference Java and C for this, but how do I, or can I, check for the existence of an external file with XSL.
First, I realize that this is only a snippet, but it's part of a huge stylesheet, so I'm hoping it's enough to show my issue.
<!-- Use this template for Received SMSs -->
<xsl:template name="ReceivedSMS">
<!-- Set/Declare "SMSname" variable (local, evaluates per instance) -->
<xsl:variable name="SMSname">
<xsl:value-of select=" following-sibling::Name"/>
</xsl:variable>
<fo:table font-family="Arial Unicode MS" font-size="8pt" text-align="start">
<fo:table-column column-width=".75in"/>
<fo:table-column column-width="6.75in"/>
<fo:table-body>
<fo:table-row>
<!-- Cell contains "speakers" icon -->
<fo:table-cell display-align="after">
<fo:block text-align="start">
<fo:external-graphic src="../images/{$SMSname}.jpg" content-height="0.6in"/>
What I'd like to do, is put in an "if" statement, surronding the {$SMSname}.jpg line. That is:
<fo:block text-align="start">
<xsl:if test="exists( the external file {$SMSname}.jpg)">
<fo:external-graphic src="../images/{$SMSname}.jpg" content-height="0.6in"/>
</xsl:if>
<xsl:if test="not(exists( the external file {$SMSname}.jpg))">
<fo:external-graphic src="../images/unknown.jpg" content-height="0.6in"/>
</xsl:if>
</fo:block>
Because of "grouping", etc., I'm using XSLT 2.0. I hope that this is something that can be done. I hope even more that it's something simple.
As always, thanks in advance for any help.
LO
For anyone else who might stumble upon this old question, by piecing together information from various sources on the internet, I came up with this XSLT2 function that uses a Java extension for checking whether a file exists:
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:java="http://www.java.com/"
exclude-result-prefixes="java xs">
<xsl:function name="java:file-exists" xmlns:file="java.io.File" as="xs:boolean">
<xsl:param name="file" as="xs:string"/>
<xsl:param name="base-uri" as="xs:string"/>
<xsl:variable name="absolute-uri" select="resolve-uri($file, $base-uri)" as="xs:anyURI"/>
<xsl:sequence select="file:exists(file:new($absolute-uri))"/>
</xsl:function>
</xsl:stylesheet>
You can then use the function like this:
<xsl:if test="java:file-exists($filename, base-uri())">
<!-- ... -->
</xsl:if>
This works at least with Saxon 9.1.0.5J — haven't tested it with any other XSLT processors.
Note: If the file for whose existence you're checking is an XML file and you're using XSLT2, you can also use the built-in doc-available() function:
<xsl:if test="doc-available('hello_world.xml')">
<!-- ... -->
</xsl:if>
No, this cannot be done using XSLT 2.0/XPath 2.0.
The XSLT 2.0 function unparsed-text-available() is only suitable for locating text files and even if a text file with the specifies URI exists this function may return false(), because it also must read the contents of the file and check that it only contains allowed characters.
From the spec:
"The unparsed-text-available function determines whether a call on the unparsed-text function with identical arguments would return a string.
If the first argument is an empty sequence, the function returns false. If the second argument is an empty sequence, the function behaves as if the second argument were omitted.
In other cases, the function returns true if a call on unparsed-text with the same arguments would succeed, and false if a call on unparsed-text with the same arguments would fail with a non-recoverable dynamic error.
Note:
This requires that the unparsed-text-available function should actually attempt to read the resource identified by the URI, and check that it is correctly encoded and contains no characters that are invalid in XML
"
End of quotation.
In case someone else needs it and is using fop, I would like to share this answer since it worked for me like a charm.
I've found a solution:
<xsl:when test="fs:exists(fs:new('myfile.html'))" xmlns:fs="java.io.File">
<!-- do something here... -->
</xsl:when>
and it works independently of XSLT 1.0 or 2.0
EDIT: Use unparsed-text-available function. It is part of xslt 2.0, but not XQuery or standalone XPath.
I've left my previous answer here so you can follow the trail of uncertainty...
I don't believe there is a way of doing this in XSLT using the standard functions. You can do it using extension functions, as described here, for java.
There is the unparsed-text-available function, but I'm unsure if this is a standard function. There's an example of it's usage at Zvon. The unparsed-text-available is mentioned here as being part of xslt 2.0, and is supported in Saxon.
A proposed File Module EXPath specification would support file-system functions such as this (file:exists() in the spec) as standard XPath extension functions. There isn't yet an XSLT implementation for this, but its worth watching.
Back to pgfearo's notice.
A proposed File Module EXPath specification would support file-system
functions such as this (file:exists() in the spec) as standard XPath
extension functions. There isn't yet an XSLT implementation for this,
but its worth watching.
For those who need to check if an file exists or not.
file:exists($path as xs:string)
works fine now.
If you still wants to do it in XSLT here is the solution, I have done it for myself as explained below.
This will not working with regular java.io.File class in XSLT. So I have used java.nio.file.Files class.
JARS required - servelt.jar
w: is the namespace of the our own Java class where pathFromURI method is defined.
Code:
<xsl:variable name="fileURI" select="u:new($absoluteFilePath)" xmlns:u="java:java.net.URI"/>
<xsl:variable name="filePathFromURI" select="w:pathFromURI($fileURI)"/>
<xsl:variable name="fileNotExist" select="not(files:exists($filePathFromURI, /..)) or files:size($filePathFromURI) = 0"/>
public static java.nio.file.Path pathFromURI(java.net.URI uri) throws Exception {
return java.nio.file.Paths.get(uri);
}
It can't solely be done by standard XSLT, you have to use an extention function or some annoying workaround. There are two methods using extension functions: use of standard java/.NET for custom functions (works with some versions of Saxon, AltovaXML, and others), or use of processor specific extension functions, like saxon:file-last-modified()/saxon:last-modified(). You can find some sample code here, look for intern:file-exists().
If you can't use extension functions, you can either generate an XML file externaly which contains informations about your file system and pass it to your stylesheet, or you can wrap binary images within SVG and than use fn:doc-available().
If you need to check for the existence of an XML file, use an external entity and an inline doctype:
<!DOCTYPE foo [ <!ENTITY bar SYSTEM "baz.xml"> ]>
Then add the entity to the stylesheet:
&bar;
The processor will timeout if the file is not found.
If you know the files exist but want to dynamically load one out of many, use the concat function and a choose/when block:
<xsl:variable name="page_name">
<xsl:choose>
<xsl:when test="$page = 1">
<xsl:value-of select="'page1.xml'"/>
</xsl:when>
<xsl:when test="$page = 2">
<xsl:value-of select="'page2.xml'"/>
</xsl:when>
<!--...-->
<xsl:when test="$page = 9">
<xsl:value-of select="'page9.xml'"/>
</xsl:when>
<xsl:when test="$page = 10">
<xsl:value-of select="'page10.xml'"/>
</xsl:when>
<xsl:otherwise>
<xsl:value-of select="'page0.xml'"/>
</xsl:otherwise>
</xsl:choose>
</xsl:variable>
<xsl:variable name="agree" select="document(concat('include/pages/',$page_name))//processing-instruction()"/>
References
XML External Entity (XXE) Processing
For anyone who needs plain XSLT solution for checking if file exist you can just use
unparsed-text-available(concat(system-property('user.dir'),'/filename.text'))
or wrap it into a function
<xsl:function name="functx:file-exists" xmlns:functx="http://www.functx.com">
<xsl:param name="path"/>
<xsl:value-of select="unparsed-text-available(concat(system-property('user.dir'),'/',$path))"/>
</xsl:function>
using this unparsed-text-available(concat(system-property('user.dir'),'/filename.text'))=false() will mean that file does not exist.
Have fun!