Referenční informace o šabloně obrazovky lidí pro aplikace plátna

Pro aplikace plátna v Power Apps, získejte informace o tom, jak každý významný ovládací prvek v šabloně obrazovky lidí 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 lidí.

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

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.

Ovládací prvek TextSearchBox.

Několik dalších ovládacích prvků reagují nebo závisí na textovém vyhledávacím poli:

  • Pokud uživatel začne psát jakýkoli text, zobrazí se UserBrowseGallery.
  • Když uživatel uvnitř UserBrowseGallery někoho vybere, bude obsah vyhledávání resetován.

Ovládací prvek UserBrowseGallery.

  • Vlastnost: Položky
    Hodnota: Logika vyhledávání uživatelů, když uživatel začne psát:

    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)) ... ), protože musíte volat operaci, když vyhledávací pole obsahuje text zadaný uživatelem. To zvýší výkon.

Ovládací prvek Název UserBrowseGallery

Ovládací prvek Název UserBrowseGallery.

  • 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, kolekce všech lidí, které uživatel aplikace vybral.

Ovládací prvek UserBrowseGallery ProfilImage

Ovládací prvek UserBrowseGallery ProfilImage.

  • Vlastnost Image
    Hodnota: Logika pro načtení profilové fotografie uživatele.

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

Ovládací prvek Image načte obrázek uživatele pomocí operace Office365Users.UserPhoto. Před tím však zkontroluje dvě věci:

  • Zda je pole ID prázdné nebo není prázdné. Tím se zabrání ovládacímu prvku Image v načtení uživatelské fotografie před naplněním galerie výsledky vyhledávání.
  • Zda má uživatel fotografii (s operací Office365Users.UserPhotoMetadata). Tím se zabrání, aby vyhledávání Office365Users.UserPhoto vrátilo výjimku, pokud uživatel nemá profilový obrázek.

Všimněte si, že pokud obrázek není načten, ovládací prvek Image je prázdný a místo toho je vidět ovládací prvek iconUser.

Ovládací prvek PeopleAddedGallery.

  • Vlastnost: Položky
    Hodnota: MyPeople

Toto je kolekce osob inicializovaných nebo přidaných výběrem ovládacího prvku UserBrowseGallery Title.

Ovládací prvek PeopleAddedGallery Title

Ovládací prvek PeopleAddedGallery Title.

  • Vlastnost: OnSelect
    Hodnota: Set( _selectedUser, ThisItem )

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

Ovládací prvek PeopleAddedGallery iconRemove

Ovládací prvek PeopleAddedGallery iconRemove.

  • 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 pak odebere tento záznam z kolekce.

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