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

Článek
04/09/2023

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

Panel zpráv s informačním oznámením vlastní stránky

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

Panel zpráv s varovným oznámením vlastní stránky

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í jazyka 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 )

Důležité

Před publikováním a testováním se ujistěte, že jste na vlastní stránku přidali tabulku účtů Microsoft Dataverse.

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.

Povolení více obrazovek na vlastní stránce

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

Sdílet prostřednictvím