XML Service

Servizio XML

Questo servizio consente agli script di analizzare, navigare e creare in modo programmatico documenti XML.

// Log the title and labels for the first page of blog posts on
// Google's The Keyword blog.
function parseXml() {
  let url = 'https://blog.google/rss/';
  let xml = UrlFetchApp.fetch(url).getContentText();
  let document = XmlService.parse(xml);
  let root = document.getRootElement();

  let channel = root.getChild('channel');
  let items = channel.getChildren('item');
  items.forEach(item => {
    let title = item.getChild('title').getText();
    let categories = item.getChildren('category');
    let labels = categories.map(category => category.getText());
    console.log('%s (%s)', title, labels.join(', '));
  });
}

// Create and log an XML representation of first 10 threads in your Gmail inbox.
function createXml() {
  let root = XmlService.createElement('threads');
  let threads = GmailApp.getInboxThreads()
  threads = threads.slice(0,10); // Just the first 10
  threads.forEach(thread => {
    let child = XmlService.createElement('thread')
        .setAttribute('messageCount', thread.getMessageCount())
        .setAttribute('isUnread', thread.isUnread())
        .setText(thread.getFirstMessageSubject());
    root.addContent(child);
  });
  let document = XmlService.createDocument(root);
  let xml = XmlService.getPrettyFormat().format(document);
  console.log(xml);
}

Corsi

NomeBreve descrizione
AttributeUna rappresentazione di un attributo XML.
CdataUna rappresentazione di un nodo XML CDATASection.
CommentUna rappresentazione di un nodo XML Comment.
ContentUna rappresentazione di un nodo XML generico.
ContentTypeUn'enumerazione che rappresenta i tipi di nodi di contenuto XML.
DocTypeUna rappresentazione di un nodo XML DocumentType.
DocumentUna rappresentazione di un documento XML.
ElementUna rappresentazione di un nodo XML Element.
EntityRefUna rappresentazione di un nodo XML EntityReference.
FormatUn formattatore per l'output di un documento XML, con tre formati predefiniti che possono essere ulteriormente personalizzati.
NamespaceUna rappresentazione di uno spazio dei nomi XML.
ProcessingInstructionUna rappresentazione di un nodo XML ProcessingInstruction.
TextUna rappresentazione di un nodo XML Text.
XmlServiceQuesto servizio consente agli script di analizzare, navigare e creare in modo programmatico documenti XML.

Attribute

Metodi

MetodoTipo restituitoBreve descrizione
getName()StringOttiene il nome locale dell'attributo.
getNamespace()NamespaceOttiene lo spazio dei nomi per l'attributo.
getValue()StringOttiene il valore dell'attributo.
setName(name)AttributeImposta il nome locale dell'attributo.
setNamespace(namespace)AttributeImposta lo spazio dei nomi per l'attributo.
setValue(value)AttributeImposta il valore dell'attributo.

Cdata

Metodi

MetodoTipo restituitoBreve descrizione
append(text)TextAggiungi il testo specificato a tutti i contenuti già esistenti nel nodo.
detach()ContentStacca il nodo dal relativo nodo Element principale.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getText()StringOttiene il valore di testo del nodo Text.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
setText(text)TextImposta il valore di testo del nodo Text.

Comment

Metodi

MetodoTipo restituitoBreve descrizione
detach()ContentStacca il nodo dal relativo nodo Element principale.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getText()StringOttiene il valore di testo del nodo Comment.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
setText(text)CommentImposta il valore di testo del nodo Comment.

Content

Metodi

MetodoTipo restituitoBreve descrizione
asCdata()CdataTrasmette il nodo come nodo CDATASection ai fini del completamento automatico.
asComment()CommentTrasmette il nodo come nodo Comment ai fini del completamento automatico.
asDocType()DocTypeTrasmette il nodo come nodo DocumentType ai fini del completamento automatico.
asElement()ElementTrasmette il nodo come nodo Element ai fini del completamento automatico.
asEntityRef()EntityRefTrasmette il nodo come nodo EntityReference ai fini del completamento automatico.
asProcessingInstruction()ProcessingInstructionTrasmette il nodo come nodo ProcessingInstruction ai fini del completamento automatico.
asText()TextTrasmette il nodo come nodo Text ai fini del completamento automatico.
detach()ContentStacca il nodo dal relativo nodo Element principale.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getType()ContentTypeRestituisce il tipo di contenuto del nodo.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.

ContentType

Proprietà

ProprietàTipoDescrizione
CDATAEnumUn nodo XML CDATASection.
COMMENTEnumUn nodo XML Comment.
DOCTYPEEnumUn nodo XML DocumentType.
ELEMENTEnumUn nodo XML Element.
ENTITYREFEnumUn nodo XML EntityReference.
PROCESSINGINSTRUCTIONEnumUn nodo XML ProcessingInstruction.
TEXTEnumUn nodo XML Text.

DocType

Metodi

MetodoTipo restituitoBreve descrizione
detach()ContentStacca il nodo dal relativo nodo Element principale.
getElementName()StringRestituisce il nome del nodo principale Element specificato nella dichiarazione DocType.
getInternalSubset()StringOttiene i dati del sottoinsieme interno per il nodo DocumentType.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getPublicId()StringOttiene l'ID pubblico dei dati del sottoinsieme esterno per il nodo DocumentType.
getSystemId()StringOttiene l'ID di sistema dei dati del sottoinsieme esterno per il nodo DocumentType.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
setElementName(name)DocTypeImposta il nome del nodo principale Element da specificare in DocType dichiarazione.
setInternalSubset(data)DocTypeImposta i dati del sottoinsieme interno per il nodo DocumentType.
setPublicId(id)DocTypeImposta l'ID pubblico del sottoinsieme di dati esterno per il nodo DocumentType.
setSystemId(id)DocTypeImposta l'ID di sistema dei dati del sottoinsieme esterno per il nodo DocumentType.

Document

Metodi

MetodoTipo restituitoBreve descrizione
addContent(content)DocumentAggiungi il nodo specificato alla fine del documento.
addContent(index, content)DocumentInserisce il nodo specificato nell'indice specificato tra tutti i nodi figlio immediati del documento.
cloneContent()Content[]Crea copie non collegate di tutti i nodi secondari immediati del documento.
detachRootElement()ElementStacca e restituisce il nodo principale Element del documento.
getAllContent()Content[]Ottiene tutti i nodi secondari immediati del documento.
getContent(index)ContentRestituisce il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del documento.
getContentSize()IntegerRestituisce il numero di nodi secondari immediati del documento.
getDescendants()Content[]Ottiene tutti i nodi che sono figli diretti o indiretti del documento, nell'ordine in cui vengono visualizzate nel documento.
getDocType()DocTypeRecupera la dichiarazione DocType del documento.
getRootElement()ElementOttiene il nodo principale Element del documento.
hasRootElement()BooleanDetermina se il documento ha un nodo principale Element.
removeContent()Content[]Rimuove tutti i nodi secondari immediati del documento.
removeContent(content)BooleanRimuove il nodo specificato, se è un elemento figlio immediato del documento.
removeContent(index)ContentRimuove il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del documento.
setDocType(docType)DocumentImposta la dichiarazione DocType del documento.
setRootElement(element)DocumentImposta il nodo principale Element del documento.

Element

Metodi

MetodoTipo restituitoBreve descrizione
addContent(content)ElementAggiungi il nodo specificato come ultimo nodo figlio del nodo Element.
addContent(index, content)ElementInserisce il nodo specificato nell'indice specificato tra tutti i nodi figlio immediati del Element nodo.
cloneContent()Content[]Crea copie non collegate di tutti i nodi secondari immediati del nodo {@code Element}.
detach()ContentStacca il nodo dal relativo nodo Element principale.
getAllContent()Content[]Ottiene tutti i nodi secondari immediati del nodo {@code Element}.
getAttribute(name)AttributeOttiene l'attributo per questo nodo Element con il nome specificato e nessuno spazio dei nomi.
getAttribute(name, namespace)AttributeRecupera l'attributo per questo nodo Element con il nome e lo spazio dei nomi specificati.
getAttributes()Attribute[]Recupera tutti gli attributi per questo nodo Element, nell'ordine in cui appaiono nel documento.
getChild(name)ElementOttiene il primo nodo Element con il nome specificato e nessuno spazio dei nomi che è immediato figlio di questo nodo Element.
getChild(name, namespace)ElementOttiene il primo nodo Element con il nome e lo spazio dei nomi specificati. figlio di questo nodo Element.
getChildText(name)StringOttiene il valore di testo del nodo con il nome specificato e senza spazio dei nomi, se il nodo è figlio immediato del nodo Element.
getChildText(name, namespace)StringOttiene il valore di testo del nodo con il nome e lo spazio dei nomi specificati, se il nodo è una figlio del nodo Element.
getChildren()Element[]Recupera tutti i nodi Element secondari di questo nodo Element, in nell'ordine in cui appaiono nel documento.
getChildren(name)Element[]Ottiene tutti i nodi Element con il nome specificato e nessuno spazio dei nomi che sono elementi secondari immediati di questo nodo Element, nell'ordine in cui vengono visualizzati nel documento.
getChildren(name, namespace)Element[]Ottiene tutti i nodi Element con il nome e lo spazio dei nomi specificati che sono elementi secondari immediati di questo nodo Element, nell'ordine in cui appaiono nel documento.
getContent(index)ContentRestituisce il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del Nodo {@code Element}.
getContentSize()IntegerRestituisce il numero di nodi secondari immediati del nodo {@code Element}.
getDescendants()Content[]Ottiene tutti i nodi che sono figli diretti o indiretti del nodo {@code Element}, nell'ordine in cui vengono visualizzate nel documento.
getDocument()DocumentOttiene il documento XML che contiene il nodo {@code Element}.
getName()StringOttiene il nome locale del nodo Element.
getNamespace()NamespaceOttiene lo spazio dei nomi per il nodo Element.
getNamespace(prefix)NamespaceRecupera lo spazio dei nomi con il prefisso specificato per il nodo Element.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getQualifiedName()StringOttiene il nome locale e il prefisso dello spazio dei nomi del nodo Element, nel formato [namespacePrefix]:[localName].
getText()StringOttiene il valore di testo del nodo Element.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
isAncestorOf(other)BooleanDetermina se questo nodo Element è un elemento padre diretto o indiretto di un determinato nodo Element.
isRootElement()BooleanDetermina se il nodo Element è il nodo radice del documento.
removeAttribute(attribute)BooleanRimuove l'attributo specificato per questo nodo Element, se esiste.
removeAttribute(attributeName)BooleanRimuove l'attributo per questo nodo Element con il nome specificato e senza spazio dei nomi, se di un attributo di questo tipo.
removeAttribute(attributeName, namespace)BooleanRimuove l'attributo per questo nodo Element con il nome e lo spazio dei nomi specificati, se presenti esiste un attributo.
removeContent()Content[]Rimuove tutti i nodi secondari immediati del nodo {@code Element}.
removeContent(content)BooleanRimuove il nodo specificato, se è un nodo secondario immediato del nodo {@code Element}.
removeContent(index)ContentRimuove il nodo in corrispondenza dell'indice specificato tra tutti i nodi figlio immediati del Nodo {@code Element}.
setAttribute(attribute)ElementImposta l'attributo specificato per questo nodo Element.
setAttribute(name, value)ElementImposta l'attributo per questo nodo Element con il nome e il valore specificati, senza spazio dei nomi.
setAttribute(name, value, namespace)ElementImposta l'attributo per questo nodo Element con il nome, il valore e lo spazio dei nomi specificati.
setName(name)ElementImposta il nome locale del nodo Element.
setNamespace(namespace)ElementImposta lo spazio dei nomi per il nodo Element.
setText(text)ElementImposta il valore di testo del nodo Element.

EntityRef

Metodi

MetodoTipo restituitoBreve descrizione
detach()ContentStacca il nodo dal relativo nodo Element principale.
getName()StringOttiene il nome del nodo EntityReference.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getPublicId()StringOttiene l'ID pubblico del nodo EntityReference.
getSystemId()StringOttiene l'ID di sistema del nodo EntityReference.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
setName(name)EntityRefImposta il nome del nodo EntityReference.
setPublicId(id)EntityRefImposta l'ID pubblico del nodo EntityReference.
setSystemId(id)EntityRefImposta l'ID di sistema del nodo EntityReference.

Format

Metodi

MetodoTipo restituitoBreve descrizione
format(document)StringRestituisce il valore Document specificato come stringa formattata.
format(element)StringRestituisce il nodo Element specificato come stringa formattata.
setEncoding(encoding)FormatConsente di impostare la codifica dei caratteri che il formattatore deve utilizzare.
setIndent(indent)FormatImposta la stringa utilizzata per far rientrare i nodi figlio rispetto ai relativi nodi padre.
setLineSeparator(separator)FormatImposta la stringa da inserire ogni volta che il formattatore inserisce normalmente un'interruzione di riga.
setOmitDeclaration(omitDeclaration)FormatConsente di impostare se il formattatore deve omettere la dichiarazione XML, ad esempio <?xml version="1.0" encoding="UTF-8"?>.
setOmitEncoding(omitEncoding)FormatConsente di impostare se il formattatore deve omettere la codifica nella dichiarazione XML, ad esempio campo di codifica in <?xml version="1.0" encoding="UTF-8"?>.

Namespace

Metodi

MetodoTipo restituitoBreve descrizione
getPrefix()StringOttiene il prefisso per lo spazio dei nomi.
getURI()StringOttiene l'URI per lo spazio dei nomi.

ProcessingInstruction

Metodi

MetodoTipo restituitoBreve descrizione
detach()ContentStacca il nodo dal relativo nodo Element principale.
getData()StringRecupera i dati non elaborati per ogni istruzione nel nodo ProcessingInstruction.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getTarget()StringOttiene il target per il nodo ProcessingInstruction.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.

Text

Metodi

MetodoTipo restituitoBreve descrizione
append(text)TextAggiungi il testo specificato a tutti i contenuti già esistenti nel nodo.
detach()ContentStacca il nodo dal relativo nodo Element principale.
getParentElement()ElementOttiene il nodo principale Element del nodo.
getText()StringOttiene il valore di testo del nodo Text.
getValue()StringRestituisce il valore testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine appaiono nel documento.
setText(text)TextImposta il valore di testo del nodo Text.

XmlService

Proprietà

ProprietàTipoDescrizione
ContentTypesContentTypeUn'enumerazione che rappresenta i tipi di nodi di contenuto XML.

Metodi

MetodoTipo restituitoBreve descrizione
createCdata(text)CdataCrea un nodo CDATASection scollegato con il valore specificato.
createComment(text)CommentCrea un nodo Comment scollegato con il valore specificato.
createDocType(elementName)DocTypeCrea un nodo DocumentType scollegato per il nodo principale Element con il nome specificato.
createDocType(elementName, systemId)DocTypeCrea un nodo DocumentType scollegato per il nodo principale Element con il nome specificato e l'ID di sistema per i dati del sottoinsieme esterno.
createDocType(elementName, publicId, systemId)DocTypeCrea un nodo DocumentType scollegato per il nodo principale Element con il nome specificato, nonché l'ID pubblico e l'ID sistema specificati per i dati del sottoinsieme esterno.
createDocument()DocumentCrea un documento XML vuoto.
createDocument(rootElement)DocumentCrea un documento XML con il nodo principale Element specificato.
createElement(name)ElementCrea un nodo Element scollegato con il nome locale specificato e nessuno spazio dei nomi.
createElement(name, namespace)ElementCrea un nodo Element scollegato con il nome e lo spazio dei nomi locali specificati.
createText(text)TextCrea un nodo Text scollegato con il valore specificato.
getCompactFormat()FormatCrea un oggetto Format per la generazione di un documento XML compatto.
getNamespace(uri)NamespaceCrea un Namespace con l'URI specificato.
getNamespace(prefix, uri)NamespaceCrea un'istruzione Namespace con il prefisso e l'URI specificati.
getNoNamespace()NamespaceCrea un valore Namespace che rappresenta l'assenza di uno spazio dei nomi reale.
getPrettyFormat()FormatCrea un oggetto Format per la generazione di un documento XML leggibile.
getRawFormat()FormatCrea un oggetto Format per l'output di un documento XML non elaborato.
getXmlNamespace()NamespaceCrea un elemento Namespace con il prefisso xml standard.
parse(xml)DocumentCrea un elemento Document dal file XML fornito, senza convalidare il codice XML.