Код құрамдастарына арналған Liquid үлгі тегі

Ескерім

2022 жылдың 12 қазанынан бастап күшіне енеді, Power Apps порталдары — Power Pages. Қосымша ақпарат: Microsoft Power Pages енді жалпыға қолжетімді (блог)
Жақында Power Apps порталдары құжаттамасын Power Pages құжаттамасымен көшіреміз және біріктіреміз.

Power Apps component framework жүйесі кәсіби әзірлеушілер мен бағдарлама жасаушыларына модельге негізделген және кенеп бағдарламалары үшін код құрамдастарын жасауға мүмкіндік береді. Бұл код құрамдастарына пайдаланушыларға пішіндер, көріністер және бақылау тақталарындағы деректермен жұмыс істеу үшін кеңейтілген тәжірибе ұсына алады. Қосымша ақпарат: Порталдарда код компоненттерін пайдалану

Маңызды

Код құрамдастарына арналған Liquid үлгі коды үшін 9.3.10.x немесе одан кейінгі порталдар нұсқасы қажет.

Осы шығарылыммен біз веб-беттерде Liquid үлгі тегін пайдалану арқылы код құрамдастарын қосуды түсіндірдік және порталдар ішіндегі пішіндердегі өріс деңгейіндегі құрамдастар үшін қосылған Web API интерфейсін пайдаланатын құрамдастарды қостық.

Код құрамдастарын codecomponent Liquid үлгі тегін пайдалану арқылы қосуға болады. Жүктелетін код құрамдасын белгілеу кілті name төлсипатын пайдалану арқылы беріледі. Кілт GUID (код компонентінің идентификаторы болып табылады) немесе Microsoft Dataverse‑ке импортталған код компонентінің атауы болуы мүмкін.

Код компонентіне керек сипаттар мәндері «**:**» (қос нүкте белгісі) арқылы бөлінген кілт/мән ретінде берілуі керек, мұндағы кілт сипат атауы және мән JSON жол мәні болып табылады.

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

Мысалы, controlValue деп аталатын енгізу параметрін күтетін код құрамдасын қосу үшін келесі Liquid үлгі тегін пайдаланыңыз:

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

Шайпұл

Бұл мысалда controlvalue және controlApiKey деп аталатын параметрлер пайдаланылады, дегемен пайдаланатын құрамдас басқа параметр атауларын қажет етуі мүмкін.

Үлгі картасын басқару элементін пайдалануға және оларды порталдармен пайдалану үшін код құрамдасын шешімдер ретінде бумалауға болады.

Ескерім

Қауымдастық арқылы жасалған ресурстарға Microsoft арқылы қолдау көрсетілмейді. Егер сізде қауымдастық ресурстарына қатысты сұрақтар немесе мәселелер туындаса, ресурс жариялаушысымен байланысыңыз. Бұл ресурстарды пайдаланбас бұрын, олардың Power Apps component framework нұсқауларына сай келетініне және тек анықтамалық мақсат үшін пайдаланылатындығына көз жеткізу керек.

Оқулық: Liquid үлгісі тегі бар беттерде код құрамдастарын пайдалану

Бұл оқулықта құрамдасты веб-бетке қосу үшін Power Apps порталдарын конфигурациялайсыз. Содан кейін порталдардың веб-бетіне өтіп, құрамдаспен әрекеттесетін боласыз.

Бастаудан бұрын

Осы оқулықта пайдаланылған үлгі код құрамдасын пайдаланатын болсаңыз, бастамас бұрын алдымен үлгі шешімдерді ортаға импорттағаныңызға көз жеткізіңіз. Шешімді импорттау туралы білу үшін Шешімдерді импорттау бөліміне өтіңіз.

Алғышарттар

Алғышарттар үшін және порталдардағы қолдау көрсетілетін/қолдау көрсетілмейтін код құрамдастарын білу үшін Порталдарда код құрамдастарын пайдалану бөліміне өтіңіз.

Ескерім

Бұл оқулық веб-беттегі картаны басқаруды көрсету үшін Power Apps component framework жүйесін пайдаланып жасалған үлгі коды компонентін пайдаланады. Сондай-ақ кез келген бар немесе жаңа құрамдасты және осы оқулық үшін кез келген басқа веб-бетті пайдалана аласыз. Бұл жағдайда осы оқулықтағы қадамдарды орындаған кезде құрамдас пен веб-бетті пайдалануды қамтамасыз етіңіз. Код құрамдастарын жасау жолы туралы қосымша ақпарат алу үшін Алдымен құрамдас жасау бөліміне өтіңіз.

1-қадам. Код құрамдасын студиядағы веб-бетке қосу

1. Порталыңызды Power Apps portals Studio бағдарламасында ашыңыз.

2. Жоғарғы сол жақ бұрышта Жаңа бетті таңдаңыз.

3.  Бос.

4. Оң жақ сипат тақтасында веб-бет атауын жаңартыңыз. Мысалы, "Карта қарау құралы."

5. Жартылай URL мекенжайын жаңартыңыз. Мысалы, "mapviewer."

6. Рұқсаттар тармағын кеңейтіңіз.

7. Бет барлығына қолжетімді параметрін өшіріңіз.

8. Осы бетке кіруге рұқсат етілетін веб-рөлдерді таңдаңыз.

9. Liquid бастапқы кодын өңдеу үшін бетте өңделетін аймақты таңдаңыз.

10. Studio кодты өңдегішті ашыңыз.

11. Келесі синтаксисті пайдаланып Liquid үлгі тегі бар басқару элементін қосыңыз:

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

    Шайпұл

    Барлық импортталған құрамдастардың мәліметтерін шығарып алу және құрамдас атауын іздеу үшін CustomControl Web API интерфейсін қараңыз.

    Мысалы:

    • Құрамдасты іздеу үшін:

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

    • Құрамдас үшін кіріс параметрлерін алу үшін:

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

12. Код өңдегішін сақтап, жабыңыз.

13. Жоғарғы оң жақ бұрышта Веб-сайтты шолу тармағын таңдаңыз.

14. Веб-бет енді оған қосылған басқару элементін көрсетеді.

Келесі қадамдар

Шолу: Порталдарда код құрамдастарын пайдалану

Сонымен қатар қараңыз

Codecomponent Dataverse нысан тегі
Codecomponent Үлгі тегі
Power Apps component framework шолуы
Бірінші құрамдасты жасау
Код құрамдастарын модельге негізделген бағдарламалардағы бағанға немесе кестеге қосу
Үлгі порталдың веб API құрамдасын іске асыру

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).