# Decorators

By uploading a specific CSV file, you can "shallow-rename" fields (change their display label) or hide specific properties from users without altering the underlying technical schema.

## Decorator CSV Format

Schema decorators are defined using a CSV file. Below are the specifications for the file format.

#### CSV Dialect Rules

* Separator: Comma (`,`)
* Quotes: Double quotes (`"`) must be used for strings that contain commas.

#### Columns Specification

The CSV must contain the following headers.

| Header       | Description                                                                                               |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| OBJECT\_NAME | The name of the object (resource) where the property is located.                                          |
| FIELD\_NAME  | The original technical name of the property to decorate.                                                  |
| HIDDEN       | `true` or `false`. Indicates if the field should be hidden from the UI.                                   |
| LABEL        | The user-friendly name to display in the Segment Builder and Query Tool.                                  |
| HELP\_TEXT   | A short description displayed as a tooltip when hovering over the question mark (?) icon in the platform. |
| LOCALE       | The locale for the label. Currently, this must be set to `en-US`.                                         |

#### Example

Code snippet

```
OBJECT_NAME,FIELD_NAME,HIDDEN,LABEL,HELP_TEXT,LOCALE
UserPoint,id,false,User ID,Unique identifier for the user point,en-US
UserPoint,technical_hash,true,,,en-US
UserEvent,subcategory,false,Subcategory,The specific sub-category of the event,en-US
UserEvent,subcategory_id,true,,,en-US
UserEvent,title,false,Event Title,The main title or headline of the event,en-US
UserEvent,region,false,Region,The geographic region associated with the event,en-US
```

{% hint style="info" %}
Note on Character Encoding

You must normalize strings by removing accents. Characters such as `é`, `è`, or `à` are not supported in the CSV file and should be replaced with their non-accented counterparts.
{% endhint %}

## Managing Decorators

You can manage schema decorators either through the mediarithmics user interface (Navigator) or programmatically via the API.

### Via User Interface

In the **Datamart > Object View Configuration** section of the Navigator Settings, you can use the buttons under the Schema to manage your CSV files directly.

The available actions are:

* **Upload new Decorators**: Allows you to upload a prepared CSV file to apply new labels and visibility rules. This will overwrite existing decorators for this schema.
* **Download Template**: Downloads a blank CSV file containing the required headers (`OBJECT_NAME`, `FIELD_NAME`, etc.) to help you get started.
* **Download Decorators**: Downloads the current active decorator CSV file. This is useful if you want to make edits to the existing configuration.
* **Delete Decorators**: Removes the current decorator file. The schema will revert to displaying raw technical field names, and hidden fields will become visible again.

### Via API

#### Prerequisites

You will need the following values:

* `DATAMART_ID`: The ID of your Datamart.
* `SCHEMA_ID`: The ID of the Schema you wish to decorate.
* `MICS_API_TOKEN`: Your API authentication token.

#### Retrieve Current Decorators

To fetch the existing decorator file for a specific schema:

Bash

```
curl -H "Authorization:$MICS_API_TOKEN" \
     -X GET \
     --location "https://api.mediarithmics.com/v1/datamarts/$DATAMART_ID/graphdb_runtime_schemas/$SCHEMA_ID/schema_decorators"
```

#### Update Decorators

To upload a new decorator CSV file (replacing the existing configuration):

Bash

```
curl -H "Authorization:$MICS_API_TOKEN" \
     -X PUT \
     --location "https://api.mediarithmics.com/v1/datamarts/$DATAMART_ID/graphdb_runtime_schemas/$SCHEMA_ID/schema_decorators" \
     --data-raw "$(cat path/to/schema_decorators.csv)"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.mediarithmics.io/schema/defining-your-schema/decorators.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.