Действия сборки в Microsoft 365
Примечание.
Действия доступны в общедоступной предварительной версии для разработчиков.
При создании приложения убедитесь, что вы определяете намерение пользователя, определяете объект для выполнения действия и создаете соответствующий обработчик, который упрощает выполнение задач для пользователя.
Чтобы создать действия для приложения, выполните следующие действия.
- Предварительные требования.
- Настройка манифеста приложения.
- Получение сведений о действии через объект контекста.
- Доступ к содержимому через API Graph.
Предварительные условия
Прежде чем приступить к работе, установите следующие средства:
| Установка | Для использования... | |
|---|---|---|
| Node.js | Среда выполнения JavaScript. Дополнительные сведения см . вNode.js таблице совместимости версий для типа проекта. | |
| Microsoft Edge (рекомендуется) или Google Chrome | Браузера со средствами разработчика. | |
| Visual Studio Code; | Visual Studio Code — это упрощенный, но мощный редактор исходного кода, который поставляется со встроенной поддержкой сред сборки JavaScript, TypeScript, Node.js и SharePoint Framework (SPFx). Используйте последнюю версию. | |
| Набор средств Teams | Расширение Microsoft Visual Studio Code, которое создает шаблон проекта для вашего приложения. Используйте последнюю версию. |
Настройка манифеста приложения
Добавьте свойство и определите actions намерение, объект и обработчик для действий в манифесте приложения (ранее — манифест приложения Teams).
Ниже приведен пример манифеста приложения для действий, которые можно активировать в таких файлах, как Excel, Word, PDF или PowerPoint.
{
"$schema": "https://developer.microsoft.com/json-schemas/teams/vDevPreview/MicrosoftTeams.schema.json",
"manifestVersion": "devPreview",
"actions": [
{
"id": "relatedTasks",
"displayName": "Related tasks",
"intent": "custom",
"description": "Shows tasks in the To do app that are related to this file.",
"handlers": [
{
"type": "openPage",
"supportedObjects": {
"file": {
"extensions": ["xlsx", "doc", "docx", "pdf", "pptx", "ppt"]
}
},
"pageInfo": {
"pageId": "index",
}
}
]
}
]
}
Дополнительные сведения см. в статье Схема манифеста общедоступной предварительной версии приложения для разработчиков.
Когда пользователь выбирает действие для открытия личной вкладки и просмотра связанных задач в приложении на основе выбранного файла. Приложение использует свойство для идентификации "intent": "custom" типа файла, например .xlsx или doc, и "type": "openPage" обработчик открывает приложение и переходит к pageId.
Получение сведений о действии через объект контекста
Создайте обработчик для получения сведений о действии через объект контекста, чтобы создать простой пользовательский интерфейс для выполнения конкретных задач пользователей с помощью библиотеки JavaScript Teams (TeamsJS).
Когда пользователь выбирает параметр Добавить в контекстном меню приложения, откроется личная вкладка openPage с помощью свойства в манифесте приложения. Ваше приложение может получить доступ к контекстной информации о вызываемом действии actionInfo из свойства объекта контекста app.getContext() .
Интерфейс ActionInfo позволяет приложению определять, когда пользователь открывает вкладку из действия и содержимое, которое инициировало действие.
app.getContext().then((context) => {
const actionInfo = context.actionInfo;
if (actionInfo) {
// App was launched using an action
}
if (actionInfo && actionInfo.actionId == 'myActionId1') {
// Handle specific action
}
if (actionInfo) {
if (actionInfo.actionObject.type == app.ActionObjectType.M365Content) {
const itemId = actionInfo.actionObjects[0].itemId;
// Get the requested content from Mirosoft Graph by item id:
}
}
})
| Имя | Описание | |
|---|---|---|
actionObjects |
Массив соответствующих объектов действий. | |
itemId |
Приложение получает идентификатор в качестве содержимого и использует его для запроса Microsoft Graph. | |
actionInfo |
Объект контекста содержит объект, содержащий все сведения, связанные с текущим действием. |
Доступ к содержимому через API Graph
После получения itemId актививного содержимого можно использовать API Graph для чтения или изменения содержимого, что облегчает выполнение задач для пользователей.
HTTP-запрос
GET /users/{user-id}/drive/items/{item-id}
Загрузка неопубликованного приложения с помощью набора средств Teams
Обновив пакет приложения необходимыми сведениями, вы можете протестировать действия в наборе средств Teams. Чтобы начать отладку, выберите клавишу F5 .
Откроется окно браузера с домашней страницей Microsoft 365, а ваше приложение будет доступно в разделе Приложения.
Теперь вы можете просмотреть действия на домашней странице Microsoft 365, щелкнув правой кнопкой мыши файл, поддерживаемый вашими действиями. В контекстном меню отображаются действия, например Добавить задачу todo.
Примечание.
Приложение Microsoft 365 (Office) переименовано в приложение Microsoft 365 Copilot. Значок приложения также меняется: с 
на 
. Обновления к пользовательскому интерфейсу приложения и значку находятся в процессе развертывания.
Предустановка действий для пользователей в центре Microsoft 365 Admin
Примечание.
Действия доступны в общедоступной предварительной версии для разработчиков. Убедитесь, что вы включили целевой выпуск для пользователей, чтобы они могли работать с действиями в приложении Microsoft 365.
Чтобы использовать приложение с действиями в клиенте, администратор должен отправить пакет приложения с манифестом devPreview в Центр Администратор Майкрософт следующим образом:
Перейдите в Центр Администратор Майкрософт.
Выберите Параметры Интегрированные>приложения>Отправка пользовательских приложений.
Следуйте инструкциям, чтобы предварительно установить приложение для всей организации или групп пользователей в клиенте.
Пример кода
| Название примера | Описание | Node.js |
|---|---|---|
| Действия в приложениях Microsoft 365 | В этом примере кода описываются действия, реализованные в приложениях Microsoft 365. В частности, основное внимание уделяется двум действиям в приложении To Do. | Просмотр |
Следующий этап
Platform Docs