Ally'ın API'sini Haricî Bir Raporlama Aracıyla Entegre Etme
Haricî raporlama araçları; gelişmiş veri görselleştirme olanakları, özelleştirme seçenekleri ve otomatik raporlama süreçleri de dâhil olmak üzere çok sayıda avantaj sunar. Kurumlar çeşitli tablo türlerini, grafikleri ve panoları kullanarak karmaşık veri kümelerini kolayca analiz edebilir. Görüntülenen veri ögelerini özelleştirerek, raporları kendi özel ihtiyaçlarına göre uyarlayabilirler. Otomatik raporlama sayesinde kullanıcılar değerli zamanlarından ve kaynaklarından tasarruf eder; rapor oluşturmaları kolaylaşır.
Kurumlar, Ally'ın API'sinin veri alma yeteneklerini popüler raporlama araçlarının gelişmiş görselleştirme ve analiz özellikleriyle birleştirerek, veriye dayalı karar almayı kolaylaştıracak bilgilere ulaşabilir.
Uç noktalarınızı uygun şekilde nasıl ayarlayacağınızı ve özelleştireceğinizi öğrenmek için Raporlama API'si Uç Noktaları'na ilişkin teknik belgeleri inceleyebilirsiniz.
Başlamadan önce
Ally'ın API'sini tercih ettiğiniz raporlama aracıyla entegre etmek için şunlara ihtiyacınız olacak:
- Power BI, Tableau, Microsoft Excel veya SAP Analytics gibi haricî bir raporlama aracı
- Ally'ın Kurumsal Raporuna erişim izni (yalnızca Yönetici)
- Yetkilendirme API'si belirteci (Kurumsal Rapor'da mevcuttur)
- Uç noktanın URL'si (bu yardım sayfasında mevcuttur)
- Ally İstemci Kimliğiniz (bu kimlik bilgisine sahip değilseniz destek ekibimize başvurun)
Her şeyi başarılı bir biçimde ayarlamak için bu yardım sayfası, Kurumsal Rapor ve haricî raporlama aracı arasında gidip gelmeniz gerekeceğini unutmayın.
Ally'ın API'si, haricî raporlama aracıyla nasıl entegre edilir?
- Kurumsal raporunuza erişin. Kurumsal rapora nasıl erişeceğinizi öğrenin.
- Genel Bakış sekmesinde, sağ taraftaki Dışa Ver düğmesini seçin.
- Haricî Aracı Bağla'yı seçin.
- Bir pencere açılarak, otomatik olarak oluşturulan belirteci görüntüler. Belirteci kopyala düğmesini seçin.
API belirteçlerinin süresi bir yıl sonra dolar. Yeni bir belirteç almak için, haricî raporlama aracınızı yeniden ayarlamak üzere bu kılavuzu izleyin.
- Tercih ettiğiniz haricî raporlama aracına gidin. Burada, örnek olarak Ally'ın API'sinin Power BI ile nasıl ayarlanacağını göstereceğiz.
Diğer haricî raporlama araçlarının arayüzleri farklı olsa da, hepsi aşağıda gösterildiği şekilde benzer adımları izler. Veri kaynağınızı ayarlama konusunda yardıma ihtiyacınız varsa lütfen raporlama aracınızın belgelerine bakın.
- Power BI Desktop uygulamasını açın
- Giriş Sayfası sekme seçeneklerinden Veri Al'ı seçin.
- Görüntülenen listeden Web'i seçin.
- Web'den penceresinde Gelişmiş'i seçin.
- HTTP isteği üstbilgisi parametre alanına Yetkilendirme yazın.
- Sağdaki metin kutusuna Bearer yazıp bir boşluk ekleyin ve Kurumsal Rapor'dan aldığınız belirteci yapıştırın.
- Aşağıdaki Uç Nokta URL'lerinden birini kopyalayın:
- https://[Bölge]/api/v2/clients/[Ally İstemci Kimliği]/reports/overall
- https://[Bölge]/api/v2/clients/[Ally İstemci Kimliği]/reports/issues
Ally'ın Rapor verileri, Genel Bakış ve Sorunlar şeklinde iki bölüme ayrılabilir. Her ikisi de kurumunuzdaki tüm kurslarınız için geçerlidir. Tercih ettiğiniz Uç Nokta URL'sini seçin.
- Uç Nokta URL'sini, Power BI'nın Web'den penceresindeki URL yolları alanına yapıştırın.
- [Ally İstemci Kimliği] yerine benzersiz Ally kimliğinizi girin.
Bu kimlik bilgisine sahip değilseniz lütfen Destek ekibimize başvurun. Bunun LMS kimliği değil, Ally istemci kimliği olduğunu unutmayın.
- [Bölge] yerine ise kurumunuza ait Ally ortamının barındırıldığı bölgeye göre şunlardan birini girin:
- ABD veri merkezi: prod.ally.ac
- Kanada veri merkezi: prod-ca-central-1.ally.ac
- Avrupa veri merkezi: prod-eu-central-1.ally.ac
- Singapur veri merkezi: prod-ap-southeast-1.ally.ac
- Avustralya veri merkezi: prod-ap-southeast-2.ally.ac
- Bu adımlar tamamlandıktan sonra, Power BI'nın Web'den penceresi şöyle görünmelidir:
- Girilen bilgilere göre sorguyu başlatmak için Tamam'ı seçin.
Kayıt sayısına bağlı olarak, veri kümesinin hazırlanması biraz vakit alabilir. Ally, verilerin hâlâ işlenip işlenmediğini kullanıcıya "durum" bilgilendirmesi yoluyla bildirir. Power BI'da durum bilgisini "Genişletilmiş meta veriler"i seçip metadata.status sütununu bularak görebilirsiniz:
Durum bilgisi "İşleniyor" şeklindeyse veriler hazır olana kadar beklemeniz gerekecektir. API'yi tekrar çağırmak ve verilerin hazır olup olmadığını görmek için üst şeritteki "Ön izlemeyi yenile" düğmesini seçin. Veri kümesi hazır olduğunda, tüm kayıtlar görüntülenir ve metadata.status sütununda durum, "Başarılı" şeklinde gösterilir.
- Son olarak, sol üst köşedeki Kapat ve Uygula ögesini seçin.
Veri yenileme süresi
Kaynak veriler, hangi uç noktası seçilirse seçilsin, 15 dakikada bir dâhilî olarak güncelleştirilir. Raporlarınıza ilişkin verileri almak için uç noktayı çağırırken bunu göz önünde bulundurun.
Yanıt sınırı
Uç nokta çağrısı başına yanıt sınırının 10.000 kayıt olduğunu unutmayın. Bazı kayıtlar ilk 10.000 kayıt içinde gösterilmiyorsa filtreleme veya sıralama seçeneklerini kullanmanız gerekir.