Change
3 min
the change processor modifies incoming messages assigning a value to a field, finding and replacing a value, deleting a field, or moving a field's content elsewhere in the message why use change use this processor for direct value assignments and string manipulation, for example setting a field to a fixed value or replacing all occurrences of a substring within a message field how it works the processor's behavior depends on the selected mode in set mode, the processor assigns input value to the message's input field in change mode, the processor searches input field for input value and replaces it with replace with value if input field is a string or json, both input value and replace with value are converted to strings, and the processor replaces every substring match, not just a complete match for any other field type, the processor requires a complete match between input value and input field before replacing it with replace with value if update timestamp is enabled, the processor adds the current timestamp to the message after it finishes the set or change operation note mode also includes a move option, which relocates the field's content to the field specified in move to field parameters parameter details mode the type of modification to perform set , change , delete , or move input field the message field targeted for modification input value type the data type of input value input value in set mode, the value to assign to input field in change mode, the value to search for replace with value type the data type of replace with value replace with value the value that replaces the matched content in change mode move to field in move mode, the field that receives the relocated content update timestamp when enabled, adds the current timestamp to the message, recording when the change was made related topics use the change processor function docid\ m1lagr a4fmqvedmha8wl