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.

İndirilen dosyayı açın ve kuruluma başlayın. Alt kısımda bulunan “Yükle” butonuna tıklayarak yüklemeyi başlatın.

Yükleme sonlandığında alt kısımda bulunan “kapat” butonuna tıklayabilirsiniz.

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.

3. Açılan ekranda sol tarafta bulunan “App registrations” (Uygulama Kayıtları) sekmesine tıklayın.

4. Yeni uygulama eklemek için yukarıda bulunan “New Registration” (Yeni Kayıt) butonuna tıklayın.

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.

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.

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.

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.

10. Value bölümünün altında bulunan değeri kaydediniz.

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.

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.

16. Bu aşamalardan sonra eğer Azure üzerinde yetki sahibi değilseniz, bu izinleri yetkili bir kişinin onaylaması gerekecektir.

Öncesi

Sonrası

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.

Daha sonra rar dosyasının içinde bulunan klasörü bulunduğunuz dizine çıkartın.

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.

Aşağıdaki komutları sırasıyla kullanın;

sc create TrcSpotPmsServiceOffice365 binPath="C:\TrcPmsServiceOffice365\publish\TrcSpotPmsServiceOffice365.exe" start=auto

sc start TrcSpotPmsServiceOffice365

sc stop TrcSpotPmsServiceOffice365

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.

TrcSpotPmsServiceOffice365 klasörünün içindeki “publish” klasörünün içerisinde bulunan “appsettings” dosyasını açın.

• 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.)

Alt tarafta bulunan kodu kullanarak servisi başlatabilirsiniz.

sc start TrcSpotPmsServiceOracle

Servisi durdurmak isterseniz aşağıda bulunan kodu kullanabilirsiniz.

sc stop TrcSpotPmsServiceOracle

Servisi silmek isterseniz durdurma kodunu çalıştırdıktan sonra aşağıdaki kodu kullanarak servisi silebilirsiniz.

sc delete TrcSpotPmsServiceOracle

Not

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.

Uyarı

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.