Osien suorituskyvyn, vakauden ja luotettavuuden parantaminen ratkaisun tarkistusohjelmalla
Kun kehittäjät luovat yrityksen toiveita vastaavan ratkaisun, tuloksena on usein erittäin kehittyneitä ratkaisuja, jotka mukauttavat ja laajentavat Microsoft Dataverse -ympäristöä. Tällaisiin toteutuksiin liittyy usein riski, että ratkaisun suorituskyky, vakaus ja luotettavuus kärsivät, mikä voi vaikuttaa kielteisesti käyttäjäkokemukseen. Tällaisten ongelmien havaitseminen ja niiden ratkaiseminen voi olla hankalaa ja viedä paljon aikaa. Ratkaisun tarkistustoiminnon avulla voi tehdä monipuolisen staattisen analyysin, jossa ratkaisun käyttöä verrataan parhaiden käytäntöjen mukaisiin sääntöihin. Tällä tavoin ongelmalliset kohdat havaitaan nopeasti. Saat tarkistuksen valmistumien jälkeen yksityiskohtaisen raportin havaituista ongelmista, osista ja koodista, joihin nämä ongelmat vaikuttavat, sekä linkin kunkin ongelman ratkaisuohjeisiin.
Ratkaisun tarkistustoiminto analysoi seuraavia ratkaisun osia:
- Dataversen mukautetut työnkulkuaktiviteetit
- Dataverse -verkkoresurssit (HTML ja JavaScript)
- Dataverse -määritykset, kuten SDK-viestin osavaiheet
- Power Automate -työkulut (työnkulun tarkistustoiminnon kautta)
- Power Fx -lausekkeet (sovelluksen tarkistustoiminnon kautta)
Ratkaisun tarkistustoimintoa voi käyttää sellaisissa hallitsemattomissa ratkaisuissa, jotka voidaan viedä ympäristöstä.
Huomautus
- Tässä ohjeaiheessa selitetään, miten ratkaisun tarkistus suoritetaan Power Apps Maker -portaalista. Käytettävissä on myös PowerShell-moduuli, jonka avulla voit olla yhteydessä suoraan palveluun. Microsoft.PowerApps.Checker.PowerShell -moduulia voidaan käyttää hallitsemattomien ratkaisujen analysointiin Power Apps -ympäristöille tai automatisoimaan ja integroimaan palvelu koonti- ja julkaisuprosesseihisi. Lisätietoja: Microsoft.PowerApps.Checker.PowerShell Overview
- Ratkaisun tarkistus tukee yleisiä muuttujia ECMAScript 2015:een (ES6) ja syntaksia ECMAScript 2018:aan (ES9) saakka. Kun JavaScriptia havaitaan käyttäen ES6-versiota vanhempia yleisiä muuttuja tai ES9-versiota vanhempaa syntaksia, verkkoresurssin osalta ilmoitetaan verkko ei tue syntaksia -ongelmasta.
- Ratkaisun tarkistuksen käyttö ei takaa ratkaisun tuonnin onnistuvan. Ratkaisun staattiset analyysitarkistukset eivät tiedä kohdeympäristön määritettyä tilaa, ja tuonnin onnistuminen voi riippua muista ympäristön ratkaisuista tai konfiguraatioista.
Ratkaisun tarkistustoiminnon suorittaminen
Kirjaudu Power Apps -palveluun
Valitse vasemmassa ruudussa Ratkaisut. Jos nimikettä ei ole sivupaneelissa, valitse ... Lisää ja valitse sitten haluamasi nimike.
Valitse sen hallitsemattoman ratkaisun vieressä, jonka haluat analysoida, ..., osoitaRatkaisun tarkistustoiminto -kohtaa ja valitse Suorita.
Ratkaisun tarkistustoiminto -komentopainikkeessa on latausilmaisin, ja näkyvissä on myös teksti Suoritetaan... näkyy Ratkaisu-luettelon Ratkaisun tarkistus -sarakkeessa.
Huomaa seuraavat asiat:
Voi kestää muutamia minuutteja, kun ratkaisun tarkistustoiminto viimeistelee analyysin.
Kun tarkistus on valmis, saat siitä sähköposti-ilmoituksen. Lisäksi Power Apps-sivuston Ilmoitukset-alueella on ilmoitus.
Tarkastele raporttia, kun tarkistus on valmis.
Tarkistuksen peruuttaminen
Lähetetty ratkaisun ympäristötarkistus voidaan peruuttaa tilaruudussa, joka on Ratkaisut-sivun oikeassa yläkulmassa.
Kun tarkistus peruutetaan, ratkaisun tarkistus keskeytetään ja ratkaisun tarkistustila palautuu edelliseen tilaan.
Ratkaisun tarkistustoiminnon tilat
Kun ratkaisun tarkistustoiminto asennetaan ympäristöön, Ratkaisun tarkistus -sarake on käytettävissä Ratkaisut-luettelossa. Tässä sarakkeessa näkyy ratkaisun analysointitilat.
| Osavaltio | Kuvaus |
|---|---|
| Ei ole suoritettu | Ratkaisua ei ole koskaan analysoitu. |
| Käynnissä | Ratkaisua analysoidaan. |
| Ei voitu suorittaa loppuun | Ratkaisun analysointia pyydettiin mutta analyysi ei onnistunut. |
| Tulokset alkaen päivämäärä ja aika | Ratkaisun analysointi on tehty ja tulokset voi ladata. |
| Ei voitu suorittaa loppuun. Tulos alkaen päivämäärä ja aika | Viimeisintä analyysipyyntöä ei voitu suorittaa loppuun. Viimeiset onnistuneet tulokset voidaan ladata. |
| Microsoft tarkistanut | Tämä on Microsoftin hallittu ratkaisu. Ratkaisun analyysia ei voi tehdä näissä ratkaisuissa. |
| Julkaisija tarkistanut | Tämä on kolmannen osapuolen hallittu ratkaisu. Ratkaisun analyysia ei voi tällä hetkellä käyttää näissä ratkaisuissa. |
Ratkaisun tarkistustoiminnon raportin tarkasteleminen
Kun ratkaisun tarkistus on suoritettu, voit tarkastella analyysiraporttia portaalissa tai ladata raportin selaimen avulla. Portaalissa on mahdollisuus lajitella tulokset ongelman, sijainnin tai vakavuusasteen mukaan ja tarkastella ratkaisussa havaittujen ongelmien eriteltyjä tietoja.
Valitse vasemmassa ruudussa Ratkaisut. Jos nimikettä ei ole sivupaneelissa, valitse ... Lisää ja valitse sitten haluamasi nimike.
Valitse … sen hallitsemattoman ratkaisun vieressä, jonka ratkaisun tarkistustoiminnon raporttia haluat tarkastella. Osoita Ratkaisun tarkistustoiminto -kohtaa ja valitse sitten Näytä tulokset.
Valitse ongelma, jos haluat tarkastella tietoja ja saada ohjeita ongelman ratkaisemiseksi.
Ratkaisun tarkistuksen tulokset ovat myös ladattavissa. Ratkaisun tarkistustoiminnon zip-tiedosto ladataan selaimen määrittämään kansioon. Ladattava raportti on Excel-muotoinen, ja siinä on useita visualisointeja ja sarakkeita, jotka auttavat tunnistamaan jokaisen ratkaisussa havaitun ongelman vaikutuksen, tyypin ja sijainnin. Siinä on myös linkki yksityiskohtaiseen ohjeeseen, jolla ongelma voidaan ratkaista.
- Valitse vasemmassa ruudussa Ratkaisut. Jos nimikettä ei ole sivupaneelissa, valitse ... Lisää ja valitse sitten haluamasi nimike.
- Valitse sen hallitsemattoman ratkaisun vieressä, jonka ratkaisun tarkistustoiminnon raportin haluat ladata, …, osoita Ratkaisun tarkistustoiminto -kohtaa ja valitse sitten Lataa tulokset.
- Ratkaisun tarkistustoiminnon zip-tiedosto ladataan selaimen määrittämään kansioon.
Yhteenveto raportin sarakkeista:
| Raportin sarake | Kuvaus | Koskee osia |
|---|---|---|
| Ongelma | Ratkaisun havaitseman ongelman otsikko. | Kaikki |
| Luokka | Tunnistetun ongelman luokittelu, kuten Suorituskyky, Ylläpidettävyys, Käyttö, Tuettavuus, Rakenne, Suojaus, Käytettävyys tai Päivitysvalmius. | Kaikki |
| Vakavuus | Osoittaa havaitun ongelman mahdollisen vaikutuksen. Käytettävissä on seuraavat vaikutustyypit: Kriittinen, Korkea, Keskisuuri, Alhainen ja Tiedoksi. | Kaikki |
| Ohjeet | Linkki artikkeliin, jossa käsitellään ongelmaa, sen vaikutusta ja suositeltua toimintoa. | Kaikki |
| Osa | Ratkaisun osa, jossa ongelma havaittiin. | Kaikki |
| Location | Sen osan sijainti ja/tai lähdetiedosto, jossa havaittu ongelma tapahtui. Se voi olla esimerkiksi kokoonpano tai JavaScript-tiedoston nimi. | Kaikki |
| Rivinumero | Ongelman rivinumeroviittaus siinä verkkoresurssiosassa, jota ongelma koskee. | WWW-resurssit |
| Moduuli | Sen moduulin nimi, jossa ongelma havaittiin kokoonpanossa. | Mukautettu työnkulkuaktiviteetti |
| Tyyppi | Kokoonpanossa havaitun ongelman tyyppi. | Mukautettu työnkulkuaktiviteetti |
| Jäsen | Kokoonpanossa havaitun ongelman jäsen. | Mukautettu työnkulkuaktiviteetti |
| Lauseke | Koodilauseke tai määritys, joka aiheutti ongelman. | Kaikki |
| Kommentit | Tietoja ongelmasta mukaan lukien tarkasta ratkaisuohjeet. | Kaikki |
Ratkaisun tarkistuksen sääntöjen paikallinen suorittaminen
Voit suorittaa ratkaisun tarkistuksen sääntöjä kehitysympäristössäsi havaitaksesi ongelmat paljon aikaisemmin, kun luot ratkaisuresurssejasi. Tätä tuetaan tällä hetkellä verkkoresurssien (JavaScript ja TypeScript) osalta. Lisätietoja on NPM-paketissa @microsoft/eslint-plugin-power-apps.
Ratkaisun tarkistustoiminnon käyttämät parhaiden käytäntöjen säännöt
Seuraavassa taulukossa on luettelo komponenttityypistä, säännön kuvauksesta, vakavuusasteesta ja luokasta. Kriittiset rikkomukset estetään tai niitä varoitetaan, kun niitä määritetään ratkaisun tarkistustoiminnon käyttöä varten hallituissa ympäristöissä. Lisätietoja: Ratkaisun tarkistajan käyttäminen hallituissa ympäristöissä
| Ratkaisun osa | Säännön nimi | Säännön kuvaus | Vakavuus | Luokka |
|---|---|---|---|---|
| Laajennus tai työnkulun aktiviteetti | meta-remove-dup-reg | Vältä päällekkäisten Dataverse -laajennusten rekisteröintejä. | Kriittinen | Suorituskyky |
| Laajennus tai työnkulun aktiviteetti | meta-avoid-reg-no-attribute | Sisällytä suodatusmääritteet Dataversen laajennusrekisteröintien kanssa. | Keskikokoinen | Suorituskyky |
| Laajennus tai työnkulun aktiviteetti | meta-avoid-reg-retrieve | Ole varovainen, kun käytät Retrieve- ja RetrieveMultiple-sanomille rekisteröityjä Dataverse -laajennuksia. | Keskikokoinen | Suorituskyky |
| Laajennus tai työnkulun aktiviteetti | meta-remove-inactive | Passiiviset kanavamääritykset Dataversessä | Matala | Ylläpidettävyys |
| Laajennus tai työnkulun aktiviteetti | meta-avoid-crm4-event | Älä käytä Microsoft Dynamics CRM 4.0 -laajennuksen rekisteröintivaihetta. | Keskikokoinen | Päivitysvalmius |
| Laajennus tai työnkulun aktiviteetti | meta-avoid-retrievemultiple-annotation | Vältä rekisteröimästä laajennusta RetrieveMultiple-huomautukseen. | Suuri | Käyttö |
| Mallipohjainen sovellus | meta-license-sales-entity-operations | Ratkaisu sisältää rajoitettuja SDK-sanomia ja -toimintoja sisältäviä entiteettejä, joihin tarvitaan voimassa oleva Dynamics 365 -käyttöoikeus. | Matala | Käyttöoikeudet |
| Mallipohjainen sovellus | meta-license-fieldservice-customcontrols | Ratkaisu sisältää mukautettuja ohjausobjekteja, jotka edellyttävät kelvollista Dynamics 365 Field Service -käyttöoikeutta. | Matala | Käyttöoikeudet |
| Mallipohjainen sovellus | meta-license-fieldservice-entity-operations | Ratkaisu sisältää entiteettejä, joissa on rajoitettuja SDK-viestejä ja toimintoja, jotka edellyttävät kelvollista Dynamics 365 Field Service -käyttöoikeutta. | Matala | Käyttöoikeudet |
| Verkkoresurssit | use-async | Käsittele HTTP- ja HTTPS-resursseja asynkronisesti. | Kriittinen | Suorituskyky |
| Verkkoresurssit | avoid-modals | Älä käytä modaalisia valintaikkunoita. | Suuri | Tuettavuus |
| Verkkoresurssit | avoid-dom-form | Suuri | Tuettavuus | |
| Verkkoresurssit | avoid-dom-form-event | Suuri | Tuettavuus | |
| Verkkoresurssit | avoid-crm2011-service-odata | Älä käytä kohteena Microsoft Dynamics CRM 2011 OData 2.0 -päätepistettä. | Kriittinen | Päivitysvalmius |
| Verkkoresurssit | avoid-crm2011-service-soap | Älä käytä kohteena Microsoft Dynamics CRM 2011 SOAP -palveluja. | Kriittinen | Päivitysvalmius |
| Verkkoresurssit | avoid-loadtheme | Älä käytä loadTheme Fluent v8 -ohjelmointirajapintaa. |
Matala | Tuettavuus |
| Verkkoresurssit | avoid-browser-specific-api | Älä käytä Internet Explorerin vanhoja ohjelmointirajapintoja tai selainlaajennuksia. | Kriittinen | Päivitysvalmius |
| Verkkoresurssit | avoid-unpub-api | Suuri | Tuettavuus | |
| Verkkoresurssit | avoid-window-top | Suuri | Tuettavuus | |
| Verkkoresurssit | avoid-2011-api | Älä käytä vanhentunutta Microsoft Dynamics CRM 2011 -objektimallia. Noudata sen sijaan Dataverse Web API -dokumentaatiota. | Suuri | Päivitysvalmius |
| Verkkoresurssit | use-relative-uri | Älä käytä absoluuttisia Dataverse -päätepisteen URL-osoitteita. | Keskikokoinen | Ylläpidettävyys |
| Verkkoresurssit | use-cached-webresource | Keskikokoinen | Suorituskyky | |
| Verkkoresurssit | use-client-context | Käytä asiakasohjelmakonteksteja. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | use-navigation-api | Käytä siirtymisen ohjelmointirajapintaparametreja. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | use-offline | Keskikokoinen | Päivitysvalmius | |
| Verkkoresurssit | do-not-make-parent-assumption | Suuri | Suunnittelu | |
| Verkkoresurssit | use-org-setting | Käytä organisaation asetuksia. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | use-global-context | Keskikokoinen | Päivitysvalmius | |
| Verkkoresurssit | use-grid-api | Käytä ruudukon ohjelmointirajapintoja. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | use-utility-dialogs | Keskikokoinen | Käyttö | |
| Verkkoresurssit | avoid-isActivityType | Korvaa Xrm.Utility.isActivityType-menetelmä uudella Xrm.Utility.gettableMetadata-menetelmällä äläkä käytä valintanauhasääntöjä. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | meta-avoid-silverlight | Silverlight-verkkoresurssin käyttö on vanhentunut. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | remove-debug-script | Vältä muun muassa virheenkorjauskomentosarjan tekemistä muissa kuin kehitysympäristöissä. | Keskikokoinen | Käyttö |
| Verkkoresurssit | use-strict-mode | Käytä strict-tilaa, kun mahdollista. | Keskikokoinen | Käyttö |
| Verkkoresurssit | use-strict-equality-operators | Käytä tarkkoja yhtäläisyysoperaattoreita. | Keskikokoinen | Käyttö |
| Verkkoresurssit | avoid-eval | Älä käytä eval-funktiota tai sen toiminnallisia vastineita. | Kriittinen | Suojaus |
| Verkkoresurssit | avoid-with | Älä käytä with-operaattorin kanssa. | Suuri | Suorituskyky |
| Verkkoresurssit | remove-alert | Älä käytä alert-funktiota tai sen funktiovastineita. | Keskikokoinen | Käyttö |
| Verkkoresurssit | remove-console | Vältä metodien käyttöä konsolissa. | Keskikokoinen | Käyttö |
| Verkkoresurssit | avoid-ui-refreshribbon | Vältä käyttämästä kohdetta refreshRibbon, jos käytössä on lomakkeen onload ja EnableRule. | Kriittinen | Suorituskyky |
| Verkkoresurssit | use-getsecurityroleprivilegesinfo | Vältä kohteen userSettings.securityRolePrivileges käyttöä. Käytä sen sijaan kohdetta userSettings.getSecurityRolePrivilegesInfo. | Suuri | Suorituskyky |
| Verkkoresurssit | use-appsidepane-api | Käytä Xrm.App.sidePanes.createPane-ohjelmointirajapintaa Xrm.Panels.loadPanel-ohjelmointirajapinnan sijaan. | Keskikokoinen | Päivitysvalmius |
| Verkkoresurssit | web-sdl-no-cookies | HTTP-evästeet on vanha asiakasohjelmapuolen tallennusmekanismi, joka sisältää riskejä ja rajoituksia. Sen sijaan kannattaa käyttää verkkotallennusta, IndexedDB-menetelmää tai muita moderneja menetelmiä. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-document-domain | Kirjoitukset document.domain-ominaisuuteen on tarkistettava, jotta samaa alkuperää koskevia tarkistuksia ei ohiteta. Ylätason toimialueiden, kuten azurewebsites.net, käyttö on ehdottomasti kielletty. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-document-write | document.write- tai document.writeln-kutsut käsittelevät DOM-mallia suoraan ilman, että niitä puhdistettaisiin, ja niitä onkin vältettävä. Sen sijaan kannattaa käyttää document.createElement()-menetelmää tai vastaavia menetelmiä. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-html-method | Suorat method html() -kutsut käsittelevät usein (esimerkiksi jQuery-kehyksessä) DOM-mallia ilman, että niitä puhdistettaisiin, ja niitä onkin vältettävä. Sen sijaan kannattaa käyttää document.createElement()-menetelmää tai vastaavia menetelmiä. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-inner-html | Määritykset innerHTML- tai outerHTML-ominaisuuksiin käsittelevät DOM-mallia suoraan ilman, että niitä puhdistettaisiin, ja niitä onkin vältettävä. Sen sijaan kannattaa käyttää document.createElement()-menetelmää tai vastaavia menetelmiä. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-insecure-url | Suojaamattomat protokollat, kuten HTTP ja FTP, on korvattava salatuilla versioilla (HTTPS, FTPS), jotta mahdollisesti luottamuksellisia tietoja ei lähetetä vain tekstinä epäluotettavien verkkojen kautta. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-msapp-exec-unsafe | MSApp.execUnsafeLocalFunction()-kutsut ohittavat komentosarjainjektion vahvistuksen ja niitä pitäisi välttää. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-postmessage-star-origin | Anna aina tietty kohdelähde , ei * lähetettäessä tietoja muihin ikkunoihin postMessage-määrityksen avulla. Näin voit välttää tietovuodot luottamusrajan ulkopuolelle. | Keskikokoinen | Suojaus |
| Verkkoresurssit | web-sdl-no-winjs-html-unsafe | WinJS.Utilities.setInnerHTMLUnsafe()-kutsut ja vastaavat menetelmät eivät tarkista syötettä millään tavoin, ja niitä onkin vältettävä. Käytä sen sijaan WinJS.Utilities.setInnerHTML()-menetelmää. | Keskikokoinen | Suojaus |
| Pohjaan perustuva sovellus | app-formula-issues-high | Lisätietoja on Power Apps -kaavojen viitteissä. | Kriittinen | Suunnittelu |
| Pohjaan perustuva sovellus | app-formula-issues-medium | Lisätietoja on Power Apps -kaavojen viitteissä. | Keskikokoinen | Suunnittelu |
| Pohjaan perustuva sovellus | app-formula-issues-low | Lisätietoja on Power Apps -kaavojen viitteissä. | Matala | Suunnittelu |
| Pohjaan perustuva sovellus | app-use-delayoutput-text-input | Paranna tehokkuutta käyttämällä joissakin skenaarioissa viivästynyttä kuormitusta. | Keskikokoinen | Suorituskyky |
| Pohjaan perustuva sovellus | app-reduce-screen-controls | Voit rajoittaa sovelluksen ohjausobjektien määrää tehokkuuden parantamiseksi. | Keskikokoinen | Suorituskyky |
| Pohjaan perustuva sovellus | app-include-accessible-label | Voit parantaa sovellusten käytettävyyttä käyttämällä eksplisiittisiä otsikoita. | Keskikokoinen | Helppokäyttötoiminnot |
| Pohjaan perustuva sovellus | app-include-alternative-input | Varmista, että kaikissa vuorovaikutteisissa elementeissä on käytössä vaihtoehtoiset syötteet. | Keskikokoinen | Helppokäyttötoiminnot |
| Pohjaan perustuva sovellus | app-avoid-autostart | Vältä automaattisen käynnistyksen käyttöä sovelluksen toistotoiminnoissa. | Keskikokoinen | Helppokäyttötoiminnot |
Katso myös
Parhaat käytännöt ja ohjeet Dataverseen
Mallipohjaisten sovellusten parhaat käytännöt ja ohjeet
Ratkaisun tarkistustoimintoon liittyvät yleiset ongelmat ja niiden ratkaisut
Huomautus
Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)
Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).
Palaute
Tulossa pian: Vuoden 2024 aikana poistamme asteittain GitHub Issuesin käytöstä sisällön palautemekanismina ja korvaamme sen uudella palautejärjestelmällä. Lisätietoja on täällä: https://aka.ms/ContentUserFeedback.
Lähetä ja näytä palaute kohteelle