Document Editor

Xpoda’da Document Editor, formlarınızda dokümanları görüntülemenizi, değiştirebilmenizi ve değişim geçmişini kaydedebilmenizi sağlar. Versiyon yönetimi sayesinde dokümanlarınızı yayınlayabilir(publish) ve daha önceki versiyonları da görüntüleyebilirsiniz. 

 

 

 

Uyumluluk 

 

 

 

Document Editor aracının özellikleri; 

Type(Alan Türü): Eklenilen form aracının alan türünü gösterir. Burada yer alan değer değiştirilemez. 

Name(Alan İsmi): Veri tabanında oluşacak olan alanın ismi yazılır. 

Help Text(Yardım Metni): Form aracı üzerine Fare ile gelindiğinde açıklama çıkması için girilen metindir. 

Height(Yükseklik): Form aracının yüksekliğini ve genişliğini düzenler. 

From Left / Top: Form aracının soldan ve üstten boyutunu düzenler. 

Display(Görünür): Form aracının Client ekranında görünmemesini sağlar. 

 

 

Örnek Kullanım 

 

Öncelikle yeni bir form açalım ve formu isimlendirelim (Örnekte; XPD_DOCUMENT_EDITOR tablo adı kullanılmıştır). Formumuza doküman ekleyebilmek ve bu eklediğimiz dokümanı eklerken kayda isim verebilmek için Text Box ile AddFile araçlarını ekleyelim. Bu alanları istediğiniz şekilde isimlendirelim. (Örnekte; Text Box alanına Konu ve AddFile alanına EvrakYukle isimleri verilmiştir.) 

Ardından formdaki kayıtlarımızı gözlemleyebilmek adına bir List aracı ve kaydın içerisindeki dokümanı görüntülemek için Document Editor araçlarını formumuza sürükleyip bırakalım.  

Dokümanınızı Document Editor aracında gösterebilmek için bir GUID değerine ihtiyacımız olmaktadır. Bu GUID, XPODA_FILES tablosunda bulunan kaydın RecordGuid alanı olmaktadır. GUID’in bir yere Update edilmesi için bir Text Box daha sürükleyip GUID olarak isimlendirelim.  

Not: Yüklenen dosyalar Xpoda’nın kendisine ait XPODA_ FILES tablosunda kaydı tutulmaktadır. Oluşturduğunuz tablonunda RecordGuid alanı bulunmaktadır fakat bu RecordGuid alanı ile Document Editor aracında dokümanınızı sağlıklı bir şekilde gözlemlemeniz mümkün değildir. Bu sebeple dokümanın devamında liste sorgusu içinde XPD_DOCUMENT_EDITOR ve XPODA_FILES tablolarının join’lenmesi ve sql sorgusu içinde kullanılacak alan bilgileri paylaşılmıştır. XPODA_FILES tablosuna ait RecordGuid alanına Alias verilmesi unutulmamalıdır. 

 

Formdaki List elemanı seçilir. Listenin Sql server alanından sql sorgusu yazılır. Örnekte; SQL Server alanına aşağıda paylaşılan sql sorguyu yazılmıştır. (Sql sorgusunda XPD_DOCUMENT_EDITOR oluşturduğunuz tablodaki alanlardan kullanılmıştır. Geri kalan alanlar XPODA FILES tablosunda hazır olarak bulunmaktadır.) 

SELECT  
XPD_DOCUMENT_EDITOR.UserTableID,  
XPD_DOCUMENT_EDITOR.Konu AS Konu, 
XPODA_FILES.TableID AS [|TableID], 
XPODA_FILES.FileID AS [|FileID], 
XPODA_FILES.FileName, 
XPODA_FILES.FileContent AS [|FileContent], 
XPODA_FILES.ProjectID, 
XPODA_FILES.FormTypeID, 
XPODA_FILES.RecordGuid AS Record

FROM dbo.XPD_DOCUMENT_EDITOR WITH (NOLOCK) 
LEFT OUTER JOIN dbo.XPODA_FILES WITH (NOLOCK) 
ON XPD_DOCUMENT_EDITOR.UserTableID = XPODA_FILES.TableID 
AND XPD_DOCUMENT_EDITOR.FormTypeID=XPODA_FILES.FormTypeID 
AND XPD_DOCUMENT_EDITOR.ProjectID=XPODA_FILES.ProjectID 

 

Form açıldığında listemizin yüklenmesi için forma aksiyon eklenir. (Yukarıda paylaşılan kırmızı renkle gösterilen alan seçilir). Formun özellikleri bölümünden aksiyonlar kısmı seçilir. (Yukarıda paylaşılan yeşil renkle gösterilen alan seçilir) ve “Add New Action” butonu tıklanır.  Type of Action olarak When the form is opened (Form açıldığında) olarak seçilir,  Operation olarak da Update Value olarak işlem belirledikten sonra, Value Area Form açıldığında yüklemek istediğimiz alan seçilir. (Örneğimizde listemizin ismi GridListe_1 olduğu için GridListe_1 seçilmiştir). 

Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. (Yukarıda paylaşılan turuncu renkle gösterilen alan). Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

 

 

 

Listeden seçim yaptığımızda, listeye çift tıkladığımızda GUID Text Box’ına XPODA_FILES alanının RecordGuid verisini yüklenmesi için aksiyon ekleyelim. List elemanını seçtikten sonra aksiyon sekmesine geçelim (Yukarıdaki görselde kırmızı işaretli alan) ve Type of Action alanını When the double clicked on row (Satıra çift tıklandığında) aksiyonu olarak seçelim. Ardından Operation alanını güncelleme yapmak istediğimiz için Update Value, Value Area alanını da bu alana RecordGuid’i yüklemek istediğimiz için TextBox’ı seçelim. Örnekte bu alan GUID olduğu için o seçilmiştir.  

Ardından SQL Query alanına listemizdeki sorguda XPODA_FILES’ta bulunan RecordGuid’e verilen Alias değerini yazılır. (Örnekte; Record alias’ı verilmiştir, dolayısıyla sql server alanına SELECT '$PRecord$' şeklinde yazılmıştır).  Böylece GUID alanına RecordGuid yüklendiğinde Document Editor aracı da tetikleyebileceğiz. 

 

 

Not: Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

 

 

 

Listeden satıra çift tıklandığında yukarıda eklediğimiz aksiyonlar Record bilgisini GUID alanına gönderilmesi sağlandı. Şimdi GUID alanına gelen Record bilgisiyle Document Editor elemanının tetiklenmesi için aksiyon ekleyelim.

 

Bunun için formdaki GUID alanı seçilir ve özellikler alanından aksiyon sekmesine geçilir (Aşağıdaki görselde yeşil renklendirilmiş alan) ve Add New Action butonuna basılır. Type of Action alanını OnValue Change (Değer değiştiğinde) aksiyonu olarak seçelim. Ardından Operation alanını güncelleme yapmak istediğimiz için Update Value, Value Area alanını da bu alanı güncellemek istediğimiz için DocumentEditor_1 seçelim. Aksiyonun son görüntüsü aşağıdaki gibi olacaktır.

 

Not: Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

 

 

 

 

Son olarak kaydetme işlemlerini yapmak için forma buton sürükleyelim ve butonun özelliklerinde isimlendirelim. Butona basıldığında kendi tablosuna kayıt atabilmesi için aksiyon ekleyelim.  Type of Action When clicked (tıklandığında) seçip ve Operation olarak Save seçtikten sonra aksiyonun kaydedelim.

 

Not: Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

 

 

Formu kaydedip ve run butonu ile client ekranına gidelim. Client görüntüsü aşağıdaki gibi olacaktır.

 

 

Client ekranında Konu kısmı doldurulur ve Evrak Yükle kısmından yüklenecek evrak yüklenir. (Örneğimizde Konu olarak EHS DATALARI yazılmış ve ona ait bir excel yüklenmiştir). Sonrasında kaydet butonuna basıp ve kayıt işlemi gerçekleştirilir. Kayıt yapıldıktan sonra listemizde kaydımız görünecektir. (Formumuza eklediğimiz aksiyonumuzdan ötürü kayıt işlemlerinden sonra veya form açıldığında formumuzdaki kayıtlar listemizde görünecektir.)

 

 

Listeden satıra çift tıklandığında seçilen satırın Record bilgisi RecordGuID alanında görünecektir. (Yukarıda paylaşılan görselde kırmızı işaretli alan). Record bilgisine göre Document Editor’de yüklenen excel dosyası gösterilir. 

 

Açtığımız dokümanda istediğimiz değişiklikleri yaptıktan sonra CTRL+S ile dosyamızı kaydedilir. (Örneğimizde Yukarıda paylaşılan görselde yeşil renkli kolonda Yeni Eklenen kolon başlığı altında değişiklikler yapılıp, CTRL+S ile dosyamızı kaydedilmiştir). 

 

Ardından bu değişikliğe sahip olan yeni versiyonumuzu yayınlamak için aracın üst kısmında bulunan Publish butonu tıklanır. Açılan Publish Document ekranında kaydedilen dokümanın son haline isim verilir ve Publish butonuna basılıp kaydedilir. 

 

İşlem başarılı olduğunda ekranın sağ üst tarafında aşağıdaki gibi bir mesaj görünecektir. 

 

NOT: CTRL+S yapmamız yeni bir versiyon oluşturmamız adına önemlidir. Aksi halde yeni versiyon kaydedilmez ve bu sebeple publish edemezsiniz. 

Ekran yenilendikten sonra listeden ilgili satır tekrar çift tıklanıp seçildiğinde, Document Editor’e excel en son kayıtlı haliyle gelecektir.

 

Artık dokümanımızın yeni versiyonu hazır ve herkes için görüntülenebilir haldedir.

 

 

 

Client ekranında Document Editor’un sağ üst köşesindeki History butonu tıklandığında açılan Version History pop-up ekranında excel dokümanının kayıt hikayesine ulaşılıp ve yayınlanan önceki versiyonları görülebilmektedir. (Yukarıda paylaşılan ekran görselinde kırmızı işaretli alan)  

 

Eski versiyona tıklayınca eski versiyon aynı pencere içerisinde Read Only olarak açılır ve değiştirilemez. Bu kayıtlar versiyon numarası ile birlikte XPODA_FILES_HISTORY tablosunda tutulmaktadır. 

 

 

 

Document Editor Aksiyonları; 

1-Document Viewed (Doküman görüntülendiğinde): Bu aksiyon Document Editor aracının -kendisinde bulunan bir aksiyondur. Bu aksiyon ile istenilen doküman görüntülendiğinde istediğiniz başka bir aksiyonun tetiklenmesi sağlanır.

 

Örneğimizde Client ekranında evrak görüntülendiğinde evrağın görüntülendiğiyle alakalı mesaj gösterilmiştir. Document Editor aracına tıkladıktan sonra sağdaki özellikler aksiyon butonu seçilir. (Yukarıda paylaşılan görselde yeşil renkli alan). Add New Action butonuna tıklayıp aksiyon eklenir.  

Type of Action; Document viewed seçilir.  

Operation; Show Message seçilir.  

Message Tittle; Mesaj içeriği bu alana yazılır. (Örnekte; Doküman görüntülendi! Yazılmıştır). 

Message Type; Bu alandan gösterilecek mesajın tipi seçilir. Açılır kutudan Information, Warning ve Done seçenekleri vardır. (Örnekte; Information seçilmiştir). 

Display Time; Mesajın gösterilme süresidir. Milliseconds (Mili Saniye) türünden süre yazılır. 

Position; Mesajın client ekranında gösterileceği konumu seçilir. (Örnekte; top-right seçilmiştir). 

Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. (Yukarıda paylaşılan turuncu renkle gösterilen alan). Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

Form kaydedilir ve run butonu ile client ekranına gidilir. 

 

Client ekranı açıksa ekran yenilenip listeden kayıtlı satır çift tıklanarak seçildiğinde Document Editor’de excel gösterildiğinde yukarıdaki görseldeki gibi ekranın sağ üst köşesinde uyarı mesajı gösterilmiştir. 

 

 

2-Document Published (Doküman versiyonu oluşturulduğunda): Bu aksiyon Document Editor aracının kendisinde bulunan bir aksiyondur. Bu aksiyon ile ilgili doküman üzerinde düzenleme ekleme veya çıkarma gibi işlemler yapıp yeni versiyonu publish ettikten hemen sonra yukarıda bulunan diğer örnekteki gibi başka bir aksiyon tetikleyebilirsiniz.  

 

Örnekte; Client ekranında evrak publish edildikten sonra Active Document Guid bilgisini göstermek için, forma bir text box form elemanı sürüklenmiştir. (Yukarıda paylaşılan görselde kırmızı işaretli alan)

text box’un özellikler kısmında sadece formda özelliği (Only Form) aktif edildikten sonra, Name alanında

AktiveEditorGuid alan ismi verilmiştir.  

Document Editor aracına tıkladıktan sonra sağdaki özellikler aksiyon butonu seçilir. (Yukarıda paylaşılan görselde yeşil renkli alan). Add New Action butonuna tıklayıp aksiyon eklenir.  

Type of Action; Document published seçilir.  

Operation; Update value seçilir.  

Value Area; ActiveEditorGuid seçilir. (Bu bilgiyi ekranda göstermek için forma eklenilen text box’un ismidir.) 

Sql Server alanında; Sql sorgusu olarak SELECT '$PActiveDocumentGuid$' yazılır. Bu alanda SELECT yazıldıktan sonra : (iki nokta üst üste) yapıldığında formdaki alanlar görülür ve buradan da seçim yapılabilir.) 

Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. (Yukarıda paylaşılan turuncu renkle gösterilen alan). Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

Form kaydedilir ve run butonu ile client ekranına gidilir. 

 

Listeden kayıtlı satırlardan seçim yapılır ve çift tıklanır. Seçilen satırın dokümanı Document Editor’de gösterilir.  

 

Örnekte; J kolonuna Kolon-7 yazıldı, CTRL-S yapılarak excel değişikliği kaydedildi. Publish butonuna basıldı. Açılan Publish Document pop-up ekranında dokumana ismi verildi ve sağ alttaki publish butonuna basıldı. 

Değişiklik kaydedildikten sonra Documan Edıtor’e eklenen Document Published aksiyonu çalışır ve aşağıda paylaşılan kırmızı renkli işaretli alanda RecordGuid bilgisi gösterilmiştir. 

 

 

 

Yetkilendirme 

Formun Authority (Yetki) özelliklerinden It cannot change fields (Alanları değiştiremez) ve It can not see fields (Alanları göremez) aksiyonlarını kullanabilmek için; 

It cannot change fields (Alanları değiştiremez) Aksiyonu; 

 

Formun sağ bölümünde bulunan Authority kısmından Document Editor bileşeninin yetkileri ayarlanabilir. (Yukarıda paylaşılan ekran görselinde kırmızı işaretli alandan form seçilir ve sonrasında yeşil renkli gösterilen alanda Authority butonuna basılır).  Add New Authority butonuna basıldıktan sonra; 

Action; Bu alanda It cannot change fields yetkilendirmesi seçildiğinde, dökümanın belirli kullanıcılar tarafından editlenebilmesi engellenir. 

Fields; Bu alandan değişiklik yapılmasının engellenmesi istenen alan seçilir. 

Condition Type; Manually select users (Kullanıcıları manuel olarak seçin) ve Run conditional query (Koşullu sorgu çalıştır) seçeneklerinden seçim yapılır. 

*Manually select users (Kullanıcıları manuel olarak seçin) seçildiğinde; 

Users Type; Bu alandan Those selected (Seçilenler), Non-selected (Seçilmemiş) ve All Users (Tüm Kullanıcılar) seçeneklerinden seçim yapılır.  

Users; Bu alandan engellenecek kullanıcılar seçilir. Those selected (Seçilenler) ve Non-selected (Seçilmemiş) seçimlerinde, seçim tipine göre kullanıcılar işaretlenir. All Users (Tüm Kullanıcılar) seçilmişse kullanıcı seçimi yapılması gerekmemektedir.  

*Run conditional query (Koşullu sorgu çalıştır) seçildiğinde; 

SQL Query alanı aktif olur ve koşullu sql sorgusu bu alana yazılır. 

Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. (Yukarıda paylaşılan turuncu renkle gösterilen alan). Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

 

It can not see fields (Alanları göremez) Aksiyonu; 

 

Formun sağ bölümünde bulunan Authority kısmından Document Editor bileşeninin yetkileri ayarlanabilir. (Yukarıda paylaşılan ekran görselinde kırmızı işaretli alandan form seçilir ve sonrasında yeşil renkli gösterilen alanda Authority butonuna basılır).  Add New Authority butonuna basıldıktan sonra; 

Action; Bu alanda It cannot see fields yetkilendirmesi seçildiğinde, dökümanın belirli kullanıcılar tarafından görülmesi engellenir. 

Fields; Bu alandan değişiklik yapılmasının engellenmesi istenen alan seçilir. 

Condition Type; Manually select users (Kullanıcıları manuel olarak seçin) ve Run conditional query (Koşullu sorgu çalıştır) seçeneklerinden seçim yapılır. 

*Manually select users (Kullanıcıları manuel olarak seçin) seçildiğinde; 

Users Type; Bu alandan Those selected (Seçilenler), Non-selected (Seçilmemiş) ve All Users (Tüm Kullanıcılar) seçeneklerinden seçim yapılır.  

Users; Bu alandan engellenecek kullanıcılar seçilir. Those selected (Seçilenler) ve Non-selected (Seçilmemiş) seçimlerinde, seçim tipine göre kullanıcılar işaretlenir. All Users (Tüm Kullanıcılar) seçilmişse kullanıcı seçimi yapılması gerekmemektedir.  

*Run conditional query (Koşullu sorgu çalıştır) seçildiğinde; 

SQL Query alanı aktif olur ve koşullu sql sorgusu bu alana yazılır. 

Aksiyonun kendi kaydet butonu kullanılır ve aksiyon kaydedilir. (Yukarıda paylaşılan turuncu renkle gösterilen alan). Sadece formun kaydet butonuna basılırsa aksiyon kaydedilmez. 

Son olarak formu kaydedip run butonu ile client ekranına gidilir.