Aller au contenu principal

Modifier une table personnalisée

Pour apporter une modification à une "Table personnalisée", rendez-vous dans l'application "Gérer les structures de tables" (Catalogue > Modèle de données > Gérer les structures de table).

images/download/thumbnails/615292931/image2019-5-17_10-32-52.png

Sélectionnez la table à modifier, puis cliquez sur le bouton "Mettre à jour".

Alt text

Cette action ouvrira une fenêtre modale.

Alt text

Il est demandé de charger un fichier de définition. Celui-ci doit être au format JSON.

Les modifications de tables qui sont possibles à ce jour sont les suivantes :

Ajouter un champ (colonne)

L’ajout d’une colonne peut se faire sur une table déjà existante soit vide, soit déjà populée. Selon le cas, tous les types de champs ne pourront pas être créées :

7

Si vous souhaitez ajouter un champ obligatoire ou clé à une base déjà populée, il sera nécessaire de passer par la suppression complète de la table et sa re-création. N’oubliez pas d’exporter vos données au préalable.

La structure de base du JSON doit présenter un champ "type" : "addColumn" qui permet d’ajouter un champ à la table existante sélectionnée.

Télécharger un fichier JSON d'exemple : addColumn.json

Ajouter un champ

{
    "type":"addColumn",
    "columns" :
    [
        {
            "propertyName": "newField",
            "columnName": "newField",
            "type": "STRING",
            "required": false,
            "indexed": false,
            "cacheIndexed": false,
            "possibleValues": ["First","Second","Third"],
            "description": "hell yeah",
            "options":
            {
                "unique": false,
                "userName": "My new field",
                "extended":false,
                "valueDisplayer" :
                {
                    "displayerType": "CivilState / PersonTitle / Gender / Country / Language"
                },
                "typeValidator" :
                {
                    "objectType": "EMAIL_ADDRESS / SEX / COUNTRY / LANGUAGE / PHONE_NUMBER / CIVIL_STATE / PERSON_TITLE / STRING_LENGTH",
                    "minCharacters": 15,
                    "maxCharacters": 124
                }
            }
        }   
    ]
}

Supprimer un champ (colonne)

La suppression d’une colonne se fait sur une table existante soit vide, soit déjà populée. Selon le cas, tous les types de champs ne pourront pas être supprimés :

8

La structure de base du JSON doit présenter un champ "type" : "deleteColum" qui permet de supprimer un champ à la table existante sélectionnée.

Télécharger un fichier JSON d'exemple : deleteColumn.json

Supprimer un champ

{
    "type":"deleteColumn",
    "propertyName": "newField4"
}

Ajouter une valeur possible à un champ existant

Il est possible de définir des valeurs possibles pré-définies pour un champ.

La structure de base du JSON doit présenter un champ "type" : "addEnumValue" qui permet d'ajouter une ou plusieurs valeur(s) à un champ existant.

Télécharger un fichier JSON d'exemple : addEnum.json (exemple sur base de plusieurs valeurs ajoutées)

Ajouter une valeur possible à un champ

{
    "type" : "addEnumValue",
    "propertyName" : "fieldNameToAddPossibleValue",
    "valuesToAdd" : ["First","Second","Third"]
}

Indexer un champ existant dans une table

La structure de base du JSON doit présenter un champ "type" : "addIndex".

Cela permet d'indiquer le champ à indexer.

Télécharger un fichier JSON d'exemple : addIndex.json

Indexer un champ existant dans une table

{
    "type":"addIndex",
    "propertyName": "nameOfFieldToIndex"
}

Rendre un champ existant obligatoire

La structure de base du JSON doit présenter un champ "type" : "mandatoryColumn"

Pour rendre un champ obligatoire dans une table déjà populée avec des données, ce champ devra obligatoirement être rempli pour chaque ligne de la table. Si pour une ligne le champ est vide, une erreur sera obtenue.

Télécharger un fichier JSON d'exemple : mandatoryColumn.json

Rendre un champ existant obligatoire

{
    "type":"mandatoryColumn",
    "propertyName": "nameOfFieldToAddMandatory"
}

Afficher des champs de la table dans l’interaction

Il est possible de choisir d’afficher une liste de champs d’une table de type ‘Interaction’ ou ‘Données liées’ directement dans le résumé de l’ "interaction du profil" (c'est-à-dire, avant d’avoir cliqué dans l’œil qui permet de voir l’ensemble des informations)

Télécharger un fichier JSON d'exemple : nonStructural.json

Afficher des champs de la table dans l'interaction

{"type": "nonStructural",    "layout": {"list": {"fields": ["language","emailAddress","mobile","url"]}}}

Supprimer une table

La suppression d’une table peut porter sur une table existante soit vide, soit déjà populée.

Faites bien attention lorsque vous décidez de supprimer une table : cette suppression peut avoir des impacts si la table supprimée était utilisée dans des scénarios, de la personnalisation de campagnes continues, des ciblages sauvegardés, des segmentations, …

Contrairement aux opérations ci-dessus, supprimer une table ne demande pas le chargement d'un fichier JSON. Une option dédiée 'Supprimer la table' est disponible via le menu 'Plus'.

Alt text

Une modale d'avertissement nécessite votre confirmation de la suppression de la table. En effet, toutes les données stockées dans la table seront perdues, sans aucune option pour les restaurer.

Avertissement

Si vous supprimez une table d'Interactions liée à une table d'agrégats, la table d'agrégat sera également supprimée, étant donné qu'elle ne peut pas exister sans source.

Alt text