Бөлісу құралы:

Размещение надстройки Office в Microsoft Azure

  • Мақала

Простейшая надстройка Office состоит из XML-файла манифеста и HTML-страницы. XML-файл манифеста описывает характеристики надстройки, такие как ее имя, то, в каких классических клиентах Office она может запускаться, а также URL-адрес HTML-страницы надстройки. HTML-страница содержится в веб-приложении, с которым пользователь взаимодействует, когда устанавливает и запускает надстройку в клиентском приложении Office. Вы можете разместить веб-приложение надстройки Office на любой платформе веб-хостинга, включая Azure.

В этой статье рассказывается, как развернуть веб-приложение надстройки в Azure и загрузить неопубликованную надстройку для тестирования в клиентском приложении Office.

Предварительные требования

  1. Установите Visual Studio 2019 и не забудьте включить рабочую нагрузку Разработка для Azure.

    Примечание.

    Если Visual Studio 2019 уже установлен, убедитесь, что рабочая нагрузка Разработка для Azure установлена, используя установщик Visual Studio.

  2. Установите Office.

    Примечание.

    Если у вас еще нет Office, можете оформить бесплатную пробную подписку на 1 месяц.

  3. Подпишитесь на Azure.

    Примечание.

    Если у вас еще нет подписки на Azure, вы можете получить ее в рамках своей подписки на Visual Studio или зарегистрировать бесплатную учетную запись.

Шаг 1. Создание общей папки для размещения XML-файла манифеста надстройки

  1. Откройте проводник на своем компьютере разработчика.

  2. Щелкните диск C: правой кнопкой мыши и выберите пункты Создать>Папку.

  3. Назовите новую папку AddinManifests.

  4. Щелкните папку AddinManifests правой кнопкой мыши и выберите пункты Общий доступ>Конкретные пользователи....

  5. В окне Общий доступ к файлам щелкните стрелку раскрывающегося списка и выберите Все>Добавить>Общий доступ.

Примечание.

В этом руководстве для хранения XML-файла манифеста надстройки используется общая локальная папка. Для решения практических задач вы можете развернуть XML-файл манифеста в каталоге SharePoint или опубликовать надстройку в AppSource.

Шаг 2. Добавление общей папки в доверенный каталог надстроек

  1. Запустите Word и создайте документ.

    Примечание.

    В этом примере используется Word, но вы можете использовать любое приложение Office, поддерживающее надстройки Office, например Excel, Outlook, PowerPoint или Project.

  2. Щелкните Файл>Параметры.

  3. В диалоговом окне Параметры Word щелкните Центр управления безопасностью, а затем — Параметры центра управления безопасностью.

  4. В диалоговом окне Trust Center выберите Доверенные каталоги надстроек. Введите UNC-путь к общей папке, которую вы создали ранее, в качестве URL-адреса каталога (например, \\YourMachineName\AddinManifests), а затем выберите Добавить каталог.

  5. Установите флажок Показывать в меню.

    Примечание.

    При хранении XML-файла манифеста надстройки в общей папке, указанной в качестве доверенного каталога веб-надстроек, надстройка отображается в разделе Общая папка в диалоговом окне Надстройки Office , которое запускается из домашней>надстройки>Получение надстроек.

  6. Закройте Word.

Шаг 3. Создание веб-приложения в Azure с помощью портала Azure

Чтобы создать веб-приложение с помощью портала Azure, выполните указанные ниже действия.

  1. Войдите в систему на портале Azure, используя свои учетные данные Azure.

  2. В разделеСлужбы Azure выберите Веб-приложения.

  3. На странице Служба приложений выберите Добавить. Чтобы добавить эти сведения, выполните указанные ниже действия.

    • Выберите подписку, которую необходимо использовать для создания сайта.

    • Выберите группу ресурсов для своего сайта. Если вы создадите группу, вам потребуется присвоить ей имя.

    • Введите уникальное имя приложения для своего сайта. Azure проверит уникальность имени сайта в домене azureweb apps.net.

    • Укажите, следует ли выполнить публикацию с помощью кода или контейнера Docker.

    • Укажите Стек среды выполнения.

    • Выберите операционную систему для своего сайта.

    • Выберите Регион.

    • Выберите план службы приложений, который необходимо использовать для создания этого сайта.

    • Нажмите кнопку Создать.

  4. На следующей странице вы узнаете о том, как выполняется развертывание и когда оно завершится. После завершения развертывания выберите пункт Перейти к ресурсу.

  5. В разделе Обзор выберите URL-адрес, который отображается в пункте URL. Откроется браузер, и в нем отобразится веб-страница с сообщением "Ваша служба приложений готова к работе".

    Важно!

    Использовать конечную точку HTTPS для надстройки не обязательно, но настоятельно рекомендуется. Надстройки без SSL-защиты (HTTPS) выдают предупреждения о небезопасном контенте и ошибки во время использования. Если вы планируете запустить надстройку в Office в Интернете или опубликовать ее в AppSource, она должна быть защищена SSL. Если надстройка получает данные из внешнего источника, она должна использовать SSL-соединение для защиты данных при передаче. Самозаверяющие сертификаты можно использовать для разработки и тестирования, если они добавлены в список доверенных сертификатов на локальном компьютере. Веб-сайты Azure автоматически предоставляют конечную точку HTTPS.

Шаг 4. Создание надстройки Office в Visual Studio

  1. Запустите Visual Studio от имени администратора.

  2. Выберите Создание нового проекта.

  3. Используя поле поиска, введите надстройка.

  4. Выберите пункт Веб-надстройка Word в качестве типа проекта, а затем нажмите кнопку Далее, чтобы принять параметры, используемые по умолчанию.

Visual Studio создаст базовую надстройку Word, которую вы можете опубликовать в том виде, в котором она есть, не внося изменений в ее веб-проект. Чтобы создать надстройку для другого приложения Office, например Excel, повторите шаги и выберите тип проекта с нужным приложением Office.

Действие 5. Публикация веб-приложения надстройки Office в Azure

  1. Не закрывая проект вашей надстройки в Visual Studio, разверните узел решения в Обозревателе решений, затем выберите Служба приложений.

  2. Щелкните правой кнопкой мыши веб-проект и выберите пункт Опубликовать. Веб-проект содержит файлы веб-приложения надстройки Office, так что это именно тот проект, который вы публикуете в Azure.

  3. На вкладке Публикация выполните указанные ниже действия.

    • Выберите пункт Служба приложений Microsoft Azure.

    • Щелкните Выбрать существующую.

    • Щелкните Опубликовать.

  4. Visual Studio опубликует веб-проект надстройки Office в вашем веб-приложении Azure. Когда Visual Studio завершит публикацию веб-проекта, откроется браузер и отобразится веб-страница с текстом "Приложение Служба приложений создано". Это текущая страница по умолчанию для веб-приложения.

  5. Скопируйте корневой URL-адрес (например, https://YourDomain.azurewebsites.net); он понадобится при изменении файла манифеста надстройки далее в этой статье.

Шаг 6. Редактирование и развертывание XML-файла манифеста надстройки

  1. В Visual Studio (с примером надстройки Office, открытом в обозревателе решений) разверните решение так, чтобы отображались оба проекта.

  2. Разверните проект надстройки Office (например, WordWebAddIn), щелкните правой кнопкой мыши папку манифеста, а затем нажмите кнопку Открыть. Откроется XML-файл манифеста надстройки.

  3. В XML-файле манифеста найдите и замените все фрагменты ~remoteAppUrl URL-адресом корня веб-приложения надстройки в Azure. Это URL-адрес, скопированный ранее после публикации веб-приложения надстройки в Azure (например, https://YourDomain.azurewebsites.net).

  4. Щелкните Файл и выберите пункт Сохранить все. Затем скопируйте XML-файл манифеста надстройки (например, WordWebAddIn.xml).

  5. С помощью программы Проводник откройте сетевой файловый ресурс, который вы создали в действии 1 "Создание общей папки" и вставьте файл манифеста в папку.

Шаг 7. Вставка и запуск надстройки в клиентском приложении Office

  1. Запустите Word и создайте документ.

  2. Выберите Главная>надстройки, а затем выберите Получить надстройки.

  3. В диалоговом окне Надстройки Office выберите ОБЩАЯ ПАПКА. Word выполнит сканирование папки, которую вы указали в качестве надежного каталога надстроек (в действии 2 "Добавление файлового ресурса в надежный каталог надстроек") и отобразит надстройки в диалоговом окне. Должен отобразиться значок для вашего примера надстройки.

  4. Щелкните значок своей надстройки и нажмите кнопку Добавить. На ленту будет добавлена кнопка Показать область задач для вашей надстройки.

  5. На ленте вкладки Главная нажмите кнопку Показать область задач. Надстройка откроется в области задач справа от текущего документа.

  6. Убедитесь, что надстройка работает, выбрав любой текст в документе и нажав кнопку Highlight! (Выделить!) в области задач.

Развертывание обновлений

При добавлении компонентов или исправлении ошибок в надстройке необходимо развернуть обновления. Если надстройка развертывается одним или несколькими администраторами в своих организациях, некоторые изменения манифеста требуют согласия администратора на обновления. Пользователи будут заблокированы в надстройке, пока не будет предоставлено согласие. Для следующих изменений манифеста потребуется повторное согласие администратора.

Примечание.

Каждый раз, когда вы вносите изменения в манифест, необходимо повысить номер версии манифеста.

См. также