kopyas. kbs kullan.m k.lavuzu tesis - jandarma.gov.tr · adım: “kbs_java_lokal.zip” adlı...

37
T.C. İÇİŞLERİ BAKANLIĞI JANDARMA GENEL KOMUTANLIĞI ANKARA KİMLİK BİLDİRİM SİSTEMİ LOKAL UYGULAMA YAZILIMI (JAVA) KULLANIM KILAVUZU (KASIM 2006) BİLGİ SİSTEMLER DAİRE BAŞKANLIĞINCA HAZIRLANMIŞTIR. TASNİF DIŞI TASNİF DIŞI

Upload: hoangdien

Post on 13-Sep-2018

219 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

T.C. İÇİŞLERİ BAKANLIĞI

JANDARMA GENEL KOMUTANLIĞI ANKARA

KİMLİK BİLDİRİM SİSTEMİ LOKAL UYGULAMA YAZILIMI (JAVA)

KULLANIM KILAVUZU (KASIM 2006)

BİLGİ SİSTEMLER DAİRE BAŞKANLIĞINCA HAZIRLANMIŞTIR.

TASNİF DIŞI

TASNİF DIŞI

Page 2: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

2

İÇİNDEKİLER Kurulum______________________________________________________________________ 3

Sistem Gereksinimleri _________________________________________________________________ 3 Altyapı Gereksinimleri ________________________________________________________________ 3 J2SE Runtime Environment 5.0 Microsoft Windows (32-bit) Kurulumu: _________________________ 3 KBS Lokal Uygulama Yazılımı Kurulumu: ________________________________________________ 3

Temel Bilgilerin Tanımlanması ___________________________________________________ 6 Tesis Kodu: _________________________________________________________________________ 6 Web Servis Adresi Kontrol ve Değiştirme: _________________________________________________ 7

Dosya Transferi________________________________________________________________ 9 Hangi Tip Dosya: ____________________________________________________________________ 9

Müşteri Bilgilerini Veri Tabanında Tutan Tesisler_________________________________________ 9 Otomasyon Programında, Emniyet Genel Müdürlüğü’nün GİYKİMBİL XML Standardını Destekleyen, Modül Bulunan Tesisler _____________________________________________________________ 9 Veri Tabanı Olmayan Tesisler ________________________________________________________ 9

XML Yapıda Dosya Transferi: _________________________________________________________ 10 Manuel Hazırlanmış Dosya Transferi:____________________________________________________ 13

Kayıt Listesi Formu:_______________________________________________________________ 13 JGNK.XML Dosyasına Kayıt Esasları: ______________________________________________ 14 Kayıt Silme İşlemi: _____________________________________________________________ 15 Kayıt ve Gönder: _______________________________________________________________ 16

Kayıt Giriş ve Güncelleme Formu:____________________________________________________ 17 T.C. Kimlik Numarası Sorgulama________________________________________________ 21 Yeni Versiyon Kontrolü ________________________________________________________ 22 Dosya Transferinde Alınan Hatalar ______________________________________________ 23

Lokal Uygulama Tarafından Üretilen Hatalar: _____________________________________________ 23 XML Yapısında Hata Bulunmaktadır. _________________________________________________ 23 XML Şeması İstenen Şemaya Uymamaktadır. ___________________________________________ 23 HASH Değeri Eksik Olduğu İçin İşleme Devam Edilemiyor. _______________________________ 23 XML Dosya İçerisinde Tesis Kodu Bilgisi Eksik veya Tanımladığınızdan Farklı Olduğu İçin İşleme Devam Edilemiyor.________________________________________________________________ 24 Göndermek İstediğiniz Kayıtlardan Bazıları İstenen Formata Uymamaktadır. __________________ 24 Web Servis Kullanımı Sırasında Hata Oluşmuştur. _______________________________________ 25

Ana Sistem Tarafından Üretilen Hatalar: _________________________________________________ 26 Hata Kodu: -1 ____________________________________________________________________ 26 Hata Kodu: -2 ____________________________________________________________________ 26 Hata Kodu: 11____________________________________________________________________ 26 Hata Kodu: 12____________________________________________________________________ 26 Hata Kodu: 21____________________________________________________________________ 26 Hata Kodu: 22____________________________________________________________________ 26 Hata Kodu: 23____________________________________________________________________ 26

VERİ YAPILARI __________________________________________________________ 27 Müşteri Bilgileri Alan Açıklamaları ______________________________________________ 28 Ülke Kodları _________________________________________________________________ 30 Kimlik Belgesi Kodları _________________________________________________________ 32 Cinsiyet Kodları ______________________________________________________________ 32 Medeni Hal Kodları ___________________________________________________________ 32 XML Yapı ___________________________________________________________________ 33

XML Hakkında Genel Bilgi: ___________________________________________________________ 34 Dikkat Edilmesi Gereken Hususlar: _____________________________________________________ 35

EXCEL Yapı _________________________________________________________________ 36 Dikkat Edilmesi Gereken Hususlar: _____________________________________________________ 37

Page 3: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

3

Kurulum

Sistem Gereksinimleri • İşletim Sistemleri: Windows İşletim Sistemleri (98, 2000, XP v.b.), Solaris,

Linux.

• Windows işletim sistemleri Microsoft Internet Explorer 5.01 veya daha yeni bir sürümünü de çalıştırıyor olmanız gerekir. Linux işletim sistemleri için Netscape ya da benzer bir internet tarayıcısı (Mozilla 1.4+) kullanıyor olmanız yeterlidir.

Altyapı Gereksinimleri • Java 2 Platform Standard Edition (J2SE) Runtime Environment 5.0 veya daha

yeni bir sürümü

Sistem gereksinimleri tesis tarafından karşılanacaktır.

Altyapı yazılımı Sun firması tarafından ücretsiz olarak verildiğinden herhangi bir ücret ödenmeden kullanılabilmektedir.

Gerekli olan altyapı ve uygulama yazılımları www.jandarma.gov.tr/kbs adresinden indirilebilmektedir. Ayrıca J2SE Runtime Environment 5.0 için kendi işletim sisteminize uygun olan altyapı yazılımını http://java.sun.com/j2se/1.5.0/system-configurations.html adresinden de indirebilirsiniz. Örnek olarak aşağıda Windows İşletim Sistemi için kurulumu anlatılmıştır.

J2SE Runtime Environment 5.0 Microsoft Windows (32-bit) Kurulumu:

J2SE Runtime Environment 5.0 hakkında detaylı bilgi ve son sürümleri için Sun firmasının aşağıdaki internet adresi ziyaret edilebilir. http://java.sun.com/j2se/1.5.0/jre/install-windows.html

KBS Lokal Uygulama Yazılımı Kurulumu: 1. Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği

kurulum dosyası olarak belirtilmiş olmasıdır, ismi farklı olabilir). Bu dosya seçildikten ve içindeki dosyalar açıldıktan sonra 2. adıma geçilir.

2. Adım: Açılmış olan klasörün içine tıklanarak girilir.

3. Adım: Dosyalar arasındaki “kbs_lokal” bat uzantılı dosyanın üzerine farenin (mouse) sol tuşu ile iki kere üst üste basılır. (Linux işletim sistemi için aynı isimli ama sh uzantılı dosyaya iki kere üst üste basılır.)

4. Adım: Program command prompt ile birlikte açılır ve kullanıma hazır olur.

Page 4: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

4

Page 5: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

5

Şekil - 1

Page 6: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

6

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 - 2

Page 7: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

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 - 3

Page 8: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

8

Testin olumsuz çıkma durumunda bir mesaj gelmektedir. Böyle bir durumda form üzerinde bulunan “Değiştirmek İstiyorum” işaret kutusu işaretlenerek “Değiştir” tuşu pasif durumdan aktif duruma geçip yeni sunucu adresi girilmesine ve test edilmesine olanak sağlamaktadır.

Şekil - 4

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.

Page 9: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

9

Dosya Transferi Hangi Tip Dosya:

Müşteri bilgileri tesislerden belirli yapılara göre hazırlanmış dosyalar halinde istenmektedir.

• XML 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 yapıda olmak üzere dosya yapısı belirlenmiştir.

Bu şekilde veri tabanına sahip tesislerin sahip oldukları otomasyon programı teknik destek elemanları ile irtibata geçerek XML yapısına ö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ından veri aktarması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.

Page 10: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

10

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 “İşlemler” ve onun altındaki “Dosya Transferi” altındaki “XML Dosya Gönder” tuşu tıklanır.

2. Adım: Gelen formda, önceden hazırlanmış olan XML dosyayı seçmek için “Dosya Seç” tuşu tıklanarak.

3. Adım: Açılan dosya seç ekranı yardımıyla hazırlanan XML dosya seçilerek “Dosya Seç” tuşu tıklanır. Bu ekran XML uzantısı haricindeki dosyaları seçmeyi engellemektedir.

4. Adım: Tesis şifresi girildikten sonra “Gönder” tuşu tıklanarak dosya gönderilir.

5. Adım: Ana sistem tarafından dosya kabul edildiği takdirde “Dosya onaylandı ve gönderim işlemi başarıyla gerçekleştirildi” mesajı belirtilir.

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.

Page 11: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

11

1

2

Page 12: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

12

Şekil - 5

3

4

5

Page 13: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

13

Manuel Hazırlanmış Dosya Transferi: Kayıt Listesi Formu:

Ana menüdeki “İşlemler” ve onun altındaki “Dosya Transferi” altındaki “Manuel Dosya Hazırla” tuşu tıklanarak kayıt listesi formu açılır.

Şekil - 6

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ındaki “xml” klasörünü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ı kontrol etmektedir. Kontrolde dışarıdan müdahale edildiğini tespit ettiğinde ya da hatalı veri olduğu tespit edildiğinde işleme düzgün devam edebilmek için onay ekranıyla sorunu çözmek için onay isteğinde bulunur. Onay verildiğinde dosyanın içindeki veriler sıfırlanır ve işleme düzgün bir şekilde devam edilir.

Şekil - 7

Page 14: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

14

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 - 8

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.

Page 15: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

15

İ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 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 - 9

Page 16: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

16

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 “Kaydetme ve Gönderim işlemleri başarıyla gerçekleştirildi.” mesajıyla durum belirtilir.

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 - 10

Page 17: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

17

Kayıt Giriş ve Güncelleme Formu:

Kayıt listesi formunda; giriş için “Yeni”, 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.

Page 18: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

18

Şekil - 11

Page 19: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

19

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 üzerinde bulunan tarih tuşlarına basarak ekrana gelen tarih formu aracılığıyla veya elle tarih bilgileri girilebilmektedir.

Şekil - 12

Page 20: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

20

İstenen yapıya uygun müşteri bilgisinin giriş veya güncellemesi yapıldıktan sonra “Tamam” 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 hatalı olan alanı uyarır.

Şekil - 13

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 “İptal” tuşunu tıklamak yeterli olacaktır.

Page 21: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

21

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 T.C. Kimlik Numaralarını sorgulayabileceği bir hizmet sunmaktadır.

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 - 14

Page 22: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

22

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 - 15

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.

Page 23: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

23

Dosya Transferinde Alınan Hatalar

Lokal Uygulama Tarafından Üretilen Hatalar:

XML Yapısında Hata Bulunmaktadır.

Şekil - 16

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.

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 program içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir.

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 program içerisinde gerekli düzeltmeler ile sorun aşılabilmektedir.

Page 24: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

24

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.

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.

Hata mesajı bilgisinde hatalı olan müşteriye daha süratli ulaşımı sağlamak için öncelikle müşterinin oluşturulan XML dosyada kaçıncı 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.

Şekil - 17

Page 25: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

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 - 18

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.

Page 26: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

26

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.

Page 27: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

27

VERİ YAPILARI VERİ YAPILARI

Page 28: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

28

Müşteri Bilgileri Alan Açıklamaları

Şekil - 19

ZORUNLU ADI ALAN TİPİ EN FAZLAUZUNLUK AÇIKLAMA

XX T.C. KİMLİK NUMARASI TamSayı 11 Tam 11 Rakamdan Oluşmalıdır.

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 "YYYY-MM-DD" şeklinde olmalı

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

X 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

XX Tesis tarafından T.C. Vatandaşı müşterileri için extra bildirmesi gerekenler

MÜŞTERİ BİLGİLERİ

Tesis tarafından tüm müşterileri için zorunlu bildirmesi gerekenler

Page 29: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

29

Açıklamalar:

1. Yaş, cinsiyet durumuna bakılmaksızın tesiste konaklayan her müşterinin bilgisinin gönderilmesi gerekmektedir.

2. T.C. Kimlik Numarası alanına mutlaka 11 rakamdan oluşan değer girilmelidir. Yabancı ülke vatandaşları için bu alan boş bırakılmalıdır. Bazı otomasyon programlarının yabancı vatandaşlar için bu alana müşteri numarası veya ‘*’,’.’,’ ‘ gibi karakterler girdiği görülmüştür. Bu gibi durumlarda uygulama hata mesajı vermektedir.

3. ADI,SOYADI,BABA ADI, ANNE ADI alanları kimlik belgesinde yazıldığı şekilde aynen girilmelidir. İki adı olanlar için kısaltma kullanılmamalıdır. “Mustafa Kemal” şeklinde aynen yazılmalıdır. Adının başında unvan bilgileri konulmamalıdır. Bazı tesislerin “Mr. Ahmet” şeklinde yazdıkları görülmüştür. Bu şekildeki hatalı girişler sebebiyle kimlik doğrulaması hatalı çıkmaktadır.

4. Alanlara mutlaka alan tipine uygun karakterler yazılmalıdır.

5. Sayısal olan alanlar için boş bırakılması gerekiyorsa hiçbir karakter girilmemelidir. Bazı otomasyon programlarının sayısal alanların boş bırakıldığı zamanlar boşluk karakteri atadığı. Bu gibi durumlarda uygulama hata mesajı vermektedir.

6. Kimlik belgesi seri ve numarası için “SERİ+BOŞLUK+NO” şeklinde giriş yapılmalıdır. Örnek “CS 764999”

7. Araç plakası plakanın tamamı arada boşluk bırakılmadan girilmelidir. “06ZXC99”

8. Doğum tarihi alanı için örnek “1972-01-29” şeklinde olmalıdır.

9. Geliş veya Ayrılış Tarihi tarih saat grubunu içermelidir. Örnek “2007-01-09 14:00:00”

10. Ülkesi alanına mutlaka referans tablo içinde geçen değerlerden biri verilmelidir. Bazı tesisler örnek olarak T.C. vatandaşlar için “TC” yerine “T.C.” veya “TR” gibi değerler girdiği için hata mesajı almaktadırlar.

11. Referans tablo değerleri kullanan alanlara mutlaka tablo değerlerinden biri girilmelidir. Örneğin erkek için cinsiyeti hanesine “E” yerine “M” veya başka tabirler yazılmamalıdır.

12. İkametgâh adresi beyana dayalı bilgi olup müşteri nasıl beyan ederse aynı şekilde girilmelidir.

Page 30: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

30

Ülke Kodları Ülke bilgileri tablosu, pasaportlarda kullanılan ülkelerin İngilizce adlarına göre

sıralı verilmiştir.

Ülke Kod Ülke KodTÜRKİYE TC DJIBOUTI DJI

KUZEY KIBRIS TURK CUMHURİYETİ KKTC DOMINICA DMA

AFGHANISTAN AFG DOMINICAN REPUBLIC DOM

ALBANIA ALB ECUADOR ECU

ALGERIA DZA EGYPT EGY

AMERICAN SAMOA ASM EL SALVADOR SLV

ANDORRA AND EQUATORIAL GUINEA GNQ

ANGOLA AGO ERITREA ERI

ANGUILLA AIA ESTONIA EST

ANTARCTICA ATA ETHIOPIA ETH

ANTIGUA AND BARBUDA ATG FAEROE ISLANDS FRO

ARGENTINA ARG FALKLAND ISLANDS (MALVINAS) FLK

ARMENIA ARM FIJI FJI

ARUBA ABW FINLAND FIN

AUSTRALIA AUS FRANCE FRA

AUSTRIA AUT FRENCH GUIANA GUF

AZERBAIJAN AZE FRENCH POLYNESIA PYF

BAHAMAS BHS FRENCH SOUTHERN TERRITORIES ATF

BAHRAIN BHR GABON GAB

BANGLADESH BGD GAMBIA GMB

BARBADOS BRB GEORGIA GEO

BELARUS BLR GERMANY (Deutschland) DEU

BELGIUM BEL GHANA GHA

BELIZE BLZ GIBRALTAR GIB

BENIN BEN GREECE GRC

BERMUDA BMU GREENLAND GRL

BHUTAN BTN GRENADA GRD

BOLIVIA BOL GUADELOUPE GLP

BOSNIA AND HERZEGOVINA BIH GUAM GUM

BOTSWANA BWA GUATEMALA GTM

BOUVET ISLAND BVT GUERNSEY GBG

BRAZIL BRA GUINEA GIN

BRITISH INDIAN OCEAN TERRITORY IOT GUINEA-BISSAU GNB

BRUNEI DARUSSALAM BRN GUYANA GUY

BULGARIA BGR HAITI HTI

BURKINA FASO BFA HEARD ISLAND AND MCDONALD ISLANDS HMD

BURUNDI BDI HONDURAS HND

CAMBODIA KHM HONG KONG (Special Administrative Region of China) HKG

CAMEROON CMR HUNGARY HUN

CANADA CAN ICELAND ISL

CAPE VERDE CPV INDIA IND

CAYMAN ISLANDS CYM INDONESIA IDN

CENTRAL AFRICAN REPUBLIC CAF IRAN (Islamic Republic of Iran) IRN

CHAD (Tchad) TCD IRAQ IRQ

CHILE CHL IRELAND IRL

CHINA CHN ISRAEL ISR

CHRISTMAS ISLAND CXR ITALY ITA

COCOS (KEELING) ISLANDS CCK JAMAICA JAM

COLOMBIA COL JAPAN JPN

COMOROS COM JERSEY GBJ

CONGO - REPUBLIC OF COG JORDAN (Hashemite Kingdom of Jordan) JORCONGO-THE DEMOCRATIC REPUBLIC OF THE (formerly Zaire) COD KAZAKHSTAN KAZ

COOK ISLANDS COK KENYA KEN

COSTA RICA CRI KIRIBATI KIR

CÔTE DIVOIRE (Ivory Coast) CIV KOREA (Democratic Peoples Republic of [North] Korea) PRK

CROATIA (Hrvatska) HRV KOREA (Republic of South Korea) KOR

CUBA CUB KUWAIT KWT

CYPRUS CYP KYRGYZSTAN KGZ

CZECH REPUBLIC CZE LAO PEOPLE'S DEMOCRATIC REPUBLIC LAO

DENMARK DNK LATVIA LVA

Page 31: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

31

Şekil - 20

Ülke Kod Ülke KodLEBANON LBN SAINT HELENA SHN

LESOTHO LSO SAINT KITTS AND NEVIS KNA

LIBERIA LBR SAINT LUCIA LCA

LIBYA (Libyan Arab Jamahirya) LBY SAINT PIERRE AND MIQUELON SPM

LIECHTENSTEIN (Fürstentum Liechtenstein) LIE SAINT VINCENT AND THE GRENADINES VCT

LITHUANIA LTU SAMOA (formerly Western Samoa) WSM

LUXEMBOURG LUX SAN MARINO (Republic of) SMR

MACAO (Special Administrative Region of China) MAC SAO TOME AND PRINCIPE STP

MACEDONIA (Former Yugoslav Republic of Macedonia) MKD SAUDI ARABIA (Kingdom of Saudi Arabia) SAU

MADAGASCAR MDG SENEGAL SEN

MALAWI MWI SERBIA AND MONTENEGRO SCG

MALAYSIA MYS SEYCHELLES SYC

MALDIVES MDV SIERRA LEONE SLE

MALI MLI SINGAPORE SGP

MALTA MLT SLOVAKIA (Slovak Republic) SVK

MARSHALL ISLANDS MHL SLOVENIA SVN

MARTINIQUE MTQ SOLOMON ISLANDS SLB

MAURITANIA MRT SOMALIA SOM

MAURITIUS MUS SOUTH AFRICA (Zuid Afrika) ZAF

MAYOTTE MYT SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS SGS

MEXICO MEX SPAIN (España) ESP

MICRONESIA FSM SRI LANKA LKA

MOLDOVA MDA SUDAN SDN

MONACO MCO SURINAME SUR

MONGOLIA MNG SVALBARD AND JAN MAYEN SJM

MONTSERRAT MSR SWAZILAND SWZ

MOROCCO MAR SWEDEN SWE

MOZAMBIQUE (Moçambique) MOZ SWITZERLAND (Confederation of Helvetia) CHE

MYANMAR (formerly Burma) MMR SYRIAN ARAB REPUBLIC SYR

NAMIBIA NAM TAIWAN (Chinese Taipei for IOC) TWN

NAURU NRU TAJIKISTAN TJK

NEPAL NPL TANZANIA TZA

NETHERLANDS NLD THAILAND THA

NETHERLANDS ANTILLES ANT TIMOR-LESTE (formerly East Timor) TLS

NEW CALEDONIA NCL TOGO TGO

NEW ZEALAND NZL TOKELAU TKL

NICARAGUA NIC TONGA TON

NIGER NER TRINIDAD AND TOBAGO TTO

NIGERIA NGA TUNISIA TUN

NIUE NIU TURKMENISTAN TKM

NORFOLK ISLAND NFK TURKS AND CAICOS ISLANDS TCA

NORTHERN MARIANA ISLANDS MNP TUVALU TUV

NORWAY NOR UGANDA UGA

OMAN OMN UKRAINE UKR

PAKISTAN PAK UNITED ARAB EMIRATES ARE

PALAU PLW UNITED KINGDOM (Great Britain) GBR

PALESTINIAN TERRITORIES PSE UNITED STATES USA

PANAMA PAN UNITED STATES MINOR OUTLYING ISLANDS UMI

PAPUA NEW GUINEA PNG URUGUAY URY

PARAGUAY PRY UZBEKISTAN UZB

PERU PER VANUATU VUT

PHILIPPINES PHL VATICAN CITY (Holy See) VAT

PITCAIRN PCN VENEZUELA VEN

POLAND POL VIET NAM VNM

PORTUGAL PRT VIRGIN ISLANDS( BRITISH) VGB

PUERTO RICO PRI VIRGIN ISLANDS( U.S.) VIR

QATAR QAT WALLIS AND FUTUNA WLF

RÉUNION REU WESTERN SAHARA (formerly Spanish Sahara) ESH

ROMANIA ROU YEMEN YEM

RUSSIAN FEDERATION RUS ZAMBIA ZMB

RWANDA RWA ZIMBABWE ZIM

Page 32: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

32

Kimlik Belgesi Kodları

Şekil - 21

Cinsiyet Kodları

Şekil - 22

Medeni Hal Kodları

Şekil - 23

Medeni Hali KodBekar BEvli E

Cinsiyet KodErkek EKadın K

Kimlik Belgesi Türleri KodPasaport PAvrupa Birliği Kimliği ANüfus Hüviyet Cüzdanı NEhliyet EDiğer D

Page 33: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

33

XML Yapı

<?xml version="1.0" encoding="iso-8859-9" ?> <?hash 432AB78342DFE0E7FDF4C8BFC116B1A4?>

<Konaklama TesisKodu="54336" Tarih="2006-06-12 23:50:26" GonderenProgram="JGNK_XML" GonderenProgramVersiyon="1.0.0">

<Kisi

SiraNo="1" TCKimlikNo="12345678901" Adi="ADI" Soyadi="SOYADI" BabaAdi="BABA ADI" AnaAdi="ANNE ADI" DogumYeri="" DogumTarihi="1988-06-26" Uyrugu="TC" KimlikBelgesiTuru="N" KimlikSeriNo="D 2345" NufusaKayitliOlduguIl="" NufusaKayitliOlduguIlce="" NufusaKayitliOlduguMahalle="" NufusCilt="" NufusAileSira="" NufusSiraNo="" Cinsiyet="E" MedeniHali="B" Isi="" IkametAdresi="ANKARA" GelisTarihi="2006-10-04 14:41:58" AyrilisTarihi="" VerilenOdaNo="" AracPlakaNo="" />

</Konaklama>

Page 34: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

34

XML Hakkında Genel Bilgi:

Extensible Markup Language(XML), uyumsuz programlar, bilgisayar ağları, veri yapıları ve işletim sistemleri konularında endişelenmeye gerek kalmadan yaygın olarak kullanılan bir veri tanımlama dili standardıdır.

XML, dosya yapısı ve içeriğini tanımlamak için standart etiketler kullanır. Tüm dosyalarda aynı XML ekleri kullanılarak, metin esaslı bilgilerde dizin, arama, birleştirme ve yeniden kullanma işlemleri etkin biçimde gerçekleştirilebilir. XML, metin esaslı olduğu ve bilgisayar dilleriyle kısıtlı olmadığı için, normalde uyumsuz olan sistemler arasında da veri alışverişini mümkün kılmaktadır.

XML dokümanları ilişkisel veritabanlarından farklı olarak hiyerarşik bir yapısı vardır. Bu yapı kendine has kuralları da beraberinde getirmektedir.

• <?xml version="1.0" encoding="ISO-8859-9" ?> bu satır başlangıç etiketidir ve kapanış etiketi yoktur. Üç adet özniteliği vardır ve “version” özniteliği verilmek zorundadır. “version” özniteliği XML dosyasının versiyonunu belirtir ve bu bilgi dokümanı parse(okuma) edecek uygulama için gereklidir. “encoding” özniteliği doküman içerisindeki dil seçeneğini belirtmek için kullanılır.

• <Konaklama> </ Konaklama > etiketi ise kök(root) etikettir ve XML dokümanın da en az bir tane bulunmak zorundadır. Bu etiket diğer bütün etiketleri içerisine almak zorundadır.

• <Kisi ….. /> etiketi çocuk(child) etiket olarak isimlendirilir ve element olarak ta bilinir. Buradaki SiraNo, Adi,Soyadi gibi başılklarda belirtilenler birer özniteliktir ve öznitelik değerleri “” arasında verilmek zorundadır.

• XML dokümanında her alan bir etiket çifti arasında belirtilir ve açılan her etiket kapatılmak zorundadır.

• Etiketler büyük küçük harf (case sensitivity) duyarlıdır.

• Bir element içerisinde başka bir element açılmış ise o element kapanmadan diğeri kapatılamaz, yani hiyerarşi bozulamaz.

• XML beyaz karakter(white space) göz önüne alınır.

• <, >, ", ', & bu karakterler XML içerisinde kullanılamaz.

• Doküman içerisinde en az bir element olmalıdır.

Page 35: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

35

Dikkat Edilmesi Gereken Hususlar: 1. Sistemin bu dokümanı okuyabilmesi için bir takım NODE ve ATTRIBUTE

tanımları kullanılmaktadır. NODE ve ATTRIBUTE dışındaki değerler dikkate alınmamaktadır.

2. XML dokümanının dil ayarı iso-8859-9 olacak şekilde oluşturulmalıdır. Bu şekilde Türkçe karakterler sorunsuz algılanabilmektedir.

3. İlk satır <?xml version=”1.0” encoding=”iso-8859-9”?> şeklinde olmalıdır.

4. Doküman Konaklama ve Kişi bilgilerinden oluşur.

• Konaklama

• TesisKodu: Tesise verilen kod. Tam sayı olmalıdır.

• Tarih: Tarih ve Saat bilgilerini içermelidir. Formatı YYYY-MM-DD hh:mm:ss şeklinde olmalıdır.

• GonderenProgram: Bu veriyi hazırlayan programın adı yazılacaktır. En fazla 80 karakter olabilir.

• GonderenProgramVersiyon: Gönderen programın versiyonu buraya yazılacaktır. En fazla 80 karakter olabilir.

• Kişi

Müşteri bilgileri burada yer alır. Her müşteri için tekrarlanacaktır. Müşteri Bilgileri Alan Açıklamalarında belirtilen sıra ve kurallara uygun olarak oluşturmalıdır.

5. 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?> Konaklama verisi içindeki <Konaklama kodu ile başlayıp </Konaklama> ile

biten kısmının MD-5 algoritması ile HASH değeri elde edilip XML dosyasında prolog olarak eklenmelidir.

6. XML standardı olarak <?xml versiyon=”1.0” encoding=”iso-8859-9” ?> kodu dokümanın en başında olmak zorundadır. Yine standart olması açısından <?hash ?> bilgisinin de başta olması beklenmektedir.

Page 36: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

EXCEL Yapı Bölüm 1:

Bölüm 2:

Şekil - 24

Page 37: Kopyas. KBS Kullan.m K.lavuzu Tesis - jandarma.gov.tr · Adım: “kbs_java_lokal.zip” adlı dosya seçilmelidir (dosyanın özelliği kurulum dosyası olarak belirtilmiş olmasıdır,

Dikkat Edilmesi Gereken Hususlar: 1. Müşteri bilgilerinin bulunduğu sayfa, Excel dosyanın ilk sayfası olmalıdır.

Uygulama diğer sayfalardaki bilgileri dikkate almaz.

2. Sayfanın birinci satır alan açıklamaları içindir.

3. Kolon sıraları örnekte olduğu gibidir. Kolon sıralamasına riayet edilmesi gerekmektedir.

4. Bilgisi girilecek her müşteri için bir satır olacak şekilde satır atlamadan giriş yapılmalıdır.

5. Uygulama ilk boş gördüğü satırda okuma işlemini sonlandırdığı için satır atlandığı takdirde eksik bilgi gönderilmiş olunur.

6. En son müşteri bilgisi satırından sonraki satıra hiçbir şey yazılmamalıdır. Bu satırdaki hücrelere konulacak en ufak boşluk karakteri, “.” vb değerler, uygulamanın o satırın dolu olduğunu kabul etmesine ve dolayısıyla hataya sebebiyet verecektir.

7. Sıra numarası 1’den başlayarak artan değer olmalıdır.

8. Bilgilerin alan açıklamalarında belirtilen formatta girilmesi gerekmektedir.