Importer un schéma JSON
Talend Data Mapper vous permet de créer une structure JSON à partir d'un schéma JSON.
Pour plus d'informations concernant le support d'éléments de schémas JSON, consultez Support des schémas JSON.
Talend Data Mapper n'utilise pas les schémas JSON pour valider les documents JSON. Ils sont utilisés uniquement en tant que modèles, pour créer des structures JSON. Par exemple, si une chaîne de caractères est définie comme "maxLength": 15, aucune erreur n'est retournée si la chaîne de caractères dépasse les 15 caractères.
Avant de commencer
- Vous avez un fichier de schéma JSON à importer.
- Vous avez ajouté toute référence devant être ignorée à la liste de blocage Reference blacklist dans . Pour plus d'informations, consultez Préférences des représentations.
Pourquoi et quand exécuter cette tâche
{
"$id": "https://example.com/arrays.schema.json",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "A representation of a list of customers.",
"type": "object",
"properties": {
"customers": {
"type": "array",
"items": {
"$ref": "#/$defs/customer"
}
}
},
"$defs": {
"customer": {
"type": "object",
"properties": {
"LastName": {
"type": "string",
"description": "The customer's last name."
},
"firstName": {
"type": "string",
"description": "The customer's last name."
},
"address": {
"type": "object",
"description": "The customer's address.",
"properties": {
"street": {
"type": "string"
},
"postCode": {
"type": "integer"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"type": "string"
}
}
}
}
}
}
}
Procédure
- Dans l'onglet Data Mapper, développez le nœud Hierarchical Mapper et cliquez-droit sur Structures.
- Cliquez sur .
- Dans l'assistant qui s'ouvre, sélectionnez Import a structure definition et cliquez sur Next (Suivant).
- Sélectionnez le type d'import, JSON Schema dans cet exemple, puis cliquez sur Next.
-
Sélectionnez le fichier à utiliser :
- Sélectionnez une ressource existante dans votre espace de travail.
- Importez un fichier local.
- Saisissez l'URL du fichier.
- Cliquez sur Next.
- Sélectionnez un dossier et saisissez le nom de la nouvelle structure, puis cliquez sur Next (Suivant).
- Cliquez sur Finish.
Résultats
Une structure JSON est créée, avec tous les éléments spécifiés dans le schéma. Si vous importez un document échantillon suivant ce schéma, vous pouvez voir les éléments mis en valeur correctement. Avec le schéma utilisé dans cet exemple, vous pouvez importer l'échantillon suivant :
{
"customers":[
{
"lastName":"Smith",
"firstName":"Jane",
"address":{
"street":"4876 Felosa Drive",
"postCode":90017,
"city":"Los Angeles",
"state":"CA",
"country":"United States"
}
},
{
"lastName":"Doe",
"firstName":"John",
"address":{
"street":"4862 Parkway Street",
"postCode":92203,
"city":"Bermuda Dunes",
"state":"CA",
"country":"United States"
}
}
]
}
Le résultat est le suivant :