Płynny znacznik szablonu dla składników kodu

Uwaga

12 października 2022 r. funkcja Portale usługi Power Apps została przekształcona w usługę Power Pages. Więcej informacji: Usługa Microsoft Power Pages jest teraz ogólnie dostępna (blog)
Wkrótce zmigrujemy i scalimy dokumentację funkcji Portale usługi Power Apps z dokumentacją usługi Power Pages.

Struktura składników Power Apps component framework umożliwia profesjonalnym deweloperom i twórcom aplikacji tworzenie składników kodu dla aplikacji opartych na modelu i aplikacji kanwy. Te składniki kodu mogą zapewnić ulepszone środowisko użytkownikom pracującym z danymi w formularzach, widokach i pulpitach nawigacyjnych. Więcej informacji: Używanie składników kodu w portalach

Ważne

Tag szablonu Liquid dla składników kodu wymaga portali w wersji 9.3.10.x lub nowszej.

W tej wersji wprowadziliśmy możliwość dodawania składników kodu za pomocą tagu Liquid template na stronach internetowych oraz włączonych składników za pomocą interfejsu API sieci Web, które są włączone dla składników na poziomie pola w formularzach w portalach.

Składniki kodu można dodawać przy użyciu znacznika szablonu Liquid codecomponent. Klucz do oznaczania składnika kodu, który trzeba załadować, jest przekazywany przy użyciu atrybutu name. Klucz może być identyfikatorem GUID (czyli identyfikatorem składnika kodu) lub nazwą składnika kodu zaimportowanego w Microsoft Dataverse.

Wartości właściwości, których oczekuje składnik kodu, muszą być przekazywane jako para klucz/wartość rozdzielona przez „:” (znak dwukropka), gdzie klucz to nazwa właściwości, a wartość jest wartością ciągu JSON.

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

Na przykład, aby dodać komponent kodu oczekujący parametru wejściowego o nazwie controlValue, użyj następującego znacznika Liquid template:

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

Porada

W tym przykładzie są używane parametry o nazwie controlvalue i controlApiKey, ale składnik może wymagać różnych nazw parametrów.

Można użyć przykładowej kontrolki mapy i spakować je jako rozwiązania do użycia w portalach.

Uwaga

Zasoby opracowane przez społeczność nie są objęte pomocą techniczną firmy Microsoft. Jeśli masz pytania lub problemy z zasobami społeczności, skontaktuj się z ich wydawcą. Przed użyciem tych zasobów należy się upewnić, że spełniają wytyczne dotyczące struktury składników Power Apps component framework i powinny być używane tylko w celach referencyjnych.

Samouczek: Używanie składników kodu na stronach z tagiem szablonu Liquid

W tym samouczku należy skonfigurować portale Power Apps, aby dodawać składnik do strony sieci Web. Następnie odwiedzisz stronę internetową portali i wejdziesz w interakcję z komponentem.

Informacje wstępne

Jeśli używasz przykładowego składnika kodu użytego w tym samouczku, upewnij się, że przykładowe rozwiązania są najpierw zaimportowane do środowiska, zanim przejdziesz. Aby uzyskać informacje na temat importowania rozwiązań, zobacz temat Importowanie rozwiązań.

Wymagania wstępne

Aby uzyskać informacje o wymaganiach wstępnych oraz o obsługiwanych/nieobsługiwanych składnikach kodu w portalach, przejdź do Używanie składników kodu w portalach.

Uwaga

W tym samouczku użyto przykładowego składnika kodu utworzonego za pomocą struktury składnika Power Apps component framework w celu zademonstrowania kontrolki mapy na stronie internetowej. W tym samouczku można także użyć dowolnych istniejących lub nowych składników własnych i dowolnej innej strony sieci Web. W takim przypadku upewnij się, że używasz swojego składnika i strony sieci Web podczas wykonywania kroków opisanych w tym samouczku. Aby uzyskać więcej informacji na temat tworzenia składników kodu, przejdź do Tworzenie pierwszego składnika.

Krok 1. Dodawanie składnika kodu do strony sieci Web z programu Studio

  1. Otwórz portal w  Power Apps portals Studio.

  2. Wybierz pozycję Nowa strona w lewym górnym rogu.

  3. Wybierz opcję Puste.

  4. W okienku właściwości po prawej stronie zaktualizuj nazwę witryny sieciowej. Na przykład „Przeglądarka mapy”.

  5. Zaktualizuj częściowy adres URL. Na przykład „mapviewer”.

  6. Rozwiń Uprawnienia.

  7. Wyłącz opcję Strona dostępna dla wszystkich.

  8. Wybierz role sieci Web, które mają mieć dostęp do tej strony.

  9. Wybierz obszar edytowalny na stronie, aby edytować kod źródłowy Liquid.

  10. Otwórz edytor kodu programu Studio.

  11. Dodaj kontrolkę za pomocą znacznika szablonu Liquid, używając następującej składni:

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

    Porada

    Aby pobrać szczegółowe informacje dotyczące wszystkich zaimportowanych składników i wyszukać nazwę składnika, zobacz interfejs API sieci Web CustomControl.

    Na przykład:

    • Aby wyszukać składnik:

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

    • Aby pobrać parametry wejściowe dla składnika:

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

  12. Zapisz i zamknij edytor kodu.

  13. W prawym górnym rogu wybierz opcję Przeglądaj witrynę internetową.

  14. Na stronie internetowej będzie teraz pokazywana dodana na niej kontrolka.

Następne kroki

Omówienie wykorzystania składników kodu w portalach

Zobacz też

Znacznik encji Codecomponent Dataverse
Znacznik szablonu Codecomponent
Omówienie Power Apps component framework
Utwórz swój pierwszy składnik
Dodawanie składników kodu do kolumny lub tabeli w aplikacjach opartych na modelu
Implementowanie przykładowego składnika internetowego interfejsu API portalu

Uwaga

Czy możesz poinformować nas o preferencjach dotyczących języka dokumentacji? Wypełnij krótką ankietę. (zauważ, że ta ankieta jest po angielsku)

Ankieta zajmie około siedmiu minut. Nie są zbierane żadne dane osobowe (oświadczenie o ochronie prywatności).