When designing an action for the Multi Field Editor or a function button, you can use this statement to specify which fields the action will process. The statement is optional. The Multi Field Editor treats an action which does not have a Supported Fields statement as being valid for all fields.
The advantage of having a Supported Fields statement is that the Multi Field Editor will display an error if trying to run an action and there are no appropriate fields specified. Further, the menus displayed on function buttons to run an action will only display a menu item if it is appropriate for the associated field.
When the supported fields are Fields in Table, You manually select fields in the field table. Note that the table supports the Process All but the Selected Fields mode.
The other possible values are presets:
- All Fields
All fields are supported.
- Single Item Fields
All built in fields which can have at most a single item are supported.
- Multiple Item Fields
All fields which can have more than one item are supported.
- Simple Text Fields
All fields which can have a single item and all multiple item fields, (except Artwork), which have a default item are supported.
- Simple Text Multiple Item Fields
All fields which can have multiple items and have a default item are supported. Note that Artwork which has a default item is not supported as the default item cannot be textually represented. The multiple item fields which have a default item are: Comments, Commercial Information Webpage, Lyrics, Official Artist/Performer Webpage, Rating and Terms of Use.
- Non Simple Text Fields
All fields which can have multiple items and do not have a default item are supported. Note that Artwork which has a default item is not supported as the default item cannot be textually represented.
- Custom Fields
All defined Custom Fields are supported.
- List of Credit Fields
All fields which are credits, including custom fields defined as credits, are supported
- List of Date Fields
A list of fields which are dates or timestamps are supported. Note that it is possible that there are custom fields which are dates which are not supported.
- List of Fields Mapped to an Application List
All fields mapped to an application list are supported.
- List of Formatted Fields
Fields which have an implied or enforced formatting are supported.The following fields are supported: AAC Kind, Classification, Content Advisory, Encoder Settings, Episode ID, File Type, Identification, Initial Key, Involved People, ISRC, Language, Media Type, Music CD Identifier, Musician Credits, Owner, Price Paid, Reverb, Seller, Start Time, Stop Time, Video Definition
- List of Numeric Fields
A list of fields which are treated as numbers are supported. This includes boolean fields such as Part of a Compilation and Custom fields defined as Yes/No values. Note that the Year field is not supported. Year is considered a date. The multiple item Rating field is supported as it has a default value. Note that it is possible that there are custom fields which are numeric which are not supported.
- List of Plain Text Fields
This is a convenience method which supports Simple Text Fields after removing: Date Fields, Formatted Fields, Numeric Fields and URL Fields.
- List of URL Fields
A list of fields which contain a URL are supported. This includes the multiple item fields Commercial Information Webpage and Official Artist/Performer Webpage as they have default values. Note that it is possible that there are custom fields which are URLs which are not supported.
If you execute an Get Info statement with the List of Supplied Fields function, you will have a list which is guaranteed to contain only fields specified in this statement. ie. the function removes all inappropriate fields.
When displaying a field's function button menu, there may be a Show All Actions / Only Show Explicitly Supported menu item. When determining what actions to display on the Multi Field Editor Actions submenu, only selection mode Fields in table without the Process All but the Selected Fields mode is treated as explicit.
