Краткое руководство. Создание первого приложения с помощью VS Code

Применимо к: Разработчик

Используйте расширение SharePoint Embedded Visual Studio Code, чтобы создать стандартный тип контейнера для первого приложения. Расширение также настраивает собственное приложение, присоединяет Azure выставления счетов и регистрирует тип контейнера. Затем вы создадите контейнер и запустите локальный пример приложения.

В этой статье начинается процесс сборки. Дополнительные рекомендации по выставлению счетов см. в статье Создание и настройка типа контейнера.

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

Перед началом работы убедитесь, что у вас есть:

• Visual Studio Code установлено.
• Административный доступ к клиенту Microsoft 365.
• Клиент с доступной службой SharePoint.
• Подписка Azure и группа ресурсов, к которым может получить доступ ваша учетная запись.
• Разрешения владельца или участника для подписки Azure.
• Node.js и npm, установленные для примера приложения.
• Разрешение на предоставление согласия администратора в Microsoft Entra ID.

Важно!

Вам нужен административный доступ к клиенту Microsoft 365. Если у вас нет клиента, используйте Программу разработчика Microsoft 365, Microsoft Customer Digital Experience или пробную версию Microsoft 365 E3.

Установка расширения

1. Откройте Visual Studio Code.
2. Откройте расширения на панели действий.
3. Выполните поиск по запросу SharePoint Embedded.
4. Нажмите кнопку Установить.
5. Если расширение уже установлено, обновите его.
6. Щелкните значок SharePoint Embedded на панели действий.

Вход

1. В представлении SharePoint Embedded выберите действие входа.
2. Используйте учетную запись администратора Microsoft 365.
3. Выполните проверку подлинности в браузере.
4. Проверьте запрошенные разрешения.
5. Выберите Принять , чтобы предоставить согласие администратора.
6. Вернитесь к Visual Studio Code при перенаправлении.

Важно!

Внимательно просмотрите запрос на согласие. Расширению требуются разрешения клиента для настройки ресурсов разработки.

После входа в расширение отображается домашнее представление SharePoint Embedded.

Создание стандартного типа контейнера

Тип контейнера определяет связь, привилегии доступа, отчетность по выставлению счетов и выбранное поведение для набора контейнеров SharePoint Embedded.

1. Выберите Создать тип контейнера.
2. Для метода выставления счетов выберите стандартный.
3. Введите имя типа контейнера.
4. Следуйте инструкциям, пока не завершится создание.

Используйте стандартный тип контейнера, если организация, владеющая приложением, оплачивает использование SharePoint Embedded. Для оценки выберите пробную версию. Для выставления счетов клиент-клиент выберите параметр сквозной передачи, который использует классификацию выставления directToCustomer счетов.

Создание или выбор приложения-владельцев

Каждый тип контейнера имеет одно собственное Microsoft Entra ID приложение.

1. Создайте приложение Microsoft Entra ID или выберите идентификатор существующего приложения.
2. Если вы создаете новое приложение, введите его имя.
3. Разрешите расширению настроить параметры разработки.

Предостережение

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

Сведения о модели см. в статье Архитектура приложения SharePoint Embedded.

Настройка стандартного выставления счетов

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

1. Выберите подписку Azure.
2. Выберите группу ресурсов.
3. Дождитесь, пока расширение зарегистрирует поставщик ресурсов Microsoft.Syntex , и подключите выставление счетов.

Если вы пропустили настройку выставления счетов или у вас нет необходимых Azure разрешений, в дереве отображается значение Выставление счетов не настроено. Чтобы завершить настройку позже, щелкните правой кнопкой мыши тип контейнера. Затем выберите Вложить выставление счетов.

Локальная регистрация типа контейнера

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

1. После создания следуйте инструкциям, чтобы зарегистрировать тип контейнера в локальном клиенте.
2. Если запрос не отображается, щелкните правой кнопкой мыши тип контейнера и выберите Зарегистрировать.
3. Проверьте разрешения.
4. Предоставьте согласие администратора в браузере.
5. Вернитесь к Visual Studio Code.

Регистрация настраивает разрешения, которые приложение-владельце может использовать для контейнеров типа контейнера.

Создание первого контейнера

1. В дереве SharePoint Embedded разверните тип контейнера.
2. Щелкните правой кнопкой мыши Контейнеры.
3. Выберите Создать контейнер.
4. Введите имя контейнера.
5. Убедитесь, что контейнер отображается в дереве.

Контейнер — это базовая единица хранения и граница безопасности в SharePoint Embedded.

Загрузка примера приложения

1. В представлении SharePoint Embedded выберите Загрузить пример приложения.
2. Выберите пример SharePoint Embedded.

1. Просмотрите предупреждение о локальных секретах обычного текста.
2. При появлении запроса на создание секрета клиента нажмите кнопку ОК для локальной разработки.
3. Позвольте расширению заполнить файл конфигурации среды выполнения.

Важно!

Пример конфигурации предназначен только для разработки. Секреты проверки подлинности хранятся на локальном компьютере в виде обычного текста.

Запуск примера приложения

Откройте терминал и запустите пример приложения из созданного каталога примера.

cd [your-path]\SharePoint-Embedded-Samples\Custom Apps\boilerplate-typescript-react
npm run start

Начинается пример:

• Клиентское приложение React.
• Сервер приложений Функции Azure.

Дождитесь появления обоих выходных данных консоли.

Затем:

1. Откройте .http://localhost:8080
2. Войдите с той же учетной записью администратора Microsoft 365.
3. Выберите Контейнеры на домашней странице.
4. Создание контейнеров и отправка файлов из примера пользовательского интерфейса.

Примечание.

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

Устранение неполадок при запуске

Признак	Проверка
Конфликт портов	Приложение пытается использовать следующий доступный порт, когда используется порт 8080.
Сбой зависимостей	Запустите npm install, а затем запустите npm run start еще раз.
Ошибка проверки подлинности	Убедитесь, что приложение Microsoft Entra ID имеет ожидаемые URI перенаправления.
Отказано в доступе	Убедитесь, что регистрация и согласие администратора успешно выполнены.
Выставление счетов не настроено	Убедитесь, что у вас есть разрешения владельца или участника для выбранной подписки Azure, а затем используйте команду Присоединить выставление счетов.

Очистка

По завершении тестирования:

1. Удалите ненужные тестовые контейнеры.
2. Ознакомьтесь с Azure ресурсами выставления счетов, созданными для этого краткого руководства.
3. Удалите локальные примеры секретов, которые больше не нужны.

Дальнейшие действия

Дополнительные сведения о параметрах типа контейнера см. в статье Создание и настройка типа контейнера.