Compartir a través de

Desarrollo de visores de documentos móviles

  • Artículo

Última modificación: miércoles, 02 de febrero de 2011

Hace referencia a: SharePoint Foundation 2010

Este tema describe cómo crear páginas móviles que hospeden visores de documentos que permitan que los usuarios vean documentos en sus dispositivos móviles con el formato de determinadas aplicaciones, como aplicaciones de procesador de textos o de hojas de cálculo. Gracias a esto, los usuarios finales móviles pueden abrir archivos de bibliotecas de documentos de Microsoft SharePoint Foundation en sus dispositivos móviles. Algunos dispositivos móviles pueden tener un visor integrado para el tipo de documento. Puede configurar el sistema de respuesta para comprobar si el dispositivo solicitante tiene un visor de este tipo y, si es así, también puede permitir que se abra el documento solicitado en explorador del dispositivo en lugar de abrirse en su explorador.

SugerenciaSugerencia

Los productos que se generan con Microsoft SharePoint Foundation, incluidos los productos de Microsoft como Microsoft SharePoint Server, pueden contener (y, de hecho, contienen) visores de documentos móviles y páginas host. Averigüe de qué elementos dispone antes de comenzar un proyecto de visor de documentos.

Información general

Para que un visor de documentos móvil esté disponible para los usuarios de la solución de SharePoint Foundation, se deben realizar dos tareas principales:

  • Crear la página que hospeda al visor.

  • Registrar la página del visor.

Creación de la página host del visor

Una página host de visor móvil suele ser un archivo .aspx que se implementa en la carpeta %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\Layouts\Mobile en cada servidor front-end web. No se pueden realizar generalizaciones absolutas sobre el contenido de la página. El centro de la página suele ser una referencia a un control que puede mostrar un documento del tipo especificado. También puede haber controles para habilitar la edición, paginación u otras funcionalidades relacionadas con el tipo de documento.

Registro de la página

Para registrar la página, se crea un archivo XML denominado mdocview_*.xml, donde * es una cadena de caracteres de nombre de archivo válidos. Se recomienda usar el nombre de la compañía o alguna otra cadena que asegure que el nombre sea distinto al que usan otros proveedores de visores de documentos. La página se implementa en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config en todos los servidores front-end web.

El nodo superior del archivo es un elemento MobileDocViewers. Agregue al menos un elemento MobileDocViewer secundario. A continuación se muestra un ejemplo de un elemento MobileDocViewer:

<MobileDocViewers>
  <MobileDocViewer Name="xps" FilePath="/_layouts/mobile/mxps.aspx" QueryId="doc" AppendSourceUrl="true" />

</MobileDocViewers>

El atributo Name identifica la extensión de nombre de archivo del tipo de archivos que el visor puede mostrar. El atributo FilePath identifica el nombre de archivo y la ruta de acceso relativa al sitio web del archivo que creó para hospedar al visor. El atributo QueryId especifica la clave de la consulta de dirección URL; en este caso, se anexa "?doc=" al final de la dirección URL de la página host del visor. El atributo AppendSourceUrl especifica si, al final de la dirección URL, se debe anexar o no la dirección URL del documento que el usuario desea ver. En este caso, debido a que el valor es true, la dirección URL se anexa. De esta manera, la dirección URL completa relativa al sitio para ver un archivo denominado File.xps de la biblioteca de documentos ubicada en http://MyServer/Shared Documents/File.xps sería /_layouts/mobile/mxps.aspx?doc=http:%2F%2FMyServer%2FShared%20Documents%2FFile%2Exps.

Se recomienda empaquetar la página como una característica que se puede activar o desactivar en el nivel de la colección de sitios. Si lo hace, el elemento MobileDocViewer también tendrá un atributo FeatureId que identifica la característica mediante un GUID. A continuación se muestra un ejemplo.

<MobileDocViewers>
  <MobileDocViewer Name="xps" FilePath="/_layouts/mobile/mxps.aspx" QueryId="doc" AppendSourceUrl="true" 
                   FeatureId="XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" />

</MobileDocViewers>

Si el visor puede abrir documentos que tienen más de un tipo de extensión de nombre de archivo, agregue un elemento MobileDocViewer independiente para cada extensión.

Si el dispositivo solicitante tiene su propio visor para el tipo de documento que abre su visor, el archivo compat.browser ubicado en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG\Browsers puede tener una entrada para el explorador que indica esta funcionalidad. Por ejemplo, un teléfono con Windows Mobile 7.0 tiene un cliente Office Mobile que puede abrir determinados tipos de documentos de Microsoft Office en el teléfono móvil. A continuación se muestra la entrada para este cliente en compat.browser.

<browser id="OfficeMobileClient" parentID="default">
  <identification>
    <userAgent match="^Office Mobile Web Access$" /> 
  </identification>
  <capabilities>
    <capability name="isMobileDevice" value="true" />
    <capability name="overrideMobileDocViewerRedirection" value="true" />
  </capabilities>
</browser>

El elemento capability denominado overrideMobileDocViewerRedirection se establece en true. Esto significa que este explorador puede ver algunos tipos de documentos de Microsoft Office.

Puede dejar que el propio visor de un explorador invalide su visor; para ello, deberá agregar un elemento BrowserCondition secundario al elemento MobileDocViewer. El elemento BrowserCondition comprueba si el dispositivo solicitante tiene su propio explorador y, si es así, redirige la solicitud desde la página host del visor a algún otro controlador de solicitudes. Por ejemplo, el siguiente MobileDocViewer especifica que los archivos .docx se abran en el archivo mWord.aspx. Sin embargo, si el explorador tiene su propio visor, la solicitud se desvía a MobileDocHandler.ashx en su lugar.

<MobileDocViewer Name="docx" FilePath="/_layouts/mobile/mWord.aspx" FeatureId="8DFAF93D-E23C-4471-9347-07368668DDAF" QueryId="doc" AppendSourceUrl="true" >
  <BrowserCondition Id="overrideMobileDocViewerRedirection" Value="true">
    <Override FilePath="/_layouts/MobileDocHandler.ashx" AppendSourceUrl="false" />
  </BrowserCondition>
</MobileDocViewer>

No reutilice el término overrideMobileDocViewerRedirection para el nombre de la capacidad, dado que ésta hace referencia al visor del cliente Office Mobile. En su lugar, cree un nuevo término. Por ejemplo, si un tipo de explorador tiene un visor de XPS, puede agregar una entrada para ese explorador en el archivo compat.browser y darle un elemento capability con CanViewXPS como valor del atributo name. A continuación, agregue un elemento secundario BrowserCondition al elemento MobileDocViewer y use CanViewXPS como valor del atributo Id.

Vea también

Conceptos

Desarrollo de dispositivos móviles con SharePoint Foundation

Bloque de creación: Páginas, controles y adaptadores móviles