Regions

On the “Regions” page you manage the region names used to group, categorise and filter workobjects (including fields). A region is selected in the “Region” field of the workobject form. The page is used by the administrator. The list and loading from a file are described in general on the Admin Settings page.

Page layout

• The “Add new region” and “Add from file” buttons.
• The table has the “ID”, “Region” and “Outer ID / ID 2” columns.
• The list contains only your company’s regions. Regions have no archived list and no “Bulk edit parameters”, and they are not shared with partners.

How to add or change a region

1. Press “Add new region” or click the region’s row. For an existing region, the “Edit region” window opens.
2. Enter the “Region”, that is the region’s name (mandatory).
3. If needed, enter the “Outer ID / ID 2”, for example the region’s code in accounting or another system.
4. Press “Save” (the window stays open) or “Save and close”.

How to delete a region

1. Click the region’s row.
2. Press “Delete” in the window and confirm.

A deleted region disappears from the list and the options. As regions have no archived list, a deleted region cannot be restored on this page.

How to load regions from a file

Press “Add from file” and follow the steps on the Admin Settings page. The only field in the file is “Region”, and it is mandatory.

Where regions are used

• The “Region” field on the workobject form; with the buttons next to the selection field you can change the region or add a new one right there. See Workobjects.
• The “Region” column in the list of fields and when loading fields from a file, see Field admin.
• The “Region” column in the list of plans and in crop rotation, and the “Workobject region” column in reports, by which you can filter and sort the data.

Who can see and change it

The page is in the Admin menu and opens only for the “Administrator” role, who can add, change and delete the company’s regions. No other role gives a separate right to add or change regions. If “Users have by default create privilege” is ticked in the company settings, other users, except “Observer” and “ARIB employee”, can also add a new record with the plus button next to the “Region” selection field on forms on other pages and change a record they added within 48 hours of adding it.

Tips

• If a region’s name changes, correct the name of the existing region instead of creating a new one: this way the region stays with all linked workobjects.
• To group by region, the region must be set on the workobjects.

API calls on this page

For integrations and AI assistants: this page uses the following Terake API calls. The full description is in the API reference.

When the page opens:

• GET /api/locationareas

Adding, changing and deleting (from the API description):

• DELETE /api/locationareas/{id}
• POST /api/locationareas
• PUT /api/locationareas/{id}/togglearchive
• PUT /api/locationareas/{id}

Other calls from this screen’s dialogs and actions (from the web client’s code):

• GET /api/locationareas/{id}