The source transform Child Element (N1 Service Provisioning System 4.1 Reference Guide)

N1 Service Provisioning System 4.1 Reference Guide

The source transform Child Element

The <source> element is a child of the <transform> step, and specifies an external file on the target host which contains the transform to be applied to the input file. At most one <source> element may appear as a child of a particular <transform> element, and they may not be used in conjunction with any other child elements.

Note –

No config generation is performed on the named source file as part of the <transform> step. However, the named source file may be a config-type resource file deployed as part of a component install, in which case substitution variables contained in the source file would have been substituted when the file was deployed.

source Element attributes

Name

Type

Required

Configurable

Description

type

One of:

PERL

XSLT

Yes

The type of transform contained in the named file, as described below.

name

String

Yes

The name of the file on the target host that contains the transform. The content of the named file must correspond to the type defined by the “type” attribute. The name may not include zip archives as directory elements.

The type Attribute of the source Element

The “type” attribute of the <source> element specifies the type of transformation contained in the named file.

A value of “PERL” indicates a Perl5-based transform similar to that of the <subst> element. In this case, the named file should have format similar to the following:

<?xml version='1.0'?>
<transform>
	<subst match=”127\.0\.0\.(\d+)” replace=”10.10.0.$1” />
</transform>

Perl-type external transform files may contain any number of <subst> elements.

A value of “XSLT” indicates an XSLT transform. In this case the named file contains a standard XSLT version 1.0 transform as defined by the namespace “http://www.w3.org/1999/XSL/Transform”. Note that unlike inline transforms which only allow the XSLT <stylesheet> element, XSLT transforms contained in external source files may include any valid top-level XSLT transform element including <stylesheet>, <transform>, and simplified XSLT syntax as described in section 2.3 of the XSLT specification.