Použití jazyka Power Fx na vlastní stránce pro modelem řízenou aplikaci

Tento článek popisuje, jak běžné funkce Microsoft Power Fx fungují odlišně v samostatných aplikacích plátna a na vlastní stránce. Je to proto, že vlastní stránka je součástí modelem řízené aplikace. Ostatní vzorce Microsoft Power Fx se nadále chovají stejným způsobem.

Důležité

Vlastní stránky jsou novou funkcí s výraznými změnami a momentálně má řadu známých omezení, které jsou uvedeny v části Známé problémy s vlastními stránkami.

Přidání oznámení na vlastní stránku

Oznámení lze uživatelům vlastní stránky zobrazit zavoláním funkce Notify. Když se zobrazí zprávy oznámení, jsou ukotveny nad výchozí stránkou, aby zůstaly viditelné, dokud nebudou deaktivovány. Pokud je zadán časový limit, zpráva oznámení zmizí po uplynutí časového limitu. Doporučujeme nepoužívat časový limit 10, protože tento již není považován za časový limit. Další informace: Funkce Notify.

Notify( "Custom page notification message" )

Notify( "Custom page notify warning message", NotificationType.Warning )

Přechod na vlastní stránku

Tato sekce obsahuje příklady přechodu z formuláře modelem řízené aplikace na vlastní stránku, přechodu z vlastní stránky na jiné vlastní stránky nebo formulář modelem řízené aplikace pomocí Power Fx.

Přechod z vlastní stránky

Funkce Navigate umožňuje uživatelům přecházet buď z modelem řízených aplikací nebo z vlastních stránek. Tato funkce je použitelná pouze v případě, že je vlastní stránka spuštěna v modelem řízené aplikaci. Během vytváření vlastních stránek nebo náhledu v návrháři plátna nemá tato funkce žádný účinek.

Přechod na jinou vlastní stránku

Chcete-li přejít z jedné vlastní stránky na jinou, jako první parametr předejte zobrazované jméno vlastní stránky.

Navigate( CustomPage2  )

Přechod do výchozího zobrazení tabulky

Chcete-li přejít do výchozího zobrazení tabulky, předejte název tabulky jako první parametr.

Navigate( Accounts )

Přechod do specifického systémového zobrazení tabulky

Chcete-li přejít na konkrétní systémové zobrazení tabulky, předejte identifikátor GUID zobrazení.

Navigate( 'Accounts (Views)'.'My Active Accounts' )

Přechod do výchozího formuláře tabulky

Chcete-li přejít na výchozí formulář tabulky, jako první parametr předejte záznam.

Navigate( Gallery1.Selected )

Přechod na konkrétní formulář tabulky

Chcete-li předat záznam Dataverse do konkrétního formuláře, předejte název formuláře v atributu Stránka druhého parametru.

Navigate( 
  AccountGallery.Selected, 
  { Page: 'Accounts (Forms)'.Account  } )

Přechod na konkrétní vlastní stránku se vstupem záznamu

Chcete-li předat záznam Dataverse na vlastní stránku, předejte název vlastní stránky do atributu Stránka druhého parametru.

Navigate( 
  AccountGallery.Selected, 
  { Page: 'Account Record Page'  } )

Na cílové vlastní stránce je záznam načten pomocí funkce Param pro získání hodnot etn a id.

Níže je uveden příklad načtení záznamu do ovládacího prvku EditForm.

AccountEditForm.DataSource = Accounts
AccountEditForm.Item = 
  LookUp( Accounts, accountid = GUID( Param("id") ) )

Přechod do výchozího formuláře tabulky v režimu vytvoření

Chcete-li přejít na výchozí formulář tabulky v režimu vytvoření, předejte záznam Dataverse vytvořený z funkce Defaults. Tím se otevře výchozí formulář s novým záznamem. Funkce Defaults převezme název tabulky k vytvoření záznamu.

Navigate( Defaults( Accounts ) )

Přechod na výchozí formulář tabulky v režimu vytváření s výchozím polem

Chcete-li přejít na nový záznam s některými výchozími poli, použijte funkci Patch pro nastavení polí na výchozí záznam pro tabulku.

Navigate(
    Patch(
        Defaults(Accounts), { 'Account Name': "My company", Phone: "555-3423" } ) 
  )

Přechod zpět na předchozí stránku nebo zavření dialogového okna

Chcete-li přejít zpět na poslední stránku nebo zavřít dialogové okno, na vlastní stránce se zavolá funkce Back. Funkce Back zavře aktuální stránku a vrátí se k poslední modelem řízené aplikaci nebo vlastní stránce v modelem řízené aplikaci. Pokud má vlastní stránka více obrazovek, podívejte se na článek Přechod zpět, když vlastní stránka obsahuje více obrazovek.

Back( )

Přechod zpět, když vlastní stránka obsahuje více obrazovek

Výchozí konfigurace vlastní stránky je jedna obrazovka. V tomto případě volání funkce Back zavře vlastní stránku, pokud není vlastní stránka poslední stránkou v zásobníku stránek v modelem řízené aplikaci. Poslední stránka zůstává otevřená.

Tvůrce aplikací může na vlastní stránce povolit více obrazovek. Ty jsou považovány za ovládací prvky celé stránky v rámci vlastní stránky, které lze skládat. Otevření vlastní stránky nijak nespecifikuje obrazovku, kterou chcete použít. Pokud vlastní stránka obsahuje více obrazovek, tvůrce se musí postarat o jejich naskládání. Volání funkce Navigate na obrazovce přidá na obrazovku zásobník stránek s vlastní stránkou. Každé volání funkce Back odebere obrazovku ze zásobníku obrazovek. Pokud je v zásobníku obrazovek pouze jedna obrazovka, vlastní stránka se zavře.

Povolení více obrazovek

Ve výchozím nastavení vlastní stránka používá jednu obrazovku, která podporuje rozdělení aplikace způsobem jedna obrazovka na stránku. To lze přepnout povolením Nastavení > Zobrazení > Povolit více obrazovek.

Funkce Confirm

Funkce Confirm zobrazí v horní části aktuální obrazovky dialogové okno. K dispozici jsou dvě tlačítka: tlačítko pro potvrzení a tlačítko pro zrušení, které se v lokalizované verzi zobrazí jako „OK“ a „Zrušit“. Uživatel jej musí potvrdit nebo zrušit, než se dialogové okno zavře a funkce vrátí hodnotu. Kromě tlačítka dialogového okna lze tlačítko zrušit vybrat také klávesou Esc nebo jinými gesty, která jsou specifická pro platformu.

Parametr Message se zobrazí v těle dialogového okna. Pokud je zpráva velmi dlouhá, bude buď zkrácena, nebo se zobrazí posuvník.

Pomocí parametruOptionsRecord zadáte možnosti pro dialogové okno. Ne všechny možnosti jsou k dispozici na každé platformě a jsou zpracovány na základě nejlepšího úsilí.

Poznámka

Možnosti v níže uvedené tabulce nejsou aktuálně k dispozici v aplikacích plátna.

Pole možnosti	Popis
ConfirmButton	Text, který se má zobrazit na tlačítku pro potvrzení nahrazující výchozí lokalizovaný text „OK“.
CancelButton	Text, který se má zobrazit na tlačítku pro zrušení nahrazující výchozí lokalizovaný text „Zrušit“.
Title	Text, který se zobrazuje jako název dialogového okna. K zobrazení tohoto textu lze použít větší, tlustší písmo než písmo zprávy. Pokud je tato hodnota velmi dlouhá, bude zkrácena.
Subtitle	Text, který se zobrazuje jako titulek dialogového okna. K zobrazení tohoto textu lze použít větší, tlustší písmo než písmo zprávy. Pokud je tato hodnota velmi dlouhá, bude zkrácena.

Confirm vrátí true, pokud bylo vybráno tlačítko pro potvrzení, v opačném případě vrátí false.

Syntaxe

Confirm( Message [, OptionsRecord ] )

• Message – povinné. Zpráva, která se zobrazí uživateli.
• OptionsRecord – volitelné. Poskytněte rozšířené možnosti pro dialogové okno. Ne všechny možnosti jsou k dispozici na každé platformě a jsou zpracovány na základě nejlepšího úsilí. V současné době nejsou v aplikacích plátna podporovány žádné z těchto možností.

Známé problémy

• Funkce Navigate nepodporuje otevření modelu nebo vlastní stránky v dialogu. Veškerá navigace z vlastní stránky se otevře uvnitř.
• Funkce Navigace nepodporuje otevírání:
  • Kolekce řídicích panelů nebo konkrétního řídicího panelu.
  • Konkrétního formuláře modelem řízené aplikace.
• Vlastní stránka se může otevřít pouze na aktuální kartě aplikace aktuální relace v modelem řízené aplikaci s více relacemi.

Viz také

Navigace na vlastní stránku pomocí klientského API

Přehled vlastní stránky modelem řízené aplikace