Dataverse-objektmærker
Bemærk
Fra 12. oktober 2022 bliver Power Apps-portaler til Power Pages. Flere oplysninger: Microsoft Power Pages er nu generelt tilgængelig (blog)
Vi overfører og fletter snart dokumentationen til Power Apps-portalerne med Power Pages-dokumentationen.
Microsoft Dataverse-objektmærker bruges til at indlæse og få vist Dataverse-data eller bruge andre Power Apps-portalers strukturservicer. Disse mærker er Dataverse-specifikke udvidelser til sproget Liquid.
diagram
Tilføjer et Power Apps-diagram på en webside. Diagrammærket kan tilføjes i feltet Kopiér på en webside eller i feltet Kilde i en webskabelon. Du kan se, hvordan du føjer et Power Apps-diagram til en webside, under Føje et diagram til en webside på portalen.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parametre
Der findes to parametre, der skal angives med diagrammærket: chart id og viewid.
chart id
Visualiserings-id for diagrammet. Du kan hente dette ved at eksportere diagrammet.
viewid
Id'et for tabellen, når den åbnes i visningseditoren.
powerbi
Tilføjer Power BI-dashboards og rapporter på sider. Mærket kan tilføjes i feltet Kopiér på en webside eller i feltet Kilde i en webskabelon. Se, hvordan du føjer en Power BI-rapport eller et dashboard til en webside på en portal, i Føje en Power BI-rapport eller et dashboard til en webside på portalen.
Bemærk
Hvis mærket skal kunne fungere, skal du aktivere Power BI-integration fra administration for Power Apps-portaler. Hvis Power BI-integration ikke er aktiveret, vises dashboardet eller rapporten ikke.
Parametre
Mærket powerbi accepterer følgende parametre:
path
Stien til Power BI-rapporten eller dashboardet. Hvis Power BI-rapporten eller dashboardet er sikker, skal du angive godkendelsestypen.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
authentication_type
Type af godkendelse, der kræves til Power BI-rapport eller dashboard. Gyldige værdier for denne parameter er:
Anonym: Giver mulighed for at integrere Power BI-rapporter, der udgives til internettet. Godkendelsestypen er som standard Anonym. Når du bruger godkendelsestypen Anonym, skal du hente URL-adressen til Power BI-rapporten som beskrevet under Publicere på internettet fra Power BI
AAD: Giver dig mulighed for at dele sikre Power BI-rapporter eller dashboards med Power BI Azure Active Directory-godkendte brugere.
powerbiembedded: Du kan dele sikre Power BI-rapporter eller -dashboards med eksterne brugere, som ikke har licens til Power BI eller Azure Active Directory-godkendelse. Oplysninger om konfiguration af Power BI Embedded Service finder du under Aktivere Power BI Embedded Service service.
Når du tilføjer en sikker Power BI-rapport eller et -dashboard, skal du sørge for, at rapporten eller dashboardet deles med Azure Active Directory- eller Power BI Embedded-portaltjenester.
Bemærk
Der skelnes ikke mellem store og små bogstaver i værdierne for authentication_type-parameteren.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Du kan også filtrere rapporten efter én eller flere værdier. Syntaksen for at filtrere en rapport er:
URL?filter=Table/Field eq 'value'
Lad os eventuelt antage, at du vil filtrere rapporten for at få vist dataene for en kontakt med navnet Bert Hair. Du skal tilføje URL'en med følgende data:
?filter=Executives/Executive eq 'Bert Hair'
Hele koden bliver:
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq 'Bert Hair'" %}
Yderligere oplysninger om filtrering af en rapport: Filtrering af en rapport ved hjælp af parametre for forespørgselsstrengen i URL-adressen
Bemærk
Anonym rapport understøtter ikke filtrering.
Du kan også oprette en dynamisk sti ved hjælp af Liquid-variablen capture som angivet nedenfor:
{% capture pbi_path %}https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01?filter=Executives/Executive eq '{{user.id}}'{% endcapture %}
{% powerbi authentication_type:"AAD" path:pbi_path %}
Yderligere oplysninger om Liquid-variablen: Variable mærker
tileid
Viser det angivne felt på dashboardet. Du skal angive id'et for feltet.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/dashboards/00000000-0000-0000-0000-000000000001" tileid:"00000000-0000-0000-0000-000000000002" %}
roller.
Roller, der er tildelt til Power BI-rapporten. Denne parameter kan kun bruges, når parameteren authentication_type er angivet til powerbiembedded.
Hvis du har defineret roller i Power BI og tildelt dem til rapporter, skal du angive de relevante roller i powerbi Liquid-mærket. Du kan bruge roller til at filtrere de data, der skal vises i en rapport. Du kan angive flere roller adskilt af et komma. Du kan finde flere oplysninger om definition af roller i Power BI under Rækkeniveausikkerhed (RLS) med Power BI.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:"Region_East,Region_West" %}
Hvis du har tildelt en rolle til en Power BI-rapport, og du ikke har angivet parameteren roller i Liquid-mærket, eller du ikke har angivet en rolle i parameteren, vises der en fejlmeddelelse.
Tip
Hvis du vil bruge de webroller, der er defineret i portalen som Power BI-roller, kan du definere en variabel og tildele webroller til den. Derefter kan du bruge den definerede variabel i Liquid-mærket.
Lad os antage, at du har defineret to webroller som Region_East og Region_West på din portal. Du kan joinforbinde dem ved hjælp af koden: {% assign webroles = user.roles | join: ", " %}
I kodestykket ovenfor er webroles en variabel, og webrollerne Region_East og Region_West gemmes i den.
Brug variablen webroles på følgende måde i Liquid-mærket:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}
editable
Gengiver en given Power Apps-portalers CMS-objekt som redigerbart på portalen for brugere med indholdsredigeringstilladelser til det pågældende objekt. Redigerbare objekter omfatter side, kodestykker og weblinks.
{% editable page 'adx_copy' type: 'html', title: 'Page Copy', escape: false, liquid: true %}
{% editable snippets Header type: 'html' %}
<!--
An editable web link set required a specific DOM structure, with
certain classes on the containing element, as demonstrated here.
-->
{% assign primary_nav = weblinks[Primary Navigation] %}
{% if primary_nav %}
<div {% if primary_nav.editable %}class=xrm-entity xrm-editable-adx_weblinkset{% endif %}>
<ul>
<!-- Render weblinks... -->
</ul>
{% editable primary_nav %}
</div>
{% endif %}
Parametre
Den første parameter, der kan redigeres, er det redigerbare objekt, f.eks. et weblinksæt, uddrag eller den aktuelle side. Den anden, valgfrie parameter er for at angive et navn på en attribut eller en nøgle i dette objekt, som skal vises og redigeres. Denne værdi kan for eksempel være navnet på en tabelattribut eller et kodestykke.
Efter disse indledende parametre understøtter mærket en række valgfri navngivne parametre.
class
Angiver en class-attributværdi for det rodelement, der gengives af dette mærke.
default
En standardværdi, der skal gengives i det tilfælde, at det redigerbare element ikke har nogen værdi.
escape
En boolesk værdi, der angiver, om en værdi, der gengives af dette mærke, er HTML-kodet. Denne værdi er som standard falsk.
liquid
En boolesk værdi, der angiver, om en Liquid-skabelonkode fundet i tekstværdien, som gengives af dette mærke, bliver behandlet. Denne værdi er som standard sand.
tag
Navnet på de HTML-beholdermærker, der gengives af dette mærke. Dette mærke gengiver div-elementer som standard. Generelt anbefales det at vælge mellem div eller span som værdi for denne parameter.
title
Angiver en etiket for denne redigerbare vare i grænsefladen til indholdsredigering. Hvis ingen er angivet, oprettes der automatisk et brugervenligt navn.
type
En strengværdi, der angiver, hvilken type redigeringsgrænseflade der skal vises, til redigerbare tekstværdier. Gyldige værdier for denne parameteren er html eller text. html er standard.
entitylist
Indlæser en bestemt liste efter navn eller id. Der er derefter adgang til egenskaberne for listen ved hjælp af et entitylist-objekt, som er tilgængeligt inden for mærkeblokken. For at gengive de faktiske resultatposter på listen kan du bruge entityview-mærket i blokken.
Hvis listen indlæses korrekt, gengives indholdet i blokken. Hvis listen ikke kan findes, gengives blokindholdet ikke.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Som standard får entitylist-objektet variabelnavnet entitylist. Der kan eventuelt anvendes et andet variabelnavn.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parametre
Angiv kun en af følgende: id, name eller key for at vælge den liste, der skal indlæses.
id
Indlæser en liste efter GUID-id. id skal være en streng, der kan parses som et GUID.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Strenge med bogstavelig GUID-værdi bruges normalt ikke. I stedet angives id ved hjælp af en GUID-egenskab for en anden variabel.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
name
Indlæser en liste efter navn.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
key
Indlæser en liste efter id eller navn. Hvis den angivne nøgleværdi kan parses som et GUID, indlæses listen efter id. Ellers bliver den indlæst efter navn.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
En Power Apps-heltalssprogkode til at vælge listens oversatte etiketter, som skal indlæses. Hvis der ikke er angivet en language_code, bruges standardsproget i portalprogrammets Power Apps-forbindelse.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Indlæser en given Power Apps-visning efter navn eller id. Egenskaberne for viste kolonnemetadata, sideinddelte resultatposter osv. for visningen ߝ kan derefter åbnes ved hjælp af et entityview-objekt, som vil være tilgængeligt inden for mærkeblokken.
Hvis visningen indlæses korrekt, gengives indholdet i blokken. Hvis visningen ikke kan findes, gengives blokindholdet ikke.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Som standard får entityview-objektet variabelnavnet entityview. Der kan eventuelt anvendes et andet variabelnavn.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Hvis entityview er indlejret i en entitylist-blok, arver den standardkonfigurationen (resultatets sidestørrelse, filterindstillinger osv.) fra listen. Hvis der ikke leveres til nogen id- eller navneparametre til entityview, indlæses standardvisningen fra den omsluttende entitylist.
{% entitylist id:page.adx_entitylist.id %}
{% entityview %}
Loaded default view of the list associated with the current page, with {{ entityview.total_records }} total records.
{% endentityview %}
{% endentitylist %}
Parametre
Angiv enten id eller logical_name sammen med name for at vælge den Power Apps-visning, der skal indlæses. Hvis ingen angives, og entityview-mærket er indlejret i et entitylist-mærke, indlæses standardvisningen af den omsluttende entitylist.
id
id skal være en streng, der kan parses som et GUID.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
Strenge med bogstavelig GUID-værdi bruges normalt ikke. I stedet angives id ved hjælp af en GUID-egenskab for en anden variabel.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
Det logiske navn for Power Apps-objektet i den visning, der skal indlæses. Skal bruges i kombination med name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
name
Power Apps-navnet for den visning, der skal indlæses. Skal bruges i kombination med logical_name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Angiver, om visningsresultaterne skal filtreres efter bruger eller firma. Skal have strengværdien bruger eller firma.
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ofte indstilles denne parameter baseret på en anmodning.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Angiver listens metadatafilterudtryk, som du kan filtrere visningsresultater efter. Denne parameter er kun gyldig, når entityview anvendes i kombination med entitylist. I de fleste tilfælde indstilles denne parameter på basis af en anmodning.
{% entitylist id:page.adx_entitylist.id %}
{% entityview id:request.params.view, metafilter:request.params.mf %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
{% endentitylist %}
order
Angiver et sorteringsudtryk til rangering af visningsresultater. Et sorteringsudtryk kan indeholde et eller flere logiske navne for objektattributter efterfulgt af sorteringsrækkefølgen ASC eller DESC.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ofte indstilles denne parameter baseret på en anmodning.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page
Angiver den siden med visningsresultater, der skal indlæses. Hvis denne parameter ikke angives, indlæses den første side med resultater.
Der skal overføres enten en heltalsværdi eller en streng, der kan parses som et heltal, til denne parameter. Hvis du har angivet en værdi for denne parameter, men værdien er null, eller på anden måde ikke kan parses som et heltal, indlæses den første side med resultater.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ofte indstilles denne parameter baseret på en anmodning.
{% entityview id:request.params.view, page:request.params.page %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page_size
Angiver antallet af resultater, der skal indlæses for den aktuelle resultatside. Hvis ingen værdi er angivet for denne parameter, og entityview bruges i en entitylist-blok, bruges listens sidestørrelse. Hvis det ikke er inden for en entitylist-blok, bruges en standardværdi på 10.
Der skal overføres enten en heltalsværdi eller en streng, der kan parses som et heltal, til denne parameter. Hvis du har angivet en værdi for denne parameter, men værdien er null, eller på anden måde ikke kan parses som et heltal, bruges standardsiden.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ofte indstilles denne parameter baseret på en anmodning.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
search
Angiver et søgeudtryk, som visningsresultater kan filtreres ud fra. Simple søgeudtryk med nøgleord vil filtrere efter, om attributter begynder med nøgleordet. Jokertegn * kan også indgå i udtrykket.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Ofte indstilles denne parameter baseret på en anmodning, så søgefilteret kan indstilles baseret på brugerinput.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
En Power Apps-sprogkode i heltal, der bruges til at vælge de oversatte etiketter i objektvisningen (navne på kolonneoverskrifter osv.), som skal indlæses. Hvis der ikke er angivet en language_code, bruges standardsproget i portalprogrammets Power Apps-forbindelse.
Hvis entityview bruges i en entitylist-blok, arver entityview dens sprogkodekonfiguration fra entitylist.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Udfører en forespørgsel på portalens søgeindeks. De matchende resultater kan derefter åbnes ved hjælp af et searchindex, som er tilgængeligt i mærkeblokken.
{% searchindex query: 'support', page: params.page, page_size: 10 %}
{% if searchindex.results.size > 0 %}
<p>Found about {{ searchindex.approximate_total_hits }} matches:</p>
<ul>
{% for result in searchindex.results %}
<li>
<h3><a href={{ result.url | escape }}>{{ result.title | escape }}</a></h3>
<p>{{ result.fragment }}</p>
</li>
{% endfor %}
</ul>
{% else %}
<p>Your query returned no results.</p>
{% endif %}
{% endsearchindex %}
<style>
.highlight {background-color: #FFFCAC;}
</style>
Som standard får søgeindeksobjektet variabelnavnet searchindex. Der kan eventuelt anvendes et andet variabelnavn.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parametre
Mærket searchindex accepterer følgende parametre.
query
Forespørgslen til at matche resultater. Denne parameter er beregnet til at acceptere den brugerspecifikke del af indeksforespørgslen (hvis relevant).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Ofte indstilles denne parameter baseret på en anmodning.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
Denne parameter understøtter Lucene Query Parser-syntaksen.
filter
En forespørgslen yderligere, som bruges til at matche resultater. Denne parameter er beregnet til at acceptere et udviklerangivet filter til resultater, hvis det ønskes.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
Denne parameter understøtter Lucene Query Parser-syntaksen.
Bemærk
Forskellen mellem filter og query er, at mens begge accepterer Lucene Query Parser-syntaksen, så er query beregnet til i højere grad at acceptere, hvordan denne syntaks parses ߝ, fordi det forventes, at de fleste slutbrugere ikke kender til denne syntaks. Så hvis parsing af query i henhold til denne syntaks mislykkes, escapes hele forespørgslen og sendes som forespørgselsteksten. filter på den anden side skal fortolkes strengt, og returnerer en fejl i tilfælde af en ugyldig syntaks.
logical_names
Power Apps-objektets logiske navne, som matchende resultater begrænses til, f.eks. en kommasepareret streng. Hvis der ikke er angivet noget, returneres alle matchende objekter.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
page
Søgeresultatsiden, som skal returneres. Hvis den ikke er angivet, returneres den første side (1).
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Ofte indstilles denne parameter baseret på en anmodning.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
Størrelsen på den søgeresultatside, som skal returneres. Hvis værdien ikke er angivet, bruges en standardstørrelse på 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Gengiver en Power Apps-konfigureret basisformular fuldstændigt efter navn eller id.
Bemærk
entityform-mærket er kun tilgængeligt til brug i indhold, der gengives i en webskabelon–baseret sideskabelon. Forsøg på at bruge mærket i en omskrivningsbaseret sidesideskabelon gengiver ikke noget. Du kan kun gengive et enkelt entityform- eller webform-mærke pr. side. entityform- eller webform-mærker efter det første gengives ikke.
{% entityform name: 'My Basic Form' %}
Parametre
name
Navnet på den basisformular, du vil indlæse.
{% entityform name:My Basic Form %}
webform
Gengiver en Power Apps-konfigureret formular med flere trin fuldstændigt efter navn eller id. Webform-mærket er kun tilgængeligt til brug i indhold, der gengives i en webskabelon–baseret sideskabelon. Forsøg på at bruge mærket i en omskrivningsbaseret sidesideskabelon gengiver ikke noget. Du kan kun gengive et enkelt entityform- eller webform-mærke pr. side. entityform- eller webform-mærker efter det første gengives ikke.
{% webform name: 'My Multistep Form' %}
Parametre
name
Navnet på den formular med flere trin, du vil indlæse.
{% webform name:My Multistep Form %}
codecomponent
Giver dig mulighed for at indlejre kodekomponenter ved hjælp af et Liquid-mærke. Du kan f.eks. føje et brugerdefineret kontrolelement til en tilknytningsvisning til en webside.
Vigtigt
- Dette er en eksempelvisningsfunktion.
- Eksempelvisningsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så kunderne kan få tidlig adgang og give feedback.
Parametre
name
Id eller van for kodekomponenten.
egenskab
Værdierne for de egenskaber, kodekomponenten forventer, skal overføres som et nøgle/værdipar adskilt af ":" (kolontegn), hvor nøglen er egenskabsnavnet, og værdien er strengværdien JSON.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Bemærk
De krævede egenskaber kan være forskellige, afhængigt af den komponent du vælger.
Se Bruge kodekomponenter til Liquid-skabelonmærke.
Se også
Mærker for kontrolflow
Gentagelsesmærker
Variabelmærker
Skabelonmærker
Bemærk
Kan du fortælle os om dine sprogpræferencer for dokumentation? Tag en kort undersøgelse. (bemærk, at denne undersøgelse er på engelsk)
Undersøgelsen tager ca. syv minutter. Der indsamles ingen personlige data (erklæring om beskyttelse af personlige oplysninger).
Feedback
Kommer snart: I hele 2024 udfaser vi GitHub-problemer som feedbackmekanisme for indhold og erstatter det med et nyt feedbacksystem. Du kan få flere oplysninger under: https://aka.ms/ContentUserFeedback.
Indsend og få vist feedback om