Principy datových karet v aplikacích plátna

Ovládací prvky Karta jsou stavební součásti ovládacích prvků Formulář pro úpravy a Formulář pro zobrazení v aplikacích plátna. Formulář představuje celý záznam a každá karta představuje jedno pole daného záznamu.

S kartami můžete snadněji pracovat v pravém podokně, když nejprve vyberete ovládací prvek Form v pracovním prostoru návrhu. V tomto podokně můžete zvolit pole, která chcete zobrazit, jak se má každé pole zobrazit a pořadí, v jakém je chcete zobrazit. Tento příklad ukazuje ovládací prvek Upravit formulář v aplikaci vytvořené ze seznamu s názvem Assets.

První obrazovka.

Pokud chcete začít pracovat s kartami, přečtěte si témata o přidání formuláře a o principech datových formulářů. Zbývající část tohoto článku obsahuje větší podrobnosti o tom, jak karty fungují a jak je můžete přizpůsobit nebo dokonce vytvořit vlastní.

Předdefinované karty

Power Apps nabízí předdefinovanou sadu karet pro řetězce, čísla a jiné datové typy. V pravém podokně jsou zobrazené dostupné možnosti, kde můžete změnit kartu použitou pro pole:

Vybraná karta.

V tomto příkladu je vybraná karta s jedním řádkem textu, ale adresa URL textu je delší, než se dá zobrazit na jednom řádku. Změňme ji na kartu s více řádky textu, aby naši uživatelé měli více místa na úpravy:

Víceřádková úprava.

Několik polí tohoto zdroje dat se nezobrazuje, ale pole můžete zobrazit nebo skrýt zaškrtnutím jeho políčka. Tento příklad ukazuje, jak zobrazit pole SecurityCode.

Přizpůsobení karty

Karty tvoří další ovládací prvky. V ovládacím prvku Formulář pro úpravy uživatel zadá data do standardního ovládacího prvku Textové zadání, který přidáte z karty Vložit.

Projděme si příklad toho, jak změnit vzhled karty pomocí manipulace s ovládacími prvky v ní.

  1. Nejprve se vraťme na kartu, kterou jsme naposledy vložili, pro pole SecurityCode. Tuto kartu kliknutím nebo klepnutím vyberte:

    Výběr kódu zabezpečení.

  2. Vyberte ovládací prvek Textové zadání v rámci karty kliknutím nebo klepnutím na tento prvek.

    Vyberte textový vstup.

  3. Tento ovládací prvek v rámci karty přesuňte přetažením oblasti výběru a změňte jeho velikost tak, že přetáhnete úchyty podél hrany oblasti výběru:

    Přizpůsobení textového zadání.

Můžete změnit velikost ovládacích prvků, přesunout je a provádět s nimi další úpravy na kartě, ale bez odemknutí ji nemůžete odstranit.

Odemčení karty

Kromě toho, že karty obsahují ovládací prvky, jsou karty samy ovládací prvky, které mají vlastnosti a vzorce stejně jako jiné ovládací prvky. Pokud se rozhodnete zobrazit pole ve formuláři, v pravém podokně se pro vás automaticky vytvoří karta a vygenerují se potřebné vzorce. Tyto vzorce můžeme vidět na kartě Upřesnit v pravém podokně:

Zámek na kartě Upřesnit.

Okamžitě vidíme jednu z nejdůležitějších vlastností karty: vlastnost DataField. Tato vlastnost určuje, které pole zdroje dat uživatel vidí a které může na této kartě upravit.

Na kartě Upřesnit ukazuje banner v horní části, že vlastnosti této karty jsou zamknuté. Ikona zámku se také zobrazí vedle vlastností DataField, DisplayName a Required. Tyto vzorce vytvořilo pravé podokno a zámek je chrání proti náhodným změnám.

Ikony zámku.

Klikněte nebo klepněte na banner v horní části karty, aby se odemkla a vy jste mohli tyto vlastnosti upravovat:

Odemčená karta.

Pojďme upravit DisplayName tak, že vložíme mezeru mezi Asset a ID. Touto změnou změníme, co se pro nás vygenerovalo. V pravém podokně má tato karta jiný popisek:

Změna zobrazovaného názvu.

Teď jsme převzali kontrolu nad touto kartou a můžeme ji dál upravit, aby vyhovovala našim potřebám. Přišli jsme ale o možnost změnit kartu z jednoho znázornění na jiné (například s jedním řádkem textu a více řádky textu), jako jsme to udělali dříve. Předdefinovanou kartu jsme převedli na vlastní kartu, kterou teď ovládáme.

Důležité

Pokud kartu odemknete, nejde už znovu zamknout. Pokud chcete mít kartu znovu zamknutou, odeberte ji a znovu ji vložte v pravém podokně.

Vzhled a chování odemknuté karty můžete změnit různými způsoby, například přidáním a odstraněním ovládacích prvků na ní. Můžete například z nabídky Ikony na kartě Vložit přidat tvar hvězdy.

Přidání hvězdičky.

Hvězda je teď součástí karty a bude se s ní přemisťovat, pokud například změníte pořadí karet v rámci formuláře.

Jako jiný příklad můžete odemknout kartu ImageURL a potom na ni přidat ovládací prvek Obrázek z karty Vložit:

Přidání obrázku.

Na řádku vzorců nastavte vlastnost Image tohoto ovládacího prvku na TextBox.Text, kde TextBox je název ovládacího prvku Textové zadání, který obsahuje adresu URL:

Zobrazení obrázku.

A teď vidíme obrázky a můžeme upravit jejich adresy URL. Všimněte si, že bychom bývali mohli použít Parent.Default jako vlastnost Image, ale ta by se neaktualizovala, když by uživatel změnil adresu URL.

Stejnou věc můžeme udělat na druhé obrazovce této aplikace, kde používáme ovládací prvek Formulář pro zobrazení k zobrazení podrobností záznamu. V takovém případě může být vhodné skrýt popisek (nastavit vlastnost Visible popisku, ne karty, na false), protože uživatel nebude upravovat adresu URL na této obrazovce:

Zobrazení obrázku.

Interakce s formulářem

Po odemknutí karty můžete změnit způsob interakce s formulářem, který ji obsahuje.

Níže jsou uvedené pokyny, jak by ovládací prvky měly fungovat s jejich kartou a jak by měly karty fungovat s formulářem. Jsou to jediné pokyny. U každého ovládacího prvku v Power Apps platí, že můžete vytvořit vzorce, které odkazují na libovolný jiný ovládací prvek v Power Apps, ať už jde o karty nebo ovládací prvky na kartách. Buďte kreativní: Aplikaci můžete vytvořit mnoha způsoby.

Vlastnost DataField

Nejdůležitější vlastnost na kartě je DataField. Tato vlastnost řídí ověřování, jaké pole se aktualizuje a další aspekty karty.

Přitékající informace

Formulář jako kontejner zpřístupňuje ThisItem pro všechny karty v něm. Tento záznam obsahuje všechna pole pro požadovaný aktuální záznam.

Vlastnost Default každé karty by měla být nastavená na ThisItem.FieldName. Za určitých okolností by mohlo být vhodné tuto hodnotu transformovat při vstupu do systému. Může být například vhodné formátovat řetězec nebo přeložit hodnotu z jednoho jazyka do jiného.

Každý ovládací prvek v rámci karty by měl odkazovat na Parent.Default, aby se dostal k hodnotě pole. Tato strategie poskytuje úroveň zapouzdření pro kartu tak, aby se vlastnost Default karty mohla změnit a nemusely se přitom měnit interní vzorce karty.

Ve výchozím nastavení jsou vlastnosti DefaultValue a Required převzaté z metadat zdroje dat na základě vlastnosti DataField. Tyto vzorce můžete přepsat vlastní logikou a integrovat metadata zdroje dat pomocí funkce DataSourceInfo.

Odtékající informace

Poté, co uživatel pomocí ovládacích prvků na kartách upraví záznam, uloží funkce SubmitForm tyto změny do zdroje dat. Při spuštění této funkce ovládací prvek Form přečte hodnoty vlastnosti DataField každé karty, aby věděl, která pole se mají změnit.

Ovládací prvek Form také přečte hodnotu vlastnosti Update každé karty. Tato hodnota se uloží ve zdroji dat pro toto pole. Toto je místo, kde použít jinou transformaci, třeba vrátit zpět transformaci, která byla použita ve vzorci Default karty.

Vlastnost Valid vychází z metadat zdroje dat na základě vlastnosti DataField. Také je založená na vlastnosti Required a jestli vlastnost Update obsahuje hodnotu. Pokud hodnota ve vlastnosti Update není platná, poskytne vlastnost Error popisnou chybovou zprávu.

Pokud vlastnost DataField karty je prázdná, je karta jenom kontejner ovládacích prvků. Její vlastnosti Valid a Update nehrají roli, když se formulář odesílá.

Rozbor příkladu

Podívejme se na ovládací prvky, které tvoří základní kartu pro zadávání dat. Místo mezi ovládacími prvky se zvětšilo, aby byl každý lépe vidět:

Rozbor karty.

Na tomto obrázku jsou ovládací prvky na datové kartě označeny:

Rozbor karet.

Díky čtyřem ovládacím prvkům tato karta funguje:

Jméno Typ Popis
TextRequiredStar Ovládací prvek Popisek Zobrazí hvězdičku, které se běžně používá ve formulářích pro zadávání dat k označení, že pole je povinné.
TextFieldDisplayName Ovládací prvek Popisek Zobrazí popisný název tohoto pole. Tento název se může lišit od toho, co je ve schématu zdroje dat.
InputText Ovládací prvek Vstupní text Zobrazí počáteční hodnotu pole a umožňuje uživatelům tuto hodnotu změnit.
TextErrorMessage Ovládací prvek Popisek Zobrazí uživateli popisnou chybovou zprávu, pokud dojde k potížím s ověřením. Také zajistí, aby pole mělo hodnotu, pokud je třeba.

K naplnění těchto ovládacích prvků daty je možné tyto vlastnosti řídit z vlastností karty pomocí těchto klíčových vzorců. Poznámka: vzorce odkazují na konkrétní pole. Místo toho všechny informace pocházejí z karty.

Vlastnost ovládacího prvku Vzorec Popis
TextRequiredStar.Visible Parent.Required Hvězdička se zobrazí jenom v případě, že je pole povinné. Vyžaduje se vzorec, který řídíte vy nebo metadata zdroje dat.
TextFieldDisplayName.Text Parent.DisplayName Ovládací prvek textového pole zobrazuje popisný název, který poskytujete vy nebo metadata zdroje dat a který je nastavený na vlastnost DisplayName karty.
InputText.Default Parent.Default Ovládací prvek pro textové zadání původně ukazuje hodnotu pole ze zdroje dat, jak ji poskytuje výchozí hodnota karty.
TextErrorMessage.Text Parent.Error Pokud dojde k potížím ověřování, vlastnost Error karty poskytne příslušnou chybovou zprávu.

Poznámka

Vlastnost Parent.Error je vlastnost pouze pro výstup, kterou nemůžete nastavit pomocí vzorce. Tato vlastnost se proto neobjeví v seznamu vlastností poblíž levého horního rohu nebo na kartě Vlastnosti nebo Pokročilý poblíž pravého okraje. Panel vzorců navrhuje tuto vlastnost, pokud píšete vzorec, který by mohl na vlastnost odkazovat.

Pokud chcete informace z těchto ovládacích prvků získat a vložit je zpátky do zdroje dat, máme následující klíčové vzorce:

Název ovládacího prvku Vzorec Popis
DataCard.DataField "ApproverEmail" Název pole, které uživatel může na této kartě zobrazit a upravit.
DataCard.Update InputText.Text Hodnota, která se má ověřit a vložit zpět do zdroje dat při spuštění příkazu SubmitForm.

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