Collections fornisce delle API Javascript ed un editor di codice in-app.

L'API Javascript è limitata alle Fonti, puoi usare Javascript per cercare e creare documenti interrogando servizi esterni (es. Google Books). Per creare una Fonte, apri una raccolta → premi sul bottone → Modifica → Fonti.

L'API è accessibile attraverso l'oggetto app.

Risultato

Rete

let request = app.request("https://www.google.com");
let response = request.send();
let data = response.json();

Storage

app.storage.firstName = "John";
app.storage.lastName = "Doe";
app.storage["full-name"] = "John Doe";

Risultati di ricerca

let result = app.searchResult.new();
result.title = "Harry Potter";
result.subtitle = "J. K. Rowling";
result.params = {id: 12345};

Document builder

Puoi usare Document builder per creare un nuovo documento o usarne uno esistente.

Prima di usare document builder, assicurati di impostare un alias per ogni campo (Modifica un campo → Alias).

• Per URL, Email, Telefono, Codice a barre puoi semplicemente usare setString.
• Per Intervallo di tempo puoi usare setDecimal specificando il valore in secondi.
• Per "Data e ora" puoi usare setDate.
• Per Colore puoi usare setString specificando il valore hex (es. #00FF00).

let document = app.document.builder();
document.setString("Harry Potter", "name");
document.setString("Pottermore Publishing", "publisher");
document.setInteger(223, "page-count");

Suggerimenti

Quando crei un documento, di solito vuoi impostare elementi di una lista o documenti già esistenti. Per risolvere questo problema, l'app usa il concetto di suggerimento.

Un suggerimento contiene un identificatore e tutti i dati necessari a creare l'elemento. L'app cercherà l'elemento corrispondente all'identificatore specificato, e se quell'elemento non esiste, ne creerà uno nuovo.

Suggerisci un elemento lista

let listItem = app.listItem.suggest("fantasy", "Fantasy");
document.setListItem(listItem, "genre");

Suggerisci un documento

Per suggerire un documento, crea un nuovo document builder e chiama builder.setIdentifier(fieldAlias) per impostare un campo come identificatore. Se stai creando un nuovo documento, non è necessario chiamare questo metodo.

let author = app.document.builder();
author.setIdentifier("name");
author.setString("J. K. Rowling", "name");

let book = app.document.builder();
book.setString("Harry Potter", "name");
book.setDocument(author, "author");

L'esempio crea un autore con il campo name come identificatore. L'autore viene poi salvato in un libro, l'app cercherà un autore dal nome "J. K. Rowling" o ne creerà uno nuovo se questo non esiste.

Suggerisci una posizione

Puoi suggerire una posizione tramite coordinate o indirizzo.

let location = app.location.suggestWithCoordinates(40.730610, -73.935242);

let document = app.document.builder();
document.setLocation(location, "location");

Group builder

Puoi usare Group builder per aggiungere valori ad un gruppo.

let document = app.document.builder();

let group = app.group.builder();

group.add.string("String 1");
group.add.string("String 2");
group.add.string("String 3");

document.setGroup(group, "my-group");

Documento

Un oggetto che gestisce un documento esistente.

// During a document update
let document = app.currentDocument;
let title = document.getValue("title");

// Find a document by short ID
let document = app.document.findById("ABC123");
let title = document.getValue("title");

Aggiornare un documento

Un documento può essere aggiornato da una fonte. Per iniziare, abilita la funzione da → Modifica → Fonti → Fonte → Abilita aggiornamento documento.

Quindi apri un documento, e dalla schermata di dettaglio, premi su → Aggiorna da... → Fonte.

Utilità