Uso de elementos de Outlook Web App

 

Se aplica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Última modificación del tema: 2016-11-28

Puede usar elementos web de Microsoft Office Outlook Web App para especificar el buzón que se abrirá, la carpeta en la que se abrirá el buzón y la vista de contenido que se usará.

Los elementos web de Outlook Web App permiten tener acceso al contenido de Outlook Web App directamente desde una URL. La URL puede especificarse en un explorador web o incrustarse en una aplicación. En general, los elementos web no se crean manualmente, sino que se crean de forma programada a partir de selecciones hechas en una interfaz de usuario o bien se insertan directamente en una aplicación, por ejemplo, una página de MicrosoftOffice SharePoint Server 2007 o SharePoint Server 2010. El código subyacente en la interfaz de usuario crea la URL. Un uso de los elementos web de Outlook Web App consiste en mostrar la Bandeja de entrada o el Calendario de un usuario en una página de SharePoint Server 2007 o SharePoint Server 2010.

Nota

Para usar los elementos web de Outlook Web App, tanto el buzón de correo del usuario como el buzón que se abre mediante un elemento web deben encontrarse en el mismo bosque de Active Directory.

Permisos para usar los elementos web de Outlook Web Access

Para usar los elementos web de Outlook Web App, como mínimo, deberá tener delegado el acceso de "Revisor" al contenido que esté abriendo. Si ha insertado un elemento web de Outlook Web App que necesite autenticarse en una aplicación, debe pasar información de autenticación junto con la solicitud del elemento web. Una forma de hacerlo es configurar el directorio virtual de Outlook Web App para usar la autenticación integrada de Windows. La autenticación integrada de Windows permite a los usuarios que ya se hayan registrado a través de su cuenta de Active Directory usar Outlook Web App sin tener que escribir de nuevo sus credenciales.

Sintaxis de elementos web de Outlook Web App

Outlook Web App en Microsoft Exchange Server 2010 tiene un nuevo formato de URL que se usa para solicitudes al directorio virtual /owa. Estas solicitudes pueden realizarse si se escribe directamente una dirección URL en un explorador web o se inserta la dirección URL en una aplicación web, por ejemplo una página de SharePoint Server.

Los elementos web de Outlook Web App se pueden usar para crear direcciones URL de diferente complejidad. Una URL de un elemento web sencillo se puede usar para abrir la Bandeja de entrada de cualquier buzón. Una URL de un elemento web más complejo se podría usar para especificar el buzón que se deberá abrir, la carpeta de dicho buzón que se deberá abrir y la vista de contenido que se deberá usar.

Por ejemplo, la URL de un elemento web sencillo https://<nombre del servidor>/owa/?cmd=contents abrirá la Bandeja de entrada del buzón determinado en el inicio de sesión del usuario. La URL de un elemento web más complejo https://<nombre del servidor>/owa/<dirección SMTP>/?cmd=contents&f=inbox%2fProjects&view=by%20subject abrirá el buzón especificado por la dirección SMTP en la subcarpeta Proyectos, ordenada por asunto.

En función de las medidas de seguridad que se hayan aplicado a la red, puede que tenga que configurar la codificación para la URL de los elementos web. Tras configurar la codificación, el código de la IU creará la URL con los parámetros codificados en la URL. Los parámetros codificados en la URL usan %20 en lugar de espacios y %2f en lugar del delimitador de ruta de acceso "/". Todos los ejemplos de este tema usan parámetros codificados.

En la tabla siguiente se indican los parámetros de un elemento web y algunos ejemplos de cómo usarlos.

Parámetros de elementos web y cómo se usan

Parámetro URL Descripción Valores y ejemplos

Nombre del servidor y directorio (obligatorio)

La URL del directorio virtual de Outlook Web App.

Ésta puede ser la misma URL que usan los usuarios para iniciar sesión en Outlook Web App, por ejemplo:

https://<nombre del servidor>/owa

Identificación explícita del buzón para el inicio de sesión de Exchange 2010 (opcional)

Cualquier dirección SMTP asociada con el buzón que se va a abrir.

Si falta esta sección de la URL, se abre el buzón predeterminado del usuario autenticado.

Si no se especifican parámetros adicionales, el comportamiento predeterminado consiste en abrir la Bandeja de entrada.

Para abrir el buzón con la dirección SMTP tsmith@fourthcoffee.com, use la URL siguiente:

https://<nombre del servidor>/owa/tsmith@fourthcoffee.com

cmd (se requiere en el caso de no especificar ningún parámetro diferente a la identificación explícita del buzón para el inicio de sesión)

?cmd=contents muestra el elemento web de Outlook Web App que especifican los parámetros en lugar de la interfaz de usuario completa de Outlook Web App.

Si no se especifica ningún buzón de correo, el parámetro cmd aparecerá después de la dirección de inicio de sesión, como se indica a continuación:

https://<nombre del servidor>/owa/?cmd=contents

Si se especifica un buzón de correo, el parámetro cmd aparecerá después de la identificación explícita del buzón, como se indica a continuación:

https://<nombre del servidor>/owa/<dirección SMTP>/?cmd=contents

Si no se especifican parámetros adicionales, el comportamiento predeterminado consiste en abrir la Bandeja de entrada.

id (opcional)

El identificador de carpeta de la carpeta desde la que el elemento web mostrará el contenido. Éste se puede obtener mediante el uso de servicios web y se puede usar en aplicaciones para seleccionar dinámicamente la carpeta que se deberá abrir.

El identificador de carpeta es el PR_ENTRY_ID codificado en base64 de la carpeta, por ejemplo:

https://<nombre del servidor>/owa/?cmd=contents&id=<PR_ENTRY_ID>

fpath (opcional)

Una cadena que especifica la carpeta de buzón que se mostrará en el elemento web. La URL del elemento web puede haberse escrito mediante el uso de la codificación URL para que pueda atravesar los firewalls.

Cuando se usa la codificación URL, un espacio se convierte en %20 y un delimitador de ruta de acceso (/), en %2f.

La jerarquía de carpeta comenzará en la raíz del buzón.

Esta ruta de carpeta puede apuntar a carpetas ordinarias o carpetas de búsqueda.

Para abrir la subcarpeta Proyectos en la Bandeja de entrada, use la URL siguiente:

https://<nombre del servidor>/owa/?cmd=contents&fpath= inbox%2fprojects

module (opcional)

Este parámetro se puede usar para especificar cualquiera de las cuatro carpetas predeterminadas sin conocer el nombre localizado.

Los valores del parámetro module no distinguen entre mayúsculas y minúsculas e incluyen lo siguiente:

  • Bandeja de entrada

  • Calendario

  • Contactos

  • Tareas

  • Carpetas públicas

Para abrir el calendario de un buzón independientemente de su localización, use la URL siguiente:

https://<nombre del servidor>/owa/?cmd=contents&module=calendar

view (opcional)

Este parámetro especifica la vista que se va a mostrar para la carpeta.

Las vistas predeterminadas cuando este parámetro no está presente son las siguientes:

  • Calendario   Diario

  • Mensajes   Mensajes

  • Contactos   Two%20Line

  • Tareas   By%20Due%20Date

Nota

Las cadenas para las vistas predeterminadas se codifican automáticamente en URL.

El orden predeterminado de una vista es la forma en la que la carpeta se ordenaría si se abriera en el cliente de Outlook Web App.

Las cadenas que identifican las vistas no están localizadas y no distinguen entre mayúsculas y minúsculas.

Las vistas disponibles varían en función del tipo de carpeta.

Vistas de calendario:

  • Diaria   La vista de calendario diario

  • Semanal   La vista de calendario semanal

  • Mensual   La vista del calendario mensual

Vistas de mensajes:

  • Mensajes   La vista de mensajes, con orden predeterminado

  • By%20Sender   Vista de mensajes ordenados por De con los nombres de los remitentes que comienzan por "a" en la parte superior

  • By%20Subject   Vista de mensajes ordenados por Asunto con los asuntos que comienzan por "a" en la parte superior

  • By%20Conversation%20Topic   Vista de conversación, no disponible en la versión ligera de Outlook Web App 

Vistas de contactos:

  • Phone%20List   Vista de contactos, con orden predeterminado

Tareas:

  • By%20Due%20Date   Vista de tareas con orden predeterminado

  • By%20Subject   Vista de tareas ordenadas por asunto, con las que comienzan por "a" en la parte superior

https://<nombre del servidor>/owa/?cmd=contents&fpath=Calendar&view=Weekly mostrará el calendario solicitado en la vista Semanal.

d, m, y (opcional)

Especifica la fecha por la que debe mostrarse el calendario. Estos parámetros pueden especificarse en cualquier orden y usarse por separado o de forma conjunta.

Si no se especifica ninguno de estos parámetros, los valores predeterminados son los valores del día, mes y año actuales. Por ejemplo, si hoy es 03.05.10 y especifica un valor de mes de "9" para septiembre, la fecha mostrada será el 03.09.10.

Los valores válidos para el parámetro de fecha son los siguientes:

d=[1-31]

m=[1-12]

y=[año de cuatro dígitos]

Para abrir un calendario con la fecha 3 de mayo de 2007, debería usar la URL siguiente: https://<nombre del servidor>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2007

part (opcional)

Especifica que Outlook Web App deberá mostrar un elemento web más pequeño.

Cuando use elementos web para tener acceso al contenido de Outlook Web App, la IU que se muestra será más pequeña que la IU completa de Outlook Web App. El parámetro part reduce aún más la IU. En la siguiente URL de ejemplo se muestra la lista de tareas en el formato de elemento web más pequeño:

https://<nombre del servidor>/owa/?cmd=contents&fpath=tasks&part=1

El parámetro part no se aplica al módulo de calendario.

En la figura siguiente se muestra el elemento web Tareas de Outlook Web App sin el parámetro part=1.

URL de elemento web sin Part=1

En la figura siguiente se muestra el elemento web Tareas de Outlook Web App con el parámetro part=1.

URL de elemento web con Part=1

Puede usar múltiples parámetros para especificar la carpeta que se mostrará y con qué formato lo hará. Si se usa más de un parámetro de carpeta, el orden de prioridad es id, f y, a continuación, module. Si no aparece ninguno de estos parámetros, se mostrará la Bandeja de entrada de forma predeterminada.

Nota

Si se ha desactivado una función mediante segmentación, esa función no estará disponible como elemento web. Por ejemplo, si se ha deshabilitado el calendario de Outlook Web App, no podrá tener acceso a los calendarios mediante el uso de elementos web de Outlook Web App.

Introducir elementos web de Outlook Web App manualmente

Los elementos web de Outlook Web App pueden especificarse también manualmente en un explorador web. Por ejemplo, un usuario puede usar una URL de un elemento web de Outlook Web App para abrir el calendario de otro usuario.

Para abrir un calendario específico en una vista Mensual:

  1. Abra una ventana del explorador web.

  2. Escriba la URL de Outlook Web App y agregue la siguiente cadena al final de la URL: <dirección SMTP del buzón>/?cmd=contents&fpath=calendar&view=weekly.

  3. Introduzca las credenciales de inicio de sesión, si así se le indica.

Por ejemplo, si la URL de Outlook Web App es https://email.fourthcoffee.com/owa, la siguiente URL abrirá el calendario que pertenece al usuario tsmith en la vista Semanal: https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents\&fpath=calendar\&view=weekly

Más información

 © 2010 Microsoft Corporation. Reservados todos los derechos.