ORACLE ====== Giriş ----- Bu belge, trcSpot ile sahip olduğunuz veri tabanı arasındaki PMS entegrasyonunu sağlamaktadır. Belge sonunda trcSpot ile veri tabanınız rahatlıkla haberleşebilecektir. Windows Servisinin Hazırlanması ------------------------------- .NET 6 SDK Kurulumu ~~~~~~~~~~~~~~~~~~~ İlk olarak uygulamanın çalışabilmesi için gerekli olan kurulumları yapmamız gerekiyor. https://dotnet.microsoft.com/en-us/download/dotnet/6.0 adresine giderek gerekli dosyayı indirin. .. image:: images/pms-oracle/1.jpg :width: 700 İndirilen dosyayı açın ve kuruluma başlayın. Alt kısımda bulunan "Yükle" butonuna tıklayarak yüklemeyi başlatın. .. image:: images/pms-oracle/2.jpg :width: 700 Yükleme sonlandığında alt kısımda bulunan "Kapat" butonuna tıklayabilirsiniz. .. image:: images/pms-oracle/3.jpg :width: 700 Entegrasyon Dosyasının İndirilmesi ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ XXX adresine giderek "TrcPmsServiceOracle" isimli rar dosyasını indiriniz. Bu dosyayı indirdikten sonra kurulumu yapmak istediğiniz diskin içine rar dosyasını atın. .. image:: images/pms-oracle/4.jpg :width: 700 Daha sonra rar dosyasının içinde bulunan klasörü bulunduğunuz dizine çıkartın. .. image:: images/pms-oracle/5.jpg :width: 700 Servis Ayarlarının Yapılması ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Windows servisinin ayarlarını yapabilmek için öncelikle servisi bir kere başlatmamız ve ardından durdurmamız gerekiyor. Bu işlem bize, servis ayarlarında kullanacağımız bir anahtar değerinin oluşmasını sağlayacaktır. Windows’un başlat tuşuna basarak veya alt kısımda bulunan arama butonuna tıklayarak açılan pencereye “CMD” veya “Komut İstemi” yazın. Sağ tarafta bulunan “Yönetici olarak çalıştır” butonuna tıklayın. Yönetici olarak çalıştırabilmeniz için açılan pencerede “Evet” butonuna tıklamalısınız. .. image:: images/pms-oracle/7.jpg :width: 700 Aşağıdaki komutları sırasıyla kullanın; .. code:: sc create TrcSpotPmsServiceOracle binPath="C:\TrcPmsServiceOracle\publish\TrcSpotPmsServiceOracle.exe" start=auto .. code:: sc start TrcSpotPmsServiceOracle .. code:: sc stop TrcSpotPmsServiceOracle .. image:: images/pms-oracle/11.jpg :width: 700 Bu komutlardan sonra TrcPmsServiceOracle klasörünün içerisine "Key" adında bir klasör oluşacaktır. Bu klasörün içerisinde bulunan "Key.txt" dosyasını açın ve sizin için oluşturulmuş anahtarın tamamını kopyalayın. .. image:: images/pms-oracle/12.jpg :width: 700 TrcPmsServiceOracle klasörünün içindeki "publish" klasörünün içerisinde bulunan "appsettings" dosyasını açın. .. image:: images/pms-oracle/6.jpg :width: 700 - CommunicationSettings bölümü, Windows servisinin bağlantı ayarlarının bulunduğu kısımdır. - **Port** bölümü, trcSpot hizmetinin bağlanacağı, sizin makinenizdeki bir TCP port numarasını içerecek bölümdür. Varsayılan olarak 13001 olarak ayarlanmıştır. Eğer cihazınızda 13001 portu dolu ise TCP olması şartıyla başka bir port numarasını kullanabilirsiniz. - DatabaseSettings bölümü, uygulamayı bağlamak istediğiniz veri tabanının ayarlarının yapılacağı kısımdır. - **Host** bölümü bağlanmak istediğiniz veri tabanının bulunduğu cihazın IP adresi olmalıdır. - **Port** bölümü veri tabanına bağlanmak için kullanılacak port numarasıdır. - **ServiceName** bölümü kullanılacak olan Oracle veri tabanının bulunduğu servisin ismidir. - **User_Id** bölümü veri tabanının kullanıcı adıdır. - Son olarak **Password** bölümü ise veri tabanı bağlantısı için kullanılacak şifredir. - TableSettings bölümü, veri tabanında bulunan bilgi almak istediğimiz tablolarla alakalı ayarların yapılacağı kısımdır. - **Key** bölümü "Key.txt" dosyasında bulunan değer olmalıdır. Kopyaladığınız anahtarı buraya yapıştırmalısınız. Anahtar değerinin tümünü kopyaladığınızdan emin olun. - **TableName** bölümü veri tabanında bulunan ve bilgi almak istenen tablonun adıdır. - **Name** bölümü kullanılacak olan tablodaki ad bilgisini içeren kolonun adını içermelidir. - **Surname** bilgisi kullanılacak olan tablodaki soyad bilgisini içeren kolonun adını içermelidir. - **Username** bölümü tabloda bulunan kayıtların aranacağı parametrelerden biridir. Örneğin kullanıcıyı TC kimlik numarası ile aramak istiyorsak, bu alanı TC kimlik numarasının bulunduğu kolonun ismi girilmelidir. - Son olarak **Password** bölümü tabloda bulunan kayıtların aranacağı parametrelerden bir diğeridir. Örneğin kullanıcıyı oda numarası ile aramak istiyorsak, bu alanı oda numarasının bulunduğu kolonun ismi girilmelidir. Servisi Başlatma ~~~~~~~~~~~~~~~~ PMS özelliğini bir Windows servisi olarak kullanmamız gerekmektedir. Komut istemcisini tekrar açın. (Windows'un başlat tuşuna basarak veya alt kısımda bulunan arama butonuna tıklayarak açılan pencereye "CMD" veya "Komut İstemi" yazın. Sağ tarafta bulunan "Yönetici olarak çalıştır" butonuna tıklayın. Yönetici olarak çalıştırabilmeniz için açılan pencerede "Evet" butonuna tıklamalısınız.) .. image:: images/pms-oracle/7.jpg :width: 700 Alt tarafta bulunan kodu kullanarak servisi başlatabilirsiniz. .. code:: sc start TrcSpotPmsServiceOracle .. image:: images/pms-oracle/8.jpg :width: 700 Servisi durdurmak isterseniz aşağıda bulunan kodu kullanabilirsiniz. .. code:: sc stop TrcSpotPmsServiceOracle .. image:: images/pms-oracle/9.jpg :width: 700 Servisi silmek isterseniz durdurma kodunu çalıştırdıktan sonra aşağıdaki kodu kullanarak servisi silebilirsiniz. .. code:: sc delete TrcSpotPmsServiceOracle .. image:: images/pms-oracle/10.jpg :width: 700 .. admonition:: Not :class: custom-note Servisin istenilen şekilde çalışmaması durumunda veya appsettings dosyasında değişiklik yapılması durumunda, servisi önce durdurup daha sonra yeniden başlatarak tekrar test edebilirsiniz. Bununla birlikte "appsettings" dosyasında yaptığınız değişiklikleri kaydettiğinizden emin olunuz. Log Dosyaları ------------- Servisi başlattıktan sonra diskinizin içerisine çıkarmış olduğunuz "TrcPmsServiceOracle" klasörünün içerisine "Logs" adında bir klasör oluşacaktır. Sistemden çıkan kayıtları burada görebilirsiniz. Servisi başlatmadan log dosyaları oluşmayacaktır. .. admonition:: Uyarı :class: danger Windows servisi çalışırken Log dosyalarını silmeniz durumunda sistem hata verecektir ve servis çalışmayı durduracaktır. Bu sorunu çözmek için servisi tekrar başlatmanız gerekmektedir. Sonuç ----- PMS entegrasyonu başarıyla tamamlandı. Sahip olduğunuz cihaza göre gereken kurulumları yaptıktan sonra trcSpot hizmetini kullanmaya başlayabilirsiniz.