Información de referencia acerca do modelo de pantalla da persoas para aplicacións de lenzo

Para aplicacións de lenzo en Power Apps, obteña información sobre como contribúe cada control significativo do modelo da pantalla de persoas á funcionalidade predefinida xeral da pantalla. Esta información presenta as fórmulas de comportamento e os valores doutras propiedades que determinan como responden os controis á entrada do usuario. Para manter un debate de alto nivel sobre a funcionalidade predefinida desta pantalla, consulte a visión xeral da pantalla de persoas.

Este tema resalta algúns controis significativos e explica as expresións ou fórmulas nas que as diversas propiedades (como Elementos e OnSelect) destes controis se establecen:

• Cadro de busca de texto
• Galería de exploración de usuarios (+ controis secundarios)
• Galería de persoas engadidas (+ controis secundarios)

Requisito previo

Familiarícese con como engadir e configurar pantallas e outros controis ao crear unha aplicación en Power Apps.

Cadro de busca de texto

Outros dous controis interactúan ou teñen unha dependencia na caixa de busca de texto:

• Se un usuario comeza a escribir un texto, UserBrowseGallery pasa a estar visible.
• Cando un usuario selecciona unha persoa dentro de UserBrowseGallery, restablécese o contido de busca.

Galería de exploración de usuarios

• Propiedade: Items
  Valor: Lóxica para buscar usuarios cando o usuario comeza a escribir:

  If( !IsBlank( Trim( TextSearchBox.Text ) ), 
      'Office365Users'.SearchUser(
          {
              searchTerm: Trim( TextSearchBox.Text ), 
              top: 15
          }
      )
  )
  

Os elementos desta galería están cubertos con resultados da operación Office365.SearchUser A operación leva o texto en Trim(TextSearchBox) como termo de busca e devolve os 15 primeiros resultados en función desa busca. TextSearchBox axústase nunha función Trim() porque unha busca do usuario en espazos non é válida.

A operación Office365Users.SearchUser está axústase nunha función If(!IsBlank(Trim(TextSearchBox.Text)) ... ) porque só precisa chamar a operación cando a caixa de busca contén texto introducido polo usuario. Isto mellora o rendemento.

Control do título de UserBrowseGallery

• Propiedade: Text
  Valor: ThisItem.DisplayName

  Amosa o nome de visualización da persoa desde o seu perfil de Office 365.

• Propiedade: OnSelect
  Valor: código para engadir ao usuario a unha colección a nivel de aplicación e, a continuación, seleccionar o usuario:

  Concurrent(
      Set( _selectedUser, ThisItem ),
      Reset( TextSearchBox ),
      If( Not( ThisItem.UserPrincipalName in MyPeople.UserPrincipalName ), 
          Collect( MyPeople, ThisItem )
      )
  )
  

Seleccionar este control fai tres cousas ao mesmo tempo:

• Configura a variable _selectedUser para o elemento seleccionado.
• Restablece o termo de busca en TextSearchBox.
• Engade o elemento seleccionado á colección MyPeople, unha colección de todas as persoas que seleccionou o usuario da aplicación.

Control ProfileImage de UserBrowseGallery

• Propiedade: Imaxe
  Valor: lóxica para recuperar a foto de perfil dun usuario.

  If( !IsBlank( ThisItem.Id ) && 
          'Office365Users'.UserPhotoMetadata( ThisItem.Id ).HasPhoto,
      'Office365Users'.UserPhoto( ThisItem.Id )
  )
  

O control Imaxe recupera a imaxe do usuario coa operación Office365Users.UserPhoto. Non obstante, antes de facelo, comprobe dúas cousas:

• Se o campo de identificación está baleiro ou non baleiro. Isto impide que o control Imaxe intente recuperar unha foto de usuario antes de que a galería estea cuberta de resultados de busca.
• Se o usuario ten unha foto (coa operación Office365Users.UserPhotoMetadata). Isto impide que a busca de Office365Users.UserPhoto devolva unha excepción se o usuario non ten unha foto de perfil.

Teña en conta que se non se recupera unha imaxe, o control Imaxe está en branco e o control iconUser no seu lugar é visible.

Galería de xente engadida

• Propiedade: Items
  Valor: MyPeople

Esta é a colección das persoas inicializadas ou engadidas ao seleccionar o control Título de UserBrowseGallery.

Control Título de PeopleAddedGallery

• Propiedade: OnSelect
  Valor: Set( _selectedUser, ThisItem )

Configura a variable _selectedUser para o elemento seleccionado en EmailPeopleGallery.

Control de iconRemove de PeopleAddedGallery

• Propiedade: OnSelect
  Valor: Remove( MyPeople, LookUp( MyPeople, UserPrincipalName = ThisItem.UserPrincipalName ) )

Busca o rexistro na colección MyPeople, onde UserPrincipalName coincide co UserPrincipalName do elemento seleccionado e, a continuación, elimina ese rexistro da colección.

Pasos seguintes

• Obteña máis información sobre esta pantalla.
• Máis información acerca do conector de Office 365 Outlook.
• Máis información acerca do conector de usuarios de Office 365.

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).