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

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

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

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

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

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

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

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

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

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

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

Data.Query

набор данных

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

Пример

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

{
 "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 свойства:

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

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

Средство выбора людей поддерживает предварительный выбор пользователя в элементе управления при создании и отправке адаптивной карточки. Input.ChoiceSet value поддерживает свойство, используемое для предварительного выбора пользователя. Формат этого 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. Статический выбор используется для создания вариантов, из которых пользователь может выбрать.

Выбор состоит из title и value. При использовании вместе с выбором людей эти варианты претворяются в профили пользователей 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"
}

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

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

Пример кода

См. также

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