Bắt đầu với plugin Power Pages cho GitHub Copilot CLI và Claude Code (xem trước)

Plugin Power Pages cho GitHub Copilot CLI và Claude Code cung cấp quy trình làm việc có sự hỗ trợ của AI để tạo, triển khai và quản lý các trang web ứng dụng một trang (SPA) hiện đại trên Power Pages. Thay vì xây dựng các dự án theo cách thủ công, viết mã API nguyên mẫu và định cấu hình quyền, hãy mô tả những gì bạn muốn bằng ngôn ngữ tự nhiên và trình bổ trợ sẽ xử lý việc triển khai.

Plugin hỗ trợ toàn bộ vòng đời phát triển trang web thông qua các kỹ năng đàm thoại, từ giàn giáo một trang web mới đến triển khai nó, thiết lập mô hình dữ liệu Dataverse và đặt cấu hình xác thực.

Quan trọng

  • Tính năng này đang ở giai đoạn xem trước.
  • Các tính năng xem trước không được dùng cho sản xuất và có thể có chức năng bị hạn chế. Những tính năng này khả dụng trước khi có bản phát hành chính thức để khách hàng có thể truy cập sớm và cung cấp phản hồi.
  • Xem xét đề xuất của đại lý trước khi phê duyệt

Điều kiện tiên quyết

Trước khi bắt đầu, hãy xác minh rằng bạn có phần mềm và quyền cần thiết.

Yêu cầu phần mềm

Cấu phần Phiên bản tối thiểu Thông tin thêm
Node.js 18.0 trở lên Tải xuống Node.js
Power Platform CLI (PAC CLI) 2.6.3 trở lên (bắt buộc đối với logic máy chủ) Cài đặt PAC CLI
Azure CLI Mới nhất Cài đặt Azure CLI
GitHub Copilot CLI hoặc Mã Claude Mới nhất GitHub Copilot CLI hoặc Mã Claude
Tiện ích mở rộng Visual Studio Code và Power Platform Tools (Tùy chọn) Mới nhất Tải xuống VS Code và cài đặt công cụ Power Platform

Bạn cũng cần:

  • Môi trường Power Platform đã bật Power Pages.
  • Phiên PAC CLI được xác thực được kết nối với môi trường mục tiêu của bạn. Chạy pac auth create nếu bạn chưa kết nối.
  • Phiên Azure CLI đã đăng nhập vào cùng một đối tượng thuê. Chạy az login để xác thực.

Xác minh xác thực:

Xác minh bạn đã được xác thực bằng cách sử dụng pac auth list lệnh.

pac auth list           # Should show authenticated profile

Nếu bạn chưa được xác thực, hãy chạy lệnh sau:

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

Mẹo

Để lấy URL phiên bản, hãy truy cập trang chủ Power Pages, chọn biểu tượng Cài đặt ở góc trên bên phải, sau đó chọn Chi tiết phiên.

Cài đặt plugin

Cài đặt plugin Power Pages từ thị trường. Nếu bạn sử dụng GitHub Copilot CLI, hãy xem tài liệu về tiện ích CLI Copilot để biết các bước cài đặt tương đương. Các lệnh sau sử dụng cú pháp Claude Code.

Chạy trình cài đặt để thiết lập tất cả các plugin đã bật tính năng tự động cập nhật:

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

Trình cài đặt tự động:

  • Cài đặt pac CLI nếu nó chưa được cài đặt.
  • Phát hiện các công cụ có sẵn, chẳng hạn như Claude Code và GitHub Copilot CLI.
  • Đăng ký thị trường plugin và cài đặt tất cả các plugin được liệt kê.
  • Cho phép tự động cập nhật để plugin luôn cập nhật.

Sau khi cài đặt, hãy khởi động lại Claude Code hoặc GitHub Copilot CLI để truy cập các kỹ năng của plugin dưới dạng lệnh gạch chéo trong phiên tác nhân của bạn.

Cài đặt từ thị trường

  1. Mở Claude Code trong thiết bị đầu cuối của bạn.

  2. Thêm Microsoft marketplace:

    /plugin marketplace add microsoft/power-platform-skills

  3. Cài đặt plugin Power Pages:

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

Sau khi bạn cài đặt plugin, hãy khởi động lại Claude Code hoặc GitHub Copilot CLI để truy cập các kỹ năng của plugin dưới dạng lệnh gạch chéo trong phiên tác nhân của bạn.

Mẹo

Để tự động nhận thông tin cập nhật về thị trường và kỹ năng, hãy bật tính năng tự động cập nhật. Sử dụng /plugin lệnh, đi tới Thị trường, chọn thị trường và bật tính năng tự động cập nhật.

Tổng quan về kỹ năng

Plugin cung cấp các kỹ năng bao gồm toàn bộ vòng đời của site Power Pages. Gọi từng kỹ năng bằng cách trò chuyện, dưới dạng lệnh gạch chéo hoặc bằng cách mô tả những gì bạn muốn to do.

Kỹ năng Lệnh Chức năng
Tạo trang web /create-site Xây dựng một trang web, áp dụng hướng thiết kế của bạn và xây dựng các trang và thành phần
Triển khai trang web /deploy-site Xây dựng dự án và tải lên Power Pages bằng cách sử dụng PAC CLI
Kích hoạt trang web /activate-site Cung cấp bản ghi trang web và gán URL công khai
Thiết lập mô hình dữ liệu /setup-datamodel Tạo bảng, cột và mối quan hệ Dataverse
Thêm dữ liệu mẫu (tùy chọn) /add-sample-data Điền bảng Dataverse với các bản ghi thử nghiệm thực tế
Tích hợp API Web /integrate-webapi Tạo mã ứng dụng khách API, dịch vụ và quyền bảng được nhập
Thiết lập phương thức xác thực /setup-auth Thêm chức năng đăng nhập và đăng xuất cũng như access control dựa trên vai trò
Tạo vai trò web /create-webroles Tạo tệp YAML vai trò web để quản lý access của người dùng
Thêm logic máy chủ /add-server-logic Tạo các điểm cuối JavaScript phía máy chủ an toàn để xác thực, gọi API bên ngoài, quản lý bí mật và hoạt động dữ liệu
Thêm luồng đám mây /add-cloud-flow Tích hợp các dòng đám mây Power Automate hiện có vào trang web của bạn cho quy trình phê duyệt, thông báo và tự động hóa theo lịch trình
Tích hợp phụ trợ /integrate-backend Phân tích nguyên mẫu của bạn, xác định cách tiếp cận phù hợp (API Web, Logic máy chủ hoặc luồng đám mây) cho từng tính năng và điều phối trình tự xây dựng hoàn chỉnh
Thêm SEO /add-seo Tạo thẻ robots.txt, sitemap.xmlvà meta

Quy trình làm việc điển hình

Quy trình làm việc từ đầu đến cuối phổ biến tuân theo trình tự sau:

  1. /create-site : Giàn giáo, thiết kế và xây dựng trang
  2. /deploy-site : Tải lên môi trường Power Pages của bạn
  3. /activate-site : Thiết lập URL công khai
  4. /setup-datamodel : Tạo bảng Dataverse
  5. /add-sample-data : Điền bảng với các bản ghi thử nghiệm
  6. /integrate-webapi : Tạo mã ứng dụng API và định cấu hình quyền
  7. /create-webroles : Xác định vai trò access
  8. /setup-auth : Thêm giao diện người dùng đăng nhập, đăng xuất và dựa trên vai trò
  9. /add-server-logic : Thêm điểm cuối phía máy chủ an toàn
  10. /add-cloud-flow : Tích hợp các luồng Power Automate hiện có
  11. /add-seo : Tối ưu hóa công cụ tìm kiếm
  12. /deploy-site : Đẩy các thay đổi cuối cùng trực tiếp

Mẹo

  • Bạn không cần phải làm theo thứ tự chính xác này. Mỗi kỹ năng kiểm tra các điều kiện tiên quyết của riêng nó và cho bạn biết nếu thiếu điều gì đó. Ví dụ: bạn có thể chạy /setup-auth trước nếu /integrate-webapi trang web của bạn cần xác thực trước.
  • Nếu bạn không chắc nên sử dụng phương pháp nào cho từng tính năng, hãy chạy /integrate-backend thay vì các bước từ 4 đến 10 riêng lẻ. Nó phân tích nguyên mẫu của bạn, xác định xem mỗi tính năng cần API Web, Logic máy chủ hay luồng đám mây và điều phối các kỹ năng theo đúng thứ tự.

Xây dựng trang web Power Pages của bạn

Hướng dẫn này bao gồm toàn bộ vòng đời của việc xây dựng trang web Power Pages bằng plugin, từ giàn giáo đến triển khai. Mỗi bước mô tả những gì bạn nói và những gì plugin làm để phản hồi.

Bước 1: Tạo trang web của bạn

Mô tả trang web bạn muốn bằng ngôn ngữ tự nhiên: mục đích gì, trang cần và bất kỳ tùy chọn thiết kế nào như bảng màu, kiểu bố cục hoặc phông chữ. Chạy /create-site hoặc chỉ mô tả trang web của bạn và plugin nhận ra ý định.

Nếu bạn không chỉ định một framework, plugin sẽ yêu cầu bạn chọn một framework (React, Vue, Angular hoặc Astro), thì:

  1. Cấu trúc project từ một mẫu và áp dụng tên trang web, màu sắc và mã thông báo thiết kế của bạn.
  2. Cài đặt các phần phụ thuộc, khởi động máy chủ phát triển và mở bản xem trước trình duyệt trực tiếp.
  3. Xây dựng từng trang, thành phần và tuyến đường bạn yêu cầu với các hình ảnh có liên quan.
  4. Tạo các cam kết git tại các mốc quan trọng để bạn có lịch sử khôi phục tích hợp.

Bước 2: Triển khai trang web của bạn

Chạy /deploy-site để tải trang web của bạn lên Power Pages. Plugin:

  1. Xác minh rằng PAC CLI đã được cài đặt và phiên xác thực của bạn đang hoạt động.
  2. Xác nhận môi trường mục tiêu với bạn trước khi tiếp tục.
  3. Chạy bản dựng chính thức và tải kết quả đã biên dịch lên.
  4. Tạo thư mục triển khai artifacts nếu chưa tồn tại.

Lưu ý

Nếu môi trường của bạn chặn một số tệp đính kèm nhất định, plugin sẽ phát hiện sự cố và cung cấp hướng dẫn để giải quyết.

Bước 3: Kích hoạt trang web của bạn

Chạy /activate-site để làm cho trang web có thể truy cập công khai. Plugin:

  1. Đề xuất tên miền phụ dựa trên tên trang web của bạn và cho phép bạn tùy chỉnh tên miền đó.
  2. Cung cấp bản ghi trang web thông qua API Power Platform.
  3. Thăm dò ý kiến cho đến khi trang web hoạt động và trả về URL công khai.

Tại thời điểm này, bạn có một trang web đang hoạt động tại một URL công khai. Các bước còn lại thêm dữ liệu, xác thực và SEO. Bỏ qua bất kỳ bước nào không áp dụng cho trang web của bạn.

Bước 4: Thiết lập mô hình dữ liệu của bạn

Chạy /setup-datamodel để tạo bảng Dataverse mà trang web của bạn cần. Nếu bạn đã có sơ đồ ER hoặc lược đồ cụ thể, hãy cung cấp trực tiếp thay vì yêu cầu tổng đài viên phân tích mã của bạn.

Plugin tạo ra một tác nhân Data Model Architect :

  1. Phân tích mã trang web của bạn để xác định dữ liệu mà các trang và thành phần yêu cầu.
  2. Truy vấn môi trường Dataverse của bạn cho các bảng hiện có để tránh trùng lặp.
  3. Đề xuất mô hình dữ liệu với bảng, cột, kiểu dữ liệu và mối quan hệ, được trực quan hóa dưới dạng sơ đồ ER.

Bạn xem xét và phê duyệt đề xuất. Plugin không tạo bất cứ thứ gì cho đến khi bạn xác nhận. Sau khi được phê duyệt, trình bổ trợ sẽ tạo các bảng và cột thông qua các lệnh gọi API và lưu tệp kê khai mà Bước 5 và 6 sử dụng.

Bước 5: Thêm dữ liệu mẫu (Tùy chọn)

Chạy /add-sample-data để điền các bản ghi thử nghiệm vào bảng của bạn. Bước này yêu cầu mô hình dữ liệu từ Bước 4.

Plugin thực hiện các hành động sau:

  1. Đọc tệp kê khai để hiểu bảng, cột và mối quan hệ của bạn.
  2. Tạo các giá trị phù hợp theo ngữ cảnh cho từng loại cột, chẳng hạn như email thực tế, ngày hợp lý và số tiền được định dạng.
  3. Chèn các bản ghi theo thứ tự phụ thuộc (bảng mẹ trước bảng con) và tự động làm mới mã thông báo xác thực trong quá trình chèn hàng loạt.

Bước 6: Tích hợp với API Web Dataverse

Chạy /integrate-webapi để thay thế dữ liệu mô phỏng bằng truy vấn Dataverse trực tiếp. Bước này yêu cầu mô hình dữ liệu từ Bước 4.

Plugin thực hiện các hành động sau:

  1. Quét cơ sở mã của bạn để tìm các thành phần sử dụng dữ liệu giả, lệnh gọi tìm nạp trình giữ chỗ hoặc mảng được mã hóa cứng. Nó ánh xạ các thành phần này với bảng Dataverse của bạn.
  2. Tạo tác nhân Tích hợp API Web cho mỗi bảng tạo ra:
    • Ứng dụng API được chia sẻ với logic thử lại và quản lý mã thông báo chống giả mạo.
    • Loại thực thể TypeScript và trình ánh xạ miền.
    • Lớp dịch vụ CRUD.
    • Các mẫu dành riêng cho framework, chẳng hạn như React hooks, các thành phần kết hợp Vue hoặc các dịch vụ Angular.
  3. Tạo ra một tác nhân Permissions Architect đề xuất quyền bảng và cài đặt site.

Bạn xem xét và phê duyệt đề xuất quyền. Plugin không tạo bất kỳ tệp cấu hình nào cho đến khi bạn xác nhận.

Bước 7: Tạo vai trò web

Chạy /create-webroles để xác định vai trò access người dùng. Plugin:

  1. Truy vấn môi trường của bạn cho các vai trò web hiện có để tránh trùng lặp.
  2. Tạo định nghĩa vai trò với mã định danh duy nhất.
  3. Thực thi rằng mỗi trang web có tối đa một vai trò ẩn danh và một vai trò được xác thực.

Bước 8: Thiết lập xác thực

Chạy /setup-auth để thêm chức năng đăng nhập và đăng xuất. Plugin:

  1. Tạo dịch vụ xác thực cho luồng Microsoft Entra ID với tính năng quản lý mã thông báo chống giả mạo.
  2. Tạo thành phần giao diện người dùng đăng nhập/đăng xuất được tích hợp với bố cục trang web của bạn.
  3. Thêm các tiện ích access control dựa trên vai trò hiển thị hoặc ẩn các thành phần giao diện người dùng dựa trên vai trò web của người dùng.
  4. Sử dụng các mẫu của framework xuyên suốt (React hooks, thành phần kết hợp Vue hoặc dịch vụ Angular).

Bước 9: Thêm logic máy chủ

Chạy /add-server-logic để thêm điểm cuối phía máy chủ an toàn vào trang web của bạn. Sử dụng Logic máy chủ khi trang web của bạn cần logic không thể chạy trong trình duyệt, chẳng hạn như lệnh gọi API bên ngoài, xác thực phía máy chủ, quản lý bí mật hoặc hoạt động dữ liệu giữa các thực thể.

Quan trọng

Hỗ trợ logic máy chủ yêu cầu PAC CLI phiên bản 2.6.3 trở lên. Sử dụng tập lệnh cài đặt nhanh để cập nhật lên phiên bản mới nhất.

Mô tả những gì bạn cần bằng ngôn ngữ đơn giản và plugin:

  1. Tạo ra một tác nhân Kiến trúc sư logic máy chủ phân tích trường hợp sử dụng của bạn và phân loại độ phức tạp của nó.
  2. Đề xuất thiết kế điểm cuối, cấu hình bảo mật và mọi quyền bảng bắt buộc để bạn xem xét.
  3. Sau khi bạn phê duyệt, hãy tạo điểm cuối JavaScript phía máy chủ tại /_api/serverlogics/<name>.
  4. Tạo một dịch vụ phía máy khách được nhập để gọi điểm cuối từ các thành phần của bạn.
  5. Cập nhật các thành phần của bạn để gọi dịch vụ mới.
  6. Đặt cấu hình gán vai trò web và quyền bảng cho điểm cuối.

Bạn xem xét và phê duyệt đề xuất. Không có mã nào được tạo cho đến khi bạn xác nhận.

Các trường hợp sử dụng phổ biến:

Lưu ý

Chạy /add-server-logic một lần cho mỗi trường hợp sử dụng. Ví dụ: nếu trang web của bạn cần cả điểm cuối xác thực khoảng không quảng cáo và điểm cuối tìm kiếm toàn cầu, hãy chạy kỹ năng này hai lần.

Bước 10: Tích hợp luồng đám mây

Chạy /add-cloud-flow để tích hợp các luồng đám mây Power Automate hiện có vào trang web của bạn. Kỹ năng này kết nối site Power Pages của bạn với các dòng mà bạn đã tạo trong Power Automate. Nó không tạo ra các luồng đám mây mới.

Plugin:

  1. Đăng ký luồng đám mây hiện có với trang web của bạn.
  2. Tạo mã phía máy khách để kích hoạt quy trình từ các trang của bạn.
  3. Xử lý trạng thái quy trình làm việc không đồng bộ và các mẫu gọi lại.
  4. Kết nối trao đổi dữ liệu giữa trang và luồng.

Sử dụng /add-cloud-flow cho quy trình phê duyệt, thông báo qua email, công việc đã lên lịch và tự động hóa theo hướng sự kiện được Power Automate xử lý tốt hơn so với điểm cuối phía máy chủ.

Thay thế: Sử dụng /integrate-backend để lập kế hoạch cho lớp dịch vụ đầy đủ

Nếu bạn không chắc tính năng nào cần API Web, Logic máy chủ hoặc luồng đám mây, hãy chạy /integrate-backend thay vì chạy thủ công các bước từ 4 đến 10. Kỹ năng này hoạt động như một người điều phối:

  1. Phân tích nguyên mẫu của bạn để xác định tất cả các tính năng cần lớp dịch vụ.
  2. Phân loại từng tính năng thành cách tiếp cận phù hợp: API Web cho CRUD tiêu chuẩn, Logic máy chủ để xác thực phía máy chủ và API bên ngoài hoặc luồng đám mây cho quy trình phê duyệt và tự động hóa.
  3. Đề xuất một kế hoạch thực thi theo trình tự với tất cả các kỹ năng, phần phụ thuộc và cấu hình.
  4. Sau khi bạn phê duyệt, hãy sắp xếp các kỹ năng theo đúng thứ tự.

Kế hoạch này là liên tục, có thể tiếp tục và có thể chỉnh sửa. Dừng lại sau bất kỳ bước nào để xem lại mã đã tạo hoặc kiểm tra trang web và tiếp tục nơi bạn đã dừng lại bằng cách chạy /integrate-backend lại.

Bước 11: Thêm SEO

Chạy /add-seo để tối ưu hóa trang web của bạn cho các công cụ tìm kiếm. Plugin:

  1. Khám phá các tuyến từ cấu hình bộ định tuyến của khung của bạn.
  2. Tạo chỉ thị của công cụ tìm kiếm và sơ đồ trang web cho tất cả các tuyến đường được phát hiện.
  3. Thêm thẻ meta: chế độ xem, bộ ký tự, mô tả, Open Graph, Twitter Card và tham chiếu biểu tượng yêu thích.

Bước 12: Triển khai trang web cuối cùng

Nếu bạn thực hiện bất kỳ bước tùy chọn nào, hãy chạy /deploy-site lại để đẩy các thay đổi trực tiếp. Plugin chạy bản dựng sản xuất và tải trang web lên cùng với tất cả các tạo tác triển khai (quyền bảng, cài đặt trang web, vai trò web, tệp logic máy chủ) lên môi trường Power Pages của bạn.

Xác minh trang web của bạn

Sau khi bạn hoàn thành các kỹ năng, hãy xác minh trang web Power Pages của bạn hoạt động chính xác.

  1. Truy cập Power Pages.
  2. Tìm trang web của bạn trong danh sách Trang web đang hoạt động .
  3. Xem trước trang web của bạn trên máy tính bằng cách sử dụng tùy chọn Xem trước .
  4. Kiểm tra chức năng.

Mẹo và phương pháp hay nhất

Các mẹo sau đây giúp bạn tận dụng tối đa plugin và tác nhân mã hóa AI khi xây dựng trang web Power Pages.

Xem đầu ra thiết bị đầu cuối để tìm các công cụ bị thiếu trong lần chạy đầu tiên

Plugin cung cấp các kỹ năng và quy trình làm việc, nhưng tác nhân mã hóa AI - GitHub Copilot CLI hoặc Claude Code - thực thi các lệnh thực tế trên máy của bạn. Khi bạn sử dụng các công cụ này lần đầu tiên, hãy theo dõi kỹ đầu ra của thiết bị đầu cuối. Tác nhân mã hóa AI chạy các lệnh và tập lệnh đằng sau hậu trường và một số lệnh này phụ thuộc vào các công cụ có thể không được cài đặt trên máy của bạn. Nếu một bước không thành công, đầu ra của thiết bị đầu cuối thường hiển thị công cụ hoặc lệnh mà nó không thể tìm thấy.

Nếu bạn thấy lỗi như command not found hoặc is not recognized, hãy cài đặt công cụ bị thiếu và kích hoạt lại quy trình làm việc. Tác nhân mã hóa AI tiếp tục nơi nó đã dừng lại sau khi công cụ có sẵn.

Xem xét đề xuất của đại lý trước khi phê duyệt

Các tác nhân Kiến trúc sư mô hình dữ liệu và Kiến trúc sư quyền API web trình bày các đề xuất trước khi thực hiện thay đổi. Hãy dành thời gian để xem xét các đề xuất này một cách cẩn thận.

  • Đề xuất mô hình dữ liệu: Kiểm tra xem tên bảng, loại cột và mối quan hệ có phù hợp với yêu cầu kinh doanh của bạn hay không. Điều chỉnh đề xuất dễ dàng hơn nhiều so với đổi tên cột sau khi dữ liệu đã được chèn vào.
  • Đề xuất quyền: Xác minh rằng mỗi vai trò có cấp độ access chính xác (tạo, đọc, cập nhật, xóa) cho từng bảng. Quyền bảng quá dễ dãi là một rủi ro bảo mật phổ biến.

Dán lỗi trực tiếp với ngữ cảnh

Khi có điều gì đó không thành công, cho dù đó là lỗi xây dựng, lỗi triển khai hay ngoại lệ thời gian chạy trong trình duyệt, hãy sao chép toàn bộ đầu ra lỗi. Dán nó cùng với mô tả ngắn gọn về những gì bạn đang làm. Bạn cung cấp càng nhiều ngữ cảnh, việc khắc phục càng nhanh.

Ví dụ: Lỗi bản dựng

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>

Mẹo

Bao gồm tên tệp, lệnh bạn đã chạy và những gì bạn mong đợi sẽ xảy ra. Plugin sử dụng ngữ cảnh này để xác định vị trí sự cố và áp dụng bản sửa lỗi có mục tiêu thay vì đoán.

Chia sẻ lỗi API Web với URL yêu cầu đầy đủ

Một sự cố phổ biến sau khi triển khai là lỗi 403 từ API Web Power Pages khi một cột không được bật để truy cập API. Khi bạn gặp lỗi này, hãy dán URL API đầy đủ và phản hồi lỗi JSON hoàn chỉnh. Thông báo lỗi cho bạn biết chính xác bảng và cột nào cần được sửa và plugin có thể cập nhật YAML quyền bảng và cài đặt trang web cho bạn.

Ví dụ: Cột không được bật cho API Web (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"
    }
  }
}

Lỗi này (AttributePermissionIsMissing) có nghĩa là cột _crd50_propertyid_value tra cứu tồn tại trong bảng Dataverse nhưng không được liệt kê trong cấu hình quyền bảng cho API Web. Plugin giải quyết lỗi này bằng cách thêm cột bị thiếu vào quyền bảng YAML và .powerpages-site/table-permissions/ triển khai lại.

Lưu ý

API Web Power Pages yêu cầu mọi cột được trả về bởi lệnh gọi API phải được liệt kê rõ ràng trong quyền bảng. Các thuộc tính tra cứu (có tiền tố và _ hậu tố với _value) rất dễ bị bỏ sót vì tên API của chúng khác với tên logic của cột trong Dataverse. Khi bạn thấy AttributePermissionIsMissing, hãy luôn thêm cột đó vào quyền bảng. Không thay đổi truy vấn API.

Hãy cụ thể về những gì bạn muốn

Các yêu cầu mơ hồ tạo ra kết quả mơ hồ. Cho plugin biết chính xác những gì bạn cần, bao gồm tùy chọn bố cục, trường dữ liệu và hành vi.

Thay vì Dùng thử
"Tạo trang cho việc làm" "Tạo trang danh sách việc làm với thanh tìm kiếm ở trên cùng, lọc chip cho vị trí và bộ phận và lưới thẻ hiển thị chức danh, công ty, mức lương và ngày đăng cho mỗi công việc"
"Sửa kiểu dáng" "Các thẻ công việc xếp chồng lên nhau theo chiều dọc trên máy tính để bàn. Làm cho chúng hiển thị trong lưới ba cột với khoảng cách 16px trên màn hình rộng hơn 768px"
"Thêm một số dữ liệu" "Thêm 20 tin tuyển dụng mẫu trên bốn bộ phận (Kỹ thuật, Tiếp thị, Bán hàng, Nhân sự) với các chức danh thực tế, mức lương dao động từ 60 nghìn đô la đến 180 nghìn đô la và ngày đăng trong 30 ngày qua"
"Thiết lập API" "Kết nối thành phần JobListings với bảng cr_jobposting Dataverse. Thay thế mảng được mã hóa cứng bằng một lệnh gọi API thực lấy chức danh, bộ phận, mức lương và ngày đăng"

Sử dụng ảnh chụp màn hình cho các vấn đề trực quan

Khi trang web không hiển thị đúng trong trình duyệt, hãy chụp ảnh màn hình và dán trực tiếp vào cuộc trò chuyện hoặc cung cấp đường dẫn tệp. Ngữ cảnh trực quan giúp xác định các vấn đề về bố cục, khoảng cách và kiểu dáng khó mô tả trong văn bản.

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.

Lặp lại trong các bước nhỏ

Thay vì mô tả toàn bộ trang web trong một lời nhắc, hãy xây dựng dần dần. Bắt đầu với cấu trúc và bố cục, sau đó thêm từng tính năng một. Cách tiếp cận này cho bạn cơ hội xem xét và sửa chữa khóa học ở mỗi bước.

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

Mẹo

Sau mỗi bước, hãy kiểm tra bản xem trước của trình duyệt. Nếu có điều gì đó không đúng, hãy sửa nó trước khi tiếp tục. Việc khắc phục sự cố trong một thành phần dễ dàng hơn là gỡ rối các vấn đề trên toàn bộ trang web.

Yêu cầu giải thích trước khi phê duyệt

Khi bạn không chắc chắn về một thay đổi được đề xuất, đặc biệt là đối với quyền, sửa đổi mô hình dữ liệu hoặc cấu hình xác thực, hãy yêu cầu plugin giải thích những gì nó dự định làm do và lý do trước khi phê duyệt.

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

Chạy các kỹ năng độc lập để phục hồi sau các vấn đề

Nếu một kỹ năng thất bại giữa chừng, bạn không cần phải bắt đầu lại. Mỗi kỹ năng chạy độc lập và có thể tiếp tục từ nơi nó đã dừng lại. Ví dụ: nếu /integrate-webapi không thành công trên bảng thứ ba, bạn có thể chạy lại nó và nó phát hiện công việc đã hoàn thành.

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

Nội dung liên quan

  • Last updated on