Ta usługa umożliwia skryptom analizowanie, nawigowanie i tworzenie dokumentów XML w ramach programowania.
// Log the title and labels for the first page of blog posts on the // Google Workspace Developer blog. function parseXml() { const url = 'https://gsuite-developers.googleblog.com/atom.xml'; const xml = UrlFetchApp.fetch(url).getContentText(); const document = XmlService.parse(xml); const root = document.getRootElement(); const atom = XmlService.getNamespace('http://www.w3.org/2005/Atom'); const entries = root.getChildren('entry', atom); for (let i = 0; i < entries.length; i++) { const title = entries[i].getChild('title', atom).getText(); const categoryElements = entries[i].getChildren('category', atom); const labels = []; for (let 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() { const root = XmlService.createElement('threads'); const threads = GmailApp.getInboxThreads(); for (let i = 0; i < threads.length; i++) { const child = XmlService.createElement('thread') .setAttribute('messageCount', threads[i].getMessageCount()) .setAttribute('isUnread', threads[i].isUnread()) .setText(threads[i].getFirstMessageSubject()); root.addContent(child); } const document = XmlService.createDocument(root); const xml = XmlService.getPrettyFormat().format(document); Logger.log(xml); }
Właściwości
Właściwość | Typ | Opis |
---|---|---|
Content | Content | Wyliczenie reprezentujące typy węzłów treści XML. |
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
create | Cdata | Tworzy niepowiązany węzeł CDATASection z określoną wartością. |
create | Comment | Tworzy niepowiązany węzeł Comment z określoną wartością. |
create | Doc | Tworzy niepowiązany węzeł Document dla węzła głównego Element o podanej nazwie. |
create | Doc | Tworzy niepowiązany węzeł Document dla węzła Element z daną nazwą i danym identyfikatorem systemowym dla danych zewnętrznych podzbioru. |
create | Doc | Tworzy nieprzyłączony węzeł Document dla węzła Element z podaną nazwą oraz podanym identyfikatorem publicznym i identyfikatorem systemowym dla danych zewnętrznych podzbioru. |
create | Document | Tworzy pusty dokument XML. |
create | Document | Tworzy dokument XML z danym węzłem głównym Element . |
create | Element | Tworzy niepowiązany węzeł Element o podanej nazwie lokalnej i bez przestrzeni nazw. |
create | Element | Tworzy niepowiązany węzeł Element z daną nazwą lokalną i przestrzenią nazw. |
create | Text | Tworzy niepowiązany węzeł Text z określoną wartością. |
get | Format | Tworzy obiekt Format , aby wygenerować skompresowany dokument XML. |
get | Namespace | Tworzy obiekt Namespace z podanym identyfikatorem URI. |
get | Namespace | Tworzy Namespace z danym prefiksem i identyfikatorem URI. |
get | Namespace | Tworzy Namespace , który reprezentuje brak prawdziwej przestrzeni nazw. |
get | Format | Tworzy obiekt Format , aby wygenerować czytelny dla człowieka dokument XML. |
get | Format | Tworzy obiekt Format , aby wygenerować surowy dokument XML. |
get | Namespace | Tworzy Namespace ze standardowym prefiksem xml . |
parse(xml) | Document | Tworzy Document z podanego kodu XML bez jego weryfikacji. |
Szczegółowa dokumentacja
create Cdata(text)
Tworzy niepowiązany węzeł CDATASection
z określoną wartością.
Parametry
Nazwa | Typ | Opis |
---|---|---|
text | String | wartość do ustawienia. |
Powrót
Cdata
– nowo utworzony węzeł CDATASection
create Comment(text)
create Doc Type(elementName)
Tworzy niepowiązany węzeł Document
dla węzła głównego Element
o podanej nazwie.
Parametry
Nazwa | Typ | Opis |
---|---|---|
element | String | nazwę węzła głównego Element , który ma być określony w deklaracji Doc ; |
Powrót
Doc
– nowo utworzony węzeł Document
create Doc Type(elementName, systemId)
Tworzy niepowiązany węzeł Document
dla węzła Element
z daną nazwą i danym identyfikatorem systemowym dla danych zewnętrznych podzbioru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
element | String | nazwę węzła głównego Element , który ma być określony w deklaracji Doc ; |
system | String | identyfikator systemu zewnętrznego podzbioru danych, który ma zostać ustawiony; |
Powrót
Doc
– nowo utworzony węzeł Document
create Doc Type(elementName, publicId, systemId)
Tworzy nieprzyłączony węzeł Document
dla węzła Element
z podaną nazwą oraz podanym identyfikatorem publicznym i identyfikatorem systemowym dla danych zewnętrznych podzbioru.
Parametry
Nazwa | Typ | Opis |
---|---|---|
element | String | nazwę węzła głównego Element , który ma być określony w deklaracji Doc ; |
public | String | publiczny identyfikator zewnętrznych danych podzbioru, które mają zostać ustawione. |
system | String | identyfikator systemu zewnętrznego podzbioru danych, który ma zostać ustawiony; |
Powrót
Doc
– nowo utworzony węzeł Document
create Document()
create Document(rootElement)
create Element(name)
create Element(name, namespace)
create Text(text)
get Compact Format()
Tworzy obiekt Format
, aby wygenerować skompresowany dokument XML. Formatowanie domyślnie używa kodowania UTF-8
, nie stosuje wcięć ani dodatkowych znaków końca wiersza, ale zawiera deklarację XML i jej kodowanie.
// Log an XML document in compact form. const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getCompactFormat().format(document); Logger.log(output);
Powrót
Format
– nowo utworzony formater.
get Namespace(uri)
get Namespace(prefix, uri)
get No Namespace()
get Pretty Format()
Tworzy obiekt Format
, aby wygenerować czytelny dla człowieka dokument XML. Formatowanie domyślnie używa kodowania UTF-8
, wcięcia o 2 spacje, separatorów wierszy \r\n
po każdym węźle oraz zawiera deklarację XML i jej kodowanie.
// Log an XML document in human-readable form. const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getPrettyFormat().format(document); Logger.log(output);
Powrót
Format
– nowo utworzony formater.
get Raw Format()
Tworzy obiekt Format
, aby wygenerować surowy dokument XML. Domyślnie formatowanie używa kodowania UTF-8
, nie stosuje wcięć ani znaków końca wiersza innych niż te podane w samym dokumencie XML oraz zawiera deklarację XML i jej kodowanie.
// Log an XML document in raw form. const xml = '<root><a><b>Text!</b><b>More text!</b></a></root>'; const document = XmlService.parse(xml); const output = XmlService.getRawFormat().format(document); Logger.log(output);
Powrót
Format
– nowo utworzony formater.