Using the CityReference field
A Cities business objects (PLAATS) is now enabled to use a CityReference field.
CityReference is a proper reference to the Cities business object: CityReference (translated as: City).
So, there are now two City fields:
• database name PLAATS - old
• database name FK_City - new
 | The old City field (PLAATS) will be phased out - see Use new improved reference field for City. |
• For existing customers, this means that they should switch to using this new field (Improved feature).
• New customers are recommended to use the CityReference field from the start.
The following procedures describes how to make the Cities business object translatable and also describes how to use the CityReference field as a proper field and as a Free field reference.
Using the CityReference field
The CityReference field is a proper reference field that derives its value from the Cities business object. This means that if a city is deleted from the Cities business object, the reference value will automatically be empty (which is not the case with the City field).
Using CityReference as a proper field
Procedure
1. Go to Layouts and select the business object on which you have a City/Country field and set it Under construction.
2. On the Layouts step, drag the CityReference field to the correct position on the grid.
3. Set the business object to Completed.
The CityReference field is now available.
Using CityReference as a Free reference field
Procedure
1. In Field definer , select the business object for which you want have a new City field.
2. Set the business object Under construction and add the Free reference (FreeInteger) field and select CityRef as Field type.
3. Set the business object to Completed.
4. Go to Layouts and add the Free reference field to the layout.
You will now be able to use this reference field as a proper reference to the translatable Cities business object.
Making the Cities business object translatable (optional)
Procedure
1. Go to Field definer , select the Cities business object and set it Under construction.
2. Set the field Is user-translatable? to Yes.
3. Set the business object to Completed.
4. On the action panel, click Jump to Layouts.
5. Set the layout Under construction.
6. Add the field LangFieldDetail to the layout.
7. Set the layout back to Completed and log off/on.
The Cities business object is now translatable. If you go to > and select a city from the elements list, you will now be able to add translated names for the different languages in your system.
 | Also check the video on Making 'Cities' translatable on our Planon Software channel. |