OFFICE 365 ========== 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 Azure Portal Ayarları ~~~~~~~~~~~~~~~~~~~~~ Office 365 tarafından kullanıcı bilgilerine erişebilmek için Azure Portal üzerinden bazı ayarlar yapmamız gerekiyor. 1. Azure Portal üzerinde giriş yapmak için https://portal.azure.com/ adresine gidin. 2. Sol menüde veya ekranın ortasında bulunan "Microsoft Entra ID" butonuna tıklayın. .. image:: images/pms-office365/1.jpg :width: 700 3. Açılan ekranda sol tarafta bulunan “App registrations” (Uygulama Kayıtları) sekmesine tıklayın. .. image:: images/pms-office365/2.jpg :width: 200 4. Yeni uygulama eklemek için yukarıda bulunan “New Registration” (Yeni Kayıt) butonuna tıklayın. .. image:: images/pms-office365/3.jpg :width: 700 5. Sistemde görünecek uygulamanın adını "Name” (Ad) bölümüne girebilirsiniz. Uygulamayı kaydetmek için alt tarafta bulunan “Register” (Kaydol) butonuna tıklayın. .. image:: images/pms-office365/4.jpg :width: 700 6. Kayıt oluşturulduktan sonra açılan ekranın sol tarafındaki menüde bulunan “Overview” (Genel Bakış) sekmesine tıklayın. Üst tarafta bulunan “Application (client) ID” (Uygulama (istemci) kimliği) olarak görünen ve “Directory (tenant) ID” (Dizin (kiracı) kimliği) olarak görünen değerleri kopyalayın. .. image:: images/pms-office365/5.jpg :width: 700 7. Sol tarafta bulunan “Certificates & secrets” (Sertifikalar ve gizli diziler) sekmesine tıklayın. 8. Çıkan ekranda “Client secrets” (İstemci gizli dizileri) bölümüne gidin ve “New client secret” (Yeni istemci gizli dizisi) butonuna tıklayın. .. image:: images/pms-office365/6.jpg :width: 700 9. Anahtar eklerken istenen “Description” (Açıklama) alanını boş bırakabilirsiniz. Hemen altında bulunan “Expires” (Süre sonu) bölümü anahtarın son kullanılacağı tarihtir. “Add” (Ekle) butonuna tıklayarak anahtarı oluşturabilirsiniz. .. image:: images/pms-office365/7.jpg :width: 300 10. Value bölümünün altında bulunan değeri kaydediniz. .. image:: images/pms-office365/8.jpg :width: 700 11. Sol taraftaki menüde bulunan “API Permissions” (API izinleri) sekmesine tıklayın. 12. Görünen pencerede “Add a permission” (İzin ekleyin) butonuna tıklayın. .. image:: images/pms-office365/9.jpg :width: 700 13. Yeni açılan pencerede ise üst tarafta bulunan “Microsoft APIS” (Microsoft API’leri) butonuna tıklayın. 14. Çıkan ekranda en üstte bulunan “Microsof Graph” seçeneğine tıklayın. 15. "Delegated Permissions" ve "Application Permissions" bölümlerinde bulunan "User.Read.All" izinlerini seçin ve ardından alt tarafta bulunan "Add permissions" butonuna tıklayın. .. image:: images/pms-office365/10.jpg :width: 700 .. image:: images/pms-office365/11.jpg :width: 700 16. Bu aşamalardan sonra eğer Azure üzerinde yetki sahibi değilseniz, bu izinleri yetkili bir kişinin onaylaması gerekecektir. **Öncesi** .. image:: images/pms-office365/12.jpg :width: 700 **Sonrası** .. image:: images/pms-office365/13.jpg :width: 700 Entegrasyon Dosyasının İndirilmesi ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ XXX adresine giderek "TrcSpotPmsServiceOffice365" 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 TrcSpotPmsServiceOffice365 binPath="C:\TrcPmsServiceOffice365\publish\TrcSpotPmsServiceOffice365.exe" start=auto .. code:: sc start TrcSpotPmsServiceOffice365 .. code:: sc stop TrcSpotPmsServiceOffice365 .. image:: images/pms-oracle/11.jpg :width: 700 Bu komutlardan sonra TrcSpotPmsServiceOffice365 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 TrcSpotPmsServiceOffice365 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 "TrcSpotPmsServiceOffice365" 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.