modèle de contenu JSON

Retourner à la version anglaise de la documentation

Dernière mise à jour : 04 oct. 2024

modèle de contenu JSON

Le modèle de contenu JSON est utilisé pour accéder au contenu stocké au format JSON. Il fournit une API de base pour permettre aux appelants d'extraire des valeurs en supposant qu'ils savent quelles valeurs sont accessibles.

Tableau 1. Méthodes pour le modèle de contenu JSON
Méthode	Types de retour	Descriptif
`getJSONAsString()`	`String`	Renvoie le contenu JSON sous forme de chaîne.
`getObjectAt(<List of cbjecta> path, JSONArtifact artifact) throws Exception`	`Object`	Renvoie l'objet dans le chemin spécifié. L'artefact racine fourni peut être null, auquel cas la racine du contenu est utilisée. La valeur renvoyée peut être une chaîne littérale, un entier, un réel ou une valeur booléenne, ou un artefact JSON (un objet JSON ou un tableau JSON).
`getChildValuesAt(<List of object> path, JSONArtifact artifact) throws Exception`	`Hash table (key:object, value:object>`	Renvoie les valeurs enfant du chemin spécifié si le chemin mène à un objet JSON, sinon renvoie NULL. Les clés de la table sont des chaînes alors que la valeur associée peut être une chaîne littérale, un entier, un réel ou un booléen, ou un artefact JSON (un objet JSON ou un tableau JSON).
`getChildrenAt(<List of object> path path, JSONArtifact artifact) throws Exception`	`List of objects`	Renvoie la liste d'objets du chemin spécifié si le chemin mène à un tableau JSON, sinon renvoie NULL. Les valeurs renvoyées peuvent être une chaîne littérale, un entier, un réel ou une valeur booléenne, ou un artefact JSON (un objet JSON ou un tableau JSON).
`reset()`	`void`	Vide la mémoire interne associée à ce modèle de contenu (par exemple, un objet DOM mis en cache).

Exemple de script

Si un noeud de création de sortie crée une sortie basée sur le format JSON, vous pouvez utiliser les éléments suivants pour accéder aux informations relatives à un ensemble de livres:

results = []
outputbuilder.run(results)
output = results[0]
cm = output.getContentModel("jsonContent")

bookTitle = cm.getObjectAt(["books", "ISIN123456", "title"], None)

# Alternatively, get the book object and use it as the root
# for subsequent entries
book = cm.getObjectAt(["books", "ISIN123456"], None)
bookTitle = cm.getObjectAt(["title"], book)

# Get all child values for aspecific book
bookInfo = cm.getChildValuesAt(["books", "ISIN123456"], None)

# Get the third book entry. Assumes the top-level "books" value
# contains a JSON array which can be indexed
bookInfo = cm.getObjectAt(["books", 2], None)

# Get a list of all child entries
allBooks = cm.getChildrenAt(["books"], None)