Uso delle Web part di Outlook Web App

  • Articolo

 

Si applica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Ultima modifica dell'argomento: 2016-11-28

È possibile utilizzare le web part di Microsoft Office Outlook Web App per specificare la cassetta postale da aprire, la cartella da aprire in tale cassetta postale e la visualizzazione del contenuto da utilizzare.

Le web part di Outlook Web App consentono di accedere al contenuto di Outlook Web App direttamente da un URL. È possibile inserire l'URL in un browser Web oppure incorporarlo in un'applicazione. Generalmente, le Web part non vengono create manualmente. Vengono invece create a livello di programmazione in base alle opzioni selezionate nell'interfaccia utente oppure vengono incorporate direttamente in un'applicazione, ad esempio una pagina di MicrosoftOffice SharePoint Server 2007 o SharePoint Server 2010. Il codice dietro l'interfaccia utente crea l'URL. Le Web part di Outlook Web App possono essere utilizzate ad esempio per visualizzare la Posta in arrivo o il Calendario di un utente in una pagina di SharePoint Server 2007 o SharePoint Server 2010.

Nota

Per utilizzare le web part di Outlook Web App, è necessario che la cassetta postale dell'utente e quella aperta tramite una web part si trovino nella stessa foresta di Active Directory.

Autorizzazioni per l'utilizzo delle web part di Outlook Web Access

Per utilizzare le web part di Outlook Web App, è necessario disporre almeno della delega per l'accesso come "Revisore" al contenuto che si intende aprire. Se è stata incorporata una Web part di Outlook Web App che richiede l'autenticazione in una applicazione, è necessario fornire le informazioni di autenticazione insieme alla richiesta della Web part. Un modo di eseguire questa operazione è configurare la directory virtuale di Outlook Web App per utilizzare l'autenticazione integrata di Windows. L'autenticazione integrata di Windows consente agli utenti che hanno già eseguito l'accesso mediante il proprio account di Active Directory di utilizzare Outlook Web App senza dover inserire nuovamente le proprie credenziali.

Sintassi delle web part di Outlook Web App

Outlook Web App in Microsoft Exchange Server 2010 dispone di un nuovo formato di URL da utilizzare per le richieste alla directory virtuale /owa. Tali richieste possono essere eseguite digitando un URL direttamente in un browser Web oppure incorporando l'URL in un'applicazione Web, ad esempio una pagina di SharePoint Server.

È possibile utilizzare le web part di Outlook Web App per creare URL di diversa complessità. È possibile utilizzare un semplice URL della web part per aprire la Posta in arrivo di una cassetta postale. Un URL della web part più complesso potrebbe essere utilizzato per specificare la cassetta postale da aprire, la cartella da aprire in tale cassetta postale e la visualizzazione del contenuto da utilizzare.

Ad esempio, il semplice URL della web part https://<nome server>/owa/?cmd=contents consentirà di aprire la Posta in arrivo della cassetta postale specificata dall'accesso dell'utente. Il più complesso URL della Web part https://<server name>/owa/<indirizzo SMTP>/?cmd=contents&fpath=inbox%2fProjects&view=by%20subject consentirà di aprire la sottocartella Projects, ordinata per argomento, nella cassetta postale specificata dall'indirizzo SMTP.

In base alle misure di protezione applicate alla rete, potrebbe essere necessario configurare una codifica per gli URL di web part. Dopo aver configurato la codifica, il codice dietro l'interfaccia creerà l'URL utilizzando i parametri con codifica URL. I parametri con codifica URL utilizzano i caratteri %20 al posto degli spazi e i caratteri %2f al posto del delimitatore di percorso "/". Tutti gli esempi in questo argomento utilizzano parametri codificati.

Nella tabella seguente vengono elencati i parametri di una web part ed esempi di possibili utilizzi.

Parametri di web part e relativo utilizzo

Parametro URL Descrizione Valori ed esempi

Nome server e directory (obbligatori)

L'URL della directory virtuale di Outlook Web App.

Può essere lo stesso URL utilizzato dagli utenti per accedere a Outlook Web App, ad esempio:

https://<nome server>/owa

Indicazione esplicita della cassetta postale con accesso di Exchange 2010 (facoltativo)

Qualsiasi indirizzo SMTP associato alla cassetta postale da aprire.

Se questa sezione dell'URL manca, verrà aperta la cassetta postale predefinita dell'utente autenticato.

Se non vengono specificati ulteriori parametri, il comportamento predefinito sarà l'apertura della Posta in arrivo.

Per aprire la cassetta postale con l'indirizzo SMTP tsmith@fourthcoffee.com, utilizzare l'URL indicato di seguito:

https://<nome server>/owa/tsmith@fourthcoffee.com

cmd (obbligatorio, se si specifica un qualsiasi parametro diverso dall'indicazione esplicita della cassetta postale di accesso)

?cmd=contents consente di visualizzare la web part di Outlook Web App specificata dai parametri anziché l'intera interfaccia utente di Outlook Web App.

Se non viene specificata una cassetta postale, il parametro cmd segue l'indirizzo di accesso:

https://<nome server>/owa/?cmd=contents

Se non viene specificata una cassetta postale, il parametro cmd segue l'indicazione esplicita della cassetta stessa:

https://<nome server>/owa/<indirizzo SMTP>/?cmd=contents

Se non vengono specificati ulteriori parametri, il comportamento predefinito sarà l'apertura della Posta in arrivo.

id (facoltativo)

L'ID della cartella di cui la web part dovrebbe visualizzare il contenuto. Lo si può ottenere utilizzando i servizi Web e può essere impiegato nelle applicazioni per selezionare in modo dinamico la cartella da aprire.

L'ID della cartella è PR_ENTRY_ID della cartella con codifica Base64, ad esempio:

https://<nome server>/owa/?cmd=contents&id=<PR_ENTRY_ID>

fpath (facoltativo)

Una stringa che specifica la cartella della cassetta postale da visualizzare nella web part. Potrebbe essere necessario scrivere l'URL della web part utilizzando la codifica URL, in modo che passi attraverso i firewall.

Se si utilizza la codifica URL, uno spazio diventa %20 e un delimitatore di percorso (/) diventa %2f.

La gerarchia di cartelle dovrebbe iniziare dalla cartella principale della cassetta postale.

Questo percorso di cartelle può puntare a normali cartelle o cartelle di ricerca.

Per aprire la sottocartella Projects in Posta in arrivo, utilizzare l'URL indicato di seguito:

https://<nome server>/owa/?cmd=contents&fpath= inbox%2fprojects

module (facoltativo)

È possibile utilizzare questo parametro per specificare una della quattro cartelle predefinite senza conoscerne il nome localizzato.

I valori del parametro module non fanno distinzione tra maiuscole e minuscole e includono quanto segue:

  • Inbox

  • Calendario

  • Contatti

  • Attività

  • Publicfolders

Per aprire il calendario di una cassetta postale indipendentemente dalla localizzazione, utilizzare l'URL indicato di seguito:

https://<nome server>/owa/?cmd=contents&module=calendar

view (facoltativo)

Questo parametro consente di specificare la visualizzazione della cartella.

Di seguito sono riportate le visualizzazioni predefinite quando non è presente questo parametro:

  • Calendar   Daily

  • Messages   Messages

  • Contacts   Two%20Line

  • Tasks   By%20Due%20Date

Nota

Le stringhe per le visualizzazioni predefinite vengono automaticamente codificate in URL.

L'ordinamento predefinito di una visualizzazione è il modo in cui verrà ordinata la cartella se viene aperta nel client di Outlook Web App.

Le stringhe che identificano le visualizzazioni non sono localizzate e non fanno distinzione tra maiuscole e minuscole.

Le visualizzazioni disponibili variano in base al tipo di cartella.

Visualizzazioni di Calendario:

  • Daily   La visualizzazione giornaliera del calendario

  • Weekly   La visualizzazione settimanale del calendario

  • Mensile   Visualizzazione mensile calendario

Visualizzazioni dei messaggi:

  • Messaggi   Visualizzazione di messaggi, con ordinamento predefinito

  • By%20Sender   Visualizzazione di messaggi con ordinamento per mittente e con i nomi dei mittenti con una "a" all'inizio

  • By%20Subject   Visualizzazione di messaggi con ordinamento per oggetto e con gli oggetti con una "a" all'inizio

  • By%20Conversation%20Topic   Visualizzazione Conversazione, non disponibile nella versione light di Outlook Web App 

Visualizzazioni dei contatti:

  • Phone%20List   Visualizzazione dei contatti, con ordinamento predefinito

Attività:

  • By%20Due%20Date   Visualizzazione delle attività con ordinamento predefinito

  • By%20Subject   Visualizzazione delle attività con ordinamento per oggetto, con una "a" all'inizio

https://<nome server>/owa/?cmd=contents&fpath=Calendar&view=Weekly consentirà di visualizzare il calendario richiesto nella visualizzazione Settimanale.

d, m, y (facoltativo)

Specifica la data da visualizzare nel calendario. È possibile inserire questi parametri in qualunque ordine e utilizzarli singolarmente o assieme.

Se uno di questi parametri non viene specificato, i valori predefiniti sono il giorno, il mese e l'anno correnti. Ad esempio, se il giorno corrente è il 03.05.10 e per il mese si specifica il valore "9", che equivale a settembre, la data visualizzata sarà il 03.09.10.

Di seguito sono riportati i valori validi per i parametri della data:

d=[1-31]

m=[1-12]

y=[anno di quattro cifre]

Per aprire un calendario alla data 3 maggio 2007, si utilizzerebbe l'URL indicato di seguito: https://<nome server>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2007

part (facoltativo)

Consente di specificare che in Outlook Web App dovrà essere visualizzata una web part più piccola.

Quando si utilizzano le web part per accedere al contenuto di Outlook Web App, l'interfaccia utente visualizzata sarà più piccola rispetto all'interfaccia intera di Outlook Web App. Il parametro part riduce ulteriormente l'interfaccia. In questo esempio di URL viene mostrato l'elenco delle attività nel formato web part più piccolo:

https://<nome server>/owa/?cmd=contents&fpath=tasks&part=1

Il parametro part non viene applicato al modulo del calendario.

Nella figura seguente viene mostrata la web part di Outlook Web App per le attività senza il parametro part=1.

URL della Web part senza Part=1

Nella figura seguente viene mostrata la web part di Outlook Web App per le attività con il parametro part=1.

URL della Web part con Part=1

È possibile utilizzare più parametri per specificare la cartella da visualizzare e il formato in cui visualizzarla. Se vengono utilizzati più parametri di cartella, l'ordine di precedenza è id, f e quindi module. Se nessuno di questi parametri è presente, per impostazione predefinita verrà visualizzata la Posta in arrivo.

Nota

Se una funzione è stata disattivata utilizzando la segmentazione, tale funzione non sarà disponibile come web part. Ad esempio, se il calendario di Outlook Web App è stato disabilitato, non sarà possibile accedere ai calendari utilizzando le web part di Outlook Web App.

Immissione manuale delle web part di Outlook Web App

È anche possibile inserire manualmente le web part di Outlook Web App in un browser Web. Ad esempio, un utente può utilizzare un URL della web part di Outlook Web App per aprire il calendario di un altro utente.

Per aprire un calendario specifico nella visualizzazione Settimanale:

  1. Aprire una finestra del browser Web.

  2. Immettere l'URL di Outlook Web App e aggiungere la seguente stringa alla fine dell'URL: <indirizzo SMTP della cassetta postale>/?cmd=contents&fpath=calendar&view=weekly.

  3. Immettere le credenziali di accesso, se vengono richieste.

Ad esempio, se l'URL di Outlook Web App è https://email.fourthcoffee.com/owa, il seguente URL aprirà il calendario che appartiene all'utente tsmith nella visualizzazione Settimanale: https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents\&fpath=calendar\&view=weekly

Per ulteriori informazioni

 ©2010 Microsoft Corporation. Tutti i diritti riservati.