This function is used to set the contents of a field which is determined at runtime. You can optionally choose to set only if the destination is empty and/or only if the source is not empty.
There is no reason to use this statement if the field to be set is deterministic when writing the action.
The supplied symbolic field name and the data string may contain any of the escape sequences described in Escape Sequences. The unescaping is performed for each file when running stepwise.
The supplied name field is list aware. You can specify more than one destination field by separating the field names with the default list delimiter (\~), newline sequences (\n) or commas (,). The list is only decomposed after escaping occurs.
As an example you might set the name to \v1 implying that the name is in track variable 1. Variable 1 could contain Artist or Title or almost any other Yate field name. A complete list of the valid symbolic names can be found in the Insert Yate Field text field context menu. The names are not case sensitive.
Setting the symbolic name field to \v1,\v2 would set the fields whose names are in track variable 1 and track variable 2.
in order to facilitate setting the rating, use a value of 0-5 which will be converted as required. If you want to write a specific value in the range of 1-255 for the internal representation of the rating, enter it as a negative number.