Editör Diyalog
    • 06 Dec 2024
    • 1 Minute to read
    • Dark
      Light

    Editör Diyalog

    • Dark
      Light

    Article summary

    Editör Diyalog

    Akış formları üzerinde, akışın eklentisi içerisindeki Word formatında dokümanlara erişmeyi ve editör içerisinde açılmasını sağlayan bir fonksiyondur. İsteğe bağlı olarak belgeler görüntülenebilmektedir ya da editör üzerinde düzenleme yapılabilmektedir. 

    Editör üzerinde düzenleme yapılabilmesi için belgeler üzerinde diyaloğu açacak kişinin "Versiyonlama" yetkisinin olması gerekmektedir.


    Editör Diyalogu kullanabilmek için form arkasında istenilen event’de aşağıdaki kod parçacığı çağırılmalıdır;

    new pw.ui.WordEditor().openDialog('edit', PwForm.WorkitemId);

    openDialog fonksiyonunun 2 tane parametresi bulunmaktadır. Bunlar;

    • Diyaloğun açılış amacı için kullanılacak olan diyalog tipi;
      1. edit : İstenilen belgeler düzenlenmek isteniyorsa kullanılır. Versiyonlama yetkisi gereklidir.
      2. view: İstenilen belgeler sadece görüntülenmek isteniyorsa kullanılır.

        Workitem id değeri
        Yukarıdaki kod örneğinde, ilgili form üzerinde içerisinde bulunulan akışın işlem yapılan adımına ait workitem id değeri verilmiştir. Bu workitem id değeri sayesinde ilgili formda diyalogu açan kişinin belgeleri versiyonlama yetkisinin olup olmaması tespit edilir.

    Örnek Kullanım:

    Manuel adım üzerindeki bir buton yardımı ile verilen workitem id’nin sahibi olan akışın Word belgelerini görüntülenmek isteniyor. Yükleme sonrasında "Proje Dokümanlarını Getir" butonuna atanmış event ve içerisinde çağırılmış kod parçacığı şu şekildedir;

    PwForm.setEvent("getProjectFiles", "Click", function(){
        new pw.ui.WordEditor().openDialog('edit', PwForm.WorkitemId);
    });
    



    Buton tıklanması sonrasında;

    Eklenti dosya kartı tipi ise, ilk olarak dosya seçici penceresi açılmaktadır. Eğer eklenti arşiv tipi ise dosya seçici pencere açılmayarak, ekrana editör gelmektedir. Diyalog “edit” ile açılırsa dosya seçici aşağıdaki görselde olduğu gibi düzenleme butonu ile birlikte açılmaktadır.


    Dialog “view” ile açılırsa dosya seçici aşağıdaki görselde olduğu gibi düzenle butonu olmadan açılmaktadır.


    Dosya seçici pencereden görüntüle butonu tıklandığında editör, "Kaydet" butonu olmadan açılmaktadır.


    Dosya seçici pencereden "Düzenle" butonu tıklandığında editör, "Kaydet" butonu ile birlikte açılamaktadır.


    Eğer kullanıcının doküman üzerinde "Versiyonlama" yetkisi yok ise;
    1) Eklenti dosya kartı tipi olduğunda, diyalog "edit" ile açılsa dahi dosya seçici içerisinde ilgili doküman üzerine tıklandığında "Düzenle" butonu gelmemektedir.
    2) Eklenti arşiv tipi olduğunda ise, açılan editör üzerinde "Kaydet" butonu gelmemektedir ve görüntüleme seçeneğinde açılmış gibi görüntülenecektir.