Ce service permet aux scripts d'analyser, de parcourir et de créer de manière automatisée des documents XML.
// Log the title and labels for the first page of blog posts on the // Google Workspace Developer blog. function parseXml() { var url = 'https://gsuite-developers.googleblog.com/atom.xml'; var xml = UrlFetchApp.fetch(url).getContentText(); var document = XmlService.parse(xml); var root = document.getRootElement(); var atom = XmlService.getNamespace('http://www.w3.org/2005/Atom'); var entries = root.getChildren('entry', atom); for (var i = 0; i < entries.length; i++) { var title = entries[i].getChild('title', atom).getText(); var categoryElements = entries[i].getChildren('category', atom); var labels = []; for (var j = 0; j < categoryElements.length; j++) { labels.push(categoryElements[j].getAttribute('term').getValue()); } Logger.log('%s (%s)', title, labels.join(', ')); } } // Create and log an XML representation of the threads in your Gmail inbox. function createXml() { var root = XmlService.createElement('threads'); var threads = GmailApp.getInboxThreads(); for (var i = 0; i < threads.length; i++) { var child = XmlService.createElement('thread') .setAttribute('messageCount', threads[i].getMessageCount()) .setAttribute('isUnread', threads[i].isUnread()) .setText(threads[i].getFirstMessageSubject()); root.addContent(child); } var document = XmlService.createDocument(root); var xml = XmlService.getPrettyFormat().format(document); Logger.log(xml); }
Propriétés
Propriété | Type | Description |
---|---|---|
ContentTypes | ContentType | Énumération représentant les types de nœuds de contenu XML. |
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
createCdata(text) | Cdata | Crée un nœud CDATASection non associé avec la valeur donnée. |
createComment(text) | Comment | Crée un nœud Comment non associé avec la valeur donnée. |
createDocType(elementName) | DocType | Crée un nœud DocumentType non associé pour le nœud Element racine avec le nom donné. |
createDocType(elementName, systemId) | DocType | Crée un nœud DocumentType non associé pour le nœud Element racine avec le nom donné et l'ID système donné pour les données du sous-ensemble externe. |
createDocType(elementName, publicId, systemId) | DocType | Crée un nœud DocumentType non associé pour le nœud Element racine avec le nom donné, ainsi que l'ID public et l'ID système donnés pour les données du sous-ensemble externe. |
createDocument() | Document | Crée un document XML vide. |
createDocument(rootElement) | Document | Crée un document XML avec le nœud racine Element donné. |
createElement(name) | Element | Crée un nœud Element non associé avec le nom local donné et sans espace de noms. |
createElement(name, namespace) | Element | Crée un nœud Element non associé avec le nom local et l'espace de noms fournis. |
createText(text) | Text | Crée un nœud Text non associé avec la valeur donnée. |
getCompactFormat() | Format | Crée un objet Format pour générer un document XML compact. |
getNamespace(uri) | Namespace | Crée un Namespace avec l'URI donné. |
getNamespace(prefix, uri) | Namespace | Crée un Namespace avec le préfixe et l'URI fournis. |
getNoNamespace() | Namespace | Crée un Namespace qui représente l'absence d'espace de noms réel. |
getPrettyFormat() | Format | Crée un objet Format pour générer un document XML lisible par l'humain. |
getRawFormat() | Format | Crée un objet Format pour générer un document XML brut. |
getXmlNamespace() | Namespace | Crée un Namespace avec le préfixe xml standard. |
parse(xml) | Document | Crée un Document à partir du fichier XML donné, sans valider le fichier XML. |
Documentation détaillée
createCdata(text)
Crée un nœud CDATASection
non associé avec la valeur donnée.
Paramètres
Nom | Type | Description |
---|---|---|
text | String | la valeur à définir |
Renvois
Cdata
: nœud CDATASection
que vous venez de créer
createComment(text)
createDocType(elementName)
Crée un nœud DocumentType
non associé pour le nœud Element
racine avec le nom donné.
Paramètres
Nom | Type | Description |
---|---|---|
elementName | String | Nom du nœud Element racine à spécifier dans la déclaration DocType |
Renvois
DocType
: nœud DocumentType
que vous venez de créer
createDocType(elementName, systemId)
Crée un nœud DocumentType
non associé pour le nœud Element
racine avec le nom donné et l'ID système donné pour les données du sous-ensemble externe.
Paramètres
Nom | Type | Description |
---|---|---|
elementName | String | Nom du nœud Element racine à spécifier dans la déclaration DocType |
systemId | String | l'ID système du sous-ensemble externe de données à définir |
Renvois
DocType
: nœud DocumentType
que vous venez de créer
createDocType(elementName, publicId, systemId)
Crée un nœud DocumentType
non associé pour le nœud Element
racine avec le nom donné, ainsi que l'ID public et l'ID système donnés pour les données du sous-ensemble externe.
Paramètres
Nom | Type | Description |
---|---|---|
elementName | String | Nom du nœud Element racine à spécifier dans la déclaration DocType |
publicId | String | l'ID public du sous-ensemble externe de données à définir |
systemId | String | l'ID système du sous-ensemble externe de données à définir |
Renvois
DocType
: nœud DocumentType
que vous venez de créer
createDocument()
createDocument(rootElement)
createElement(name)
createElement(name, namespace)
createText(text)
getCompactFormat()
Crée un objet Format
pour générer un document XML compact. L'outil de mise en forme utilise par défaut l'encodage UTF-8
, sans retrait ni saut de ligne, mais inclut la déclaration XML et son encodage.
// Log an XML document in compact form. var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; var document = XmlService.parse(xml); var output = XmlService.getCompactFormat() .format(document); Logger.log(output);
Renvois
Format
: outil de mise en forme nouvellement créé
getNamespace(uri)
getNamespace(prefix, uri)
getNoNamespace()
getPrettyFormat()
Crée un objet Format
pour générer un document XML lisible par l'humain. L'outil de mise en forme utilise par défaut l'encodage UTF-8
, un retrait à deux espaces et des séparateurs de lignes \r\n
après chaque nœud. Il inclut la déclaration XML et son encodage.
// Log an XML document in human-readable form. var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; var document = XmlService.parse(xml); var output = XmlService.getPrettyFormat() .format(document); Logger.log(output);
Renvois
Format
: outil de mise en forme nouvellement créé
getRawFormat()
Crée un objet Format
pour générer un document XML brut. L'outil de mise en forme utilise par défaut l'encodage UTF-8
, aucun retrait ni aucun saut de ligne autres que ceux fournis dans le document XML lui-même. Il inclut la déclaration XML et son encodage.
// Log an XML document in raw form. var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; var document = XmlService.parse(xml); var output = XmlService.getRawFormat() .format(document); Logger.log(output);
Renvois
Format
: outil de mise en forme nouvellement créé