Skip to main content

Control - Region/City

When managing business objects, sometimes it is necessary to know the region they belong to, for example, the birth place of an employee, the location of a client company, and so on. In this case, you can choose the region/city control, which also supports quick filtering and showing the data on a map.

I. Basic Configuration​

Type:

Region/City control supports three types of region display formats, which are province, province-city, province-city-county.

Selection must be made to the final level

  • If it is a province-city type, the user must select the city before it can be saved.

  • If it is a province-city-county type, the user must select the county before it can be saved.

The page when selecting:

Source of data

It only shows administrative districts, excluding functional areas, development zones, etc. The data source is the data for 2022 published by the Ministry of Civil Affairs.

The administrative division chart is based on the contents of the region/city field to be displayed.

II. Writing Rules​

You can import or write data to the region/city field through Excel, APIs, and workflows.

  1. First check the configuration of the region/city field (province-city-county), and write it if it matches.

  2. The format of province-city-county must be proper, with "/" between different levels, and the province, the city, and the county must be written.

    For example, for XXX Province/XX City/XX County, if it is Henan/Zhengzhou, it cannot be written. If it is Henan Province Zhengzhou City, it cannot be written either.

  3. The province, city and county must match. For example, Henan Province/Qingdao City cannot be written.

  4. For four municipalities directly under the central government, just write XXX City/XX District.

Example

The region to be written is Henan Province/Zhoukou City/Fugou County. First, you need to check the configuration of the region/city field.

  • For a province, it will search if there is a province called "Henan Province", and if it matches, it will be written.

  • If it is a province/city type, it will continue to search if there is a city named "Zhoukou City" that belongs to Henan Province, if so, it will be written, if not, it will not be written.

More examples shown in the following:

Tips: What if the province, city and county are written separately?

Sometimes, the region infomation obtained from external systems via Webhook may be written to different fields, which requires you to combine them first, and then write the contents of the combined fields to the region field via workflow.

Have questions about this article？ Send us feedback