Como configurar Web Parts no Outlook Web Access
Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007
Tópico modificado em: 2009-10-29
Este tópico descreve as Web Parts do Microsoft Office Outlook Web Access e explica como usá-las para abrir pastas específicas. Você pode usar as Web Parts do Outlook Web Access para especificar a caixa de correio a ser aberta, a pasta dentro dessa caixa de correio a ser aberta, e a exibição de conteúdo a ser usada.
As Web Parts do Outlook Web Access permitem que você acesse o conteúdo do Outlook Web Access diretamente de uma URL. A URL pode ser inserida em um navegador da Web ou incorporada em um aplicativo. Geralmente, as Web Parts não são criadas manualmente. Em vez disso, elas são criadas de forma programada com base nas seleções feitas em uma interface de usuário (UI) ou são incorporadas diretamente em um aplicativo, como uma página do Microsoft Office SharePoint Server 2007. O código oculto na UI cria então a URL. Um uso para as Web Parts do Outlook Web Access é exibir a Caixa de Entrada ou o Calendário de um usuário em uma página do Office SharePoint Server 2007.
Dica
Para usar o Outlook Web Access Web Parts, a caixa de correio do usuário e a caixa de correio que está sendo aberto por meio de um Web Part deverão estar na mesma floresta do Active Directory.
Permissões para o uso das Web Parts do Outlook Web Access
Para usar as Web Parts do Outlook Web Access, você deve ter, no mínimo, acesso de "Revisor" delegado para o conteúdo que está abrindo. Se você tiver incorporado uma Web Part do Outlook Web Access que exige autenticação para um aplicativo, deverá passar informações de autenticação junto com a solicitação para a Web Part. Uma forma de fazer isso é configurando o diretório virtual do Outlook Web Access para usar a autenticação Integrada do Windows. A autenticação Integrada do Windows permite que usuários já conectados ao usar a conta do Active Directory usem o Outlook Web Access sem ter de inserir suas credenciais novamente.
Sintaxe das Web Parts do Outlook Web Access
O Exchange 2007 Outlook Web Access tem um novo formato de URL para usar para solicitações ao diretório virtual /owa. Essas solicitações podem ser feitas digitando uma URL diretamente em um navegador da Web ou incorporando a URL em um aplicativo da Web, como uma página do Office SharePoint Server.
As Web Parts do Outlook Web Access podem ser usadas para criar URLs de complexidade variada. Uma URL de Web Part simples pode ser usada para abrir a Caixa de Entrada de qualquer caixa de correio. Uma URL de Web Part mais complexa pode ser usada para especificar a caixa de correio a ser aberta, a pasta dentro dessa caixa de correio a ser aberta, e a exibição de conteúdo a ser usada.
Por exemplo, a URL de Web Part simples https://<nome de servidor>/owa/?cmd=contents abrirá a Caixa de Entrada da caixa de correio que é determinada pelo logon do usuário. A URL de Web Part mais complexa https://<nome do servidor>/owa/<SMTP address>/?cmd=contents&f=inbox%2fProjects&view=by%20subject abrirá a caixa de correio especificada pelo endereço SMTP na subpasta Projects, classificada por assunto.
Dependendo das medidas de segurança que forem aplicadas à sua rede, talvez seja necessário configurar a codificação para a URL das Web Parts. Depois de configurar a codificação, o código oculto na UI criará a URL usando os parâmetros codificados pela URL. Os parâmetros codificados pela URL usam %20 no lugar de espaços e %2f no lugar do delimitador de caminho "/". Todos os exemplos deste tópico usam parâmetros codificados.
As Web Parts do Microsoft Exchange 2000 e do Exchange 2003 com suporte são convertidas automaticamente em Web Parts do Exchange 2007.
A Tabela 1 lista os parâmetros de uma Web Part e exemplos de como eles são usados.
Tabela 1 Parâmetros da Web Part e como eles são usados
Parâmetro de URL | Descrição | Valores e exemplos |
---|---|---|
Nome do servidor e diretório (necessário) |
A URL do diretório virtual do Outlook Web Access. |
Pode ser a mesma URL que os usuários usam para fazer logon no Outlook Web Access, por exemplo: https://<nome do servidor>/owa |
Identificação da caixa de correio de logon explícito do Exchange 2007 (opcional) |
Qualquer endereço SMTP associado à caixa de correio a ser aberta. Se essa seção da URL estiver ausente, a caixa de correio padrão do usuário autenticado estará aberta. Se nenhum parâmetro adicional for especificado, o comportamento padrão será abrir a Caixa de Entrada. |
Para abrir a caixa de correio com o endereço SMTP pneves@fourthcoffee.com, use: https://<nome do servidor>/owa/tsmith@fourthcoffee.com |
cmd (necessário se você estiver especificando qualquer parâmetro diferente da identificação de caixa de correio de logon explícita) |
?cmd=contents exibe a Web Part do Outlook Web Access que é especificada pelos parâmetros em vez da interface de usuário completa do Outlook Web Access. |
Se nenhuma caixa de correio for especificada, esse parâmetro virá após o diretório de servidor: https://<nome do servidor>/owa/?cmd=contents Se uma caixa de correio for especificada, esse parâmetro virá após a identificação explícita da caixa de correio: https://<nome do servidor>/owa/<endereço SMTP>/?cmd=contents Se nenhum parâmetro adicional for especificado, o comportamento padrão será abrir a Caixa de Entrada. |
id (opcional) |
O ID da pasta da qual a Web Part deve exibir o conteúdo. Isso pode ser obtido usando os serviços da Web e pode ser usado em aplicativos para selecionar dinamicamente qual pasta abrir. |
O ID da pasta é o PR_ENTRY_ID codificado em Base64 da pasta: https://<nome do servidor>/owa/?cmd=contents&id=<PR_ENTRY_ID> |
f (opcional) |
Uma cadeia de caracteres que especifica a pasta da caixa de correio a ser exibida na Web Part. A URL da Web Part pode precisar ser gravada usando a codificação de URL para que ela possa passar por firewalls. Quando você usa a codificação de URL, um espaço se torna %20, e um delimitador de caminho (/) se torna %2f. A hierarquia da pasta deve iniciar na raiz da caixa de correio. Esse caminho de pasta pode apontar para pastas comuns ou pastas de pesquisa. |
Para abrir a subpasta Projects na Caixa de Entrada, use: https://<nome do servidor>/owa/?cmd=contents&f= inbox%2fprojects |
module (opcional) |
Esse parâmetro pode ser usado para especificar qualquer das quatro pastas padrão sem saber o nome localizado. |
Os valores do parâmetro do módulo não diferenciam maiúsculas de minúsculas, e incluem o seguinte:
Para abrir o calendário de uma caixa de correio seja qual for a localização: https://<nome do servidor>/owa/?cmd=contents&module=calendar |
view (opcional) |
Esse parâmetro especifica a exibição a ser mostrada para a pasta. As exibições padrão quando esse parâmetro não está presente são as seguintes:
Dica As cadeias de caracteres para as exibições padrão são automaticamente codificadas na URL. O tipo de exibição padrão é a forma como a pasta será classificada se ela for aberta no cliente Outlook Web Access. As exibições da Web Part do Exchange 2003 que não são aceitas no Exchange 2007 são as seguintes:
As cadeias de caracteres que identificam as exibições não são localizadas e não diferenciam maiúsculas de minúsculas. |
As exibições disponíveis variam de acordo com o tipo de pasta. Exibições de calendário:
Exibições de mensagem:
Exibições de contato:
Tarefas:
https://<nome do servidor>/owa/?cmd=contents&f=Calendar&view=Weekly exibirá o calendário solicitado na exibição Semanal. |
d, m, y (opcional) |
Especifica a data na qual o calendário deve ser exibido. Esses parâmetros podem ser inseridos em qualquer ordem e podem ser usados sozinhos ou juntos. Se nenhum desses parâmetros for especificado, os valores padrão serão os valores de dia, mês e ano atuais. Por exemplo, se o dia atual for 3 de maio de 2007 e você especificar o valor de mês "9" para setembro, a data exibida será 3 de setembro de 2007. |
Os valores válidos para os parâmetros de dados são os seguintes: d=[1-31] m=[1-12] y=[ano com quatro dígitos] Para abrir um calendário para a data 3 de maio de 2007, você usaria https://<nome do servidor>/owa/?cmd=content&f=calendar&view=daily&d=3&m=5&y=2007 |
part (opcional) |
Especifica que o Outlook Web Access deve exibir uma Web Part menor. |
Quando você usa Web Parts para acessar o conteúdo de Outlook Web Access, a UI que é exibida será menor que a UI completa do Outlook Web Access. Esse parâmetro part reduz a UI ainda mais. Esse exemplo mostra a lista de tarefas no formato da menor Web Part: https://<nome do servidor>/owa/?cmd=contents&f=tasks&part=1 As Figuras 1 e 2 mostram a UI que o Outlook Web Access exibirá com e sem part=1 aplicado à Web Part de Tarefas. |
A Figura 1 mostra a Web Part de Tarefas do Outlook Web Access sem o parâmetro part=1.
Figura 1 URL de Web Part sem Part=1
A Figura 2 mostra a Web Part de Tarefas do Outlook Web Access com o parâmetro part=1.
Figura 2 URL de Web Part com Part=1
Você pode usar vários parâmetros para especificar a pasta a ser exibida e o formato para exibi-la. Se mais de um parâmetro for usado, a ordem será id, f e, em seguida, module. Se nenhum desses parâmetros estiver presente, a Caixa de Entrada será exibida por padrão.
Dica
Se um recurso for desativado usando a segmentação, esse recurso não estará disponível como uma Web Part. Por exemplo, se o calendário do Outlook Web Access foi desabilitado, você não poderá acessar calendários usando Web Parts do Outlook Web Access.
Usando Web Parts do Outlook Web Access manualmente
As Web Parts do Outlook Web Access podem ser inseridas manualmente em um navegador da Web. Por exemplo, um usuário pode usar uma URL da Web Part do Outlook Web Access para abrir o calendário de outro usuário.
Para abrir um calendário específico na exibição Semanal:
Abra uma janela do navegador da Web.
Digite a URL do Outlook Web Access e adicione a seguinte cadeia de caracteres no final da URL: <endereço SMTP da caixa de correio>/?cmd=contents&f=calendar&view=weekly.
Digite as credenciais de logon, caso seja solicitado.
Por exemplo, se a URL do Outlook Web Access for https://email.fourthcoffee.com/owa, a seguinte URL abrirá o calendário que pertence ao usuário tsmith na exibição Semanal:
https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents\&f=calendar\&view=weekly
Para acessar diretamente uma pasta específica em Pastas Públicas, adicione a cadeia de caracteres &f=<Nome_da_pasta> para a URL /owa/?cmd=contents&module=PublicFolders. Por exemplo, a URL completa para acessar uma pasta específica em Pastas Públicas é semelhante com a seguinte:
https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<Nome_da_pasta>
Para cada nível de pasta abaixo do nível que você deseja acessar, é preciso adicionar a cadeia de caracteres %2f<Nome_da_pasta>. Por exemplo, para acessar uma pasta no próximo nível da hierarquia de pastas das Pastas Públicas, a URL completa deve ser semelhante à seguinte:
https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<Nome_da_pasta>%2f<Nome_da_pasta>
Para cada nível de pasta que você deseja acessar, adicione a cadeia de caracteres %2f<Nome_da_pasta>. Por exemplo, se desejar acessar uma pasta que está quatro níveis abaixo nas Pastas Públicas, use uma URL semelhante à seguinte:
https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<Nome_da_pasta>%2f<Nome_da_pasta>%2f<Nome_da_pasta>%2f<Nome_da_pasta>
Para obter mais informações
Para obter mais informações sobre Web Parts e sobre como planejar páginas da Web, consulte o seguinte:
Para obter mais informações sobre a autenticação do Outlook Web Access, consulte os seguintes tópicos: