Guida di Lotus Domino Designer 8.5 - Comandi URL per l'apertura di server, database e viste

IMPOSTAZIONE DELLE APPLICAZIONI

Comandi URL per l'apertura di server, database e viste
I seguenti comandi accedono a server, database, viste, documenti, documenti "Informazioni sul database", documenti della Guida e icone di database. Affinché sia possibile accedervi mediante un comando URL, i database devono trovarsi nella cartella notes\data o in una sua sottocartella, tranne nel caso di comandi server come ?Login, ?Logout e ?Redirect. Qualora sia necessario specificare il nome di un database usando la sintassi di un comando server, ad esempio usando Microsoft Internet Information Server, è sarà possibile servirsi del nome di un database che non esiste. Se il database citato all'interno di un comando server non esiste, tale database sarà ignorato. Usare ?Redirect per reindirizzare i collegamenti a documento tra i vari server. Gli elementi di impostazione nascosti sono tali anche per il server; non è possibile usare i comandi URL di IBM® Lotus® Domino(TM) per accedere a documenti contenuti in viste nascoste.

Attenzione Se è impostata la proprietà del database "Non consentire apertura URL", i comandi URL vengono disabilitati.

Nota Gli URL mostrati di seguito sono solo a titolo di esempio. Essi non fanno riferimento ad alcun sito Web realmente esistente.

Redirect

Sintassi

http://Server/Dummy.nsf?Redirect&Name=notesserver&Id=To=encodedurl

Dove:

http://Server fa riferimento al server Web che genera l'indirizzo URL.
Name=notesserver specifica il nome di un server Domino nella sua forma comune o abbreviata. Questo argomento è facoltativo quando sul server è attiva l'impostazione "Per database".
ID=repid indica l'ID di replica del database da ricercare. Questo argomento è facoltativo.
To=encodedurl specifica il resto dell'URL.

Esempio

http://mercury.com/dummy.nsf?Redirect&Name=Mister%2FHankey&Id=0525666D0060ABBF&To=%FAView%3FOpenView

Nota Se si forza la disconnessione mediante il comando ?Logout, è possibile reindirizzare l'utente verso un altro sito Web mediante il parametro &RedirectTo.

OpenDatabase

Sintassi

http://Host/__IDReplicaDatabase.nsf?OpenDatabase

Esempi

http://www.mercury.com/ordini.nsf?OpenDatabase

http://www.mercury.com/vendite/discussione.nsf?OpenDatabase

http://www.mercury.com/__852562F3007ABFD6.nsf?OpenDatabase

OpenView

Sintassi

http://Host/Database/NomeVista?OpenView

http://Host/Database/IDUniversaleVista?OpenView

http://Host/Database/$defaultview?OpenView

Esempi

http://www.mercury.com/ordini.nsf/Per+venditore?OpenView

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F300702264?OpenView

http://www.mercury.com/ordini.nsf/$defaultview?OpenView

Argomenti facoltativi di OpenView

Per meglio definire un URL, è possibile aggiungere gli argomenti facoltativi. È possibile anche combinare i seguenti argomenti per ottenere il risultato desiderato.

Collapse=n

Dove

è il numero della riga da visualizzare in formato compresso all'interno di una vista gerarchica. Non usare questo argomento assieme a ExpandView o CollapseView.

CollapseView

Visualizza la vista in formato compresso

Count=n

Dove

è il numero di righe da visualizzare

Expand=n

Dove

è il numero di righe da visualizzare in formato espanso all'interno di una vista gerarchica. Non usare questo argomento assieme a ExpandView o CollapseView.

ExpandView

Visualizza la vista in formato esteso

RestrictToCategory=categoria

Imposta

la categoria dell'oggetto "Mostra categoria singola"

Dove categoria è la categoria da visualizzare nella vista.

Start=n

Dove

è il numero della riga da cui partire nella visualizzazione della vista. Il numero della riga in una vista gerarchica può includere dei sottoindici (Ad esempio, Start=3.5.1 significa che la visualizzazione inizierà dal terzo argomento principale, sottoargomento 5, documento 1).

StartKey=stringa

Dove

stringa

è la chiave che punta a un documento della vista. La vista viene visualizzata a partire da quel documento.

Esempi

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?OpenView&CollapseView

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?OpenView&ExpandView

http://www.mercury.com/ordini.nsf/Per+categoria?OpenView&RestrictToCategory=prezzi

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?OpenView&Start=3&Count=15

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?OpenView&StartKey=F

ReadViewEntries

Questo comando può essere usato per accedere ai dati di una vista in un modulo XML senza attributi di aspetto quali caratteri, separatori di lista, formati di data, impostazioni HTML, modelli di vista e reindirizzamenti di cornici.

Nota Questo comando restituisce solo i documenti a cui l'utente è autorizzato ad accedere.

Sintassi

http://Host/Database/NomeVista?ReadViewEntries

http://Host/Database/IDUniversaleVista?ReadViewEntries

http://Host/Database/$defaultview?ReadViewEntries

Esempi

http://www.mercury.com/ordini.nsf/Per+venditore?ReadViewEntries

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F300702264?ReadViewEntries

http://www.mercury.com/ordini.nsf/$defaultview?ReadViewEntries

Argomenti facoltativi di ReadViewEntries

Per meglio definire un URL, è possibile aggiungere gli argomenti facoltativi. È possibile anche combinare i seguenti argomenti per ottenere il risultato desiderato.

Collapse=n

Dove

è il numero della riga da visualizzare in formato compresso all'interno di una vista gerarchica. Non usare questo argomento assieme a ExpandView o CollapseView.

CollapseView

Visualizza la vista in formato compresso

Count=n

Dove

è il numero di righe da visualizzare

Endview=1

Fa in modo che l'ultimo documento restituito da ReadViewEntries sia l'ultimo documento della vista. Utilizzare insieme a Count =

per visualizzare gli ultimi

documenti della vista.

Expand=n

Dove

è il numero di righe da visualizzare in formato espanso all'interno di una vista gerarchica. Non usare questo argomento assieme a ExpandView o CollapseView.

ExpandView

Visualizza la vista in formato esteso

KeyType=testo|ora|numero

Specifica il tipo di StartKey. Valore predefinito quando non viene specificato alcun argomento per il testo. Impostando KeyType su un orario è possibile usare un valore relativo a un orario per StartKey indica da quale riga visualizzare la vista e usare un valore per UntilKey, che specifica dove terminare la visualizzazione della vista. Se viene specificato &KeyType=orario, &StartKey e &UntilKey possono essere indicati come orari in formato ISO. Ad esempio, si potrebbe usare il valore 20020101T140000,00Z per indicare le ore 9:00 AM Eastern Standard Time del 01/01/2202 in Coordinated Universal Time (UTC) o Greenwich Mean Time (GMT), oppure il valore 20020101T090000,00-05 per indicare le stesse data e ora in ora locale più uno scostamento. Impostare il KeyType su un numero quando combinato con l'argomento StartKey permette di trattare come valore numerico lo StartKey specificato.

NavigateReverse=1

Se si comincia con il documento iniziale nella vista, elenca quel documento iniziale e i documenti con numeri di riga minori.

Outputformat=JSON

Visualizza la vista in formato JavaScript Object Notation.

PreFormat

Causa la conversione in formato testo di tutti i tipi di dati presenti sul server. Liste di testo, numeri, date e liste numeriche vengono convertiti in testo prima di essere inviati. L'impostazione locale del server viene usata per tutte le formattazioni. Senza questo argomento, i dati XML in uscita contengono informazioni in formato strutturato prive di impostazioni locali.

ResortAscending=numero colonna

ResortDescending=numero colonna

Dove

numero colonna

è il numero, a partire da 0, della colonna della vista da riordinare alfabeticamente.

RestrictToCategory=categoria

Imposta

la categoria dell'oggetto "Mostra categoria singola", dove categoria è la categoria da visualizzare nella vista.

Start=n

Dove

è il numero della riga da cui partire nella visualizzazione della vista. Il numero della riga in una vista gerarchica può includere dei sottoindici (ad esempio, Start=3.5.1 significa che la visualizzazione inizierà dal terzo argomento principale, sottoargomento 5, documento 1).

StartKey=stringa

Dove

stringa

è la chiave relativa a un documento in una vista ordinata. La vista viene visualizzata a partire da quel documento. Nei casi in cui non esiste corrispondenza per StartKey, viene restituito il documento successivo. Quindi, se StartKey è "A" e non ci sono documenti che iniziano con "A", StartKey restituisce il primo documento che inizia con "B".

UntilKey=stringa

UntilKey è valido solo se usato con StartKey. Consente di visualizzare l'intervallo di voci della vista che iniziano con il documento specificato da StartKey fino al documento specificato da UntilKey. Ad esempio, &StartKey=A&UntilKey=B restituisce tutte le voci che iniziano con A. Usare la parola chiave &Count per limitare ulteriormente il numero di voci restituite in un intervallo specificato.

Esempi

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?ReadViewEntries&CollapseView

http://www.mercury.com/ordini.nsf/By+Category?ReadViewEntries&Endview=1&Count=3

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?ReadViewEntries&ExpandView

http://www.mercury.com/ordini.nsf/By+Category?ReadViewEntries&NavigateReverse=1&Start=50

http://www.mercury.com/ordini.nsf/By+Category?ReadViewEntries&outputformat=JSON

http://www.mercury.com/ordini.nsf/Per+categoria?ReadViewEntries&PreFormat

http://www.mercury.com/ordini.nsf/Per+categoria?ReadViewEntries&RestrictToCategory=prezzi

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?ReadViewEntries&Start=3&Count=15

http://www.mercury.com/ordini.nsf/DDC087A8ACE170F8852562F30070226400000196?ReadViewEntries&StartKey=F

http://www.mercury.com/ordini.nsf/By+Department?ReadViewEntries&StartKey=312&KeyType=number

OpenAbout