add-dataverse · microsoft, code-apps — скилл для Claude Code: таблицы Power Apps
Скилл add-dataverse подключает таблицы Dataverse к приложению Power Apps и создаёт TypeScript-модели и сервисы. Он также помогает спроектировать и создать новые таблицы.
MIT ★ 1 167 обновлён 2026-10-29
/plugin marketplace add microsoft/power-platform-skills
/plugin install code-apps-preview@power-platform-skillsЧто делает add-dataverse
Для уже существующих таблиц скилл добавляет источник данных командой pa app add data-source, затем проверяет сгенерированные файлы и запускает npm run build. В моделях описаны интерфейсы TypeScript, а сервисы содержат методы CRUD; для таблиц с файловыми или графическими столбцами добавляются соответствующие типы и методы работы с файлами.
Если таблицы нужно создать, скилл сначала изучает существующие схемы, предлагает повторно использовать таблицу, расширить её или создать новую, а затем получает явное подтверждение. Для работы с API нужна авторизация Azure CLI и роль System Administrator или System Customizer. Без нужной роли создание таблиц через API не пройдёт.
Перед написанием кода скилл требует свериться со справочником Dataverse: в нём описаны особенности полей, связей и файловых столбцов. После сборки он исправляет ошибки TypeScript, но не выполняет развёртывание приложения.
Какие задачи решает
- подключить существующую таблицу Dataverse к приложению Power Apps
- создать схему таблиц с учётом зависимостей между ними
- найти таблицы, которые можно повторно использовать или расширить
- получить TypeScript-модели и CRUD-сервисы для таблиц
- проверить приложение сборкой и исправить ошибки TypeScript
Примеры запросов агенту
- Подключи таблицы
accountиcontactиз Dataverse к приложению Power Apps и проверь сборку. - Спроектируй таблицы Dataverse для этих данных, проверь существующие схемы и покажи план до создания.
Как установить add-dataverse
1Через маркетплейс плагинов
/plugin marketplace add microsoft/power-platform-skills/plugin install code-apps-preview@power-platform-skillsКоманда ставит плагин code-apps-preview целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-dataverse -a claude-code3Вручную: положить файлы
~/.claude/skills/add-dataverse/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/add-dataverse/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-dataverse -a codex2Вручную: положить файлы
.agents/skills/add-dataverse/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-dataverse -a cursor2Вручную: положить файлы
.cursor/skills/add-dataverse/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/power-platform-skills plugins/code-apps/skills/add-dataverse2Вручную: положить файлы
.github/skills/add-dataverse/SKILL.md1Через Skills CLI (Vercel)
npx skills add microsoft/power-platform-skills --skill add-dataverse -a gemini-cli2Командой платформы
gemini skills install https://github.com/microsoft/power-platform-skills --path plugins/code-apps/skills/add-dataverseВручную: положить файлы
.devin/skills/add-dataverse/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об add-dataverse
Как установить add-dataverse в Claude Code?
Сначала добавьте маркетплейс командой /plugin marketplace add microsoft/power-platform-skills, затем установите плагин командой /plugin install code-apps-preview@power-platform-skills.
Что делает add-dataverse?
Скилл подключает таблицы Dataverse к приложению Power Apps и проверяет созданные TypeScript-модели и сервисы. При необходимости он помогает спроектировать и создать таблицы.
Что нужно для создания таблиц Dataverse?
Нужны авторизация Azure CLI и роль System Administrator или System Customizer. Перед созданием скилл проверяет существующие таблицы и запрашивает явное подтверждение.
Исходный текст
SKILL.md · MIT
---
name: add-dataverse
description: Adds Dataverse tables to a Power Apps code app with generated TypeScript models and services. Can also create new Dataverse tables. Use when connecting to Dataverse, adding tables, creating schema, or querying Dataverse data.
user-invocable: true
allowed-tools: Read, Edit, Write, Grep, Glob, Bash, LSP, TaskCreate, TaskUpdate, TaskList, TaskGet, AskUserQuestion, Skill, EnterPlanMode, ExitPlanMode
model: opus
---
**📋 Shared Instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** - Cross-cutting concerns.
**References:**
- [dataverse-reference.md](./references/dataverse-reference.md) - Picklist fields, virtual fields, lookups, file/image columns, form patterns (CRITICAL)
- [api-authentication-reference.md](./references/api-authentication-reference.md) - Dataverse API auth, token, publisher prefix
- [table-management-reference.md](./references/table-management-reference.md) - Query, create, extend tables and columns
- [data-architecture-reference.md](./references/data-architecture-reference.md) - Relationship types, dependency tiers
# Add Dataverse
Two paths: **existing tables** (skip to Step 5) or **new tables** (full workflow).
## Workflow
1. Plan → 2. Setup API Auth → 3. Review Existing Tables → 4. Create Tables → 5. Add Data Source → 6. Review Generated Files → 7. Build
---
### Step 1: Plan
Check memory bank for project context. Ask the user:
1. Which Dataverse table(s) do they need? (e.g., `account`, `contact`, `cr123_customentity`)
2. Do the tables **already exist** in their environment, or do they need to **create new** ones?
**If tables already exist:** Skip to Step 5.
**If creating new tables:**
- Ask about the data they need and design an appropriate schema
- Use standard Dataverse tables when appropriate (`contact` for people, `account` for organizations)
- Build a dependency graph -- see [data-architecture-reference.md](./references/data-architecture-reference.md) for tier classification
- Enter plan mode with `EnterPlanMode`, present ER model with tables, columns, relationships, and creation order
- Get approval with `ExitPlanMode`
### Step 2: Setup API Auth (if creating tables)
See [api-authentication-reference.md](./references/api-authentication-reference.md) for full details.
```powershell
az account show # Verify Azure CLI logged in
# Find your Dataverse environment URL:
# In make.powerapps.com → Settings → Developer resources → Web API endpoint
# It looks like: https://<org-name>.crm.dynamics.com/api/data/v9.2/
# Use the base URL: https://<org-name>.crm.dynamics.com
$api = Initialize-DataverseApi -EnvironmentUrl "https://<org>.crm.dynamics.com"
$headers = $api.Headers
$baseUrl = $api.BaseUrl
$publisherPrefix = $api.PublisherPrefix
```
Requires **System Administrator** or **System Customizer** security role.
### Step 3: Review Existing Tables (if creating tables)
**Always query existing tables first before creating:**
```powershell
$existingTables = Invoke-RestMethod -Uri "$baseUrl/EntityDefinitions?`$filter=IsCustomEntity eq true&`$select=SchemaName,LogicalName,DisplayName" -Headers $headers
```
See [table-management-reference.md](./references/table-management-reference.md) for `Find-SimilarTables`, `Compare-TableSchemas`, and `Build-TableNameMapping` functions.
Present findings to user with `AskUserQuestion`:
- Tables that can be **reused** (already exist with matching columns)
- Tables that need **extension** (exist but missing columns)
- Tables that must be **created** (no match found)
### Step 4: Create Tables (if creating tables)
Get explicit confirmation before creating. Create in dependency order:
- **Tier 0**: Reference tables (no dependencies)
- **Tier 1**: Primary entities (reference Tier 0)
- **Tier 2**: Dependent tables (reference Tier 1)
Use safe functions from [table-management-reference.md](./references/table-management-reference.md):
- `New-DataverseTableIfNotExists`
- `Add-DataverseColumnIfNotExists`
- `Add-DataverseLookupIfNotExists` (from [data-architecture-reference.md](./references/data-architecture-reference.md))
### Step 5: Add Data Source
For each table:
```bash
pa app add data-source --connector dataverse --table <table-logical-name>
```
Can add multiple tables by running the command for each one.
### Step 6: Review Generated Files
The command generates:
- `src/generated/models/{Table}Model.ts` -- TypeScript interfaces, plus `{Table}FileColumnName`, `{Table}ImageColumnName`, `{Table}UploadColumnName` union types if the table has file/image columns
- `src/generated/services/{Table}Service.ts` -- CRUD methods (create, get, getAll, update, delete) plus `upload`, `downloadFile`, `downloadImage`, `deleteFileOrImage` if file/image columns exist
Show the user a usage example:
```typescript
import { AccountsService } from "../generated/services/AccountsService";
const result = await AccountsService.getAll({
select: ["name", "accountnumber"],
filter: "statecode eq 0",
orderBy: ["name asc"],
top: 50
});
const accounts = result.data || [];
```
**Key rules:**
- Use generated services (e.g., `AccountsService.getAll()`), not fetch/axios
- Check `result.data` for actual data
- Don't edit generated files unless needed
- **Read [dataverse-reference.md](./references/dataverse-reference.md) before writing any Dataverse code** -- picklist fields, virtual fields, lookups, and file/image columns all have critical gotchas
### Step 7: Build
```bash
npm run build
```
Fix TypeScript errors before proceeding. Do NOT deploy yet.
### Update Memory Bank
Record which tables were added (or created), generated files, and any schema notes.
© Microsoft · MIT · microsoft/power-platform-skills
Похожие скиллы
Все скиллы по теме «Данные и базы» →Сначала — add-dataverse от других авторов.