Referenčni podatki o predlogi zaslona stikov za aplikacije delovnega območja

Za aplikacije delovnega območja v storitvi Power Apps preberite, kako vsak pomemben kontrolnik v predlogi zaslona stikov prispeva k splošni privzeti funkcionalnosti zaslona. Ta predstavitev vseh podrobnosti vključuje formule vedenja in vrednosti drugih lastnosti, ki določajo, kako se kontrolnik odziva na vnos uporabnika. Za celovito razpravo o privzeti funkcionalnosti tega zaslona glejte Pregled zaslona stikov.

Ta tema poudarja nekaj pomembnih kontrolnikov in razlaga izraze oz. formule, na podlagi katerih se nastavijo različne lastnosti (npr. Items in OnSelect) teh kontrolnikov:

• Besedilno iskalno polje
• Galerija za brskanje po uporabnikih (+ podrejeni kontrolniki)
• Galerija dodanih stikov (+ podrejeni kontrolniki)

Predpogoj

Poznavanje postopkov dodajanja in konfiguriranja zaslonov ter drugih kontrolnikov, ko ustvarjate aplikacijo v storitvi Power Apps.

Besedilno iskalno polje

Nekaj drugih kontrolnikov ima interakcijo ali odvisnost z besedilnim iskalnim poljem:

• Če uporabnik začne vnašati poljubno besedilo, se prikaže UserBrowseGallery.
• Ko uporabnik izbere osebo v možnosti UserBrowseGallery, se vsebine iskanja ponastavijo.

Galerija za brskanje po uporabnikih

• Lastnost: Elementi
  Vrednost: logika za iskanje uporabnikov, ko uporabnik začne tipkati:

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

Elementi te galerije so zapolnjeni z rezultati iskanja iz postopka Office365.SearchUser. Postopek za iskalni izraz vzame besedilo pri možnosti Trim(TextSearchBox) in vrne prvih 15 rezultatov glede na to iskanje. TextSearchBox je obdan s funkcijo Trim(), ker iskanje uporabnikov s presledki ni veljavno.

Postopek Office365Users.SearchUser je obdan s funkcijo If(!IsBlank(Trim(TextSearchBox.Text)) ... ), ker morate priklicati postopek samo, ko iskalno polje vsebuje besedilo, ki ga vnese uporabnik. To izboljša zmogljivost.

Kontrolnik UserBrowseGallery Title

• Lastnost: Besedilo
  Vrednost: ThisItem.DisplayName

  Prikaže prikazno ime osebe iz njenega profila Office 365.

• Lastnost: OnSelect
  Vrednost: s kodiranjem dodajte uporabnika v zbirko na ravni aplikacije, nato pa izberite uporabnika:

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

Z izbiro tega kontrolnika hkrati storite tri stvari:

• Spremenljivka _selectedUser se nastavi na izbrani element.
• Ponastavi se iskalni izraz pri možnosti TextSearchBox.
• Izbrani element se doda v zbirko MyPeople, ki je zbirka vseh oseb, ki jih je izbral uporabnik aplikacije.

Kontrolnik ProfileImage za UserBrowseGallery

• Lastnost: Image
  Vrednost: logika za pridobivanje slike profila uporabnika.

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

Kontrolnik Image pridobi uporabnikovo sliko s postopkom Office365Users.UserPhoto. Vendar pa pred tem preveri dve stvari:

• Ali je polje z ID-jem prazno ali ne. Nadzorniku Image to preprečuje pridobivanje fotografije uporabnika, preden se galerija zapolni z rezultati iskanja.
• Ali ima uporabnik fotografijo (s postopkom Office365Users.UserPhotoMetadata). To preprečuje, da bi iskanje Office365Users.UserPhoto vrnilo izjemo, če uporabnik nima slike profila.

Če slike ni mogoče pridobiti, je kontrolnik Image prazen in je namesto njega viden kontrolnik iconUser.

Galerija dodanih stikov

• Lastnost: Elementi
  Vrednost: MyPeople

To je zbirka oseb, inicializiranih ali dodanih z izbiro kontrolnika UserBrowseGallery Title.

Kontrolnik PeopleAddedGallery Title

• Lastnost: OnSelect
  Vrednost: Set( _selectedUser, ThisItem )

Nastavi spremenljivko _selectedUser na izbrani element pri možnosti EmailPeopleGallery.

Kontrolnik PeopleAddedGallery iconRemove

• Lastnost: OnSelect
  Vrednost: Remove( MyPeople, LookUp( MyPeople, UserPrincipalName = ThisItem.UserPrincipalName ) )

Poišče zapis v zbirki MyPeople, kjer se UserPrincipalName ujema z možnostjo UserPrincipalName izbranega elementa, nato pa odstrani ta zapis iz zbirke.

Naslednji koraki

• Več o tem zaslonu.
• Preberite več o povezovalniku Office 365 Outlook.
• Preberite več o povezovalniku za uporabnike storitve Office 365.

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).