Utiliser un template JSON

ACTITO met à votre disposition des templates de fichiers JSON vous permettant de créer directement des tables de données personnalisées correspondant à des utilisations fréquentes.

Ces fichiers peuvent être utilisés dans l'état avec les attributs prédéfinis, ou être modifiés pour s'adapter aux besoins propres à votre activité (par exemple, modifier le nom de la table ou le nom d'un attribut, ajouter un attribut supplémentaire, ...). Pour toute modification du fichier, veillez à respecter les contraintes expliquées sur la page "Structurer votre fichier de définition JSON".

Exemples de tables de type Données liées

La table "Enfants"

Vous avez la possibilité de créer une table "Enfants". Il s'agit d'une table de type Données liées, qui est donc relative à un profil et permet de recueillir des informations générales et s'inscrivant dans la durée.

Dans ce cas, ce template de table vous permettra de conserver les informations relatives aux enfants de chacun de vos profils.

Dans ACTITO, les utilisations de ces informations sont multiples :

  • Faire appel au prénom d'un enfant dans une personnalisation.

  • Conditionner un e-mail en fonction de l'âge de l'enfant du profil visé.

  • Conditionner un e-mail selon que le profil visé ait une fille ou un garçon

  • Déclencher un scénario pour l'anniversaire d'un enfant.

  • ...

Les attributs prédéfinis pour le template "Enfants" sont :

  • le nom de famille et le prénom de l'enfant

  • le genre de l'enfant

  • la date de naissance de l'enfant

  • l'identifiant de l'enfant

  • l'identifiant du parent, qui fait le lien avec la table de profil

Téléchargez le template de fichier de définition JSON pour une table "Enfants" : Children_FR.json

Children_FR.json
{
"userName": "Enfants",
"technicalName": "children",
"businessKey": "childId",
"autoGeneratedBusinessKey": false,
"description": "",
"creationTimeColumn": null,
"entityName": "entityName",
"prettyNameExpression": null,
"layout": {
"list": null,
"details": null
},
"emails": [],
"capabilityDTOs": [
{
"name": "ProfileData"
}
],
"defaultFetchingParameters": [],
"links": [
{
"objectType": "PROFILE_LINK",
"linkName": "profileLink",
"sourceFieldName": "profileId",
"targetFieldName": "profileId",
"constraintType": "onDeleteCascade",
"targetedEntityName": "entityName",
"skipIntegrityCheck": null,
"targetedProfileTableName": "tableName"
}
],
"tableEventDefinitions": [],
"fields": [
{
"objectType": "SIMPLE",
"fieldName": "lastName",
"columnName": "lastName",
"userName": "Nom",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
 
{
"objectType": "SIMPLE",
"fieldName": "firstName",
"columnName": "firstName",
"userName": "Prénom",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "gender",
"columnName": "gender",
"userName": "Genre",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "SEX"
}
},
{
"objectType": "SIMPLE",
"fieldName": "birthdate",
"columnName": "birthdate",
"userName": "Anniversaire",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "DATE",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "childId",
"columnName": "childId",
"userName": "Id de l'enfant",
"required": true,
"unique": true,
"extended": false,
"indexed": true,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 100
}
},
{
"objectType": "SIMPLE",
"fieldName": "profileId",
"columnName": "profileId",
"userName": "Id du parent",
"required": true,
"unique": false,
"extended": true,
"indexed": true,
"cacheIndexed": false,
"description": null,
"type": "LONG",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
}
],
"rowCleaning": {
"cleanPredicate": null,
"fifoLimit": null,
"softLimit": false,
"hardLimit": false
},
"entityId": 11
}

La table "Parrainage"

Vous avez la possibilité de créer une table "Parrainage". Il s'agit d'une table de type Données liées, qui est donc relative à un profil et permet de recueillir des informations générales et s'inscrivant dans la durée.

Dans ce cas, ce template de table vous permettra de conserver les informations relatives aux nouveaux contacts que vous avez acquis grâce au parrainage du profil existant.

Dans ACTITO, vous pourrez utiliser ces informations pour :

  • Faire référence au nom du filleul (via une personnalisation) dans un e-mail destiné au parrain

  • Cibler vos profils qui ont rapporté le plus de nouveaux contacts pour les récompenser (grâce au critère "Nombre de" dans le module de ciblage)

  • ...

Les attributs prédéfinis pour le template "Parrainage" sont :

  • Le nom de famille et le prénom du filleul

  • La date de la recommandation

  • Le type de relation entre le parrain et le nouveau contact

  • La date de conversion, qui correspond au moment d'activation du filleul

  • L'identifiant du parrainage

  • L'identifiant du parrain, qui fait le lien avec la table de profil

Téléchargez le template de fichier de définition JSON pour une table "Parrainage" : Sponsorship_FR.json

Sponsorship_FR.json
{
"userName": "Parrainage",
"technicalName": "sponsorship",
"businessKey": "sponsorshipId",
"autoGeneratedBusinessKey": false,
"description": "",
"creationTimeColumn": null,
"entityName": "entityName",
"prettyNameExpression": null,
"layout": {
"list": null,
"details": null
},
"emails": [],
"capabilityDTOs": [
{
"name": "ProfileData"
}
],
"defaultFetchingParameters": [],
"links": [
{
"objectType": "PROFILE_LINK",
"linkName": "profileLink",
"sourceFieldName": "profileId",
"targetFieldName": "profileId",
"constraintType": "onDeleteCascade",
"targetedEntityName": "entityName",
"skipIntegrityCheck": null,
"targetedProfileTableName": "tableName"
}
],
"tableEventDefinitions": [],
"fields": [
{
"objectType": "SIMPLE",
"fieldName": "lastName",
"columnName": "lastName",
"userName": "Nom",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "firstName",
"columnName": "firstName",
"userName": "Prénom",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "date",
"columnName": "date",
"userName": "Date",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "DATE",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "relationType",
"columnName": "relationType",
"userName": "Type de relation",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "conversionDate",
"columnName": "conversionDate",
"userName": "Date de conversion",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "DATE",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "sponsorshipId",
"columnName": "sponsorshipId",
"userName": "Id",
"required": true,
"unique": true,
"extended": false,
"indexed": true,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 100
}
},
{
"objectType": "SIMPLE",
"fieldName": "profileId",
"columnName": "profileId",
"userName": "Id du parrain",
"required": true,
"unique": false,
"extended": true,
"indexed": true,
"cacheIndexed": false,
"description": null,
"type": "LONG",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
}
],
"rowCleaning": {
"cleanPredicate": null,
"fifoLimit": null,
"softLimit": false,
"hardLimit": false
},
"entityId": 11
}

Exemple de table de type Référentiel

La table "Entreprise"

Vous avez la possibilité de créer une table "Entreprise". Il s'agit d'une table de type référentiel, qui contient donc des données de référence communes à tous ou une partie des profils.

Dans ce cas, ce template vous permettra de conserver les informations liées à une liste d'entreprises. La notion d'entreprise étant très large, l'usage de ce template sera facilement adaptable à une utilisation propre à votre activité, si besoin grâce à des modifications mineures. L'entreprise peut tout autant faire référence à :

  • Un magasin : il peut aussi bien être lié à une table de profil (par exemple, magasin préféré du profil) ou à une table personnalisée (par exemple, magasin où a été effectué un achat)

  • Une filiale : ceci permet d'associer chaque profil à la filiale responsable de sa région

  • L'entreprise à laquelle un contact B2B appartient

  • Un hôpital : par exemple, renseigner l'hôpital le plus proche de l'adresse de chaque profil

  • ...

A savoir

Veuillez noter que le volume maximal accepté dans une table de type Référentiel est de 250 000 cellules.

Les attributs prédéfinis pour le template "Entreprise" sont :

  • Le nom de l'entreprise

  • L'adresse de l'entreprise (attributs "rue", "numéro", "code postal", "ville" et "pays")

  • Le numéro de TVA

  • L'identifiant de l'entreprise

Téléchargez le template de fichier de définition JSON pour une table "Entreprise" : Company_FR.json

Company_FR
{
"userName": "Entreprise",
"technicalName": "Company",
"businessKey": "companyId",
"autoGeneratedBusinessKey": null,
"description": "null",
"creationTimeColumn": null,
"entityName": "entityName",
"prettyNameExpression": null,
"layout": {
"list": null,
"details": null
},
"emails": [],
"capabilityDTOs": [
{
"name": "LookupTable"
}
],
"defaultFetchingParameters": [],
"links": [ ],
"tableEventDefinitions": [],
"fields": [
{
"objectType": "SIMPLE",
"fieldName": "name",
"columnName": "name",
"userName": "Nom",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": true,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "street",
"columnName": "street",
"userName": "Rue",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 100
}
},
{
"objectType": "SIMPLE",
"fieldName": "number",
"columnName": "number",
"userName": "Numero",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 10
}
},
{
"objectType": "SIMPLE",
"fieldName": "postalcode",
"columnName": "postalcode",
"userName": "Code postal",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 20
}
},
{
"objectType": "SIMPLE",
"fieldName": "locality",
"columnName": "locality",
"userName": "Ville",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "country",
"columnName": "country",
"userName": "Pays",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": {
"displayerType": "Country"
},
"typeValidator": {
"objectType": "COUNTRY"
}
},
{
"objectType": "SIMPLE",
"fieldName": "vat",
"columnName": "vat",
"userName": "Numero TVA",
"required": false,
"unique": true,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 15
}
},
{
"objectType": "SIMPLE",
"fieldName": "companyId",
"columnName": "companyId",
"userName": "Id",
"required": true,
"unique": true,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 10
}
}
],
"rowCleaning": {
"cleanPredicate": null,
"fifoLimit": null,
"softLimit": false,
"hardLimit": false
},
"entityId": 11
}

Exemple de table de type Interaction

La table "Evénement"

Vous avez la possibilité de créer une table "Evénement". Il s'agit d'une table de type Interaction, qui permet de recueillir des données ponctuelles qui sont enregistrées lorsqu'un profil interagit avec votre activité.

Dans ce cas, ce template vous permettra de conserver toutes les informations relatives à la participation d'un profil à un événement. Selon votre activité, la notion d'événement peut prendre de nombreuses définitions :

  • Un concert

  • Un gala de charité

  • Une conférence

  • Un salon

  • Un voyage

  • ...

Des adaptations minimes du fichier de définition peuvent vous permettre de répondre à votre propre définition d'un événement

Dans ACTITO, vous pourrez utiliser ces informations pour :

  • Vous pouvez faire référence aux données de l'événement dans la personnalisation d'un e-mail, par exemple pour confirmer une inscription à l'événement, donner les coordonnées et l'horaire de l'événement, ...

  • Vous pouvez conditionner un e-mail selon qu'un profil ait participé ou non à l'événement

  • Grâce à la capacité "EventGeneratedTable", un événement sera enregistré dans ACTITO à chaque création de ligne, ce qui permettra de déclencher un scénario dès qu'un profil s'inscrit à un événement, ou quelques jours après qu'il ait assisté à un événement, ...

  • ...

Les attributs prédéfinis pour le template "Evénement" sont :

  • Le moment de début et le moment de fin de l'événement

  • La date d'inscription à l'événement

  • Le lieu de déroulement de l'événement

  • Le nom de l'événement

  • Le code d'inscription

  • Le statut de la participation

  • Le type de ticket

  • Le prix du ticket

  • L'identifiant de l'événement

  • L'identifiant du profil assistant à l'événement, qui permet de faire le lien avec la table de profil

Téléchargez le template de fichier de définition JSON pour une table "Evénement" : Event_FR.json

Event_FR.json
{
"userName": "Événement",
"technicalName": "Event",
"businessKey": "EventId",
"autoGeneratedBusinessKey": false,
"description": null,
"creationTimeColumn": null,
"entityName": "entityName",
"prettyNameExpression": null,
"layout": {
"list": null,
"details": null
},
"emails": [],
"capabilityDTOs": [
{
"name": "Interaction"
},
{
"name": "EventGeneratedTable"
}
],
"defaultFetchingParameters": [],
"links": [
{
"objectType": "PROFILE_LINK",
"linkName": "Event participation",
"constraintType": "onDeleteCascade",
"sourceFieldName": "profileId",
"targetFieldName": "profileId",
"targetedEntityName": "entityName",
"targetedProfileTableName": "tableName"
}
],
"tableEventDefinitions": [
{
"technicalName": "create",
"userName": "Nouveau",
"tableEventConditionDefinitions": [
{
"updatedProperties": [],
"type": "CREATE",
"beforePredicate": null,
"afterPredicate": null
}
]
},
{
"technicalName": "update",
"userName": "Mise à jour",
"tableEventConditionDefinitions": [
{
"updatedProperties": [
"Participated"
],
"type": "UPDATE",
"beforePredicate": {
"type": "S",
"names": [
"profileId"
],
"operator": [
"U",
"isKnown"
]
},
"afterPredicate": {
"type": "S",
"names": [
"profileId"
],
"operator": [
"U",
"isKnown"
]
}
}
]
}
],
"fields": [
{
"objectType": "SIMPLE",
"fieldName": "startMoment",
"columnName": "startMoment",
"userName": "Moment de départ",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "TIMESTAMP",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "endMoment",
"columnName": "endMoment",
"userName": "Moment de fin",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "TIMESTAMP",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "subscriptionDate",
"columnName": "subscriptionDate",
"userName": "Date d'inscription",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "DATE",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "EventPlace",
"columnName": "EventPlace",
"userName": "Lieu",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 256
}
},
{
"objectType": "SIMPLE",
"fieldName": "EventName",
"columnName": "EventName",
"userName": "Nom",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": true,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "SubscriptionCode",
"columnName": "SubscriptionCode",
"userName": "Code",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": null,
"type": "LONG",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 50
}
},
{
"objectType": "SIMPLE",
"fieldName": "status",
"columnName": "status",
"userName": "Statut",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": true,
"description": null,
"type": "STRING",
"possibleValues": [
"Subscribe",
"Paid",
"Participated",
"DidNotParticipated",
"Cancelled"],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 20
}
},
{
"objectType": "SIMPLE",
"fieldName": "ticketType",
"columnName": "ticketType",
"userName": "Type",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": true,
"description": null,
"type": "STRING",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": {
"objectType": "STRING_LENGTH",
"minCharacters": 0,
"maxCharacters": 20
}
},
{
"objectType": "SIMPLE",
"fieldName": "price",
"columnName": "price",
"userName": "Prix",
"required": false,
"unique": false,
"extended": false,
"indexed": false,
"cacheIndexed": false,
"description": "",
"type": "INTEGER",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "EventId",
"columnName": "EventId",
"userName": "Id de l'événement",
"required": true,
"unique": true,
"extended": false,
"indexed": true,
"cacheIndexed": false,
"description": "",
"type": "LONG",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
},
{
"objectType": "SIMPLE",
"fieldName": "profileId",
"columnName": "profileId",
"userName": "Id du profil",
"required": true,
"unique": false,
"extended": false,
"indexed": true,
"cacheIndexed": false,
"description": null,
"type": "LONG",
"possibleValues": [],
"valueDisplayer": null,
"typeValidator": null
}
],
"rowCleaning": {
"cleanPredicate": null,
"fifoLimit": null,
"softLimit": false,
"hardLimit": false
},
"entityId": 11
}