Referenční informace o šabloně obrazovky e-mailu v aplikacích plátna

Článek
03/09/2022
2 min ke čtení

Pro aplikace plátna v Power Apps, získejte informace o tom, jak každý významný ovládací prvek v šabloně obrazovky e-mailu přispívá k celkové výchozí funkčnosti obrazovky. Tyto podrobnosti představují vzorce chování a hodnoty dalších vlastností, které určují, jak ovládací prvky reagují na vstup uživatele. Podrobnější informace o výchozí funkci této obrazovky naleznete na stránce přehled obrazovky e-mailu.

Tento téma zdůrazňuje některé významné ovládací prvky a vysvětluje výrazy nebo vzorce, ke kterým jsou nastaveny různé vlastnosti (například Položky a OnSelect) z těchto ovládacích prvků:

Textové vyhledávací pole
Ikona pro přidání
Galerie pro procházení osob
Galerie e-mailů osob (+ podřízené ovládací prvky)
Ikona pošty

Požadavek

Seznámení s tím, jak přidávat a konfigurovat obrazovky a další ovládací prvky při vytváření aplikace v Power Apps.

Několik dalších ovládacích prvků na obrazovce závisí na ovládacím prvku Textové vyhledávací pole:

Pokud uživatel začne psát jakýkoli text, zobrazí se PeopleBrowseGallery.
Pokud uživatel zadá platnou e-mailovou adresu, zobrazí se AddIcon.
Když uživatel uvnitř PeopleBrowseGallery někoho vybere, bude obsah vyhledávání resetován.

Ikona pro přidání

Ovládací prvek Ikona pro přidání umožňuje uživatelům aplikace přidávat lidi, kteří neexistují uvnitř jejich organizace, do seznamu příjemců vytvářeného e-mailu.

Vlastnost: Visible
Hodnota: Logika, která zobrazí ovládací prvek, pouze pokud uživatel do vyhledávacího pole zadá platnou e-mailovou adresu:
```
!IsBlank( TextSearchBox.Text ) &&
    IsMatch( TextSearchBox.Text, Match.Email ) &&
    Not( Trim( TextSearchBox.Text ) in MyPeople.UserPrincipalName )
```
Řádek po řádku, předchozí blok kódu říká, že ovládací prvek Ikona pro přidání bude viditelný, pouze pokud:
- TextSearchBox obsahuje text.
- Text v TextSearchBox je platná e-mailová adresa.
- Text v TextSearchBox dosud neexistuje v kolekci MyPeople.
Vlastnost: OnSelect
Hodnota: Pokud vyberete tuto možnost, přidá se platná e-mailová adresa do kolekce MyPeople. Tato kolekce se používá na obrazovce jako seznam příjemců:
```
Collect( MyPeople,
    { 
        DisplayName: TextSearchBox.Text, 
        UserPrincipalName: TextSearchBox.Text, 
        Mail: TextSearchBox.Text
    }
);
Reset( TextSearchBox )
```
Tento blok kódu přidá řádek do kolekce MyPeople a vyplní tři pole textem v TextSearchBox. Tato tři pole jsou DisplayName, UserPrincipalName a Mail. Poté resetuje obsah TextSearchBox.

Galerie pro procházení osob

Ovládací prvek PeopleBrowseGallery.

Vlastnost: Položky
Hodnota: Prvních 15 výsledků vyhledávání textu zadaného do ovládacího prvku TextSearchBox:
```
If( !IsBlank( Trim(TextSearchBox.Text ) ), 
    'Office365Users'.SearchUser( {searchTerm: Trim( TextSearchBox.Text ), top: 15} )
)
```
Položky této galerie jsou vyplněny výsledky vyhledávání z operace Office365.SearchUser. Operace bere text v Trim(TextSearchBox) jako termín vyhledávání a na základě tohoto vyhledávání vrací 15 nejlepších výsledků.

TextSearchBox je zabalen do funkce Trim(), protože vyhledávání uživatelů v mezerách není platné. Operace Office365Users.SearchUser je zabalena ve funkci If(!IsBlank(Trim(TextSearchBox.Text)) ... ), což znamená, že operace je provedena, pouze pokud vyhledávací pole obsahuje text zadaný uživatelem. To zvýší výkon.

Ovládací prvek Title galerie pro procházení osob

Ovládací prvek Název galerie pro procházení osob.

Vlastnost: Text
Hodnota: ThisItem.DisplayName

Zobrazuje zobrazované jméno dané osoby z profilu Office 365.

Vlastnost: OnSelect
Hodnota: Kód pro přidání uživatele do kolekce na úrovni aplikace a poté vyberte uživatele:

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

Výběr tohoto ovládacího prvku provede tři věci současně:

Nastaví proměnnou _selectedUser na vybranou položku.
Obnoví hledaný termín v TextSearchBox.
Přidá vybranou položku do kolekce MyPeople, což je kolekce všech vybraných uživatelů, které obrazovka e-mailu používá jako množinu příjemců.

Galerie e-mailů osob

Ovládací prvek EmailPeopleGallery.

Vlastnost: Položky
Hodnota: MyPeople

Toto je kolekce osob inicializovaných nebo přidaných výběrem ovládacího prvku PeopleBrowseGallery Title.
Vlastnost: Height
Hodnota: Logika pro nastavení výšky na základě počtu položek aktuálně v galerii:
```
Min( 
    ( EmailPeopleGallery.TemplateHeight + EmailPeopleGallery.TemplatePadding * 2) *
        RoundUp(CountRows(EmailPeopleGallery.AllItems) / 2, 0 ),
    304
)
```
Výška této galerie se přizpůsobí počtu položek v galerii s maximální výškou 304.

Přebírá TemplateHeight + TemplatePadding * 2 jako celkovou výšku jednoho řádku ovládacího prvku EmailPeopleGallery a pak ji vynásobí počtem řádků. Od hodnoty WrapCount = 2 je počet skutečných řádků RoundUp(CountRows(EmailPeopleGallery.AllItems) / 2, 0).
Vlastnost: ShowScrollbar
Hodnota: EmailPeopleGallery.Height >= 304

Jakmile výška galerie dosáhne 304, zobrazí se posuvník.

Ovládací prvek Title galerie e-mailů osob

Ovládací prvek názvu EmailPeopleGallery.

Vlastnost: OnSelect
Hodnota: Set(_selectedUser, ThisItem)

Nastaví proměnnou _selectedUser na vybranou položku v EmailPeopleGallery.

Ovládací prvek iconRemove galerie e-mailů osob

Ovládací prvek Název MonthDayGallery.

Vlastnost: OnSelect
Hodnota: Remove( MyPeople, LookUp( MyPeople, UserPrincipalName = ThisItem.UserPrincipalName ) )

Vyhledá záznam v kolekci MyPeople, kde UserPrincipalName odpovídá UserPrincipalName vybrané položky a odebere tento záznam z kolekce.

Ikona pošty

Vlastnost: OnSelect
Hodnota: Logika pro odeslání e-mailové zprávy uživatele:
```
Set( _emailRecipientString, Concat( MyPeople, Mail & ";" ) );
'Office365'.SendEmail( _emailRecipientString, 
    TextEmailSubject.Text,  
    TextEmailMessage.Text, 
    { Importance:"Normal" }
);
Reset( TextEmailSubject );
Reset( TextEmailMessage );
Clear( MyPeople )
```
Odeslání e-mailové zprávy vyžaduje řetězec e-mailových adres oddělený středníkem. V předchozím kódu:
1. První řádek kódu prevezme pole Mail ze všech řádků v kolekci MyPeople, zřetězí je do jednoho řetězce e-mailových adres oddělených středníky a nastaví proměnnou _emailRecipientString na hodnotu řetězce.
2. Poté použije operaci Office365.SendEmail k odeslání e-mailu příjemcům. Operace má tři požadované parametry, To (komu), Subject (předmět) a Body (text) a jeden volitelný parametr – Importance (důležitost). V předchozím kódu jsou to _emailRecipientString, TextEmailSubject.Text, TextEmailMessage .Text a Normal.
3. Nakonec obnoví ovládací prvky TextEmailSubject a TextEmailMessage a vymaže kolekci MyPeople.
Vlastnost DisplayMode
Hodnota: If( Len( Trim( TextEmailSubject.Text ) ) > 0 && !IsEmpty( MyPeople ), DisplayMode.Edit, DisplayMode.Disabled ) K odeslání e-mailu musí být v předmětu e-mailu uveden text a kolekce příjemců (MyPeople) nesmí být prázdná.

Další kroky

Poznámka

Můžete nám sdělit, jaké máte jazykové preference pro dokumentaci? Zúčastněte se krátkého průzkumu. (upozorňujeme, že tento průzkum je v angličtině)

Průzkum bude trvat asi sedm minut. Nejsou shromažďovány žádné osobní údaje (prohlášení o zásadách ochrany osobních údajů).