Skip to main content

Modifying a Custom Table

To modify a 'Custom Table' go to the 'Manage table structure' (Catalog > Data model > Manage table structure)

**images/download/thumbnails/615293193/image2019-5-21_10-15-37.png
**

Select the table that you want to modify, then select 'Update'.

Alt text

This action will open a modal window.

Alt text

You will be invited to download a definition file. It must be in the JSON format.

The following 'Custom Table' modifications are possible:

Adding a field (column)

Adding a column can be done on existing tables which are either empty or populated. Depending on the case, every type of field (columns) cannot always be created:

images/download/attachments/615293193/image2020-8-14_12-7-56.png

If you want to add a mandatory field or the key of an already populated table, it will be necessary to completely delete the table and create it again. Do not forget to export your data beforehand.

The basic structure of the JSON file must present a ‘type' : "addColumn" field which enables you to add a field to a given existing table.

Download a JSON file example: addColumn.json

Deleting a field (column)

Deleting a field can be done on either an empty or an already populated table. Depending on the case, every type of field (columns) cannot always be deleted:

images/download/attachments/615293193/image2020-8-14_12-8-52.png
The basic structure of the JSON file must present a "type" : "deleteColumn" field which enables you to delete a field from a given existing table.

Download a JSON file example: deleteColumn.json

Adding a possible value to an existing field

It is possible to define possible pre-defined values for a field.

The basic structure of the JSON file must present a "type" : "addEnumValue" field which enables you to add one or more values to an existing field.

Download a JSON file example: addEnum.json (example on the basis of several added values)

Indexing an existing field in a table

The basic structure of the JSON file must present a "type" : "addIndex" field.

This allows you specify the field that you want to index.

Download a JSON file example: addIndex.json

Making an existing field 'Mandatory'

The basic structure of the JSON file must present a "type" : "mandatoryColumn" field.

In order to make a field 'mandatory' in an already populated table, this field must obligatorily have a value for each entry of the table. If the field is empty for a single entry, you will obtain an error.

Download a JSON file example: mandatoryColumn.json

Displaying fields in the interaction

It is possible to choose to display a list of fields of an 'Interaction' or 'Linked Data' custom table directly in the summary of a profile interaction (meaning before clicking on the eye icon which opens the whole list of information)

Download a JSON file example: nonStructural.json

Deleting a table

You can delete both an empty or an already populated existing table.

Please proceed with caution: deleting a table can have a negative impact if the deleted table was used in scenarios, in campaign personalizations, in saved targetings, in segmentations,...

Unlike the above processes, deleting a table does not require uploading a JSON file. A dedicated 'Delete the table' option is available through the 'More' menu.

Alt text

A warning modal will require you to confirm the table deletion. Indeed, all the data stored in the table will be lost, without any option to restore it!

caution

If you delete an Interaction table linked to an aggregate table, the aggregate table will be deleted as well, as it cannot exist without a source.

Alt text