Управление задачами на основе приложений в Планировщик для специализированных задач

Статья
12/18/2024
Применяется к:

Microsoft Teams

Примечание.

Сейчас эта функция доступна в общедоступной предварительной версии.

Обзор

Функция задач на основе приложений обеспечивает организации больший контроль над тем, что пользователи видят при открытии задач в приложении Планировщик в Microsoft Teams. Вместо отображения только стандартного набора полей задач можно предоставить пользователям возможности, адаптированные к задаче. Это может быть набор полей для конкретного рабочего процесса или пошаговые инструкции, которые помогут пользователю выполнить рабочий процесс от начала до конца. Для этого необходимо интегрировать приложение Teams с задачей и создать эти задачи программным способом.

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

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

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

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

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

Требования

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

Каждая задача на основе приложения указывает на интерфейс в целевом приложении Teams, для которого требуется указать URL-адрес ссылки на этот интерфейс. Рекомендуется указать этот URL-адрес ссылки на конкретный элемент или экран, над которым должен работать пользователь. Этот URL-адрес ссылки должен быть добавлен в задачу определенным образом. Дополнительные сведения см. в разделе Шаг 1. Настройка URL-адреса ссылки этой статьи.
Задачи необходимо создавать и обновлять с помощью API бизнес-сценариев в Microsoft Graph.
Пользователи, которым необходимо работать с задачей, должны иметь доступ к целевому приложению в Teams в соответствии с политиками приложений, заданными в Центре администрирования Teams. Дополнительные сведения см. в статье Обзор управления приложениями и управления в Центре администрирования Teams.
Целевое приложение Teams отвечает за управление жизненным циклом задачи, который включает в себя следующие действия:
- Создайте задачу. См . статью Создание бизнесаСценариоТаск.
- Назначьте задачу. См . раздел Обновление бизнесаСценариоТаск.
- Обновите задачу, если свойства изменяются. См . раздел Обновление бизнесаСценариоТаск.
- Пометьте задачу как завершенную, когда все шаги будут выполнены. См . раздел Обновление бизнесаСценариоТаск.
- Удалите задачу. См . раздел Удаление бизнесаСценариоТаск.

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

Создание задачи на основе приложения

В этом разделе описывается использование API Create businessScenarioTask для создания задачи на основе приложения.

Используйте следующий HTTP-запрос POST. Вот как выглядит запрос с заполнителями для указанных свойств.

Запрос

POST https://graph.microsoft.com/beta/solutions/businessScenarios/{your-business-scenario-ID}/planner/tasks 

{ 
"title": "{Task title}", 
    "target": { 
        "@odata.type": "#microsoft.graph.businessScenarioGroupTarget", 
        "taskTargetKind": "group", 
        "groupId": "{group ID of the team where you want to create the task}" 
    }, 
    "businessScenarioProperties": { 
        "externalObjectId": "{any unique ID, for example, the ID of the object in your destination app}", 
        "externalBucketId": "{any bucket ID from planConfiguration of your business scenario}" 
    }, 
    "assignments": { 
        "{user ID of user you want to assign the task to}": { 
            "@odata.type": "#microsoft.graph.plannerAssignment", 
            "orderHint": " !" 
        } 
    }, 
    "details": { 
        "references": { 
            "{reference URL}": { 
                "@odata.type": "microsoft.graph.plannerExternalReference", 
                "alias": "{destination app name}", 
                "previewPriority": " !", 
                "type": "TeamsHostedApp" 
            } 
       } 
    } 
}

В следующих разделах описано, как сформировать запрос более подробно.

Определение свойств в запросе

Определенный тип вложения отличает задачу на основе приложения от стандартной. Вложение должно иметь тип TeamsHostedApp и содержать специально отформатированную ссылку (URL-адрес ссылки) на интерфейс назначения в приложении Teams. Это означает, что Планировщик задача является задачей на основе приложения.

Помните, что API ссылается на эти вложения как на ссылки.

Сначала необходимо настроить URL-адрес ссылки, чтобы он указывал на конечный интерфейс. Затем укажите URL-адрес ссылки вместе с другими обязательными свойствами для вложения в тексте запроса.

Шаг 1. Настройка URL-адреса ссылки

URL-адрес ссылки использует определенный формат. Выполните следующие действия, чтобы создать и закодировать URL-адрес.

Шаг 1a. Создание URL-адреса

URL-адрес ссылки на интерфейс назначения должен использовать синтаксис модальной ссылки Stageview в следующем формате:

https://teams.microsoft.com/l/stage/{Teams-app-Id}/0?context={"contentUrl":"URL-to-destination-experience"},"name":"{page-title}","openMode":"modal"}

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

Параметр	Описание
`Teams-app-Id`	Идентификатор приложения Teams, которое вы интегрируете с задачей.
`URL-to-destination-experience`	URL-адрес, указывающий на целевой интерфейс в целевом приложении Teams, который пользователи должны видеть при открытии задачи. По соображениям безопасности URL-адрес должен указывать на допустимый домен, связанный с приложением Teams, который представлен предоставленным вами идентификатором приложения.
`page-title`	Заголовок, который должен отображаться в верхней части экрана, когда пользователю отображается URL-адрес целевого интерфейса.

Ниже приведен пример URL-адреса ссылки перед кодировкой:

https://teams.microsoft.com/l/stage/com.microsoft.teamspace.tab.youtube/0?context={"contentUrl":"https://tabs.teams.microsoft.com/youtubeContentStage?videoId=HBGmSy1iVmY","name":"Security%20talk","openMode":"modal"}

В этом примере:

Teams-app-Id — это идентификатор приложения YouTube в Teams (com.microsoft.teamspace.tab.youtube). Помните, что большинство идентификаторов приложений Teams являются буквенно-цифровыми и могут выглядеть по-разному.
URL-to-destination-experience указывает на интерфейс в целевом приложении Teams (https://tabs.teams.microsoft.com/youtubeContentStage?videoId=HBGmSy1iVmY).
page-title — это имя заголовка экрана (Security talk) при загрузке URL-адреса.

Если приложение YouTube в Teams доступно для вас, вы можете отправить этот URL-адрес себе и подтвердить его открытие.

Шаг 1b. Кодирование URL-адреса

Необходимо закодировать URL-адрес ссылки, прежде чем использовать его во вложении. Кодирование в процентах гарантирует, что ссылка имеет совместимый формат для программного использования.

Выполните следующие действия, чтобы закодировать URL-адрес ссылки. Мы используем пример url-адреса ссылки, описанный выше, чтобы продемонстрировать, как кодировать URL-адрес.

Процент кодирует часть URL-адреса, которая поступает после 0?context=. Не кодируйте https:// или = (символ равенства) или любые символы между ними.

https://teams.microsoft.com/l/stage/com.microsoft.teamspace.tab.youtube/0?context=%7B%22contentUrl%22%3A%22https%3A%2F%2Ftabs.teams.microsoft.com%2FyoutubeContentStage%3FvideoId%3DHBGmSy1iVmY%22%2C%22name%22%3A%22Security%2520talk%22%2C%22openMode%22%3A%22modal%22%7D

Кончик

Это последний шаг, на котором можно легко проверить ссылку в чате Teams. После выполнения этого шага вы можете протестировать URL-адрес, отправив его себе в чате Teams. Ссылка должна открываться на компьютере, в Интернете или на мобильных устройствах Teams для любого пользователя, имеющего доступ к целевому приложению в Teams.
Замените все. символы в URL-адресе %2Eссылки на . Это необходимо сделать для всех символов в URL-адресе ссылки от начала до конца. Если пропустить этот шаг, URL-адрес ссылки может не работать.

Следующий URL-адрес готов к использованию программными средствами.

https://teams%2Emicrosoft%2Ecom/l/stage/com%2Emicrosoft%2Eteamspace%2Etab%2Eyoutube/0?context=%7B%22contentUrl%22%3A%22https%3A%2F%2Ftabs%2Eteams%2Emicrosoft%2Ecom%2FyoutubeContentStage%3FvideoId%3DHBGmSy1iVmY%22%2C%22name%22%3A%22Security%2520talk%22%2C%22openMode%22%3A%22modal%22%7D

Примечание.

Если URL-адрес указывает на Приложение Power App, убедитесь, что он содержит &source=teamstab параметр для обеспечения работы единого входа (SSO) для Power Apps и &skipMobileRedirect=1 параметр пропуска экрана, предлагающего пользователям открыть автономный проигрыватель Power App.

Шаг 2. Определение вложения

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

        "references": { 
            "{reference-URL}": { 
            "@odata.type": "microsoft.graph.plannerExternalReference", 
            "alias": "{destination app name}", 
            "previewPriority": " !", 
            "type": "TeamsHostedApp" 
         } 
       }

Свойство	Описание
`reference-URL`	URL-адрес целевого интерфейса в синтаксисе модальной ссылки Stageview. Дополнительные сведения о создании и кодировании URL-адреса см. в разделе Шаг 1. Настройка эталонного URL-адреса этой статьи.
`alias`	Имя приложения Teams. Когда пользователь открывает задачу, он видит сообщение"Завершить задачу с <псевдонимом> и кнопкой "Запустить задачу ", чтобы перейти к целевому интерфейсу.
`previewPriority`	Оставьте значение `!`.
`type`	Задайте значение `TeamsHostedApp`. Это означает, что Планировщик задача является задачей на основе приложений.

Пример

В этом примере показано, как создать задачу на основе приложения с именем "Проверка презентации методов безопасности" и назначить ее пользователю С именем Adele Vance (идентификатор пользователя 44ee44ee-ff55-aa66-bb77-88cc8cc88cc8cc). В этом запросе используется пример URL-адреса ссылки из раздела Шаг 1. Настройка URL-адреса ссылки этой статьи.

Запрос

POST https://graph.microsoft.com/beta/solutions/businessScenarios/ccd5aa8aebd048bd839a4fa5b7420631/planner/tasks

{
"title": "Review security practices presentation",
    "target": {
        "@odata.type": "#microsoft.graph.businessScenarioGroupTarget",
        "taskTargetKind": "group",
        "groupId": "769bbf41-70b7-4ea6-a044-a7037358883e"
    },
    "businessScenarioProperties": {
        "externalObjectId": "SP-202418",
        "externalBucketId": "Security practices"
    },
    "assignments": {
        "44ee44ee-ff55-aa66-bb77-88cc88cc88cc": {
            "@odata.type": "#microsoft.graph.plannerAssignment",
            "orderHint": " !"
        }
    },
    "details": {
        "references": {
            "https://teams%2Emicrosoft%2Ecom/l/stage/com%2Emicrosoft%2Eteamspace%2Etab%2Eyoutube/0?context=%7B%22contentUrl%22%3A%22https%3A%2F%2Ftabs%2Eteams%2Emicrosoft%2Ecom%2FyoutubeContentStage%3FvideoId%3DHBGmSy1iVmY%22%2C%22name%22%3A%22Security%2520talk%22%2C%22openMode%22%3A%22modal%22%7D": {
                "@odata.type": "microsoft.graph.plannerExternalReference",
                "alias": "Security practices presentation",
                "previewPriority": " !",
                "type": "TeamsHostedApp"
             }
        }
    }
}

Примечание.

Этот пример эталонного URL-адреса был выбран в качестве простого способа тестирования работы с задачами на основе приложений с помощью приложения, доступного во многих средах организации. Помните, что с помощью этого примера url-адреса ссылки пользователи не смогут выполнить задачу. Это связано с тем, что приложение YouTube не интегрировано с задачами на основе приложений и не выполняет вызов API, чтобы пометить задачу как завершенную после воспроизведения видео.

Как это выглядит в приложении Планировщик

Вот что видит пользователь, открывая задачу в приложении Планировщик в Teams. При нажатии кнопки Запустить задачу пользователь перейдет к целевому интерфейсу в приложении Teams. В этом примере конечный интерфейс — это видео о рекомендациях по обеспечению безопасности в приложении YouTube в Teams.

Дополнительные сведения о пользовательском интерфейсе см. в статье Работа с задачами на основе приложений в приложении Планировщик в Teams.

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

Управление задачами на основе приложений в Планировщик для специализированных задач

Обзор

Требования

Создание задачи на основе приложения

Определение свойств в запросе

Шаг 1. Настройка URL-адреса ссылки

Шаг 1a. Создание URL-адреса

Шаг 1b. Кодирование URL-адреса

Шаг 2. Определение вложения

Пример

Как это выглядит в приложении Планировщик

Обратная связь

Дополнительные ресурсы

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

Управление задачами на основе приложений в Планировщик для специализированных задач

Обзор

Требования

Создание задачи на основе приложения

Определение свойств в запросе

Шаг 1. Настройка URL-адреса ссылки

Шаг 1a. Создание URL-адреса

Шаг 1b. Кодирование URL-адреса

Шаг 2. Определение вложения

Пример

Как это выглядит в приложении Планировщик

Статьи по теме

Обратная связь

Дополнительные ресурсы