Class ListItem

ListItem

Obsoleta. Questa classe è deprecata e non deve essere utilizzata nei nuovi script.

Un ListItem dei siti: un elemento dell'elenco di una pagina Elenco di siti.

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
deleteListItem()	void	Elimina questo elemento dell'elenco.
getDatePublished()	Date	Restituisce la data della prima pubblicazione di questo elemento dell'elenco.
getLastUpdated()	Date	Indica la data dell'ultimo aggiornamento del commento.
getParent()	Page	Ottieni la pagina principale di questo elemento dell'elenco.
getValueByIndex(index)	String	Ottieni il valore di questo ListItem per una colonna numerata.
getValueByName(name)	String	Ottieni il valore di questo ListItem per una colonna con nome.
setParent(parent)	ListItem	Imposta la pagina principale di questo elemento dell'elenco.
setValueByIndex(index, value)	ListItem	Imposta il valore di questo ListItem per una colonna numerata.
setValueByName(name, value)	ListItem	Imposta il valore di questo ListItem per una colonna numerata.

Metodi deprecati

deleteListItem()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Elimina questo elemento dell'elenco.

// This code sample deletes all list items from a List page
// Running this code sample against a Page that is a standard web page will
// cause getListItems() to throw an exception
var page = SitesApp.getSite('demositeappsscript').getChildByName('mylistpage');
var items = page.getListItems();
for(var i = 0; i < items.length; i++) {
  items[i].deleteListItem();
}

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

getDatePublished()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Restituisce la data della prima pubblicazione di questo elemento dell'elenco.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var items = page.getListItems();
var date = items[0].getDatePublished();

Ritorni

Date: la data di pubblicazione originale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

getLastUpdated()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Indica la data dell'ultimo aggiornamento del commento.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var items = page.getListItems();
var date = items[0].getLastUpdated();

Ritorni

Date: data dell'ultimo aggiornamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

getParent()

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Ottieni la pagina principale di questo elemento dell'elenco.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var items = page.getListItems();
// parentPage will equal page
var parentPage = items[0].getParent();

Ritorni

Page: la pagina principale

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

getValueByIndex(index)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Ottieni il valore di questo ListItem per una colonna numerata.

var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage");
var listItem = page.getListItems()[0];

// Remember that rows are 0 indexed. This returns the item in the first column
// of the list. If an index that is greater than the number of columns is used,
// the script will throw an "InvalidArgument: index" exception.
var value = listItem.getValueByIndex(5);

Parametri

Nome	Tipo	Descrizione
index	Integer	la colonna per ottenere il valore

Ritorni

String: il valore della colonna.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

getValueByName(name)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Ottieni il valore di questo ListItem per una colonna con nome.

var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage");
var listItem = page.getListItems()[0];

// Suppose we have a column named "Owner" - this will let us fetch the value
// for the list item
var value = listItem.getValueByName("Owner");
Logger.log(value);

Parametri

Nome	Tipo	Descrizione
name	String	la colonna per ottenere il valore

Ritorni

String: il valore della colonna.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

setParent(parent)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta la pagina principale di questo elemento dell'elenco.

var page = SitesApp.getSite('example.com', 'mysite').getChildByName('mylistpage');
var secondListPage = SitesApp.getSite('example.com', 'mysite')
                             .getChildByName('secondlistpage');
var items = page.getListItems();

// Returns secondListPage
var parentPage = items[0].setParent(secondListPage).getParent();

Parametri

Nome	Tipo	Descrizione
parent	Page	il nuovo genitore

Ritorni

ListItem - questo ListItem per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

setValueByIndex(index, value)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta il valore di questo ListItem per una colonna numerata. Per le colonne URL, il valore deve essere un anchor tag XML, con le entità XML con escape.

var page = SitesApp.getSite("example.com", "mysite").getChildByName("mylistpage");
var listItem = page.getListItems()[0];
listItem.setValueByIndex(1, 'This is the new value');
listItem.setValueByIndex(2, '<a href="http://www.example.com?a=1&amp;b=2">Example</a>');

Parametri

Nome	Tipo	Descrizione
index	Integer	la colonna per impostare il valore
value	String	il nuovo valore

Ritorni

ListItem - questo ListItem per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds

---

setValueByName(name, value)

Obsoleta. Questa funzione è deprecata e non deve essere utilizzata nei nuovi script.

Imposta il valore di questo ListItem per una colonna numerata. Per le colonne URL, il valore deve essere un anchor tag XML, con le entità XML con escape.

var page = SitesApp.getSite("demositeappsscript").getChildByName("mylistpage");
var listItem = page.getListItems()[0];
listItem.setValueByName('Owner', 'Eric');
listItem.setValueByName('Page', '<a href="http://www.example.com?a=1&amp;b=2">Example</a>');

Parametri

Nome	Tipo	Descrizione
name	String	la colonna per impostare il valore
value	String	il nuovo valore

Ritorni

ListItem - questo ListItem per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

• https://sites.google.com/feeds