Seletor de Pessoas em Cartões Adaptáveis

Pessoas Picker ajuda os usuários a pesquisar e selecionar usuários no Cartão Adaptável. Você pode adicionar Pessoas Picker como controle de entrada ao Cartão Adaptável, que funciona em chats, canais, caixas de diálogo (conhecidos como módulos de tarefa no TeamsJS v1.x) e guias. Pessoas Picker dá suporte aos seguintes recursos:

• Pesquisa usuários únicos ou vários.
• Seleciona usuários únicos ou múltiplos.
• Reatribui para usuários únicos ou múltiplos.
• Prepovoa o nome dos usuários selecionados.

Cenários populares

A tabela a seguir fornece cenários populares para Pessoas Seletor em Cartões Adaptáveis e as ações correspondentes:

Cenários	Ações
Cenários baseados em aprovação	Para solicitar, atribuir e reatribuir a aprovação ao usuário pretendido com base no requisito.
Gestão de incidentes	Para controlar incidentes e notificar, atribua e reatribua ao usuário pretendido para uma ação imediata.
Gerenciamento de projeto	Para atribuir tíquetes ou bugs a determinados usuários.
Pesquisa de usuário	Para pesquisar usuários em toda a organização.

Desktop

O cliente da Web e da área de trabalho dá suporte Pessoas Seletor no Cartão Adaptável. Durante a pesquisa na Web, Pessoas Picker envolve uma experiência de digitação embutida.

Exemplo de cenário de reatribuição

O usuário A (Robert) recebe um tíquete para uma tarefa em um canal e percebe o atribuído incorreto. User A reatribui a tarefa que envia as informações de volta para o bot.

Para reatribuir qualquer tarefa:

1. Selecione Reatribuir onde o campo seletor de pessoas é prepovoado com o nome para reatribuir a tarefa para o usuário pretendido.
2. Remova o nome do usuário incorreto.
3. Selecione usuários pretendidos de acordo com o cenário de imagem, o usuário B (Mona) e o usuário C (Robin) para a tarefa.
4. Selecione Atribuir. Após a atribuição, as informações são enviadas para o bot. O bot atualiza o Cartão Adaptável e notifica os usuários pretendidos.

A imagem a seguir mostra o cenário de reatribuição:

Dispositivo móvel

Os clientes móveis Android e iOS dão suporte a Pessoas Picker em Cartões Adaptáveis. Você pode usar Pessoas Picker no celular para pesquisar e selecionar o usuário para aprimorar a experiência do usuário. A experiência de pesquisa é semelhante a qualquer outra experiência de seleção de usuário no celular.

Exemplo de cenário de reatribuição

O usuário A (Robert) recebe um tíquete para uma tarefa em um canal e percebe o atribuído incorreto. User A reatribui a tarefa que envia as informações de volta para o bot.

Para reatribuir qualquer tarefa:

1. Selecione Reatribuir onde o campo seletor de pessoas é prepovoado com o nome para reatribuir a tarefa para o usuário pretendido.
2. Remova o nome do usuário incorreto.
3. Selecione usuários pretendidos de acordo com o cenário de imagem, o usuário B (Mona) e o usuário C (Robin) para a tarefa.
4. Selecione Concluído.
5. Selecione Atribuir. Após a atribuição, as informações são enviadas para o bot. O bot atualiza o Cartão Adaptável e notifica os usuários pretendidos.

A imagem a seguir mostra o cenário de reatribuição:

Implementar o seletor de Pessoas

Pessoas Picker é implementado como uma extensão do controle Input.ChoiceSet. O controle de entrada inclui as seguintes seleções:

• Dropdown, como uma seleção expandida.
• Botão de rádio, como uma única seleção.
• Caixas de seleção, como várias seleções.

Observação

O Input.ChoiceSet controle é baseado nas style propriedades e isMultiSelect .

Atualizar esquema

As seguintes propriedades são adições ao Input.ChoiceSet esquema para habilitar Pessoas experiência do Seletor no cartão:

Controle Input.ChoiceSet

Propriedade	Tipo	Obrigatório	Descrição
choices.data	Data.Query	Não	Habilita a conclusão automática dinâmica para diferentes tipos de usuário, buscando resultados do conjunto de dados especificado.

Data.Query

Propriedade	Tipo	Obrigatório	Descrição
Dataset	Cadeia de caracteres	Sim	O tipo de dados que devem ser buscados dinamicamente.

Dataset

A tabela a seguir fornece valores predefinidos como conjunto de dados para o seletor de pessoas:

Dataset	Escopo de Pesquisa
graph.microsoft.com/users	Pesquise todos os membros em toda a organização.
graph.microsoft.com/users?scope=currentContext	Pesquise nos membros da conversa atual, como chat ou canal no qual o cartão específico é enviado.

Exemplo

O exemplo de código para criar Pessoas Picker com a pesquisa da organização é o seguinte:

{
 "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"
}

A imagem a seguir ilustra Pessoas Seletor em Cartões Adaptáveis com a pesquisa da organização:

Para habilitar a pesquisa dentro de uma lista de membros de conversa, use o conjunto de dados apropriado definido na tabela de conjunto de dados . isMultiSelect a propriedade é usada para habilitar a seleção de vários usuários no controle. Ele é definido como false por padrão e essa configuração permite que você selecione apenas um usuário.

Envio de dados

Você pode usar Action.Submit ou Action.Execute enviar dados selecionados para o bot. A invoke carga recebida no bot é uma lista de Microsoft Entra IDs ou as IDs fornecidas na lista estática. Em Pessoas Picker, quando um usuário é selecionado no controle, o Microsoft Entra ID do usuário é o valor enviado de volta. O Microsoft Entra ID é uma cadeia de caracteres e identifica exclusivamente um usuário no diretório.

O formato do valor enviado ao bot depende do valor da isMultiSelect propriedade:

valor de isMultiSelect	Formatar
false (seleção única)	<selected_Azure_AD_ID>
true (várias seleções)	<>selected_Azure_AD_ID_1,selected_Azure_AD_ID_2,selected_Azure_AD_ID_3<><>

Com o Microsoft Entra ID, Pessoas Picker preseleciona o usuário correspondente.

Pré-seleção do usuário

Pessoas Picker dá suporte à pré-seleção do usuário no controle ao criar e enviar um Cartão Adaptável. Input.ChoiceSet dá suporte à value propriedade usada para pré-selecionar um usuário. O formato dessa value propriedade é o mesmo que o formato de valor enviado no envio de dados.
A lista a seguir fornece as informações para pré-selecionar usuários:

• Para um único usuário no controle, especifique o Microsoft Entra ID do usuário como o value.
• Para vários usuários, como isMultiSelect é true, especifique uma cadeia de caracteres separada por vírgulas de Microsoft Entra IDs.

O exemplo a seguir descreve a pré-seleção de um único usuário:

{
 "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"
}

O exemplo a seguir descreve a pré-seleção de vários usuários:

{
 "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"
}

Opções estáticas

As opções estáticas dão suporte a cenários em que perfis personalizados devem ser inseridos nos conjuntos de dados predefinidos. Input.ChoiceSet dá suporte à especificação choices estatica no json. A escolha estática é usada para criar as opções das quais o usuário pode selecionar.

Observação

Estáticos choices são usados com conjuntos de dados dinâmicos.

A escolha consiste title em e value. Quando usadas junto com Pessoas Picker, essas opções são traduzidas para perfis de usuário que têm title como o nome e value como o identificador. Esses perfis personalizados também fazem parte dos resultados da pesquisa quando a consulta de pesquisa corresponde ao determinado title. O exemplo a seguir descreve opções estáticas:

{
 "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"
}

A imagem a seguir ilustra Pessoas Seletor em Cartões Adaptáveis com opções estáticas na pesquisa da organização:

Você pode implementar Pessoas Picker para um gerenciamento de tarefas eficiente em diferentes cenários.

Exemplo de código

Nome de exemplo	Descrição	.NET	Node.js	Manifesto
Pessoas controle de seletor em Cartões Adaptáveis	Este exemplo mostra como usar o controle de seletor de pessoas em Cartões Adaptáveis.	View	View	Exibir

Confira também

• Tipos de cartões
• Bots e SDKs
• Criar extensões de mensagem para o Teams
• Criar conectores para Grupos do Microsoft 365
• Elementos de mídia no Cartão Adaptável
• Marca menção