Dynamics CRM Online Web API 1- Azure Active Directory

NOT: Dynamics Crm Online Trial versiyonunda anladığım kadarı ile  Azure Active Directory kullanamıyoruz.

Microsoft,  Dynamics CRM Online 2015 Update 1 ile beraber Organization Service (2011 SOAP endpoint) ve Organization Data Service (OData v2 REST endpoint) teknolojilerinin yerini alacak olan  Dynamics Crm Web API yi tanıttı . Crm Web Api’ nin Open Data Protocol (ODATA) standardını kullanıyor (ODATA standardı hakkında detaylı bilgiye buradaki adresten ulaşabilirsiniz) .

SOAP vs ODATA vs REST karşılaştırma için buradaki adrese bakabilirsiniz.

Dynamics Crm Web Api kullanabilmek için öncelikle Crm Online kullanıyor olmalısınız. On Premise versiyonlar için ne zaman Web Api desteği geleceği konusunda Microsoft tarafından henüz bir bilgi sunulmadı.  Eğer Crm Online kullanıyoarsanız öncelikle Web Api önizlemesini aktif etmemiz gerekiyor. Bu arada kullanacağımız Crm Web Api servisinin önizleme versiyonu olduğunu unutmamak gerek.

As a preview feature, this API isn’t supported. Microsoft Dynamics CRM Technical support won’t be able to help you with issues or questions about this Web API preview.

Dynamics CRM Web API’ yi aktif etmek için öncelikle Ayarlar>Yönetim

Dynamics Crm Web Api Preview Tutorial

Dynamics Crm Web Api Preview System Setting

>Sistem Ayarları

Dynamics Crm Web Api Tutorial

Dynamics Crm Web Api System Setting

>Önizlemeler sekmesine gelip lisans koşullarını kabul edip Dynamics Crm Web API önizlemesini etkinleştir diyoruz.

Dynamics Crm Web API Activation

Dynamics Crm Web API Activation

Bu kadar. Artık Dynamics CRM Web API’ yi kullanabiliriz. Eğer Crm Web API’ yi CRM dışarısındaki bir uygulamada kullanmak istiyorsak öncelikle uygulamamızı kayıt etmemiz gerekiyor. Bu sayede uygulamamıza has  ClientId ve redirectURI alabileceğiz(ClientId ve redirectURI konusuna yazının ilerleyen bölümlerinde deyineceğim). Eğer Web API’ yi CRM içerisinde kullanacak isek böyle bir kayıt işlemine gerek yok.

Web API kullanabilmemiz için neden uygulamalarımızı kayıt etmeliyiz?
Microsoft bu soruya Organizasyonların hangi uygulamaların hangi verilere  erişmesi gerektiğinin yönetilebilmesi için Web API kullanan uygulamalarımızı kayıt etmemiz gerektiğini söylüyor.  Her uygulama için ayrı kayıt işlemi yapmamız zorunlu olmasa da gerekli olduğunu söylüyor (tek kayıt işlemi ile birden fazla uygulamamızda CRM Web API  kullanabiliyoruz). Data detaylı bilgi için Dynamics CRM Web API register application sayfasına bakabilirsiniz.

Uygulamamızı kayıt edebilmemiz için(Crm Online kullandığımız için) Azure hesabımızın olması gerekiyor(trial hesap da oluyor).
NOT: Uygulama kayıt işlemi ücretsiz. Fakat Azure hesabı (trial yada normal) açarken güvenlik amaçlı kredi kartı bilgisi isteniyor.

Uygulamamızı kayıt edebilmemiz için Dynamics CRM Online (Office 365) hesabımızı Azure hesabımız ile ilişkilendirmemiz gerekiyor. Bu ilişkilendirme ile Dynamics CRM organizasyonumuzun kurulu olduğu sunucudaki Active Directory erişim elde ediyoruz. Şimdi bu işlemi adım adım yapalım:

  1. https://manage.windowsazure.com/ adresine giderek Azure hesabımıza giriş yapıyoruz. Eğer CRM Online (Office 365) demo hesabı alıp Azure portalına girmeye çalıştıysanız aşağıdaki gibi bir hata ekranı ile karşılaşacaksınız. Onun için Azure hesabınıza bağlanırken azure aboneliği bulunan mail adresinizi girdiğinizden emin olmalısınız.

    Dynamics CRM Online Azure No subscriptions found

    Dynamics CRM Online Azure No subscriptions found

  2. Azure hesabınıza giriş yaptıysanız sizi aşağıdaki gibi bir panel karşılayacak.

    Azure Panel

    Azure Panel

  3. Sol Alttaki New butonuna tıklayarak APP SERVICES > ACTIVE DIRECTORY > DIRECTORY > CUSTOM CREATE diyoruz.

    Dynamics CRM Online Manage Azure Active Directory

    Dynamics CRM Online Manage Azure Active Directory

  4. Karşımıza gelen formda DIRECTORY alanından Use existing directory diyoruz ve alttaki I am ready to be signed out kutucuğunu işaretleyip tamam diyoruz.
    CRM Online Connect Active Directory

    CRM Online Connect Active Directory

    CRM Online Manage Active Directory

    CRM Online Manage Active Directory

  5. Tamam dediğimizde azure portalından otomatik olarak çıkış yapılacak. Çıkış yapıldıktan sonra CRM Online (Office 365) hesabımızla azure portalına yeniden giriş yapıyoruz. (Eğer daha önceden Office 365 hesabınızla giriş yapmaya çalıştıysanız otomatik olarak CRM Online (Office 365) hesabını azure hesabınıza bağlayacak.  Sonra ise azure portalımızdan sol taraftaki ACTIVE DIRECTORY sekmesini seçiyoruz ve DIRECTORY alanındaki oluşmuş olan Varsayılan Dizin’ e tıklıyoruz.

    CRM Online Access Active Directory Via Azure

    CRM Online Access Active Directory Via Azure

  6. Daha sonra APPLICATION sekmesine gelip aşağıdan ADD butonuna tıklıyoruz.

    CRM Online Add Application Azure

    CRM Online Add Application Azure

  7. Karşımıza gelen formda Add an application my organization is developing seçeneği seçerek devam ediyoruz.

    Add Application To Azure

    Add Application To Azure

  8. Sonraki ekranda Uygulamamızın adını yazıyoruz ve Type alanında WEB APPLICATION AND/OR WEB API seçeneğini seçiyoruz.

    Azure tell us about your application

    Azure tell us about your application

  9. Şimdiki ekranda artık uygulamamızın özelliklerini tanımlıyacağız.

    Azure App Properties

    Azure App Properties

  10. Karşımıza gelen ekranda ACCESS WEB APIS IN OTHER APPLICATIONS sekmesi altında ClientId miz bulunuyor. Web api kullanmak için buna ihtiyacımız olacak.

    Azure ClientId

    Azure ClientId

  11. Daha sonra aşağıdaki ekrandan CONFIGURE sekmesine tıklıyoruz.

    Azure Application Configure

    Azure Application Configure

  12. CONFIGURE sekmesindeki ADD APPLICATION diyoruz.

    Azure Add Application

    Azure Add Application

  13. Permission to other application alanından Dynamics CRM Online’ı seçiyoruz.

    Azure Application Permission

    Azure Application Permission

  14. Uygulamamızı ekledikten sonra Delegate Permission’ ı Access CRM Online as organization users yapıyoruz.

    Azure Delegate Permission

    Azure Delegate Permission

Kaynak: https://msdn.microsoft.com/en-us/dynamics/crm/mt149065.aspx

Leave a Comment

E-posta hesabınız yayımlanmayacak.