Questa pagina è stata tradotta dall'API Cloud Translation.

XML Service

Questo servizio consente agli script di analizzare, esplorare 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

Nome	Breve descrizione
`Attribute`	Una rappresentazione di un attributo XML.
`Cdata`	Una rappresentazione di un nodo XML `CDATASection`.
`Comment`	Una rappresentazione di un nodo XML `Comment`.
`Content`	Una rappresentazione di un nodo XML generico.
`ContentType`	Un'enumerazione che rappresenta i tipi di nodi di contenuti XML.
`DocType`	Una rappresentazione di un nodo XML `DocumentType`.
`Document`	Una rappresentazione di un documento XML.
`Element`	Una rappresentazione di un nodo XML `Element`.
`EntityRef`	Una rappresentazione di un nodo XML `EntityReference`.
`Format`	Un formattatore per l'output di un documento XML, con tre formati predefiniti che possono essere ulteriormente personalizzati.
`Namespace`	Una rappresentazione di uno spazio dei nomi XML.
`ProcessingInstruction`	Una rappresentazione di un nodo XML `ProcessingInstruction`.
`Text`	Una rappresentazione di un nodo XML `Text`.
`XmlService`	Questo servizio consente agli script di analizzare, esplorare e creare in modo programmatico documenti XML.

`Attribute`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getName()`	`String`	Restituisce il nome locale dell'attributo.
`getNamespace()`	`Namespace`	Restituisce lo spazio dei nomi per l'attributo.
`getValue()`	`String`	Restituisce il valore dell'attributo.
`setName(name)`	`Attribute`	Consente di impostare il nome locale dell'attributo.
`setNamespace(namespace)`	`Attribute`	Imposta lo spazio dei nomi per l'attributo.
`setValue(value)`	`Attribute`	Imposta il valore dell'attributo.

`Cdata`

Metodi

Metodo	Tipo restituito	Breve descrizione
`append(text)`	`Text`	Aggiunge il testo specificato a eventuali contenuti già esistenti nel nodo.
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getText()`	`String`	Restituisce il valore di testo del nodo `Text`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.
`setText(text)`	`Text`	Imposta il valore di testo del nodo `Text`.

`Comment`

Metodi

Metodo	Tipo restituito	Breve descrizione
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getText()`	`String`	Restituisce il valore di testo del nodo `Comment`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.
`setText(text)`	`Comment`	Imposta il valore di testo del nodo `Comment`.

`Content`

Metodi

Metodo	Tipo restituito	Breve descrizione
`asCdata()`	`Cdata`	Consente di trasmettere il nodo come nodo `CDATASection` ai fini del completamento automatico.
`asComment()`	`Comment`	Consente di trasmettere il nodo come nodo `Comment` ai fini del completamento automatico.
`asDocType()`	`DocType`	Consente di trasmettere il nodo come nodo `DocumentType` ai fini del completamento automatico.
`asElement()`	`Element`	Trasmette il nodo come nodo `Element` ai fini del completamento automatico.
`asEntityRef()`	`EntityRef`	Consente di trasmettere il nodo come nodo `EntityReference` ai fini del completamento automatico.
`asProcessingInstruction()`	`ProcessingInstruction`	Consente di trasmettere il nodo come nodo `ProcessingInstruction` ai fini del completamento automatico.
`asText()`	`Text`	Consente di trasmettere il nodo come nodo `Text` ai fini del completamento automatico.
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getType()`	`ContentType`	Restituisce il tipo di contenuto del nodo.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.

`ContentType`

Proprietà

Proprietà	Tipo	Descrizione
`CDATA`	`Enum`	Un nodo XML `CDATASection`.
`COMMENT`	`Enum`	Un nodo XML `Comment`.
`DOCTYPE`	`Enum`	Un nodo XML `DocumentType`.
`ELEMENT`	`Enum`	Un nodo XML `Element`.
`ENTITYREF`	`Enum`	Un nodo XML `EntityReference`.
`PROCESSINGINSTRUCTION`	`Enum`	Un nodo XML `ProcessingInstruction`.
`TEXT`	`Enum`	Un nodo XML `Text`.

`DocType`

Metodi

Metodo	Tipo restituito	Breve descrizione
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getElementName()`	`String`	Restituisce il nome del nodo radice `Element` specificato nella dichiarazione `DocType`.
`getInternalSubset()`	`String`	Restituisce i dati del sottoinsieme interno per il nodo `DocumentType`.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getPublicId()`	`String`	Restituisce l'ID pubblico del sottoinsieme di dati esterno per il nodo `DocumentType`.
`getSystemId()`	`String`	Restituisce l'ID sistema del sottoinsieme di dati esterno per il nodo `DocumentType`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.
`setElementName(name)`	`DocType`	Imposta il nome del nodo radice `Element` da specificare nella dichiarazione `DocType`.
`setInternalSubset(data)`	`DocType`	Imposta i dati del sottoinsieme interno per il nodo `DocumentType`.
`setPublicId(id)`	`DocType`	Imposta l'ID pubblico del sottoinsieme di dati esterno per il nodo `DocumentType`.
`setSystemId(id)`	`DocType`	Imposta l'ID sistema del sottoinsieme di dati esterno per il nodo `DocumentType`.

`Document`

Metodi

Metodo	Tipo restituito	Breve descrizione
`addContent(content)`	`Document`	Accoda il nodo specificato alla fine del documento.
`addContent(index, content)`	`Document`	Inserisce il nodo specificato nell'indice specificato tra tutti i nodi che sono elementi secondari immediati del documento.
`cloneContent()`	`Content[]`	Crea copie non allegate di tutti i nodi che sono elementi secondari immediati del documento.
`detachRootElement()`	`Element`	Stacca e restituisce il nodo radice `Element` del documento.
`getAllContent()`	`Content[]`	Restituisce tutti i nodi che sono elementi secondari immediati del documento.
`getContent(index)`	`Content`	Restituisce il nodo nell'indice specificato tra tutti i nodi che sono elementi secondari immediati del documento.
`getContentSize()`	`Integer`	Restituisce il numero di nodi che sono elementi secondari immediati del documento.
`getDescendants()`	`Content[]`	Restituisce tutti i nodi che sono secondari diretti o indiretti del documento, nell'ordine in cui sono visualizzati nel documento.
`getDocType()`	`DocType`	Recupera la dichiarazione `DocType` del documento.
`getRootElement()`	`Element`	Restituisce il nodo radice `Element` del documento.
`hasRootElement()`	`Boolean`	Determina se il documento ha un nodo radice `Element`.
`removeContent()`	`Content[]`	Rimuove tutti i nodi che sono elementi secondari immediati del documento.
`removeContent(content)`	`Boolean`	Rimuove il nodo specificato, se è un nodo secondario immediato del documento.
`removeContent(index)`	`Content`	Rimuove il nodo nell'indice specificato tra tutti i nodi che sono elementi secondari immediati del documento.
`setDocType(docType)`	`Document`	Imposta la dichiarazione `DocType` del documento.
`setRootElement(element)`	`Document`	Imposta il nodo radice `Element` del documento.

`Element`

Metodi

Metodo	Tipo restituito	Breve descrizione
`addContent(content)`	`Element`	Accoda il nodo specificato come ultimo nodo figlio del nodo `Element`.
`addContent(index, content)`	`Element`	Inserisce il nodo specificato nell'indice specificato tra tutti i nodi secondari immediati del nodo `Element`.
`cloneContent()`	`Content[]`	Crea copie non collegate di tutti i nodi che sono elementi secondari immediati del nodo {@code Element}.
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getAllContent()`	`Content[]`	Restituisce tutti i nodi che sono elementi secondari immediati del nodo {@code Element}.
`getAttribute(name)`	`Attribute`	Recupera l'attributo per questo nodo `Element` con il nome specificato e nessuno spazio dei nomi.
`getAttribute(name, namespace)`	`Attribute`	Recupera 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)`	`Element`	Restituisce il primo nodo `Element` con il nome specificato e nessuno spazio dei nomi che è un elemento secondario immediato di questo nodo `Element`.
`getChild(name, namespace)`	`Element`	Recupera il primo nodo `Element` con il nome e lo spazio dei nomi specificati, che è un elemento secondario immediato di questo nodo `Element`.
`getChildText(name)`	`String`	Restituisce il valore di testo del nodo con il nome specificato e nessuno spazio dei nomi, se il nodo è un nodo figlio immediato del nodo `Element`.
`getChildText(name, namespace)`	`String`	Restituisce il valore di testo del nodo con il nome e lo spazio dei nomi specificati, se il nodo è un nodo secondario immediato del nodo `Element`.
`getChildren()`	`Element[]`	Recupera tutti i nodi `Element` che sono elementi secondari immediati di questo nodo `Element`, nell'ordine in cui appaiono nel documento.
`getChildren(name)`	`Element[]`	Restituisce 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 appaiono nel documento.
`getChildren(name, namespace)`	`Element[]`	Recupera tutti i nodi `Element` con il nome e lo spazio dei nomi dati che sono elementi secondari immediati di questo nodo `Element`, nell'ordine in cui appaiono nel documento.
`getContent(index)`	`Content`	Restituisce il nodo nell'indice specificato tra tutti i nodi che sono elementi secondari immediati del nodo {@code Element}.
`getContentSize()`	`Integer`	Restituisce il numero di nodi che sono elementi secondari immediati del nodo {@code Element}.
`getDescendants()`	`Content[]`	Restituisce tutti i nodi che sono figli diretti o indiretti del nodo {@code Element}, nell'ordine in cui appaiono nel documento.
`getDocument()`	`Document`	Recupera il documento XML che contiene il nodo {@code Element}.
`getName()`	`String`	Restituisce il nome locale del nodo `Element`.
`getNamespace()`	`Namespace`	Ottiene lo spazio dei nomi per il nodo `Element`.
`getNamespace(prefix)`	`Namespace`	Restituisce lo spazio dei nomi con il prefisso specificato per il nodo `Element`.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getQualifiedName()`	`String`	Restituisce il nome locale e il prefisso dello spazio dei nomi del nodo `Element`, nel formato `[namespacePrefix]:[localName]`.
`getText()`	`String`	Restituisce il valore di testo del nodo `Element`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.
`isAncestorOf(other)`	`Boolean`	Determina se questo nodo `Element` è un padre diretto o indiretto di un determinato nodo `Element`.
`isRootElement()`	`Boolean`	Determina se il nodo `Element` è il nodo radice del documento.
`removeAttribute(attribute)`	`Boolean`	Rimuove l'attributo specificato per questo nodo `Element`, se esiste un attributo di questo tipo.
`removeAttribute(attributeName)`	`Boolean`	Rimuove l'attributo per questo nodo `Element` con il nome specificato e nessuno spazio dei nomi, se esiste un attributo di questo tipo.
`removeAttribute(attributeName, namespace)`	`Boolean`	Rimuove l'attributo per questo nodo `Element` con il nome e lo spazio dei nomi specificati, se esiste un attributo di questo tipo.
`removeContent()`	`Content[]`	Rimuove tutti i nodi che sono elementi secondari immediati del nodo {@code Element}.
`removeContent(content)`	`Boolean`	Rimuove il nodo specificato, se è un nodo secondario immediato del nodo {@code Element}.
`removeContent(index)`	`Content`	Rimuove il nodo nell'indice specificato tra tutti i nodi secondari immediati del nodo {@code Element}.
`setAttribute(attribute)`	`Element`	Imposta l'attributo specificato per questo nodo `Element`.
`setAttribute(name, value)`	`Element`	Imposta l'attributo per questo nodo `Element` con il nome e il valore specificati e nessuno spazio dei nomi.
`setAttribute(name, value, namespace)`	`Element`	Imposta l'attributo per questo nodo `Element` con il nome, il valore e lo spazio dei nomi specificati.
`setName(name)`	`Element`	Imposta il nome locale del nodo `Element`.
`setNamespace(namespace)`	`Element`	Imposta lo spazio dei nomi per il nodo `Element`.
`setText(text)`	`Element`	Imposta il valore di testo del nodo `Element`.

`EntityRef`

Metodi

Metodo	Tipo restituito	Breve descrizione
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getName()`	`String`	Restituisce il nome del nodo `EntityReference`.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getPublicId()`	`String`	Restituisce l'ID pubblico del nodo `EntityReference`.
`getSystemId()`	`String`	Recupera l'ID sistema del nodo `EntityReference`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.
`setName(name)`	`EntityRef`	Imposta il nome del nodo `EntityReference`.
`setPublicId(id)`	`EntityRef`	Imposta l'ID pubblico del nodo `EntityReference`.
`setSystemId(id)`	`EntityRef`	Imposta l'ID sistema del nodo `EntityReference`.

`Format`

Metodi

Metodo	Tipo restituito	Breve descrizione
`format(document)`	`String`	Restituisce come output l'elemento `Document` specificato come stringa formattata.
`format(element)`	`String`	Restituisce come output il nodo `Element` specificato come stringa formattata.
`setEncoding(encoding)`	`Format`	Imposta la codifica dei caratteri che il formattatore deve utilizzare.
`setIndent(indent)`	`Format`	Imposta la stringa utilizzata per far rientrare i nodi figlio in base ai rispettivi elementi padre.
`setLineSeparator(separator)`	`Format`	Imposta la stringa da inserire ogni volta che il formattatore inserisce normalmente un'interruzione di riga.
`setOmitDeclaration(omitDeclaration)`	`Format`	Consente di impostare se il formattatore deve omettere la dichiarazione XML, ad esempio `<?xml version="1.0" encoding="UTF-8"?>`.
`setOmitEncoding(omitEncoding)`	`Format`	Consente di impostare se il formattatore deve omettere la codifica nella dichiarazione XML, ad esempio il campo di codifica in `<?xml version="1.0" encoding="UTF-8"?>`.

`Namespace`

Metodi

Metodo	Tipo restituito	Breve descrizione
`getPrefix()`	`String`	Restituisce il prefisso per lo spazio dei nomi.
`getURI()`	`String`	Restituisce l'URI per lo spazio dei nomi.

`ProcessingInstruction`

Metodi

Metodo	Tipo restituito	Breve descrizione
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getData()`	`String`	Restituisce i dati non elaborati per ogni istruzione nel nodo `ProcessingInstruction`.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getTarget()`	`String`	Restituisce il target per il nodo `ProcessingInstruction`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.

`Text`

Metodi

Metodo	Tipo restituito	Breve descrizione
`append(text)`	`Text`	Aggiunge il testo specificato a eventuali contenuti già esistenti nel nodo.
`detach()`	`Content`	Stacca il nodo dal nodo `Element` padre.
`getParentElement()`	`Element`	Restituisce il nodo principale `Element` del nodo.
`getText()`	`String`	Restituisce il valore di testo del nodo `Text`.
`getValue()`	`String`	Restituisce il valore di testo di tutti i nodi che sono figli diretti o indiretti del nodo, nell'ordine in cui appaiono nel documento.
`setText(text)`	`Text`	Imposta il valore di testo del nodo `Text`.

`XmlService`

Proprietà

Proprietà	Tipo	Descrizione
`ContentTypes`	`ContentType`	Un'enumerazione che rappresenta i tipi di nodi di contenuti XML.

Metodi

Metodo	Tipo restituito	Breve descrizione
`createCdata(text)`	`Cdata`	Crea un nodo `CDATASection` scollegato con il valore specificato.
`createComment(text)`	`Comment`	Crea un nodo `Comment` scollegato con il valore specificato.
`createDocType(elementName)`	`DocType`	Crea un nodo `DocumentType` scollegato per il nodo `Element` principale con il nome specificato.
`createDocType(elementName, systemId)`	`DocType`	Crea un nodo `DocumentType` scollegato per il nodo `Element` principale con il nome specificato e l'ID sistema specificato per i dati del sottoinsieme esterno.
`createDocType(elementName, publicId, systemId)`	`DocType`	Crea un nodo `DocumentType` scollegato per il nodo `Element` principale con il nome specificato, nonché l'ID pubblico e l'ID di sistema specificati per i dati del sottoinsieme esterno.
`createDocument()`	`Document`	Crea un documento XML vuoto.
`createDocument(rootElement)`	`Document`	Crea un documento XML con il nodo radice `Element` specificato.
`createElement(name)`	`Element`	Crea un nodo `Element` scollegato con il nome locale specificato e nessuno spazio dei nomi.
`createElement(name, namespace)`	`Element`	Crea un nodo `Element` scollegato con il nome locale e lo spazio dei nomi specificati.
`createText(text)`	`Text`	Crea un nodo `Text` scollegato con il valore specificato.
`getCompactFormat()`	`Format`	Crea un oggetto `Format` per l'output di un documento XML compatto.
`getNamespace(uri)`	`Namespace`	Crea un elemento `Namespace` con l'URI specificato.
`getNamespace(prefix, uri)`	`Namespace`	Crea un `Namespace` con il prefisso e l'URI specificati.
`getNoNamespace()`	`Namespace`	Crea un `Namespace` che rappresenta l'assenza di uno spazio dei nomi reale.
`getPrettyFormat()`	`Format`	Crea un oggetto `Format` per l'output di un documento XML leggibile.
`getRawFormat()`	`Format`	Crea un oggetto `Format` per l'output di un documento XML non elaborato.
`getXmlNamespace()`	`Namespace`	Crea un elemento `Namespace` con il prefisso `xml` standard.
`parse(xml)`	`Document`	Crea un valore `Document` dal file XML fornito, senza convalidarlo.