Skip to content

Log Functions

Overview

This article explains how to implement log functions in your mapping files when running them in Zynk Workflow.

When you call one of these functions, a message will be written to the log database. If you are running from the Zynk Workflow application, the message will also be shown in the log panel.

  • Namespace urn:ZynkLogFunctions
  • Available since Zynk Workflow 2023.6.2

XSLT

Declarations

To use log functions, you need to add the namespace declaration to your XSLT file:

<xsl:stylesheet 
    version="1.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:Log="urn:ZynkLogFunctions"
    exclude-result-prefixes="Log">

    <!-- transformation -->

</xsl:stylesheet>

Functions

Below is a list of available functions within the urn:ZynkLogFunctions namespace:

  • Info
  • string message
  • Debug
  • string message
  • Warning
  • string message
  • Error
  • string message

Example

Input

<?xml version="1.0" encoding="utf-8"?>
<Company>
    <Products>
        <Product>
            <Sku>CALC0001</Sku>
            <Name>Basic Calculator</Name>
            <Description />
        </Product>
        <Product>
            <Sku>CALC0002</Sku>
            <Name>Pocket Calculator</Name>
            <Description>You can take this fantastic, pocket sized calculator anywhere with you!</Description>
        </Product>
    </Products>
</Company>

XSLT

<xsl:stylesheet 
    version="1.0"
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:msxsl="urn:schemas-microsoft-com:xslt"
    xmlns:Log="urn:ZynkLogFunctions"
    exclude-result-prefixes="msxsl Log">

    <xsl:output indent="yes"/>

    <xsl:template match="/">
        <products>
            <xsl:for-each select="Company/Products/Product">
                <xsl:choose>
                    <xsl:when test="string-length(Description) = 0">
                        <xsl:variable name="SingleQuote">'</xsl:variable>
                        <xsl:variable name="Message" select="concat('The product with SKU, ', $SingleQuote, Sku, $SingleQuote, ', does not have a description.')"/>

                        <xsl:variable name="Error" select="Log:Error($Message)"/>
                        <xsl:comment><xsl:value-of select="$Message"/></xsl:comment>
                    </xsl:when>
                    <xsl:otherwise>
                        <product>
                            <sku><xsl:value-of select="Sku"/></sku>
                            <title><xsl:value-of select="Name"/></title>
                        </product>
                    </xsl:otherwise>
                </xsl:choose>
            </xsl:for-each>
        </products>
    </xsl:template>

</xsl:stylesheet>

Output

<?xml version="1.0" encoding="utf-8"?>
<products>
    <!--The product with SKU, 'CALC0001', does not have a description.-->
    <product>
        <sku>CALC0002</sku>
        <title>Pocket Calculator</title>
    </product>
</products>