This function is used to import a track's tagging information.
A folder path and a base filename are specified or constructed. A base filename is required as more than one file may have been written when the data was exported. The folder and filename together specify the source of the files being imported.
You can specify a path for the source folder or that the source folder is relative to the folder containing the audio file. Relative paths are specified by the number of levels up from the file's containing folder. Zero levels implies that the new folder structure should be in the files's containing folder. One level implies that the new folder structure should be in the parent of the file's containing folder, etc.
At runtime the path must resolve to be:
Choose up to three fields to be used as folders to be appended to the absolute or relative base path. When the path is constructed if you specified Album Artist and the field is empty, Artist will be used. If the value associated with a chosen field is empty an error will be issued unless a placeholder is specified. Note that if a non empty placeholder is specified and a field is not specified, the placeholder will be used.
Transformations can be applied to each of the three fields to be optionally appended. To configure the transformations press the Transformations... button. A panel will be displayed containing the transformation settings. Close the panel by clicking off the panel or by pressing the Escape key. For more information see Statement Transformations.
To summarize the source folder location is calculated as follows:
You can enter a specific filename or leave the field empty to use the audio file's name for the name of the file to be imported (without the plist extension).
All text fields may contain any of the escape sequences described in Escape Sequences.
The function sets the Retained Path 1 property to the folder which contained the imported data. The Retained Path 2 property is set to the base filename. On failure, both properties are emptied.