Palvelinlogiikan yleiskatsaus

Power Pages -palvelinlogiikan avulla tekijät voivat suorittaa JavaScriptin turvallisesti palvelimessa ja lisätä laajennettavuuden suoraan sivuston suorituspalveluun.
 
Koska palvelinlogiikka suoritetaan palvelimessa, se on piilotettu selaimessa ja suojattu verkkorooleilla ja taulukon oikeuksilla. Voit lisätä logiikkaa Power Pagesin suunnittelustudiossa ja tehdä sen käyttämällä Visual Studio Codea, joka tarjoaa IntelliSensen ja kääntämisaikaisen vahvistuksen.

Dataverse tallentaa koodin ja määritykset, joten palvelinlogiikka hyötyy samasta elinkaaren hallinta- ja käyttöönottoputkesta kuin muut Power Pagesin osat.

Palvelimen logiikan työnkulku

Kielituki

Palvelimen logiikan avulla kehittäjät voivat kirjoittaa alkuperäisen JavaScript-koodin, joka on yhteensopiva ECMAScript 2023 -standardin kanssa ilman selaimen ohjelmointirajapintojen tukea (kuten DOM-ohjelmointirajapinnat fetch tai XMLHttpRequest). Tiettyjä turvallisia tai rajoitettuja kuvioita estetään myös suojatun suorituksen varmistamiseksi. Lisätietoja on kohdassa Palvelinlogiikan luomisen rajoitukset.

Mitä voit tehdä palvelinlogiikalla?

Power Pagesin palvelinlogiikan avulla tekijät ja kehittäjät voivat siirtää tärkeitä toimintoja selaimesta palvelimelle hallinnan, skaalattavuuden ja suojauksen parantamiseksi. Sen avulla sivustosi voi suorittaa monimutkaisia tehtäviä ja integrointeja näyttämättä arkaluontoista logiikkaa tai tietoja asiakaspuolella.

Palvelinlogiikan avulla voit tehdä seuraavaa:

  • Yhdistä ulkoisiin palveluihin ja ohjelmointirajapintoihin: Integroi turvallisesti REST-ohjelmointirajapintoihin, Azure-funktioihin tai muihin liiketoimintajärjestelmiin tietojen vaihtamiseen, toimintojen käynnistämiseen tai dynaamisten tietojen noutamiseen.
  • Suorita suojattuja tietotoimintoja: Suorita palvelimessa Dataverse-toimintoja, kuten kyselyjä, päivittämistä tai tietueiden poistamista, käyttämällä johdonmukaisesti liiketoimintalogiikkaa ja vahvistusta.
  • Suorita mukautettu logiikka ja muunnokset: Käsittele tai käsittele tietoja ennen niiden palauttamista asiakkaalle. Voit esimerkiksi laskea summia, vahvistaa liiketoimintasääntöjä tai täydentää tietoja ulkoisten hakujen avulla.
  • Palauta käsitellyt vastaukset sivuille: Lähetä vain tarvittavat ja suodatetut tiedot asiakassivuille, mikä varmistaa nopeamman hahmontamisen ja pienemmät hyötykuormat.
  • Yksinkertaista suojattua todentamista: Hallitse palvelun tunnistetietoja ja ohjelmointirajapinta-avaimia palvelimessa asiakaskoodin sijaan ja ylläpidä suojattuja ja yhteensopivia integrointikäytäntöjä.

Palvelinlogiikan käytön edut

Palvelinlogiikka tuo Yritystason laajennettavuuden Power Pagesille, mikä auttaa organisaatioita kehittämään suojatumpia, skaalautuvia ja ylläpidettäviä verkkokokemuksia.

Tärkeimpiä etuja ovat seuraavat:

  • Parannettu suojaus: Suorita ja tallenna liiketoimintalogiikkaa, salaisuuksia ja ohjelmointirajapinta-avaimia palvelimella – älä koskaan paljasta niitä selaimessa tai käyttäjille.
  • Integroinnin joustavuus: Yhdistä Power Pages saumattomasti ulkoisten järjestelmien kanssa, mukaan lukien Azure-funktiot, REST-ohjelmointirajapinnat, Dataverse-toiminnot ja yrityspalvelut.
  • Parannettu suorituskyky ja tehokkuus: Raskaan laskennan, vahvistusten ja tietojen käsittelyn purkaminen palvelimelle, asiakaspuolen kuormituksen pienentäminen ja sivun reagoinnin parantaminen.
  • Johdonmukaisuus eri kanavissa: Sovella samaa logiikkaa verkkosivuilla, lomakkeissa ja integroinnissa, mikä varmistaa yhtenäisen tietojen vahvistamisen ja toiminnan koko sovelluksessa.
  • Keskitetty ylläpito: Päivitä tai tarkenna logiikkaa yhdessä paikassa siirtämättä tai muokkaamatta useita asiakaskomentosarjoja tai -sivuja.

Palvelimen logiikan suojaaminen

Jotta koodi voidaan suorittaa palvelinlogiikassa, käyttäjillä on oltava tekijän määrittämät oikeudet. Käyttöoikeuksia säätelevät verkkoroolit ja taulukon käyttöoikeudet, jotka myös määrittävät, voiko palvelinlogiikka käyttää tiettyjä taulukoita.

Palvelinlogiikan ohjelmointirajapinnan todentaminen

Sinun ei tarvitse sisällyttää mukautettua todennuskoodia. Sovellusistunto hallitsee todentamista ja valtuutusta. Kaikkien palvelinlogiikan ohjelmointirajapintakutsujen on sisällettävä Sivustojen välinen pyynnön väärennös (CSRF) -tunnus.

Ulkoisten palvelukutsujen hallinta-asetus

Palvelinlogiikka voi muodostaa yhteyden ulkoisiin REST-ohjelmointirajapintoihin, Azure-funktioihin ja muihin liiketoimintajärjestelmiin palvelinpuolen integrointeja varten. Tietojen poistamisen estämiseksi vuokraajan järjestelmänvalvojat voivat estää lähtevät HTTP-kutsut , joita palvelinlogiikka tekee sivustokohtaisesti. Kun tämä hallinnon ohjausobjekti on käytössä, lähtevä HTTP-kutsu, jonka palvelinlogiikka yrittää, epäonnistuu. Lisätietoja on artikkelissa Ulkoisten palvelukutsujen poistaminen käytöstä palvelinlogiikasta.

Toimipaikan asetukset

Määritä palvelimen logiikka seuraavien valinnaisten sivuston asetusten avulla:

Nimi Description Oletusarvo
ServerLogic/Käytössä Ota käyttöön tai poista käytöstä -ominaisuus tosi
ServerLogic/AllowedDomains Rajoita, mitä ulkoisia toimialueita voidaan kutsua Kaikki sallitut toimialueet
ServerLogic/TimeoutInSeconds Suurin suoritusaika (sekunteina). Aikakatkaisua voidaan lisätä jopa 240 sekuntiin 120
ServerLogic/SalliVerkkoyhteydetKaikilleToimialueille Salli verkkopalvelut eri toimialueilla Tosi

Palvelinlogiikan ohjelmointirajapinnan URL-osoite

Muodosta ohjelmointirajapinnan URL-osoite käyttämällä seuraavaa muotoa:

https://<site-url>/_api/serverlogics/<server-logic-name>  
Esimerkki:

https://contoso.powerappsportals.com/_api/serverlogics/exchangerate

 

Tuetut HTTP-menetelmät

Palvelinlogiikka tukee HTTP-vakiomenetelmiä, joiden avulla voit suorittaa toimintoja tiedoille tai olla vuorovaikutuksessa ulkoisten palveluiden kanssa. Jokainen menetelmä yhdistää funktioon, jonka määrität palvelimen logiikkakoodissa.

Menetelmä Funktion allekirjoitus Käyttö Description
GET function get() { } Nouda tiedot.  Käytetään tietojen noutamiseen Dataversesta, ulkoisista ohjelmointirajapinnoista tai mukautetusta liiketoimintalogiikasta. Ihanteellinen vain luku -toimintoihin, jos tietoja ei muuteta.
POST funktio post() { } Luo tietueita tai lähetä uusia tietoja.  Käytetään yleisesti uusien tietueiden lisäämiseen Dataverseen tai tietojen lähettämiseen ulkoisiin järjestelmiin. Sopii lomakkeen lähetyksiä tai työnkulkuja varten, joiden on luotava tai käynnistettävä toimintoja.
ASETTAA function put() { } Korvaa tai päivitä tietueita.  Päivittää tai korvaa koko tietueen tai tietojoukon. Käytetään yleensä täysien päivitysten tai synkronointiskenaarioiden yhteydessä.
PATCH function patch() { } Päivittää osan tietueesta (upsert).  Suorittaa olemassa olevien tietojen osittaisen päivityksen korvaamatta koko tietuetta. Käytä tätä menetelmää, kun vain tietyt kentät tarvitsevat muutoksia.
POISTAA function del() { } Poista tietueet tai kentät.  Poistaa tietueet tai tiedot Dataversesta tai ulkoisesta järjestelmästä. On käytettävä varoen tahattomien tietojen menetyksen estämiseksi.

Seuraava vaihe

Laatijapalvelimen logiikka

Palvelinobjektit
Dataverse-taulukoiden käsitteleminen palvelinlogiikan avulla