modèle de contenu XML

Retourner à la version anglaise de la documentation

Dernière mise à jour : 04 oct. 2024

modèle de contenu XML

Le modèle de contenu XML donne accès au contenu XML.

Le modèle de contenu XML prend en charge la capacité à accéder aux composants basés sur des expressions XPath. Les expressions XPath sont des chaînes qui définissent les éléments ou les attributs qui sont requis par l'appelant. Le modèle de contenu XML masque les détails de la génération de divers objet et de différentes expressions de compilation qui sont généralement nécessaires pour la prise en charge de XPath. Il est plus simple d'appeler à partir du scriptage Python .

Le modèle de contenu XML inclut une fonction qui renvoie le document XML sous forme de chaîne, de sorte que les utilisateurs de script Python puissent utiliser leur bibliothèque Python préférée pour analyser le XML.

Tableau 1. Méthodes pour le modèle de contenu XML
Méthode	Types de retour	Descriptif
`getXMLAsString()`	`String`	Renvoie le code XML sous forme de chaîne.
`getNumericValue(String xpath)`	`number`	Renvoie le résultat de l'évaluation du chemin avec un type de retour numérique (par exemple, comptage du nombre d'éléments qui correspondent à l'expression de chemin).
`getBooleanValue(String xpath)`	`boolean`	Renvoie le résultat booléen de l'évaluation de l'expression de chemin spécifiée.
`getStringValue(String xpath, String attribute)`	`String`	Renvoie la valeur d'attribut ou la valeur de noeud XML qui correspond au chemin spécifié.
`getStringValues(String xpath, String attribute)`	`List of strings`	Renvoie la liste de toutes les valeurs d'attribut ou les valeurs de noeud XML qui correspondent au chemin spécifié.
`getValuesList(String xpath, <List of strings> attributes, boolean includeValue)`	`List of lists of strings`	Renvoie la liste de toutes les valeurs d'attribut qui correspondent au chemin spécifié avec la valeur de noeud XML si nécessaire.
`getValuesMap(String xpath, String keyAttribute, <List of strings> attributes, boolean includeValue)`	`Hash table (key:string, value:list of string)`	Renvoie une table de hachage qui utilise l'attribut de clé ou la valeur de noeud XML en tant que clé, et la liste des valeurs d'attribut spécifiées en tant que valeurs de table.
`isNamespaceAware()`	`boolean`	Indique si les analyseurs syntaxiques XML doivent prendre en compte les espaces de nom. La valeur par défaut est `False`.
`setNamespaceAware(boolean value)`	`void`	Définit si les analyseurs syntaxiques XML doivent prendre en compte les espaces de nom. Cela appelle également `reset()` pour s'assurer que les changements sont pris en compte par les appels suivants.
`reset()`	`void`	Vide la mémoire interne associée à ce modèle de contenu (par exemple, un objet DOM mis en cache).

Noeuds et sorties

Ce tableau répertorie les noeuds qui génèrent des sorties incluant ce type de modèle de contenu.

Tableau 2. Noeuds et sorties
Nom du noeud	Nom de sortie	ID de conteneur
`Most model builders`	`Most generated models`	`"PMML"`
`"autodataprep"`	`n/a`	`"PMML"`

Exemple de script

Le code de scriptage Python permettant d'accéder au contenu peut ressembler à ceci :

results = []
modelbuilder.run(results)
modeloutput = results[0]
cm = modeloutput.getContentModel("PMML")

dataFieldNames = cm.getStringValues("/PMML/DataDictionary/DataField", "name")
predictedNames = cm.getStringValues("//MiningSchema/MiningField[@usageType='predicted']", "name")