Ta usługa umożliwia skryptom analizowanie, nawigację i programowe tworzenie dokumentów 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); }
Właściwości
Właściwość | Typ | Opis |
---|---|---|
ContentTypes | ContentType | Wyliczenie reprezentujące typy węzłów treści XML. |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
createCdata(text) | Cdata | Tworzy niedołączony węzeł CDATASection o podanej wartości. |
createComment(text) | Comment | Tworzy niedołączony węzeł Comment o podanej wartości. |
createDocType(elementName) | DocType | Tworzy niedołączony węzeł DocumentType dla głównego węzła Element o podanej nazwie. |
createDocType(elementName, systemId) | DocType | Tworzy niedołączony węzeł DocumentType dla głównego węzła Element o podanej nazwie oraz podany identyfikator systemu dla zewnętrznych podzbioru danych. |
createDocType(elementName, publicId, systemId) | DocType | Tworzy niedołączony węzeł DocumentType dla głównego węzła Element o podanej nazwie oraz podany identyfikator publiczny i identyfikator systemu dla zewnętrznych podzbioru danych. |
createDocument() | Document | Tworzy pusty dokument XML. |
createDocument(rootElement) | Document | Tworzy dokument XML z danym głównym węzłem Element . |
createElement(name) | Element | Tworzy niedołączony węzeł Element o podanej nazwie lokalnej bez przestrzeni nazw. |
createElement(name, namespace) | Element | Tworzy niedołączony węzeł Element o podanej nazwie lokalnej i przestrzeni nazw. |
createText(text) | Text | Tworzy niedołączony węzeł Text o podanej wartości. |
getCompactFormat() | Format | Tworzy obiekt Format do przesyłania kompaktowego dokumentu XML. |
getNamespace(uri) | Namespace | Tworzy element Namespace o podanym identyfikatorze URI. |
getNamespace(prefix, uri) | Namespace | Tworzy element Namespace o podanym prefiksie i identyfikatorze URI. |
getNoNamespace() | Namespace | Tworzy element Namespace reprezentujący brak rzeczywistej przestrzeni nazw. |
getPrettyFormat() | Format | Tworzy obiekt Format do umieszczenia na wyjściu zrozumiałego dla człowieka dokumentu XML. |
getRawFormat() | Format | Tworzy obiekt Format do przesyłania nieprzetworzonego dokumentu XML. |
getXmlNamespace() | Namespace | Tworzy element Namespace ze standardowym prefiksem xml . |
parse(xml) | Document | Tworzy Document z danego kodu XML bez weryfikacji kodu XML. |
Szczegółowa dokumentacja
createCdata(text)
Tworzy niedołączony węzeł CDATASection
o podanej wartości.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | wartość do ustawienia |
Powroty
Cdata
– nowo utworzony węzeł CDATASection
createComment(text)
createDocType(elementName)
Tworzy niedołączony węzeł DocumentType
dla głównego węzła Element
o podanej nazwie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
elementName | String | nazwa głównego węzła Element do określenia w deklaracji DocType |
Powroty
DocType
– nowo utworzony węzeł DocumentType
createDocType(elementName, systemId)
Tworzy niedołączony węzeł DocumentType
dla głównego węzła Element
o podanej nazwie oraz podany identyfikator systemu dla zewnętrznych podzbioru danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
elementName | String | nazwa głównego węzła Element do określenia w deklaracji DocType |
systemId | String | identyfikator systemu zewnętrznych podzbiorów danych do ustawienia |
Powroty
DocType
– nowo utworzony węzeł DocumentType
createDocType(elementName, publicId, systemId)
Tworzy niedołączony węzeł DocumentType
dla głównego węzła Element
o podanej nazwie oraz podany identyfikator publiczny i identyfikator systemu dla zewnętrznych podzbioru danych.
Parametry
Nazwa | Typ | Opis |
---|---|---|
elementName | String | nazwa głównego węzła Element do określenia w deklaracji DocType |
publicId | String | publiczny identyfikator zewnętrznych podzbiorów danych do ustawienia |
systemId | String | identyfikator systemu zewnętrznych podzbiorów danych do ustawienia |
Powroty
DocType
– nowo utworzony węzeł DocumentType
createDocument()
createDocument(rootElement)
createElement(name)
createElement(name, namespace)
createText(text)
getCompactFormat()
Tworzy obiekt Format
do przesyłania kompaktowego dokumentu XML. W przypadku narzędzia formatowania domyślnie stosowane jest kodowanie UTF-8
, bez wcięć i bez dodatkowych podziałów wierszy, ale uwzględniana jest deklaracja XML i jej kodowanie.
// 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);
Powroty
Format
– nowo utworzony narzędzie do formatowania
getNamespace(uri)
getNamespace(prefix, uri)
getNoNamespace()
getPrettyFormat()
Tworzy obiekt Format
do umieszczenia na wyjściu zrozumiałego dla człowieka dokumentu XML. W przypadku narzędzia do formatowania domyślnie stosowane jest kodowanie UTF-8
, wcięcie tekstu ze spacjami 2 spacje i separatory wierszy \r\n
po każdym węźle. Obejmuje ona deklarację XML i jej kodowanie.
// 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);
Powroty
Format
– nowo utworzony narzędzie do formatowania
getRawFormat()
Tworzy obiekt Format
do przesyłania nieprzetworzonego dokumentu XML. W programie formatowania domyślnie stosowane jest kodowanie UTF-8
, bez wcięć ani podziałów wierszy innych niż te podane w samym dokumencie XML. Zawiera też deklarację XML i jej kodowanie.
// 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);
Powroty
Format
– nowo utworzony narzędzie do formatowania