Class ListItem

ListItem

Obsoleta. Questo corso è deprecato e non deve essere utilizzato in nuovi script.

Un elemento Elenco di siti: un elemento dell'elenco da 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	Restituisce la data dell'ultimo aggiornamento del commento.
getParent()	Page	Recupera la pagina principale di questo elemento dell'elenco.
getValueByIndex(index)	String	Recupera il valore di questo ListItem per una colonna numerata.
getValueByName(name)	String	Recupera il valore di questo ListItem per una colonna denominata.
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();

Invio

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.

Restituisce 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();

Invio

Date: la 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.

Recupera 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();

Invio

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.

Recupera 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	nella colonna per ottenere il valore

Invio

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.

Recupera il valore di questo ListItem per una colonna denominata.

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	nella colonna per ottenere il valore

Invio

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

Invio

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 HTML, con le entità XML con caratteri di 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	nella colonna per impostare il valore
value	String	il nuovo valore

Invio

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 HTML, con le entità XML con caratteri di 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	nella colonna per impostare il valore
value	String	il nuovo valore

Invio

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