USXSL.SetGlobalXsl

note

This article is about the SetGlobalXsl method of the USXSL internal component.

USXSL.SetGlobalXsl

Associates a global alias with a parsed XSL document that is held in-memory after it is first referred to. In subsequent calls to USXSL.Apply and USXSL.Apply2File, you can refer to the XSL document by using the alias.

The point of using this method is that, if you need the same XSL document more than once, referring to its parsed version by alias may improve performance.

Returns the alias as a string. If the passed XSL document is invalid, an error is returned.

Syntax

SELECT   USXSL.SetGlobalXsl(
    *alias,   xsl-document*
)

where alias and xsl-document are required.

alias is case-sensitive and acts as a handle for identifying the opened file in subsequent calls to USXSL.Apply or USXSL.Apply2File.

xsl-document is the input XSL document (stylesheet, transformation). If xsl-document is the empty string, the alias-document mapping is removed from the list.

When a Rules Service runs multiple Rules Engines, you can have the first Rules Engine use USXSL.SetGlobalXsl() to map an alias to an XSL document, and subsequent Rules Engines reference that alias. By contrast, this is not possible with mappings that were made using the USXSL.SetXsl method.