Share

copy_properties

Copies properties from source objects to a target object.

Inputs

target

The target object that properties will be copied to.

sources

The source objects from which properties will be copied from.

overwrite_existing

When true, existing properties on the target are overwritten by the source properties if some of the sources have properties with the same name. When false, existing properties on the target are preserved. Note that properties are copied from the sources in the order that they appear in the sources array. When this parameter is checked, the properties in the later sources take priority over the earlier ones. When it is unchecked, the earlier sources take priority over the later ones.

properties

The names of properties to copy, such as point_color. Make sure to include all properties that you want.

  • Separate multiple property names with spaces.
  • You can use the wildcard * in expressions, for example, point_user* to specify all properties that begin with the string "point_user".
  • The default value * specifies all geo properties.
  • Use an empty string to specify no properties.
  • To include all properties except those specified, use * (to include all properties) and then prefix specific properties or patterns individually with ! to exclude them. For example * !point_foo !point_bar* includes all properties except "point_foo" and those that begin with the string "point_bar".

Outputs

out_target

The target object with properties copied from the sources array.

Was this information helpful?