Dataverse Liquid-taggar
Microsoft Dataverse Liquid-taggar används för att läsa in och visa Dataverse-data, eller för att använda andra Power Pages-ramverkstjänster. Dessa taggar är Dataverse-specifika tillägg till Liquid-språket.
Diagram
Lägger till en Power Apps modellbaserad app till en webbsida. Diagramtaggen kan läggas till i fältet Kopiera på en webbsida i fältet Källa på en webbmall. Anvisningar för hur du lägger till ett Power Apps modellbaserat appdiagram till en webbsida, se Lägga till ett diagram på en webbsida i Power Pages.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parametrar
Det finns två parametrar som ska tillhandahållas med diagramtaggen: diagram-id och viewid.
diagram-id
Visualiserings-ID för diagrammet. Du kan få ID genom att exportera diagrammet.
viewid
ID för tabellen som öppnades i vyredigeraren.
powerbi
Lägger till Power BI-instrumentpaneler och rapporter på sidor. Etiketten kan läggas till i fältet Kopiera på en webbsida eller i fältet Källa på en webbmall. För steg för att lägga till en Power BI-rapport eller instrumentpanel till en webbsida i Power Pages, se Lägg till Power BI-rapport eller instrumentpanel till en webbsida i Power Pages.
Kommentar
För att etiketten ska fungera måste du aktivera Power BI-integration från Power Pages nav i Power Platform administratörscenter. Om Power BI-integration inte är aktiverat visas inte instrumentpanelen eller en rapport.
Parametrar
Etiketten powerbi godkänner följande parametrar:
sökväg
Sökvägen till Power BI-rapporten eller instrumentpanelen. Om Power BI-rapporten eller instrumentpanelen är säker, måste du ange önskad autentiseringstyp.
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
autentiseringstyp.
Typ av verifiering som krävs för Power BI-rapporten eller instrumentpanelen. Giltiga värden för parametern är:
Anonym: gör det möjligt att bädda in publicera till Power BI-webbrapporter. Standardautentiseringstypen är anonym. När autentiseringstypen används som anonym måste du skaffa Power BI-rapport-URL:en enligt beskrivningen i: publicera på webben från Power BI
AAD: gör att du kan dela säkra Power BI-rapporter och instrumentpaneler till Power BI Microsoft Entra ID autentiserade användare.
powerbiembedded: Gör att du kan dela säkra Power BI-rapporter och -instrumentpaneler till externa användare som inte har någon Power BI-licens eller Microsoft Entra-autentiseringskonfiguration. Information om hur du installerar Power BI Embedded-tjänsten finns i Aktivera Power BI Embedded-tjänsten.
När du lägger till den säkra Power BI-rapporten eller instrumentpanel säkerställer att denna delas med Power Pages Microsoft Entra eller Power BI Embedded-tjänster.
Kommentar
Värdena för parametern authentication_type är skiftlägeskänsliga.
{% powerbi authentication_type:"AAD" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Du kan även filtrera rapporten på ett eller flera värden. Syntaxen för att filtrera en rapport är:
URL?filter=Tabell/Fält eq 'värde'
Anta att du vill filtrera rapporten för att visa data för en kontakt med namnet Bert Hair. Du måste lägga till URL:en med följande data:
?filter=Chefer/chef eq 'Bert Hair'
Den fullständiga koden är:
{% 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'" %}
Mer information om filtrering av en rapport: Filtrera en rapport med hjälp av frågesträngsparametrar i URL
Kommentar
Anonym rapporten stöder inte filtrering.
Du kan också skapa en dynamisk sökväg med hjälp av den flytande variabeln capture :
{% 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 %}
Mer information om flytande variabel: Variabeltaggar
tileid
Visar den angivna panelen på instrumentpanelen. Du måste ange ett ID för panelen.
{% 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 som tilldelats Power BI-rapporten. Den här parametern fungerar endast om parametern authentication_type har värdet powerbiembedded.
Om du har definierat roller i Power BI och tilldelat dem till rapporter måste du ange lämpliga roller i PowerBI-koden för Liquid-tagg. Med roller kan du filtrera data som ska visas i en rapport. Du kan ange flera roller avgränsade med ett kommatecken. Mer information om hur du definierar roller i Power BI finns i i säkerhet på radnivå (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" %}
Om du har tilldelat en roll till en Power BI-rapport och angav inte parametern roller i Liquid-taggen eller inte angav någon roll i parametern, visas ett felmeddelande.
Dricks
Om du vill använda de webbroller som definierats i webbplatsen som Power BI-roller kan du definiera en variabel och tilldela webbroller till den. Därefter kan du använda den definierade variabeln i Liquid-taggen.
Anta att du har definierat två webbroller som Region_East och Region_West i webbplats. Du kan koppla dem med hjälp av koden: {% assign webroles = user.roles | join: ", " %}
I kodavsnittet ovan är webroles en variabel och webbrollerna Region_East och Region_West kommer att lagras i den.
Använd variabeln webroles enligt följande i Liquid-taggen:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000000/ReportSection2" roles:webroles%}
redigerbart
Gör ett visst Power Pages CMS-objekt redigerbart i portalen för användare med behörighet för innehållsredigering för det objektet. Redigerbara objekt inkluderar sida, kodfragment och webblänkar.
{% 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 %}
Parameters
Den första parametern som angavs som redigerbar är det redigerbara objektet, t.ex. en webblänksuppsättning, ett kodavsnitt eller den aktuella sidan. Den valfria andra parametern är att ange ett attributnamn eller nyckel i objektet som ska visas och redigeras. Detta värde kan vara namnet på ett tabellattribut eller ett kodfragmentnamn, t.ex.
Taggen stöder många valfria namngivna parametrar efter dessa inledande parametrar.
klass
Anger ett klassattributvärde för rotelementet som återges av taggen.
standard
Ett standardvärde som ska återges i det fall som redigerbara objekt har inget värde.
ESC
Ett booleskt värde som anger om ett värde av den här taggen ska vara HTML-kodad. Som standard är detta värde "falskt".
liquid
Ett booleskt värde som anger om all preliminär mallkod som finns i textvärdet som återges av den här taggen kommer att bearbetas. Standardvärdet är "sant".
tagg
Namnet på HTML-behållaretaggar återges av denna tagg. Den här taggen återger div-element som standard. I allmänhet bör du välja mellan "div" eller "span" som värde för denna parameter.
rubrik
Anger en etikett för detta redigerbara objekt i gränssnittet för innehållsredigering. Om ingen anges genereras en beskrivande etikett automatiskt.
typ
Ett strängvärde som anger vilken typ av gränssnitt för redigering uppvisas för redigerbara textvärden. Giltiga värden för parametern "html" eller "text". standardinställningen är html.
entitetslista
Läser in en viss tabellista med namn eller ID. Egenskaperna i tabellistan kan sedan nås med en entitetslisteobjekt som ska vara tillgängliga i taggblocket. Om du vill återge faktiska resultatposter i listan använder du taggen entitetsvy inne i blocket.
Om listan har lästs in återges innehållet i blocket. Om listan inte har lästs in återges inte innehållet i blocket.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Som standard får entitetslisteobjektet variabelnamnet "entitylist". Du kan också ge olika variabelnamn.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parameters
Angeendast ett värde bland id, namn eller nyckel för att välja vilken lista som ska laddas.
id
Laddar en lista efter GUID ID. Id måste vara en sträng som kan tolkas som en GUID.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
I allmänhet används inte bokstavliga GUID-strängar. I stället anges id genom en GUID-egenskap för en annan variabel.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
namn
Läser in en lista efter namn.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
nyckel
Läser in en lista efter ID eller namn. Om värdet för angivna nyckeln kan tolkas som en GUID, kommer listan att läsas in efter ID. Den kommer annars att läsas in efter namn.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
En språkkod för Dataverse-heltal som väljer vilka lokaliserade etiketter för lista som ska läsas in. Om ingen språk_kod anges kommer det förvalda språket för webbplatsprogrammets Dataverse-anslutning att användas.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entitetsvy
Läser in en viss Dataverse-vy efter namn eller ID. Egenskaper för att visa kolumnmetadata i vyn ߝ, sidnumrerade resultatposter, osv. kan sedan nås med en entitetsvyobjekt som blir tillgänglig i taggblocket.
Om vyn har lästs in återges innehållet i blocket. Om vyn inte har lästs in återges inte innehållet i blocket.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Som standard får entitetsvyobjekt variabelnamnet "entityview". Du kan också ge olika variabelnamn.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Om "entityview" är inkapslat i ett entitetslisteblock ärver den dess standardkonfiguration (resultatsidans storlek, filteralternativ, osv.) från listan. Om inget vy-id eller inga namnparameter tillhandahålles till "entityview", kommer den att läsa in standardvyn från omslutande entitetslista.
{% 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 %}
Parametrar
Ange antingen id eller logiskt namn med namnet, och välj den Dataverse-vy som du vill läsa in. Om ingen av dem ges och entitetsvytaggen är kapslad i en entitetslistetagg, läses standardvyn för den omslutande entitetslistan in.
id
id måste vara en sträng som kan tolkas som en GUID.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
I allmänhet används inte bokstavliga GUID-strängar. I stället anges id genom en GUID-egenskap för en annan variabel.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
Dataverse-entitetens logiska namn för vyn som ska läsas in. Måste användas i kombination med namn.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
namn
Dataverse-namnet för den vy som ska läsas in. Måste användas i kombination med logiskt namn.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Anger om du vill filtrera vyresultaten efter användare eller konto. Måste ha ett strängvärde av "användare" eller "konto".
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ett vanligt fall är att ange denna parameter baserat på en begäran.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Anger filteruttrycket för listans metadata som du ska filtrera vyresultaten efter. Den här parametern är bara giltig när "entityview" används i kombination med entitetslista. I de flesta fall baseras den här parametern på en begäran.
{% 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
Anger ett sorteringsuttryck för beställningsvyresultat. Ett sorteringsuttryck kan innehålla ett eller flera logiska namn för entitetsattribut, följt av en sorteringsordning av antingen ASC eller DESC.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ett vanligt fall är att ange denna parameter baserat på en begäran.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
sida
Anger vyresultatsidan som ska läsas in. Om denna parameter inte anges läses den första sidan med resultat in.
Den här parametern måste skicka ett heltal eller en sträng som kan tolkas som ett heltal. Om ett värde har angetts för den här parametern, men värdet är null eller annars inte kan tolkas som ett heltal, läses den första sidan med resultat in.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ett vanligt fall är att ange denna parameter baserat på en begäran.
{% 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
Anger antalet resultat som ska läsas in för den aktuella resultatsidan. Om inget värde har angetts för den här parametern och entityview används inom ett entitetslistblock, storleken för listan att användas. Om det hela inte sker inom ett entitetslisteblock, kommer standardvärdet 10 att användas.
Den här parametern måste skicka ett heltal eller en sträng som kan tolkas som ett heltal. Om ett värde har angetts för den här parametern, men värdet är null eller annars inte kan tolkas som ett heltal, kommer den standardinställda sidstorleken att användas.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Ett vanligt fall är att ange denna parameter baserat på en begäran.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
sök
Anger ett sökuttryck som du kan filtrera vyresultat efter. Sökuttryck med enkla nyckelord filtreras om attribut börjar med nyckelordet. Jokertecken * kan också inkluderas i uttrycket.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Ett vanligt sätt är att ange denna parametern baserat på en begäran, så att sökfiltret kan anges baserat på indata från användaren.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
En språkkod för Dataverse-heltal för att markera entitetsvyns lokaliserade etiketter (kolumnrubriketiketter osv.) Om ingen språk_kod anges kommer det förvalda språket för webbplatsprogrammets Dataverse-anslutning att användas.
Om du använder "entityview" i ett entitetslisteblock, ärver "entityview" dess konfiguration för språkkod från entitetslistan.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
sökindex
Utför en fråga till webbplatsens sökindex. Det matchande resultatet kan sedan nås med ett sökindex som blir tillgängligt i taggblocket.
{% 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ökindexobjekt variabelnamnet "searchindex". Du kan också ge olika variabelnamn.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parameters
searchindex-taggen godkänner följande parametrar.
fråga
Den fråga som används för att matcha resultat. Den här parametern ska acceptera den användarspecificerade delen av indexfrågan (om det finns några).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Ett vanligt fall är att ange denna parameter baserat på en begäran.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
Denna parameter stöder the Lucene-sökverktygssyntax.
filter
Den fråga som används för att matcha resultat. Den här parametern är avsedd att acceptera ett utvecklarspecificerat filter för resultat, om så önskas.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
Denna parameter stöder the Lucene-sökverktygssyntax.
Kommentar
Skillnaden mellan filter och fråga är att fastän båda accepterar Lucene-sökverktygssyntaxen så är en fråga avsedd att vara mer förlåtande i fråga om hur syntaxen tolkas ߝ, detta eftersom det förväntas att de flesta användare inte känner till denna syntax. Om parsingfrågan enligt denna syntax skulle misslyckas kommer hela frågan att undantas och skickas som frågetext. filter kommer å andra sidan att tolkas strikt och returnera ett fel vid felaktig syntax.
logical_names
Dataverse-entitetens logiska namn som matchande resultat kommer att vara begränsade till, som en kommaavgränsad sträng. Om inte kommer alla matchande enheter att returneras.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
sida
Sökresultatsidan som ska returneras. Om inte returneras den första sidan (1).
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Ett vanligt fall är att ange denna parameter baserat på en begäran.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
Storleken på resultatsidan som ska returneras. Om den inte anges, används standardstorleken på 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entitetsformulär
Återger fullständigt ett formulär efter namn eller ID.
Kommentar
"entityform"-taggen kan endast användas i innehåll som återges inom en webbmall–baserad sidmall. Försök att använda taggen i en mall för omarbetningsbaserad sidmall återger ingenting. Du kan bara återge en enda enda entitetsforms- eller webbforms-tagg per sida. entitetsforms- eller webbformstaggar efter den första kommer inte att återges.
{% entityform name: 'My Basic Form' %}
Parameters
namn
Namnet på grundläggande formuläret som du vill läsa in.
{% entityform name:My Basic Form %}
webbformulär
Återger helt ett flerstegsformulär efter namn eller ID. Webbformulärstaggen kan endast användas i innehåll som återges inom en webbmallbaserad sidmall. Försök att använda taggen i en omarbetningsbaserad sidmall återger ingenting. Du kan bara återge en enda enda entitetsforms- eller webbforms-tagg per sida. entitetsforms- eller webbformstaggar efter den första kommer inte att återges.
{% webform name: 'My Multistep Form' %}
Parametrar
namn
Namnet på flerstegsformuläret som du vill läsa in.
{% webform name:My Multistep Form %}
codecomponent
Gör att du kan bädda in kodkomponenter med hjälp av en Liquid-tagg. Om du till exempel lägger till en anpassad kontroll för kartvisning på en webbsida.
Parametrar
namn
ID eller namn på kodkomponenten.
egenskap
Värdena för de egenskaper som kodkomponenten förväntar sig måste skickas som ett nyckel-/värdepar som åtskiljs av ":" (kolontecken), där nyckeln är egenskapsnamnet och värdet är JSON-strängvärdet.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Kommentar
De egenskaper som krävs kan variera beroende på vilken komponent du väljer.
Se Använda Liquid-malltagg för kodkomponenter.