تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class XmlService

تسمح هذه الخدمة للنصوص البرمجية بتحليل مستندات 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);
}

أماكن إقامة

الموقع	Type	الوصف
`ContentTypes`	`ContentType`	تعداد يمثل أنواع عقد محتوى XML.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`createCdata(text)`	`Cdata`	تنشئ عقدة `CDATASection` غير مرتبطة بالقيمة المحددة.
`createComment(text)`	`Comment`	تنشئ عقدة `Comment` غير مرتبطة بالقيمة المحددة.
`createDocType(elementName)`	`DocType`	تنشئ عقدة `DocumentType` غير مرتبطة لعقدة `Element` الجذر بالاسم المحدد.
`createDocType(elementName, systemId)`	`DocType`	تنشئ عقدة `DocumentType` غير مرتبطة لعقدة `Element` الجذر بالاسم المحدد، ورقم تعريف النظام المحدد لبيانات المجموعة الفرعية الخارجية.
`createDocType(elementName, publicId, systemId)`	`DocType`	تنشئ عقدة `DocumentType` غير مرتبطة لعقدة `Element` الجذر بالاسم المحدد، والمعرّف العام ورقم تعريف النظام المحددَين لبيانات المجموعة الفرعية الخارجية.
`createDocument()`	`Document`	تنشئ مستند XML فارغًا.
`createDocument(rootElement)`	`Document`	تنشئ مستند XML باستخدام عقدة `Element` الجذر المحددة.
`createElement(name)`	`Element`	تنشئ عقدة `Element` غير مرتبطة بالاسم المحلي المحدّد بدون مساحة اسم.
`createElement(name, namespace)`	`Element`	تنشئ عقدة `Element` غير مرتبطة بالاسم المحلي ومساحة الاسم المحدّدة.
`createText(text)`	`Text`	تنشئ عقدة `Text` غير مرتبطة بالقيمة المحددة.
`getCompactFormat()`	`Format`	تنشئ كائن `Format` لإخراج مستند XML مصغّر.
`getNamespace(uri)`	`Namespace`	تنشئ `Namespace` باستخدام معرّف الموارد المنتظم المحدد.
`getNamespace(prefix, uri)`	`Namespace`	تنشئ `Namespace` باستخدام البادئة ومعرّف الموارد المنتظم (URI) المحددَين.
`getNoNamespace()`	`Namespace`	تنشئ علامة `Namespace` تشير إلى عدم توفّر مساحة اسم حقيقية.
`getPrettyFormat()`	`Format`	تنشئ كائن `Format` لإخراج مستند XML يمكن لشخص عادي قراءته.
`getRawFormat()`	`Format`	تنشئ كائن `Format` لإخراج مستند XML غير معدَّل.
`getXmlNamespace()`	`Namespace`	تنشئ `Namespace` ببادئة `xml` عادية.
`parse(xml)`	`Document`	تنشئ `Document` من ملف XML المحدّد، بدون التحقّق من صحة XML.

الوثائق التفصيلية

`createCdata(text)`

تنشئ عقدة CDATASection غير مرتبطة بالقيمة المحددة.

المَعلمات

الاسم	Type	الوصف
`text`	`String`	القيمة المطلوب ضبطها

استرجاع الكرة

Cdata — عقدة CDATASection التي تم إنشاؤها حديثًا

`createComment(text)`

تنشئ عقدة Comment غير مرتبطة بالقيمة المحددة.

المَعلمات

الاسم	Type	الوصف
`text`	`String`	القيمة المطلوب ضبطها

استرجاع الكرة

Comment — عقدة Comment التي تم إنشاؤها حديثًا

`createDocType(elementName)`

تنشئ عقدة DocumentType غير مرتبطة لعقدة Element الجذر بالاسم المحدد.

المَعلمات

الاسم	Type	الوصف
`elementName`	`String`	اسم عقدة `Element` الجذر المطلوب تحديدها في بيان `DocType`

استرجاع الكرة

DocType — عقدة DocumentType التي تم إنشاؤها حديثًا

`createDocType(elementName, systemId)`

تنشئ عقدة DocumentType غير مرتبطة لعقدة Element الجذر بالاسم المحدد، ورقم تعريف النظام المحدد لبيانات المجموعة الفرعية الخارجية.

المَعلمات

الاسم	Type	الوصف
`elementName`	`String`	اسم عقدة `Element` الجذر المطلوب تحديدها في بيان `DocType`
`systemId`	`String`	رقم تعريف النظام لبيانات المجموعة الفرعية الخارجية المطلوب تعيينها

استرجاع الكرة

DocType — عقدة DocumentType التي تم إنشاؤها حديثًا

`createDocType(elementName, publicId, systemId)`

تنشئ عقدة DocumentType غير مرتبطة لعقدة Element الجذر بالاسم المحدد، والمعرّف العام ورقم تعريف النظام المحددَين لبيانات المجموعة الفرعية الخارجية.

المَعلمات

الاسم	Type	الوصف
`elementName`	`String`	اسم عقدة `Element` الجذر المطلوب تحديدها في بيان `DocType`
`publicId`	`String`	المعرّف العام لبيانات المجموعة الفرعية الخارجية التي يلزم تعيينها
`systemId`	`String`	رقم تعريف النظام لبيانات المجموعة الفرعية الخارجية المطلوب تعيينها

استرجاع الكرة

DocType — عقدة DocumentType التي تم إنشاؤها حديثًا

`createDocument()`

تنشئ مستند XML فارغًا.

استرجاع الكرة

Document — المستند الذي تم إنشاؤه حديثًا

`createDocument(rootElement)`

تنشئ مستند XML باستخدام عقدة Element الجذر المحددة.

المَعلمات

الاسم	Type	الوصف
`rootElement`	`Element`	العقدة `Element` الجذر لضبطها

استرجاع الكرة

Document — المستند الذي تم إنشاؤه حديثًا

`createElement(name)`

تنشئ عقدة Element غير مرتبطة بالاسم المحلي المحدّد بدون مساحة اسم.

المَعلمات

الاسم	Type	الوصف
`name`	`String`	الاسم المحلي لتعيين

استرجاع الكرة

Element — عقدة Element التي تم إنشاؤها حديثًا

`createElement(name, namespace)`

تنشئ عقدة Element غير مرتبطة بالاسم المحلي ومساحة الاسم المحدّدة.

المَعلمات

الاسم	Type	الوصف
`name`	`String`	الاسم المحلي لتعيين
`namespace`	`Namespace`	مساحة الاسم المطلوب تعيينها

استرجاع الكرة

Element — عقدة Element التي تم إنشاؤها حديثًا

`createText(text)`

تنشئ عقدة Text غير مرتبطة بالقيمة المحددة.

المَعلمات

الاسم	Type	الوصف
`text`	`String`	القيمة المطلوب ضبطها

استرجاع الكرة

Text — عقدة Text التي تم إنشاؤها حديثًا

`getCompactFormat()`

تنشئ كائن Format لإخراج مستند XML مصغّر. الإعداد التلقائي للمنسّق هو ترميز UTF-8 بدون مسافة بادئة وبدون فواصل أسطر إضافية، ولكنه يتضمّن إعلان XML وترميزه.

// 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);

استرجاع الكرة

Format — أداة التنسيق التي تم إنشاؤها حديثًا

`getNamespace(uri)`

تنشئ Namespace باستخدام معرّف الموارد المنتظم المحدد.

المَعلمات

الاسم	Type	الوصف
`uri`	`String`	معرّف الموارد المنتظم (URI) لمساحة الاسم

استرجاع الكرة

Namespace - مساحة الاسم التي تم إنشاؤها حديثًا

`getNamespace(prefix, uri)`

تنشئ Namespace باستخدام البادئة ومعرّف الموارد المنتظم (URI) المحددَين.

المَعلمات

الاسم	Type	الوصف
`prefix`	`String`	بادئة مساحة الاسم
`uri`	`String`	معرّف الموارد المنتظم (URI) لمساحة الاسم

استرجاع الكرة

Namespace - مساحة الاسم التي تم إنشاؤها حديثًا

`getNoNamespace()`

تنشئ علامة Namespace تشير إلى عدم توفّر مساحة اسم حقيقية.

استرجاع الكرة

Namespace - مساحة الاسم التي تم إنشاؤها حديثًا

`getPrettyFormat()`

تنشئ كائن Format لإخراج مستند XML يمكن لشخص عادي قراءته. في أداة التنسيق، يتم ضبط الإعدادات التلقائية على ترميز UTF-8 والمسافة البادئة مسافتَين وفواصل الأسطر \r\n بعد كل عقدة، كما أنّها تتضمّن تعريف XML وترميزه.

// 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);

استرجاع الكرة

Format — أداة التنسيق التي تم إنشاؤها حديثًا

`getRawFormat()`

تنشئ كائن Format لإخراج مستند XML غير معدَّل. الإعداد التلقائي للمنسق على ترميز UTF-8، بدون مسافة بادئة ولا فواصل أسطر غير تلك المتوفرة في مستند XML نفسه، ويتضمن إعلان XML وترميزه.

// 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);

استرجاع الكرة

Format — أداة التنسيق التي تم إنشاؤها حديثًا

`getXmlNamespace()`

تنشئ Namespace ببادئة xml عادية.

استرجاع الكرة

Namespace - مساحة الاسم التي تم إنشاؤها حديثًا

`parse(xml)`

تنشئ Document من ملف XML المحدّد، بدون التحقّق من صحة XML.

var xml = '<root><a><b>Text!</b><b>More text!</b></a></root>';
var doc = XmlService.parse(xml);

المَعلمات

الاسم	Type	الوصف
`xml`	`String`	ملف XML المطلوب تحليله

استرجاع الكرة

Document — المستند الذي تم إنشاؤه حديثًا