השירות הזה מאפשר לסקריפטים לנתח, לנווט וליצור מסמכי XML באופן פרוגרמטי.
// 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); }
מאפיינים
נכס | סוג | תיאור |
---|---|---|
Content | Content | ספירה מייצגת את סוגי צמתים של תוכן XML. |
Methods
שיטה | סוג הערך המוחזר | תיאור קצר |
---|---|---|
create | Cdata | יצירת צומת CDATASection לא מצורף עם הערך הנתון. |
create | Comment | יצירת צומת Comment לא מצורף עם הערך הנתון. |
create | Doc | יצירת צומת Document לא מצורף לצומת הבסיס Element עם השם שצוין. |
create | Doc | יצירת צומת Document לא מצורף לצומת הבסיס Element עם השם שצוין, ומזהה המערכת שצוין לנתוני קבוצת המשנה החיצונית. |
create | Doc | יצירת צומת Document לא מצורף לצומת הבסיס Element עם השם שצוין, והמזהה הציבורי ומזהה המערכת שצוינו לנתוני קבוצת המשנה החיצונית. |
create | Document | יצירת מסמך XML ריק. |
create | Document | יצירת מסמך XML עם צומת Element ברמה הבסיסית. |
create | Element | יצירת צומת Element לא מצורף עם השם המקומי שצוין וללא מרחב שמות. |
create | Element | יצירת צומת Element לא מצורף עם השם המקומי ומרחב השמות שצוינו. |
create | Text | יצירת צומת Text לא מצורף עם הערך הנתון. |
get | Format | יצירת אובייקט Format להפקת מסמך XML קומפקטי. |
get | Namespace | יצירת Namespace עם ה-URI שצוין. |
get | Namespace | יצירת Namespace עם הקידומת וה-URI שצוינו. |
get | Namespace | הפונקציה יוצרת Namespace שמייצג את היעדר מרחב השמות האמיתי. |
get | Format | יצירת אובייקט Format להפקת מסמך XML קריא לאנשים. |
get | Format | יצירת אובייקט Format להפקת מסמך XML גולמי. |
get | Namespace | יצירת Namespace עם הקידומת הרגילה xml . |
parse(xml) | Document | יצירת Document מה-XML הנתון, בלי לאמת את ה-XML. |
מסמכים מפורטים
create Cdata(text)
יצירת צומת CDATASection
לא מצורף עם הערך הנתון.
פרמטרים
שם | סוג | תיאור |
---|---|---|
text | String | הערך להגדרה |
חזרה
Cdata
– הצומת CDATASection
שנוצר
create Comment(text)
create Doc Type(elementName)
יצירת צומת Document
לא מצורף לצומת הבסיס Element
עם השם שצוין.
פרמטרים
שם | סוג | תיאור |
---|---|---|
element | String | השם של צומת הבסיס Element שצריך לציין בהצהרה Doc
|
חזרה
Doc
– הצומת Document
שנוצר
create Doc Type(elementName, systemId)
יצירת צומת Document
לא מצורף לצומת הבסיס Element
עם השם שצוין, ומזהה המערכת שצוין לנתוני קבוצת המשנה החיצונית.
פרמטרים
שם | סוג | תיאור |
---|---|---|
element | String | השם של צומת הבסיס Element שצריך לציין בהצהרה Doc
|
system | String | מזהה המערכת של נתוני קבוצת המשנה החיצונית שרוצים להגדיר |
חזרה
Doc
– הצומת Document
שנוצר
create Doc Type(elementName, publicId, systemId)
יצירת צומת Document
לא מצורף לצומת הבסיס Element
עם השם שצוין, והמזהה הציבורי ומזהה המערכת שצוינו לנתוני קבוצת המשנה החיצונית.
פרמטרים
שם | סוג | תיאור |
---|---|---|
element | String | השם של צומת הבסיס Element שצריך לציין בהצהרה Doc
|
public | String | המזהה הציבורי של נתוני קבוצת המשנה החיצונית שרוצים להגדיר |
system | String | מזהה המערכת של נתוני קבוצת המשנה החיצונית שרוצים להגדיר |
חזרה
Doc
– הצומת Document
שנוצר
create Document()
create Document(rootElement)
create Element(name)
create Element(name, namespace)
create Text(text)
get Compact Format()
יצירת אובייקט Format
להפקת מסמך XML קומפקטי. ברירת המחדל של הפורמט היא קידוד UTF-8
, ללא הכנסה (indentation) וללא הפסקות שורה נוספות, אבל הוא כולל את הצהרת ה-XML ואת הקידוד שלה.
// 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);
חזרה
Format
– הפורמטטור החדש שנוצר
get Namespace(uri)
get Namespace(prefix, uri)
get No Namespace()
get Pretty Format()
יצירת אובייקט Format
להפקת מסמך XML קריא לאנשים. ברירת המחדל של הפורמט היא קידוד UTF-8
, הכנסת רווחים של שני תווים, מפרידים בין שורות \r\n
אחרי כל צומת, והצהרת ה-XML והקידוד שלה.
// 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);
חזרה
Format
– הפורמטטור החדש שנוצר
get Raw Format()
יצירת אובייקט Format
להפקת מסמך XML גולמי. ברירת המחדל של הפורמט היא קידוד UTF-8
, ללא הכנסה (indent) וללא הפסקות שורה מלבד אלה שסופקו במסמך ה-XML עצמו, והוא כולל את הצהרת ה-XML ואת הקידוד שלה.
// 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);
חזרה
Format
– הפורמטטור החדש שנוצר