Dataverse-enhetskoder
Obs!
Fra og med 12. oktober 2022 er Power Apps-portaler Power Pages. Mer informasjon: Microsoft Power Pages er nå tilgjengelig (blogg)
Vi overfører og slår snart sammen Power Apps-portaldokumentasjonen med Power Pages-dokumentasjonen.
Koder for Microsoft Dataverse-enhet brukes til å laste inn og vise Dataverse-data, eller bruke andre rammeverktjenester for Power Apps-portaler. Disse kodene er Dataverse-spesifikke utvidelser for Liquid-språket.
diagram
Legger til et Power Apps-diagram på en nettside. Koden chart kan legges til i Kopi-feltet på en nettside eller i Kilde-feltet i en webmal. Hvis du vil se trinn for tilføying av Power Apps-diagram på en nettside, kan du se Legge til et diagram på en nettside i portalen.
{% chart id:"EE3C733D-5693-DE11-97D4-00155DA3B01E" viewid:"00000000-0000-0000-00AA-000010001006" %}
Parametere
Koden chart har to parametere: chart id og viewid.
chart id
Visualiserings-ID for diagrammet. Du får denne ved å eksportere diagrammet.
viewid
ID for tabellen når den åpnes i visningsredigeringsprogrammet.
powerbi
Legger til Power BI-dashbord og -rapporter på sider. Koden kan legges til i Kopi-feltet på en nettside eller i Kilde-feltet i en webmal. Hvis du vil ha fremgangsmåten for å legge til en Power BI-rapport eller -dashbord på en nettside i portalen, kan du se Legge til Power BI-rapport eller -dashbord på en nettside i portalen.
Obs!
For at koden skal fungere, må du aktivere Power BI-integrasjon fra administrasjonssenteret for Power Apps-portaler. Hvis Power BI-integrasjon ikke er aktivert, vises ikke dashbord eller rapporter.
Parametere
powerbi-koden godtar parameterne nedenfor:
path
Bane til Power BI-rapporten eller -dashbordet. Hvis Power BI-rapporten eller -dashbordet er sikker, må du angi godkjenningstypen.
{% 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 godkjenning som kreves for Power BI-rapporten eller -dashbordet. Gyldige verdier for denne parameteren er:
Anonym: Lar deg publisere til Power BI-webrapporter. Standard godkjenningtype er anonym. Når du bruker godkjenningstypen som anonym, må du få Power BI-rapportens URL-adresse som beskrevet på: Publiser til Internett fra Power BI
AAD: Lar deg dele sikre Power BI-rapporter eller -dashbord til Power BI Azure Active Directory-autentiserte brukere.
powerbiembedded: Gjør det mulig å dele sikre Power BI-rapporter og -dashbord til eksterne brukere som ikke har Power BI-lisens eller Azure Active Directory-autentiseringsoppsett. Hvis du vil ha informasjon om Power BI Embedded-tjenesteoppsett, kan du se Aktivere Power BI Embedded-tjeneste.
Når du legger til sikker(t) Power BI-rapport eller -dashbord, må du sørge for at den/det deles med Azure Active Directory- eller Power BI Embedded-tjenester for portal.
Obs!
Verdiene for authentication_type-parameteren skiller mellom store og små bokstaver.
{% 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 etter én eller flere verdier. Syntaksen for å filtrere en rapport er som følger:
URL?filter=Tabell/Felt eq 'verdi'
La oss for eksempel si at du vil filtrere rapporten for å se data for en kontakt kalt Bert Hair. Du må tilføye følgende data i nettadressen:
?filter=Ledere/Leder eq 'Bert Hair'
Den fullstendige koden blir som følger:
{% 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 informasjon om filtrering av en rapport: Filtrere en rapport ved å bruke spørringsstrengparametere i URL-adressen
Obs!
Anonym rapport støtter ikke filtrering.
Du kan også opprette en dynamisk bane ved hjelp av variabelen capture Liquid, slik som 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 %}
Mer informasjon om Liquid-variabelen: Variabelkoder
tileid
Viser den angitte flisen på instrumentbordet. Du må angi ID-en for flisen.
{% 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 tildelt Power BI-rapporten. Denne parameteren fungerer bare når authentication_type-parameteren er satt til powerbiembedded.
Hvis du har definert roller i Power BI og tildelt dem til rapporter, må du spesifisere de aktuelle rollene i Liquid-taggen powerbi. Roller lar deg filtrere dataene som skal vises i en rapport. Du kan spesifisere flere roller atskilt med komma. Hvis du vil ha mer informasjon om definering av roller i Power BI, kan du se RLS (Row-level security) 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 ikke spesifiserte roller-parameteren i Liquid-taggen eller ikke spesifiserte en rolle i parameteren, vises en feil.
Tips
Hvis du vil bruke nettrollene som er definert i portalen, som Power BI-rollene, kan du definere en variabel og tilordne nettroller til den. Deretter kan du bruke den definerte variabelen i Liquid-taggen.
La oss si at du har definert to nettroller som Region_East and Region_West i portalen. Du kan bli med i disse ved å bruke koden: {% assign webroles = user.roles | join: ", " %}
I ovennevnte kodesnutt er webroles en variabel, og Region_East and Region_West-nettrollene lagres i den.
Bruk webroles-variabelen i Liquid-taggen på følgende måte:
{% 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
Gjengir et gitt CMS-objekt for Power Apps-portaler som redigerbart på portalen, for brukere med tillatelse for innholdsredigering for dette objektet. Redigerbare objekter inkluderer side, kodesnutter og webkoblinger.
{% 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 %}
Parametere
Den første parameteren som kan redigeres, er det redigerbare objektet, for eksempel et nettkoblingssett, tekstutdrag eller nåværende side. Den andre valgfrie parameteren er å angi et attributtnavn eller nøkkel i objektet som skal gjengis og redigeres. Denne verdien kan for eksempel være navnet på et tabellattributt eller et snuttnavn.
Etter disse første parameterne støtter koden mange valgfrie parametere.
class
Angir en class-attributtverdi for rotelementet som gjengis av denne koden.
default
En standardverdi som skal gjengis i tilfeller der det redigerbare elementet ikke har noen verdi.
escape
En boolsk verdi som angir om en verdi som gjengis av denne koden skal være HTML-kodet. Denne verdien er usann som standard.
liquid
En boolsk verdi som angir om en hvilken som helst Liquid-malkode i tekstverdien som gjengis av denne koden, vil bli behandlet. Denne verdien er sann som standard.
tag
Navnet på beholder-HTML-kodene som skal gjengis av denne koden. Denne koden vil gjengi div-elementer som standard. Det anbefales at du kan velge mellom div eller span som en verdi for denne parameteren.
title
Angir en etikett for dette redigerbare elementet i grensesnittet for innholdsredigering. Hvis ingen er angitt, vil det automatisk genereres en egendefinert etikett.
type
En strengverdi som angir typen redigeringsgrensesnitt som skal presenteres for redigerbare tekstverdier. Gyldige verdier for denne parameteren er html eller text. Standardinnstillingen er html.
entitylist
Laster inn en angitt liste etter navn eller ID. Det er deretter tilgang til egenskapene for listen ved hjelp av et entitylist-objekt som vil være tilgjengelig i kodeblokken. Hvis du vil gjengi de faktiske resultatpostene i listen, kan du bruke entityview-koden i blokken.
Hvis listen lastes inn, gjengis innholdet i blokken. Hvis listen ikke finnes, gjengis ikke innholdet i blokken.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Som standard får entitylist-objektet variabelnavnet entitylist. Du kan eventuelt angi et annet variabelnavn.
{% entitylist my_list = name:My List %}
Loaded list {{ my_list.adx_name }}.
{% endentitylist %}
Parametere
Angi bare én av id, name eller key for å velge listen som skal lastes inn.
id
Laster inn en liste etter GUID-ID. id må være en streng som kan analyseres som en GUID.
{% entitylist id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
Litterale GUID-strenger brukes vanligvis ikke. I stedet vil id bli angitt med en GUID-egenskap for en annen variabel.
{% entitylist id:page.adx_entitylist.id %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
name
Laster inn en liste etter navn.
{% entitylist name:My List %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
key
Laster inn en liste etter ID eller navn. Hvis den angitte nøkkelverdien kan analyseres som en GUID, vil listen lastes inn etter ID. Ellers lastes den inn etter navn.
<!-- key_variable can hold an ID or name -->
{% entitylist key:key_variable %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
language_code
En heltallspråkkode for Power Apps for å velge lokaliserte etiketter for listen som skal lastes inn. Hvis ingen language_code er angitt, brukes standardspråket for portalprogrammets Power Apps-tilkobling.
{% entitylist name:"My List", language_code:1033 %}
Loaded list {{ entitylist.adx_name }}.
{% endentitylist %}
entityview
Laster inn en angitt Power Apps-visning etter navn eller ID. Du kan gå til egenskaper for visningen ߝ for visning av kolonnemetadata, paginerte resultatoppføringer og så videre, ved hjelp av et entityview-objekt som vil være tilgjengelig i kodeblokken.
Hvis visningen lastes inn, gjengis innholdet i blokken. Hvis visningen ikke finnes, gjengis ikke innholdet i blokken.
{% 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. Du kan eventuelt angi et annet variabelnavn.
{% entityview my_view = logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ my_view.total_records }} total records.
{% endentityview %}
Hvis entityview er nestet i en entitylist-blokk, arver den standardkonfigurasjonen (resultatsidestørrelse, filteralternativer og så videre) fra listen. Hvis ingen visnings-id- eller -name-parameter er angitt for entityview, lastes standardvisningen inn 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 %}
Parametere
Angi enten id eller logical_name med navn for å velge Power Apps-visningen som skal lastes inn. Hvis ingen er angitt og entityview-koden er nestet inne i en entitylist-kode, lastes standardvisningen inn for den omsluttende entitylist.
id
id må være en streng som kan analyseres som en GUID.
{% entityview id:936DA01F-9ABD-4d9d-80C7-02AF85C822A8 %}
Loaded entity view {{ entityview.name }}.
{% endentityview %}
Litterale GUID-strenger brukes vanligvis ikke. I stedet vil id bli angitt med en GUID-egenskap for en annen variabel.
{% entityview id:request.params.view %}
Loaded entity view {{ entityview.name }} using view query string request parameter.
{% endentityview %}
logical_name
Det logiske navnet på Power Apps-enheten for visningen som skal lastes inn. Må brukes sammen med name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
name
Power Apps-navnet på visningen som skal lastes inn. Må brukes sammen med logical_name.
{% entityview logical_name:'contact', name:"Active Contacts" %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
filter
Angir om du vil filtrere visningsresultatene etter brukeren eller forretningsforbindelse. Må ha strengverdien bruker eller forretningsforbindelse.
{% entityview id:request.params.view, filter:'user' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel.
{% entityview id:request.params.view, filter:request.params.filter %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
metafilter
Angir filteruttrykket for metadata for listen som resultatene filtreres etter. Denne parameteren er bare gyldig når entityview brukes i kombinasjon med entitylist. I de fleste tilfeller angis denne parameteren basert på en forespørsel.
{% 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
Angir et sorteringsuttrykk for sortering av visningsresultater. Sorteringsuttrykk kan inneholde ett eller flere logiske navn for enhetsattributt, etterfulgt av sorteringsretningen ASC eller DESC.
{% entityview id:request.params.view, order:'name ASC, createdon DESC' %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel.
{% entityview id:request.params.view, order:request.params.order %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
page
Angir visningssiden for resultater som skal lastes inn. Hvis denne parameteren ikke er angitt, blir den første siden med resultater lastet inn.
Denne parameteren må sendes en heltallsverdi eller en streng som kan analyseres som et heltall. Hvis det er angitt en verdi for denne parameteren men verdien er null eller ikke kan analyseres som et heltall, blir den første siden med resultater lastet inn.
{% entityview id:request.params.view, page:2 %}
Loaded page {{ entityview.page }} of entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel.
{% 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
Angir hvor mange resultater som skal lastes inn for gjeldende resultatside. Hvis ingen verdi er angitt for denne parameteren og entityview brukes i en entitylist-blokk, brukes sidestørrelsen for listen. Hvis ikke i en entitylist-blokk, brukes standardverdien 10.
Denne parameteren må sendes en heltallsverdi eller en streng som kan analyseres som et heltall. Hvis det er angitt en verdi for denne parameteren men verdien er null eller ikke kan analyseres som et heltall, brukes standard sidestørrelse.
{% entityview id:request.params.view, page_size:20 %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel.
{% entityview id:request.params.view, page_size:request.params.pagesize %}
Loaded entity view with {{ entityview.total_records }} total records.
{% endentityview %}
search
Angir et søkeuttrykk som visningsresultater filtreres etter. Enkle nøkkelordsøkeuttrykk vil filtrere etter om attributtene begynner med nøkkelordet. Jokertegn * kan også inkluderes i uttrykket.
{% entityview id:request.params.view, search:'John\*' %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel, slik at søkefilteret kan angis basert på brukerinndata.
{% entityview id:request.params.view, search:request.params.search %}
Loaded entity view with {{ entityview.total_records }} total matching records.
{% endentityview %}
language_code
En heltallspråkkode for Power Apps for å velge lokaliserte etiketter (kolonneetiketter i toppteksten og så videre) som skal lastes inn. Hvis ingen language_code er angitt, brukes standardspråket for portalprogrammets Power Apps-tilkobling.
Hvis entityview brukes i en entitylist-blokk, arver entityview språkkodekonfigurasjonen fra entitylist.
{% entityview logical_name:'contact', name:"Active Contacts", language_code:1033 %}
Loaded entity view {{ entityview.name }}.
{% endentitylist %}
searchindex
Utfører en spørring mot portalsøkeindeksen. Det er deretter tilgang til de samsvarende resultatene ved hjelp av en søkeindeks som vil være tilgjengelig i kodeblokken.
{% 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 gis searchindex-objektet variabelnavnet searchindex. Du kan eventuelt angi et annet variabelnavn.
{% searchindex liquid_search = query: 'support', page: params.page, page_size: 10 %}
{% if liquid_search.results.size > 0 %}
...
{% endif %}
{% endsearchindex %}
Parametere
searchindex-koden godtar parameterne nedenfor.
query
Spørring som brukes til å samsvare resultatene. Denne parameteren er beregnet til å godta den brukerangitte delen av indeksspørringen (hvis aktuelt).
{% searchindex query: 'support' %}
...
{% endsearchindex %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel.
{% searchindex query: request.params.query %}
...
{% endsearchindex %}
Denne parameteren støtter syntaksen for Lucene-spørringsanalyse.
filter
En tilleggsspørring som brukes til å samsvare resultatene. Denne parameteren er beregnet på å godta utviklerangitte filtre for resultater, hvis du vil.
{% searchindex query: request.params.query, filter: '+statecode:0' %}
...
{% endsearchindex %}
Denne parameteren støtter syntaksen for Lucene-spørringsanalyse.
Obs!
Forskjellen mellom filter og query er at begge godtar syntaks for Lucene-spørringsanalyse, men query er ment å være mer tilgivende med hensyn til hvordan denne syntaksen analyseres ߝ siden det er forventet at de fleste brukerne ikke kjenner til denne syntaksen. I tilfelle analyse av query i henhold til denne syntaksen mislykkes, brukes det escape for hele spørringen og den sendes som spørringstekst. filter analyseres derimot,strengt og returnerer en feil hvis det brukes ugyldig syntaks.
logical_names
De logiske navnene for Power Apps-enhet som samsvarende resultater begrenses til, som en kommadelt streng. Hvis ikke angitt, returneres alle samsvarende enheter.
{% searchindex query: request.params.query, logical_names: 'kbarticle,incident' %}
...
>
{% endsearchindex %}
page
Siden med søkeresultater som skal returneres. Hvis ikke angitt, returneres den første siden (1).
{% searchindex query: request.params.query, page: 2 %}
...
{% endsearchindex %}
Et vanlig brukstilfelle er å angi denne parameteren basert på en forespørsel.
{% searchindex query: request.params.query, page: request.params.page %}
...
{% endsearchindex %}
page_size
Størrelsen på siden med resultater som skal returneres. Hvis ikke angitt, brukes en standardstørrelsen 10.
{% searchindex query: request.params.query, page_size: 20 %}
...
{% endsearchindex %}
entityform
Gjengir fullstendig et Power Apps-konfigurert standardskjema etter navn eller ID.
Obs!
entityform-koden er bare tilgjengelig for bruk i innhold som gjengis i en webmal-basert sidemal. Forsøk på bruke kode i en Skriv på nytt-basert sidemal vil ikke gjengi noe. Du kan bare gjengi én enkelt entityform- eller entityform-kode per side. entityform- eller webform-koder etter den først, vil ikke gjengis.
{% entityform name: 'My Basic Form' %}
Parametere
name
Navnet på standardskjemaet som du vil laste inn.
{% entityform name:My Basic Form %}
webform
Gjengir fullstendig et Power Apps-konfigurert flertrinnsskjema etter navn eller ID. webform-koden er bare tilgjengelig for bruk i innhold som gjengis i en webmal-basert sidemal. Forsøk på bruke kode i en Skriv på nytt-basert sidemal vil ikke gjengi noe. Du kan bare gjengi én enkelt entityform- eller entityform-kode per side. entityform- eller webform-koder etter den først, vil ikke gjengis.
{% webform name: 'My Multistep Form' %}
Parametere
name
Navnet på flertrinnsskjemaet som du vil laste inn.
{% webform name:My Multistep Form %}
codecomponent
Gjør det mulig å bygge inn kodekomponenter ved hjelp av et Liquid-merke. Det kan for eksempel være å legge til egendefinert kontroll for kartvisning på en webside.
Viktig
- Dette er en forhåndsvisningsfunksjon.
- Forhåndsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisielle utgivelsen, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.
Parametere
name
IDen eller navnet på kodekomponenten.
egenskap
Verdiene i egenskapene som kodekomponenten forventer, må sendes inn som et nøkkel/verdipar atskilt med ":" (kolontegn), der nøkkelen er egenskapsnavnet og verdien er JSON-strengverdien.
{% codecomponent name:abc\_SampleNamespace.MapControl controlValue:'Space Needle' controlApiKey:<API Key Value> %}
Obs!
Egenskapene som kreves, kan variere avhengig av komponenten du velger.
Se Bruk kodekomponenter til Liquid-malkode.
Se også
Kontroller flytmerker
Gjentakelsesmerker
Variabelmerker
Malmerker
Obs!
Kan du fortelle oss om språkinnstillingene for dokumentasjonen? Ta en kort undersøkelse. (vær oppmerksom på at denne undersøkelsen er på engelsk)
Undersøkelsen tar rundt sju minutter. Det blir ikke samlet inn noen personopplysninger (personvernerklæring).
Tilbakemeldinger
Kommer snart: Gjennom 2024 faser vi ut GitHub Issues som tilbakemeldingsmekanisme for innhold, og erstatter det med et nytt system for tilbakemeldinger. Hvis du vil ha mer informasjon, kan du se: https://aka.ms/ContentUserFeedback.
Send inn og vis tilbakemelding for