Aracılığıyla paylaş

Form için olay işleyicilerini yapılandırma

  • Makale

Bu konu, Dynamics 365 Customer Engagement (on-premises) için geçerlidir. Bu konunun Power Apps sürümü için bkz: Model temelli uygulama formu olay işleyicileri yapılandırma

Dynamics 365 Customer Engagement (on-premises) formları için form olay işleyicileri, bir formdaki aşağıdaki alanlar için yapılandırılabilir:

Öğe Etkinlik Açıklama
Şekil OnLoad Form yüklendiğinde oluşur.
OnSave Veri kaydedildiğinde oluşur.
Sekme TabStateChange Sekme genişletildiğinde veya daraltıldığında oluşur.
Alan OnChange Alandaki veriler değiştiğinde ve denetim odağı kaybettiğinde oluşur.
IFRAME OnReadyStateComplete Bir IFRAME içeriği yüklendiğinde oluşur.

Bir olay işleyicisi, bir JavaScript web kaynağına bir başvurudan ve o web kaynağında tanımlı, olay gerçekleştiğinde yürütülecek bir işlevden oluşur. Her öğede, yapılandırılmış 50 adede kadar ayrı olay işleyicisi olabilir.

Önemli

Bir olay işleyicisini yanlış yapılandırmak, formun doğru yüklenmemesine ve çalışmamasına neden olabilecek komut dosyası hatalarıyla sonuçlanabilir. Komut dosyasının geliştiricisi değilseniz, komut dosyasının hangi yapılandırma seçeneklerini gerektirdiğini tam olarak anladığınızdan emin olun.

Bir komut dosyası olay işleyicisini, güvendiğiniz bir kaynaktan gelmeyen bir kitaplık kullanarak yapılandırmayın. Komut dosyaları, bir kullanıcının gerçekleştirebileceği herhangi bir eylemi gerçekleştirmek için kullanılabilir ve kötü yazılmış bir komut dosyası, bir formun performansına önemli ölçüde zarar verebilir.

Bir olay işleyicisini yapılandırdıktan sonra, her zaman düzgün çalıştığını doğrulamak için onu test edin.

Olay işleyicisi yapılandırma

  1. Form düzenleyicisinde, bir işleyici yapılandırmak istediğiniz olay bulunan öğeyi seçin.

  2. Giriş sekmesi'nde, Düzenle grubunda, Özellikleri Değiştir öğesin seçin veya yalnızca öğeye çift tıklayın.

  3. Öğe özellikleri iletişiminde, Olaylar sekmesini seçin.

  4. Form Kitaplıkları alanını genişletin. Olay işleyicisi olarak ayarlamak istediğiniz işlevi içeren kitaplık zaten listede yoksa, kitaplığı ekleyin.

  5. Bir form kitaplığını bir olay işleyicisine ekleme:

    1. Olay Listesi'nin Form Kitaplıkları bölümünde, Ekle öğesini seçin.

    2. Kullanılabilir web kaynakları listesinde JavaScript web kaynağını bulun. Seçin ve ardından Ekle'yi seçin.

      İhtiyacınız olan JavaScript web kaynağı yoksa, Yeni öğesini seçerek yeni bir web kaynağı formu açın ve bir tane oluşturun.

    3. Bir JavaScript web Kaynağı oluşturma:

      1. Web kaynağı formunda, aşağıdaki özellikleri ayarlayın:

        Özellik Değer
        Adı Gerekli. Web kaynağının adını yazın.
        Görünen Ad Gerekli. Web kaynakları listesinde görüntülenecek adı yazın.
        Açıklama isteğe bağlı. Web kaynağının bir açıklamasını yazın.
        Tür Gerekli. Komut Dosyası (JScript) öğesini seçin.
        Dil isteğe bağlı. Kuruluşunuz için kullanılabilir olan dillerden birini seçin.

      2. Bir komut dosyası sağlanmışsa, dosyayı bulmak için Gözat düğmesini kullanmanızı ve onu yüklemenizi önemle tavsiye ederiz.

        Alternatif olarak, Metin Düzenleyici düğmesini seçebilir ve komut dosyasının içeriğini İçeriği Düzenle iletişimine yapıştırabilir veya yazabilirsiniz.

        Not

        Bu basit metin düzenleyicisi, komut dosyasının doğruluğunu denetlemek için herhangi bir özellik sağlanmadığı için, komut dosyalarını düzenlemek için genellikle her zaman Visual Studio gibi ayrı bir uygulama kullanmaya çalışmanız ve ardından onları karşıya yüklemeniz gerekir.

      3. Kaydet öğesini seçin ve web kaynağı iletişim kutusunu kapatın.

      4. Oluşturduğunuz web kaynağı artık Kayıt Ara iletişiminde seçilidir. Ekle öğesini seçerek iletişim kutusunu kapatın.

  6. Olay İşleyicileri bölümünde, bir olay işleyicisi ayarlamak istediğiniz olayı seçin.

  7. Ekle öğesini seçerek İşleyici Özellikleri iletişim kutusunu açın.

  8. Ayrıntılar sekmesinde, uygun kitaplığı seçin ve olay için yürütülmesi gereken işlevin adını yazın.

  9. Varsayılan olarak, olay işleyicisi etkindir. Bu olayı etkinleştirmek istemiyorsanız Etkin onay kutusunu temizleyin.

    Bazı işlevler, bir yürütme içeriğinin işleve geçirilmesini gerektirir. Gerekirse, Yürütme içeriğini ilk parametre olarak geçir öğesini seçin.

    Bazı işlevler, bir işlevin davranışını denetlemek için bir parametre kümesini kabul edebilir. Bunlar gerekiyorsa, bunları İşleve geçirilecek parametrelerin, virgülle ayrılmış listesi'ne girin.

  10. Bağımlılıklar sekmesinde, komut dosyasının bağımlı olduğu herhangi bir alanı Bağımlı Alanlar alanına ekleyin.

  11. Tamam öğesini seçerek İşleyici Özellikleri iletişim kutusunu kapatın.

  12. Olay işleyicisi girildiğinde, yukarı veya aşağı taşımak için yeşil okları kullanarak, işlevin, diğer işlevlere kıyasla yürütüleceği sırayı ayarlayabilirsiniz.

  13. Tamam öğesini seçerek öğe özellikleri iletişim kutusunu kapatın.

  14. Yaptığınız değişiklikleri kaydetmek için Kaydet'i seçin. Formu yayımlamak için Yayımla öğesini seçin.

Not

Kullanıcı arabirimi (UI) komut dosyalarının yüklenme sırasını yukarı ve aşağı yeşil okları kullanarak ayarlamanıza olanak sağlar, ancak komut dosyaları gerçekte bu sırayla yüklenmez.

Ayrıca bkz.

Ana formu ve bileşenlerini kullanma