Prontuario della sintassi di ricerca

La ricerca in Agenda è semplice e veloce: basta digitare qualche termine di ricerca per cercare istantaneamente in tutte le tue note. I risultati presenti nella panoramica o nel progetto attualmente selezionati vengono mostrati in cima all’elenco dei risultati, mentre quelli nei progetti archiviati o nel cestino vengono mostrati alla fine.

Puoi però anche creare interrogazioni molto più complesse, sia facendo clic o toccando i token di ricerca nel campo di ricerca che vengono creati premendo la barra spaziatrice o il tasto Invio, sia tramite un sistema molto simile a quello delle azioni di testo (consulta il capitolo Prontuario delle azioni di testo), in combinazione con un potente completamento automatico.

Le proprietà di ricerca sono precedute da una barra rovesciata (\) che richiama un menu di completamento automatico con le proprietà disponibili su cui effettuare la ricerca, ulteriormente filtrabili digitando i primi caratteri dell’azione che desideri utilizzare.

Suggerimento: su iPhone e iPad senza tastiera hardware, digitare la barra rovesciata può risultare un po’ scomodo. In alternativa puoi semplicemente toccare l’icona della lente d’ingrandimento nel campo di ricerca. Comodo!

Analogamente, su alcune tastiere, come quelle cinesi o giapponesi, è difficile digitare una barra rovesciata; per questo, ovunque sia indicata una barra rovesciata, puoi anche usare due apici inversi (``) o due punti mediani (··).

Molte di queste proprietà possono accettare i cosiddetti parametri tra parentesi (in modo simile a come puoi aggiungere valori come parametri ai tag, consulta il capitolo Tag, persone, azioni di testo e link), per perfezionare ulteriormente il comportamento di queste azioni. Ad esempio, \title(starts-with: yak) cerca la parola yak all’inizio del titolo della nota.

I parametri indicati come Predefinito sono considerati il parametro predefinito se non ne viene fornito alcuno. Ad esempio, \tag(important) equivale a \tag(name: important).

Qui sotto trovi una panoramica completa delle proprietà di ricerca attualmente supportate da Agenda.

Proprietà delle note

\all

• cerca in tutti i campi di una nota (Predefinito)
• sinonimi: everything

\on-the-agenda

• cerca in base allo stato In Agenda di una nota
• sinonimi: ontheagenda, ota, agenda

\title

• cerca nel titolo di una nota
• sinonimi: ti

\assigned-date

• cerca in base alla data assegnata a una nota, ovvero una nota a cui è assegnata una singola data
• sinonimi:
• abbreviazioni: \today, \tomorrow, \yesterday, \monday, \tuesday, \wednesday, \thursday, \friday, \saturday, \sunday

\start-date

• cerca in base alla data d’inizio di una nota, ovvero il primo giorno di una nota a cui è assegnato un intervallo di date
• sinonimi:

\end-date

• cerca in base alla data di fine di una nota, ovvero l’ultimo giorno di una nota a cui è assegnato un intervallo di date
• sinonimi:

Data assegnata e data d’inizio/fine a confronto: \assigned-date riguarda le note a cui è stata assegnata una singola data, mentre \start-date e \end-date riguardano le note a cui è stato assegnato un intervallo di date. Se una nota ha una sola data, \assigned-date e \start-date corrisponderanno alle stesse note, quindi i loro risultati si sovrappongono. La differenza diventa visibile solo quando le note hanno intervalli di date.

\linked-event

• cerca in base all’evento collegato a una nota
• sinonimi:

\calendar

• cerca in base al calendario dell’evento collegato a una nota
• sinonimi:

\due-date

• cerca in base alla data di scadenza dei promemoria presenti in una nota
• sinonimi:

\color

• cerca in base al colore di sfondo di una nota
• sinonimi:

\pinned

• cerca in base allo stato di fissaggio di una nota
• sinonimi:

\footnote

• cerca in base allo stato di nota a piè di pagina di una nota
• sinonimi:

\done

• cerca in base allo stato di completamento di una nota
• sinonimi:

\locked

• cerca in base allo stato di blocco di una nota
• sinonimi:

\shared

• cerca in base allo stato di condivisione di una nota
• sinonimi:

\edited-date

• cerca in base alla data di modifica di una nota
• sinonimi:

\creation-date

• cerca in base alla data di creazione di una nota
• sinonimi:

\template

• cerca in base al modello utilizzato per creare una nota
• sinonimi:

Contenuto della nota

\tag

• cerca in base al tag presente nel contenuto di una nota
• sinonimi: #

Parametri

• name - il nome del tag - Predefinito, obbligatorio
• color - il nome o il valore esadecimale del colore del tag - Premium
• value, text, string - un valore di testo facoltativo - Secondo predefinito
• day, on, after, before, until, from, in - un valore di giorno facoltativo
• date, at - un valore di data facoltativo
• int, integer, number, level - un valore intero facoltativo
• float, double - un valore in virgola mobile facoltativo

Esempi

• \tag(name: important) - crea il tag #important, equivalente a \tag(important)
• \tag(important, color: blue) - crea il tag #important di colore blu
• \tag(important, color: #333) - crea il tag #important con il colore esadecimale #333
• \tag(priority, value: high) - crea il tag #priority(high), equivalente a \tag(priority, high)
• \tag(due, day: tomorrow) - crea il tag #due(6 April 2022)
• \tag(due, in: 3 weeks) - crea il tag #due(26 April 2022)
• \tag(deadline, at: 17 oct 2022 13pm) - crea il tag #deadline(17 Oct 2022 at 13.00)
• \tag(priority, int: 1, color: red) - crea il tag #priority(1) in rosso
• \tag(version, float: 2.1) - crea il tag #version(2.1)

\person

• cerca in base alla persona presente nel contenuto di una nota
• sinonimi: @, contact

Parametri

• name, alias, nickname - il nome della persona - Predefinito, obbligatorio

Esempi

• \person(name: Tom G) - crea la persona @(Tom G), equivalente a \person(Tom G)

\reminder

• cerca in base al promemoria presente nel contenuto di una nota
• sinonimi: \remind,

Parametri

• none - inserisce un promemoria segnaposto non pianificato
• due-date - una stringa in linguaggio naturale che rappresenta una data futura - Predefinito
• title - il titolo del promemoria da pianificare
• list - l’elenco nell’app Promemoria in cui pianificare il promemoria
• all-day - pianifica il promemoria come promemoria per l’intera giornata

Esempi

• \reminder - crea un promemoria non pianificato e apre il popover di modifica
• \reminder(today) - pianifica un promemoria per oggi tra 30 minuti
• \reminder(today at 6pm) - pianifica un promemoria per oggi alle 18
• \reminder(tomorrow evening) - pianifica un promemoria per domani alle 18
• \reminder(in 3 weeks) - pianifica un promemoria tra 21 giorni
• \reminder(25 dec 2020, at 8pm)` - pianifica un promemoria per il 25 dicembre 2020 alle 20
• \reminder(today at 6pm, list: important) - pianifica un promemoria per oggi alle 18 nell’elenco di promemoria “important”
• \reminder(all-day: tomorrow) - pianifica un promemoria per l’intera giornata di domani

\table

• cerca in base alla tabella presente nel contenuto di una nota
• sinonimi:

\link

• cerca in base al link presente nel contenuto di una nota
• sinonimi:

\attachment

• cerca in base all’allegato presente nel contenuto di una nota
• sinonimi:

\drawing

• cerca in base al disegno presente nel contenuto di una nota
• sinonimi:

\starred

• cerca in base allo stato di stella nel contenuto di una nota
• sinonimi:

\has-todo

• cerca in base alla presenza di elementi da fare nel contenuto di una nota
• sinonimi:

\has-checklist

• cerca in base alla presenza di una lista di controllo nel contenuto di una nota
• sinonimi:

\has-list

• cerca in base alla presenza di un elenco numerato o puntato o di una lista di controllo nel contenuto di una nota
• sinonimi:

\has-code

• cerca in base alla presenza di uno snippet di codice nel contenuto di una nota
• sinonimi:

\has-quote

• cerca in base alla presenza di una citazione nel contenuto di una nota
• sinonimi:

Progetti e Categorie

\category

• cerca in base alla categoria che contiene una nota
• sinonimi:

\project

• cerca in base al progetto che contiene una nota
• sinonimi:

\archived

• cerca in base al fatto che una nota faccia parte di un progetto archiviato
• sinonimi:

Preimpostazioni

\recently-edited

• cerca tra le note modificate di recente
• sinonimi:

\now

• cerca tra le note attualmente in corso
• sinonimi:

\upcoming

• cerca tra le note imminenti
• sinonimi:

\earlier

• cerca tra le note appena terminate
• sinonimi:

\on-this-day

• cerca tra le note del passato che sono state assegnate allo stesso giorno di un anno precedente.
• sinonimi:

\random

• restituisce un determinato numero di note selezionate casualmente
• sinonimi:

Operatori

AND

• entrambi i termini devono essere presenti
• sinonimi: &&

OR

• uno dei termini deve essere presente
• sinonimi: ||

NOT

• il termine non deve essere presente
• sinonimi: !

Corrispondenze letterali

() e ""

Raggruppamento

Localizzazione

Tieni presente che tutte le azioni e i parametri devono essere correttamente localizzati in base alla lingua dell’app. In tal caso puoi usare sia la variante inglese riportata sopra sia le varianti tradotte. Nota che, sebbene le azioni possano contenere accenti e/o maiuscole, non è necessario digitarli: ad esempio, nella versione francese di Agenda puoi ottenere un elenco numerato digitando una qualsiasi delle seguenti opzioni:

• \numérotée
• \numerotee
• \Numérotée
• \numbered