Bežné problémy a riešenia pre nástroj na kontrolu riešení

Tento článok uvádza niektoré bežné problémy, ktoré sa môžu vyskytnúť pri používaní nástroja na kontrolu riešení. V prípade potreby sú uvedené riešenia.

Na spustenie analýzy alebo na prevzatie výsledkov nemôžete použiť nástroj na kontrolu riešení

Krátko po odoslaní požiadavky na kontrolu riešenia na spustenie analýzy alebo stiahnutie výsledkov sa operácia nedokončí a zobrazí sa chybové hlásenie, ako napríklad:

„Nepodarilo sa nám spustiť kontrolu riešenia [Názov riešenia]. Skúste to spustiť znova.“

Vždy, keď je to možné, sa nástroj na kontrolu riešenia sa pokúša vrátiť špecifické chybové hlásenie s odkazom na podrobnosti o možných príčinách a krokoch riešenia. Podrobnosti si prečítajte po stlačení možnosti 'Ďalšie informácie'.

Poruchy, ku ktorým dôjde počas spracovania na pozadí analýzy, sa nepodaria so stavom "Nedá sa dokončiť" a vráti chybové hlásenie na portáli Power Apps a súčasne odošle e-mailové upozornenie žiadateľovi.

Výberom oznámenia na portáli sa prepojí na túto stránku bežných problémov na ďalšie riešenie problémov. Ak niektorý z uvedených bežných problémov problém nevyrieši, vráti sa aj referenčné číslo. Poskytnite toto referenčné číslo technickej podpore spoločnosti Microsoft na ďalšie vyšetrovanie.

Nástroju na kontrolu riešení sa nepodarilo skontrolovať predvolené riešenie

Nástroj na kontrolu riešení exportuje riešenie z prostredia Microsoft Power Platform na analýzu. Export predvoleného riešenia nie je podporovaný a kontrola sa nemusí úspešne dokončiť. Viac informácií: Nástroju na kontrolu riešení sa nepodarilo exportovať veľké riešenia.

Prevádzka nástroja na kontrolu riešení zlyhala z dôvodu nepodporovanej verzie nástroja na kontrolu Power Apps

Nástroj na kontrolu riešení je aktivovaný aplikáciou nástroja na kontrolu Power Apps. Ak máte nainštalovanú aplikáciu nástroja na kontrolu Power Apps staršiu ako 1.0.0.47, nástroj na kontrolu riešení sa nemusí úspešne ukončiť. Mali by ste inovovať verziu nástroja na kontrolu Power Apps z Centrum spravovania služby Power Platform.

Ak však máte nainštalovanú staršiu verziu nástroja na kontrolu Power Apps než 1.0.0.45, odporúčame odstrániť toto riešenie a znova ho nainštalovať. Vzhľadom na nedávne zmeny schémy môže inovácia nástroja na kontrolu Power Apps z verzií starších než 1.0.0.45 zlyhať.

Ak chcete zachovať predchádzajúce výsledky z nástroja na kontrolu riešení, exportujte výsledky z predchádzajúcich spustení alebo exportujte všetky údaje nástroja na kontrolu riešení pomocou funkcie Export údajov do programu Excel, kde sa exportujú údaje z týchto tabuliek:

• Súčasť analýzy
• Úloha analýzy
• Výsledok analýzy
• Podrobnosť o výsledku analýzy

Ako nainštalovať Power Apps Checker

Odinštalovanie nástroja na kontrolu Power Apps:

1. Ako správca systému alebo prispôsobovač systému otvorte portál Power Apps na stránke https://make.powerapps.com/environments.
2. Vyberte Riešenia.
3. Vyberte Power Apps Checker potom na nástrojovej lište riešení vyberte Odstrániť.

Ako nainštalovať nástroj na kontrolu Power Apps

Ak chcete nainštalovať nástroj na kontrolu Power Apps späť do svojho prostredia:

1. Ako správca systému alebo prispôsobovač systému otvorte svoj portál Power Apps na stránke https://make.powerapps.com/environments.
2. Vyberte Riešenia.
3. Na nástrojovej lište riešení vyberte Nástroj na kontrolu riešení a potom položku Nainštalovať.

Nástroj na kontrolu nemôže pristupovať k prostrediam v režime správy

Prostredia, ktoré boli umiestnené do Režimu správy zámerne obmedzia prístup len na používateľov s rolami System Administrator a System Customizer. Pretože identita aplikácie nástroja na kontrolu Power Apps nemá predvolene priradenú žiadnu z týchto rolí, nemôže pristupovať k organizáciám pracujúcim v tomto režime.

Aby bolo možné v tejto organizácii používať nástroj na kontrolu riešenia, musí byť deaktivovaný režim správcu.

Spôsob deaktivácie režimu správcu

Deaktivácia režimu správcu pre inštanciu organizácie:

1. Prihláste sa do centra spravovania Power Platform.

2. Otvorte prostredie, ktoré má problémy so spustením kontroly riešení, a potom vyberte Editovať.

3. Deaktivujte Režim správy a potom stlačte možnosť Uložiť.

   

4. Spustite nástroj na kontrolu riešení znova.

Nástroj na kontrolu riešení zlyhá v dôsledku chýbajúcich rol zabezpečenia

Používateľ aplikácie pre kontrolu riešení vyžaduje priradené nasledujúce roly zabezpečenia, aby mohol poskytnúť potrebné privilégiá na komunikáciu s Dataverse organizáciou. Ak žiadna z týchto rolí nie je priradená používateľovi 'Power Apps Aplikácia kontroly', pokusy o spustenie analýzy, stiahnutie výsledkov a zrušenie spustenia budú zlyhať. K tomu dochádza najčastejšie, keď majú zákazníci automatizáciu na mieste, ktorá odstraňuje úlohy zabezpečenia od neočakávaných používateľov. Nasledujúce bezpečnostné roly obsahujú minimálne požadované povolenia:

• Exportovať prispôsobenia (kontrola riešení)
• Servisný poradca
• Nástroj na kontrolu riešení

Priradenie chýbajúcich bezpečnostných rol

Ak chcete priradiť chýbajúce roly zabezpečenia používateľovi Power Apps Checker Application:

1. V Power Platform centre spravovania prejdite do svojho prostredia a potom na zoznam používateľov aplikácie Používatelia > ·.
2. Zo zoznamu používateľov vyberte používateľa 'Power Apps Kontrolná aplikácia' .
3. Na paneli príkazov vyberte Upraviť roly zabezpečenia .
4. Začiarknite políčka pre roly uvedené vyššie a potom vyberte Uložiť.
5. Spustite nástroj na kontrolu riešení znova.

Nástroj na kontrolu riešení zlyhá kvôli režimu obmedzeného prístupu

Používateľ nástroja na kontrolu riešení vyžaduje režim prístupu Neinteraktívne alebo Čítanie aj zápis s cieľom komunikovať s organizáciou Dataverse. Ak bol prístupový režim zmenený na inú hodnotu, napr. ,Správa', potom pokusy o spustenie analýzy, výsledky sťahovania a spustenie zrušenia zlyhajú.

Ak chcete vyriešiť tento problém, musíte aktualizovať používateľa aplikácie Power Apps Checker režimom „Neinteraktívneho“ prístupu.

Spôsob aktualizácie režimu prístupu používateľa

Ak chcete aktualizovať režim prístupu pre používateľa Kontrola v rámci platformy Power Apps:

1. Otvorte svoju organizáciu Dataverse a prejdite na Nastavenia > Zabezpečenie > Používatelia.
2. Vyberte používateľa Power Apps Checker v rámci platformy PowerApps' zo zoznamu používateľov a dvojitým kliknutím otvorte formulár používateľa.
3. Prejdite na položku formulára 'Správa' > Informácie o licencii klientskeho prístupu (LKP).
4. V rozbaľovacej ponuke zvoľte možnosť 'Neinteraktívne' v časti Režim prístupu.

5. Uložte a zatvorte používateľský formulár.
6. Spustite nástroj na kontrolu riešení znova.

Nástroj na kontrolu riešení zlyhá v dôsledku deaktivovaného používateľa aplikácie

Používateľ aplikácie na kontrolu Power Apps v organizácii Dataverse obsahujúcej riešenia na analýzu musí byť povolený. Ak sa užívateľ aplikácie deaktivuje, požiadavky na analýzu riešení v tej istej organizácii zlyhajú. Ak sa zobrazí toto chybové hlásenie, najprv overte, či používateľ aplikácie na kontrolu Power Apps je skutočne zakázaný. Potom postupujte podľa krokov na riešenie, ktoré sú uvedené nižšie.

Ako povoliť používateľa aplikácie na kontrolu Power Apps

1. V centre spravovania Power Platform vyberte prostredie a prejdite do ponuky Nastavenia > Používatelia + Povolenia > Používatelia.
2. V zobrazení Používatelia aplikácie vyberte značku začiarknutia vedľa používateľa aplikácie na kontrolu Power Apps.
3. Na paneli s nástrojmi Akcie vyberte položku Povoliť.

4. V správe Potvrdiť aktiváciu používateľa vyberte položku Aktivovať.
5. Alternatívnym prístupom je otvorenie používateľského formulára aplikácie a výber stavu Povolené v päte formulára. Uložte zmenu.

Solution checker zostáva v stave spustenia dlhšie ako 30 minút

Nástroj na kontrolu riešení môže zostať v spustenom stave na neurčito, ak analyzované riešenie obsahuje komponenty doplnkov vyvinuté pomocou .NET Standard 2.0. Pluginy používajúce .NET Standard 2.0 nie sú momentálne podporované v nástroji na kontrolu riešení a mali by byť vylúčené z analýzy. Vylúčte komponent doplnku buď jeho odstránením z cieľového riešenia, alebo použitím parametra „ExcludedFileNamePattern“ v Power Apps Modul Checker PowerShell.

Bežné podmienky doplnkov, ktoré spôsobujú zlyhanie nástroja na kontrolu riešení

Keď nástroj na kontrolu riešení dostane a spracuje požiadavky na analýzu, musí zavolať koncový bod Dataverse na načítanie/aktualizáciu relevantných údajov o úlohách a exportovanie vybratých riešení. Každá interakcia vykonaná službou nástroja na kontrolu riešení s Dataverse môže potenciálne spustiť jeden alebo viac krokov doplnku, ktoré boli zaregistrované v správe odoslanej v žiadosti. Tieto doplnky môžu zase zaviesť podmienky, ktoré bránia spracovaniu správy tak, ako to očakáva služba Dataverse a prerušiť schopnosť nástroja na kontrolu riešenia spracovať požadovanú analytickú úlohu. Podobné situácie sa môžu vyskytnúť pri sťahovaní výsledkov úloh nástroja na kontrolu riešenia alebo pri zrušení prebiehajúcej úlohy analýzy.

Typické operácie Dataverse požadované nástrojom na kontrolu riešenia:

• Získajte údaje riešenia systemuser a organizačnej tabuľky
• Vytváranie, aktualizácia a načítanie úloh analýzy, komponentov analýzy a údajov z tabuľky výsledkov analýz
• Export riešení

Krok doplnku zaregistrovaný na vykonanie v kontexte nelicencovaného používateľa

Keď kontrola riešenia zlyhá kvôli výnimke „používateľ bez licencie“, je to často spôsobené spusteným doplnkom krok nakonfigurovaným na spustenie v kontexte konkrétneho používateľa systému, ktorý momentálne nemá licenciu. Zaistite, aby sa všetky kroky doplnku, ktoré by mohli byť spustené nástrojom na kontrolu riešení, vykonali v kontexte licencovaného používateľa.

Dôležité

Dôrazne sa odporúča, aby boli kroky doplnku nakonfigurované tak, aby sa vykonávali v kontexte volajúceho používateľa, a nie konkrétnych používateľov, ktorí podliehajú zrušeniu pridelenej licencie.

Krok doplnku vykonáva operácie, ktoré vyžadujú privilégiá, ktoré neboli udelené používateľovi aplikácie na kontrolu Power Apps

Keď kontrola riešení zlyhá z dôvodu Dataverse odmietnutia prístupu na základe chýbajúceho privilégia, je to často spôsobené spusteným doplnkom krok, ktorý vykonáva operácie vyžadujúce privilégiá, ktoré nie sú momentálne udelené aplikácii Power Apps Checker užívateľ. Buď prekonfigurujte krok doplnku tak, aby sa nevykonával pri operácii vyvolanej nástrojom na kontrolu riešenia, alebo poskytnite používateľovi aplikácie na kontrolu Power Apps potrebné privilégiá na vykonanie kroku vlastného doplnku.

Krok doplnku neočakávane preruší vykonávanie vykonaním InvalidPluginExecutionException

Nástroj na kontrolu riešení môže zlyhať z dôvodu chýb „Kód ISV prerušil operáciu“ alebo „Došlo k neočakávanej chybe na strane kódu ISV“. Keď k tomu dôjde, znamená to, že bol spustený doplnok krok, ktorý explicitne prerušil vykonávanie vyvolaním výnimky InvalidPluginExcecutionException alebo že v kóde doplnku nebola správne zachytená chyba. Buď prekonfigurujte krok doplnku tak, aby sa nevykonával pri operácii vyvolanej nástrojom na kontrolu riešenia, alebo upravte implementáciu doplnku tak, aby neprerušoval vykonávanie na základe podmienok predložených nástrojom na kontrolu riešení.

Medzi bežné operácie vyvolané nástrojom na kontrolu riešenia patria Vytvoriť a Aktualizovať. Tieto operácie sa môžu vyskytnúť v nasledujúcich tabuľkách: Úloha analýzy, Komponent analýzy alebo Výsledok analýzy.

Kontrola riešení zlyhá kvôli zakázanej aplikácii prvej strany v Microsoft Entra ID

Identita podnikovej aplikácie prvej strany používaná nástrojom na kontrolu riešení (PowerApps-Advisor) by nemala byť zakázaná v Microsoft Entra ID. Ak je zakázaná, identita sa nemôže overiť pri žiadaní o tokeny nosiča pre Dataverse a iných požadovaných poskytovateľov prostriedkov v mene žiadajúceho používateľa.

Podľa nižšie uvedených krokov overte, či identita aplikácie nebola zakázaná v Microsoft Entra a v prípade potreby aplikáciu povoľte.

Spôsob overenia alebo úpravy povoleného stavu aplikácie

Ak chcete overiť alebo zmeniť povolený stav identity podnikovej aplikácie PowerApps-Advisor

1. Získajte prístup k svojmu nájomníkovi na Microsoft Entra Portáli.
2. Prejdite do časti Podnikové aplikácie.
3. Zvoľte možnosť Všetky aplikácie a vyhľadajte PowerApps-Advisor.

4. Zvoľte možnosť PowerApps-Advisor na zobrazenie podrobnosti aplikácie.
5. Stlačte možnosť Vlastnosti.
6. Skontrolujte stav Povolené prihlasovanie používateľov. Ak je stav 'Nie', aplikácia bola zakázaná.

7. Stlačte rádiový ovládací prvok a prepnite hodnotu na 'Áno'. Tým povolíte aplikáciu.

8. Vyberte položku Uložiť. Aplikácia je teraz povolená. Možno bude potrebné niekoľko minút počkať, kým dôjde k zmene.
9. Spustite nástroj na kontrolu riešení znova.

Dôležité

Ak chcete upravovať podnikové aplikácie, musíte mať oprávnenia správcu v Microsoft Entra ID (Microsoft Entra ID).

Nástroj na kontrolu riešení neúspešne exportoval riešenia s komponentmi konceptu toku obchodného procesu

Ak riešenie obsahuje komponent toku obchodných procesov v stave konceptu, ktorý ešte nebol predtým aktivovaný, potom nástroj na kontrolu riešení nedokáže exportovať riešenie na analýzu. Táto chyba nie je jedinečná pre kontrolu riešení a je spôsobená tým, že tok obchodného procesu má závislosť na podpornom (vlastnom) komponente tabuľky, ktorý sa nevytvorí, kým sa tok obchodného procesu prvýkrát neaktivuje. Tento problém sa môže vyskytnúť aj vtedy, ak je tok obchodných procesov aktivovaný v rámci prieskumníka riešení.

Prečítajte si KB Článok #4337537: Neplatný export – Tabuľka obchodného procesu chýba, kde nájdete podrobnosti o probléme a krokoch na jeho vyriešenie.

Kontrola riešení nedokáže exportovať riešenia s modelmi riadenými komponentmi aplikácií

Ak riešenie obsahuje aplikáciu riadenú modelom, nástroju na kontrolu riešení sa nemusí podariť exportovať riešenie na účely analýzy. Táto chyba je spôsobená bezpečnosťou zdieľania aplikácií na základe rolí. Ak používateľ aplikácie Power Apps Checker nemá primeraný prístup k aplikáciám riadeným modelom, všetky riešenia, ktoré ich obsahujú, sa nepodarí exportovať pomocou nástroja na kontrolu riešení.

Ak chcete vyriešiť tento problém, poskytnite rolu zabezpečenia Tvorca prostredia do používateľa aplikácie Power Apps Checker.

Nástroj na kontrolu riešení neúspešne exportoval opravené riešenia

Ak malo riešenie aplikovanú záplatu, nástroju na kontrolu riešení sa nepodarí exportovať riešenie na analýzu. Keď má riešenie aplikovanú záplatu, originálne riešenie sa uzamkne a nedá sa zmeniť ani exportovať dovtedy, pokiaľ sú tú závislé záplaty, ktoré existujú v organizácii, ktoré identifikujú riešenie ako nadradené riešenie.

Ak chcete vyriešiť tento problém, naklonujte riešenie tak, aby všetky záplaty, ktoré súvisia s riešením, boli nasadené na novovytvorenom riešení. To odomkne riešenia a umožní export riešenia zo systému. Ďalšie informácie: Klonovanie riešenia.

Kontrola riešení nebude analyzovať prázdne riešenia

Ak nástroj na kontrolu riešení exportuje riešenie, ktoré neobsahuje žiadne komponenty na analýzu, ukončí ďalšie spracovanie a považuje spustenie za zlyhanie. Uistite sa, že vybraté riešenie predložené pre analýzu nástroja na kontrolu riešení obsahuje aspoň jeden komponent.

Nástroj na kontrolu riešení neúspešne exportoval veľké riešenia

Primárny scenár pre zlyhanie exportu veľkého riešenia z prostredia vyžaduje výnimku časového limitu na exportnej požiadavke. K tomu dôjde, ak požiadavka presiahne 20 minút. Veľké riešenia, ako napríklad predvolené riešenie, sa nemusí v tomto časovom rámci exportovať a kontrola sa nedokončí úspešne. Ak nástroj na kontrolu riešenia počas exportu zaznamená časový limit, trikrát to zopakuje, kým sa mu nepodarí spracovať úlohu, takže môže trvať viac ako hodinu, kým dostanete upozornenie na zlyhanie.

Riešenie je vytvoriť menšie riešenia s menším počtom komponentov na analýzu. Ak veľká veľkosť súboru riešenia spôsobená mnohými komponentmi zostavy doplnku, prečítajte si návod na optimalizáciu vývoja vlastnej zostavy.

Dôležité

Na minimalizáciu falošných poplachov zabezpečte pridanie závislých prispôsobení. Pri vytváraní riešenia a pridávaní týchto komponentov zahrňte nasledujúce:

• Po pridávaní doplnkov zahrňte kroky spracovania správy súpravy SDK pre doplnok.
• Pri pridávaní formulárov tabuliek zahrňte webové zdroje JavaScript pripojené k udalostiam formulára.
• Pri pridávaní webových zdrojov JavaScript zahrňte všetky závislé webové zdroje JavaScript.
• Pri pridávaní webových zdrojov HTML zahrňte akékoľvek závislé skripty, ktoré sú definované v rámci webového zdroja HTML.
• Pri pridávaní vlastných pracovných postupov zahrňte zostavy použité v rámci pracovného postupu.

Odkazy na čísla riadkov pre problémy v zdrojoch HTML s vloženým kódom JavaScript nie sú správne

Keď webové zdroje HTML sú spracované v rámci nástroja na kontrolu riešení, webový zdroj HTML je spracovaný samostatne ako JavaScript vo webovom zdroji HTML. Z tohto dôvodu nebude číslo riadku porušenia zisteného v rámci <script> webového zdroja HTML správne.

Problémy so syntaxou nepodporované na webe pre webové zdroje

Kontrola riešení podporuje globálne premenné pre syntax ECMAScript 2015 (ES6) a do ECMAScript 2018 (ES9). Keď nástroj na kontrolu riešení analyzuje JavaScript pomocou globálnych premenných neskoršej verzie ako ES6 alebo syntaxe neskoršej ako ES9, nahlási sa problém webovej nepodporovanej syntaxe pre webový prostriedok.

Viacnásobné porušenie hlásené pre zásuvné moduly a aktivity pracovných postupov na základe rozsahu volaní

V prípade zásuvných modulov a pravidiel aktivita pracovného postupu, kde je problém relevantný iba v kontexte volania, nástroj na kontrolu riešení spustí svoju analýzu pri implementácii rozhrania IPlugin a prejde grafom hovoru, aby zistil problémy v rámci tohto implementáciu. V niektorých prípadoch môže mnoho volacích ciest prísť na rovnaké miesto, kde je zistený problém. Pretože problém sa týka rozsahu volania, nástroj môže vytvoriť správu na základe tohto rozsahu a poskytovať lepší obraz o dopade než o odlišných miestach. V dôsledku môžu viaceré problémy odkazovať na jedno miesto, ktoré je potrebné opraviť.

app-formula-issues-high môže vykazovať iný počet chýb ako tie, ktoré sa zobrazujú v režime návrhu

Kontrola riešení uvádza počet chýb nájdených v aplikácii, vrátane chýb z testov. Kontrola aplikácií v návrhovom režime zobrazuje iba chyby ovládacích prvkov obrazovky a komponentov. Ak je počet chýb zobrazených v nástroji na kontrolu aplikácií v dizajnovom režime menší, otvorte Test Studio a vyhľadajte chyby vo výrazoch použitých v testoch.

Nahlásené porušenia kontroly riešení pre komponenty kódu

Kontrola riešení hlási viacero porušení pri spustení na riešení, ktoré má komponenty kódu zabudované v režime ladenia. Jedna bežná chyba, ktorá sa vyskytuje v režime ladenia, je web-avoid-eval. Kontrola riešení je zameraná na overenie kódu pre produkčné použitie, takže komponenty kódu musia byť zostavené pomocou správneho buildMode: npm run build -- --buildMode production alebo msbuild /p:configuration=Release v závislosti od vášho stavebného systému. Ďalšie informácie: Vytvorte a zostavte komponent kódu

Ak sa vyskytnú chyby v bundle.js vložené komponentmi kódu, môžete tento súbor vylúčiť z analýzy. Viac informácií: Microsoft.PowerApps. Modul Checker.PowerShell a PAC CLI

Pozrite si tiež

Osvedčené postupy a usmernenie pre Dataverse

Najlepšie postupy a usmernenia pre aplikácie riadené modelom

Poznámka

Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)

Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).