Značka šablony Liquid pro komponenty kódu

[Tento článek téma představuje předběžnou dokumentaci a může se změnit.]

Power Apps component framework umožňuje profesionálním vývojářům a tvůrcům aplikací vytvářet komponenty kódu pro modelem řízené aplikace a aplikace plátna. Tyto komponenty kódu mohou poskytnout vylepšené prostředí pro uživatele pracující s daty ve formulářích, pohledech a řídicích panelech. Další informace: Používání komponent kódu na portálech

Důležité

Značka šablony Liquid pro komponenty kódu vyžaduje verzi portálu 9.3.10.x nebo novější.

S touto verzí jsme zavedli schopnost přidávání komponent kódu pomocí značky šablony Liquid na webových stránkách a povolování komponent pomocí webového rozhraní API, které je aktivováno u komponent na úrovni pole ve formulářích portálů.

Komponenty kódu lze přidat pomocí značky šablony Liquid codecomponent. Klíč pro označení komponenty kódu, kterou je třeba načíst, je předán pomocí atributu name. Klíčem může být GUID (což je ID komponenty kódu) nebo název komponenty kódu importované do Microsoft Dataverse.

Hodnoty vlastností, které komponenta kódu očekává, musejí být předány jako pár klíč/hodnota oddělený znakem ":" (dvojtečka), kde klíč je název vlastnosti a hodnota je hodnota řetězce JSON.

{% codecomponent name: <ID or name> <property1:value> <property2:value> %}

Chcete-li například přidat komponentu kódu která očekává vstupní parametr s názvem controlValue, použijte následující značku šablony Liquid:

{% codecomponent name:abc_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value>%}

Tip

Tento příklad používá parametry nazvané controlvalue a controlApiKey, avšak komponenta, kterou používáte, může vyžadovat jiné názvy parametrů.

Můžete použít ukázkový ovládací prvek Mapa a zabalit komponentu kódu jako řešení pro použití s portály.

Poznámka

Zdroje vytvořené komunitou nejsou společností Microsoft podporované. Pokud máte k prostředkům komunity nějaké otázky nebo jste se setkali s problémy, kontaktujte vydavatele příslušného prostředku. Před použitím těchto zdrojů se musíte ujistit, že splňují podmínky Power Apps component framework a měly by být používány pouze pro referenční účely.

Kurz: Používejte komponenty kódu na stránkách se značkou šablony Liquid

V tomto tutoriálu provedete konfiguraci portálů Power Apps pro přidání komponenty na webovou stránku. Poté navštívíte webovou stránku portálu a budete pracovat s komponentou.

Než začnete

Pokud používáte komponentu ukázkového kódu použitou v tomto kurzu, ujistěte se, že nejprve importujete ukázková řešení do prostředí, než začnete. Chcete-li se dozvědět o importu řešení, přejděte na Import řešení.

Předpoklady

Předpoklady a informace o podporovaných/nepodporovaných komponentách kódu v portálech naleznete v části Použití komponent kódu v portálech.

Poznámka

Tento výukový kurz používá ukázkovou komponentu kódu vytvořenou pomocí Power Apps component framework pro demonstraci ovládacího prvku Mapa na webové stránce. Pro tento výukový program můžete také použít jakoukoli existující nebo novou komponentu své vlastní a jakoukoli jinou webovou stránku. V tomto případě se ujistěte, že používáte svou komponentu a webovou stránku, když budete postupovat podle kroků v tomto kurzu. Další informace o tom, jak vytvořit komponenty kódu, najdete v tématu Vytvořte svou první komponentu.

Krok 1. Přidání komponenty kódu na webovou stránku ze Studia

1. Otevřete svůj portál ve Studiu portálů Power Apps.

2. V levém horním rohu vyberte Nová stránka.

3. Vyberte Prázdná.

4. V podokně vlastností na pravé straně aktualizujte název webové stránky. Například "Prohlížeč map".

5. Aktualizujte částečnou adresu URL. Například "mapviewer".

6. Rozbalte Oprávnění

7. Zakažte Stránka dostupná všem.

8. Vyberte webové role, kterým by měl být povolen přístup na tuto stránku.

9. Vyberte upravitelnou oblast na stránce pro úpravu zdrojového kódu Liquid.

10. Otevřete editor kódu studio.

11. Přidejte ovládací prvek se značkou šablony Liquid pomocí následující syntaxe:

    {% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
    

    Tip

    Chcete-li získat podrobnosti o všech importovaných komponentách a vyhledat název komponenty, viz webové rozhraní API CustomControl.

    Příklad:

    • Jak vyhledat komponentu:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$select=ContosoCustomControlName

    • Jak získat vstupní parametry pro komponentu:

      https://contoso.api.crm10.dynamics.com/api/data/v9.2/customcontrols?$filter=name eq 'ContosoCustomControlName' &$select=manifest

12. Uložte a zavřete editor kódu.

13. V pravém horním rohu vyberte Procházet web.

14. Na webové stránce se nyní zobrazí přidaný ovládací prvek.

Další kroky

Přehled: Použít komponenty kódu na portálech

Viz také

Značka entity Codecomponent Dataverse
Značka šablony Codecomponent
Přehled o Power Apps component framework
Vytvořte svou první komponentu
Přidání komponent kódu do sloupce nebo tabulky v modelem řízených aplikacích
Implementace ukázkové komponenty webového rozhraní API portálu

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