Povratne informacije

Referenčne informacije o predlogi e-poštnega zaslona v aplikacijah s platnom

  • Članek
  • 2 min za branje

Za aplikacije delovnega območja v storitvi Power Apps preberite, kako vsak pomemben kontrolnik v predlogi zaslona e-pošte 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 e-pošte.

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:

Predpogoj

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

Besedilno iskalno polje

Kontrolnik »TextSearchBox«.

Več drugih kontrolnikov na zaslonu ima odvisnost s kontrolnikom Text search box:

  • Če uporabnik začne vnašati poljubno besedilo, se prikaže PeopleBrowseGallery.
  • Če uporabnik vnese veljaven e-poštni naslov, se prikaže AddIcon.
  • Ko uporabnik izbere osebo v možnosti PeopleBrowseGallery, se vsebine iskanja ponastavijo.

Ikona za dodajanje

Kontrolnik »AddIcon«.

Kontrolnik Add icon omogoča uporabnikom, da dodajo osebe, ki ne obstajajo v njihovi organizaciji, na seznam prejemnikov e-poštnega sporočila, ki ga sestavljajo.

  • Lastnost: Visible
    Vrednost: Logika za prikaz kontrolnika samo, ko uporabnik vnese veljaven e-poštni naslov v iskalno polje:

    !IsBlank( TextSearchBox.Text ) &&
    IsMatch( TextSearchBox.Text, Match.Email ) &&
    Not( Trim( TextSearchBox.Text ) in MyPeople.UserPrincipalName )

    Vrstica za vrstico prejšnji blok kode pravi, da bo kontrolnik Add icon viden samo, če:

    • TextSearchBox vsebuje besedilo.
    • Besedilo v možnosti TextSearchBox je veljaven e-poštni naslov.
    • Besedilo v TextSearchBox še ne obstaja v zbirki MyPeople.

  • Lastnost: OnSelect
    Vrednost: Če izberete to, dodate veljaven e-poštni naslov v zbirko MyPeople. To zbirko zaslon uporablja kot seznam prejemnikov:

    Collect( MyPeople,
    { 
        DisplayName: TextSearchBox.Text, 
        UserPrincipalName: TextSearchBox.Text, 
        Mail: TextSearchBox.Text
    }
);
Reset( TextSearchBox )

    Ta blok kode doda vrstico v zbirko MyPeople in izpolni tri polja z besedilom v možnosti TextSearchBox. Ta tri polja so DisplayName, UserPrincipalName in Mail. Nato ponastavi vsebino možnosti TextSearchBox.

Kontrolnik »PeopleBrowseGallery«.

  • Lastnost: Elementi
    Vrednost: Najpogostejših 15 rezultatov iskanja za iskano besedilo, vneseno v kontrolnik TextSearchBox:

    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)) ... ), kar pomeni, da se izvede samo, če iskalno polje vsebuje besedilo, ki ga vnese uporabnik. To izboljša zmogljivost.

Kontrolnik naslova PeopleBrowseGallery.

  • 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:

  • Nastavi spremenljivko _selectedUser na izbrani element.
  • Ponastavi se iskalni izraz pri možnosti TextSearchBox.
  • Doda izbrani element v zbirko MyPeople, tj. zbirko vseh izbranih uporabnikov, ki jih zaslon z e-pošto uporablja kot nabor prejemnikov.

Kontrolnik EmailPeopleGallery.

  • Lastnost: Elementi
    Vrednost: MyPeople

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

  • Lastnost: Height
    Vrednost: Logika za nastavitev višine na podlagi števila primerov, ki so trenutno v galeriji:

    Min( 
    ( EmailPeopleGallery.TemplateHeight + EmailPeopleGallery.TemplatePadding * 2) *
        RoundUp(CountRows(EmailPeopleGallery.AllItems) / 2, 0 ),
    304
)

    Višina te galerije se prilagodi številu predmetov v galeriji, največja višina pa je 304.

    Vzame TemplateHeight + TemplatePadding * 2 kot skupno višino ene vrstice EmailPeopleGallery, kar nato pomnoži s številom vrstic. Ker velja WrapCount = 2, je število pravih vrstic RoundUp(CountRows(EmailPeopleGallery.AllItems) / 2, 0).

  • Lastnost: ShowScrollbar
    Vrednost: EmailPeopleGallery.Height >= 304

    Ko višina galerije doseže 304, postane viden drsni trak.

Kontrolnik naslova EmailPeopleGallery.

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

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

Kontrolnik naslova MonthDayGallery.

  • 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, in odstrani ta zapis iz zbirke.

Ikona za pošto

  • Lastnost: OnSelect
    Vrednost: Logika za pošiljanje uporabnikovega e-poštnega sporočila:

    Set( _emailRecipientString, Concat( MyPeople, Mail & ";" ) );
'Office365'.SendEmail( _emailRecipientString, 
    TextEmailSubject.Text,  
    TextEmailMessage.Text, 
    { Importance:"Normal" }
);
Reset( TextEmailSubject );
Reset( TextEmailMessage );
Clear( MyPeople )

    Za pošiljanje e-poštnega sporočila je potreben niz e-poštnih naslovov, ločenih s podpičjem. V prejšnji kodi:

    1. Prva vrstica kode vzame polje Pošta iz vseh vrstic v zbirki MyPeople, jih združi v en niz e-poštnih naslovov, ločenih s podpičji, in nastavi spremenljivko _emailRecipientString na to vrednost niza.

    2. Nato uporabi postopek Office365.SendEmail za pošiljanje e-poštnega sporočila prejemnikom. Postopek ima tri obvezne parametre, Za, Zadeva in Telo, ter en izbirni parameter Pomembnost. V prejšnji kodi ti po vrsti ustrezajo _emailRecipientString, TextEmailSubject.Text, TextEmailMessage.Text in Normal.

    3. Končno, ponastavi kontrolnika TextEmailSubject in TextEmailMessage ter počisti zbirko MyPeople.

  • Lastnost: DisplayMode
    Vrednost: If( Len( Trim( TextEmailSubject.Text ) ) > 0 && !IsEmpty( MyPeople ), DisplayMode.Edit, DisplayMode.Disabled ) Da je e-poštno sporočilo poslano, mora vrstica z zadevo e-poštnega sporočila vsebovati besedilo in zbirka prejemnikov (MyPeople) ne sme biti prazna.

Naslednji koraki

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).