This function is used to transfer metadata in or out of a track from/to the path of an audio file stored in a variable. The variable must contain an absolute path to the file.
When transferring in you have no access to the track's properties as they cannot be copied to the track receiving the metadata. You can elect to create a key/value list in in a specified variable. The list will contain all of the relevant properties defined in the Get Property statement. The key value separator is the default ≔ character. The list delimiter is \n. You would use the List Key statement to access the values. Note that in order to remain compatible with older versions of this statement, you can optionally save the properties to a named variable called Transfer Metadata Properties. If the action is being run stepwise a fatal error will be issued if you are saving to the named variable. Avoid saving to the named variable as this functionality has been deprecated..
When transferring out all container errors including the elimination of leading padding before the start of the audio stream will be corrected.
When transferring out you have the option of transferring only if the source file has been modified.
You can transfer all metadata, all metadata except Unhandled or you can select which metadata items are to be transferred. While Unhandled items can be transferred, they are never transferred unless the source and destination have the same audio file type.
If the statement succeeds, the action test state will be set to true, otherwise it will be set to false. When running stepwise the action test state will be false if there were any failures. On a per file basis, the Save Error property will be set to 1 if an error occurred. Errors can be caused by invalid paths, non-existent files or save errors. Regardless of the error status, no errors are issued to the UI. ie. the statement runs silent.
The Once setting is only meaningful when running stepwise. When Once is set a transfer is only attempted for the first selected file.