Jaa


Funktion käynnistäminen sovelluksesta, työnkulusta, koodista tai muusta funktiosta (esiversio)

[Tämä ohjeaihe sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Voit käynnistää funktioita Dataversessa pohjasovelluksesta, mallipohjaisen sovelluksen mukautetulta sivulta, työnkulusta, koodista tai toisesta funktiosta.

Tärkeää

  • Tämä on esiversiotoiminto.
  • Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.

Funktion käynnistäminen pohjasovelluksesta tai mukautetulta sivulta

  1. Valitse Power Appsin (make.powerapps.com) Funktiot-alueelta funktio, jonka haluat käynnistää pohjasovelluksesta tai mukautetulta sivulta.
  2. Valitse komentopalkissa Kopioi koodikatkelma.
  3. Liitä ja tallenna kopioitu kaava tekstieditoriin, Muistioon tai paikkaan, johon voit helposti viitata.
  4. Power Apps Studioissa:
    1. Luo kaaviosovellus tai mukautettu sivu tai muokkaa sitä Power Apps Studiossa.
    2. Valitse vasemmanpuoleisen siirtymisruudun Tietolähteet-välilehdessä Lisää tietoja, etsi Ympäristö-vaihtoehto Dataverse-yhdistimestä ja valitse se.
    3. Lisää seuraavat komponentit kaavioon:
      • Lisää syötteen ohjausobjekteja, jotka vastaavat kunkin parametrin tietotyyppiä, kuten numerosyöte.
      • Lisää painike toiminnon kutsumiseksi.
      • Lisää tuloksen ohjausobjekti, joka vastaa parametrin tietotyyppiä, kuten numerosyöte.
  5. Valitse luomasi painike ja toiminto, ja syötä OnSelect-ominaisuuteen funktiosi, kuten Environment.new_calculatesum.
  6. Yhdistä kukin syöteparametrin Value viittaamaan vastaavaan syöteohjausobjektiin:
    • Jos funktiosi on Environment.new_CalculateSum({ X: Value, Y: Value });, se voidaan kirjoittaa uudelleen seuraavasti: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Jos haluat määrittää funktion result-tuloksen, päivitä kaavan arvoksi 'Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))'.
  7. Valitse tulosteen ohjausobjekti ja aseta Value-ominaisuus kaavalla "result.z".

Esikatsele sovellusta, syötä syötteiden 1 ja 2 arvot ja valitse painike. Tuloksen pitäisi näkyä tuloskentässä.

Funktioiden käynnistäminen Power Automate -pilvityönkulusta

  1. Lisää pilvityönkulussa uusi toiminto Microsoft Dataverse -yhdistimestä.
  2. Valitse toiminto nimeltä Suorita sitomaton toiminto
  3. Select funktiosi. Toiminnolla on yksilöllinen nimi etuliitteellä.
  4. Anna arvot kaikille syöttöparametreille (jos sellaisia on).

Funktioiden käynnistäminen Dataversen verkko-ohjelmointirajapinnasta

Noudata Mukautettujen ohjelmointirajapintojen käynnistäminen verkko-ohjelmointirajapinnasta -artikkelin sitomattomien toimintojen ohjeita (laajennuksen soveltuvan laajuuden mukaan).

Kutsu aiemmin luotuja funktioita uusissa funktioissa

Jos haluat käynnistää aiemmin luodun funktion uudessa funktiossa, käytä syntaksia: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Koska lähtö on aina tietue, käytä pistemerkintää päästäksesi lähtöparametreihin. Jos esimerkiksi funktiolla "ExistingFunction" on kaksi tulosparametria, jotka on määritetty out1 ja out2, voit käyttää niitä jommallakummalla seuraavista tavoista:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Funktioiden rajoitukset Dataversessa

  • Ympäristön kieliobjekti on lisättävä uudelleen, jotta nykyisiä kaavio-sovellusten uusia toimintoja voidaan käyttää. Jos funktio on luotu sen jälkeen, kun olet lisännyt ympäristön taulukkotietolähteen aiemmin luotuun kaaviosovellukseen, sinun on poistettava Power Fx-ympäristön kieliobjekti ja lisättävä se uudelleen. Sitten näet päivitetyn luettelon funktioista toimintoina.
  • Upotettu tuki. funktiot voivat kutsua vain Microsoftin julkaisemia toimintoja Power Fx-lausekkeista.
  • Jotkin Collect-skenaariot vaativat Patchin. Joissakin skenaarioissa Collect() ei toimi. Voit kiertää ongelman käyttämällä funktiota Patch() tämän sarakkeen täyttämisen esimerkissä esitetyllä tavalla.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Virheenkorjaus ja ohjeiden hankkiminen funktioihin

Jos kohtaat ongelmia funktion luomisessa tai suorittamisessa, käytä funktiota trace() virheenkorjaukseen tai siirry kohtaan Rajoitukset funktioiden kanssa Dataversessa yleisten ongelmien tarkistamiseksi.

Virheenkorjaus trace()-toiminnolla

  1. Jos haluat tehdä virheenkorjauksen jäljitystoiminnon avulla, varmista, että otat laajennuksen ja mukautetun työnkulun aktiviteettien seurannan käyttöön.
  2. Siirry Power Appsiin (make.powerapps.com), valitse oikeassa yläkulmassa oleva Asetukset-rataskuvake ja valitse sitten Lisäasetukset.
  3. Valitse Asetukset > Seuranta > Yleiset seuranta-asetukset.
  4. Varmista Mukautus-välilehdessä, että Ota käyttöön laajennuksen jäljityslokiin kirjaaminen on käytössä määrityksellä Kaikki.

Kun otat seurannan käyttöön, voit alkaa käyttää trace()-funktioita Power Fx-kaavojen virheenkorjaukseen. Lisätietoja trace()-funktion käyttämisestä Power Fx-lausekkeen sisällä: Trace-funktio - Power Platform.

Ohjeet ja yhteyden ottaminen tukeen

Jos sinulla on ongelmia funktioissa, joita ei ole käsitelty Microsoft Dataversen low-code-laajennusten vihjeissä ja tunnetuissa ongelmissa, kuten dokumentoimattomia virheitä, käytä Ohje + tuki -toimintoa ja sisällytä seuraavat tiedot:

  • Ongelman tyyppi - Dataversen verkko-ohjelmointirajapinta ja SDK.
  • Ongelman alityyppi.

Esimerkkifunktioita

Funktioiden luominen ja käyttäminen Microsoft Dataversessa