Выбор людей в адаптивных карточках

средство выбора Люди помогает пользователям искать и выбирать пользователей в адаптивной карточке. Вы можете добавить Люди Picker в качестве элемента управления вводом в адаптивную карточку, которая работает в чатах, каналах, диалогах (называемых модулями задач в TeamsJS версии 1.x) и вкладками. Средство выбора Люди поддерживает следующие функции:

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

Популярные сценарии

В следующей таблице приведены популярные сценарии выбора Люди в адаптивных карточках и соответствующие действия.

Сценарии	Действия
Сценарии на основе утверждения	Запрос, назначение и переназначение утверждения предполагаемому пользователю на основе требования.
Управление инцидентами	Отслеживание инцидентов и уведомление, назначение и переназначение предполагаемому пользователю для немедленного действия.
Управление проектами	Назначение билетов или ошибок определенным пользователям.
Поиск пользователей	Поиск пользователей по всей организации.

Компьютер

Веб-клиент и классический клиент поддерживают Люди Средства выбора в адаптивной карточке. При поиске в Интернете Люди Picker включает встроенный интерфейс ввода.

Пример сценария переназначения

Пользователь А (Роберт) получает билет на задачу в канале и понимает, что неправильная назначенная сторона. Пользователь A переназначает задачу, которая отправляет информацию боту.

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

1. Выберите Переназначить , где поле выбора людей предварительно заполнено именем, чтобы переназначить задачу предполагаемому пользователю.
2. Удалите неправильное имя пользователя.
3. Выберите предполагаемых пользователей в сценарии изображения, пользователя B (Mona) и пользователя C (Robin) для задачи.
4. Нажмите Назначить. После назначения данные отправляются боту. Бот обновляет адаптивную карточку и уведомляет предполагаемых пользователей.

На следующем рисунке показан сценарий переназначения:

Мобильные устройства

Мобильные клиенты Android и iOS поддерживают Люди Средства выбора в адаптивных карточках. Вы можете использовать средство выбора Люди на мобильных устройствах для поиска и выбора пользователя, чтобы улучшить взаимодействие с пользователем. Интерфейс поиска аналогичен любому другому интерфейсу выбора пользователей на мобильных устройствах.

Пример сценария переназначения

Пользователь А (Роберт) получает билет на задачу в канале и понимает, что неправильная назначенная сторона. Пользователь A переназначает задачу, которая отправляет информацию боту.

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

1. Выберите Переназначить , где поле выбора людей предварительно заполнено именем, чтобы переназначить задачу предполагаемому пользователю.
2. Удалите неправильное имя пользователя.
3. Выберите предполагаемых пользователей в сценарии изображения, пользователя B (Mona) и пользователя C (Robin) для задачи.
4. Нажмите кнопку Готово.
5. Нажмите Назначить. После назначения данные отправляются боту. Бот обновляет адаптивную карточку и уведомляет предполагаемых пользователей.

На следующем рисунке показан сценарий переназначения:

Реализация средства выбора Люди

Люди Средства выбора реализовано как расширение элемента управления Input.ChoiceSet. Элемент управления входными данными включает в себя следующие параметры:

• Раскрывающийся список, например развернутый выделенный фрагмент.
• Переключатель, например один выбор.
• Флажки, например несколько вариантов выбора.

Примечание.

Элемент Input.ChoiceSet управления основан на свойствах style и isMultiSelect .

Обновление схемы

Следующие свойства являются дополнениями к схемеInput.ChoiceSet, чтобы обеспечить Люди возможности выбора на карта:

Элемент управления Input.ChoiceSet

Свойство	Тип	Обязательный	Описание
choices.data	Data.Query	Нет	Включает динамическое автоматическое заполнение для разных типов пользователей путем получения результатов из указанного набора данных.

Data.Query

Свойство	Тип	Обязательный	Описание
Набора данных	String	Да	Тип данных, которые необходимо получить динамически.

Набора данных

В следующей таблице приведены стандартные значения в виде набора данных для средства выбора людей.

Набора данных	Область поиска
graph.microsoft.com/users	Поиск всех участников в организации.
graph.microsoft.com/users? область=currentContext	Выполните поиск по участникам текущей беседы, например в чате или канале, в котором отправляется конкретная карта.

Пример

Ниже приведен пример кода для создания средства выбора Люди с помощью поиска организации:

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "isMultiSelect": true
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

На следующем рисунке показано Люди средства выбора в адаптивных карточках с поиском организации:

Чтобы включить поиск в списке участников диалога, используйте соответствующий набор данных, определенный в таблице наборов данных . isMultiSelect свойство используется для выбора нескольких пользователей в элементе управления . По умолчанию задано значение false, и этот параметр позволяет выбрать только одного пользователя.

Отправка данных

Вы можете использовать Action.Submit или Action.Execute для отправки выбранных данных боту. Полезные invoke данные, полученные в боте, представляют собой список идентификаторов Microsoft Entra или идентификаторов, указанных в статическом списке. В средстве выбора Люди при выборе пользователя в элементе Microsoft Entra ID управления значение пользователя является значением, отправленным обратно. Является Microsoft Entra ID строкой и уникальным образом идентифицирует пользователя в каталоге.

Формат значения, отправленного боту, зависит от значения isMultiSelect свойства:

значение isMultiSelect	Формат
false (один выбор)	<selected_Azure_AD_ID>
true (множественный выбор)	<>selected_Azure_AD_ID_1,selected_Azure_AD_ID_2,selected_Azure_AD_ID_3<><>

Microsoft Entra IDС помощью средства выбора Люди предварительно выбирает соответствующего пользователя.

Предварительный выбор пользователя

средство выбора Люди поддерживает предварительный выбор пользователя в элементе управления при создании и отправке адаптивной карточки. Input.ChoiceSetvalue поддерживает свойство, используемое для предварительного выбора пользователя. Формат этого value свойства совпадает с форматом отправленного значения при отправке данных.
В следующем списке приведены сведения для предварительного выбора пользователей:

• Для одного пользователя в элементе управления укажите Microsoft Entra ID для пользователя valueзначение .
• Для нескольких пользователей, например isMultiSelect , укажите trueстроку Microsoft Entra IDs, разделенную запятыми.

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

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "value": "<Microsoft Entra ID 1>"
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

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

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "isMultiSelect": true,
   "value": "<Microsoft Entra ID 1>,<Microsoft Entra ID 2>,<Microsoft Entra ID 3>"
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

Статические варианты

Статические варианты поддерживают сценарии, в которых пользовательские профили должны быть вставлены в предопределенные наборы данных. Input.ChoiceSet поддерживает статические choices указания в json. Статический выбор используется для создания вариантов, из которых пользователь может выбрать.

Примечание.

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

Выбор состоит из title и value. При использовании вместе с Люди Picker эти варианты претворяются в профили пользователей title с именем в качестве имени и идентификаторомvalue. Эти настраиваемые профили также являются частью результатов поиска, когда поисковый запрос соответствует заданному title. В следующем примере описываются статические варианты.

{
 "type": "AdaptiveCard",
 "body": [
  {
   "type": "TextBlock",
   "size": "Medium",
   "weight": "Bolder",
   "text": "People Picker with Org search enabled"
  },
  {
   "type": "Input.ChoiceSet",
   "choices": [
    {
     "title": "Custom Profile 1",
     "value": "Profile1"
    },
    {
     "title": "Custom Profile 2",
     "value": "Profile2"
    }
   ],
   "choices.data": {
    "type": "Data.Query",
    "dataset": "graph.microsoft.com/users"
   },
   "id": "people-picker",
   "isMultiSelect": true
  }
 ],
 "actions": [
  {
   "type": "Action.Submit",
   "title": "Submit"
  }
 ],
 "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
 "version": "1.2"
}

На следующем рисунке показано Люди средства выбора в адаптивных карточках со статическими вариантами в поиске организации:

Вы можете реализовать Люди Picker для эффективного управления задачами в разных сценариях.

Пример кода

Название примера	Описание	.NET	Node.js	Манифест
элемент управления Люди средства выбора в адаптивных карточках	В этом примере показано, как использовать элемент управления "Выбор людей" в адаптивных карточках.	Просмотр	Просмотр	Просмотр

См. также

• Типы карточек
• Боты и пакеты SDK
• Создание расширений сообщений для Teams
• Создание соединителей для Группы Microsoft 365
• Элементы мультимедиа в адаптивной карточке
• Упоминание тегов