Del via

Opprett og bruk funksjoner i Microsoft Dataverse (forhåndsversjon)

  • Artikkel

[Dette emnet inneholder dokumentasjon for forhåndsversjonen, og kan bli endret.]

Opprett og bruk gjenbrukbare funksjoner i Microsoft Dataverse. Funksjoner bruker Power Fx til å kjøre et bestemt sett med kommandoer i Dataverse som kjører på serversiden.

Viktig!

  • Dette er forhåndsversjonsfunksjon.
  • Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.

Forutsetning

Medlemskap i sikkerhetsrollen Systemtilpasser i Power Platform-miljøet.

Opprett en funksjon i en løsning

  1. Gå til Power Apps, og velg deretter Løsninger i venstre navigasjonsrute. Hvis elementet ikke finnes i sideruten, velger du ...Mer og deretter elementet du vil ha.
  2. Åpne løsningen der du vil opprette en funksjon.
  3. Velg Ny>Automatisering>Funksjon på kommandolinjen.
  4. Skriv inn følgende informasjon i sidepanelet Ny funksjon som vises.
    • Angi et visningsnavn og en beskrivelse for funksjonen.
    • Velg Ny inndataparameter og/eller Ny utdataparameter, og angi deretter et navn og en datatype for parameteren. Legg til flere inndata- og utdataparametere etter behov.
    • Du kan eventuelt velge tabeller i listen Tabellreferanser. Du kan referere til Dataverse-tabellene du velger, ved hjelp av funksjoner for datainnsamling, for eksempel Filter() og LookUp().
    • Skriv inn Power Fx-uttrykket i Formel-boksen.
  5. Velg Lagre.
  6. Test funksjonen.

Referer til inndataparametere i formelen ved navn.

Utdataparametere må refereres til i klammeparentesene, for eksempel { Out: "Return value" }.

Tips

  • Legg merke til IntelliSense i Formel-boksen. Understreket rødt er ugyldig. Bølgete gul betyr at logikken din kan bli påvirket av delegeringsbegrensninger. Unngå delegeringsproblemer ved å bruke delegerbare funksjoner.
  • Utvid Avanserte alternativer for å se gjennom skjemanavnet.

Eksempelfunksjoner

Denne delen inneholder noen eksempelfunksjoner.

Beregne summen av to heltall

  1. Skriv inn et Visningsnavn, for eksempel new_calculateSum, og en Beskrivelse.

  2. Legg til to inndataparametere, x og y (begge av datatypeheltall), og en utdataparameter, z (datatypeheltall).

  3. Skriv inn formelen i Formel-boksen:
    { z:x+y }

    Funksjon som multipliserer to tall.

  4. Test funksjonen.

Legg til en ny tittel i artikkeltabellen

  1. Opprett to inndataparametere tittel og url (begge med strengdatatyper) og en utdatavariabel, melding (datatypestreng).
  2. Velg tabellen Kunnskapssamlede artikler i rullegardinlisten Tabellreferanser.
  3. Skriv inn formelen i Formel-boksen:
Collect('Knowledge Federated Articles',  
   { 
    Title: title, 
    URL: url 
    } 
    ); 
{ 
    message: "New Article title added: " & title 
}

Valider om en inndatastreng inneholder strengene du velger

  1. Opprett en inndataparameter DocumentTextInput (med datatypen streng) og en utdatavariabel kalt result (datatypen streng).
  2. Skriv inn formelen i Formel-boksen:
{
    result: If("Confidentiality" in DocumentTextInput && "Dispute Resolution" in DocumentTextInput && "Governing Law" in DocumentTextInput && "Termination" in DocumentTextInput, 

    "Document is compliant.", 
    "Document is missing one or more compliance clauses." 
    ) 
}

Beregn pris for hotellopphold

  1. Opprett seks inndataparametere: netter, rom, avgift, rabatt, romservice, ratepernight (alle med strengdatatype) og en utgangsvariabel, pris (datatype float).
  2. Skriv inn formelen i Formel-boksen:
{ 
   price: ((nights*rooms*ratepernight)*(1+(tax/100))*(1-(discount/100)))+roomservice 

}

Flere funksjonseksempler

Hvis du vil ha flere eksempelfunksjoner, kan du gå til Eksempelfunksjoner (forhåndsversjon).

Redigere, teste eller slette en funksjon

Rediger en funksjon

  1. Velg funksjonen i Funksjoner-området.
  2. Velg Rediger på kommandolinjen.
  3. Endre formelen, og Lagre den.

Test en funksjon

  1. Velg funksjonen i Funksjoner-området.
  2. Velg Test på kommandolinjen.
  3. Angi verdier for inndataparameterne som er definert i funksjonen, og velg deretter Spill av.

En vellykket test returnerer et OData-svar som inkluderer informasjon som organisasjons-URI, funksjonsnavn og utdataparametere og -verdier.

Test en funksjon

Tips

Bruk utdataparametere til å validere forventet virkemåte og resultater. Ellers observerer du bare suksess eller fiasko når du tester.

Slett en funksjon

Viktig!

Ikke slett funksjonene fra området Løsninger under forhåndsversjonen siden det kan føre til isolerte komponenter. Slett funksjoner ved å gå til Power App (make.powerapps.com) >Funksjoner i venstre navigasjonsrute.

  1. Velg Funksjoner i venstre navigasjonsrute, og velg deretter funksjonen din. Hvis elementet ikke finnes i sideruten, velger du ...Mer og deretter elementet du vil ha.
  2. Velg Slett på kommandolinjen.

Funksjoner i Microsoft Dataverse (forhåndsversjon)