Resource to workflow variable
With the workflow component, Resource to workflow variable (which is a shortcut component of the other category), you can read a resource from the library and store it in a workflow variable. A related component is: From file to workflow variable.
The component has these parameters:
Content type
The "content type" select the resource type that you want to read from the Library. You can select the type from the drop down list or even click on the icon on the right to build an XPath expression, that returns the type. The type refer to the "sub-folders" of the library.
Path and file name
The "path and filename" set the path and filename of the resource that you want to read. The path is the relative path from the Library folder selected as the content type above.
Variable name
Variable name sets the name of the workflow variable, that you want to store this resource in.
Note that when reading the resource types document, transformation, translation and validation rule, then the resources will be read as text. If the document is not using UTF-8 character set, then you may encounter encoding issues. Other resource types are read as binary data.
You can verify the contents of the variable afterwards e.g. with the debug headers component.
Example use case
A common use case for the "resource to workflow variable" component, is to merge two or more XML files with an XSL transformation. In this case you could have one XML as the payload and the others as workflow variables.
For instance if you read the second XML into a workflow variable "SecondXML", then you can append that with the payload with this transformation:
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:fn="http://www.w3.org/2005/xpath-functions">
<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes" />
<xsl:param name="SecondXML" />
<xsl:template match="/">
<root>
<xsl:copy-of select="fn:parse-xml($SecondXML)" />
<xsl:copy-of select="." /> <!-- This is the root node in the payload XML -->
</root>
</xsl:template>
</xsl:stylesheet>
Related Articles
From variable to resource
You can load data from a workflow variable into a Library resource within a workflow with the advanced, utilities component: From variable to a resource. The component has these parameters: Variable name The name of the variable to copy the data ...From file to workflow variable
With the advanced utilities workflow component, From file to workflow variable you can extract the contents of a file in the file system and put that into the contents of a variable. A related component is: Resource to workflow variable. This can ...Workflow variable element
You can define two kinds of variables in your templates: 1.A normal variable, which is defined and used only within the template. 2.A workflow variable, which can be used for e.g. for sending user defined variable information from the workflow to a ...Payload to workflow variable
The advanced, utilities workflow component, Payload to variable copies the current payload into a variable. This can e.g. be used, if you want to insert the payload into an output file via a variable in a transformation. The payload to workflow ...Set one workflow variable
The advanced set meta data workflow component, Set one workflow variable, sets/defines a workflow variable. This can be used later in the workflow and also in a template in the designer. The variable can be referenced in XPath expressions with a ...