Создание надстройки Office в Microsoft Azure с помощью Visual Studio

  • Статья

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

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

Важно!

Процесс, описанный в этой статье, не применяется к надстройкам Outlook. Инструкции по промежуточному созданию надстроек для Outlook в Azure см. в статье Размещение надстройки Outlook в Microsoft Azure с помощью Visual Studio.

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

  1. Установите Visual Studio 2022 и включите рабочую нагрузку разработки Azure .

    Примечание.

    Если вы ранее установили Visual Studio 2022, используйте Visual Studio Installer, чтобы убедиться, что установлена рабочая нагрузка разработки Azure.

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

    Примечание.

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

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

    Примечание.

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

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

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

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

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

  4. Щелкните правой кнопкой мыши (или выберите и удерживайте) папку AddinManifests и выберите пункт Поделиться с>определенными людьми.

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

Примечание.

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

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

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

    Примечание.

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

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

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

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

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

    Примечание.

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

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

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

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

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

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

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

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

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

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

  2. Следуйте инструкциям в разделе Публикация веб-приложения. Пропустите разделы статей, предшествующие публикации веб-приложения, но убедитесь, что в верхней части страницы выбрана кнопка Visual Studio .

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

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

Шаг 5. Изменение и развертывание файла манифеста надстройки

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также