Liquid ознака предлошка за компоненте кода

Напомена

Од 12. октобра 2022. 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 (што је ID компоненте кода) или назив компоненте кода увезене у 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 порталима Студио.

2. У горњем левом углу изаберите ставку Нова  страница.

3. Изаберите опцију  Празно.

4. У десном окну својстава ажурирајте назив веб-странице. На пример, „Приказивач мапа“.

5. Ажурирајте делимичан URL. На пример, „mapviewer“.

6. Проширите Дозволе.

7. Онемогућите страницу која је доступна свима.

8. Изаберите веб-улоге којима треба да буде дозвољен приступ овој страници.

9. Изаберите област која се може уређивати на страници да бисте уређивали Liquid изворни кôд.

10. Отворите уређивач кода програма Студио.

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
Креирање прве компоненте
Додајте компоненте кода у колону или табелу у апликацијама заснованим на моделу
Примена пробне компоненте Web API-ја за портале

Напомена

Можете ли нам рећи о својим жељеним поставкама језика у документацији? Испуните кратку анкету. (имајте на уму да је ова анкета на енглеском језику)

Анкета ће трајати око седам минута. Не прикупљају се лични подаци (изјава о приватности).