My Tasks Введение
Многие сотрудники проводят большую часть дня в Microsoft Teams, а не на интрасайте. Vitextra My Tasks поставляется как приложение для Teams, поэтому личный список задач (Planner, To Do, письма с флажком, задачи SharePoint и Project, рабочие элементы Azure DevOps) можно разместить там, где люди уже работают: в виде личного приложения на боковой панели Teams или вкладки в канале команды. Список, фильтры, быстрые фильтры по сроку, панель сведений о задаче и экспорт работают так же, как на странице SharePoint.
В этой статье описаны необходимые шаги: как сделать приложение доступным в Teams, как добавить его в виде личного приложения или вкладки канала и как проверить, что задачи загружаются. Предполагается, что пакет My Tasks уже развёрнут в каталоге приложений вашего клиента.
❗ Важно
My Tasks в Teams — это то же решение SharePoint Framework, которое работает на страницах SharePoint. Чтобы приложением можно было пользоваться в Teams, нужно выполнить три условия: (1) приложение SharePoint (vitextra.my-tasks.sppkg) установлено в каталоге приложений клиента; (2) оно синхронизировано с Teams либо загружен его пакет приложения Teams; (3) администратор клиента утвердил запрошенные пакетом разрешения API в Центре администрирования SharePoint (Дополнительно > Доступ к API, в англоязычном интерфейсе — Advanced > API access). Без этого утверждения источники, которым нужен Microsoft Graph (Planner, To Do, Outlook) или Azure DevOps, не возвращают задачи. Перечень разрешений приведён в статье KB10303. My Tasks: разрешения, конфиденциальность и безопасность.
💡 Совет
Если продукт ещё не установлен, сначала прочитайте статьи KB10035. Как установить продукт Vitextra в SharePoint Online и KB10289. Как добавить и настроить веб-часть My Tasks, а потом вернитесь к этой статье.
Предварительные требования
- Чтобы синхронизировать приложение с Teams, нужно управлять каталогом приложений SharePoint. Как правило, для этого требуется роль Администратор SharePoint.
- Чтобы утвердить разрешения API, нужно быть администратором клиента, который может открыть Дополнительно > Доступ к API в Центре администрирования SharePoint.
- Чтобы добавить уже синхронизированное приложение как личное, специальные права не нужны: любой пользователь может сделать это в магазине приложений Teams, если администратор Teams разрешил приложения, созданные для вашей организации.
- Чтобы добавить приложение как вкладку канала, нужно быть участником команды (владельцы команды могут ограничивать круг лиц, которым разрешено добавлять вкладки).
Как сделать приложение доступным в Teams
- Откройте Центр администрирования Microsoft 365 и перейдите в раздел SharePoint в группе Центры администрирования.
- В Центре администрирования SharePoint выберите Другие возможности, затем в разделе Приложения нажмите Открыть и перейдите в Каталог приложений > Приложения для SharePoint.
- Выберите в списке пакет Vitextra My Tasks, откройте вкладку ФАЙЛЫ на ленте и нажмите Синхронизировать с Teams.
Уведомление Successfully synced teams solution подтверждает, что пакет приложения Teams опубликован в магазине приложений вашей организации. Приложение Teams связано с пакетом SharePoint, поэтому обновления, установленные в каталоге приложений, применяются и в Teams; см. KB10050. Как обновить решение Vitextra на SPFx в SharePoint Online.
📝 Примечание
Кроме того, администратор Teams может загрузить пакет приложения Teams вручную в Центре администрирования Teams: Приложения Teams > Управление приложениями > Отправить новое приложение. Пакет — это файл TeamsSPFxApp.zip, который входит в комплект продукта. Проще и надёжнее использовать кнопку Синхронизировать с Teams, поэтому мы рекомендуем этот способ.
Добавление My Tasks как личного приложения
- В Microsoft Teams нажмите Приложения на левой боковой панели.
- В списке категорий выберите Создано для вашей организации. Здесь отображаются приложения, синхронизированные из вашего каталога приложений.
- Найдите плитку My Tasks, опубликованную Vitextra, и нажмите её.
- На странице сведений нажмите Добавить (а не Добавить в команду).
Приложение появится на левой боковой панели. Откройте его, и вы увидите список задач. Личное приложение доступно в классическом клиенте Teams и в мобильных приложениях Teams.
💡 Совет
При таком способе приложение закрепляется только у того, кто нажал Добавить. Чтобы My Tasks появилось на боковой панели у всех, администратор Teams может закрепить его для всего клиента с помощью политики настройки приложений в Центре администрирования Teams.
Добавление My Tasks как вкладки канала
- Откройте команду и канал, в котором должен находиться список, и нажмите + на панели вкладок вверху.
- Найдите My Tasks в списке приложений (при необходимости воспользуйтесь строкой поиска) и выберите его.
- В диалоговом окне нажмите Добавить (или Сохранить). Вкладка откроется вместе с областью свойств веб-части.
- В группе Источник данных выберите источники, например Планировщик, To Do или Azure DevOps (с названием организации в поле Организация), задайте остальные параметры и закройте область свойств. Параметры такие же, как на странице SharePoint, и описаны в статье KB10289. Как добавить и настроить веб-часть My Tasks.
У вкладки собственные настройки, которые не зависят от личного приложения и других каналов. Позже владелец команды может изменить их, выбрав пункт Параметры в меню вкладки.
📝 Примечание
My Tasks — это личное представление. Каждый участник, который открывает вкладку, видит только свои задачи, загруженные в его собственном контексте, а не задачи команды. У участников общие только настройки вкладки (включённые источники, столбцы и число строк), но не данные. Фильтры и сортировка, которые выбрал пользователь, запоминаются в его браузере и не передаются другим участникам.
Если задачи не загружаются в Teams
Сначала проверьте следующее:
- Доступ к API. Администратор клиента утвердил разрешения пакета в Центре администрирования SharePoint. Для Planner, To Do и Outlook нужны разрешения Microsoft Graph, а для Azure DevOps — отдельное разрешение.
- Источники. В области свойств вкладки включён хотя бы один источник, а название организации Azure DevOps в поле Организация введено точно.
- Фильтры. Значок Фильтровать не закрашен, а в меню Срок выбрано Все даты.
- Лицензия. Пробный период не истёк. Если он истёк, вместо списка веб-часть показывает сообщение.
Источник, который не удалось загрузить, пропускается без сообщений, а остальные источники по-прежнему отображаются. Полный перечень проверок приведён в статье KB10307. Почему в My Tasks не отображаются или не загружаются задачи.
Темы и мобильные устройства
My Tasks берёт цвета из темы приложения, в котором работает, поэтому следует светлой и тёмной темам Teams. Макет адаптивный, поэтому список остаётся удобным и в узкой вкладке канала, и на телефоне. О темах, шрифтах и языках читайте в статье KB10302. My Tasks: темы, шрифты и поддержка языков.
💡 Совет
Чтобы просто познакомиться со списком в Teams, добавьте приложение как личное. Если команде нужен готовый набор источников, например Azure DevOps для команды разработки, создайте вкладку канала и один раз настройте её. Краткое руководство для пользователей: KB10291. My Tasks: краткое руководство для пользователей.
