pac model

Polecenia do pracy z aplikacjami opartymi na modelach.

Commands

Command Description
pac model create Tworzy nową aplikację opartą na modelach.
pac model genpage download Pobieraj wygenerowane strony z aplikacji opartej na modelach.
pac model genpage generate-types Generuje definicje schematów TypeScript dla źródeł danych
pac model genpage list Lista wszystkich wygenerowanych stron w określonej aplikacji opartej na modelu.
pac model genpage transpile Transpiluje plik TypeScript z typami w czasie wykonywania do testowania i debugowania
pac model genpage upload Prześlij i opublikuj wygenerowaną stronę w aplikacji opartej na modelach.
pac model list Lista wszystkich aplikacji opartych na modelu w środowisku.
pac model list-languages Lista języków włączonych w środowisku Dataverse.
pac model list-tables Lista tabel Dataverse w środowisku połączonym.

pac model create

Tworzy nową aplikację opartą na modelach.

Wymagane parametry dla model create

--name -n

Nazwa wyświetlana nowej aplikacji opartej na modelu.

Parametry opcjonalne dla model create

--description -d

Opis nowej aplikacji opartej na modelu.

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--publish

Opublikuj aplikację po utworzeniu.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--solution

Unikatowa nazwa rozwiązania do dodania aplikacji. Domyślnie jest to aktywne rozwiązanie.

przykłady pac model create

W poniższych przykładach pokazano typowe sposoby użycia pac model create polecenia .

Tworzenie nowej aplikacji opartej na modelu w aktywnym środowisku

pac model create --name "Contoso Sales Hub"

Tworzenie aplikacji z opisem i dodawanie jej do rozwiązania, a następnie natychmiastowe publikowanie

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --solution "ContosoSales" \
  --publish

Tworzenie aplikacji w określonym środowisku przez podanie adresu URL środowiska

pac model create \
  --name "Contoso Sales Hub" \
  --description "Central hub for managing Contoso sales activities, accounts, and contacts." \
  --environment "https://contoso.crm.dynamics.com" \
  --solution "ContosoSales" \
  --publish

Tip

Użyj pac model list polecenia , aby sprawdzić, czy aplikacja została utworzona i pobrać jej identyfikator aplikacji do użycia z innymi poleceniami, takimi jak pac model genpage upload.

pac model genpage download

Pobieraj wygenerowane strony z aplikacji opartej na modelach.

Wymagane parametry dla model genpage download

--app-id

Identyfikator aplikacji opartej na modelu.

Parametry opcjonalne dla model genpage download

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--output-directory -o

Katalog do zapisywania ściągniętych stron. Domyślnie jest to bieżący katalog.

--page-id

Rozdzielona przecinkami lista identyfikatorów stron do ściągnięcia.

przykłady pac model genpage download

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage download polecenia .

Pobieranie pojedynczej strony generowania według identyfikatora strony do folderu lokalnego do edycji

pac model genpage download \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --output-directory ./pages/account-dashboard

Pobieranie wszystkich stron generujących w aplikacji jednocześnie

pac model genpage download \
  --app-id "Contoso Sales Hub" \
  --output-directory ./pages

Utwórz podkatalog o nazwie po identyfikatorze strony i zapisuje następujące pliki

./pages/account-dashboard/
  e5f6a7b8-abcd-ef01-2345-000000000010/
    page.tsx          ← TypeScript source code
    page.js           ← Transpiled JavaScript
    RuntimeTypes.ts   ← Dataverse type definitions
    config.json       ← Page metadata
    prompt.txt        ← Original generation prompt

pac model genpage generate-types

Generuje definicje schematów TypeScript dla źródeł danych

Wymagane parametry dla model genpage generate-types

--data-sources

Rozdzielona przecinkami lista używanych źródeł danych (np. "konto, potencjalnych klientów, kontakt").

Parametry opcjonalne dla model genpage generate-types

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--output-file -o

Ścieżka do zapisania wygenerowanego pliku schematu TypeScript (wartość domyślna to RuntimeTypes.ts)

przykłady pac model genpage generate-types

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage generate-types polecenia .

Generowanie typów TypeScript

Generuj account typy TypeScript dla tabel i i contact i i zapisuj je w pliku ./src/RuntimeTypes.ts:

pac model genpage generate-types \
  --data-sources "account,contact" \
  --output-file ./src/RuntimeTypes.ts

Generowanie typów dla pojedynczej tabeli w określonym katalogu wyjściowym

pac model genpage generate-types \
  --data-sources "opportunity" \
  --output-file ./pages/opportunity/RuntimeTypes.ts

Note

Zawsze uruchamiaj generate-types przed napisaniem kodu strony, który wysyła zapytania do tabel usługi Dataverse. Wygenerowany plik zawiera silnie typizowane nazwy kolumn, pola klucza obcego i wartości wyliczenia dla każdej tabeli. Poleganie na wygenerowanych typach uniemożliwia błędy środowiska uruchomieniowego spowodowane błędami pisowni lub nieistniejącą nazwami kolumn.

pac model genpage list

Lista wszystkich wygenerowanych stron w określonej aplikacji opartej na modelu.

Wymagane parametry dla model genpage list

--app-id

Identyfikator aplikacji opartej na modelu.

Parametry opcjonalne dla model genpage list

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

przykłady pac model genpage list

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage list polecenia .

Wyświetlanie listy stron przy użyciu identyfikatora aplikacji

Wyświetl listę wszystkich stron generujących w aplikacji Contoso Sales Hub przy użyciu jej identyfikatora aplikacji:

pac model genpage list --app-id "a1b2c3d4-1234-5678-abcd-000000000001"

Wyświetlanie listy stron przy użyciu nazwy aplikacji

Wyświetl strony generowania według nazwy aplikacji (interfejs wiersza polecenia automatycznie wyszukuje identyfikator aplikacji):

pac model genpage list --app-id "Contoso Sales Hub"

pac model Dane wyjściowe przykładu usługi Genpage

Found 2 generated page(s):

  Account Dashboard
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000010
    Description: Created: 2026-01-15T10:22:00Z

  Opportunity Tracker
    Page ID: e5f6a7b8-abcd-ef01-2345-000000000011
    Description: Created: 2026-02-03T14:05:00Z

pac model genpage transpile

Transpiluje plik TypeScript z typami w czasie wykonywania do testowania i debugowania

Wymagane parametry dla model genpage transpile

--code-file

Ścieżka do pliku zawierającego kod strony.

Parametry opcjonalne dla model genpage transpile

--data-sources

Rozdzielona przecinkami lista używanych źródeł danych (np. "konto, potencjalnych klientów, kontakt").

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--output-file

Ścieżka do zapisania transpilowanych danych wyjściowych języka JavaScript (domyślnie na [code-file].compiled.js)

pac model genpage upload

Prześlij i opublikuj wygenerowaną stronę w aplikacji opartej na modelach.

Wymagane parametry dla model genpage upload

--app-id

Identyfikator aplikacji opartej na modelu.

--code-file

Ścieżka do pliku zawierającego kod strony.

Parametry opcjonalne dla model genpage upload

--add-to-sitemap

Dodaj stronę do nawigacji mapy witryny aplikacji.

Ten parametr nie wymaga żadnej wartości. Jest to przełącznik.

--agent-message

Komunikat odpowiedzi agenta.

--agent-message-file

Ścieżka do pliku zawierającego komunikat odpowiedzi agenta.

--compiled-code-file

Ścieżka do pliku zawierającego skompilowany kod JavaScript. Jeśli nie zostanie podany, język TypeScript zostanie automatycznie transpilowany do języka JavaScript.

--data-sources

Rozdzielona przecinkami lista używanych źródeł danych (np. "konto, potencjalnych klientów, kontakt").

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--model

Model AI używany do generowania strony (np. "claude-3-5-sonnet-20241022").

--name -n

Nazwa strony.

--page-id

Identyfikator strony do zaktualizowania. Jeśli nie zostanie podana, zostanie utworzona nowa strona.

--prompt

Monit użytkownika, który wygenerował tę stronę.

--prompt-file

Ścieżka do pliku zawierającego monit użytkownika, który wygenerował tę stronę.

przykłady pac model genpage upload

W poniższych przykładach pokazano typowe sposoby użycia pac model genpage upload polecenia .

Publikowanie nowej strony generowania

Opublikuj nową stronę generowania w aplikacji Contoso Sales Hub i dodaj ją do mapy witryny aplikacji:

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --code-file ./pages/account-dashboard.tsx \
  --name "Account Dashboard" \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Created account dashboard with card grid, revenue chart, and contact list. Uses account and contact tables." \
  --add-to-sitemap

Aktualizowanie istniejącej strony generowania

Zaktualizuj istniejącą stronę generowania, podając jej identyfikator strony (pomijaj --add-to-sitemap , aby uniknąć tworzenia zduplikowanego wpisu mapy witryny):

pac model genpage upload \
  --app-id "a1b2c3d4-1234-5678-abcd-000000000001" \
  --page-id "e5f6a7b8-abcd-ef01-2345-000000000010" \
  --code-file ./pages/account-dashboard.tsx \
  --data-sources "account,contact" \
  --prompt "A dashboard showing Account records as interactive cards with contact count and revenue metrics." \
  --model "claude-sonnet-4-6" \
  --agent-message "Updated card layout to use a two-column grid; added revenue sparkline chart."

Publikowanie strony korzystającej z pozornych danych

Publikowanie strony korzystającej z pozornych danych (bez tabel Usługi Dataverse — pomijanie --data-sources):

pac model genpage upload \
  --app-id "Contoso Sales Hub" \
  --code-file ./pages/welcome-screen.tsx \
  --name "Welcome" \
  --prompt "A branded welcome screen with Contoso logo, quick-action tiles, and a news feed placeholder." \
  --model "claude-sonnet-4-6" \
  --agent-message "Welcome page with static mock data. No Dataverse queries." \
  --add-to-sitemap

Tip

Parametr --app-id akceptuje identyfikator GUID aplikacji lub jego nazwę wyświetlaną. Jeśli wiele aplikacji ma taką samą nazwę wyświetlaną, użyj identyfikatora GUID, aby uniknąć niejednoznaczności. Uruchom polecenie pac model list , aby wyszukać identyfikatory aplikacji.

pac model genpage upload krótki przewodnik dotyczący parametrów

Parameter Required Description
--app-id Yes Identyfikator GUID aplikacji lub nazwa wyświetlana. Uruchom polecenie pac model list , aby go znaleźć.
--code-file Yes Ścieżka do pliku źródłowego .tsx do wdrożenia.
--name Tylko nowe strony Nazwa wyświetlana wyświetlana na mapie witryny aplikacji.
--page-id Updates only Identyfikator GUID istniejącej strony do zastąpienia.
--data-sources Dataverse pages Rozdzielona przecinkami lista nazw logicznych tabeli Dataverse (na przykład "account,contact").
--prompt Recommended Podsumowanie języka naturalnego tego, co robi strona. Przechowywane w kontekście rewitalizacji.
--model Recommended Identyfikator modelu używany do generowania strony (na przykład claude-sonnet-4-6).
--agent-message Recommended Opis tego, co zostało skompilowane lub zmienione. Przechowywane jako historia zmian.
--add-to-sitemap Tylko nowe strony Automatycznie dodaje stronę do nawigacji aplikacji. Pomiń podczas aktualizowania.

pac model list

Lista wszystkich aplikacji opartych na modelu w środowisku.

Parametry opcjonalne dla model list

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

Przykład: pac model list

Wyświetl listę wszystkich aplikacji opartych na modelu w aktualnie aktywnym środowisku:

pac model list

Sample output:

Found 3 model-driven app(s):

  Contoso Sales Hub
    App ID: a1b2c3d4-1234-5678-abcd-000000000001
    Unique Name: contoso_SalesHub

  Contoso Field Service
    App ID: a1b2c3d4-1234-5678-abcd-000000000002
    Unique Name: contoso_FieldService

  Contoso Customer Portal
    App ID: a1b2c3d4-1234-5678-abcd-000000000003
    Unique Name: contoso_CustomerPortal

pac model list-languages

Lista języków włączonych w środowisku Dataverse.

Parametry opcjonalne dla model list-languages

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

pac model list-tables

Lista tabel Dataverse w środowisku połączonym.

Parametry opcjonalne dla model list-tables

--environment -env

Określa docelowy element Dataverse. Wartość może być identyfikatorem GUID lub bezwzględnym adresem URL https. Jeśli nie zostanie określony, zostanie użyta aktywna organizacja wybrana dla bieżącego profilu uwierzytelniania.

--search -s

Lista nazw oddzielonych przecinkami do wyszukiwania (odpowiada nazwie logicznej, nazwie schematu lub nazwie wyświetlanej).

--type -t

Filtruj według typu tabeli: 'custom', 'standard' lub 'all' (domyślnie: all).

See also

Microsoft Power Platform grupy poleceń interfejsu wiersza polecenia
omówienie interfejsu wiersza polecenia Microsoft Power Platform

  • Last updated on