Utilizzo delle web part di Outlook Web App
Si applica a: Exchange Server 2013
È possibile usare Le web part di Microsoft Office Outlook Web App per specificare la cassetta postale da aprire, la cartella all'interno della cassetta postale da aprire e la visualizzazione contenuto da usare.
Outlook Web App web part consentono di accedere al contenuto Outlook Web App direttamente da un URL. L'URL può essere immesso in un Web browser o incorporato in un'applicazione. In genere, le web part non vengono create manualmente. Vengono invece creati a livello di codice in base alle selezioni effettuate in un'interfaccia utente o incorporati direttamente in un'applicazione, ad esempio una pagina di SharePoint Server. Il codice sottostante all'interfaccia utente crea quindi l'URL. Un uso per Outlook Web App web part consiste nel visualizzare la posta in arrivo o il calendario di un utente in una pagina di SharePoint.
Nota
Per usare Outlook Web App web part, sia la cassetta postale dell'utente che la cassetta postale aperta tramite una web part devono trovarsi nella stessa foresta di Active Directory.
Autorizzazioni per l'uso di web part Outlook Web App
Per usare Outlook Web App web part, è necessario disporre almeno dell'accesso "Revisore" al contenuto che si sta aprendo. Se è stato incorporato un Web part Outlook Web App che richiede l'autenticazione in un'applicazione, è necessario passare le informazioni di autenticazione insieme alla richiesta per la web part. A tale scopo, configurare la directory virtuale Outlook Web App per l'uso di Integrated autenticazione di Windows. La autenticazione di Windows integrata consente agli utenti che hanno già eseguito l'accesso usando il proprio account Active Directory di usare Outlook Web App senza dover immettere di nuovo le credenziali.
sintassi web part Outlook Web App
Outlook Web App in Exchange 2013 ha un formato URL da usare per le richieste alla directory virtuale /owa. Queste richieste possono essere effettuate digitando un URL direttamente in un Web browser o incorporando l'URL in un'applicazione Web, ad esempio una pagina di SharePoint Server.
Outlook Web App web part possono essere usate per creare URL di complessità variabile. È possibile usare un semplice URL della web part per aprire la posta in arrivo di qualsiasi cassetta postale. È possibile usare un URL della web part più complesso per specificare la cassetta postale da aprire, la cartella all'interno della cassetta postale da aprire e la visualizzazione contenuto da usare.
A seconda delle misure di sicurezza applicate alla rete, potrebbe essere necessario configurare la codifica per l'URL delle web part. Dopo aver configurato la codifica, il codice sottostante all'interfaccia utente creerà l'URL usando i parametri con codifica URL. I parametri con codifica URL usano %20 al posto degli spazi e %2f al posto del delimitatore di percorso "/". Tutti gli esempi in questo argomento usano parametri codificati.
La tabella seguente elenca i parametri di una web part ed esempi di come vengono usati.
Nota
Exchange 2016, Exchange 2019 e Exchange Online non includono più il supporto per le web part.
Parametri della web part e modalità di utilizzo
| Parametro URL | Descrizione | Valori ed esempi |
|---|---|---|
| Nome del server e directory (obbligatorio) | URL della directory virtuale Outlook Web App. | Può trattarsi dello stesso URL usato dagli utenti per accedere a Outlook Web App, ad esempio:https://<server name>/owa |
| Identificazione esplicita della cassetta postale di accesso di Exchange 2013 (facoltativo) | Qualsiasi indirizzo SMTP associato alla cassetta postale da aprire. Se questa sezione dell'URL non è presente, viene aperta la cassetta postale predefinita dell'utente autenticato. Se non vengono specificati parametri aggiuntivi, il comportamento predefinito consiste nell'aprire posta in arrivo. |
Per aprire la cassetta postale con l'indirizzo tsmith@fourthcoffee.comSMTP , usare l'URL seguente:https://<server name>/owa/tsmith@fourthcoffee.com |
| cmd (obbligatorio se si specifica un parametro diverso dall'identificazione esplicita della cassetta postale di accesso) | ?cmd=contentsvisualizza il Web part Outlook Web App specificato dai parametri anziché l'interfaccia utente Outlook Web App completa. |
Se non viene specificata alcuna cassetta postale, il parametro cmd viene visualizzato dopo l'indirizzo di accesso, come indicato di seguito:https://<server name>/owa/?cmd=contents Se viene specificata una cassetta postale, il parametro cmd viene visualizzato dopo l'identificazione esplicita della cassetta postale, come indicato di seguito: https://<server name>/owa/<SMTP address>/?cmd=contents Se non vengono specificati parametri aggiuntivi, il comportamento predefinito consiste nell'aprire posta in arrivo. |
| exsvurl | Questo parametro deve essere incluso quando si usa l'autenticazione LiveID Tutti i parametri verranno eliminati durante l'autenticazione LiveID se "exsvurl=1" non è presente. Questo parametro è destinato solo alle cassette postali di Microsoft 365 e Office 365. |
https://<server name>/owa/?cmd=contents&exsvurl=1 |
| fpath (facoltativo) | La parte dell'URL potrebbe dover essere scritta usando la codifica URL in modo che possa passare attraverso i firewall. Quando si usa la codifica URL, uno spazio diventa %20 e un delimitatore di percorso (/) diventa %2f. La gerarchia di cartelle deve iniziare dalla radice della cassetta postale. Questo percorso di cartella può puntare a cartelle ordinarie o cartelle di ricerca. |
Per aprire la sottocartella Progetti nella posta in arrivo, usare l'URL seguente:https://<server name>/owa/?cmd=contents&fpath=inbox%2fprojects |
| modulo (facoltativo) | Questo parametro può essere usato per specificare una delle cartelle predefinite senza conoscere il nome localizzato. | I valori per il parametro del modulo non fanno distinzione tra maiuscole e minuscole e includono i valori seguenti:
Per aprire il calendario di una cassetta postale indipendentemente dalla localizzazione, usare l'URL seguente: |
| view (facoltativo) | Questo parametro specifica la visualizzazione da visualizzare per la cartella. Le visualizzazioni predefinite quando questo parametro non è presente sono le seguenti:
Nota: le stringhe per le visualizzazioni predefinite vengono codificate automaticamente con URL. |
Le visualizzazioni disponibili variano in base al tipo di cartella. Visualizzazioni calendario:
Visualizzazioni dei messaggi:
|
| d, m, y (facoltativo) | Specifica la data per la quale deve essere visualizzato il calendario. Questi parametri possono essere immessi in qualsiasi ordine e possono essere usati in modo ingante o insieme. Se uno di questi parametri non viene specificato, i valori predefiniti sono i valori correnti di giorno, mese e anno. Ad esempio, se il giorno corrente è il 3 maggio 2016 e si specifica il valore del mese "9" per settembre, la data visualizzata sarà il 3 settembre 2016. |
I valori validi per i parametri di dati sono i seguenti: d=[1-31] m=[1-12] y=[anno a quattro cifre] Per aprire un calendario alla data 3 maggio 2016, usare l'URL seguente: https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016 |
| part (facoltativo) | Specifica che Outlook Web App deve visualizzare una web part più piccola. | Quando usi web part per accedere al contenuto Outlook Web App, l'interfaccia utente visualizzata sarà più piccola dell'interfaccia utente Outlook Web App completa. Il parametro part riduce ulteriormente l'interfaccia utente. L'URL di esempio seguente mostra l'elenco Attività nel formato della web part più piccolo:https://<server name>/owa/?cmd=contents&part=1 Il parametro part non si applica al modulo calendario. |
| FolderList | Questo parametro di parte include il controllo elenco cartelle per consentire agli utenti di passare da una sottocartella all'altra. Questo vale solo per le cartelle di posta elettronica. | https://<server name>/owa/?cmd=contents&folderlist=1 |
Immettere Outlook Web App web part manualmente
Outlook Web App web part possono essere immesse manualmente anche in un Web browser. Ad esempio, un utente può usare un URL di Web part Outlook Web App per aprire il calendario di un altro utente.
Gli esempi seguenti illustrano come accedere direttamente alle viste Outlook Web App comuni:
- Posta in arrivo:
https://<server name>_/owa/?cmd=contents\&module=inbox - Calendario (oggi):
https://<server name>/owa/?cmd=contents\&module=calendar\&exsvurl=1 - Calendario (settimanale):
https://<server name>/owa/?cmd=contents\&module=calendar\&view=weekly\&exsvurl=1 - Calendario (mensile):
https://<server name>/owa/?cmd=contents\&module=calendar\&view=monthly\&exsvurl=1