Similaires aux formats de fichiers d'entité globale, quatre formats de fichiers JSON différents sont pris en charge dans le portail brainCloud.
Format d'objet JSON brut - fortement recommandé pour les sauvegardes et la migration de données.
Format de ligne JSON brut - utile pour l'intégration avec des outils externes prenant en charge le format de ligne JSON. Métadonnées incluses.
Format d'objet JSON simplifié - très bon pour l'intégration avec des outils externes.
Format de ligne JSON simplifié - utile pour l'intégration avec des outils externes prenant en charge le format de ligne JSON. Limité à un seul type d'entité par fichier.
Chacun des formats de fichier est décrit plus en détail ci-dessous.
Format d'objet JSON brut:
Vous trouverez ci-dessous un fichier objet JSON brut.
{
"dynamicChannel": [
{
"entityId": "d02137df-06de-413e-9ef7-34216de06454",
"version": 1,
"acl": {
"other": 2
},
"ownerId": null,
"expiresAt": null,
"timeToLive": null,
"createdAt": 1687874382272,
"updatedAt": 1687874382272,
"appId": "13229",
"data": {
"id": "13229:dy:dynamic_1",
"type": "dy",
"code": "dynamic_1",
"name": "dynamic_1",
"desc": "dynamic_1 channel"
}
},
{
"entityId": "1075946e-6cea-4390-921d-6b43a6c8f636",
"version": 1,
"acl": {
"other": 2
},
"ownerId": null,
"expiresAt": null,
"timeToLive": null,
"createdAt": 1687904590872,
"updatedAt": 1687904590872,
"appId": "13229",
"data": {
"id": "13229:dy:dynamic_1",
"type": "dy",
"code": "dynamic_1",
"name": "dynamic_1",
"desc": "dynamic_1 channel"
}
},
{
"entityId": "ccb3cd5f-08f9-4c7b-9915-87a2c330bde0",
"version": 1,
"acl": {
"other": 2
},
"ownerId": null,
"expiresAt": null,
"timeToLive": null,
"createdAt": 1710255034434,
"updatedAt": 1710255034434,
"appId": "13229",
"data": {
"id": "13229:dy:dynamic_1",
"type": "dy",
"code": "dynamic_1",
"name": "dynamic_1",
"desc": "dynamic_1 channel"
}
}
]
}
Spécificités du format de fichier:
Les types d'entités sont inclus dans des tableaux JSON - et plusieurs types d'entités sont donc pris en charge.
Les métadonnées de brainCloud sont préservées
entityId
version
acl
ownerId
expiresAt
timeToLive
createdAt
updatedAt
appId
Notez que bien que l'exemple ci-dessous ne montre qu'un seul type d'entité - "dynamicChannel", la structure du fichier permet à plusieurs types d'entités d'être présents dans un seul fichier.
Format des lignes JSON brutes:
Les fichiers de lignes JSON brutes ont une structure un peu plus simple que les fichiers d'objets JSON bruts, dans la mesure où ils ne nécessitent pas la structure de tableau d'objets englobante.
{"entityId":"d02137df-06de-413e-9ef7-34216de06454","version":1,"acl":{"other":2},"ownerId":null,"expiresAt":null,"timeToLive":null,"createdAt":1687874382272,"updatedAt":1687874382272,"data":{"id":"13229:dy:dynamic_1","type":"dy","code":"dynamic_1","name":"dynamic_1","desc":"dynamic_1 channel"}}
{"entityId":"1075946e-6cea-4390-921d-6b43a6c8f636","version":1,"acl":{"other":2},"ownerId":null,"expiresAt":null,"timeToLive":null,"createdAt":1687904590872,"updatedAt":1687904590872,"data":{"id":"13229:dy:dynamic_1","type":"dy","code":"dynamic_1","name":"dynamic_1","desc":"dynamic_1 channel"}}
{"entityId":"ccb3cd5f-08f9-4c7b-9915-87a2c330bde0","version":1,"acl":{"other":2},"ownerId":null,"expiresAt":null,"timeToLive":null,"createdAt":1710255034434,"updatedAt":1710255034434,"data":{"id":"13229:dy:dynamic_1","type":"dy","code":"dynamic_1","name":"dynamic_1","desc":"dynamic_1 channel"}}Chaque ligne du fichier est considérée comme un objet JSON distinct.
Pour cette raison, les fichiers JSON Lines ne peuvent prendre en charge qu'un seul _entityType_ par fichier.
Notez que nous utilisons un exemple plus simple pour une meilleure lisibilité. Notez également que le fichier ci-dessus ne contient que trois lignes (le retour à la ligne semble plus long - notez les numéros de ligne).
Format d'objet JSON simplifié:
Le JSON simplifié est très lisible et adapté à l'importation et à l'exportation aller-retour avec des outils tels que Google Sheets.
Il minimise la structure et les frais généraux imposés par brainCloud, bien que cela comporte des limitations (ACL au niveau de l'enregistrement, propriété et entityIds ne sont pas conservés).
Spécificités du format de fichier:
Les types d'entités sont inclus dans des tableaux JSON - plusieurs types d'entités sont donc pris en charge. ← Identique à RAW
Les métadonnées de brainCloud ne sont PAS conservées.
L'absence d'une section "données" rend l'objet plus facile à visualiser et à comprendre
{
"dynamicChannel": [
{
"id": "13229:dy:dynamic_1",
"type": "dy",
"code": "dynamic_1",
"name": "dynamic_1",
"desc": "dynamic_1 channel"
},
{
"id": "13229:dy:dynamic_1",
"type": "dy",
"code": "dynamic_1",
"name": "dynamic_1",
"desc": "dynamic_1 channel"
},
{
"id": "13229:dy:dynamic_1",
"type": "dy",
"code": "dynamic_1",
"name": "dynamic_1",
"desc": "dynamic_1 channel"
}
]
}Notez que bien que l'exemple ci-dessous ne montre qu'un seul type d'entité - "dynamicChannel", la structure du fichier permet à plusieurs types d'entités d'être présents dans un seul fichier.
Format simplifié des lignes JSON:
Les fichiers JSON Lines ont une structure un peu plus simple que les fichiers objets JSON, dans la mesure où ils ne nécessitent pas la structure de tableau d'objets englobante.
{"id":"13229:dy:dynamic_1","type":"dy","code":"dynamic_1","name":"dynamic_1","desc":"dynamic_1 channel"}
{"id":"13229:dy:dynamic_1","type":"dy","code":"dynamic_1","name":"dynamic_1","desc":"dynamic_1 channel"}
{"id":"13229:dy:dynamic_1","type":"dy","code":"dynamic_1","name":"dynamic_1","desc":"dynamic_1 channel"}
Chaque ligne du fichier est considérée comme un objet JSON distinct.
Pour cette raison, les fichiers JSON Lines ne peuvent prendre en charge qu'un seul _entityType_ par fichier.
Notez que nous utilisons un exemple plus simple pour une meilleure lisibilité. Notez également que le fichier ci-dessous ne contient que trois lignes (le retour à la ligne semble plus long ; notez les numéros de ligne).