Masalah umum dan resolusi untuk pemeriksa solusi

Artikel ini berisi daftar beberapa masalah umum yang mungkin Anda temui saat menggunakan pemeriksa solusi. Bila berlaku, solusi akan diberikan.

Anda tidak dapat menggunakan pemeriksa solusi untuk menjalankan analisis atau mengunduh hasil

Segera setelah mengajukan permintaan pemeriksa solusi untuk menjalankan analisis atau mengunduh hasil, operasi tidak selesai dan pesan kesalahan ditampilkan, seperti:

"Kami tidak dapat menjalankan pemeriksaan solusi di [Nama Solusi] Coba jalankan lagi."

Bila memungkinkan, pemeriksa solusi akan mencoba menghasilkan pesan kesalahan tertentu dengan tautan untuk rincian tentang potensi penyebab dan langkah pemecahan masalah. Pilih 'Pelajari lebih lanjut' untuk rincian.

Kegagalan yang terjadi selama pemrosesan latar belakang analisis akan gagal dengan status ' tidak dapat diselesaikan ' dan menghasilkan pesan kesalahan di portal Power Apps serta mengirim pemberitahuan email ke pemohon.

Memilih portal pemberitahuan akan menautkan ke Halaman masalah umum ini untuk pemecahan masalah lebih lanjut. Jika salah satu masalah umum yang diberikan tidak menyelesaikan masalah, nomor referensi juga akan dihasilkan. Berikan nomor referensi ini ke dukungan Microsoft untuk investigasi lebih lanjut.

Pemeriksa solusi gagal memeriksa Solusi default

Pemeriksa solusi mengekspor solusi dari lingkungan Microsoft Power Platform untuk analisis. Mengekspor solusi Default tidak didukung dan pemeriksaan mungkin tidak berhasil diselesaikan. Informasi lebih lanjut: pemeriksa solusi gagal mengekspor solusi besar.

Pemeriksa solusi gagal karena versi pemeriksa Power Apps yang tidak didukung

Pemeriksa solusi adalah fitur yang diaktifkan oleh aplikasi pemeriksa Power Apps. Jika Anda telah menginstal aplikasi pemeriksa Power Apps lebih awal dari 1.0.0.47, pemeriksa solusi mungkin gagal untuk berhasil diselesaikan. Anda harus meningkatkan versi pemeriksa Power Apps Anda dari Pusat admin Power Platform.

Namun, jika Anda memiliki versi pemeriksa Power Apps lebih awal dari versi 1.0.0.45 diinstal, sebaiknya Anda menghapus solusi dan menginstal lagi. Karena perubahan skema terbaru, peningkatan dari pemeriksa Power Apps dari versi lebih awal dari versi 1.0.0.45 mungkin akan gagal.

Jika Anda ingin menyimpan hasil pemeriksa solusi sebelumnya, ekspor hasil dari operasi sebelumnya atau ekspor semua data pemeriksa solusi dengan menggunakan Ekspor data ke Excel untuk mengekspor data dari tabel berikut:

• Komponen Analisis
• Tugas Analisis
• Hasil Analisis
• Rincian Hasil Analisis

Cara Menghapus instalan Pemeriksa Power Apps

Untuk menghapus instalan solusi pemeriksa Power Apps:

1. Sebagai Administrator sistem atau penyesuai sistem, buka Power Apps portal dengan membuka https://make.powerapps.com/environments.
2. Pilih Solusi.
3. Pilih Pemeriksa Power Apps, lalu pada toolbar solusi pilih Hapus.

Cara menginstal Pemeriksa Power Apps

Untuk menginstal Power Apps Checker kembali ke lingkungan Anda:

1. Sebagai Administrator sistem atau penyesuai sistem, buka portal Power Apps Anda dengan membuka https://make.powerapps.com/environments.
2. Pilih Solusi.
3. Di bilah alat solusi, pilih Pemeriksa Solusi, lalu pilih Instal.

Pemeriksa solusi tidak dapat mengakses lingkungan dalam mode administrasi

Lingkungan yang telah ditempatkan ke dalam mode administrasi sengaja membatasi akses ke hanya pengguna dengan peran Adminstrator sistem dan penyesuai sistem. Karena identitas aplikasi Power Apps Checker tidak menetapkan peran ini secara default, ia tidak dapat mengakses organisasi yang beroperasi dalam mode ini.

Untuk menggunakan pemeriksa solusi dalam organisasi ini, mode Administrasi harus dinonaktifkan.

Cara menonaktifkan mode administrasi

Untuk menonaktifkan mode administrasi untuk instans organisasi:

1. Masuk ke pusat admin Power Platform.

2. Buka lingkungan yang memiliki masalah menjalankan Pemeriksa solusi, lalu pilih Edit.

3. Atur modus administrasi ke dinonaktifkan, dan kemudian pilih Simpan.

   

4. Jalankan pemeriksa solusi kembali.

Pemeriksa solusi gagal karena peran keamanan yang hilang

Pengguna aplikasi untuk pemeriksa solusi memerlukan dua peran keamanan yang ditetapkan untuk memberikan hak istimewa yang diperlukan untuk berkomunikasi dengan Dataverse organisasi. Jika salah satu peran ini tidak ditetapkan ke pengguna 'Power Apps Checker ', usaha menjalankan analisis, mengunduh hasil, dan menjalankan pembatalan akan gagal. Hal ini sering terjadi saat pelanggan telah memiliki otomatisasi yang menghilangkan peran keamanan dari pengguna yang tidak diharapkan. Peran keamanan berikut berisi izin minimum yang diperlukan:

• Ekspor kustomisasi
• Pemeriksa solusi

Cara menetapkan peran keamanan yang hilang

Untuk menetapkan peran keamanan yang hilang ke pengguna pemeriksa Power Apps:

1. Buka organisasi Dataverse Anda dan navigasi ke pengaturan > Keamanan > Pengguna.
2. Pilih pengguna 'Power Apps Checker ' dari daftar pengguna.
3. Di bilah perintah, pilih KELOLA PERAN.
4. Pilih kotak centang ' ekspor penyesuaian ' dan ' pemeriksa solusi ', lalu pilih OK.

5. Jalankan pemeriksa solusi kembali.

Pemeriksa solusi gagal karena mode akses terbatas

Pengguna aplikasi untuk pemeriksa solusi memerlukan mode akses ' non-interaktif ' atau ' baca-tulis ' agar dapat berkomunikasi dengan organisasi Dataverse. Jika mode akses telah diubah ke nilai lain seperti "administratif", maka usaha menjalankan analisis, Unduh hasil, dan jalankan pembatalan akan gagal.

Untuk mengatasi masalah ini, Anda harus memperbarui pengguna aplikasi 'Power Apps Checker' dengan mode akses ' non-interaktif '.

Cara memperbarui mode akses pengguna

Untuk memperbarui mode akses untuk pengguna pemeriksa Power Apps:

1. Buka organisasi Dataverse Anda dan navigasi ke pengaturan > Keamanan > Pengguna.
2. Pilih pengguna 'Power Apps Checker ' dari daftar pengguna dan klik dua kali untuk membuka formulir pengguna.
3. Gulir ke bagian ' administrasi ' > 'Informasi izin akses klien (CAL)' dari formulir.
4. Pilih ' non-interaktif ' dalam kontrol drop- down mode akses.

5. Simpan dan tutup formulir pengguna.
6. Jalankan pemeriksa solusi kembali.

Pemeriksa solusi gagal karena pengguna aplikasi yang dinonaktifkan

Pengguna aplikasi pemeriksa Power Apps di organisasi Dataverse yang berisi solusi yang akan dianalisis harus diaktifkan. Jika pengguna aplikasi dinonaktifkan, permintaan untuk menganalisis solusi di organisasi yang sama akan gagal. Jika menerima pesan kesalahan ini, pertama Verifikasikan bahwa pengguna aplikasi pemeriksa Power Apps memang dinonaktifkan. Kemudian ikuti langkah-langkah mitigasi yang diberikan di bawah ini.

Cara mengaktifkan pengguna aplikasi pemeriksa Power Apps

1. Di pusat admin Power Platform, pilih lingkungan dan buka pengaturan > pengguna+izin > pengguna.
2. Dalam tampilan pengguna aplikasi, pilih tanda centang di sebelah pengguna aplikasi pemeriksa Power Apps.
3. Pada toolbar tindakan, pilih Aktifkan.

4. Dalam pesan Konfirmasikan Pengaktifan Pengguna, pilih Aktifkan.
5. Pendekatan alternatif adalah membuka formulir pengguna aplikasi dan memilih status diaktifkan di footer formulir. Simpan perubahan.

Pemeriksa solusi tetap dalam status Berjalan selama lebih dari tiga puluh menit

Pemeriksa solusi dapat tetap dalam keadaan berjalan tanpa batas waktu jika solusi yang dianalisis berisi komponen plugin yang dikembangkan menggunakan .NET Standard 2.0. Plugin yang menggunakan .NET Standard 2.0 saat ini tidak didukung dalam pemeriksa solusi dan harus dikecualikan dari analisis. Kecualikan komponen plugin dengan menghapusnya dari solusi target, atau dengan menggunakan parameter 'ExcludedFileNamePattern' dalam Power Apps modul Checker PowerShell.

Persyaratan plugin umum yang menyebabkan pemeriksa solusi gagal

Bila pemeriksa solusi menerima dan memproses permintaan analisis, permintaan harus memanggil titik akhir Dataverse untuk mengambil/memperbarui data pekerjaan yang relevan dan mengekspor solusi yang dipilih. Setiap interaksi yang dibuat oleh layanan pemeriksa solusi dengan Dataverse kemungkinan dapat memicu satu atau beberapa langkah plugin yang telah didaftarkan pada pesan yang dikirim dalam permintaan. Plugin ini dapat pada gilirannya memperkenalkan kondisi yang mencegah pesan ditangani sebagaimana mestinya oleh Dataverse dan mengganggu kemampuan pemeriksa solusi untuk memproses pekerjaan analisis yang diminta. Situasi serupa dapat terjadi saat mengunduh hasil pekerjaan pemeriksa solusi atau membatalkan pekerjaan analisis yang sedang berjalan.

Operasi Dataverse umum yang diminta oleh pemeriksa solusi:

• Mengambil solusi, systemuser, dan data tabel organisasi
• Membuat, memperbarui, dan mengambil pekerjaan analisis, komponen analisis, dan data hasil analisis tabel
• Mengekspor solusi

Langkah plugin yang terdaftar untuk dieksekusi dalam konteks pengguna yang tidak berlisensi

Ketika pemeriksa solusi gagal karena pengecualian "pengguna tidak berlisensi", hal ini sering disebabkan oleh langkah plugin yang dipicu yang dikonfigurasi untuk dijalankan dalam konteks pengguna sistem tertentu yang saat ini tidak berlisensi. Pastikan bahwa setiap langkah plugin yang dapat dipicu oleh pemeriksa solusi dijalankan dalam konteks pengguna berlisensi.

Penting

Sangat disarankan agar langkah-langkah plugin dikonfigurasi untuk dijalankan dalam konteks pengguna yang memanggil daripada pengguna tertentu yang tergantung pada lisensi yang ditetapkan dan dicabut.

Langkah plugin melakukan operasi yang memerlukan hak yang tidak diberikan untuk pengguna aplikasi pemeriksa Power Apps

Ketika pemeriksa solusi gagal karena Dataverse menolak akses berdasarkan hak yang tidak ada, hal ini sering disebabkan oleh langkah plugin yang dipicu yang melakukan operasi yang memerlukan hak istimewa yang saat ini tidak diberikan kepada pengguna aplikasi pemeriksa Power Apps. Konfigurasikan ulang langkah plugin untuk tidak dieksekusi pada operasi yang dijalankan oleh pemeriksa solusi atau berikan hak istimewa yang diperlukan kepada pengguna aplikasi pemeriksa Power Apps untuk menjalankan langkah plugin kustom.

Langkah plugin tiba-tiba menginterupsi eksekusi dengan memunculkan InvalidPluginExecutionException

Pemeriksa solusi mungkin gagal karena kesalahan "kode ISV membatalkan operasi" atau "kesalahan tak terduga terjadi dari kode ISV". Saat ini terjadi, hal ini menunjukkan bahwa langkah plugin dipicu yang secara eksplisit mengganggu eksekusi dengan menampilkan InvalidPluginExcecutionException atau kesalahan tidak tertangkap dengan benar dalam kode plugin. Konfigurasikan ulang langkah plugin untuk tidak dieksekusi pada operasi yang dijalankan oleh pemeriksa solusi atau sesuaikan penerapan plugin untuk tidak menginterupsi eksekusi berdasarkan kondisi yang disajikan oleh pemeriksa solusi.

Operasi umum yang dijalankan oleh pemeriksa solusi mencakup pembuatan dan pembaruan. Operasi ini dapat terjadi pada tabel berikut: Pekerjaan Analisis, Komponen Analisis, atau Hasil Analisis.

Pemeriksa solusi gagal karena aplikasi pihak pertama dinonaktifkan di Azure Active Directory

Identitas aplikasi perusahaan pihak pertama yang digunakan oleh pemeriksa solusi (PowerApps-Advisor) tidak boleh dinonaktifkan di Azure Active Directory (AAD). Jika dinonaktifkan, identitas tidak dapat mengotentikasi saat meminta token pemegang untuk Dataverse dan penyedia sumber daya lain yang diperlukan atas nama pengguna yang meminta.

Ikuti langkah-langkah berikut untuk memverifikasi bahwa identitas aplikasi belum dinonaktifkan di AAD dan jika perlu mengaktifkan aplikasi.

Cara memverifikasi dan/atau memodifikasi status diaktifkan aplikasi

Untuk memverifikasi dan/atau memodifikasi status diaktifkan dari identitas aplikasi PowerApps-Advisor Enterprise

1. Akses penyewa Anda di portal Azure Active Directory (AAD).
2. Navigasikan ke aplikasi Enterprise.
3. Pilih semua aplikasi dan Cari 'PowerApps-Advisor '.

4. Pilih 'PowerApps-Advisor ' untuk melihat rincian aplikasi.
5. Pilih properti.
6. Periksa status diaktifkan untuk pengguna untuk masuk. Jika ' tidak ', maka aplikasi telah dinonaktifkan.

7. Pilih kontrol radio untuk mengalihkan nilai ke ' ya '. Hal ini mengaktifkan aplikasi.

8. Pilih Simpan. Kini Aplikasi Diaktifkan. Anda mungkin harus menunggu beberapa menit agar perubahan diterapkan.
9. Jalankan pemeriksa solusi kembali.

Penting

Anda harus memiliki hak istimewa administrator di Azure Active Directory (AAD) untuk mengedit aplikasi Enterprise.

Pemeriksa solusi gagal mengekspor solusi dengan komponen alur proses bisnis draf

Jika solusi berisi komponen alur proses bisnis dalam keadaan draf yang belum pernah diaktifkan sebelumnya, maka pemeriksa solusi akan gagal mengekspor solusi untuk analisis. Kesalahan ini tidak unik untuk pemeriksa solusi dan disebabkan oleh alur proses bisnis yang memiliki ketergantungan pada komponen tabel dukungan (kustom) yang tidak dibuat hingga alur proses bisnis diaktifkan untuk pertama kalinya. Masalah ini juga dapat terjadi jika alur proses bisnis diaktifkan dari dalam penjelajah solusi.

LIhat Artikel KB #4337537: Ekspor Tidak Valid - Tabel Proses Bisnis Hilang untuk rincian tentang masalah dan langkah-langkah untuk mengatasinya.

Pemeriksa solusi gagal mengekspor solusi dengan komponen aplikasi yang diarahkan model

Jika solusi berisi aplikasi berbasis model, pemeriksa solusi mungkin gagal mengekspor solusi untuk analisis. Kesalahan ini disebabkan oleh keamanan berbasis peran untuk berbagi aplikasi. Jika pengguna aplikasi pemeriksa Power Apps tidak memiliki akses yang sesuai ke aplikasi berdasarkan model, solusi apa pun yang meliputinya akan gagal diekspor dengan pemeriksa solusi.

Untuk mengatasi masalah ini, berikan peran keamanan pembuat lingkungan ke pengguna aplikasi pemeriksa Power Apps.

Pemeriksa solusi gagal mengekspor solusi tambahan

Jika solusi telah menerapkan tambalan, pemeriksa solusi akan gagal mengekspor solusi untuk analisis. Bila solusi telah memiliki patch diterapkan, solusi asli menjadi terkunci dan tidak dapat diubah atau diekspor selama ada patch dependen yang ada di organisasi yang mengidentifikasi solusi sebagai solusi induk.

Untuk mengatasi masalah ini, duplikasi solusi sehingga semua patch yang terkait dengan solusi diluncurkan ke solusi yang baru dibuat. Ini membuka solusi dan memungkinkan solusi diekspor dari sistem. Informasi selengkapnya: lihat Kloning solusi.

Pemeriksa Solusi tidak akan menganalisis solusi yang kosong

Jika pemeriksa solusi mengekspor solusi yang tidak berisi komponen untuk dianalisis, itu akan menghentikan pemrosesan lebih lanjut dan menganggap menjalankan kegagalan. Pastikan bahwa solusi yang dipilih yang dikirimkan untuk analisis pemeriksa solusi berisi setidaknya satu komponen.

Pemeriksa solusi gagal mengekspor solusi besar

Skenario utama untuk kegagalan mengekspor solusi besar dari lingkungan melibatkan pengecualian batas waktu pada permintaan ekspor. Hal ini akan terjadi jika permintaan melebihi 20 menit. Solusi besar, seperti solusi Default, mungkin akan gagal untuk diekspor dalam kerangka waktu ini, dan periksa tidak akan diselesaikan dengan berhasil. Jika Pemeriksa Solusi mengalami waktu habis selama ekspor, ia akan mencoba lagi tiga kali sebelum gagal untuk memproses pekerjaan, sehingga diperlukan waktu sekitar satu jam lebih sebelum Anda menerima pemberitahuan kegagalan.

Solusinya adalah membuat solusi yang lebih kecil dengan lebih sedikit komponen untuk dapat dianalisis. Jika ukuran file solusi besar karena banyak komponen Asembli plug-in, lihat panduan untuk mengoptimalkan pengembangan Asembli kustom.

Penting

Untuk meminimalkan kesalahan positif, pastikan Anda menambahkan penyesuaian dependen. Bila Anda membuat solusi dan menambahkan komponen ini, sertakan yang berikut:

• Bila Anda menambahkan plug-in, sertakan langkah pemrosesan pesan SDK untuk plug-in.
• Bila Anda menambahkan formulir tabel, sertakan sumber daya web JavaScript yang dilampirkan ke aktivitas formulir.
• Bila Anda menambahkan sumber daya web JavaScript, sertakan sumber daya web JavaScript dependen apa pun.
• Bila Anda menambahkan sumber daya web HTML, sertakan skrip dependen apa pun yang ditentukan dalam sumber daya web HTML.
• Bila Anda menambahkan alur kerja kustom, sertakan Asembli yang digunakan dalam alur kerja.

Referensi nomor baris untuk masalah sumber daya HTML dengan JavaScript tertanam tidak benar

Bila sumber daya web HTML diproses dalam Pemeriksa Solusi, sumber daya web HTML diproses secara terpisah dari JavaScript dalam sumber daya web HTML. Oleh karena itu, jumlah baris pelanggaran yang ditemukan dalam <script> sumber daya web HTML tidak akan benar.

Kesalahan web-avoid-eval untuk komponen kode Power Apps component framework

Jika kesalahan web-avoid-eval dilaporkan untuk komponen kode Power Apps component framework yang dibuat menggunakan alat CLI, kemas kontrol Anda dengan msbuild /p:configuration=Release atau npm run build -- --buildMode production untuk menghasilkan pembuatan rilis yang tidak mencakup penggunaan 'eval'.

Masalah sintaks yang tidak didukung web untuk sumber daya web

Solution Checker mendukung variabel global untuk sintaks ECMAScript 2015 (ES6) dan hingga ECMAScript 2018 (ES9). Bila pemeriksa solusi menganalisis JavaScript menggunakan variabel global setelah ES6, atau sintaksis lebih dari ES9, masalah sintaks web yang tidak didukung untuk sumber daya web dilaporkan.

Beberapa pelanggaran yang dilaporkan untuk plug-in dan aktivitas alur kerja berdasarkan cakupan panggilan

Untuk plug-in dan aturan aktivitas alur kerja di mana masalah ini hanya relevan dalam konteks panggilan, alat pemeriksa solusi memulai analisisnya di penerapan antarmuka IPlugin dan melintasi grafik panggilan untuk mendeteksi masalah dalam lingkup penerapan itu. Dalam beberapa kasus, banyak jalur panggilan mungkin tiba di lokasi yang sama di mana masalah terdeteksi. Karena masalah relevan dengan cakupan panggilan, alat dapat melaporkan dengan didasarkan pada cakupan tersebut untuk memberikan gambaran yang lebih baik atas dampak, bukan di lokasi yang berbeda. Oleh karena itu, beberapa masalah mungkin mengacu ke satu lokasi yang harus diperbaiki.

aplikasi-formula-masalah-tinggi mungkin menampilkan jumlah kesalahan yang berbeda dibandingkan yang ditampilkan dalam mode desain

Pemeriksa solusi akan mencantumkan jumlah kesalahan yang ditemukan di aplikasi, termasuk dari pengujian. Pemeriksa aplikasi dalam mode desain hanya menampilkan kesalahan dari kontrol layar dan komponen. Jika jumlah kesalahan yang ditampilkan dalam pemeriksa aplikasi dalam mode desain lebih kecil, buka Studio pengujian dan Cari kesalahan di ekspresi yang digunakan dalam pengujian.

Pelanggaran Pemeriksa Solusi yang dilaporkan untuk komponen kode

Pemeriksa Solusi melaporkan beberapa pelanggaran saat menjalankan solusi yang memiliki komponen kode yang dibangun dalam mode debug. Pemeriksa solusi ditargetkan untuk memvalidasi kode untuk penggunaan produksi, sehingga komponen kode harus dibuat menggunakan buildMode yang tepat: npm run build -- --buildMode production or msbuild /p:configuration=Release tergantung pada sistem pembangunan Anda. Informasi lebih lanjut Membuat dan membangun komponen kode.

Lihat juga

Praktik terbaik dan panduan untuk Dataverse

Praktik terbaik dan panduan untuk aplikasi berdasarkan model

Catatan

Apa bahasa dokumentasi yang Anda inginkan? Lakukan survei singkat. (perlu diketahui bahwa survei ini dalam bahasa Inggris)

Survei akan berlangsung kurang lebih selama tujuh menit. Tidak ada data pribadi yang dikumpulkan (pernyataan privasi).