# Place Administration

{% hint style="info" %}
This help page requires version 3.0 of SanteDB
{% endhint %}

In SanteDB a [Place](../../../../../santedb/data-and-information-architecture/conceptual-data-model/entities/data-dictionary#place)  is a specialized entity used to represent a physical place. SanteDB further distinguishes between classifications of places in Service Delivery Locations (Facilities) and geographic places.&#x20;

The Place administration screen is used to edit non-service delivery locations and is used to express the geographical hierarchy within a SanteDB instance. This can be villages, provinces, cities, and countries. SanteDB uses these entries in a variety of manners:

* If fully structured address inputs are enabled, SanteDB uses these Place registrations to populate the drop-downs based on hierarchy of previous inputs.
* Catchment assignment with facilities (and by extension, the assignment of a Patient to a default home facility based on catchment)
* Subscriptions when basing subscriptions off geographic areas of data

## Place Hierarchy

Places in SanteDB can be established in a hierarchy using the place editing screen. The place editing process allows the linkages of places in a Parent/Child relationship. To illustrate this using Ontario Canada as an example:

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FwyI4c4vqXFWOi4texdmO%2Fimage.png?alt=media&#x26;token=cd658aca-fb23-4a29-ba7a-53098352dfca" alt=""><figcaption></figcaption></figure>

The example, would consist of 4 places in the SanteDB database:

1. A place named "Canada" with a classification of Country at the root (with no parent)
2. A place named "Ontario" with a classification of State or Province, with a parent of Canada (#1) and two children of Toronto (#3) and Ottawa (#4)
3. A place named "Toronto" with a classification of City or Town and a parent of Ontario (#2)
4. A place named "Ottawa" with a classification of City or Town and a parent of Ontario (#2)

## Place List

The master place list is accessed via the **Reference Data > Places** menu item. Upon visiting the place screen, users will be presented with a list of all the places which have been registered in the SanteDB solution which are not service delivery locations.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FIhDdwhJH0gbXSDEmvjY1%2Fimage.png?alt=media&#x26;token=5eb4ff0c-a630-4c98-9b93-120a2c6b2ed0" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
SanteDB contains place registrations for countries - when implementing a place hierarchy it is recommended that implementers bind the top level of their hierarchy (typically provinces or states) to the SanteDB registered country.
{% endhint %}

## Creating a Place

To create a place press the **Create** button, this will present the administrator with a basic entry form to enter the key details about new place:

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FpRWYNkmVidul3wO0wnMs%2Fimage.png?alt=media&#x26;token=c163dbfc-4464-49a9-8761-021852feaf26" alt=""><figcaption></figcaption></figure>

The form fields to be provided are:

| Field          | Description                                                                                                                                                         | Example           |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| Classification | The standard classification of the geographic place in SanteDB. See [SanteDB Place Hierarchy](#santedb-place-hierarchy) for more information.                       | State or Province |
| Type           | The sub-classification/custom classification of the geographic place. This can be used for customizing your own place hierarchy or specifying a sub-specialization. | Union Territory   |
| Official Name  | The official name for the place as it should appear in drop downs, reports, etc.                                                                                    | Capitolville      |
| Parent         | If the place is a child of another place (such as a province is a specialization of country)                                                                        | SampleCountry     |

### SanteDB Place Hierarchy & Classifications

In order for drop downs in the SanteDB user interface to be cascaded according to hierarchy, all geographic places must have a classification assigned to them in the standardized hierarchy. By using standardized hierarchies, developers can understand your own custom administrative structure with SanteDB's. The standardized classifications in order:

* Country: Represents the top of the geographic hierarchy.
* Nation: Represents a geographical grouping of people based on culture, language, ethnic background, etc. (for example: Sioux Nation as a child of Canada)
* State or Province: A sub-national subdivision of a country such as a territory, state, province, region, etc.
* County or Parish: A sub-provincial subdivision of a province or state which is used for administrative oversight (county boards, or governing councils, etc.).&#x20;
* City or Town: An incorporated or recognized area of land with a municipal governance structure.

SanteDB also includes a generic **Place** classification which should be used when a classification of a place does not apply (such as an ungoverned island, an orbiting space station, other planets, etc.)

## Place Details

After creating a place, or viewing a place from the existing list of places registered in the SanteDB service, the Administrator will be presented with the place details screen illustrating the hierarchy, the facilities which service this area (facilities where the place is in catchment) and the relationships the place carries.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2F6doAutwSN33B1uWRb6GO%2Fimage.png?alt=media&#x26;token=7dc7b6ec-38eb-4186-a9af-60c60fd24b7c" alt=""><figcaption></figcaption></figure>

### Changing Status

To change the place status, administrators should click on the status indicator and select another state to place the Place instance into:

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FasUW9anoJFsT8IQwwMJT%2Fimage.png?alt=media&#x26;token=c4abc114-8853-46da-9817-3787615db3bb" alt=""><figcaption></figcaption></figure>

Statuses here follow the normal [Entity State Machine](../../../../santedb/data-and-information-architecture/conceptual-data-model/entities/state-machine).

### Editing Core Properties

The core properties can be edited by clicking the pencil icon in the **Place Properties** panel. This will switch the editing panel into edit mode:

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FZ3XrRqsEUoA6ufid4Oph%2Fimage.png?alt=media&#x26;token=5ef2b69b-1614-46e9-a030-170a31d4cf27" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Changing the Classification of the place is only recommended if the place does not have any active relationships. Modification of the classification may invalidate some relationships and may cause issues for any existing data.
{% endhint %}

#### Adding Aliases

In many contexts, places may have additional pseudonyms which can be used to reference places. For example, the city Hamilton/Wentworth may also be referred to by local residents as just Hamilton, or Stoney Creek. All these names should point to the official registration for Hamilton/Wentworth.

The Name tab on the edit screen can be used to modify these aliases and can be used to add other names to the place:

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2Ft7UdpQmGyebIvjx5Zmmt%2Fimage.png?alt=media&#x26;token=457d84a4-7431-4129-ae74-df59d4d0ac57" alt=""><figcaption></figcaption></figure>

#### Adding Identifiers

Geographical places may carry official identifiers which are referenced in addresses or other systems (for example, all countries in SanteDB carry an ISO-3166 identifier). The **Identifiers** tab should be used to associate identifiers with the place. To add an identifier:

1. Select the assigning authority&#x20;
2. Enter the ID number&#x20;
3. Press the **+** button to add the identifier to the list

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FAKl9z42DHXIDeXK5vWRp%2Fimage.png?alt=media&#x26;token=5b0728c7-4178-47d5-8ee5-8d8ff56f62c6" alt=""><figcaption></figcaption></figure>

Identifiers can be removed using the **X** button beside the identifier to be removed.&#x20;

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FCCSObk5yKIWZn54buzOG%2Fimage.png?alt=media&#x26;token=a3077700-63d6-4da3-8c26-e6e3d5d53e11" alt=""><figcaption></figcaption></figure>

#### Adding Addresses

The address on a place (City, Province, Country, etc.) often serves the address template whenever a structure address is selected for this place. Addresses should be updated whenever the parent relationship changes, or can be used to specify the address template for objects created within this place.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2F3MF1HDzypkixAGoocTAD%2Fimage.png?alt=media&#x26;token=e1816ba6-daad-4229-98e8-d88280451e65" alt=""><figcaption></figcaption></figure>

### Editing Hierarchy

The place hierarchy is used to establish the parent and children of the geographic place within the SanteDB system. The hierarchy is listed in the Hierarchy panel on the place details screen.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2F0dqb5g4YGZuf0PCXJpry%2Fimage.png?alt=media&#x26;token=ce5a732e-87f7-40f2-8977-47142ea77366" alt=""><figcaption></figcaption></figure>

Child places can be removed directly from the hierarchy window without entering edit mode. However, if the parent or new children are to be added, the administrator must click on the Pencil icon to enter edit mode which will enable the form inputs.

Adding a child link requires searching for the child place to add and pressing the **Add** button.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FnrDY6OXOQWdQC2jsQ4Xn%2Fimage.png?alt=media&#x26;token=816d222f-3ee9-4ed2-a1c1-772ba82cc788" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
A place can have only one Parent. When changing the parent of the current place or when changing the parent by associating a child, you will be prompted to confirm the action. Changing the place hierarchy may require editing other data such as addresses.
{% endhint %}

### Adding Service Facilities

SanteDB supports the assignment of dedicate service delivery locations (facilities) which service the geographic region. This can be performed via the facility editing screen, or can be performed directly in the Place editing screen. Assigning a facility starts with pressing the **Add** button on the **Service Facilities** panel.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2F6JJeKeIERSQ0qsBRkOBH%2Fimage.png?alt=media&#x26;token=69592c58-80c3-43ab-9959-db4e9e3803b2" alt=""><figcaption></figcaption></figure>

### Associating an Existing Facility

The default option when adding a dedicated service delivery location is to link an existing facility. This is done by searching for an existing facility and pressing ADD.

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2FQ0NTRj6lSYIbALqGRk2C%2Fimage.png?alt=media&#x26;token=b7b9ce4d-d8a3-448f-bdb0-533795f6e507" alt=""><figcaption></figcaption></figure>

### Associating a New Facility

Alternately, an administrator can create a new facility selecting **Associate a New Facility**.&#x20;

&#x20;

<figure><img src="https://3421852694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZ0_pjgTp_kx4hqTZ3a%2Fuploads%2F1yjbnFoZz3q0FrVsjUNp%2Fimage.png?alt=media&#x26;token=785e5ab3-0098-4ebf-9265-a2237609000f" alt=""><figcaption></figcaption></figure>

The administrator should complete the minimum fields, select the additional data elements (if known) and then press the ADD button.

