Разработка средств просмотра документов для мобильных устройств

Статья
04/21/2015

Дата последнего изменения: 2 февраля 2011 г.

Применимо к: SharePoint Foundation 2010

В этом разделе описывается создание страниц (предназначенных для мобильных устройств), на которых размещаются средства просмотра документов, позволяющие пользователям просматривать на своих мобильных устройствах документы в формате конкретных приложений, таких как текстовый процессор или электронные таблицы. Это предоставляет пользователям возможность открывать файлы в библиотеках документов Microsoft SharePoint Foundation на своих мобильных устройствах. На некоторых мобильных устройствах для некоторых типов документов может быть установлено встроенное средство просмотра. Можно настроить реагирующую систему так, чтобы она проверяла наличие средства просмотра на запрашивающем устройстве и при его наличии в качестве варианта позволяла открывать запрошенный документ в браузере устройства.

Совет
Продукты, созданные на основе Microsoft SharePoint Foundation, в том числе такие продукты Microsoft, как Microsoft SharePoint Server, уже могут содержать и действительно содержат средства просмотра документов для мобильных устройств и страницы для их размещения. Прежде чем начинать проект средства просмотра документов узнайте, какие средства уже доступны.

Продукты, созданные на основе Microsoft SharePoint Foundation, в том числе такие продукты Microsoft, как Microsoft SharePoint Server, уже могут содержать и действительно содержат средства просмотра документов для мобильных устройств и страницы для их размещения. Прежде чем начинать проект средства просмотра документов узнайте, какие средства уже доступны.

Обзор

Предоставление пользователям решения SharePoint Foundation доступа к средству просмотра документов включает следующие два этапа.

Создание страницы, на которой размещается средство просмотра.
Регистрация страницы средства просмотра

Создание страницы, на которой размещается средство просмотра

Страница размещения средства просмотра для мобильных устройств обычно представляет собой ASPX-файл, который развертывается в папку %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\Layouts\Mobile на каждом интерфейсном веб-сервере. Никаких обобщений о содержании страницы сделать нельзя. Основным элементом страницы обычно является ссылка на элемент управления, который может отображать документ заданного типа. Могут также предоставляться элементы управления, обеспечивающие редактирование, разбиение на страницы или другие функциональные возможности, связанные с типом документа.

Регистрация страницы

Для регистрации страницы необходимо создать XML-файл с именем mdocview_*.xml, где * — это некоторая строка допустимых символов имени файла. Рекомендуется использовать название организации или какую-то другую строку, которая, скорее всего, не будет дублировать имя, используемое другими поставщиками средств просмотра документов. Эта страница развертывается в каталог "%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\Config" на всех интерфейсных веб-серверах.

Верхним узлом файла является элемент MobileDocViewers. Добавьте хотя бы один дочерний элемент MobileDocViewer. Пример элемента MobileDocViewer приведен ниже:

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

</MobileDocViewers>

Атрибут Name определяет расширение имени файла для типа файлов, которые может отображать средство просмотра. Атрибут FilePath задает путь относительно веб-сайта и имя файла, создаваемого для размещения средства просмотра. Атрибут QueryId задает ключ запроса URL-адреса, в данном случае в конец URL-адреса страницы размещения средства просмотра добавляется "?doc=". Атрибут AppendSourceUrl определяет, должен ли в конец URL-адреса добавляться URL-адрес документа, который пользователю требуется просмотреть. В данном случае, поскольку указано значение "true", URL-адрес добавляется. Соответственно полный URL-адрес относительно веб-сайта, используемый для просмотра файла с именем File.xps в библиотеке документов, находящегося по адресу http://MyServer/Shared Documents/File.xps, будет /_layouts/mobile/mxps.aspx?doc=http:%2F%2FMyServer%2FShared%20Documents%2FFile%2Exps.

Рекомендуется упаковывать страницу как компонент, который может быть включен или выключен на уровне семейства веб-сайтов. В таком случае у элемента MobileDocViewer также будет атрибут FeatureId, определяющий этот компонент по значению GUID. См. следующий пример.

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

</MobileDocViewers>

Если средство просмотра может открывать документы, имеющие несколько видов расширений имени файла, добавьте для каждого расширения отдельный элемент MobileDocViewer.

Если у запрашивающего устройства есть собственное средство просмотра для типа документа, открываемого пользовательским средством просмотра, то в файле compat.browser, находящемся в папке %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\CONFIG\Browsers, может содержаться запись для браузера, указывающая на эту возможность. Например, у телефона с операционной системой Windows Mobile 7.0 есть мобильный клиент Office, который может открывать определенные типы документов Microsoft Office на мобильном телефоне. Запись для этого клиента в файле 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>

Для элемента capability с именем overrideMobileDocViewerRedirection задано значение true. Это означает, что данный браузер позволяет просматривать некоторые типы документов Microsoft Office.

Можно задать использование собственного средства просмотра браузера вместо средства просмотра, предоставляемого веб-сайтом, добавив дочерний элемент BrowserCondition к элементу MobileDocViewer. Элемент BrowserCondition проверяет, есть ли у запрашивающего устройства собственный браузер и, если есть, перенаправляет запрос со страницы размещения средства просмотра другому обработчику запроса. Например, в следующем элементе MobileDocViewer определяется, что DOCX-файлы открываются в файле mWord.aspx. Но если у браузера есть собственное средство просмотра, запрос вместо этой страницы будет направлен на страницу MobileDocHandler.ashx.

<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>

Не используйте повторно условие overrideMobileDocViewerRedirection для имени предоставляемой функции, так как эта функция ссылается на средство просмотра мобильного клиента Office. Вместо этого создайте собственное условие. Например, если у некоторого типа браузера есть средство просмотра XPS, можно добавить запись для этого браузера в файл compat.browser и задать для него элемент capability с использованием CanViewXPS в качестве значения атрибута name. Затем добавьте дочерний элемент BrowserCondition к предоставляемому элементу MobileDocViewer и используйте CanViewXPS в качестве значения атрибута Id.

См. также

Концепции

Разработка для мобильных устройств с помощью SharePoint Foundation

Базовые элементы разработки: страницы, элементы управления и адаптеры для мобильных устройств

Поделиться через