Jaa

Dataversen low-code-laajennusten käyttäminen (esiversio)

  • Artikkeli

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

Microsoft Dataverse on tehokas ratkaisu, jolla tietoarkkitehtuuria voidaan tehostaa ja asiakasohjelmapuolen kuormitusta vähentää vähäkoodisten laajennusten avulla. Nämä laajennukset ovat uudelleenkäytettäviä, reaaliaikaisia työnkulkuja, jotka suorittavat Dataversessa tietyn komentojoukon. Niitä käytetään palvelimen puolella, ja mukautetut tapahtumakäsittelijät käynnistävät ne.

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.

Perinteisesti laajennukset luotiin mukautettuina .NET Framework -kokoelmaksi käännettyinä luokkina, jotka sitten ladattiin ja rekisteröitiin Dataversessa. Vähäkoodisten laajennusten käyttöönoton myötä käyttäjät tarvitsevat näiden tapahtumakäsittelijöiden luontiin vain vähän tai ei lainkaan koodauskokemusta. Myöskään manuaalista rekisteröintiä ei tarvita.

Vähäkoodiset laajennukset tallennetaan Dataverse-tietokantaan, ja ne voidaan integroida sujuvasti Power Appsiin ja Power Automateen. Työnkulun toiminta määritetään käyttämällä Power Fx -lausekekieltä, ja se voidaan yhdistää suoraan Dataversen liiketoimintatietoihin ja ulkoisiin tietolähteisiin Power Platform -yhdistimen kautta. Vähäkoodisten laajennusten ansiosta tekijät voivat muodostaa nopeasti monimutkaisia työnkulkuja myös vähäisellä koodauskokemuksella. Tuloksena onkin entistä sujuvampi ja tehokas tietoarkkitehtuuri.

Palvelinpuolen logiikan edut

Palvelinpuolen liiketoimintalogiikan määrittämisessä on esimerkiksi seuraavat edut:

  • Parantunut suojaus. Koska palvelinpuolen logiikkaa suoritetaan palvelimessa, se voi auttaa estämään arkaluonteisten tietojen tai prosessien luvatonta käyttöä.
  • Parantunut suorituskyky. Palvelimessa suoritettava liiketoimintalogiikka voi vähentää asiakasohjelman ja palvelimen välillä siirrettävien tietojen määrää, mikä nopeuttaa käsittelyä.
  • Yhdenmukaisuus ja luotettavuus. Palvelinpuolen logiikka varmistaa, että liiketoimintasääntöjä käytetään yhdenmukaisissa kaikissa asiakasohjelmissa, mikä vähentää virheiden tai epäyhdenmukaisuuksien riskiä.
  • Ylläpidon ja päivitysten helpottuminen. Liiketoimintalogiikan keskittäminen palvelimen helpottaa yläpitoa ja päivitystä, sillä muutokset voidaan tehdä yhdessä paikassa sen sijaan, että olisi päivitettävä useita asiakasohjelmia.
  • Skaalautuvuus. Palvelinpuolen logiikan skaalaaminen on helpompaa kuin asiakasohjelmapuolen logiikan skaalaaminen, mikä parantaa suurten työmäärien suorituskykyä ja käsittelyä.

Vähäkoodiset laajennukset

Dataversessa tuetaan kahta vähäkoodista laajennustyyppiä:

Type Herätin Parametreja tuetaan Tuettu vaikutusalue
Välitön Suoritetaan manuaalisesti Kyllä Yleinen ja taulukko
Automaattinen Dataverse-taulukon tapahtuma Ei Table

Kaikissa vähäkoodisissa laajennuksissa on seuraavat yleiset ominaisuudet:

Ominaisuus Description
Display name Laajennuksen helposti luettava nimi. Ei voi muuttaa luonnin jälkeen.
Name Laajennuksen sisäinen nimi. Ympäristö tunnistaa komponentin sen avulla koodissa ja tietokantatoiminnoissa. Ei voi muuttaa luonnin jälkeen.
Description Annetaan laajennusta koskeva lisäkonteksti (tarkoitus, toiminta ti muu tärkeä tieto).
Ratkaisu Käytetään komponenttien ryhmittelemiseen ja toisiin ympäristöihin viemiseen. Lisätietoja ratkaisuista
Expression Tämän mukautetun funktion avulla suoritetaan Power Fx -lausekekielellä määritettyjä toimintoja tai laskelmia. Power Fx on pohjaan perustuvissa Power Apps -sovelluksissa käytetty kaavakieli, jonka käyttö on laajennettu vähäkoodisiin laajennuksiin. Lisätietoja on tuettuja funktioita käsittelevässä kohdassa.

Vähäisen koodin laajennus on mukautettu koodilogiikkaa, jonka käyttäjä käynnistetään manuaalisesti. Mukautettujen syöte- ja tulosparametrien käyttö on mahdollista.

Yksilöivät ominaisuudet:

Ominaisuus Description
Käyttöalue Käytetään liittämään laajennus tiettyyn taulukkoon. Määrityksenä voi olla joko taulukko (näkyy entiteettinä) tai yleinen, jolloin taulukko (entiteetti) vaikutusalueena tarkoittaa, että laajennus käynnistetään tietyn taulukkotietueen kontekstissa. Jos vaikutusalue on yleinen, toimintoa ei ole liitetty taulukkoon (lisätietoja).
Parametrit Parametrien avulla voidaan välittää tietoja laajennuksen ja sen suorittavan kontekstin välillä, mikä helpottaa eri tilanteissa uudelleenkäytettävän liiketoimintalogiikan suunnittelua.

Syöteparametrien avulla annetaan laajennuksen tiedot ja mahdollisuus hallita funktion toimintaa välittämällä erilaisia Power Fx -kaavassa määritettyjä arvoja.

Tulosparametrien avulla voidaan noutaa funktion tai menetelmän tulokset ohjelmassa käytettäväksi.

Tuetut tietotyypit:
  • Totuusarvo
  • String
  • Float
  • Desimaaliluku
  • DateTime
  • Integer

Lisätietoja pohjaan perustuvasta sovelluksesta tehtävästä tai Power Automate -pilvityönkulussa tapahtuvasta integroinnista: Vähäkoodisen laajennuksen integrointi

Laajennuksen oikeudet

Suunnittelunaikainen

Tekijät, joilla on järjestelmän mukauttajan tai järjestelmänvalvojan käyttöoikeusroolin jäsenyys Power Platform -ympäristössä, voivat käyttää kaikkia kyseisen ympäristön laajennuksia. Mukautettujen käyttöoikeusroolien avulla voidaan rajoittaa vähäkoodisten laajennusten käyttöoikeutta.

Suorituksenaikainen

Kun laajennus käynnistetään, se käyttää laajennuksen määritelmään liittyviä taulukkotietoja (taulukkoja, jotka ovat kaavan osa, tai automaattisen laajennuksiin asetuksiin liitettyä taulukkoa) laajennuksen käynnistäjän kontekstissa.

Yhteydet

Käyttöoikeusroolien avulla yhdistimen käyttöoikeus laajennuksessa voidaan rajoittaa tietylle organisaation käyttäjäjoukolle. Roolit, joilla on luonti-, luku-, päivitys- tai poisto-oikeudet voidaan määrittää.

Vähäkoodisen laajennuksen luomisen edellytykset

  • Ympäristön järjestelmänvalvojan tai järjestelmän mukauttajan käyttöoikeusroolin jäsenyys Power Platform -ympäristössä.
  • Dataverse accelerator -sovellus.

Vihje

Dataverse accelerator -sovellus asennetaan automaattisesti uusiin ympäristöihin 1.10.2023 alkaen. Jos Dataverse accelerator on jo asennettu, Dataverse accelerator voidaan päivittää manuaalisesti.

Dataverse acceleratorin päivittäminen

  1. Noudattamalla ohjeita voit tarkastella lisensoituja sovelluksia ympäristössäsi.
  2. Jos Dataverse Accelerator on jo asennettu ja päivitys on saatavilla, se näkyy kohteen vieressä olevassa taulukossa.
  3. Valitse Dataverse Accelerator ja sitten Päivitä komentopalkissa.

Vihje

Päivitykset saadaan automaattisesti, kun ne ovat saatavana, ottamalla käyttöön Microsoft - Power CAT -julkaisijan automaattiset sovelluspäivitykset (ei tarvita uusissa 1.10.2023 jälkeen luoduissa uusissa ympäristöissä).

Muistiinpano

Jos valinnaiset Yhdistimien vähäkoodiset laajennukset -ratkaisu on asennettu aiemmin, se poistetaan automaattisesti 29.6.2023 jälkeen tehtävän päivityksen yhteydessä. Toiminnot ovat käytettävissä pääratkaisussa.

Vähäisen koodin pikalaajennkkeen luominen

  1. Toista Dataverse Accelerator -sovellus.
  2. Valitse Luo laajennus heti -kortti. Luo laajennus heti -kortti
  3. Kirjoita näyttönimi.
  4. Määritä valinnaisesti parametreja:
    • Valitse Uusi syöteparametri tai Uusi tulosparametri sekä anna sitten selite ja tietotyyppi.
    • Lisää muita syöte- ja tulosparametreja tarvittaessa.
  5. Syötä Power Fx -lauseke Lauseke-editorissa.
    • Käytä syöteparametrien viitteenä kaavassa selitteen nimeä.
    • Tulosparametriviittaus on tehtävä kaarisulkeissa esimerkiksi seuraavasti: { Out: "Return value" }.
    • Tee Dataverse-taulukkoviittaukset käyttämällä tietokokoelmafunktioita, kuten Filter() ja LookUp().
    • Jos vaikutusalueeksi on määritetty entiteetti, ThisRecord mahdollistaa suoritettavaan laajennukseen liitetyn taulukkorivin sarakearvojen käyttämisen. Esimerkki: ThisRecord.'Account Name'.

    Vihje

    Intellisensen käyttöä Lauseke-ruudussa koskeva huomautus. Alleviivattu punainen on virheellinen. Kiemurteleva keltainen tarkoittaa, että delegoinnin rajoitukset voivat vaikuttaa logiikkaasi. Voit välttää delegoinnin ongelmat käyttämällä delegoitavissa olevia funktioita.

  6. Lisäasetukset on mahdollista laajentaa ratkaisun, vaikutusalueen tai kuvauksen muokkaamista varten.
  7. Valitse Tallenna.
  8. Testaa heti luotua vähäkoodista laajennusta.

Esimerkki: kahden kokonaisluvun summan laskeminen.

  • Luo kaksi syöteparametria, X ja Y (kummankin tyyppi on kokonaisluku) ja yksi tulosparametri, Z (tyyppinä merkkijono).
  • Käytä seuraavaa kaavaa: {Z: X + Y }

Esimerkki heti luotavasta laajennuksesta Dataverse Accelerator -sovelluksessa

Luo automatisoitu vähäsen koodin laajennus

  1. Toista Dataverse Accelerator -sovellus.
  2. Valitse Luo automaattinen laajennus -kortti. Luo automaattinen laajennus -kortti
  3. Anna seuraavat arvot:
    • Nimi: Syötä laajennukselle nimi, kuten Syötteen tarkistus.
    • Taulukko: Valitse taulukko, johon laajennus liitetään, esimerkiksi Tili.
    • Suorita tämä laajennussääntö, kun rivi on. Määritä laajennuksen käynnistävä tietotapahtuma.
  4. Syötä Power Fx -lauseke Lauseke-editorissa.
    • Tee Dataverse-taulukkoviittaukset käyttämällä tietokokoelmafunktioita, kuten Filter() ja LookUp().
    • ThisRecord mahdollistaa suoritettavaan laajennukseen liitetyn taulukkorivin sarakearvojen käyttämisen. Esimerkki: ThisRecord.'Account Name'.
  5. Laajentamalla Lisäasetukset voidaan muokata vaihetta (jolloin suoritus tapahtuu) ja ratkaisua, johon laajennus tallennetaan.
  6. Valitse Tallenna.
  7. Testaa automaattista vähäkoodista laajennusta.

Power Platform -yhdistimen käyttäminen vähäkoodisissa laajennuksissa

Power Platform -yhdistimien avulla vähäkoodisissa laajennuksissa on helppo integroida Dataversen ulkopuolisten järjestelmien, kuten SQL Serverin, Salesforcen ja SharePointin, tietoja ja toimintoja ilman monimutkaista koodausta tai mukautettua kehittämistä.

Edellytykset yhdistimien käyttämiselle vähäkoodisissa laajennuksissa

Yhdistimen toimintojen käyttäminen vähäkoodisissa laajennuksissa

Yhdistimiä ja mukautettuja yhdistimiä on helppo käyttää vähäkoodisen laajennuksen Power Fx -kaavassa.

  1. Luo yhteys käytettävään yhdistimeen.
  2. Lisää yhteysviite yhteyteen Dataverse-ympäristössä.
  3. Kirjoita vähäkoodisen laajennuksen Power Fx -lauseke-editorissa yhteysviitteen nimi. (Se on sisäinen nimi, jossa on etuliite ja alaviiva, kuten new_connectorName; se ei ole näyttönimi.)
  4. Intellisense näyttää käytettävissä olevat toiminnot. Valitse toiminto ja syötä tarvittavat parametrit.

Varmista yhdistimen ohjeista ennen yhdistimen käyttämistä vähäkoodisessa laajennuksessa. että syöte- ja tulosparametrit välitetään oikein.

Lisätietoja: esimerkki

Muistiinpano

  • Tällä hetkellä ei tueta kaikki yhdistimen toimintoja.
  • Dataverse-yhdistintä ei saa käyttää Dataverse-taulukkojen yhdistämiseen laajennuslausekkeesta. Kokoelmia käytetään sen sijaan alkuperäisillä Power Fx -funktioilla: Filter, Search, LookUp, Patch, Collect ja Set. Sarakkeet ovat käytössä yleisinä muuttujina.

Vähäisen koodin laajennuksen testaaminen

Heti luotujen laajennusten testaaminen

  1. Valitse aloitusnäytössä luettelosta heti luotu laajennus ja valitse sitten komentopalkissa Testi. Tähän näyttöön voi siirtyä myös heti luotavan laajennuksen editorin komentopalkista tallennuksen jälkeen. Vähäkoodisen laajennuksen testauksen valinta

  2. Anna kaikkien vähäisen koodin laajennuksessa määritettyjen syöteparametrien arvot ja valitse sitten Suorita. Vähäkoodisen laajennuksen testauksen suorittamisen valinta

Kiinnitä huomiota vastaukseen.

Vihje

Tulosparametrien avulla voit tarkistaa odotetun käyttäytymisen ja tulokset. Muussa tapauksessa testauksen aikana näkyy vain onnistuminen tai epäonnistuminen.

Automaattisten laajennusten testaaminen

Testaa automatisoidut laajennukset käynnistämällä tietotapahtuma. Tarkkaile, onnistuiko laajennus validoimalla kaavassa määritetyt odotetut muutokset.

Vihje

Liitetty tietotapahtuma voidaan käynnistää esiversiossa Power Appsin taulukkoeditorissa:

  1. Kirjaudu Power Appsiin, valitse ensin Taulukot ja sitten Laajennus-taulukko.
  2. Valitse komentopalkista Muokkaa.
  3. Rivejä voi luoda, päivittää tai poistaa suoraan tässä näkymässä. Vaihtoehtoisesti voit avata rivin oletuslomakkeessa valitsemalla ensin rivin ja sitten komentopalkissa Muokkaa riviä lomakkeella.

Vähäisen koodin laajennuksen integroiminen

Pikalaajennun käynnistäminen pohjaan perustuvasta sovelluksesta tai mukautetusta sivusta

  1. Dataverse Accelerator -sovellus:
    1. Valitse luettelossa heti luotava laajennus.
    2. Valitse komentopalkissa Kopioi koodikatkelma. Esiintymän vähäkoodisen laajennuksen käynnistäminen
    3. Liitä ja tallenna kopioitu kaava tekstieditoriin tai muistioon (johonkin, jossa sitä on helppo käyttää).
  2. Power Appsissa:
    1. Luo Power Apps Studiossa pohjaan perustuva sovellus (tai mukautettu sivu) tai muokkaa sitä.
    2. Valitse vasemman siirtymisruudun Tietolähteet-välilehdessä + Uusi tietolähde ja hae Dataverse-yhdistimessä Ympäristö-vaihtoehto.
    3. Lisää seuraavat komponentit kaavioon:
    • Lisää kunkin parametrin tietotyyppiä vastaavat syöteohjausobjektit, kuten Tekstisyöte, jos kyse on tekstistä tai luvuista, tai vaihtopainike, jos kyse on totuusarvosta.
    • Jos laajennuksen vaikutusalue on sidottu taulukkoon, lisää samaan taulukkoon liitetty yhdistelmäruutu, jossa syöte voidaan valita.
    • Lisää laajennusta kutsuva painike.
  3. Liitä laajennuksen kopioitu kaava painikkeen OnSelect-ominaisuuteen.
  4. Yhdistä kukin syöteparametrin Value viittaamaan vastaavaan syöteohjausobjektiin:
    • Jos kaava oli Environment.new_CalculateSum({ X: Value, Y: Value });, se voidaan uudelleenkirjoittaa muotoon: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Jos kaava oli sidottu, korvaa Environment taulukon näyttönimellä, mikä mahdollistaa laajennuksen käytön.
  5. Vähäkoodiselle laajennukselle on määritetty tulosparametri:
    1. Sieppaa vastaus Set()- tai UpdateContext()-kaavassa: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Näytä muuttuja selitteessä. Ilmoituksen tiedot voidaan näyttää myös Notify()-kaavan avulla.
  6. Toista sovellus ja valitse komentopalkissa vähäkoodisen laajennuksen suorittava komento.

Lisätietoja Dataverse-toimintojen kutsumisesta suoraan Power Fx:stä pohjaan perustuvissa sovelluksissa.

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

  1. Lisää pilvityönkulussa uusi toiminto Microsoft Dataverse -yhdistimestä.
  2. Valitse toiminnoksi Suorita ei-sidottu toiminto tai Suorita sidottu toiminto.
  3. Valitse laajennus (jolla on yksilöivä nimi ja etuliite).
  4. Anna kaikkien syöteparametrien (tarvittaessa) arvot.

Pikalaajennuksen käynnistäminen Dataverse-verkko-ohjelmointirajapinnasta

Noudata Ei-sidotun toiminto- tai Taulukkoon sidottu funktio -osien vaiheita kohdassa Mukautettujen ohjelmointirajapintojen käynnistäminen verkko-ohjelmointirajapinnasta – ohjeet (laajennuksen vaikutusalueen mukaan).

Ohjeen saaminen vähäisen koodin laajennuksia varten

Jos kohtaat ongelmia omien vähäisen koodin laajennustesi luomisessa tai suorittamisessa, siirry näihin vinkkeihin, joissa on neuvoja tavanomaisiin ongelmiin: Microsoft Dataversen vähäisen koodin laajennusten vinkkejä ja tunnettuja ongelmia

Yhteyden ottaminen ohjeisiin ja tukeen

Jos kohtaat ongelmia Dataverse Accelerator -ratkaisun asennuksessa tai ongelmia vähäisen koodin laajennuksissa, joita Microsoft Dataversen vähäisen koodin laajennusten vinkit ja tunnetut ongelmat ei kata, kuten virheitä, joita ei löydy dokumentaatiosta, käytä Ohje ja tuki -kokemusta ja sisällytä seuraavat tiedot:

  • Ongelman tyyppi - Dataversen verkko-ohjelmointirajapinta ja SDK
  • Ongelman alatyyppi- Accelerator kit for Dataverse

Esimerkki pienikoodilaajennuksista, jotka voit luoda

Esimerkkejä vähäkoodisen laajennuksen luonnista on kohdassa Esimerkki Dataversen vähäkoodisista laajennuksista (esiversio)

Rajoitukset

  • Käyttöympäristön kieliobjektia on lisättävä uudelleen, jotta uusia laajennuksia voidaan käyttää aiemmin luoduissa pohjaan perustuvissa sovelluksissa. Niissä laajennuksissa, jotka on luotu sen jälkeen, kun ympäristötaulukon tietolähde on lisätty aiemmin luotuun pohjaan perustuvaan sovellukseen, on poistettava Power Fx -ympäristön kieliobjekti ja lisättävä se sitten uudelleen. Päivitetty laajennusluettelo näkyy sitten toimintoina.

  • Intellisense edellyttää, että automaattisissa laajennuksissa on eksplisiittiset merkinnät, jos kaavassa halutaan viitata taulukkoon. Käytä seuraavaa selvityssyntaksia, kuten [@Accounts], käyttämällä hakasulkeita ja @-symbolia (ei siis vain muotoa Accounts).

  • Upotettu tuki. Laajennukset voivat vain kutsua Microsoftin julkaisemia ensimmäisen osapuolen toimintoja Power Fx -lausekkeista.

  • Jotkin Collect-skenaariot vaativat Patchin. Joissakin skenaarioissa Collect() ei toimi. Voit kiertää ongelman käyttämällä Patch()ia kuten alla on näytetty liittyy-sarakkeen täyttöesimerkissä. Automaattista laajennusta luotaessa kunkin Power Fx-kaavassa viitatun taulukon eteen on lisättävä @-merkki.

    Patch(Faxes,
    Collect(Faxes, { Subject : "Sub1" } ),
    { Regarding : First(Accounts) }
)

  • Jos vähäkoodiset laajennukset käyttävät yhdistimiä ja DLP on otettu käyttöön, järjestelmänvalvojat voivat estää yhteyksien luonnin DLP-käytännön avulla. Dataverse-ympäristössä jo olevat yhteysviitteet toimivat kuitenkin edelleen. Jos järjestelmänvalvojan on estettävä vähäkoodisen laajennuksen kaikki toiminta yhdistimien kanssa, he voivat poistaa organisaatioasetuksen Allowconnectorsonpowerfxactions käytöstä. Tämä asetus on oletusarvoisesti käytössä, ja voidaan poistaa käytöstä tavanomaisilla SDK-menetelmillä (kuten WebAPI, SDK ja PowerShell). Se voidaan poistaa käytöstä vähäkoodisen pikalaajennuksen avulla seuraavasti:

    Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })

  • Yhdistimiä käyttävät laajennukset voivat antaa tulokseksi vain tiettyjen kenttien tulokset. Tämän vuoksi tietyt perusarvot on yhdistettävä yhdistimen vastauksesta tulosarvoihin.

Vähäisen koodin laajennukset, joilla on mukautettujen yhdistimien rajoitus

Jos käytettävissä on vähäisen koodin laajennuksia ja mukautettuja yhdistimiä, ennen yhteysviitteiden tai työnkulkujen tuontia on tuotava mukautetut yhdistimet.

Jos ympäristö ei sisällä mukautettua yhdistintä ratkaisussa, tuo erillinen ratkaisu, joka sisältää vain mukautetun yhdistimen. Tee tämä ennen varsinaisen ratkaisun tuomista. Tämä on tehtävä ensimmäiseksi, koska Azuren on rekisteröitävä mukautettu yhdistin ennen ratkaisun muiden osien tuomista.

Jos tuot ratkaisun, joka sisältää mukautettuja yhdistimiä ja työnkulkuja, Azure ei voi rekisteröidä mukautettua yhdistimiä rekisteröidessään yhteysviitteitä tai -työnkulkuja. Tämä koskee myös mukautetun yhdistimen yhteysviitteitä, joita ei aiemmin tuotu erillisessä ratkaisussa. Jos Azure ei rekisteröinyt mukautettua yhdistintä, tuonti epäonnistuu, tai et voi aloittaa tuontia.

Lisätietoja: Mukautettujen yhdistimien luominen ratkaisuissa: Tunnetut rajoitukset

Katso myös

Vähäisen koodin laajennukset Power Fx:ssä (esiversio)

Esimääritetyn kehotteen käyttäminen Dataversen low-code-laajennuksessa Power Appsissa

Automatisoidun vähäisen koodin laajennuksen luominen Power Appsin avulla (video)

Vähäisen koodin pikalaajennuksen luominen Power Appsin avulla (video)