pac model

Команды для работы с приложениями, управляемыми моделями.

Commands

Command Description
pac model create Создаёт новое приложение, основанное на моделях.
pac model genpage download Извлекайте сгенерированные страницы из приложения, управляемого моделями.
pac model genpage generate-types Генерирует определения схем TypeScript для источников данных
pac model genpage list Перечисляет все сгенерированные страницы в указанном приложении, управляемом моделями.
pac model genpage transpile Транспилирует файл TypeScript с типами выполнения для тестирования и отладки
pac model genpage upload Загрузите и опубликуйте сгенерированную страницу в приложении, управляемом моделями.
pac model list Перечисляет все приложения, управляемые моделями, в среде.
pac model list-languages Перечисляет поддерживаемые языки в среде Dataverse.
pac model list-tables Перечислите таблицы Dataverse в связанной среде.

pac model create

Создаёт новое приложение, основанное на моделях.

Обязательные параметры для model create

--name -n

Отображаемое имя нового приложения на основе модели.

Необязательные параметры для model create

--description -d

Описание нового приложения на основе модели.

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--publish

Опубликуйте приложение после создания.

Этот параметр не требует значения. Это переключатель.

--solution

Уникальное имя решения для добавления приложения в. По умолчанию используется активное решение.

примеры pac model create

В следующих примерах показаны распространенные способы использования pac model create команды.

Создание приложения на основе модели в активной среде

pac model create --name "Contoso Sales Hub"

Создайте приложение с описанием и добавьте его в решение, а затем немедленно опубликуйте

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

Создание приложения в определенной среде путем предоставления URL-адреса среды

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

Используется pac model list для проверки того, что приложение создано и извлекается его идентификатор приложения для использования с другими командами, такими как pac model genpage upload.

pac model genpage download

Извлекайте сгенерированные страницы из приложения, управляемого моделями.

Обязательные параметры для model genpage download

--app-id

Идентификатор приложения на основе модели.

Необязательные параметры для model genpage download

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--output-directory -o

Каталог для сохранения вытягиваемых страниц. По умолчанию используется текущий каталог.

--page-id

Разделенный запятыми список идентификаторов страниц для извлечения.

примеры pac model genpage download

В следующих примерах показаны распространенные способы использования pac model genpage download команды.

Скачайте одну созданную страницу с идентификатором страницы в локальную папку для редактирования

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

Скачивание всех создаваемых страниц в приложении одновременно

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

Создайте подкаталог с именем идентификатора страницы и записывает следующие файлы.

./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

Генерирует определения схем TypeScript для источников данных

Обязательные параметры для model genpage generate-types

--data-sources

Разделенный запятыми список используемых источников данных (например, account, lead, contact).

Необязательные параметры для model genpage generate-types

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--output-file -o

Путь к сохранению созданного файла схемы TypeScript (по умолчанию — RuntimeTypes.ts)

примеры pac model genpage generate-types

В следующих примерах показаны распространенные способы использования pac model genpage generate-types команды.

Создание типов TypeScript

Создайте типы TypeScript для account таблиц и contact записывайте их в ./src/RuntimeTypes.ts:

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

Создание типов для одной таблицы в определенном выходном каталоге

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

Note

Всегда выполняйте перед generate-types написанием кода страницы, который запрашивает таблицы Dataverse. Созданный файл содержит строго типизированные имена столбцов, поля внешнего ключа и значения перечисления для каждой таблицы. Использование созданных типов предотвращает ошибки среды выполнения, вызванные ошибками или несуществующими именами столбцов.

pac model genpage list

Перечисляет все сгенерированные страницы в указанном приложении, управляемом моделями.

Обязательные параметры для model genpage list

--app-id

Идентификатор приложения на основе модели.

Необязательные параметры для model genpage list

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

примеры pac model genpage list

В следующих примерах показаны распространенные способы использования pac model genpage list команды.

Вывод списка страниц с помощью идентификатора приложения

Перечислить все созданные страницы в приложении Contoso Sales Hub с помощью его идентификатора приложения:

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

Вывод списка страниц с помощью имени приложения

Вывод списка создаваемых страниц по имени приложения (ИНТЕРФЕЙС командной строки автоматически ищет идентификатор приложения):

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

pac model Выходные данные примера 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

Транспилирует файл TypeScript с типами выполнения для тестирования и отладки

Обязательные параметры для model genpage transpile

--code-file

Путь к файлу, содержаму код страницы.

Необязательные параметры для model genpage transpile

--data-sources

Разделенный запятыми список используемых источников данных (например, account, lead, contact).

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--output-file

Путь к сохранению транспилированных выходных данных JavaScript (по умолчанию — [code-file].compiled.js)

pac model genpage upload

Загрузите и опубликуйте сгенерированную страницу в приложении, управляемом моделями.

Обязательные параметры для model genpage upload

--app-id

Идентификатор приложения на основе модели.

--code-file

Путь к файлу, содержаму код страницы.

Необязательные параметры для model genpage upload

--add-to-sitemap

Добавьте страницу в навигацию по картам сайта приложения.

Этот параметр не требует значения. Это переключатель.

--agent-message

Ответное сообщение агента.

--agent-message-file

Путь к файлу, содержаму ответное сообщение агента.

--compiled-code-file

Путь к файлу с скомпилированным кодом JavaScript. Если этот параметр не указан, TypeScript будет автоматически транспилирован в JavaScript.

--data-sources

Разделенный запятыми список используемых источников данных (например, account, lead, contact).

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--model

Модель искусственного интеллекта, используемая для создания страницы (например, claude-3-5-sonnet-20241022).

--name -n

Имя страницы.

--page-id

Идентификатор страницы для обновления. Если это не указано, будет создана новая страница.

--prompt

Запрос пользователя, создающий эту страницу.

--prompt-file

Путь к файлу с запросом пользователя, который создал эту страницу.

примеры pac model genpage upload

В следующих примерах показаны распространенные способы использования pac model genpage upload команды.

Публикация новой созданной страницы

Опубликуйте новую созданную страницу в приложении Центра продаж Contoso и добавьте ее в карту сайта приложения:

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

Обновление существующей созданной страницы

Обновите существующую созданную страницу, указав его идентификатор страницы (опустить --add-to-sitemap , чтобы избежать создания повторяющейся записи карты сайта):

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."

Публикация страницы, в которую используются макетные данные

Публикация страницы, в которую используются макетные данные (нет таблиц Dataverse — опустите --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

Параметр --app-id принимает GUID приложения или его отображаемое имя. Если несколько приложений используют одно отображаемое имя, используйте GUID, чтобы избежать неоднозначности. Выполните поиск pac model list идентификаторов приложений.

pac model genpage upload краткий справочник по параметру

Parameter Required Description
--app-id Yes GUID приложения или отображаемое имя. Запустите pac model list , чтобы найти его.
--code-file Yes Путь к исходному файлу .tsx для развертывания.
--name Только новые страницы Отображаемое имя, показанное на карте сайта приложения.
--page-id Updates only GUID существующей страницы для замены.
--data-sources Dataverse pages Разделенный запятыми список логических имен таблицы Dataverse (например, "account,contact").
--prompt Recommended Сводка по естественному языку о том, что делает страница. Хранится для контекста восстановления.
--model Recommended Идентификатор модели, используемый для создания страницы (например, claude-sonnet-4-6).
--agent-message Recommended Описание того, что было построено или изменено. Хранится в журнале изменений.
--add-to-sitemap Только новые страницы Автоматически добавляет страницу в навигацию приложения. Опущений при обновлении.

pac model list

Перечисляет все приложения, управляемые моделями, в среде.

Необязательные параметры для model list

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

Пример pac model list

Список всех приложений, управляемых моделью, в активной среде:

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

Перечисляет поддерживаемые языки в среде Dataverse.

Необязательные параметры для model list-languages

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

pac model list-tables

Перечислите таблицы Dataverse в связанной среде.

Необязательные параметры для model list-tables

--environment -env

Указывает целевой объект Dataverse. Это значение может быть URL-адресом GUID или абсолютным URL-адресом HTTPS. Если это не указано, будет использоваться активная организация, выбранная для текущего профиля проверки подлинности.

--search -s

Список имён с разделёнными запятой для поиска (совпадает с логическим именем, названием схемы или отображаемым именем).

--type -t

Фильтруйте по типу таблицы: «пользовательский», «стандартный» или «все» (по умолчанию: все).

See also

Microsoft Power Platform группы команд CLI
Обзор Microsoft Power Platform CLI

  • Last updated on