As Is | NONE

Syntax

NONE( [input] )

Parameters

input
Any data may be used as the input.

Return Value

The input is returned unchanged and unmodified. No operation occurs. This is equivalent to VALUE.

Description

Any value passed into this function will be returned unmodified. This method is a no-op and should be the selected transformation when the data should be passed through as-is.

IMPORTANT: If the input value is an object, the output value will maintain its reference to the original object.

For example, if the process data has the following:

{
  obj1: {
    inObj1: 'test'
  }
}

And a subsequent transfrom has the input key of obj1 and the output key of obj2, the result of NONE() will reference the original data. This means that both obj1 and obj2 will reference the same data in memory. Subsequent modifications to data in obj2 would also occur in obj1

For example, the following transform...

  # output key = "obj2.inObj2"
  "ref value"

...will result in the following process data "inObj2" appears in both objects...

{
  obj1: {
    inObj1: 'test',
    inObj2: 'ref value'
  },
  obj2: {
    inObj1: 'test',
    inObj2: 'ref value'
  }
}

To avoid this behavior with objects use COPY([ value ]) instead.

Examples

NONE("test") # returns "test"

NONE(1) # returns 1

NONE(["test"]) # returns ["test"]

# input = {"test": 1}
NONE(${input}) # returns {"test": 1}