Accesso alle risorse del database con l'uso di un client WebDAV

WebDAV usa una gerarchia di contenuti, molto simile a una directory del file system, per organizzare i file in gruppi chiamati raccolte. Una raccolta può contenere altre raccolte e/o file. In Domino, questa gerarchia viene rappresentata usando il nome di ogni elemento di progettazione (il valore memorizzato nel campo $TITLE per ogni elemento) come nome del file. Ad esempio, una risorsa di immagini chiamata immagini/logo.gif apparirebbe in una raccolta di WebDAV come un file chiamato logo.gif nelle immagini denominate della raccolta radice. Nel client Domino Designer, gli elementi della raccolta vengono visualizzati nell'elenco di progettazione Risorse file condivisi con una barra finale aggiunta al nome nel campo $TITLE e un commento facoltativo. Gli elementi della raccolta sono elementi di progettazione delle risorse di file con il flag di progettazione aggiuntivo '/' nel campo $Flags.

Raccolte virtuali

Quando un elemento di progettazione viene inserito in un database Domino mediante WebDAV, Domino crea gli elementi della raccolta che rappresentino tutte le raccolte nella gerarchia di contenuti dei file inseriti. Questi elementi della raccolta detengono la proprietà della raccolta e rappresentano le raccolte possibili, o future, vuote (ossia, non che contengono elementi). Tuttavia una raccolta può esistere anche senza un elemento che la rappresenti. Ciò può accadere quando gli elementi vengono creati o rinominati usando il client di Designer. In questo caso, la raccolta viene definita raccolta virtuale. Una raccolta virtuale esiste quando un elemento di progettazione specifica il nome di una raccolta nel nome del percorso, ma per la raccolta non esiste un elemento della raccolta. Ad esempio, se la raccolta di progettazione per un database contiene una risorsa immagini intitolata immagini/logo.gif, ma non contiene un elemento della raccolta chiamato immagini, allora le immagini costituiscono una raccolta virtuale.

Le raccolte virtuali sono molto simili alle raccolte non virtuali tranne per le seguenti eccezioni:

Le proprietà di una raccolta virtuale sono un insieme di impostazioni predefinite che si basano sulle proprietà del database. Ad esempio, la data di creazione di una raccolta virtuale coincide con la data di creazione del database.
Una raccolta virtuale che non contiene più elementi, scompare.
Se un client WebDAV tenta di impostare le proprietà in una raccolta individuale, il server Domino tenta di creare un elemento di raccolta per la raccolta, trasformando la raccolta virtuale in una raccolta effettiva.

Accesso agli elementi del database

Quando si usa un client WebDAV per accedere a un database, creare prima di tutto una connessione dal client a un database su un server specifico. Ad esempio, in Esplora risorse per Windows 2000, creare Risorse di rete. Per identificare il database, immettere un URL che specifichi il nome host del sito Web, il nome del database e aggiungere la stringa $files al termine del percorso per indicare al server che si tratta di una richiesta di WebDAV. Ad esempio, per aprire il database chiamato sales.nsf come una cartella Web da Esplora risorse di Windows, immettere il percorso come indicato di seguito:

http://servername/sales.nsf$files

Una volta mappato un database in un client WebDAV, è possibile usare l'interfaccia del client WebDAV per sfogliare il database e selezionare gli elementi interni al database da aprire.

Per visualizzare il contenuto di una risorsa all'interno di un database da un browser Web usando un indirizzo URL, è necessario aggiungere il nome della risorsa (il valore del campo $TITLE associata) al nome della cartella. Per esempio,

http://nomeserver/vendite.nsf$files/immagini/logo.gif

Nota: Non è possibile usare Internet Explorer di Microsoft per accedere a un database WebDAV che si trova in una sottodirectory della directory dei dati del server Domino. In alternativa, usare Esplora risorse di Windows.

Una volta stabilita una connessione a un database Domino usando un client WebDAV, è possibile aprire una risorsa, modificarla e risalvarla sul database. Oppure è possibile aggiungere un elemento che è stato creato usando un editor di terze parti nel database.

Avvertenza:

I client WebDAV non mantengono gli attributi del sistema operativo, come ad esempio lo stato di sola lettura. Ad esempio, se si crea una pagina HTML e la si contrassegna come file di "sola lettura" in Windows, la pagina non verrà contrassegnata come sola lettura se la si aggiunge a un database e la si visualizza da Designer.

Come evitare e risolvere i conflitti di denominazione

WebDAV richiede un nome univoco per ogni risorsa. Poiché un database Domino può contenere più di un elemento con lo stesso valore nel campo $TITLE, a volte potrebbero verificarsi dei conflitti di denominazione. Ad esempio, un conflitto di denominazione può verificarsi se due autori stanno lavorando su repliche diverse dello stesso database e creano entrambi un nuovo elemento con lo stesso nome. Quando i database vengono replicati, ogni replica conterrà due diversi elementi di progettazione con lo stesso valore $TITLE.

Nota: Il blocco della progettazione non impedisce i conflitti di denominazione perché in Domino il blocco si basa su noteID, non sul nome di una nota.

Domino affronta i conflitti di denominazione arricchendo dinamicamente i nomi degli elementi in conflitto con il NoteID dell'elemento usando il modulo "Name(NoteID).ext". Il server usa questo modulo per identificare in modo univoco ogni elemento coinvolto in un conflitto di denominazione, ma non rinomina in effetti gli elementi del database. Se si vede che questa convenzione di denominazione usa un client WebDAV, cercare di risolvere il conflitto per evitare problemi. È possibile usare Esplora risorse di Windows o qualsiasi altro client WebDAV per rinominare una o più risorse in conflitto. Quando il conflitto di denominazione viene risolto in questo modo, l'altro nome di risorsa su cui questo influisce torna al formato non arricchito del nome in $TITLE. Potrebbe essere necessario aggiornare la vista di un client WebDAV allo scopo di vedere le modifiche. È anche possibile modificare il nome di un elemento nel client di Designer.

Quando un conflitto di denominazione coinvolge un elemento della raccolta, il nome di questo elemento viene arricchito come descritto precedentemente. Tuttavia, se la raccolta contiene qualsiasi elemento, una raccolta virtuale non arricchita verrà usata per conservare il contenuto della raccolta. Il risultato di ciò sarà che dal client WebDAV verranno visualizzati un nome di raccolta arricchito che non contiene elementi e un nome di raccolta non arricchito che contiene tutti gli elementi della raccolta. Le raccolte con i nomi arricchiti non possono essere la destinazione di un'operazione di spostamento o di copia e non è possibile creare gli elementi delle raccolte con i nomi arricchiti, in altre parole esse saranno sempre vuote. Tuttavia è possibile rinominare o eliminare una raccolta con un nome arricchito allo scopo di risolvere un conflitto di denominazione. Eliminando una raccolta con un nome arricchito si elimina solo l'elemento della raccolta coinvolto nel conflitto di denominazione. Non si eliminano gli elementi contenuti nella raccolta virtuale con il nome non arricchito.

Nota: Quanto esposto in precedenza implica che i nomi che corrispondono allo stile di denominazione arricchito ("Nome(NoteID).ext)", dove NoteID è la rappresentazione ASCII di un numero esadecimale a otto cifre, dovrebbero essere evitati nei nomi degli elementi di progettazione. Mentre il server Domino non consentirà di creare o denominare un elemento di progettazione da un client WebDAV con un nome che potrebbe essere confuso con un nome arricchito, il client di Designer consentirà di eseguire questa operazione.