Kurulum 2 Sistem Gereksinimleri 2 Altyapı Gereksinimleri 2.NET Framework Sürüm 1.1 Kurulumu: 4 Microsoft WSE 2.0 SP3 Runtime.msi Kurulumu: 6.NET Framework Sürüm 3.5 Kurulumu: 4 KBS Lokal Uygulama Yazılımı Kurulumu: 8 Versiyon Güncellemesinde Dikkat Edilmesi Gereken Hususlar: 10 Temel Bilgilerin Tanımlanması 12 Tesis Kodu: 12 Web Servis Adresi Kontrol ve Değiştirme: 13 Dosya Transferi 15 Hangi Tip Dosya: 15 Müşteri Bilgilerini Veri Tabanında Tutan Tesisler 15 Otomasyon Programında, Emniyet Genel Müdürlüğü nün GİYKİMBİL XML Standardını Destekleyen, Modül Bulunan Tesisler 15 Veri Tabanı Olmayan Tesisler 16 XML Yapıda Dosya Transferi: 17 Excel Yapıda Dosya Transferi: 19 Manuel Hazırlanmış Dosya Transferi: 21 Kayıt Listesi Formu: 21 Kayıt Giriş ve Güncelleme Formu: 26 T.C. Kimlik Numarası Sorgulama 29 Yeni Versiyon Kontrolü 30 Dosya Transferinde Alınan Hatalar 31 Lokal Uygulama Tarafından Üretilen Hatalar: XML Yapısında Hata Bulunmaktadır. Şema Olarak Kullanılan Dosya ('XML\Kayitsema.xsd') Bulunamadı. XML Şeması İstenen Şemaya Uymamaktadır. HASH Değeri Eksik Olduğu İçin İşleme Devam Edilemiyor. Kişi Sıra Numarası Alanında Uyumsuzluk Bulunmaktadır. XML Dosya İçerisinde Tesis Kodu Bilgisi Eksik veya Tanımladığınızdan Farklı Olduğu İçin İşleme Devam Edilemiyor. 'Excel' Dosya Okunurken Hata İle Karşılaşıldı. Göndermek İstediğiniz Kayıtlardan Bazıları İstenen Formata Uymamaktadır. Web Servis Kullanımı Sırasında Hata Oluşmuştur. Ana Sistem Tarafından Üretilen Hatalar: Hata Kodu: -1 Hata Kodu: -2 Hata Kodu: 11 Hata Kodu: 12 Hata Kodu: 21 Hata Kodu: 22 Hata Kodu: 23 31 31 31 32 32 32 33 33 33 35 36 36 36 36 36 36 36 36 VERİ YAPILARI 36 Müşteri Bilgileri Alan Açıklamaları 36 Ülke Kodları 39 Kimlik Belgesi Kodları 41 Cinsiyet Kodları 41 Medeni Hal Kodları 41 XML Yapı 42 XML Hakkında Genel Bilgi: 43 Dikkat Edilmesi Gereken Hususlar: 44 EXCEL Yapı 45
Dikkat Edilmesi Gereken Hususlar: 46 Kurulum Sistem Gereksinimleri İşletim Sistemleri: Windows 2000; Windows ME; Windows Server 2003 Service Pack 1 for Itanium-based Systems; Windows Server 2003 x64 editions; Windows XP; Windows XP Professional x64 Edition, Window Vista (KBS 3.5.0 ve yukarı sürümler), Windows 7 (KBS 3.5.0 ve yukarı sürümler). Microsoft Internet Explorer 5.01 veya daha yeni bir sürümünü de çalıştırıyor olmanız gerekir. Altyapı Gereksinimleri.NET Framework Sürüm 1.1 (KBS 2.2.1 Sürümü İçin) Microsoft WSE 2.0 SP3 Runtime.msi.Net Framework Sürüm 3.5 (KBS 3.5.0 ve Yukarı Sürümler İçin) Sistem gereksinimleri tesis tarafından karşılanacaktır. Altyapı yazılımları Microsoft firması tarafından ücretsiz olarak verildiğinden herhangi bir ücret ödenmeden kullanılabilmektedir. Gerekli olan altyapı ve adresinden indirilebilmektedir. uygulama yazılımları www.jandarma.gov.tr/kbs
Şekil 1
.NET Framework Sürüm 1.1 Kurulumu: Eğer bilgisayarınızda.net Framework uygulaması yüklenmemişse: 1. Adım: dotnetfx.exe adlı dosya seçilmelidir. Bu dosya seçildikten ve dosyanın üzerine farenin (mouse) sol tuşu ile iki kere üst üste basılır. 2. Adım: Gelen pencerede EVET seçeneği seçilerek devam edilir. 3. Adım: Kurulum için gerekli geçici dosyalar oluşturulmaktadır. 4. Adım: Kurulum işlemi gerçekleştirilmektedir. 5. Adım: Kurulumun bittiğine dair mesaj kutusu gelmektedir. OK seçeneği seçilerek kurulum işlemi sonlandırır. Eğer bilgisayarınızda.net Framework altyapısının herhangi bir versiyonu kurulu ise 2. adımda kuruluma başlamak yerine aşağıdaki mesaj verilerek kurulum işlemi sonlandırılmaktadır. Şekil - 1.NET Framework Sürüm 1.1 hakkında detaylı bilgi ve son sürümleri için Microsoft un aşağıdaki internet adresi ziyaret edilebilir. http://www.microsoft.com/downloads/browse.aspx?displaylang=tr&productid=c 9C8FCFB-BFF3-40CA-B59D-216F6850000A
Şekil - 2
Microsoft WSE 2.0 SP3 Runtime.msi Kurulumu: 1. Adım: Microsoft WSE 2.0 SP3 Runtime.msi adlı dosya seçilmelidir. Bu dosya seçildikten ve dosyanın üzerine farenin (mouse) sol tuşu ile iki kere üst üste basılır. 2. Adım: Gelen pencerede Next seçeneği seçilerek devam edilir. 3. Adım: Kırmızı yuvarlak ile gösterilen seçenek tercih edilmezse kurulum yapılmasına devam edilemez. Kırmızı yuvarlak ile belirtilen seçenek işaretlenerek Next seçeneği seçilmelidir. 4. Adım: Install seçeneği seçilerek kuruluma başlanır. 5. Adım: Kurulumun bittiğine dair mesaj kutusu gelmektedir. Finish seçeneği seçilerek kurulum işlemi sonlandırır.
Şekil - 3.NET Framework Sürüm 3.5 Kurulumu: Eğer bilgisayarınızda.net Framework uygulaması yüklenmemişse: 1. Adım: dotnetfx351setup.exe adlı dosya seçilmelidir. Bu dosya seçildikten ve dosyanın üzerine farenin (mouse) sol tuşu ile iki kere üst üste basılır.
2. Adım: Gelen pencerede ÇALIŞTIR seçeneği seçilerek devam edilir. 3. Adım: Kurulum için gerekli geçici dosyalar oluşturulmaktadır. 4. Adım: Kurulum işlemi gerçekleştirilmektedir. 5. Adım: Kurulumun bittiğine dair mesaj kutusu gelmektedir. OK seçeneği seçilerek kurulum işlemi sonlandırır. Eğer bilgisayarınızda.net Framework altyapısının herhangi bir versiyonu kurulu ise 2. adımda kuruluma başlamak yerine aşağıdaki mesaj verilerek kurulum işlemi sonlandırılmaktadır..net Framework Sürüm 3.5 hakkında detaylı bilgi ve son sürümleri için Microsoft un internet adresi ziyaret edilebilir. http://www.microsoft.com/en-us/download/details.aspx?id=25150 KURULUM ADIMLARI GÖRSEL Şekil-1 Şekil-2
Şekil-3
Şekil-4
Şekil-5
Şekil-6 KBS Lokal Uygulama Yazılımı Kurulumu: 1. Adım: KBS_3_5_0.msi adlı dosya seçilmelidir. Bu dosya seçildikten ve dosyanın üzerine farenin (mouse) sol tuşu ile iki kere üst üste basılır. 2. Adım: Gelen pencerede Tamam seçeneği seçilerek devam edilir. 3. Adım: Gelen pencerede Next seçeneği seçilerek devam edilir. 4. Adım: Kurulum ile ilgili tercihlerin sorulduğu bölümdür. Kurulum yeri değiştirilebilmektedir. Ancak kurulum yerinin değiştirilmesi önerilmemektedir. Ayrıca uygulamayı kurulumu gerçekleştiren kişiden başka kişiler de kullanacaksa kırmızı ufak yuvarlak ile gösterilen seçenek tercih edilmelidir. Daha sonra Next seçeneği seçilmelidir. 5. Adım: Next seçeneği seçilerek kuruluma başlanır.
6. Adım: Kurulumun bittiğine dair mesaj kutusu gelmektedir. Close seçeneği seçilerek kurulum işlemi sonlandırır. Kurulum işleminden sonra bilgisayar masa üstünde, şeklinde görülen bir simge gelir. Yeni sürümün kurulumundan sonratesis Kodu girişinde hata alındığında; Bilgisayar kullanıcısına, KBS programının kurulu olduğu C:\Program Files\JGNK\ klasörüne erişmesi için TAM YETKİ (Yazma ve Değiştirme) verilmelidir.
Şekil - 4
Versiyon Güncellemesinde Dikkat Edilmesi Gereken Hususlar: Aynı veya daha düşük versiyonun kurulmak istenmesi durumunda var olan versiyonun bilgisayardan kaldırılması gerekmektedir. Daha üst versiyonlar kurulmak istenirse eski sürüm otomatik olarak kaldırılmaktadır. Ancak bazen çeşitli sebeplerden eski versiyon otomatik olarak kaldırılamadığından kullanıcıdan bunu manuel yapması istenebilmektedir. Şekil - 5
Şekil - 6 Alt yapı yazılımları bir sefer kurulmasını müteakip sürüm güncellemelerinde tekrar kurulmasına ihtiyaç bulunmamaktadır. Ancak herhangi bir sebeple tekrar kurulmak istendiği takdirde önceki sürümünün bilgisayardan kaldırılması gerekmektedir. Versiyon güncelleme veya tekrar kurulum sırasında daha önce tanımlanmış olan temel bilgiler sistemden silinmektedir. Dolayısıyla bu bilgiler kurulumdan sonra uygulamanın ilk çalışması esnasında tekrar tanımlanmalıdır. Manuel dosya hazırlayan tesislerin de müşteri bilgileri silinmekte olup tekrar baştan girilme zorunluluğu bulunmaktadır.
Temel Bilgilerin Tanımlanması Tesis Kodu: Güvenlikli dosya transferi için kullanılan tesis kodu ve şifre bilgilerine ihtiyaç bulunmaktadır. Tesis yetkilisinin, tesis kodunu her dosya transferinde tekrar yazmasını engellemek maksadıyla tesis kodu uygulama yazılımı içinde parametrik olarak tutulmaktadır. Dolayısıyla tesis yetkilisi tarafından kendisine verilen tesis kodunu uygulamaya bir defaya mahsus girmesi gerekmektedir. Uygulama programı bilgisayara her yüklendiğinde yukarıda bahsedilen adımlar tekrarlanarak tesis kodu girilmelidir Şekil - 7
Web Servis Adresi Kontrol ve Değiştirme: Üç maksatla kullanılmaktadır. 1. Uygulama ilk kurulduğunda otomatik olarak gelen web servis adresinin doğru olup olmadığının kontrolü, 2. Uygulamayı kullanırken dosya transferinde web servis adresinin bulunamadığına dair mesaj alındığında kontrol için, 3. J.Gn.K.lığı tarafından yeni web servis adresi bildirildiğinde değiştirmek için.
Şekil - 8 Testin olumsuz çıkma durumunda bir mesaj gelmekte ve form üzerinde bulunan Kaydet tuşu pasif duruma geçmektedir. Testten geçemeyen adresin sisteme kaydedilmesi önlenmektedir. Şekil - 9 Testin olumsuz çıkmasının çeşitli sebepleri olabilmektedir. Bunlar; Girilen adres yanlış yazılmış olabilir, Bilgisayarın internet bağlantısı kopmuş olabilir, Bilgisayar üzerinde veya bilgisayarın bağlı bulunduğu ağ üzerinde bulunan güvenlik yazılımları tarafından engelleniyor olabilir. Öncelikli olarak yukarıda belirtilen sebeplerin araştırılması gerekmektedir. Bunun için tesis bilgisayar ve alt yapısından sorumlu olan kişilerden yardım istenmelidir. Her türlü kontrol yapıldıktan sonra test hala olumsuz çıkıyorsa durumu İl veya İlçe J. K.lıklarındaki yetkili kullanıcılara iletiniz.
Dosya Transferi Hangi Tip Dosya: Müşteri bilgileri tesislerden belirli yapılara göre hazırlanmış dosyalar halinde istenmektedir. XML yapıda dosya, Excel yapıda dosya, Manuel hazırlanmış dosya. Dosya tipleri ve yapıları tespit edilirken sistem gereksinimlerinin yanında tesislerin imkan kabiliyetleri ile en kısa zamanda adapte olmaları için gerekli koşullar da dikkate alınmıştır. Müşteri Bilgilerini Veri Tabanında Tutan Tesisler Öncelikli olarak müşteri bilgilerini bir otomasyon programı vasıtasıyla veri tabanında tutan tesislerin aynı bilgileri KBS için lokal programa tekrar girişi önlenmek istenmiştir. Veri tabanında bulunan müşteri bilgilerini, kendi otomasyon programlarının içine ekletecekleri modül aracılığıyla, dosya içine aktarabilmeleri için XML ve Excel yapıda olmak üzere iki değişik dosya yapısı belirlenmiştir. Bu şekilde veri tabanına sahip tesislerin sahip oldukları otomasyon programı teknik destek elemanları ile irtibata geçerek kendilerine uygun olan iki yapıdan bir tanesine göre dosya üreten modülü ekletmeleri gerekmektedir. Otomasyon Programında, Emniyet Genel Müdürlüğü nün GİYKİMBİL XML Standardını Destekleyen, Modül Bulunan Tesisler Emniyet Genel Müdürlüğü daha önceden kendi sorumluluk sahasında bulunan geçici ikamet edenlerin kimlik bildirimi ile ilgili GİYKİMBİL projesini geçirerek bu proje kapsamında gönderilecek verilerin GİYKİMBİL XML standardında hazırlanmasını istemiştir. Bu gelişme üzerine piyasada bulunan tesis otomasyon programlarının büyük bölümü, veri tabanlarından istenen standartta müşteri bilgileri dosyası üretmek için gerekli olan modülleri geliştirmişlerdir. Jandarma sorumluluk sahasında da yukarıda anlatılan otomasyon programlarından kullanan tesislerin sayısının fazla olduğu tespit edilmiş olup bu tesislerin mevcut otomasyon programlarına herhangi bir ek modül ekleme ihtiyacı duymaması için GİYKİMBİL XML standardında hazırlanış dosyalarda kabul edilmektedir. Bu durumda olan tesisler, sahip oldukları otomasyon programı teknik destek elemanları ile irtibata geçerek dikkat etmesi gereken hususlarda kendilerinin bilgilendirilmelerini istemeleri gerekmektedir. Veri Tabanı Olmayan Tesisler Veri tabanı olmayan, olduğu halde kendi veri tabanını kullanmak istemeyen tesislerin yasa kapsamında bulundurması zorunlu olan donanım dışında ek külfete
girmeden müşteri bilgilerini iletmeleri mümkündür. Bunu için kendilerine verilen iki seçenekten birini kullanmaları yeterli olacaktır. 1. Müşteri bilgileri dosyasını EXCEL yapıda hazırlayarak göndermelidir. Bu seçenekte bir program kullanmadan elle veri giriş olacağından girilmesi zorunlu alanlar, alan tiplerine çok dikkat edilmelidir. 2. Lokal program içersindeki manuel dosya hazırlama arayüzünü kullanmaktır. Manuel dosya hazırlama, tesis sorumlusuna bir arayüz yardımıyla müşteri bilgilerini girmede yardımcı olmaktadır. Manuel hazırlanan bilgiler bir dosya içerisinde bulunması, bir kontrol mekanizması olmadığından yanlışlıkla silinebilmesi, silinmesi durumunda geriye dönüş imkanı olmadığı için tüm bilgilerin baştan girilecek olması önemli problemler yaratmaktadır. Bu yolu seçen tesislerin yukarıda anlatılan hususlara çok dikkat etmeleri gerekmektedir.
XML Yapıda Dosya Transferi: 1. Adım: Ana menüdeki Dosya Transferi altındaki XML Dosya Gönder tuşu tıklanır. Açılan form Excel yapıda dosya transferi için kullanılan form ile benzer olduğundan hatalı işlem yapmamak için formun başlığında XML Tipi Dosya Gönderme Formu yazıldığından emin olunmalıdır. 2. Adım: Gelen formda, hazırlanan XML dosyayı seçmek için Dosya Seç tuşu tıklanarak. 3. Adım: Açılan dosya seçim penceresi yardımıyla hazırlanan XML dosya seçilerek Aç tuşu tıklanır. Dosya seçim penceresi XML uzantısı haricindeki dosyaları seçmeyi engellemektedir. 4. Adım: gönderilir. Tesis şifresi girildikten sonra Gönder tuşu tıklanarak dosya 5. Adım: Ana sistem tarafından dosya kabul edildiği takdirde İşlem Başarı İle Tamamlandı ile başlayan ve kaç müşteriye ait kayıt alındığına dair bir mesaj geri döner. Gönderilmek istenen XML dosya lokal uygulama ve ana sistem tarafından kabul edilmeden önce çeşitli kontroller yapılmakta ve uygun olmayanlar hakkında çeşitli uyarı veya hata mesajları verilmektedir. Karşılaşabilinecek uyarı ve hata mesajları ileride toplu olarak verilmektedir.
Şekil - 10
Excel Yapıda Dosya Transferi: Excel yapıda dosya transferinde uygulama bulunduğu bilgisayardaki Microsoft Office dll dosyalarını kullanmaktadır. Bu yüzden uygulamanın çalıştığı bilgisayarda Microsoft Office paketi kurulu olmadığı takdirde hata verecektir. Bu durumda tesisin bilgisayarına ya Microsoft Office paketini kuracak ya da diğer gönderme seçeneklerini kullanacaktır. 1. Adım: Ana menüdeki Dosya Transferi altındaki Excel Dosya Gönder tuşu tıklanır. Açılan form XML yapıda dosya transferi için kullanılan form ile benzer olduğundan hatalı işlem yapmamak için formun başlığında XLS Tipi Dosya Gönderme Formu yazıldığından emin olunmalıdır. 2. Adım: Gelen formda, hazırlanan Excel dosyayı seçmek için Dosya Seç tuşu tıklanarak. 3. Adım: Açılan browser yardımıyla hazırlanan Excel dosya seçilerek Aç tuşu tıklanır. Browser XLS uzantısı haricindeki dosyaları seçmeyi engellemektedir. 4. Adım: gönderilir. Tesis şifresi girildikten sonra Gönder tuşu tıklanarak dosya 5. Adım: Ana sistem tarafından dosya kabul edildiği takdirde İşlem Başarı İle Tamamlandı ile başlayan ve kaç müşteriye ait kayıt alındığına dair bir mesaj geri döner. Gönderilmek istenen XLS dosya lokal uygulama ve ana sistem tarafından kabul edilmeden önce çeşitli kontroller yapılmakta ve uygun olmayanlar hakkında çeşitli uyarı veya hata mesajları verilmektedir. Karşılaşabilinecek uyarı ve hata mesajları ileride toplu olarak verilmektedir.
Şekil - 11
Manuel Hazırlanmış Dosya Transferi: Kayıt Listesi Formu: Ana menüdeki Dosya Transferi altındaki Manuel Dosya Hazırla tuşu tıklanarak kayıt listesi formu açılır. Şekil - 12 Girilen müşteri bilgilerini XML yapıda olan bir dosya içinde saklamaktadır. Bu dosya, uygulamanın kurulumu sırasında oluşturulan klasörün altında JGNK.XML adında bulunmaktadır. Bu dosyayı oluştururken de dışarıdan erişime karşı kontrol değerleri oluşturmaktadır. Uygulama, her manuel dosya hazırlama formuna girişte öncelikli olarak bu dosyayı aramaktadır. Dosyayı bulamadığında veya bulduğunda yaptığı kontrolde dışarıdan müdahale edildiğini tespit ettiğinde içindeki bilgileri yok sayarak listeyi boş getirmektedir. Bu durumda liste formunu açmadan önce uyarmaktadır. Şekil - 13 Daha önce girilmiş kayıtlar bozulmamış ise gelen formun içinde liste halinde toplu olarak gösterilmektedir. Kayıt listesi formu ile aşağıdaki işlemler yapılabilmektedir: Yeni kayıt ekleme formuna geçiş, Kayıt güncelleme formuna geçiş, Yanlışlıkla girilen veya tesisten ayrılmış müşteri bilgisini silmek, Hazırlanan listeyi ana sisteme göndermek, Hazırlanan listeyi daha sonra göndermek üzere kaydetmek, En son kaydedilme işleminden sonra yapılan tüm işlemleri iptal ederek çıkmak.
Şekil - 14 JGNK.XML Dosyasına Kayıt Esasları: Form açıldığında JGNK.XML dosyasında bulunan verileri geçici belleğe alınmaktadır. Bu aşamadan itibaren yapılan her türlü ekleme, güncelleme ve silme işlemleri Kaydet ve Gönder veya Kaydet tuşlarından birine basılmadığı sürece geçici bellekte tutulmaktadır. Kullanıcı yaptığı işlemlerden vazgeçmesi durumunda kaydetmeden İptal tuşuna basarak veya formun sol üstünde bulunan x işaretine tıklayarak formdan çıkması durumunda o ana kadar yapılan işlemler iptal edilecektir. Yapılan işlemler kaydedilmeden önce programsal bir hata sebebiyle veya elektrik kesilmeleri vb. sebeplerle programın kontrolsüz olarak sonlandırılması durumunda da yapılan işlemler gene iptal olacaktır. İstenmeyen sebeplerden dolayı yapılan işlemlerin iptal edilmesini engellemek için yapılan işlemlerin zaman zaman Kaydet tuşu tıklanarak kaydedilmesinde fayda bulunmaktadır. Her kaydetme işleminde JGNK.XML dosyası o anda var olan verilerle güncellenecektir. Bu sebepten kaydetme işlemi tamamlandıktan sonra da geriye dönüş mümkün olmamaktadır. Kayıt Silme İşlemi: Öncelikli olarak silinmek istenen kayıt seçilir ve Sil tuşuna veya formun sağ üst köşesindeki Program menüsünün altında bulunan Sil seçeneği tıklanarak kayıt geçici olarak silinir. Kaydın kalıcı olarak silinmesi için Kaydet ve Gönder veya Kaydet işlemlerinden birinin yapılması gerekir. Bu işlemler yapılmadan İptal tuşuna basılarak veya formun sol üstünde bulunan x işaretine tıklanarak çıkma durumunda silme işlemi iptal edilecektir.
Şekil - 15 Kayıt ve Gönder: Müşteri bilgilerinin giriş ve güncelleme işlemlerinin bitirilmesini müteakip verilerin ana sisteme gönderilmesi için öncelikle şifre girilerek Kaydet ve Gönder tuşuna tıklanır. Uygulama gerekli kontrolleri tamamladıktan sonra öncelikli olarak JGNK.XML dosyasına son durumu kaydetme işlemini tamamlar, daha sonra ana merkeze verilerin gönderme işlemine geçer. Ana sistem tarafından dosya kabul edildiği takdirde İşlem Başarı İle Tamamlandı ile başlayan ve kaç müşteriye ait kayıt alındığına dair bir mesaj geri döner. Gönderilmek istenen bilgiler dosya lokal uygulama ve ana sistem tarafından kabul edilmeden önce çeşitli kontroller yapılmakta ve uygun olmayanlar hakkında çeşitli uyarı veya hata mesajları verilmektedir. Karşılaşabilinecek uyarı ve hata mesajları ileride toplu olarak verilmektedir.
Şekil - 16
Kayıt Giriş ve Güncelleme Formu: Kayıt listesi formunda; giriş için Ekle, güncelleme için öncelikli olarak güncellenmek istenen kayıt seçilir ve Güncelle tuşuna tıklanarak kayıt giriş ve güncelleme formuna geçilir.
Şekil - 17 Zorunlu alanların kolay anlaşılması için, formda alan isimleri için üç ayrı renk grubu kullanılmıştır. KIRMIZI : Tüm müşteriler için doldurulması zorunlu olan alanlardır. MAVİ : T.C. Vatandaşı müşteriler için kırmızı alanlar ile birlikte doldurulması zorunlu olan alanlardır. SİYAH : Doldurma mecburiyeti bulunmayan alanlardır. Formda üç çeşit veri girişi tipi mevcuttur:
1. Uzun beyaz dikdörtgen olan alanların içine istenen formatta karakter girişine müsaade edilmektedir. Serbest giriş olmakla beraber her alan veri yapısında belirilen tipte ve uzunlukta karakter girişine müsaade etmektedir. 2. Seçmeli alanlar olup sadece ekranda görülen tercihlerden birinin seçilmesine müsaade etmektedirler. 3. Tarih alanlarıdır. Alanın solunda bulunan ok a basarak ekrana gelen tarih formu aracılığıyla veya elle tarih bilgileri girilebilmektedir. Şekil - 18 İstenen yapıya uygun müşteri bilgisinin giriş veya güncellemesi yapıldıktan sonra Kaydet tuşuna tıklanır. Uygulama öncelikli olarak verinin istenen yapıda girilip girilmediğini, eksik bilgi olup olmadığını kontrol eder. Hata olması durumunda hata mesajı vererek imleci hatalı olan alana yerleştirir. Şekil - 19 Kaydın uygun olması durumunda geçici belleğe kaydederek kaydedildiğine dair mesaj verir ve kayıt listesi formuna geri döner. Yapılan işlemin JGNK.XML dosyasına kaydedilme işlemi ancak kayıt listesi formundan da kaydetme işlemi yapıldıktan sonra gerçekleşmektedir. Giriş ve güncelleme işleminden vazgeçmek istenmesi durumunda formda bulunan Geri tuşunu tıklamak yeterli olacaktır.
T.C. Kimlik Numarası Sorgulama Nüfus ve Vatandaşlık İşleri Genel Müdürlüğü (NVİGM) tarafından yürütülen MERNİS projesi kapsamında her T.C. vatandaşı için bir T.C. Kimlik Numarası verilmektedir. Resmi, bankacılık vb. işlemlerde de T.C. Kimlik Numarası kullanılması zorunlu hale getirilmiştir. 2000 yılından sonra verilen nüfus cüzdanlarında bu bilgi mevcut olmakla beraber daha eski nüfus cüzdanları, ehliyet ve kimlik yerine geçen diğer belgelerde bu alan mevcut değildir. NVİGM internet sitesinde vatandaşların sorgulayabileceği bir hizmet sunmaktadır. T.C. Kimlik Numaralarını Tesiste bulunan müşterilerden T.C. Kimlik Numarası bilinmeyenlerin sorgulanması için NVİGM internet sitesine daha rahat ulaşabilmeleri için kısayollar konulmuştur. T.C. Kimlik Numarası sorgulama ve doğrulama servisleri NVİGM ne ait olduğu için servislerin kullanımı ile ilgili bilgiler ilgili sitede mevcut bulunmaktadır. Şekil - 20
Yeni Versiyon Kontrolü İhtiyaç duyulması halinde uygulama üzerinde güncellemeler yapılarak yeni versiyon çıkarılabilmektedir. Yeni versiyonun kullanıma başlanılması ile ilgili tesislere tebligat yapılacak olsa da tesislerin en son güncel versiyonu kullandıklarından emin olmaları için uygulama içerisinden yeni versiyon kontrolü yapılabilmektedir. Bunun için ana menüde bulunan Yardım menüsünün altındaki Yeni Versiyon Kontrolü seçeneği tıklanır. Şekil - 21 Yeni versiyonun mevcut olması durumunda tesis ikaz edilerek kurulum dosyasının indirilmesi sağlanır. Kurulum dosyası indirildikten sonra kurulum talimatına göre yeni versiyonun kurma işlemi gerçekleştirilerek işlemlere devam edilir.
Dosya Transferinde Alınan Hatalar Lokal Uygulama Tarafından Üretilen Hatalar: XML Yapısında Hata Bulunmaktadır. Şekil - 22 Otomasyon program tarafından üretilmiş olan XML dosya, veri yapıları bölümündeki XML Hakkında Genel Bilgi deki belirtilen kurallara uygun olarak üretilmediği durumlarda verilen hatadır. Özellikle kullanılmaması gereken karakterlerin müşteri ad, soyadı, adres bilgileri içinde kullanıldığı ve otomasyon programının bunları engellemediği zamanlarda sık sık alınmaktadır. Otomasyon program içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir. Şema Olarak Kullanılan Dosya ('XML\Kayitsema.xsd') Bulunamadı. Şekil - 23
Kurulum sırasında oluşturulan klasörün altında bulunan XML klasörünün içinde Kayitsema.xsd ile Kayitsema.xsx şema dosyaları oluşturulmaktadır. Şema dosyaları gönderilmek istenilen XML dosyanın şekil olarak istenen formatta olup olmadığını kontrolde kullanılmaktadır. Şema dosyalarının buradan silinmesi, taşınması, isminin değiştirilmesi gibi durumlarda program dosyayı bulamadığı zaman ürettiği hata mesajıdır. Şema dosyaların yerine konması gerekmektedir. Dosyalar bulunamadığı takdirde uygulama tekrar kurulmalıdır. XML Şeması İstenen Şemaya Uymamaktadır. Gönderilmek istenilen XML dosyanın şekil olarak istenen formatta olup olmadığı, şema dosyaları yardımıyla kontrol edilmektedir. Kontrol sonucu uyumsuz çıkan XML dosyaları için üretilen hata mesajıdır. Alan adları, büyük, küçük harfe duyarlıdır. Örneğin SiraNo yerine Sirano yazılması hataya sebebiyet vermektedir. Kişi bilgilerinde boş olan alanların da mutlaka bulunması gerekmektedir. Otomasyon aşılabilmektedir. program içerisinde gerekli düzeltmeler ile sorun HASH Değeri Eksik Olduğu İçin İşleme Devam Edilemiyor. Uygulamada XML yapı için HASH değeri kontrolü yapılmıyor olsa da EGM nün GİYKİMLBİL projesindeki XML yapıya uygunluğunu sağlamak maksadıyla HASH bilgisinin bulunması aranmaktadır. <?hash 432AB78342DFE0E7FDF4C8BFC116B1A4?> Otomasyon aşılabilmektedir. program içerisinde gerekli düzeltmeler ile sorun Kişi Sıra Numarası Alanında Uyumsuzluk Bulunmaktadır. Şekil - 24 Her kişi kaydı için ayrı sıra numarası olmalıdır. Bazı otomasyon programlarında müşteri sıra numarasını, kişi sıra numarası olarak kullanıldığı gözlemlenmiştir. Bu gibi durumlarda eğer aynı müşteri birden fazla odada kalıyor ise birden fazla kayıt üretilmekte ama sıra numaraları aynı olmaktadır. Otomasyon aşılabilmektedir. program içerisinde gerekli düzeltmeler ile sorun
XML Dosya İçerisinde Tesis Kodu Bilgisi Eksik veya Tanımladığınızdan Farklı Olduğu İçin İşleme Devam Edilemiyor. Temel bilgi tanımlaması yapılırken tesis kodu bilgisi tanımlanmaktadır. XML dosya üretilirken de otomasyon programı tarafından tesis kodu XML dosyanın içine yazılmaktadır. Uygulama programı bu iki tesis kodu arasında uyuşmazlık tespit ettiği zaman hata üretmektedir. Öncelikli olarak tesis bilgi tanımlamasından tesis kodunun doğru tanımlanıp tanımlanmadığı kontrol edilmelidir. Tesis kodu burada doğru tanımlanmış ise o zaman otomasyon program içerisinde XML dosya üretilirken oluşturulan tesis kodunun düzelttirilmesi gerekmektedir. 'Excel' Dosya Okunurken Hata İle Karşılaşıldı. Excel yapıda dosya transferinde uygulama bulunduğu bilgisayardaki Microsoft Office dll dosyalarını kullanmaktadır. Bu yüzden uygulamanın çalıştığı bilgisayarda Microsoft Office paketi kurulu olmadığı takdirde hata verecektir. Paket kurulu olsa dahi kullanılmak istenen Microsoft.Office.Interop.Excel ile Office dll dosyalarının sistemden sislinmiş olma durumlarında da hata verilmektedir. En son olarak Excel veri yapısı bölümündeki dikkat edilmesi gereken hususlarda anlatılanlara dikkat edilmesi gerekmektedir. Göndermek İstediğiniz Kayıtlardan Bazıları İstenen Formata Uymamaktadır. Gönderilmek istenen bilgilerin müşteri bilgileri alan açıklamalarında belirtilen şartlara uygunluğu kontrol edilmekte ve hata ile karşılaşıldığında hata mesajı verilmektedir. Tesislerin hatalarını daha süratli gidermeleri için veriler baştan sona kadar teker teker kontrol edilmekte ve her hata ayrı bir satır oluşturacak şekilde text dosyası oluşturulmakta ve kullanıcıya gösterilmektedir. Oluşturulan text dosyada bilgisinde hata olan müşteriye daha süratli ulaşımı sağlamak için öncelikle müşterinin oluşturulan dosyada kaçını sırada olduğu, oda numarası, adı ve soyadı bilgileri verilmekte, sonra hatalı olan alanın adı ve barındırdığı değer, en son olarak ta hata ile ilgili açıklama yapılmaktadır. Hatalı olan alanlara ait hataların giderilmesinden sonra gönderime geçilmelidir. Dosya başlığında hata olduğunun bildirilmesi durumunda ise otomasyon program içerisinden düzeltilmelidir. Bölüm 1:
Bölüm 2: Bölüm 3: Şekil - 25
Web Servis Kullanımı Sırasında Hata Oluşmuştur. Gönderilmek istenen bilgilerin kontrollerinin bitirilmesini müteakip ana sisteme bu bilgilerin gönderme işlemine geçilir. Uygulama, ana sistemde bulunan web servis ile iletişim kuramadığı zamanlarda hata mesajı vermektedir. Duruma göre iletişim kuramamanın birden fazla sebebi bulunmaktadır. Öncelik sırasına göre dikkat edilmesi gereken hususlar aşağıya çıkarılmıştır. 1. İnternet bağlantısı kesilmiş olabilir. Dial-up bağlantı ile interneti kullanan tesislerin sık sık başına gelmektedir. 2. Bilgisayar üzerinde veya bilgisayarın bağlı olduğu yerel ağ üzerinde bulunan güvenlik yazılımları tarafından web servis kullanımı engelleniyor olabilir. Özellikle büyük ölçekli, ana merkez üzerinden internete çıkan tesislerde sık sık meydana gelmektedir. 3. İnternet bağlantısında sorun olmadığının ve güvenlik yazılımları tarafından engellenmediğinden emin olduktan sonra web servis adresinin kontrol edilmesi gerekmektedir. Şekil - 26 4. Son olarak web servis adresinin değişmiş veya ana sistemde arıza olma durumunun kontrolü için tesis yetkilisinin kendisinden sorumlu olan birlikte (İl J. veya İlçe J. K.lıkları) bulunan İl/İlçe J.K.lıkları Yetkili Kullanıcısına başvurması gerekmektedir.
Ana Sistem Tarafından Üretilen Hatalar: J.Gn.K.lığı Sistemi Hata Bildirmiştir: Hata Kodu: -1 Sistem tarafından verilen şifre, tesis tarafından değiştirilmeden lokal uygulama kullanımına izin verilmemektedir. Sistem tarafından verilen şifre kullanılarak veri gönderimi yapmak istendiğinde üretilen hata kodudur. Hata Kodu: -2 Üç sefer üst üste hatalı şifre ile giriş denemesi yapıldığı için kullanıma kapalı olduğunu bildiren hata kodudur. Tesis kodu ve şifre kullanım esasları doğrultusunda kullanıcısının kullanıma açılması gerekmektedir. Hata Kodu: 11 Hatalı şifre girilme durumudur. Büyük, küçük harf kullanımına dikkat edilmelidir. Hata Kodu: 12 Sistem belirli zaman aralıklarında veri kabul etmektedir. Bazen de sistem ana yetkilisi tarafından değişik maksatlarla geçici olarak sistem kapatılabilmektedir. Bu durumlarda öncelikli olarak kullanım zamanları içinde tekrar denemek, kullanım zaman dilimi içinde olduğu halde hata veriyorsa bir müddet bekledikten sonra tekrar denemek gerekmektedir. Sürenin uzaması halinde (İl J. veya İlçe J. K.lıkları) bulunan İl/İlçe J.K.lıkları Yetkili Kullanıcısına bildirilmesi gerekmektedir Hata Kodu: 21 XML yapıda hata olduğunda üretilen hata kodudur. Lokal uygulamadaki hatalarda detaylı olarak anlatılmıştır. Hata Kodu: 22 HASH değerindeki eksiklik veya şemaya uyumsuzluk olduğunda üretilen hata kodudur. Lokal uygulamadaki hatalarda detaylı olarak anlatılmıştır. Hata Kodu: 23 Gönderilmek istenen bilgilerin müşteri bilgileri alan açıklamalarında belirtilen şartlara uygunluğu kontrol edilmekte ve hata ile karşılaşıldığında hata mesajı verilmektedir. Yapılan açıklama lokal uygulamadaki detaylı olmayıp sadece satır numarası ve hatalı olan alan adından ibarettir. VERİ YAPILARI Müşteri Bilgileri Alan Açıklamaları
MÜŞTERİ BİLGİLERİ ZORUNLU EN FAZLA UZUNLUK ADI ALAN TİPİ XX T.C. KİMLİK NUMARASI TamSayı 11 X ADI Karakter 80 X SOYADI Karakter 80 XX BABA ADI Karakter 80 XX ANNE ADI Karakter 80 DOĞUM YERİ Karakter 80 X DOĞUM TARİHİ Tarih X ÜLKESİ Karakter 5 Referans Tablo İçerisindeki Değerler Olmalı X KİMLİK BELGESİ TÜRÜ Karakter 1 Referans Tablo İçerisindeki Değerler Olmalı X KİMLİK BELGESİ SERİ VE NUMARASI Karakter 20 NÜFUSA KAYITLI OLDUĞU İL Karakter 80 NÜFUSA KAYITLI OLDUĞU İLÇE Karakter 80 NÜFUSA KAYITLI OLDUĞU MAHALLE/KÖY Karakter 80 CİLT NO TamSayı 15 AİLE SIRA NO TamSayı 15 BİREY SIRA NO TamSayı 15 CİNSİYETİ Karakter 1 Referans Tablo İçerisindeki Değerler Olmalı MEDENİ HALİ Karakter 1 Referans Tablo İçerisindeki Değerler Olmalı İŞİ Karakter 80 X İKAMET ADRESİ Karakter 255 X GELİŞ TARİHİ Tarih "YYYY-MM-DD HH:MM:SS" şeklinde olmalı AYRILIŞ TARİHİ Tarih "YYYY-MM-DD HH:MM:SS" şeklinde olmalı VERİLEN ODA NUMARASI Karakter 15 ARACININ PLAKASI Karakter 20 X AÇIKLAMA Tam 11 Rakamdan Oluşmalıdır. "YYYY-MM-DD" şeklinde olmalı X Tesis tarafından tüm müşterileri için zorunlu bildirmesi gerekenler XX Tesis tarafından T.C. Vatandaşı müşterileri için extra bildirmesi gerekenler Şekil - 27