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

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

  • Bu özellik, önizleme aşamasındadır.
  • Önizleme özellikleri, üretimde kullanıma yönelik değildir ve sınırlı işlevselliğe sahip olabilir. Bu özellikler, müşterilerin erken erişim elde etmesi ve geri bildirim sağlaması amacıyla resmi sürümden önce kullanıma sunulur.
  • Onaylamadan önce aracı tekliflerini gözden geçirme

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 ç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
Kimlik doğrulamayı ayarlama /setup-auth Oturum açma ve oturum kapatma işlevselliği ile rol tabanlı erişim kontrolü ekler
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

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

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.

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.

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

Oturum açma ve oturum kapatma işlevselliği eklemek için komutunu çalıştırın /setup-auth . Eklenti:

  1. Microsoft Entra ID akışı için sahteciliğe karşı belirteç yönetimi içeren bir kimlik doğrulama hizmeti oluşturur.
  2. Site düzeninizle tümleştirilmiş bir oturum açma/oturum kapatma kullanıcı arabirimi bileşeni oluşturur.
  3. Kullanıcının web rollerine bağlı olarak kullanıcı arabirimi öğelerini gösteren veya gizleyen rol tabanlı erişim kontrolü yardımcı programları ekler.
  4. Çerçevenizin kalıplarını (React hook'ları, Vue bileşenleri veya Angular servisleri) kullanır.

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.

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.

İ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

Veri Modeli Mimarı ve Web API İzinleri Mimarı aracıları değişiklik yapmadan önce teklifler sunar. Bu teklifleri dikkatle gözden geçirmek için zaman ayırı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. Bir teklifi ayarlamak, veriler eklendikten sonra sütunları yeniden adlandırmaktan çok 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.

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.

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