GitHub Copilot CLI ve Claude Code için Power Pages eklentisini kullanmaya başlama

GitHub Copilot CLI ve Claude Code için Power Pages eklentisi, modern tek sayfalı uygulama (SPA) sitelerini Power Pages'da oluşturmak, dağıtmak ve yönetmek için yapay zeka destekli bir iş akışı sağlar. Projeleri el ile yapılandırmak, ortak API kodu yazmak ve izinleri yapılandırmak yerine, doğal dilde ne istediğinizi açıklayın ve eklenti uygulamayı işler.

Eklenti, yeni bir sitenin iskelesini oluşturmaktan dağıtmaya, Dataverse veri modellerini ayarlamaya ve kimlik doğrulamasını yapılandırmaya kadar konuşma becerileri aracılığıyla site geliştirme yaşam döngüsünün tamamını destekler.

Important

  • GitHub Copilot CLI veya Claude Code gibi üretken bir yapay zeka kodlama aracısı, Power Pages özgü görevleri tamamlamak için bu eklentinin becerilerini ve iş akışlarını kullanır.
  • Yapay zeka kodlama aracısı tarafından oluşturulan kod ve yapılandırma yanlış olabilir. Oluşturulan tüm içeriği onaylamadan veya dağıtmadan önce gözden geçirin, test edin ve doğrulayın. Aracı tekliflerini onaylamadan önce her zaman gözden geçirin.

Prerequisites

Başlamadan önce gerekli yazılım ve izinlere sahip olduğunuzu doğrulayın.

Yazılım gereksinimleri

Bileşen En düşük sürüm Daha fazla bilgi
Node.js 18.0 veya üzeri Node.js'i İndir
Power Platform CLI (PAC CLI) 2.6.3 veya üzeri (sunucu mantığı için gereklidir) PAC CLI'yi yükleme
Azure CLI Latest Azure CLI'yı yükleme
GitHub Copilot CLI veya Claude Code Latest GitHub Copilot CLI veya Claude Code
Visual Studio Code ve Power Platform Araçları uzantısı (İsteğe bağlı) Latest VS Code'u indirin ve Power Platform Araçları'nı yükleyin

Ayrıca şunları yapmanız gerekir:

  • Power Pages'in etkinleştirildiği bir Power Platform ortamı.
  • Hedef ortamınıza bağlı kimliği doğrulanmış bir PAC CLI oturumu. Henüz bağlanmadıysanız komutunu çalıştırın pac auth create .
  • Aynı kiracıda oturum açan bir Azure CLI oturumu. Kimlik doğrulaması için az login --allow-no-subscriptions çalıştırın.

Kimlik doğrulamayı doğrulayın:

komutunu kullanarak kimliğinizin pac auth list doğrulanmış olduğunu doğrulayın.

pac auth list           # Should show authenticated profile

Kimliğiniz doğrulanmamışsa şu komutu çalıştırın:

pac auth create --environment <Instance url>        # Authenticate to Power Platform

Tip

Örnek URL'sini almak için Power Pages giriş sayfasına gidin, sağ üst köşedeki Settings simgesini seçin ve ardından Session details öğesini seçin.

Eklentiyi yükleme

Marketten Power Pages eklentisini yükleyin. GitHub Copilot CLI kullanıyorsanız, eşdeğer yükleme adımları için Copilot CLI uzantıları belgelerine bakın. Aşağıdaki komutlar Claude Code söz dizimini kullanır.

Otomatik güncelleştirme etkin tüm eklentileri ayarlamak için yükleyiciyi çalıştırın:

Windows (PowerShell):

iwr https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js -OutFile install.js; node install.js; del install.js

macOS/Linux/Windows (cmd):

curl -fsSL https://raw.githubusercontent.com/microsoft/power-platform-skills/main/scripts/install.js | node

Yükleyici otomatik olarak:

  • pac HENÜZ yüklü değilse CLI'yi yükler.
  • Claude Code ve GitHub Copilot CLI gibi kullanılabilir araçları algılar.
  • Eklenti marketini kaydeder ve listelenen tüm eklentileri yükler.
  • Eklentilerin güncel kalması için otomatik güncelleştirmesi etkinleştirir.

Kurulumdan sonra, eklentinin becerilerine ajan oturumunuzda slash komutları olarak erişmek için Claude Code veya GitHub Copilot CLI'yi yeniden başlatın.

Marketten yükleme

  1. Terminalinizde Claude Code'un açılmasını sağlayın.

  2. Microsoft marketini ekleyin:

    /plugin marketplace add microsoft/power-platform-skills

  3. Power Pages eklentisini yükleyin:

    /plugin install power-pages@power-platform-skills

Eklentiyi yükledikten sonra, aracı oturumunuzda eklentinin becerilerine eğik çizgi komutları olarak erişebilmek için Claude Code veya GitHub Copilot CLI'yi yeniden başlatın.

Tip

Market güncelleştirmelerini ve becerilerini otomatik olarak almak için otomatik güncelleştirmeyi açın. /plugin komutunu kullanın, Marketler'e gidin, marketi seçin ve otomatik güncelleştirmeyi açın.

Becerilere genel bakış

Eklenti, bir Power Pages sitesinin tüm yaşam döngüsünü kapsayan beceriler sağlar. Her beceriyi, eğik çizgi komutu olarak veya ne yapmak istediğinizi açıklayarak konuşma yoluyla çağırabilirsiniz.

Beceri Komut Ne yapar?
Site oluştur /create-site Bir siteyi iskeleler, tasarım yönünüzü uygular ve sayfalar ve bileşenler oluşturur
Site yayınla /deploy-site PAC CLI kullanarak projeyi oluşturur ve Power Pages'e yükler
Siteyi etkinleştir /activate-site Web sitesi kaydı oluşturur ve kamuya açık bir URL atar
Veri modelini ayarlama /setup-datamodel Dataverse tabloları, sütunları ve ilişkileri oluşturur
Örnek veri ekleme (isteğe bağlı) /add-sample-data Dataverse tablolarını gerçekçi test kayıtlarıyla doldurur
Web API'lerini tümleştirme /integrate-webapi Türlenmiş API istemci kodu, hizmetleri ve tablo izinleri oluşturur
Yapay zeka özetleri ekleme /add-ai-webapi Üretken yapay zekâ özetleme API'lerini (arama özeti ve veri özetleme) sayfalarınıza entegre eder. Sahteciliğe karşı koruma sağlayan jeton yönetimi, çerçeveye özgü sarmalayıcılar, kablolu çağrı noktaları ve bunlara uygun Summarization site ayarlarını içeren, türü belirtilmiş bir özet hizmeti oluşturur
Kimlik doğrulamayı ayarlama /setup-auth Oturum açma, oturum kapatma ve rol tabanlı erişim denetimi ekler. çok sağlayıcılı yapılandırmalar dahil olmak üzere Microsoft Entra ID, Microsoft Entra Dış Kimlik, OpenID Connect, SAML 2.0, WS-Federation, Microsoft hesabı, Facebook, Google ve yerel kullanıcı adı ve parola kimlik doğrulamasını destekler
Web rolleri oluşturma /create-webroles Kullanıcı erişim yönetimi için web rolü YAML dosyaları oluşturur
Sunucu mantığı ekleme /add-server-logic Doğrulama, dış API çağrıları, gizli dizi yönetimi ve veri işlemleri için güvenli sunucu tarafı JavaScript uç noktaları oluşturur
Bulut akışı ekleme /add-cloud-flow Onay iş akışları, bildirimler ve zamanlanmış otomasyon için mevcut Power Automate bulut akışlarını sitenize tümleştirir
Arka ucu tümleştirme /integrate-backend Prototipinizi analiz eder, her özellik için doğru yaklaşımı (Web API'si, Sunucu Mantığı veya bulut akışı) belirler ve derleme sırasının tamamını düzenler
SEO Ekle /add-seo robots.txt, sitemap.xmlve meta etiketleri oluşturur
Güvenlik gözden geçirmesini çalıştırma /security-review Odaklanmış güvenlik becerilerini düzenler ve her bulguyu tek bir HTML raporunda birleştirir. Kod, bağımlılıklar, dağıtılan site taraması, tarayıcı üst bilgileri, web uygulaması güvenlik duvarı, tablo izinleri ve kimlik doğrulama yapılandırmasını kapsar
Kaynak kodunu tara /scan-code Yerel kaynak dosyalarda statik analiz ve bağımlılık taraması çalıştırır; kod desenleri, güvenlik açığı bulunan paketler, sabit kodlanmış gizli diziler ve lisans sorunlarıyla ilgili bulguları ortaya çıkar
Dağıtılan siteyi tara /scan-site Canlı sitede sunucu tarafı güvenlik taraması başlatır, en son raporu getirir ve bulguları önem derecesine göre gruplandırir
Tarayıcı güvenlik üst bilgilerini yönetme /manage-headers Bir sitenin tarayıcılara gönderdiği HTTP güvenlik üst bilgilerini inceler ve yapılandırır : İçerik Güvenliği İlkesi, çerçeve ve tıklama koruması, çıkış noktaları arası paylaşım, tanımlama bilgisi davranışı ve ilgili site ayarları
Web uygulaması güvenlik duvarını yönetme /manage-firewall Bir üretim sitesinde web uygulaması güvenlik duvarını (WAF) inceler ve yapılandırır: korumayı etkinleştirir, IP bloklarını, ülke bloklarını, yol bloklarını ve hız sınırlarını ekler veya kaldırır
Tablo izinlerini denetleme /audit-permissions Site kodu ve Dataverse meta verilerine göre mevcut tablo izinlerini denetler; önerilen düzeltmelerle önem derecelerine göre gruplandırılmış bir HTML raporu oluşturur
Dağıtımı planlama /plan-alm Proje durumunu algılar, yükseltme stratejinizi toplar, görsel bir plan oluşturur ve diğer uygulama yaşam döngüsü yönetimi (ALM) becerilerini doğru sırada düzenler
Yazar çözümü /setup-solution Yayımcı ve çözüm oluşturur, Power Pages bileşenleri ekler, site ayarlarını sınıflandırır ve ortam değişkenleri ile Azure Key Vault gizli dizileri önerir
Ardışık düzen ana makinesini ayarlama /ensure-pipelines-host Power Platform Pipelines için bir ana bilgisayar ortamı hazırlar veya algılar
İş akışını ayarlama /setup-pipeline Dataverse'de işlem hattı tanımını kaydeder ve yükseltme aşamalarını hedef ortamlara bağlar
Ardışık düzen aracılığıyla dağıtım /deploy-pipeline Hedef aşama için aşama başına ortam değişkeni geçersiz kılmalarıyla birlikte bir boru hattı dağıtımını tetikler
Zorlamalı bağlantı ortamı /force-link-environment Bir ana bilgisayar çakışması dağıtımı engellediğinde, hedef ortamı yeni bir Power Platform Pipelines ana bilgisayarına yeniden atar
Çözümü dışarı aktarma /export-solution Dışarı aktarmadan önce tamlık denetimiyle çözümü yönetilen veya yönetilmeyen zip olarak dışarı aktarır
Çözümü içeri aktarma /import-solution Bir çözüm ZIP dosyasını hedef ortama, aşamalı olarak veya doğrudan içe aktarır
Test sitesi /test-site Dağıtılan bir siteyi tarayıcı tabanlı bir testle doğrular: sayfa gezinmesi, rol tabanlı erişim denetimleri ve Web API'sini doğrulama
Dağıtımda tespit /diagnose-deployment Dağıtım hatalarını bilinen hata kataloğuyla eşleştirir ve bir düzeltme önerir

Tipik iş akışı

Ortak bir uçtan uca iş akışı şu sırayı izler:

  1. /create-site: İskele oluşturma, tasarım ve sayfa oluşturma
  2. /deploy-site : Power Pages ortamınıza yükleyin
  3. /activate-site : Genel URL ayarlama
  4. /setup-datamodel : Dataverse tabloları oluşturma
  5. /add-sample-data : Tabloları test kayıtlarıyla doldurma
  6. /integrate-webapi : API istemci kodu oluşturma ve izinleri yapılandırma
  7. /create-webroles : Erişim rolleri tanımla
  8. /setup-auth : Oturum açma, oturum kapatma ve rol tabanlı kullanıcı arabirimi ekleme
  9. /add-server-logic : Güvenli sunucu tarafı uç noktaları ekleme
  10. /add-cloud-flow : Mevcut Power Automate akışlarını tümleştirme
  11. /add-seo : Arama altyapısı iyileştirmesi
  12. /deploy-site : Son değişiklikleri canlı gönder
  13. /security-review : Üretime geçmeden önce uçtan uca güvenlik incelemesi çalıştırın
  14. /plan-alm : Sitenizi test ve üretim ortamlarına yükseltme

Tip

  • Bu sırayı tam olarak izlemeniz gerekmez. Her beceri kendi önkoşullarını denetler ve bir şeyin eksik olup olmadığını size söyler. Örneğin, önce sitenizin kimlik doğrulamasına ihtiyacı varsa önce /setup-auth komutunu çalıştırabilirsiniz/integrate-webapi.
  • Her özellik için hangi yaklaşımı kullanacağınızdan emin değilseniz, 4 ile 10 arasında tek tek adım yerine komutunu çalıştırın /integrate-backend . Prototipinizi analiz eder, her özelliğin Web API'sine mi, Sunucu Mantığına mı yoksa bir bulut akışına mı ihtiyacı olduğunu belirler ve becerileri doğru sırada düzenler.
  • Yapay zeka tarafından oluşturulan arama ve kayıt özetlerini eklemek için sonrasında /add-ai-webapikomutunu çalıştırın/integrate-webapi. Bu, /integrate-webapi tarafından yapılandırılan tablo izinlerini ve site ayarlarını yeniden kullanır; bu nedenle Web API tümleştirmeniz hazır olduktan sonra bunu çalıştırın.

Power Pages sitenizi oluşturma

Bu rehberde, iskeleden dağıtıma kadar eklentiyle Power Pages sitesi oluşturmanın tüm yaşam döngüsü anlatılmaktadır. Her adım, söylediklerinizi ve eklentinin yanıt olarak ne yaptığını açıklar.

1. Adım: Sitenizi oluşturma

İstediğiniz siteyi doğal dilde açıklayın: ne için olduğu, hangi sayfalara ihtiyaç duyduğu ve renk düzeni, düzen stili veya yazı tipleri gibi tasarım tercihleri. /create-site çalıştırın veya sadece sitenizi tanımlayın; eklenti amacı otomatik olarak tanır.

Çerçeve belirtmezseniz eklenti sizden bir çerçeve (React, Vue, Angular veya Astro) seçmenizi ister:

  1. Bir şablondan projenin iskeletini oluşturur ve site adınızı, renklerinizi ve tasarım parametrelerinizi uygular.
  2. Bağımlılıkları yükler, bir geliştirme sunucusu başlatır ve canlı bir tarayıcı önizlemesi açar.
  3. İstediğiniz her sayfayı, bileşeni ve rotayı ilgili görüntülerle oluşturur.
  4. Önemli kilometre taşlarında dahili geri alma geçmişine sahip olmanız için git commit'leri oluşturur.

2. Adım: Sitenizi dağıtma

Sitenizi Power Pages'e yüklemek için komutunu çalıştırın /deploy-site . Eklenti:

  1. PAC CLI'nın yüklendiğini ve kimlik doğrulama oturumunuzun etkin olduğunu doğrular.
  2. Devam etmeden önce hedef ortamı size onaylatır.
  3. Üretim derlemesi çalıştırır ve derlenmiş üretim çıkışını yükler.
  4. Henüz yoksa bir dağıtım öğeleri dizinini oluşturur.

Note

Ortamınız belirli dosya eklerini engelliyorsa eklenti sorunu algılar ve sorunu çözmek için yönergeler sağlar.

3. Adım: Sitenizi etkinleştirme

Siteyi genel olarak erişilebilir hale getirmek için komutunu çalıştırın /activate-site . Eklenti:

  1. Site adınıza göre bir alt etki alanı önerir ve bunu özelleştirmenize olanak tanır.
  2. Power Platform API'siyle bir web sitesi kaydı sağlar.
  3. Site aktif olana kadar sürekli kontrol eder ve genel URL'yi döndürür.

Bu noktada, genel URL'de bir çalışma siteniz vardır. Kalan adımlarda veri, kimlik doğrulaması ve SEO eklenir. Siteniz için geçerli olmayan adımları atlayın.

4. Adım: Veri modelinizi ayarlama

Sitenizin ihtiyaç duyduğu Dataverse tablolarını oluşturmak için komutunu çalıştırın /setup-datamodel . Zaten bir ER diyagramınız veya belirli bir şemanız varsa, aracının kodunuzu çözümlemesini sağlamak yerine doğrudan sağlayın.

Eklenti, aşağıdakilere sahip bir Veri Modeli Mimarı aracısı oluşturur:

  1. Sayfaların ve bileşenlerin hangi verileri gerektirdiğini belirlemek için sitenizin kodunu analiz eder.
  2. Yinelenenleri önlemek için Var olan tablolar için Dataverse ortamınızı sorgular.
  3. Tablolar, sütunlar, veri türleri ve ilişkiler içeren ve ER diyagramı olarak görselleştirilmiş bir veri modeli önerir.

Teklifi gözden geçirir ve onaylarsınız. Siz onaylayana kadar eklenti hiçbir şey oluşturmaz. Onaydan sonra eklenti, API çağrıları aracılığıyla tabloları ve sütunları oluşturur ve 5. ve 6. Adımların kullandığı bir bildirim dosyasını kaydeder.

5. Adım: Örnek veri ekleme (İsteğe bağlı)

Tablolarınızı test kayıtlarıyla doldurmak için komutunu çalıştırın /add-sample-data . Bu adım, 4. Adımdaki veri modelini gerektirir.

Eklenti aşağıdaki eylemleri gerçekleştirir:

  1. Tablolarınızı, sütunlarınızı ve ilişkilerinizi anlamak için bildirimi okur.
  2. Gerçekçi e-postalar, makul tarihler ve biçimlendirilmiş para birimi tutarları gibi her sütun türü için bağlamsal olarak uygun değerler oluşturur.
  3. Kayıtları bağımlılık sırasına (alt tablolardan önceki üst tablolar) ekler ve toplu eklemeler sırasında kimlik doğrulama belirteçlerini otomatik olarak yeniler.

6. Adım: Dataverse Web API'siyle tümleştirme

Sahte verileri canlı Dataverse sorgularıyla değiştirmek için komutunu çalıştırın /integrate-webapi . Bu adım, 4. Adımdaki veri modelini gerektirir.

Eklenti aşağıdaki eylemleri gerçekleştirir:

  1. Sahte veri, yer tutucu getirme çağrıları veya sabit kodlanmış diziler kullanan bileşenler için kod tabanınızı tarar. Bu bileşenleri Dataverse tablolarınızla eşler.
  2. Oluşturan her tablo için bir Web API Tümleştirme aracısı oluşturur:
    • Sahteciliğe karşı belirteç yönetimi ve yeniden deneme mantığı içeren paylaşılan bir API istemcisi.
    • TypeScript varlık türleri ve etki alanı eşleyicileri.
    • CRUD hizmet katmanı.
    • React hookları, Vue bileşenleri veya Angular servisleri gibi çerçeveye özgü kalıplar.
  3. Tablo izinleri ve site ayarları öneren bir İzin Mimarı aracısı oluşturur.

İzin teklifini gözden geçirir ve onaylarsınız. Siz onaylayana kadar eklenti herhangi bir yapılandırma dosyası oluşturmaz.

Yapay zeka tarafından oluşturulan özetler ekleme (İsteğe bağlı)

Web API entegrasyonunuzun üzerine üretken yapay zekâ özetleri eklemek için /add-ai-webapi komutunu çalıştırın. Beceri, iki önizleme özetleme API'sini kayıt ayrıntılarınıza ve liste sayfalarınıza bağlar:

  • Arama özeti API'si: Alıntılarla birlikte arama sonuçlarının yapay zekayla sıkıştırılmış bir özetini döndürür.
  • Veri özetleme API'si: Dataverse tablosu için kayıt başına özet veya liste düzeyinde içgörüler döndürür.

Bu adım, 4. Adım'dan veri modeline ve 6. Adım'dan Web API tümleştirmesine dayalıdır. Eklenti aşağıdaki eylemleri gerçekleştirir:

  1. Kodunuzu özet tümleştirme noktaları için tarar ve hedef sayfaları, tabloları ve kullanılacak API'leri onaylar.
  2. Eksik Web API önkoşullarını (tablo izinleri, sütun listeleri ve web rolleri) /integrate-webapi ve /create-webroles'e devreder; böylece izinler için tek doğru kaynak bunlar olur.
  3. AI Web API Tümleştirme aracısı, sahteciliğe karşı koruma jetonu yönetimi, çerçeveye özgü sarmalayıcılar (React kancaları, Vue oluşturulabilir öğeleri veya Angular hizmetleri) ve hedef sayfalarda sabitlenmiş çağrı noktaları içeren, türlendirilmiş bir özet hizmeti (aiSummaryService.ts) oluşturan bir aracı oluşturur.
  4. İstemler ve içerik sınırları için Summarization site ayarlarını oluşturan bir Yapay Zekâ Web API Ayarları Mimarı aracısı oluşturur.

Teklifleri gözden geçirir ve onaylarsınız. Eklenti siz onaylayana kadar kod oluşturmaz veya ayarlar oluşturmaz.

Note

Özetleme API'leri önizleme aşamasındadır ve yönetim ve site düzeyi denetimlerinin açık olmasına bağlıdır. Özetler dağıtımdan sonra görünmüyorsa, ilgili site ayarları ve yönetici denetimleri aracılığıyla özelliğin etkinleştirildiğini onaylayın. Daha fazla bilgi için bkz. Data özetleme API'lerine genel bakış ve Power Pages yapay zeka arama.

7. Adım: Web rolleri oluşturma

Kullanıcı erişim rollerini tanımlamak için komutunu çalıştırın /create-webroles . Eklenti:

  1. Yinelemeleri önlemek için ortamınızı mevcut web rolleri için sorgular.
  2. Benzersiz tanımlayıcılarla rol tanımları oluşturur.
  3. Her sitenin en fazla bir anonim rolü ve bir kimliği doğrulanmış rolü olduğunu zorlar.

8. Adım: Kimlik doğrulamayı ayarlama

Sitenize oturum açma, oturum kapatma ve rol tabanlı erişim denetimi eklemek için komutunu çalıştırın /setup-auth . Eklenti aşağıdaki kimlik sağlayıcılarını destekler ve aynı anda bir veya birkaç sağlayıcı yapılandırabilirsiniz.

Provider En iyi kullanım alanları
Microsoft Entra Dış Kimlik (müşteriye yönelik siteler için önerilir) Kendi kendine kayıt özelliği sunan herkese açık siteler ve müşteri portalları.
Microsoft Entra Kimliği şirket içi çalışan portalları veya işletmeler arası (B2B) iş ortağı siteleri. Power Pages sitenin üst kiracısını otomatik olarak yapılandırdığından, kiracı bilgilerini girmeniz gerekmez.
Microsoft, Facebook, Google Tüketici kitleleri için sosyal oturum açma.
Yerel kimlik doğrulama Kullanıcı adı ve parolayla oturum açma. Önerilmez ve yalnızca açıkça istediğinizde yapılandırılır.

Protokoller ve yapılandırma konuları dahil olmak üzere desteklenen sağlayıcılar hakkında daha fazla bilgi için bkz. Power Pages kimlik doğrulamasının genel görünümü.

Eklenti:

  1. Sitenizi (amaç, sayfalar, hedef kitle) analiz eder ve mantıklı bir varsayılan değer önerir. Örneğin eklenti, müşterilere yönelik bir site için açık kayıt özelliğine sahip Microsoft Entra Dış Kimlik’yi veya bir iç portal için yalnızca davetlilere açık kayıt özelliğine sahip Microsoft Entra ID’yi önerir. Öneriyi kabul eder veya kendi sağlayıcılarınızı seçersiniz.
  2. Her bir kimlik sağlayıcı için kimlik sağlayıcının yönetim merkezinde kiracı oluşturma, uygulamaları kaydetme, kullanıcı akışları oluşturma ve istemci kimliklerini ile yönlendirme URI'lerini alma gibi tüm ön koşul adımlarını tek tek anlatır. Eklenti, konuşmaya geri yapıştırdığınız her değeri doğrular ve uygulama kaydına yapıştırılan değerin site ayarlarına yazılan değerle eşleşmesi için siteniz için tam yeniden yönlendirme URI'sini hesaplar.
  3. Kullanıcı profili verilerinin kimlik sağlayıcısından Dataverse kişi kaydına (talep eşlemesi) nasıl akması gerektiğini, her oturum açmada mı yoksa yalnızca ilk oturum açmada mı eşitlenmesi gerektiğini ve dış oturum açmaların mevcut kişilere e-postayla otomatik olarak bağlanıp bağlanmayacağını sorar.
  4. Kimlik doğrulama hizmetini, tür bildirimlerini, rol tabanlı yetkilendirme yardımcı programlarını (hasRole, RequireAuth, RequireRole), SPA oturumlarının sessizce sona ermesini önleyen oturumu canlı tutma kancasını ve site düzeninize entegre edilmiş bir oturum açma/oturum kapatma kullanıcı arayüzü bileşenini oluşturur. Eklenti, çerçevenizin her yerinde React hook’ları, Vue composable’ları, Angular servisleri veya Astro bileşenleri gibi kalıpları kullanır.
  5. Birden fazla sağlayıcı yapılandırıldığında, seçtiğiniz düzene göre oluşturulan bir /login sayfası üretir: yatay satır, dikey yığın, birincil vurgu veya sekmeli.
  6. Her sağlayıcı, kayıt modu, claim eşlemesi ve isteğe bağlı özellik için karşılık gelen site ayarlarını .powerpages-site/site-settings/ altında yazar.

Eklenti, bunları açtığınızda aşağıdaki isteğe bağlı özellikleri de yapılandırıyor:

  • Hükümler ve koşullar: Kullanıcıların oturum açma işlemini tamamlamadan önce kabul etmesi gereken /terms SPA sayfası ve buna karşılık gelen site ayarı ile içerik parçacıkları.
  • Kullanıcı profili sayfası: Oturum açmış kullanıcıların iletişim bilgilerini Power Pages Web API'si aracılığıyla düzenlediği /user-profile SPA sayfası.
  • Birleşik oturum kapatma: Paylaşılan cihaz kullanılan veya düzenlemeye tabi senaryolarda, kullanıcı siteden çıkış yaptığında kimlik sağlayıcıdaki oturumunu da kapatır.

Tip

Mevcut siteye ikinci bir kimlik sağlayıcısı eklemek için yeniden çalıştırın /setup-auth . Eklenti, önceden yapılandırılmış olanları algılar ve mevcut sağlayıcıların üzerine yazmadan yeni bir sağlayıcı eklemeyi teklif eder. Bu yaklaşım, Microsoft Entra Dış Kimlik ile başlayıp daha sonra sosyal oturum açma için Google ekleme gibi artımlı senaryolar için kullanışlıdır.

Note

İstemci tarafı yetkilendirmesi (RequireAuth, RequireRole, hasRole) yalnızca kullanıcı deneyimi içindir. Kullanıcının gördüklerini denetler. /integrate-webapi tarafından yapılandırılan sunucu tarafı tablo izinleri gerçek güvenlik sağlar.

9. Adım: Sunucu mantığı ekleme

Komutunu çalıştırarak /add-server-logic sitenize güvenli sunucu tarafı uç noktaları ekleyin. Sitenizin dış API çağrıları, sunucu tarafı doğrulama, gizli dizi yönetimi veya çapraz varlık veri işlemleri gibi tarayıcıda çalıştıramayan bir mantığa ihtiyacı olduğunda Sunucu Mantığı'nı kullanın.

Important

Sunucu mantığı desteği için PAC CLI sürüm 2.6.3 veya üzeri gerekir. En son sürüme güncelleştirmek için hızlı yükleme betiğini kullanın.

İhtiyacınız olan şeyleri düz dilde ve eklentide açıklayın:

  1. Kullanım örneğinizi analiz eden ve karmaşıklığını sınıflandıran bir Server Logic Architect aracını başlatır.
  2. Gözden geçirmeniz için bir uç nokta tasarımı, güvenlik yapılandırması ve gerekli tablo izinleri önerir.
  3. Onayladıktan sonra, /_api/serverlogics/<name> konumunda sunucu tarafı JavaScript uç noktasını oluşturur.
  4. Bileşenlerinizden uç noktayı çağırmak için tür tanımlı bir istemci tarafı hizmeti oluşturur.
  5. Bileşenlerinizi yeni hizmeti çağıracak şekilde güncelleştirir.
  6. Uç nokta için web rolü atamalarını ve tablo izinlerini yapılandırır.

Teklifi gözden geçirir ve onaylarsınız. Siz onaylayana kadar kod oluşturulmaz.

Yaygın kullanım örnekleri:

  • Dış hizmetlere bağlanın. Kimlik bilgilerini açığa çıkarmadan REST API'leri, Azure İşlevleri veya üçüncü taraf hizmetleri çağırabilirsiniz. (Eğitim: dış hizmetlerle etkileşim)
  • Güvenli veri işlemleri gerçekleştirme. Tutarlı sunucu tarafı doğrulamasıyla Dataverse kayıtlarını sorgulayın, güncelleştirin veya silin. (Öğretici: Dataverse tablolarıyla etkileşim kurma)
  • Özel mantık çalıştırın. Verileri istemciye döndürmeden önce tablolar arasında toplama, iş kurallarını zorunlu kılma veya türetilmiş değerleri hesaplama.
  • Gizlilikleri sunucu tarafında yönetin. Kimlik bilgilerini ve API anahtarlarını hiçbir zaman istemci kodunda değil sunucuda depolayın. (Tutorial: Microsoft Graph ve SharePoint)

Note

Kullanım örneği başına bir kez çalıştırın /add-server-logic . Örneğin, sitenizin hem envanter doğrulama uç noktasına hem de genel arama uç noktasına ihtiyacı varsa, beceriyi iki kez çalıştırın.

10. Adım: Bulut akışlarını tümleştirme

Mevcut Power Automate bulut akışlarını sitenize tümleştirmek için /add-cloud-flow çalıştırın. Bu beceri, Power Pages sitenizi Power Automate önceden oluşturduğunuz akışlara bağlar. Yeni bulut akışları oluşturmaz.

Eklenti:

  1. Mevcut bulut akışını sitenize kaydeder.
  2. Sayfalarınızdan akışı tetiklemek için istemci tarafı kodu oluşturur.
  3. Zaman uyumsuz iş akışı durumunu ve geri çağırma desenlerini işler.
  4. Sayfa ile akış arasında veri alışverişini kurar.

Power Automate tarafından sunucu tarafı uç noktalarına göre daha iyi işlenen onay iş akışları, e-posta bildirimleri, zamanlanmış işler ve olay odaklı otomasyon için /add-cloud-flow kullanın.

Alternatif: Tam hizmet katmanını planlamak için /integrate-backend kullanın

Hangi özelliklerin Web API'sine, Sunucu Mantığına veya bulut akışına ihtiyaç duyduğundan emin değilseniz, 4 ile 10 arasında el ile çalıştırmak yerine komutunu çalıştırın /integrate-backend . Bu beceri, aşağıdakiler için bir düzenleyici görevi görür:

  1. Hizmet katmanı gerektiren tüm özellikleri tanımlamak için prototipinizi analiz eder.
  2. Her özelliği doğru yaklaşımda sınıflandırır: Standart CRUD için Web API'si, sunucu tarafı doğrulama ve dış API'ler için Sunucu Mantığı veya onay iş akışları ve otomasyon için bulut akışı.
  3. Tüm becerilere, bağımlılıklara ve yapılandırmalara sahip sıralı bir yürütme planı önerir.
  4. Onayı aldıktan sonra becerileri doğru sırayla koordine eder.

Plan kalıcı, devam ettirilebilir ve düzenlenebilir. Oluşturulan kodu gözden geçirmek veya siteyi test etmek için herhangi bir adımdan sonra durdurun ve yeniden çalıştırarak /integrate-backend kaldığınız yerden devam edin.

11. Adım: SEO Ekleme

Sitenizi arama motorlarına göre iyileştirmek için komutunu çalıştırın /add-seo . Eklenti:

  1. Framework'ünüzün yönlendirici yapılandırmasından yolları keşfeder.
  2. Bulunan tüm yollar için arama altyapısı yönergeleri ve site haritası oluşturur.
  3. Meta etiketler ekler: viewport, charset, description, Open Graph, Twitter Card ve favicon referansları.

12. Adım: Son siteyi dağıt

İsteğe bağlı herhangi bir adımı gerçekleştirirseniz, değişiklikleri canlı göndermek için /deploy-site'yi yeniden çalıştırın. Eklenti bir üretim derlemesi çalıştırır ve tüm dağıtım yapıtlarıyla birlikte siteyi (tablo izinleri, site ayarları, web rolleri, sunucu mantığı dosyaları) Power Pages ortamınıza yükler.

13. Adım: Güvenlik incelemesi çalıştırma

Üretime geçmeden önce sitenizin uçtan uca güvenlik gözden geçirmesini gerçekleştirmek için komutunu çalıştırın /security-review . Beceri, odaklı güvenlik becerilerini koordine eder ve tüm bulguları docs/security-review-<timestamp>.html konumunda tek bir HTML raporunda birleştirir.

Eklenti, hedefiniz hakkında tek bir düz dil soru sorar ve eşleşen odaklanmış beceri kümesini seçer:

Goal Neleri denetler?
Kod ve yapılandırma Kaynak kodu, bağımlılıklar, tablo izinleri ve kimlik doğrulama yapılandırması. Yalnızca yerel dosyalarda çalışır; dağıtım gerekmez.
Sürüm hazırlığı (önerilir) Yayımlamadan önce tam inceleme. Odaklanmış her beceriyi çalıştırır: kod ve bağımlılıklar, dağıtılan site taraması, tarayıcı güvenlik üst bilgileri, web uygulaması güvenlik duvarı, tablo izinleri ve kimlik doğrulaması.
Yayına alınan site Yalnızca canlı olarak devreye alınmış siteler taranır. Yayımlanan bir sitenin sürekli izlenmesi için kullanışlıdır.

Onayladıktan sonra eklenti, eşleşen odaklanmış becerileri paralel olarak çalıştırır ve bulgularını tek bir rapora yazar:

  • /scan-code: Yerel kaynak dosyalarda statik analiz (opengrep) ve bağımlılık tarama (trivy) çalıştırır. Kod desenlerini, güvenlik açığı olan paketleri, sabit kodlanmış gizli dizileri ve lisans sorunlarını ortaya çıkar. Araçlardan biri yüklü değilse beceri, alternatif olarak manuel kod incelemesi sunar.
  • /scan-site: Canlı sitede bir sunucu tarafı güvenlik taraması başlatır ve en son raporu getirir. Tarama süresi site boyutuna bağlıdır - küçük siteler dakikalar içinde biter, büyük siteler saatler sürebilir. Bulgular önem derecelerine göre gruplandırılır. Dağıtılmış bir site gerektirir.
  • /manage-headers: .powerpages-site/site-settings/ kapsamında yapılandırılan HTTP güvenlik başlıklarını inceler: İçerik Güvenliği İlkesi, X-Frame-Options, CORS, çerez SameSite ve ilgili ayarlar. Eksik veya zayıf değerleri tanımlar ve önerilen varsayılan değerleri önerir.
  • /manage-firewall: Yönetilen kural durumu ve özel kurallar (IP blokları, ülke blokları, yol blokları, hız sınırları) dahil olmak üzere üretim sitesi için web uygulaması güvenlik duvarını (WAF) inceler. Yalnızca desteklenen bölgelerdeki üretim sitelerinde kullanılabilir; beceri, uygunluk sorunlarını algılar ve bildirir.
  • /audit-permissions: Site kodu ve Dataverse meta verilerine göre mevcut tablo izinlerini denetler. Eksik izinleri, fazla izinli rolleri, kullanılmayan izinleri ve YAML şema sorunlarını ortaya çıkar.

Birleştirilmiş rapor, bulguları bölüme göre gruplandırar, varsayılan tarayıcınızda açılır ve düz dil düzeltme yönergelerini içerir. Eklenti, sohbet üzerinden ardından düzeltmelerde size adım adım yol göstermeyi teklif eder - bir bulgu seçin; eklenti, değişikliği uygulamak için ilgili odaklı yeteneği etkileşimli olarak devreye sokar.

Note

Güvenlik gözden geçirmesi hiçbir zaman değişiklikleri otomatik olarak uygulamaz. Her bir odaklanmış beceri, birleştirilmiş çalıştırma sırasında salt okunur inceleme modunda çalışır. Düzeltme uygulamak için, siz eylemi seçtikten sonra eklenti eşleşen beceriyi etkileşimli olarak çağırır.

Tip

Ayrıca odaklanmış herhangi bir beceriyi kendi başına da çalıştırabilirsiniz:

  • Kod düzeyi sorunlarını erken yakalamak için geliştirme sırasında komutunu çalıştırın /scan-code .
  • Belirli bir İçerik Güvenlik İlkesi hatasını düzeltmek veya CORS'yi ayarlamak için komutunu çalıştırın /manage-headers .
  • Oturum açma sayfasına hız sınırı eklemek veya ülkeye göre trafiği engellemek için komutunu çalıştırın /manage-firewall .
  • Tablo izinlerini değiştirdikten sonra, hâlâ site koduyla eşleşip eşleşmediklerini doğrulamak için /audit-permissions öğesini çalıştırın.
  • Bir üretim sitesini zaman içinde izlemek için /security-review hedefiyle yeniden çalıştırın.

Sitenizi doğrulayın

Becerileri tamamladıktan sonra Power Pages sitenizin düzgün çalıştığını doğrulayın.

  1. Power Pages gidin.
  2. Sitenizi Etkin siteler listesinde bulun.
  3. Önizleme seçeneğini kullanarak sitenizin önizlemesini masaüstünde yapın .
  4. İşlevi sınayın.

Sitenizi ortamlar genelinde tanıtın

Siteniz geliştirme ortamınızda çalıştırıldıktan sonra, test ve üretim ortamlarına yükseltmek için uygulama yaşam döngüsü yönetimi (ALM) becerilerini kullanın. Eklenti sitenizi bir Power Platform çözümü olarak paketler, ortamlar arasında değişen değerleri tanımlar ve çözümü Power Platform İşlem Hatları aracılığıyla veya el ile dışarı ve içeri aktarma yoluyla dağıtır.

ALM becerilerini kullanmak için en az bir hedef Power Platform ortamına da (test, üretim veya her ikisi) ihtiyacınız vardır. Gizli anahtarlar için isteğe bağlı Azure Key Vault akışını kullanabilmek için, Azure aboneliğinizde bir Azure Key Vault oluşturma iznine de sahip olmanız gerekir.

Dağıtımı planlama

Başlamak için komutunu çalıştırın /plan-alm . /plan-alm , ALM'nin giriş noktasıdır ve diğer ALM becerilerini düzenler, bu nedenle bunları genellikle doğrudan çalıştırmazsınız. Eklenti:

  1. Projenizin, çözümünüzün ve hedef ortamlarınızın geçerli durumunu algılar.
  2. Yükseltme stratejiniz (Power Platform Pipelines mı yoksa manuel dışa aktarma ve içe aktarma mı), hedef aşamalar ve uygulanacak kısıtlamalar hakkında bilgi ister.
  3. docs/alm-plan.html konumunda, gerçekleştirmeyi amaçladığı her eylemi gösteren görsel bir plan oluşturur.
  4. Herhangi bir aşağı akış becerisini çalıştırmadan önce onayınızı bekler.

Plan diske kalıcı olarak kaydedilir; bu nedenle sonraki her beceri aynı kaydedilmiş planı okur ve ona yazar. Bir aşama başarısız olursa yeniden çalıştırın /plan-alm ve durdurulduğu yerden devam eder.

Çözümü yazma

Sitenizi Power Platform çözümü olarak paketlemek için komutunu çalıştırın /setup-solution . Eklenti:

  1. Bir yayımcı ve çözüm oluşturur, ardından Power Pages bileşenlerinizi ekler: site, web rolleri, sunucu mantığı uç noktaları, bulut akışı kayıtları ve OAuth sağlayıcı ayarları.
  2. Her site ayarını duyarlılığa göre sınıflandırır ve ortamlar arasında değişen değerler için ortam değişkenleri önerir.
  3. Azure Key Vault sağlamayı ve bağlantı dizeleri ve API anahtarları gibi kimlik bilgisi türü değerlerini depolamayı teklif eder.
  4. Yeni bir çözüm oluşturmadan bileşenleri uzlaştırma amacıyla, siteniz için bir çözüm zaten mevcut olduğunda eşitleme modunda çalışır.

Teklifi gözden geçirir ve onaylarsınız. Siz onaylayana kadar eklenti herhangi bir yapılandırma oluşturmaz.

Tip

Çözümünüz güvenilir biçimde devreye alınamayacak kadar büyükse veya iç içe geçmişse, eklenti bölünmesini önerir ve nereden bölmeniz gerektiğini belirtir. Değişiklikler uygulanmadan önce bölmeyi onaylayın.

Power Platform Pipelines ile dağıtım

Yükseltme stratejiniz olarak Power Platform Pipelines'ı seçtiyseniz eklenti şu becerileri çalıştırır:

  1. /ensure-pipelines-host, Power Platform Pipelines için gerekli koşulları sağlar veya bir ana bilgisayar ortamı tespit eder. Beceri, kiracınız için kullanılabilen en düşük maliyetli seçeneği seçer: ücretsiz bir platform konağı, mevcut bir ortamdaki Pipelines uygulaması veya özel bir konak.
  2. /setup-pipeline Dataverse'de bir işlem hattı tanımı kaydeder, seçtiğiniz aşamaları yapılandırıp her aşamayı bir hedef ortama bağlar.
  3. /deploy-pipeline, bir aşama için dağıtımı tetikler, deploymentSettings.json aracılığıyla her aşamaya özgü ortam değişkeni geçersiz kılmalarını uygular ve durumu bir dağıtım kayıt defterinde izler.

Bir dağıtım, hedef ortamın zaten farklı bir Power Platform Pipelines ana bilgisayarına bağlı olması nedeniyle başarısız olursa, eklenti hedef ortamı yeniden atamak için /force-link-environment öğesini çalıştırabilir. Eylem, açık onayınızı gerektirir ve geri alınamaz.

Manuel dışa aktarma ve içe aktarma ile dağıtım

El ile yolu seçerseniz eklenti şu şekilde çalışır:

  1. /export-solution çözümü, dışa aktarmadan önce eksiksizlik denetimiyle yönetilen ya da yönetilmeyen bir ZIP olarak dışa aktarmak için.
  2. ZIP dosyasını hedef ortama aktarmak için önce bağımlılıkları doğrulamak üzere aşamalı olarak ya da doğrudan /import-solution.

Dağıtılan siteyi etkinleştirme ve doğrulama

Hedef ortamda başarılı bir dağıtımdan sonra eklenti:

  1. Hedef ortamda genel erişime açık URL'yi oluşturmak için /activate-site komutunu çalıştırır.
  2. Dağıtımı doğrulamak için /test-site çalıştırır. Eklenti, temsilci sayfalarında gezinmek, rol tabanlı erişim denetimleri çalıştırmak, çağrıları doğrulamak /_api/ ve uç noktalardan /_api/serverlogics/ yanıt şekillerini yakalamak için bir tarayıcı kullanır. Bu beceri, sonucu PASS, WARNINGS, veya FAIL şeklinde bildirir. Her bir kontrolün ayrıntıları ise plana bağlı bağlantılar aracılığıyla görüntülenebilir.

Bir adım başarısız olursa eklenti çalıştırır /diagnose-deployment. Beceri, hatayı güncelliğini yitirmiş bir manifest, eksik bağımlılıklar, ana bilgisayar çakışmaları, engellenmiş JavaScript veya süresi dolmuş kimlik doğrulaması gibi bilinen dağıtım hataları kataloğundaki girdilerle karşılaştırır ve somut bir düzeltme önerir. Eklenti, onayınız olmadan hiçbir zaman bir düzeltme uygulamaz.

Note

Her ALM becerisi disk üzerindeki yapıtlardan okur ve diske yazar: çözüm bildirimi, plan verileri, işlem hattı kayıt defteri, dağıtım defteri ve test sonuçları. Orkestrasyon kaldığı yerden devam ettirilebilir ve denetlenebilir. Herhangi bir adımda neler olduğunu görmek için yapıtları inceleyin.

İpuçları ve en iyi yöntemler

Aşağıdaki ipuçları, Power Pages siteleri oluştururken eklentiden ve yapay zeka kodlama aracılarından en iyi şekilde yararlanmak için size yardımcı olur.

Terminal çıktısını, ilk çalıştırmada eksik araçlar için izleyin.

Eklenti becerileri ve iş akışlarını sağlar, ancak Copilot CLI veya Claude Code GitHub yapay zeka kodlama aracısı makinenizdeki gerçek komutları yürütür. Bu araçları ilk kez kullandığınızda terminal çıkışını yakından izleyin. Yapay zeka kodlama aracısı arka planda komutlar ve betikler çalıştırır ve bu komutlardan bazıları makinenize yüklenmemiş olabilecek araçlara bağlıdır. Bir adım başarısız olursa, terminal çıkışı genellikle hangi aracın veya komutun bulamadığını gösterir.

command not found veya is not recognized gibi bir hata görürseniz, eksik aracı yükleyin ve iş akışını yeniden tetikleyin. Yapay zeka kodlama aracısı, araç kullanılabilir olduktan sonra kaldığınız yerden devam eder.

Onaylamadan önce aracı tekliflerini gözden geçirme

Yapay zeka kodlama aracısı, değişiklik yapmadan önce Veri Modeli Mimarı ve İzin Mimarı'ndan gelenler gibi teklifler sunar. Yapay zeka kodlama aracısı tarafından oluşturulan kod ve yapılandırma yanlış olabilir, bu nedenle onaylamadan veya dağıtmadan önce her teklifi ve oluşturulan tüm kodları gözden geçirin, test edin ve doğrulayın.

  • Veri modeli teklifleri: Tablo adlarının, sütun türlerinin ve ilişkilerin iş gereksinimlerinizle eşleşip eşleşmediğini denetleyin. Teklif ayarlamak, veriler eklendikten sonra sütunları yeniden adlandırmaktan daha kolaydır.
  • İzin teklifleri: Her rolün her tablo için doğru erişim düzeyine (oluşturma, okuma, güncelleştirme, silme) sahip olduğunu doğrulayın. Aşırı yetkilendirilmiş tablo izinleri yaygın bir güvenlik riskidir.
  • Oluşturulan kod: Oluşturulan kodu okuyun ve dağıtmadan önce siteyi yerel olarak test edin. Yapay zeka tarafından oluşturulan kod hatalar veya güvenlik sorunları içerebilir.

Hataları doğrudan bağlamla yapıştırma

Bir şey başarısız olduğunda, derleme hatası, dağıtım hatası veya tarayıcıda çalışma zamanı özel durumu olsun, hata çıkışının tamamını kopyalayın. Yaptığınız şeyin kısa bir açıklamasıyla birlikte yapıştırın. Ne kadar çok bağlam sağlarsanız düzeltme de o kadar hızlı olur.

Örnek: Derleme hatası

I ran npm run build and got this error. Fix it.

error TS2339: Property 'jobTitle' does not exist on type 'JobPosting'.

  src/components/JobCard.tsx:24:31
    24   <Text>{posting.jobTitle}</Text>

Tip

Dosya adını, çalıştırdığınız komutu ve gerçekleşmesini beklediğiniz şeyleri ekleyin. Eklenti, sorunu bulmak ve tahmin etmek yerine hedeflenen bir düzeltme uygulamak için bu bağlamı kullanır.

Web API'si hatalarını tam istek URL'si ile paylaşma

Dağıtıldıktan sonra sık karşılaşılan bir sorun, api erişimi için bir sütun etkinleştirilmediğinde Power Pages Web API'sinden gelen 403 hatasıdır. Bu hatayla karşılaştığınızda , tam API URL'sini ve tam JSON hata yanıtını yapıştırın. Hata mesajı size tam olarak hangi tablo ve sütunun düzeltilmesi gerektiğini bildirir ve eklenti, sizin için tablo izinlerini ve site ayarlarını YAML dosyasında güncelleyebilir.

Örnek: Web API'sinde sütun etkinleştirilmedi (403)

I'm getting a 403 error when the documents page loads. Here's the API call and the response. Fix the issue so this API works.

URL:
https://my-site.powerappsportals.com/_api/crd50_documents?$select=crd50_documentid,crd50_name,crd50_documentcategory,crd50_filetype,crd50_filesize,crd50_updateddate,crd50_description,_crd50_propertyid_value

Response:
{
  "error": {
    "code": "90040101",
    "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
    "innererror": {
      "code": "90040101",
      "message": "Attribute _crd50_propertyid_value in table crd50_document is not enabled for Web Api.",
      "type": "AttributePermissionIsMissing"
    }
  }
}

Bu hata (AttributePermissionIsMissing), arama sütununun _crd50_propertyid_value Dataverse tablosunda var olduğu ancak Web API'sinin tablo izin yapılandırmasında listelenmediğinden kaynaklanır. Eklenti, .powerpages-site/table-permissions/ içinde YAML tablo iznine eksik sütunu ekleyerek ve yeniden dağıtarak bu hatayı giderir.

Note

Power Pages Web API'sinde, bir API çağrısı tarafından döndürülen her sütunun tablo izninde açıkça listelenmiş olması gerekir. API adları, Dataverse'deki sütunun mantıksal adından farklı olduğundan, Arama Özelliklerini (ön ekli _ ve son ekli _value) kolayca kaçırabilirsiniz. ifadesini gördüğünüzde AttributePermissionIsMissing, her zaman bu sütunu tablo iznine ekleyin. API sorgusunu değiştirmeyin.

ne istediğiniz hakkında ayrıntılı olun

Belirsiz istekler belirsiz sonuçlar üretir. Düzen tercihleri, veri alanları ve davranış da dahil olmak üzere eklentiye tam olarak ihtiyacınız olanı söyleyin.

Aşağıdaki değer yerine Deneme
İşler için bir sayfa oluştur En üstte bir arama çubuğu, konum ve departman için filtre seçenekleri ve her iş için başlık, şirket, maaş aralığı ve yayınlanma tarihini gösteren bir kart ağı içeren bir iş ilanları sayfası oluşturun.
"Stili düzelt" İş kartları masaüstünde dikey şekilde dizilir. 768 pikselden daha geniş ekranlarda 16 piksel boşluk bırakarak üç sütunlu bir kılavuzda görüntülenmelerini sağla"
"Biraz veri ekleyin" "Gerçekçi başlıklar, 60k-$180k arasında maaş aralıkları ve son 30 gün içinde gönderilen tarihlerle dört departmana (Mühendislik, Pazarlama, Satış, İk) 20 örnek iş gönderisi ekleyin"
"API'yi ayarlama" "JobListings bileşenini cr_jobposting Dataverse tablosuna bağlayın. Sabit kodlu diziyi başlık, departman, maaş ve yayınlanma tarihini getiren gerçek bir API çağrısıyla değiştirin.
Oturum açma ekle Açık kayıt özelliğiyle Microsoft Entra Dış Kimlik ile oturum açmayı ve Google'ı ikinci sağlayıcı olarak ayarlayın. Bunları oturum açma sayfasında yatay bir satır olarak göster."

Görsel sorunlar için ekran görüntülerini kullanma

Site tarayıcıda doğru şekilde görünmediğinde, ekran görüntüsünü alın ve doğrudan konuşmaya yapıştırın veya bir dosya yolu sağlayın. Görsel bağlam, metinde tanımlanması zor olan düzen, aralık ve stil sorunlarını tanımlamaya yardımcı olur.

The header overlaps the hero section on mobile. Here's a screenshot:

[paste screenshot or provide path to screenshot file]

Fix the header so it doesn't overlap. It should be a fixed header with the content starting below it.

Küçük adımlarda yineleme

Sitenin tamamını tek bir istemle tanımlamak yerine artımlı olarak derleyin. Yapı ve düzen ile başlayın, ardından özellikleri birer birer ekleyin. Bu yaklaşım, her adımda gözden geçirme ve kursu düzeltme fırsatı sunar.

Step 1: /create-site → Get the basic scaffold and layout right
Step 2: "Add a hero section to the home page with a search bar"
Step 3: "Add a job listings page with filter and sort"
Step 4: "Add a job detail page that shows full description"
Step 5: /setup-datamodel → Create tables now that you know the data shape
Step 6: /integrate-webapi → Wire up real data

Tip

Her adımdan sonra tarayıcı önizlemesini denetleyin. Bir sorun varsa devam etmeden önce düzeltin. Bir bileşendeki sorunları çözmek, tüm sitedeki sorunları çözmekten daha kolaydır.

Onaylamadan önce bir açıklama isteyin

Özellikle izinler, veri modeli değişiklikleri veya kimlik doğrulama yapılandırması için önerilen bir değişiklik hakkında emin değilseniz, onaylamadan önce eklentiden ne yapmak istediğini ve nedenini açıklamasını isteyin.

Before you create the table permissions, explain what access each role will have and why. I want to understand the security implications.

Sorunlardan kurtulmak için becerileri bağımsız olarak çalıştırın

Bir beceri yarıda kalırsa baştan başlamanız gerekmez. Her beceri bağımsız olarak çalışır ve kaldığınız yerden devam edebilir. Örneğin, üçüncü tabloda başarısız olursa /integrate-webapi , yeniden çalıştırabilirsiniz ve tamamlanan çalışmayı algılar.

/integrate-webapi failed while processing the cr_applications table. Here's the error: [paste error]. Resume the integration from where it stopped.

İlgili içerik

  • Last updated on