Welcome < Configuration < System Configuration < Custom Fields

Custom Fields

The Custom Fields tab is used to configure attribute and text fields for the assets in Zetta. In this tab the user can view the details for system and custom fields. If Zetta is integrated with GSelector, additional attributes in GSelector can be mapped to Zetta Custom Fields. These Custom Fields can be added to modules as columns and sent using Live Metadata send.

Access the Custom Fields tab from the System Configuration window in Zetta's Configuration menu.

Click any area in this image for help

Click any area in this image for help

In this Topic: show/hideshow/hide

Custom Fields Toolbar

There are three toolbar operations that can be performed from the Custom Fields tab:

	Refresh Custom Fields - The Refresh Custom Fields button will refresh the window to the last saved state, discarding any unsaved changes.
	Add Custom Field – Clicking Add Custom Field will create a Custom Field instance that can be configured.
	Delete Custom Field – The Delete Custom Field button will remove the selected configured Custom Field Instance. System type fields cannot be deleted from Zetta.

Details

The Details tab of the Custom Fields window show the following detailed information about the field.

In this section: show/hideshow/hide

Name

The Name is the name of the field this will be shown in the Extra tab or Station/Cut specific tab based on the Scope of the field. This field cannot be changed for system fields. To match the Attributes in GSelector the Name must be the same as what is configured for the field in GSelector.

Asset Type

The Asset Type field is used to select the asset types(s) for which this field can have values or text. There is All Custom Asset Types option that can be used to make the field show up for all custom Asset Types. If All Custom Asset Types is selected any newly created Asset Type, created in the Asset Types tab of the System Configuration window, will have this field assigned. The Asset Type field cannot be changed for system fields. Multiple asset types can be added to this field, such as song and link. To match the Attributes fields in GSelector the Asset Type(s) must be the same as what is configured in GSelector.

Scope

The Scope drop-down is used to select the Station, Cut or Global. If the system does not have any Asset Type assigned to cuts or the system is integrated with GSelector, the Cut option will not be shown in the drop-down. When the scope is set to Station, the field will be added to the Station Specific tab of the metadata card for the selected Asset Type. When the scope is set to Cut, the field will be added to the Cut Specific tab of the metadata card for the selected Asset Type. When the scope is set to Global, the field will be added to the Extra tab of the metadata card for the selected Asset Type. When the scope is set to Station or Cut, the Pool option is shown. Once fields have assigned values or text saved to the database this field cannot be changed. To match the User-defined fields in GSelector the Scope must be Global.

Value Type

The Value Type option is used to select Attribute or Text. When Attributes is selected the Values tab is shown and a list of attribute values can be added to the field. These added values will show up in a drop-down list in Metadata card for the selected Asset Type. Once fields have assigned values or text saved to the database this field cannot be changed. When Text is selected as the Value Type the Maximum Length field will be shown. To match the User-defined fields in GSelector the Value Type should be Attributes.

Value Pool

The Value Pool drop-down option will be shown only if the Scope of the field is Station or Cut and the Value Type selected is Attribute. The Value Pool options available are Station Pool or Global Pool. Once fields have assigned values saved to the database this field cannot be changed.

Station Pool - When Station Pool is selected the field can have different values for each station. A station selection drop-down will be shown in the Values tab to pick the station.

Global Pool - When Global Pool is selected the field will have a global list that shows up for all stations. There will be no station selection drop-down shown in the Values tab in this case.

Allow New Values

If the Value Type selected is Attribute the Allow New Values option is available. When the Allow New Values option is enabled users can add additional values in the metadata card for the field. Simply, enter the new value in the Value(s) field of the metadata card and save the asset. If this option is disabled (unchecked) all values for this field will need to be entered in the Values tab prior to being assigned to an asset.

Allow Multiple Values

If the Value Type selected is Attribute the Allow Multiple Values option is available. When the Allow Multiple Values option is enabled, users can assign multiple values for this field in the metadata card. When this option is disabled the user will only be able to assign one value to the field in the metadata card.

Text Maximum Length Value

If Value Type is Text, the Maximum Length field will be shown. The Maximum length can be any value between 1 and 255.

Adding GSelector Attributes to Zetta

If GSelector integration is enabled most of the attributes in GSelector can be mapped to Zetta Custom Fields. The following tables and examples show how to match the supported fields. When Custom Fields are created to match GSelector fields, Zetta and the GSelector Integration Services must be restarted.

NOTE: Ensure you select Allow New Values for all of these Custom Fields so GSelector can create any non-existing attribute values.

Attributes in the GSelector Song or Link Additional tab

The Additional attributes found in the Additional tab of the Song or Link card in GSelector will have a Scope of Global, a Value Type of Attribute and allow for single or multiple values. Some of the Attributes from the Additional tab of GSelector are already in Zetta. The Publisher and Label attributes are already fields in the Extra tab of the Song metadata card and are not currently supported for Links. The ISRC attribute is already in the Extra tab of the Song and Link metadata card. The Promoter and License fields are already read-only fields in the GSelector tab of the Metadata Card for Songs but can be added for Songs if desired. The User Defined attributes in the bottom portion of the Additional tab will need to be defined in the Tools | Global Setting | User Defined tab of GSelector before they are matched up to Zetta Custom Fields. Fields that are set to Allow Multiple Values in Zetta will be shown in GSelector with a semicolon separating the values and if the values are added in GSelector with a semicolon they will be treated as separate values when passed to Zetta.

Tip: If these fields are not used in GSelector they do not need to be added to Zetta.

Example 1:

Example 2 (User Defined field):

Custom user defined fields in GSelector

GSelector version 4.9.0 introduced 'Custom user defined fields', allowing sites to create up to 89 custom fields. These fields can be bidirectional synchronized between Zetta and GS starting with Zetta version 5.20.1, provided the corresponding field exists in Zetta. GSelector supports four data types, Text (string), Date, Number (int) and True/False (default if not set is False). All of GSelector Custom user defined fields are GLOBAL.

Other Global Attributes in GSelector

Film Name and Version are Global attributes in GSelector and will have a Scope of Global, a Value Type of Attribute and only allow a single value. The Version field is already a read-only field in the GSelector tab of the Metadata Card for Songs but can be added for Songs if desired. BPM In, BPM Out and BPM Overall are Global attributes in GSelector and will have a Scope of Global, a Value Type of Text.

Example 1:

Example 2:

Global/Station Attribute Mapping in GSelector

Global/Station Attribute Mappings are based on the Attribute Type that is set in the Setup | Station | Features | Attributes tab in GSelector. These Custom Fields are for Songs and Links will have a Scope of Global, a Value Type of Attribute and allows a multiple values.

If the Attributes are set to Global in GSelector the Naming is as follows:

Example:

If the Attributes are set to Station in GSelector, the Naming is as follows:

Example:

Values

The Values tab in the Custom Fields tab of the System Configuration window is shown when Attribute is selected as the Value Type. This tab is used to add values to the selected field. The row just below the column headers can be used to filter the contents of the Values tab.

Values toolbar

Values List Pane

Values Toolbar

	Add Custom Attribute Value – Clicking Add Custom Attribute Value button will create a value entry in the list pane. Each value requires a Name and optional Id.
	Delete Custom Attribute – The Delete Custom Attribute Value button will remove the selected configured value entry from the list and will remove the value from all assets where it is assigned.
	Station Select - The Station selection drop-down is only shown when the Scope of the attribute is Station or Cut, the Value Type selected is Attribute and the Pool is set as Station Pool.

Values List pane

The List pane in the Values tab holds a list of added attribute values. These are the values that are shown in the Extra, Station Specific or Cuts tab of the metadata card for an asset. The location of the attribute is based on the Scope of the field. To add a value to the list, click the Add Custom Attribute Value button in the Values toolbar. This will create a line item in the list. Then double-click the Name field, of the newly created line item, to enter a name for the attribute. Optionally, double-click the Id field to enter an Id for the value.

Custom Fields Step-by-Step

This section will provide step-by-step instructions for tasks in the Custom Fields tab of the System Configuration window. When Custom Fields and Values are created to match GSelector fields, Zetta and the GSelector Integration Services must be restarted.

In this section: show/hideshow/hide

Add a New Custom Field

1. Go to the Custom Fields tab in the System Configuration window.
2. Click the Add Custom Field button.
3. Enter a Name for the Field.
4. Select the Asset Type
5. Select the Scope
6. Select the Value Type
7. Select the Pool if the Scope of the attribute is Station or Cut and the Value Type selected is Attribute.
8. Optionally, select Allow New Values if the Value Type is Attribute.
9. Optionally, select Allow Multiple Values if the Value Type is Attribute.
10. Optionally, set a Maximum Length if the Value Type is Text.
11. Click the Values tab to add field values if the Value Type is Attribute.
12. Click Save in the System Configuration toolbar.

Add an Attribute Value to a Custom Field

1. Go to the Custom Fields tab in the System Configuration window.
2. Select the Field to add Values.
3. Click the Values tab.
4. Click the Add Custom Attribute Value button in the Values toolbar. This will create a line item in the list.
5. Double-click the Name field, of the newly created line item, to enter a name for the attribute.
6. Optionally, double-click the Id field to enter an Id for the value.
7. Click Save button in the System Configuration toolbar.

Delete an Attribute Value from a Custom Field

Warning This will remove the attribute value from any asset where it is assigned.

1. Go to the Custom Fields tab in the System Configuration window.
2. Select the Field to delete Values.
3. Click the Values tab.
4. Select the Value to delete.
5. Click the Delete Custom Attribute Value button in the Values toolbar.
6. Click Save in the System Configuration toolbar.

Edit an Attribute Value of a Custom Field

1. Go to the Custom Fields tab in the System Configuration window.
2. Select the Field to edit Values.
3. Click the Values tab.
4. Select the Value to edit.
5. Double-click the Name field of the value and enter a new name for the attribute.
6. Optionally, double-click the Id field to enter a new Id for the value.
7. Click Save in the System Configuration toolbar.

Edit a Custom Field

1. Go to the Custom Fields tab in the System Configuration window.
2. Select the field to Edit.

3. Edit the Name for the Field.
4. Edit the Asset Type(s)
5. Edit the Scope. This can only be edited if there are no Values saved to the database. This can only be edited if there are no Values saved to the database.
6. Edit the Value Type. This can only be edited if there are no Values saved to the database. This can only be edited if there are no Values saved to the database.
7. Edit the Pool if the Scope of the attribute is Station or Cut and the Value Type selected is Attribute. This can only be edited if there are no Values saved to the database.
8. Optionally, select Allow New Values if the Value Type is Attribute.
9. Optionally, select Allow Multiple Values if the Value Type is Attribute.
10. Optionally, set a Maximum Length if the Value Type is Text.
11. Click the Values tab to add or edit attribute values if the Value Type is Attribute.
12. Click Save in the System Configuration toolbar.

Delete a Custom Field

Warning This will remove the attribute from any asset where it is assigned.

1. Go to the Custom Fields tab in the System Configuration window.
2. Select the Field to Delete.
3. Click the Delete button in the Custom Fields toolbar.
4. Click OK to the warning.
5. Click Save in the System Configuration toolbar.

Welcome < Configuration < System Configuration < Custom Fields