Application icon

Application List Functions

Application Lists are usually filled either automatically or manually from the UI when metadata is entered in fields that can be mapped to lists. The Fill Application Lists action statement can perform the same functionality on demand. These methods of populating the application lists are driven by the contents of metadata fields which are mapped to application lists.

This statement allows you to add or remove one or more items from an application list directly. You specify the application list and the items that are to be added or removed.

When you choose Indirect Application List as the list, named variable Indirect Application List must contain the name of an application list. If an application list has been renamed the default name of the list will also be accepted. The extracted application list becomes the effective list to be manipulated by the function. You can extract a list of the current names of the application lists via the Get Info's Names of Application Lists function.

The text field specifies the item or items which are to be removed or added. The text field may contain any of the escape sequences described in Escape Sequences. After unescaping, the text field is treated as a list delimited by default list delimiters (\~), newline characters (\n) or multi value delimiters (\m). In this manner one or more items may be processed at a time.

Typically the text field is evaluated once, regardless of the execution mode. If you set the All files option, the function will be applied once per track when run stepwise, assuming that there is a per track escape sequence that is present.

The application lists are case, diacritic and leading article (found in the Natural Sort Exception Set) preserving. If an item is added which already exists with different representation, the original is preserved. If you want to ensure that a list item has a certain representation choose the Override Add statement. Override Add is essentially a Remove followed by an Add.

If you want to know the exact match for the items in the list you can select the Return Matches function. The specified named variable will be set to the exact rendition of every item in the source list of items or empty. Items in the named variable are delimited by the default list delimiter (\~). The named variable field may contain any of the escape sequences described in Escape Sequences.

Example:

If the text field contained BOB DYLAN\n unknown \n Rolling Stones
    and if Bob Dylan and The Rolling Stones were in the specified list
        and unknown was not in the list
            the following would be returned:

Bob Dylan\~\~The Rolling Stones

You can also use this statement to clear out a particular list or to clear all lists. Warning: The clear functions cannot be undone.

The Get Info statement can be used to create a copy of any application list in the event you want to search or enumerate the list.