Visible fields attribute of the NameFormat element

Attribute visibleFields, on element NameFormat in file localization_localeCode.xml, defines the set of name fields that can be visible for each region. For example:

France

visibleFields="Prefix,FirstName,MiddleName,Particle,LastName,Suffix,Name"

Japan

visibleFields="LastName,FirstName,LastNameKanji,FirstNameKanji,Name,NameKanji"

The field order and the actual fields that can be shown are specified in the PCF files or the NameFormatter class. The order of the fields defined in visibleFields does not matter, and listing a field in this attribute simply enables it to be shown if it is specified.

The fields listed in this attribute must be defined in the class NameOwnerFieldId. By convention, the names used in visibleFields match field names defined in Contact or a subentity of Contact. In ContactManager, the names match field names defined in ABContact or a subentity of ABContact. Names are case-sensitive. If the values are not valid, you get error messages in the log when the data is first used. The error messages are defined in gw.api.name.NameLocaleSettings.init.

If a localization_localeCode.xml file does define a visibleFields attribute, PolicyCenter uses the entire set of name fields defined in the PCF file.

See also