Microsoft Fabric App Geliştirme — Kurulum ve Uygulama

Geleneksel Power BI raporlarının sunduğu sınırları aşarak doğrudan veri tabanına yazma (write-back) yapabilen, özel animasyonlara ve kullanıcı arayüzlerine sahip tam teşekküllü web uygulamaları geliştirmek artık Microsoft Fabric ile mümkün. GitHub Pro hesabınız ve Visual Studio / VS Code ortamınız hazır olduğuna göre, bu rehberi takip ederek ilk Fabric uygulamanızı sıfırdan canlıya taşıyabilirsiniz.

Ön Hazırlık ve Gereksinimler

1. Microsoft Fabric Kapasitesi: Çalışma alanınızın (Workspace) en az F2 veya deneme (Trial / F64) lisansına sahip olması gerekir.
2. Tenant (Yönetici) Onayı: Fabric yöneticinizin, organizasyon ayarlarından Fabric Apps özelliğini etkinleştirmiş olması şarttır.
3. Araçlar: Bilgisayarınızda Node.js yüklü olmalı ve geliştirme için Visual Studio / VS Code ile GitHub Pro hesabınız aktif durumda bulunmalıdır.

Adım 1: Fabric Yönetici Portalından Özelliği Etkinleştirme

1. Microsoft Fabric portalına gidin ve sağ üstteki dişli çark simgesinden Admin Portal (Yönetici Portalı) seçeneğini açın.
2. Sol menüden Tenant Settings (Kiracı Ayarları) sekmesine gidin.
3. Arama çubuğuna App yazarak Fabric apps ayarını bulun.
4. Özelliği Enabled (Etkin) konuma getirin ve değişiklikleri kaydedin.

Adım 2: Fabric Çalışma Alanında Uygulama Öğe (Item) Oluşturma

1. Fabric içerisinde uygun bir çalışma alanına (Workspace) gidin.
2. Üst menüden + New item (Yeni Öğe) butonuna tıklayın.
3. Arama alanına app yazın ve önizleme aşamasında olan App (Preview) öğesini seçin.

4. Uygulamanıza bir isim vererek (Örn: SatisAnalizApp) oluşturma işlemini tamamlayın. Bu adım size uygulama için gerekli başlangıç yapılandırma yönergelerini verecektir.

Adım 3: Yerel Ortamda Proje Kurulumu (CLI & Raven)

Microsoft, web uygulamalarını hızlıca ayağa kaldırmanız için özel bir CLI aracı (Raven) sunar.

1. Öncelikle terminalde çalışacağınız klasörü oluşturun.

2. Bilgisayarınızda bir terminal (PowerShell veya VS Code terminali) açın.

3. Oluşturduğunu klasörü visual studioda açın.

4. VS Code içerisinden bir terminal (PowerShell veya Bash) açın ve şu komutu çalıştırarak Raven CLI şablonunu başlatın.

Karşınıza gelen şablon seçeneklerinden projenize uygun olanı seçin:

• Blank App: İçinde veri katmanı olmayan, tamamen sıfırdan tasarlayacağınız uygulamalar için.
• Data App: Fabric içerisindeki mevcut bir semantik modele veya veri tabanına bağlanacak uygulamalar için. (Mevcut bir analitik yapı kullanacaksanız bunu seçmeniz önerilir).

5. Kurulum tamamlandığında proje klasörünün içine girin ve geliştirme sunucusunu başlatın:

GitHub Pro ve Visual Studio ile Versiyon Kontrolü

Projeyi güven altına almak ve versiyonlamak için GitHub entegrasyonunu tamamla:

1. Öncelikle Git’i Yükleyin

1. git-scm.com adresine gidin.
2. Bilgisayarınız için uygun olan Git versiyonunu indirip kurun.
3. Kurulum sırasında her aşamada Next diyerek ilerleyebilirsiniz (varsayılan ayarlar yeterlidir).

1. Terminalde proje kök dizinindeyken Git deposunu başlat:

2. Dosyaları ekle ve ilk commit’ini yap:

GitHub’da Depo Oluşturup Projeyi Bağlamak

1. Tarayıcından GitHub hesabına giriş yap.
2. Sağ üst köşedeki + simgesine tıklayıp New repository (Yeni depo) seçeneğine tıkla.
3. Depona bir isim ver (Örneğin: SatisAnalizApp). Public veya Private seçip, başka hiçbir kutucuğa (README vb.) işaret koymadan en alttaki Create repository butonuna bas.

4. Açılan sayfada sana vereceği https://github.com/kullaniciadin/SatisAnalizApp.git şeklindeki URL’yi kopyala.

5. Yerel Projeyi GitHub’a Göndermek

Terminaline geri dön ve kopyaladığın URL’yi aşağıdaki komutta <GITHUB_REPOSITORY_URL> yazan yerin yerine yapıştırarak (açılı parantezler < > kalmayacak şekilde) Enter’a bas:

Artık projeni Visual Studio / VS Code üzerinden tam yetkiyle yönetebilir, GitHub Pro avantajlarından ve elindeki SQL MCP / veritabanı bağlantı araçlarından faydalanabilirsin.

Adım 8: Yapay Zeka ile Arayüz ve Veri Katmanını Örme

Uygulamanın arayüzünü tasarlamak ve arka plandaki Fabric veya SSAS veri kaynaklarına bağlamak için:

1. VS Code içinde Claude Code veya kullandığın AI asistan oturumunu aç.
2. Asistana projenin bir Fabric Data App olduğunu belirterek tasarlamak istediğin yapıyı anlat.

3. Yapay zeka gerekli API ve veri çekme katmanlarını senin için kodlayacaktır.

Adım 9: Test ve Fabric Ortamına Dağıtım (Deployment)

1. Projede yerleşik olarak gelen Playwright araçları sayesinde AI, yazdığı kodları arka planda test edebilir.

2. Tasarım ve veriler tam istediğin kıvama geldiğinde, projenizi Fabric çalışma alanınıza (Workspace) deploy ederek canlı ortamda kullanıcıların kullanımına açabilirsin.