Document Editor
Xpoda platformunda yer alan Document Editor aracı, formlarınız üzerinden dokümanları görüntülemenizi, düzenlemenizi ve yapılan değişikliklerin geçmişini kaydetmenizi sağlar.
Versiyon yönetimi özelliği sayesinde, dokümanlarınızı yayınlayabilir (publish), önceki versiyonlara erişim sağlayabilirsiniz.
| Araç Kutusundaki Görünümü | Free Formdaki Görünümü | Responsive Formdaki Görünümü |
| |
Uyumluluk
| Free Form | Responsive Form | Mobile |
Document Editor aracının özellikleri;
Type (Alan Türü): Eklenen form aracının alan türünü gösterir. Burada yer alan değer değiştirilemez.
Name (Alan İsmi): Eklenen form aracına bir isim verilir. Form içerisinde kullanılacak aksiyonlarda, Document Editor alan ismi olarak burada tanımlanan alan ismi kullanılır.
Help Text (Yardım Metni): Client tarafında, Document Editor form aracının üzerine fare ile gelindiğinde gösterilmesi istenen bilgilendirme metni yazılır.
Height / Width: Form aracının yüksekliği ve genişliği ayarlanır.
From Left / Top: Form aracının soldan ve üstten konumu ayarlanır.
Display (Görünür): Form aracının Client ekranında görünmemesini sağlar.
Örnek Kullanım
Document Editor form aracı üzerinde görüntülenecek dosyanın eklenebilmesi için, öncelikle ilgili form ekranını oluşturalım.
Free Form özelliğine sahip yeni bir form açalım. Bu işlem için aşağıdaki resimde kırmızı çerçeve ile işaretlenmiş, new Form ikonuna tıklanmalıdır.
Açılan pencereden Free Form seçeneğini seçelim.
Free Form seçildiğinde Form_1 isminde yeni bir form ekranı oluşacaktır.
Fom_1 isimli formu seçelim, ardından ekranın sağ tarafında bulunan form özelliklerini aşağıdaki gibi düzenleyelim.
1 numara ile gösterilen Properties alanını seçelim. Ardından 2 numara ile gösterilen Table Name alanına DE_FILE_UPLOAD yazalım. Son olarak Type alanından Form seçeneğini seçelim.
Formların Type özelliği ‘Form’ olarak seçildiğinde, Table Name özelliğinde yazılı isim ile SQL içinde bulunan XPODA veri tabanı altında yeni bir tablo oluşturulur.
Client tarafında ilgili form üzerinden bir kayıt işlemi gerçekleştirildiğinde, bu kayıt doğrudan Table Name alanında belirtilen tabloya eklenir.
Oluşturduğumuz form, Free Form ve Form özellikleriyle açılmıştır.
Sol taraftaki form araçları kısmından 1 TextBox, 1 Add File ve 1 Buton aracını sürükleyerek formumuza ekleyelim.
Label'ları sırayla seçip, özellikler bölümündeki Text alanına resimdeki örneğe göre isimlendirmeleri yapalım. İsimlendirmeyi tamamladıktan sonra Enter tuşuna basalım.
Form araçlarının özelliklerini düzenlemek için, her bir form aracını sırasıyla seçip, ardından resimdeki örneğe göre gerekli ayarlamaları yapalım. Name alanındaki isimlendirmeyi tamamladıktan sonra Enter tuşuna basalım.
Client ekranında Save butonuna tıklandığında ekrandaki alanlara girilen verilerin tabloya kayıt edilmesi için, Save butonuna aksiyon ekleyelim. Save butonunu seçelim, ardından aksiyonlar bölümünü seçelim. Add New Action alanına tıklayalım.
Gelen seçeneklerden;
Type of Action: When clicked seçeneğini seçelim.
Operation: Save seçeneğini seçelim.
Ardından aksiyonu kaydedelim.
Kaydedilen aksiyon, resimdeki gibi görünecektir.
Gerekli ayarlamaları tamamladıktan sonra projeyi kaydedelim ve ardından Run butonuna tıklayarak client ekranına geçiş yapalım.
|
Client ekranında, projenin en son kaydedilen hali görüntülenir. Proje kaydedilmeden client ekranına geçiş yapıldığında, son yapılan değişiklikler ekran üzerinde görüntülenemez. |
|
Formun Type değeri 'Form' olarak seçildiği için, proje kaydedildikten sonra, XPODA veri tabanında ekrana eklenen alan isimleri ve veri tipleri ile birlikte, Table Name alanına yazılan isimle yeni bir tablo oluşturulacaktır. |
Formunun client ekranındaki görüntüsü aşağıdaki gibi olacaktır.
Öncelikle, örnek olarak kullanılacak bir Excel (.xlsx) ve bir Word (.docx) dosyası oluşturalım. Bu dosyalar test amacıyla herhangi bir içerik barındırabilir.
Aşağıdaki görselde belirtilen içerik ve sütun yapısı ile bir Excel (.xlsx) dosyası oluşturalım.
Dosya ismini STOCK_LIST olarak ayarlayalım.
Aşağıdaki görselde belirtilen içerik ile bir Word (.docx) dosyası oluşturalım.
Dosya ismini STOCK olarak ayarlayalım.
Oluşturulan Excel ve Word dosyalarını, form üzerinde bulunan Add File aracı ile forma yükleyelim.
Client ekranında yeni bir kayıt oluşturmak için, File Subject alanına istenilen bilgiyi girelim. Dosya eklemek için Add File alanındaki Select File yazısı üzerine tıklayalım ve açılan pencereden STOCK_LIST isimli Excel (.xlsx) dosyasını seçtikten sonra, kaydımızı oluşturmak için Save butonuna tıklayalım.
Add File alanından STOCK isimli Word (.docx) dosyasını seçerek, yeni bir kayıt oluşturalım.
Eklenen dosyaların Document Editor aracı üzerinden görüntülenip düzenlenebilmesi için, Free Form özelliğine sahip yeni bir form açalım. Bu işlem için aşağıdaki resimde kırmızı çerçeve ile işaretlenmiş, new Form ikonuna tıklanmalıdır.
Açılan pencereden Free Form seçeneğini seçelim.
Free Form seçildiğinde Form_2 isminde yeni bir form ekranı oluşacaktır.
Form_2 isimli formu seçelim, ardından ekranın sağ tarafında bulunan form özelliklerini aşağıdaki gibi düzenleyelim.
1 numara ile gösterilen Properties alanını seçelim. Ardından 2 numara ile gösterilen Type alanından Report seçeneğini seçelim.
SQL içinde bulunan XPODA veri tabanı altında tablo oluşturulması istenmediği için, ilgili formun Type özelliği 'Report' olarak seçilmiştir.
Sol taraftaki form araçları kısmından 1 List, 1 TextBox ve 1 Document Editor aracını sürükleyerek formumuza ekleyelim.
2 numara ile gösterilen Textbox aracı için,
Label’ı seçip, özellikler bölümündeki Text alanına Record Guid ifadesini yazalım. İsimlendirmeyi tamamladıktan sonra Enter tuşuna basalım.
Ardından TextBox aracını seçip, özellikler bölümündeki Name alanına Guid ifadesini yazalım. İsimlendirmeyi tamamladıktan sonra Enter tuşuna basalım.
Form_1 içerisinde eklemiş olduğumuz dosya bilgilerini, Form_2 isimli form içerisinde yer alan liste aracı içerisinde görüntüleyebilmek için, öncelikle liste aracını seçelim. Ardından sağ taraftaki özellikler bölümünde bulunan SQL Query alanına ilgili sorgumuzu yazalım. Aşağıda, bu amaca yönelik örnek bir SQL sorgusu bulunmaktadır:
SELECT
DE_FILE_UPLOAD.UserTableID,
DE_FILE_UPLOAD.FileSubject AS [File Subject],
XPODA_FILES.FileName,
XPODA_FILES.RecordGuid AS Record,
XPODA_FILES.FileID AS [|FileID]
FROM DE_FILE_UPLOAD WITH (NOLOCK)
LEFT OUTER JOIN dbo.XPODA_FILES WITH (NOLOCK) ON DE_FILE_UPLOAD.UserTableID = XPODA_FILES.TableID
AND DE_FILE_UPLOAD.FormTypeID=XPODA_FILES.FormTypeID
AND DE_FILE_UPLOAD.ProjectID=XPODA_FILES.ProjectID
|
Add File aracı ile yüklenen dosyalar, sistem tarafından otomatik olarak XPODA_FILES tablosunda saklanır. Bu nedenle, dosya bilgilerini listeleyebilmek için oluşturulan sorguya XPODA_FILES tablosu da dahil edilmelidir. |
|
XPODA_FILES tablosundaki dosyaların Document Editor aracında görüntülenmesi, XPODA_FILES tablosundaki RecordGuid alanı üzerinden sağlanmaktadır. Bu nedenle, ilgili sorguya RecordGuid bilgisini içeren bir sütun eklenmeli ve bu sütuna bir alias (takma ad) verilmelidir. Yukarıdaki sorguda, XPODA_FILES.RecordGuid AS Record satırı, bu amaçla eklenmiştir. |
Client tarafında, Form_2 isimli form açıldığında, eklemiş olduğumuz sorgu sonucunun listede görüntülenebilmesi için, öncelikle listenin tetiklenmesi gerekmektedir.
Form açıldığında liste aracını tetikleyen aksiyonun eklenmesi için, Form_2’ e çift tıklayıp, ardından aksiyonlar bölümünü seçelim. Add New Action alanına tıklayalım.
Gelen seçeneklerden;
Type of Action: When the form is opened seçeneğini seçelim.
Operation: Update Value seçeneğini seçelim.
Value Area: GridListe_1 seçeneğini seçelim.
Ardından aksiyonu kaydedelim.
Kaydedilen aksiyon, resimdeki gibi görünecektir.
Son olarak projeyi kaydedelim ve ardından Run butonuna tıklayarak client ekranına geçiş yapalım.
Listenin client ekranındaki görüntüsü aşağıdaki gibi olacaktır.
Liste üzerinden bir satır seçildiğinde, ilgili satırdaki dosyanın Document Editor üzerinde görüntülenebilmesi için, öncelikle seçilen satırdaki RecordGuid bilgisini (yukarıdaki resimde Record sütunundaki veri) form üzerindeki TextBox alanına aktaralım.
Bu işlem için, öncelikle listeyi seçelim, ardından aksiyonlar bölümünü seçelim. Add New Action alanına tıklayalım.
Gelen seçeneklerden;
Type of Action: When the row is selected seçeneğini seçelim.
Operation: Update Value seçeneğini seçelim.
Value Area: Guid seçeneğini seçelim.
SQL Query: SELECT '$PRecord$' yazalım.
Ardından aksiyonu kaydedelim.
Kaydedilen aksiyon, resimdeki gibi görünecektir.
Son olarak projeyi kaydedelim ve ardından Run butonuna tıklayarak client ekranına geçiş yapalım.
Listeden bir satır seçildiğinde, TextBox alanına RecordGuid bilgisinin aktarılmasının client ekranındaki görüntüsü aşağıda gösterildiği gibi olacaktır.
TextBox alanına RecordGuid bilgisi doldurulduğunda, bu bilgi ile Document Editor aracında seçili dosyanın görüntülenebilmesi için Document Editor aracını tetikleyelim.
Bu işlem için, öncelikle TextBox aracını seçelim, ardından aksiyonlar bölümünü seçelim. Add New Action alanına tıklayalım.
Gelen seçeneklerden;
Type of Action: On Value Change seçeneğini seçelim.
Operation: Update Value seçeneğini seçelim.
Value Area: DocumentEditor_1 seçeneğini seçelim.
Ardından aksiyonu kaydedelim.
Kaydedilen aksiyon, resimdeki gibi görünecektir.
Son olarak projeyi kaydedelim ve ardından Run butonuna tıklayarak client ekranına geçiş yapalım.
Client ekranındaki görüntü aşağıda gösterildiği gibi olacaktır. Listeden bir seçim yapıldığında, ilgili satırdaki dosya Document Editor aracında görüntülenecektir.
|
Desteklenen Dosya Türleri:
|
|
Document Editor aracında görüntülenen dosya üzerinde, Document Editor aracı kullanılarak değişiklik yapılabilmektedir. |
Örnek Kullanım:
Document Editor aracında görüntülenen dosya içerisine Amount sütunu eklenerek, dosya üzerinde değişiklikler yapılmıştır.
CTRL + S tuş kombinasyonu ile yapılan değişiklikleri kaydedelim.
|
Yapılan değişiklikler, CTRL + S tuş kombinasyonu ile kaydedilir. |
Ardından, bu değişikliklere sahip yeni versiyonumuzu yayınlamak için aracın sağ üst köşesinde bulunan Publish butonuna tıklayalım. Açılan Publish Document penceresinde, kaydedilen dokümanın son haline bir isim verelim ve ardından Publish butonuna tıklayarak dosyamızı yayınlayalım.
İşlem başarılı bir şekilde tamamlandığında, ekranın sağ üst bölümünde aşağıdaki gibi bir mesaj görüntülenecektir.
Dokümanımızın yeni versiyonu hazır olup, herkes için görüntülenebilir durumdadır.
|
Dosya üzerinde değişiklik yapıldıktan sonra, CTRL + S tuş kombinasyonu kullanılmadan Publish işlemi gerçekleştirildiğinde, değişiklikler kaydedilmemiş olacaktır. Bu durumda, değişiklikten önceki versiyon tekrar yayınlanacak ve dosya görüntülendiğinde, değişiklikten önceki hali gösterilecektir. |
Eğer dosya üzerinde değişiklik yapıldıktan sonra CTRL + S tuş kombinasyonu kullanılmış ancak Publish işlemi yapılmamışsa, dosya görüntülendiğinde yine değişiklikten önceki hali gösterilecektir.
Bu sebeple, dosya üzerinde yapılan değişikliklerin kaydedilmesi için ilk olarak CTRL + S tuş kombinasyonu ile işlemler kaydedilmeli, ardından Publish butonu ile dosya yayınlanmalıdır.
Publish işlemi tamamlandıktan sonra, liste üzerinden tekrar ilgili satır seçildiğinde, dosya en son yapılan değişikliklerle birlikte görüntülenecektir.
Dosyaya yeni bir satır ekleyip, ardından CTRL + S tuş kambinasyonu ile dosyayı kaydedelim.
Devamında Publish butonuna tıklayalım. Açılan Publish Document penceresinde, kaydedilen dokümanın son haline bir STOCK EXCEL 3 ismini verelim ve ardından Publish butonuna tıklayarak dosyamızı yayınlayalım.
Dokümanımızın yeni versiyonu hazır olup, herkes için görüntülenebilir durumdadır.
|
Dosya üzerinde yapılan değişiklikler, versiyon numarası ile birlikte XPODA_FILES_VERSION tablosunda saklanmaktadır. |
Document Editor aracının sağ üst köşesinde bulunan Show Document History butonuna tıklandığında, açılan Version History pop-up penceresinde Excel (.xlsx) dokümanının kayıt geçmişine ulaşılabilir ve yayınlanan önceki versiyonlar görüntülenebilir.
Current Version ifadesinin bulunduğu satır, en son yayınlanmış versiyonu belirtmektedir.
Eski bir versiyon satırına gelindiğinde, "Open Version" yazısına fare ile tıklanarak, eski versiyon aynı pencerede Read-Only (yalnızca okunabilir) olarak açılır ve değiştirilemez.
Document Editor Aksiyonları;
Document Editor form aracı için kullanılabilecek aksiyonlar, aşağıdaki maddelerde ayrıntılı bir şekilde açıklanmıştır:
1-Document Viewed (Doküman görüntülendiğinde): Bu aksiyon, yalnızca Document Editor aracında kullanılan bir aksiyondur. Bu aksiyon sayesinde, bir doküman görüntülendiğinde, istediğiniz başka bir aksiyonun çalışması sağlanabilir.
Doküman görüntülendiğinde, mesaj gösteren bir aksiyon ekleyelim.
Bu işlem için, öncelikle Document Editor aracını seçelim, ardından aksiyonlar bölümünü seçelim. Add New Action alanına tıklayalım.
Gelen seçeneklerden;
Type of Action: Document viewed seçeneğini seçelim.
Operation: Show Message seçeneğini seçelim.
Message Title: Information yazalım.
Message Content: Document viewed! yazalım.
Message Type: Information seçeneğini seçelim.
Ardından aksiyonu kaydedelim.
Kaydedilen aksiyon, resimdeki gibi görünecektir.
Son olarak projeyi kaydedelim ve ardından Run butonuna tıklayarak client ekranına geçiş yapalım.
Client ekranındaki görüntü aşağıda gösterildiği gibi olacaktır. Listeden bir seçim yapılıp dosya Document Editor aracında görüntülendiğinde, bilgi mesajı karşımıza çıkacaktır.
2-Document Published (Doküman yayınlandığında): ): Bu aksiyon, yalnızca Document Editor aracında kullanılan bir aksiyondur. Doküman üzerinde yapılan değişiklikler, CTRL + S tuş kombinasyonu ile kaydedildikten sonra Publish işlemi gerçekleştirilir. Bu aksiyon sayesinde, publish işlemi yapıldığında, istediğiniz başka bir aksiyonun çalışması sağlanabilir.
Bu aksiyon şu an istenilen işlemi tam olarak yerine getiremiyor. Yeni sürümlerde, bu özellik üzerinde iyileştirme çalışmaları yapılacaktır.