Tanıtım:

Bu uygulamanın iki temel fonksiyonu vardır.

1. MS Word ortamında "HVL-TEMP-TPr" şablonunun 4. Bölümü altında verilen TEST'leri JİRA'da güncelleme/yaratma işlemlerini yapabilecek .csv dosyalarını oluşturmak.
2. MS Excel'de sırası ile (içleri BOŞ da olsa) aşağıdaki sütunlardan oluşan Test Prosedürlerini Jira'ya import edebilecek .csv dosyalarını oluşturmaktır.
3. Test Durumu No
4. Test Durumu Adı
5. Adım No
6. Test Adımı
7. Beklenen Test Sonuçları
8. Açıklamalar
9. Sonuç(G/K/UD)
10. Gereksinim No
11. Ön Koşul
12. Test Girdileri
13. Varsayımlar ve Kısıtlamalar

ÖNEMLİ:

1. Word "parse" işlemi sonucunda iki .csv oluşmaktadır. (abc.docx dosyası ile işlem yapıldığı varsayıldığında)
2. abc_TBU.csv dosyası:

Daha önce Jira'da bulunan "TEST"lerin Word ortamında güncellendikleri varsayımıı ile oluşturulmaktadır. ADMİN yetkileri ile JİRA'da (U)pdate yapılabilmektedir.

1. abc_TBC.csv dosyası:

"TEST"lerin daha önce JİRA'da olmayan, Word dosyası üzerindeki çalışmalar sırasında oluşturulan "TEST"ler oldukları varsayılmaktadır. Bunlar Normal kullanıcı yetkileri ile JİRA'da (C)reate edilebilmektedir.

1. Excel "parse" işlemi sonucunda iki .csv oluşmaktadır. (abc.xlsx dosyası ile işlem yapıldığı varsayıldığında)
2. abc_Tests_TBC.csv dosyası:

"Create" edilecek TEST'leri içeren .csv dosyasıdır. Bunlar Normal kullanıcı yetkileri ile JİRA'da (C)reate edilebilmektedir.

1. abc_TBC_Test_Sets.csv dosyası:

"Create" edilecek TEST SET'leri içeren .csv dosyasıdır. Bunlar Normal kullanıcı yetkileri ile JİRA'da (C)reate edilebilmektedir.

Kullanım

1. Çift tıklayarak jar dosyasını çalıştırınız.
2. "Select TPr to be converted] için [browse] butonuna tıklayarak, csv dosyasına çevirmek istediğiniz Excel veya Word dosyasını seçiniz. (Dosyaların sahip olması gereken içerik ve formatlar yukarıda tanımlanmıştır)
3. Excel Dosyası seçtiyseniz;
4. "Replace "paragraph" character (\n) with" yanındaki seçeneklerden, dokümanın içerisinde geçen "\n" karakterini değiştirmek istediğiniz karakteri seçiniz.

Not: Bu seçimi yaparken dokümanın içinde zaten olması gereken bir karakteri tercih etmeyiniz. Jira'ya import sonrasında \n yerine kullanılanlar ile normalde olması gerekenleri ayırt etmeniz zorlaşabilir.

1. Dil Seçimi: 1. English ise çeşitli adımlar için yazılmış bilgiler Jira'ya For_Step-XXXX:….. şeklinde aktarılır. 2. Türkçe ise bu bilgiler XXXX numaralı Test Adımı için; …….. şeklinde aktarılır.
2. Word dosyası seçtiyseniz;
3. "Replace "paragraph" character (\n) with" yanındaki seçeneklerden, dokümanın içerisinde geçen "\n" karakterini değiştirmek istediğiniz karakteri seçiniz.

Not: Bu seçimi yaparken dokümanın içinde zaten olması gereken bir karakteri tercih etmeyiniz. Jira'ya import sonrasında \n yerine kullanılanlar ile normalde olması gerekenleri ayırt etmeniz zorlaşabilir.

1. "Please Set Issue Key Prefix"'den, Jira'daki Issue Key'lerin prefix'ini giriniz. (Örn: TBGTH,KRBN)
2. Dil Seçimi: 1. English ise; HVL-TEMP-TPr'nin İngilizce başlıklarına göre parse işlemi yapılır. 2. Türkçe ise; HVL-TEMP-TPr'nin Türkçe başlıklarına göre parse işlemi yapılır.
3. .csv dosyasının oluşturulacağı klasörü seçiniz.

Not: Herhangi bir seçim yapılmaz ise excel belgesinin olduğu konuma oluşturulacaktır.

1. Create .csv butonu ile csv dönüştürme işlemini başlatabilirsiniz.

Arayüzdeki Diğer Hususlar

1. Uygulamanın bir sonraki açılışında "browse" butonları ile yaptığını seçimlere göre açılmasını isterseniz "close" butonu ile çıkış yapınız.
2. "browse" ile yaptığını seçimlerin "default" konumlara dönmesi için "Clear All" butonunu kullanabilirsiniz.

Not: "Default" "directory"ler, "Windows"un ilgili kullanıcıya ait "Downloads" alanlarıdır.

1. Sağ üstteki çarpı butonu ile karşınıza 3 seçenek çıkacaktır.
2. Exit: direk uygulamayı kapatır,
3. Save&Exit docx ve csv dosyasının directory'lerini kaydederek sonraki kullanımda o directory'den başlayacak şekilde uygulamayı kapatacaktır.
4. Cancel seçeneği uygulamayı kapatmayacaktır.

Bu uygulamanın mevcut sürümünde WORD formatındaki TPR’nin “parse” edilmesiyle ilgili "handle" EDİLEMEYEN "Exception"lar aşağıdaki gibidir;

1-Issue key "|" işaretleri arasına olmalıdır. Aksi takdirde bu testler yeni oluşturulmuş varsayılacaktır.

2-Bir “Test”in, “Test” olduğunun anlaşılabilmesi için 4.X.X seviyesindeki başlığın “ - ” ile başlaması gerekmektedir. (tırnak işaretleri olmadan)

a. , ilgili proje’nin Jira’daki kısaltması olmalıdır.

b. Uygulama’da da aynı girilmesi gerekecektir.

c. CASE SENSITIVE’dir.

3- Uygulama Word dosyasındaki halihazırda kullanılan bütün ";" işaretlerini ":" ile "replace" etmektedir, çünkü "delimiter" olarak ";" kullanılması gerekmektedir.

4- IV. (4.) Bölüm kapsamında BAŞLIK olmayan yerlerde , "Test Girdileri", "Varsayımlar ve Kısıtlamalar", "Ön Koşullar", "Test Adımları" ifadelerinin tek başına yer almaması gerekmektedir.

Örn:

4.1 Geçici Kabul Gözle Muayene

4.1.1 |PROJE-0001| – Gözle Kontroller

4.1.1.1 Ön Koşullar

Gözle kontrol edilecek cihazların ilgili sahalarda kurulumlarının tamamlanmış olması gerekmektedir.

4.1.1.2 Test Girdileri

Test Başlangıç Tarihi-Saati:

Test Bitiş Tarihi-Saati:

Yüklenici Temsilcisi:

Müşteri Temsilcisi:

Detaylı Test Girdileri, Test Adımları'nda verilmiştir.

4.1.1.3 Varsayımlar ve Kısıtlamalar

Ön Koşullar'daki ihtiyaçların karşılanacağı varsayılmaktadır. Bahse konu test sahada devam eden operasyonu etkilemeyecek şekilde koşulması sağlanacaktır.

Yukarıda; Varsayımlar ve Kısıtlamalar başlığı altında geçen "Ön Koşullar'daki …." ifadesi Test Girdileri başlığı altında geçen "Detaylı Test Girdileri, Test Adımları'nda verilmiştir" ifadesi SORUN YARATMAZ.

Fakat aşağıdaki örnekte görülen; Herhangi bir başlığın altında yanlışlıkla yanına bir şey yazılmadan bırakılmış "Ön Koşullar", "Test Adımları" ifadeleri .csv'de sorun yaratacaktır.

4.2 Geçici Kabul Gözle Muayene

4.2.1 |PROJE-0001| – Gözle Kontroller

4.2.1.1 Ön Koşullar

Gözle kontrol edilecek cihazların ilgili sahalarda kurulumlarının tamamlanmış olması gerekmektedir.

4.2.1.2 Test Girdileri

Test Adımları

4.2.1.3 Varsayımlar ve Kısıtlamalar

Ön Koşullar

5- Test Adımları bölümünün 32760 karakterden uzun olmaması gerekmektedir.

Dokümanda böyle bir durum varsa, bu karakter sayısına ulaşılan noktadan sonraki adımlar .csv’ye alınamamaktadır.

Bu durumda .csv belgesinde "Manuel_Test_Step_Import_Needed_Label" sütununun altında "Manuel_Test_Step_Import_Needed" ifadesi belirecektir.

Bu label’in görüldüğü testler Jira’ya eklendikten/güncellendikten sonra “Test” issue’sinin içinden Test Adımları import yöntemi kullanılarak eksik kalan adımlar Jira’ya aktarılabilir.

6- Summary kısmının 255 karakterden uzun olması.

Dokümanda böyle bir durum varsa, Summary 255’inci karakterden sonra kesilerek .csv’ye alınmaktadır.

Bu durumda .csv belgesinde "Summary_Trimmed_Label" sütununun altında "Summary_Trimmed" ifadesi belirecektir.

7- Test açıklamaları başlamadan önce 4. TEST AÇIKLAMALARI başlığı mutlaka olmalıdır.

8- Test aralarında testleri konu başlıklarına bölen kısımların issue key prefix'i ile başlaması

ÖRN :

4.1 TBGTH Test Adımları (Exception Çıkaracaktır.)

4.1 Test Adımları TBGTH (Exception Çıkarmayacaktır.)

9- Test "test adımları" kısmı dışında tablo bulunması durumunda "OLE_Objects_Needs_Manuel_Processing_Label" sütununun altında "OLE_Objects_Needs_Manuel_Processing_Needed" ifadesi belirecektir.

(Bu tabloda test adımlarında yer alan sütunların birebir aynı sıra ve yazılarda yer almaması gerekmektedir.)

ÖRN:

| Adım No | Test Adımı | Beklenen Test Sonuçları | Açıklamalar | Sonuç | Gereksinim No |

Şeklinde sütunları olan bir tablonun dokümanın farklı yerlerinde geçmesi durumunda tablonun WORD'den silinmesi ve daha sonra Jira'ya visual mod kullanılarak eklenmesi gerekir.

10- Dokümanın herhangi bir yerinde bir resim kullanılması durumunda resim yok sayılarak parse işlemi devam edecektir. Fakat resimlerin yok sayıldığı bilgisi henüz excel dosyasında belirtilememektedir.