# Model configuration settings

This section offers information for Odoo users on how to set up model configurations for the Oregional REST API.

**Model configurations** allow to refine how a model should be made available to a remote application.

**Highlights**: 

* add an icon to the model that can be sent to the remote application to help users visually to identify quickly the type of Odoo record they see on a Confluence page
* change the display name of the model, e.g.: for res.partner instead of *"Contacts"* you might want to display *"Partners"* in Confluence
* limit the list of fields that can be displayed in Confluence (you might not want to allow certain sensitive fields to be able to be accessible from Confluence)
* link a model configuration to any model scheme

The app is shipped with the ***Default partner configuration scheme*** to give you an idea about this feature.

### Model configurations menu <a href="#modelconfigurationsettings-modelconfigurationsmenu" id="modelconfigurationsettings-modelconfigurationsmenu"></a>

![](https://592562319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDRDuISatrSJXjVVJWeuq%2Fuploads%2FkZwr0mBzreOC8LUjR61A%2Fimage.png?alt=media\&token=c7ef0e0f-a358-4a1f-b508-b3125d309c31)

### Model configuration list <a href="#modelconfigurationsettings-modelconfigurationlist" id="modelconfigurationsettings-modelconfigurationlist"></a>

The list of active model configurations is displayed by default.&#x20;

![](https://592562319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDRDuISatrSJXjVVJWeuq%2Fuploads%2FDcJaCaoHYs885VDCqHyG%2Fimage.png?alt=media\&token=f789d304-78ee-4b93-89be-d26f4c632a9a)

{% hint style="warning" %}
Inactive model configurations can be opened using search filter and search for field **Active** with value **is false.**
{% endhint %}

### &#x20;Model configuration settings <a href="#modelconfigurationsettings-modelconfigurationsettings" id="modelconfigurationsettings-modelconfigurationsettings"></a>

Only users with **Oregional Odoo App administrator permission** can make settings for model configurations

![](https://592562319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDRDuISatrSJXjVVJWeuq%2Fuploads%2Fj6nQy6EbH3PWYTuqap62%2Fimage.png?alt=media\&token=1c08da37-9dfb-46a3-94d7-1b48beb178cf)

| Item                 | Description                                             | Notes                                                  |
| -------------------- | ------------------------------------------------------- | ------------------------------------------------------ |
| Icon                 | Custom icon for the model in this configuration         | Can be made available for external applications        |
| Name                 | The name of the model                                   | Translatable                                           |
| Active button        | Archive / Unarchive a model scheme                      | <p><br></p>                                            |
| Model                | Linked Odoo model object                                | A records from ir.module.module model                  |
| Model Technical Name | The technical name of the linked Odoo model             | It is a related field, so it is computed automatically |
| Model Display Name   | Custom display name for the model in this configuration | <p><br></p>                                            |
| Description          | Additional information about the model scheme           | Translateable                                          |

#### Fields tab <a href="#modelconfigurationsettings-fieldstab" id="modelconfigurationsettings-fieldstab"></a>

Fields for the selected model that are allowed to be used in Confluence.

{% hint style="warning" %}
There are three ways to limit the list of fields:

* None: there is no limit, all fields are available for the model
* Blacklist: all fields except for the listed fields are available for the model&#x20;
* Whitelist: only the listed fields are available for the model

Not all fields make sense or advised to be used in Confluence, but it is up to you, what you allow. Just give it some thoughts before allowing all fields.&#x20;
{% endhint %}

#### Model schemes tab <a href="#modelconfigurationsettings-modelschemestab" id="modelconfigurationsettings-modelschemestab"></a>

You may link the configuration to model schemes by clicking on **Add a line** and unlink configurations by clicking on the **x** on the right end of the line.

![](https://592562319-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDRDuISatrSJXjVVJWeuq%2Fuploads%2FJAZN29ySm2fwChEV71ev%2Fimage.png?alt=media\&token=f17b5e35-4457-473e-8be0-3f39d5f342fe)

#### Audit tab <a href="#modelconfigurationsettings-audittab" id="modelconfigurationsettings-audittab"></a>

On the audit tab admins can find information about:

* creation timestamp
* user who created the record
* last modification timestamp
* user who last modified the record