Akış denetleyicisi

Çözüm denetleyicisindeki statik analiz özelliğiyle geliştirme iş akışınızı iyileştirin. Bu araç, robotik süreç otomasyonundaki (RPA) en iyi uygulamaları destekler ve en iyi performansı sağlamak için akışlarınızı otomatik olarak değerlendirerek kritik akış gereksinimlerini karşılar. Statik analiz, tasarımcının Akış denetleyicisi bölümünde kullanılabilir. Temel yönergeleri uygular ve gerçek zamanlı geri bildirim ve erken kod incelemesi sağlar. Doğrudan iş akışınıza entegre olur, kod kalitesini artırır ve daha verimli ve üretken bir geliştirme deneyimi için temel oluşturur.

Kural yönetimi

Power Platform yönetim merkezinde Çözüm denetleyicisi ve Power Automate portalında Akış denetleyicisi yapılandırması aracılığıyla kuralları tanımlayın ve yönetin.

Uygun izinlere sahip yöneticiler ve kullanıcılar şunları yapabilir:

• Kuralları etkinleştirin veya devre dışı bırakın.
• Önem düzeylerini (hata, uyarı, bilgi) yapılandırın.
• Eşikler ve sınırlar gibi parametreleri destekleyen kurallar için özel değerler yapılandırın (yalnızca portal Power Automate).
• Kuralları belirli ortamlara veya ortam gruplarına uygulayın (Yalnızca Yönetilen Ortamlar, Power Platform yönetim merkezi).

Akış denetleyicisi yapılandırması ortam düzeyinde uygulanır ve seçili ortamdaki tüm masaüstü akışlarını etkiler.

Power Platform yönetim merkezinde yapılandırdığınız çözüm denetleyicisi zorlama ayarları, Power Automate portalındaki Akış denetleyicisi yapılandırma ayarlarından önceliklidir. Power Automate portalında Çözüm denetleyicisi zorlaması aracılığıyla kısıtlanan kuralları değiştiremezsiniz.

Yönetim merkezinde yapılandırma

Statik analiz kurallarını yapılandırmak için:

1. Power Platform yönetim merkezine gidin.
2. Devam etmek için Yönet>Ortamlar'ı seçin.
3. Yönetilen ortamları düzenle'yi seçin.
4. Çözüm denetleyicisi zorlaması bölümünde, seçili ortam için hangi kuralların dışlanması gerektiğini yapılandırın.

Power Automate portalında yapılandırma

Bir ortam için Akış denetleyicisi kurallarını yapılandırmak için:

1. Power Automate portalında Masaüstü akışları sayfasına gidin.

2. Akış denetleyicisi'ne tıklayın.

3. Akış denetleyicisi yapılandırma bölmesinde, istenen kuralları yapılandırın. Her kural için şunları yapabilirsiniz:

   • Kuralı etkinleştirin veya devre dışı bırakın.
   • Bir önem düzeyi seçin.
   • Parametreleri destekleyen kurallar için özel bir değer belirtin.

4. Kaydetseçeneğini seçin.

Yapılandırma değişiklikleri ortam düzeyinde uygulanır ve seçili ortamdaki tüm masaüstü akışlarını etkiler. Tasarımcıda zaten açık olan masaüstü akışları için yapılandırma değişikliklerinin etkili olması için akışı yeniden açın.

Not

• Power Platform yönetim merkezindeki çözüm denetleyicisi zorlama ayarları, Power Automate portalındaki Akış denetleyicisi yapılandırma ayarlarından önceliklidir.
• Ortam, tanımlı bir yapılandırmaya sahip bir ortam grubunun parçasıysa, kural ayarları devralınır ve tek tek düzenlenemez. Çözüm denetleyicisi ve Yönetilen Ortamlarda Çözüm denetleyicisi zorunluluğu hakkında daha fazla bilgi edinin.
• Yalnızca parametreleştirmeyi destekleyen kurallar yapılandırılabilir değerleri görüntüler. Kurala bağlı olarak, yapılandırılan değer analiz sırasında kullanılan en düşük veya en yüksek eşiği temsil edebilir.
• Power Platform yöneticileri, özelliğe erişim gerektiren tüm rollere uygun Çözümleme Geçersiz Kılma ayrıcalıklarını atamalıdır:
  • Geçerli yapılandırmayı görüntülemek için prvReadmsdyn_analysisoverride (Analiz Geçersiz Kılma - Okuma).
  • prvWritemsdyn_analysisoverride (Analiz Geçersiz Kılma - Yazma), önem dereceleri, parametre değerleri ve kuralların etkinleştirilmesi dahil olmak üzere kural ayarlarını değiştirmek için kullanılır.
  • Yeni kural geçersiz kılmaları oluşturmak için prvCreatemsdyn_analysisoverride (Çözümleme Geçersiz Kılma - Oluştur).

Portalda statik analiz çalıştırma

Statik analizi el ile tetiklemek için:

1. Power Automate portalındakiÇözümler sayfasına gidin.

2. Çözümün yanındaki bağlam menüsünü (⋯) açın.

3. Fareyi Çözüm denetleyicisi üzerine getirin.

4. Aşağıdaki seçeneklerden birini kullanın:

   • Çalıştır: Statik analizi başlatır.
   • Sonuçları görüntüle: En son analiz raporunu açar.
   • Sonuçları indir: Raporu çevrimdışı inceleme için dışa aktarır.

Not

Statik analiz, bir çözüme dahil olan tüm masaüstü akışları için çalışır. Sonuçlardaki Nesne adı sütununu denetleyerek hangi masaüstü akışının belirli bir kural ihlalini tetiklediğini belirleyin. Bu sütunda ilgili masaüstü akışının adı gösterilir.

Tasarımcıda statik analiz

Statik analiz otomatik olarak çalışır ve el ile müdahale gerektirmeden kodunuzu sürekli olarak inceler. Akışınıza eylemler eklediğinizde, kaldırdığınızda veya değiştirdiğinizde, bu özellik değişiklikleri değerlendirmek ve analizi yenilemek için etkinleştirilir. Bu süreç, geliştirmeyi sorunsuz ve verimli hale getirir. Tasarımcının sağ tarafında özel bir Akış Denetleyicisi düğmesi görürsünüz. Düğmedeki sayı, masaüstü akışındaki toplam ihlalleri gösterir. Akış Denetleyicisi bölmesini açmak ve ihlal edilen belirli kurallarla ilgili ayrıntılı içgörüleri görüntülemek için düğmeyi seçin.

Her analiz, başarıyla takip edilen kuralların oranını gösteren bir yüzde puanı oluşturur. Daha yüksek bir puan, daha az ihlal ve daha iyi kod kalitesi anlamına gelir.

Bu puan, akışta her değişiklik yapıldığında yeniden hesaplanır, anında geri bildirim sağlanır ve iyi geliştirme uygulamaları teşvik edilir.

Kurallar ihlal edilirse, statik analiz raporu net bir özet gösterir. Kural adlarını ve akışınızda her bir kuralı ihlal eden eylemlerin veya değişkenlerin sayısını listeler. Bir kural seçildiğinde, ilgili eylem vurgulanır ve ayrıntılı bir hata açıklaması sağlanır. Değişkenle ilgili ihlaller için sistem, değişken bölmesine giderek düzeltmeleri kolaylaştırır. Akış denetleyicisi bölmesi, arama işlevi içerir ve belirli sorunları hızlı bir şekilde bulabilmeniz için ikincil akışa göre filtreleme yapmanıza olanak tanır.

Her ihlalde, hatanın doğası, önerilen düzeltmeler ve belgelere bağlantı gibi ayrıntıları içeren bir kutucuk görüntülenir. Aynı ihlalin oluşumları arasında gezinmek için kuralın üst bilgisindeki kaydırıcıyı kullanın. Bu kılavuz, geliştiricilerin sorunları hızlı ve etkili bir şekilde ele almasına yardımcı olur. Akış denetleyicisi hata ihlalleri, bir satır içi gösterge ve daha fazla ayrıntı içeren bir açılır pencere gösterir. Uyarılar, hatalar gibi tasarımcı çalışma alanında satır içi olarak da görünür. Tasarımcı, ikincil akış sekmelerinde uyarılar ve hatalar gibi tanılama durumlarını gösterir ve ilgilenilmesi gereken bileşene gitmenizi sağlayan bir düğme içerir.

Açıklama

1. Belirli bir kural ihlalinin meydana gelme durumları
2. Kuralı ihlal eden eyleme gidin
3. Belgelerin bağlantısı

Statik analizi kuralları

Statik analiz kuralları, akışlarınızın güvenli, bakımı yapılabilir ve performanslı olmasını sağlamaya yardımcı olan önceden tanımlanmış yönergelerdir. Her kural, akış tasarımının güvenlik, performans ve bakım yapılabilirlik gibi belirli yönlerini hedefler ve akışınızın kalitesini artırmak için eyleme dönüştürülebilir geri bildirim sağlar. Aşağıda kuralların, açıklamalarının ve önerilen düzeltmelerin bir listesi bulunmaktadır.

Güvenli olmayan parola güvenliği

• Derece: Uyarı
• Tür: Güvenlik
• Hata ayrıntıları: Parolalar akışta güvenli olmayan bir şekilde yönetiliyor.
• Açıklama: Bu kural, masaüstü akışında parolaların güvenli olmayan bir şekilde yönetilip yönetilmediğini kontrol ederek yürütme sırasında bunların ifşa edilmemesini veya yanlış kullanılmamasını sağlar.
• Önerilen düzeltme: Masaüstü için Power Automate'nin parola özelliklerini kullanarak tüm parolayla ilgili girdilerin uygun şekilde işlendiğinden emin olun. Makine tabanlı şifreleme yoluyla maksimum güvenlik için "Doğrudan şifreli metin girişi" kullanın. Farklı makinelerde kullanılan akışlar için "Değişken olarak parola girişi"ni seçin ve güvenliği artırmak için ilgili değişkeni hassas olarak işaretleyin. Ayrıca, CyberArk kimlik bilgileriyle bütünleşen "Kimlik Bilgilerini Al" eylemi gibi güvenli kimlik bilgisi yönetim özelliklerini kullanın.

İki alt akış arasında özyineleme

• Derece: Uyarı
• Tür: Tasarım
• Hata ayrıntıları: İkincil akışlar arasında sonsuz döngüye neden olabilecek tekrarlanan çağrılar algılandı.
• Açıklama: Bu kural, iki veya daha fazla alt akış arasında yinelemeli çağrıları kontrol ederek akışın sonsuz bir döngüye girmediğinden emin olur.
• Önerilen düzeltme: Alt akışlar arasındaki tüm yinelemeli çağrıları kaldırın.

Değişken uzunluğu aşıldı

• Derece: Uyarı
• Tür: Devamlılık
• Hata ayrıntıları: Değişken adı, 40 karakter sınırını aşıyor.
• Açıklama: Bu kural, akışta tanımlanan her değişkenin adının belirtilen karakter sayısını aşıp aşmadığını doğrular. Varsayılan sınır 40 karakterdir.
• Önerilen çözüm: Belirtilen karakter sınırını aşan değişkenleri, adlarının 40 karakterden kısa olması için yeniden adlandırın.

Giriş değişkeni varsayılan değerleri

• Derece: Uyarı
• Tür: Devamlılık
• Hata ayrıntıları: Giriş/çıkış değişkenleri varsayılan değerleri kullanmıyor.
• Açıklama: Bu kural, Giriş/Çıkış değişkenlerinin varsayılan değerleri kullanıp kullanmadığını doğrular ve akış için düzgün şekilde yapılandırıldığından emin olur.
• Önerilen düzeltme: Akıştaki tüm giriş ve çıkış değişkenlerine varsayılan değerler atayın.

Giriş ve çıkış değişkenlerinin sayısı eşiği

• Derece: Uyarı
• Tür: Devamlılık
• Hata ayrıntıları: Toplam giriş/çıkış değişkenleri 25 değişken sınırını aşıyor.
• Açıklama: Bu kural, akıştaki toplam giriş/çıkış değişkeni sayısının belirtilen bir eşiği aşıp aşmadığını doğrular. Sınır 25 değişkendir.
• Önerilen düzeltme: Akıştaki giriş ve çıkış değişkenlerinin sayısının 25'i geçmediğinden emin olun.

Boş blokta hatası eylemi

• Varsayılan önem derecesi: Uyarı
• Tür: Tasarım
• Hata ayrıntıları: "Blokta hatası" eylemi boş ve hataları işlemiyor.
• Açıklama: Bu kural, akışınızdaki "Blokta hata" eylemlerinin hataları işlemek üzere doğru şekilde ayarlanıp ayarlanmadığını kontrol eder ve hataların beklendiği gibi atılıp yönetildiğinden emin olur.
• Önerilen düzeltme: Olası hataları yönetmek için akışta Blokta hata olduğunda eylemlerini ayarlayın.

İç İçe If tümceleri

• Derece: Uyarı
• Tür: Devamlılık
• Hata ayrıntıları: İç içe If koşulları beş seviyeyi aşar.
• Açıklama: Bu kural, beşten fazla düzeye sahip iç içe if ifadelerinin olup olmadığını kontrol ederek akışın yönetilebilir ve okunabilir kalmasını sağlar.
• Önerilen düzeltme: Akışı, iç içe geçmiş if ifadelerini beş seviyeden fazla olmayacak şekilde yeniden düzenleyin.

Şu durumda eksik:

• Derece: Uyarı
• Tür: Tasarım
• Hata ayrıntıları: Tamamlanmamış "If" eylemi algılandı, içerik eksik veya yalnızca "Else" dalındaki eylemleri içeriyor.
• Açıklama: Bu kural, içeriği olmayan veya yalnızca Else dalındaki eylemleri içeren If eylemlerini algılayarak koşullu ifadelerin etkili bir şekilde uygulanmasını sağlar.
• Önerilen düzeltme: Akışı gözden geçirin ve her "If" koşulunun "If", "Else if" ve "Else" dallarının her birinde anlamlı işlemler içerdiğinden emin olmak için bunları tek tek inceleyin.

Sonsuz döngü

• Derece: Uyarı
• Tür: Tasarım
• Hata ayrıntıları: Akışta sonsuz döngü algılandı. Bu durum, akışın süresiz olarak çalışmasına neden olabilir.
• Açıklama: Bu kural, akışta sonsuz döngüler olup olmadığını kontrol ederek, akışın süresiz olarak çalışabileceği senaryoları belirlemeye ve önlemeye yardımcı olur.
• Önerilen düzeltme: Her döngünün açıkça tanımlanmış ve ulaşılabilir bir sonlandırma koşuluna sahip olduğundan emin olun. Koşul bir sayacı, belirli bir değeri veya bir görevin tamamlanmasını temel alabilir. Beklenenden daha uzun süre çalışırsa döngüyü kırmak için kontroller veya güvenli koşullar ekleyin. Örneğin, bir maksimum yineleme sayısı ayarlayın veya bir zaman aşımı ekleyin.

Bekleme eylemlerinin yanlış kullanımı

• Derece: Uyarı
• Tür: Performans
• Hata ayrıntıları: Bekleme eylemlerinin kötüye kullanıldığı tespit edildi; 10'dan fazla bekleme eylemi potansiyel darboğazlara neden oluyor.
• Açıklama: Bu kural, uzun süreli gecikmelerin neden olabileceği olası performans sorunlarını belirlemeye ve en aza indirmeye yardımcı olmak için akışın aşırı sayıda (10'dan fazla) bekleme eylemi içerip içermediğini denetler.
• Önerilen düzeltme: Tüm bekleme eylemlerini tanımlamak ve akışın mantığı için gerekli olup olmadıklarını denetlemek için akışı gözden geçirin. Gereksiz beklemeleri kaldırın veya mümkünse birleştirin.

Çok uzun bekleme süresi

• Derece: Uyarı
• Tür: Performans
• Hata ayrıntıları: Sabit kodlu bekleme eylemleri için 600 saniye sınırını aşan büyük bir bekleme süresi algılandı.
• Açıklama: Bu kural, akıştaki sabit kodlanmış bekleme eylemlerinin belirli bir zaman miktarını aşıp aşmadığını kontrol eder; sınır 600 saniye olarak ayarlanır.
• Önerilen düzeltme: 600 saniye sınırını aşan bekleme eylemlerini bulmak için akışı gözden geçirin. Bu uzun bekleme sürelerinin gerekli olup olmadığını kontrol edin ve sürelerini akışın düzgün çalışması için gereken en kısa süreye ayarlayın. Uzun bir bekleme gerekiyorsa, daha kısa aralıklara bölün ve aralarına kontroller veya koşullar ekleyin. Mümkün olduğunda, uzun bekleme eylemlerini olay temelli tetikleyicilerle değiştirin.

Ulaşılamayan eylemler

• Derece: Uyarı
• Tür: Devamlılık
• Hata ayrıntıları: Akıştaki bir veya daha fazla eyleme ulaşılamıyor ve hiçbir koşulda yürütülmeyecek.
• Açıklama: Bu kural, akışta mantıksal olarak ulaşılamayan eylemleri denetler. Ulaşılamayan eylemler yanlış dallanmadan, yanlış yerleştirilmiş koşullardan veya bağlantısız kesimlerden kaynaklanabilir ve akışın mantığındaki veya yapısındaki kusurları gösterebilir.
• Önerilen düzeltme: Yürütme yoluna bağlı olmayan eylemleri bulmak için akışı gözden geçirin. Her eylemlere geçerli bir mantık, dal veya döngü üzerinden erişilebildiğinden emin olun. Akışı temiz ve verimli tutmak için ulaşılamayan eylemleri kaldırın veya taşıyın.

Gerekli olmayan alt akış

• Derece: Uyarı
• Tür: Devamlılık
• Hata ayrıntıları: Kural hiçbir eylem içermeyen, yalnızca devre dışı bırakılmış eylemler içeren veya ayrımını gerekçelendirmek için çok az eylem içeren bir alt akış algılamıştır. Bu tür alt akışlar akışın yürütülmesine anlamlı katkıda bulunmayabilir ve netliği azaltabilir.
• Açıklama: Bu kural, genellikle 5'ten az eylem içeren boş veya çok az olan alt akışları denetler. Alt akışlar modülerlik ve yeniden kullanım için yararlı olsa da, anlamlı içerik veya soyutlama eksik olanlar eksik geliştirmeyi, gereksiz parçalanmayı veya yanlış yapılandırmayı gösterebilir. Bu desenler karışıklığa yol açabilir ve sürdürülebilirliği engelleyebilir.
• Önerilen düzeltme: Açık ve değerli bir amaca hizmet edip etmediğini belirlemek için tanımlanan alt akışı gözden geçirin. Eğer öyle değilse, onu kaldırmayı veya ilgili bir mantık bloğuyla birleştirmeyi değerlendirin. Alt akış gelecekte kullanıma yönelikse, rolünü netleştirmek ve yanlış yorumlamayı önlemek için bir yer tutucu eylem ekleyin.

Bilinen sınırlamalar

• Yalnızca Yönetilen Ortamlarda kullanılabilir.
• Kural özelleştirme, kuralların etkinleştirilmesi veya devre dışı bırakılması ve önem derecesinin yapılandırılmasıyla sınırlıdır.

Bilinen sorunlar

• Bir kural ihlali ayrıntısını görüntüledikten sonra kopyalanan eylemlerin silinmesi, işlenmeyen hataları tetikleyebilir.
• Aşağıdaki eylemlerde hassas olmayan bir parola değişkeni kullanmak, kural değerlendirmesi sırasında statik analizin başarısız olmasına neden olur.
  • Giriş iletişim kutusunu görüntüle
  • Klasör seçme iletişim kutusunu göster
  • Özel formu görüntüle