К основному содержанию
скилл CX Codex

assign-offline-profile — скилл для Claude Code: установка и работа

Скилл assign-offline-profile привязывает пользователей и команды к профилю Mobile Offline в Dataverse, чтобы включить офлайн-синхронизацию в мобильных приложениях.

MIT ★ 1 167 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add microsoft/power-platform-skills
/plugin install mobile-app@power-platform-skills
Открыть на GitHub

Что делает assign-offline-profile

Создание офлайн-профиля в Dataverse само по себе не включает синхронизацию на мобильных устройствах. Приложения не получают данные без явной связи между профилем и учетными записями. Скилл сопоставляет пользователей или команды с профилем через сущности usermobileofflineprofilemembership и teammobileofflineprofilemembership.

Процесс разбит на шаги: чтение environmentId из power.config.json, поиск идентификатора профиля через аргументы или offline-profile.json, проверка текущих привязок и расчёт дельты изменений. Скилл запрашивает подтверждение перед отправкой POST или DELETE-запросов в Dataverse Web API.

Без корректного environmentId в конфигурационном файле приложения выполнение прерывается со статусом NEEDS_CONTEXT. Для привязки команд поддерживаются только управляемые группы (teamtype eq 0); группы доступа исключаются автоматически.

Какие задачи решает

  • включить офлайн-синхронизацию Dataverse для конкретных сотрудников
  • назначить Mobile Offline Profile на рабочую группу или команду
  • удалить устаревшие привязки пользователей к офлайн-профилю
  • проверить текущий список участников с доступом к офлайн-данным

Примеры запросов агенту

  • Привяжи текущего пользователя к профилю офлайн-синхронизации через флаг --me
  • Назначь офлайн-профиль пользователям [email protected] и [email protected]
  • Удали команду Field Service из участников офлайн-профиля

Как установить assign-offline-profile

1Через маркетплейс плагинов

/plugin marketplace add microsoft/power-platform-skills
/plugin install mobile-app@power-platform-skills

Команда ставит плагин mobile-app целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add microsoft/power-platform-skills --skill assign-offline-profile -a claude-code

3Вручную: положить файлы

~/.claude/skills/assign-offline-profile/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/assign-offline-profile/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об assign-offline-profile

Как установить assign-offline-profile в Claude Code?

Выполните по очереди команды маркетплейса: /plugin marketplace add microsoft/power-platform-skills, а затем /plugin install mobile-app@power-platform-skills.

Зачем нужен этот скилл, если профиль уже создан?

В архитектуре Dataverse создание профиля и назначение прав разделены. Пока учётные записи или команды не добавлены в список участников профиля, мобильный клиент не загрузит локальную базу.

Где скилл ищет идентификатор профиля?

Сначала проверяются аргументы --profile-id и --profile-name. Если их нет, значение считывается из файла offline-profile.json в рабочей директории либо запрашивается через Dataverse API.

Исходный текст

SKILL.md · MIT
---
name: assign-offline-profile
description: Use when the user needs to bind users or teams to a Mobile Offline Profile so they actually receive offline sync on their devices. Without this, the profile exists in Dataverse but no one's app uses it.
user-invocable: false
allowed-tools: Read, Edit, Write, Grep, Glob, Bash, AskUserQuestion
model: sonnet
---

**Shared instructions: [shared-instructions.md](${PLUGIN_ROOT}/shared/shared-instructions.md)** — read first.

**References:**

- [offline-profile-schema.md](${PLUGIN_ROOT}/shared/references/offline-profile-schema.md) — `usermobileofflineprofilemembership` / `teammobileofflineprofilemembership` entity field map
- [dataverse-offline-api.md](${PLUGIN_ROOT}/shared/references/dataverse-offline-api.md) — Web API recipe (§12 — membership POSTs)

# Assign Offline Profile

Bind one or more users and/or teams to an existing Mobile Offline Profile. Without this step, the profile exists in Dataverse but is unbound — no one's app actually uses it for offline sync.

Per the maker portal's UX (the "Assign profile to user" dialog under env settings), this is a separate operation from profile creation. Many users hit "I created the profile but offline still doesn't work" — the missing piece is membership.

Before project reads or commands, apply
[app-working-directory.md](${PLUGIN_ROOT}/shared/references/app-working-directory.md).
Resolve one absolute `working_dir` for a direct call or require the child
invocation's owner root. Keep every shell/file operation, referenced recipe,
and retry on that root and the selected environment/tenant; missing or
conflicting context is `NEEDS_CONTEXT`. File tools use `<working_dir>/...`.
Planning-phase calls may discover and propose the membership diff but must
return before the confirmation gate, POST/DELETE, or artifact updates.

## Workflow

1. Verify project + locate profile → 2. Pick users/teams → 3. Discover existing memberships → 4. Confirm diff (single gate) → 5. POST memberships → 6. Verify → 7. Summary

---

### Step 1 — Verify project + locate profile

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
environment_id=$(node -p "require('./power.config.json').environmentId || ''") || {
  echo "BLOCKED: unreadable power.config.json" >&2; exit 1;
}
if [ -z "$environment_id" ]; then
  echo "NEEDS_CONTEXT: selected app has no environmentId" >&2; exit 1;
fi
node "${PLUGIN_ROOT}/scripts/resolve-environment.js" "$environment_id" --no-cache --require-tenant
```

Capture `<envUrl>` and `<tenantId>` and require them to match any supplied owner
identity. Pass `--tenant-id "<tenantId>"` on every Dataverse request, including
profile lookup, `WhoAmI`, membership discovery, mutation, readback, and retries.

Profile ID resolution (in order):

| Source | Used when |
|---|---|
| `$ARGUMENTS` contains `--profile-id <guid>` | Explicit override |
| `$ARGUMENTS` contains `--profile-name <name>` | Resolve via `GET /mobileofflineprofiles?$filter=name eq '<name>'&$select=mobileofflineprofileid` |
| `<working_dir>/offline-profile.json` | Read top-level `profileId` field |
| Otherwise | `GET /mobileofflineprofiles` and present `AskUserQuestion` with the list (max 4 options) |

STOP if no profile can be resolved. Print: `Run /setup-offline-profile first, or pass --profile-id`.

> **`power.config.json` is intentionally NOT consulted here.** That file is owned by `pa app init`. The profile ID lives in `offline-profile.json` only.

### Step 2 — Pick users/teams

`$ARGUMENTS` parsing:

| Flag | Effect |
|---|---|
| `--user <upn>` (repeatable) | Add specific user(s) by UPN (`[email protected]`) |
| `--team <name>` (repeatable) | Add specific team(s) by name |
| `--me` | Add the current Dataverse user from `WhoAmI` / `systemusers(<UserId>)` — useful for solo dev demos |
| `--all-app-users` | Add every user with **System User** role in the current env (broad; intended for prod rollout — confirm at gate) |
| `--unassign-user <upn>` / `--unassign-team <name>` | Remove an existing membership rather than add |

If no flags passed, present `AskUserQuestion`:

> **Question**: "Who should receive this offline profile?"
>
> **Options** (max 4):
> - `Just me (the current user)` — equivalent to `--me`
> - `Pick specific users by UPN` — you reply with comma-separated emails in the next message
> - `Pick a team` — list env's teams and pick one
> - `All users with System User role` — equivalent to `--all-app-users`; broad scope, confirm at gate

For pick-users flow: after the choice, print:

> "Reply with comma-separated UPNs (e.g. `[email protected], [email protected]`)"

Then read the next user message and parse.

### Step 3 — Discover existing memberships

**Telemetry checkpoint: `discover_offline_profile_memberships`**

For idempotency:

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
# Existing user memberships for this profile
node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> GET \
  "usermobileofflineprofilememberships?\$filter=_mobileofflineprofileid_value eq <profileId>&\$select=usermobileofflineprofilemembershipid,_systemuserid_value&\$expand=systemuserid_systemuser(\$select=domainname)" \
  --tenant-id "<tenantId>"

# Existing team memberships for this profile
node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> GET \
  "teammobileofflineprofilememberships?\$filter=_mobileofflineprofileid_value eq <profileId>&\$select=teammobileofflineprofilemembershipid,_teamid_value&\$expand=teamid_team(\$select=name)" \
  --tenant-id "<tenantId>"
```

Build the set of `already-bound` UPNs and team names.

For each candidate user/team from Step 2, look up their `systemuserid` / `teamid` (skip if already in `already-bound`):

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> GET \
  "systemusers?\$filter=domainname eq '<upn>'&\$select=systemuserid,fullname,domainname&\$top=1" \
  --tenant-id "<tenantId>"

node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> GET \
  "teams?\$filter=name eq '<team-name>' and teamtype eq 0&\$select=teamid,name&\$top=1" --tenant-id "<tenantId>"
```

(`teamtype eq 0` excludes Access Teams and Owner Teams — only Manage Teams get profile assignments.)

Construct three lists:
- `to_add` — resolved IDs to POST
- `to_remove` — resolved IDs to DELETE (from `--unassign-*` flags)
- `not_found` — UPNs/team-names that didn't resolve (warn)
- `already_bound` — skipped no-ops

### Step 4 — Confirm diff (single gate)

**Telemetry checkpoint: `confirm_offline_profile_assignment_diff`**

`AskUserQuestion`:

> **Question header**: `Confirm membership changes`
>
> **Question body**:
>
> ```
> Profile: <name> (<profileId>)
>
> Will ADD:
>   - User: [email protected] (Rahul Bansal)
>   - User: charanma@... (Charan Mahankali)
>   - Team: Field Service RMs (12 members)
>
> Will REMOVE:
>   (none)
>
> Already bound (skipping):
>   - User: admin@... (no-op)
>
> Could not resolve:
>   - [email protected] — not in this env's system users
>
> Proceed?
> ```
>
> **Options**:
> - `Proceed`
> - `Cancel`

### Step 5 — POST memberships

**Telemetry checkpoint: `assign_offline_profile_memberships`**

For each in `to_add`, POST sequentially (parallel POSTs occasionally return 429):

**User membership:**

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> POST \
  "usermobileofflineprofilememberships" \
  --tenant-id "<tenantId>" \
  --body '{
    "[email protected]": "/mobileofflineprofiles(<profileId>)",
    "[email protected]": "/systemusers(<systemuserid>)"
  }' \
  --include-headers
```

Expected 204 with `OData-EntityId` → capture membership GUID.

**Team membership:**

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> POST \
  "teammobileofflineprofilememberships" \
  --tenant-id "<tenantId>" \
  --body '{
    "[email protected]": "/mobileofflineprofiles(<profileId>)",
    "[email protected]": "/teams(<teamid>)"
  }' \
  --include-headers
```

For each in `to_remove`, DELETE:

```bash
cd -- '<working_dir>' || { echo "BLOCKED: cannot enter working_dir" >&2; exit 1; }
node "${PLUGIN_ROOT}/scripts/dataverse-request.js" <envUrl> DELETE \
  "usermobileofflineprofilememberships(<membershipid>)" --tenant-id "<tenantId>"
```

> **⚠️ Duplicate handling:** POSTing a membership that already exists returns `409 Conflict`. The `dataverse-request.js` wrapper's `looksLikeDuplicate` rescue treats this as silent success (the Step 3 dedup should catch most cases first). Re-runs are safe.

### Step 6 — Verify

**Telemetry checkpoint: `verify_offline_profile_memberships`**

Re-query memberships from Step 3 and assert the diff applied:
- Every `to_add` now appears in the GET response
- Every `to_remove` no longer appears

If the verification disagrees, return `BLOCKED: membership writes did not commit` and print the discrepancy.

### Step 7 — Summary

Print:

```
✓ Membership updates applied.

  Profile      : <name>
  Total members: <N users + M teams>
  Added        : <list>
  Removed      : <list>
  Skipped      : <list> (already bound)

Users will receive the profile on their next mobile app sign-in. Existing
sessions need to sign out + sign in to trigger the profile pull.
```

Update `memory-bank.md` `## Offline profile` block:

```yaml
membership:
  users: [rahul@..., charanma@...]
  teams: [Field Service RMs]
  lastAssignedAt: 2026-05-19T...
```

## Status code (final line)

- `DONE` — every requested add/remove applied; verify confirmed
- `DONE_WITH_CONCERNS: <list>` — some UPNs/teams could not be resolved, or `--all-app-users` matched 0 users (env may not have the role granted yet)
- `NEEDS_CONTEXT: <missing>` — couldn't determine profileId (no offline-profile.json, no --profile flags, no profiles in env)
- `BLOCKED: <reason>` — auth failure, profile not found in env, or verification disagreement

## Failure recovery

Memberships are individually committed (no transaction). If Step 5 fails mid-loop:
- Partially-added memberships remain (visible in env)
- Re-running with the same arguments is idempotent (Step 3 dedup catches what's already bound)
- Use `--unassign-*` to undo specific bindings if needed

© Microsoft · MIT · microsoft/power-platform-skills

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →
mobile-app-developer VoltAgent Субагент mobile-app-developer помогает решать задачи мобильной разработки: переходы между экранами, работу со стейтом, сетевые сбои и поведение приложения в фоне. CX Codex ★ 6 505звёзд репо mobile-offline-support secondsky Скилл mobile-offline-support для офлайн-первого подхода в мобильных приложениях: локальное хранилище, очередь синхронизации, разрешение конфликтов. CX Codex +1 423установок power-platform-architect официальный Tim Hanewich Скилл power-platform-architect для GitHub Copilot превращает требования бизнеса и расшифровки встреч в архитектуру решения на Power Platform. Он также подбирает компоненты и строит диаграммы Mermaid.js. CX Codex +1 205установок pcf-tooling официальный github Правило pcf-tooling для GitHub Copilot, которое подключает Microsoft Power Platform CLI при работе с Power Apps Component Framework. Срабатывает на файлах TypeScript, JavaScript, JSON, XML и проектах PCF. CX Codex +1 ★ 41 430звёзд репо dataverse microsoft Плагин для работы с Microsoft Dataverse и Dynamics 365 через Claude Code. Помогает писать запросы, менять схему таблиц, импортировать данные и развёртывать решения. ★ 262звёзд репо react-native-architecture Seth Hobson Скилл react-native-architecture для Claude Code, Codex и Cursor: подсказывает структуру проекта, навигацию, нативные модули и офлайн-синхронизацию в React Native на Expo. CX Codex +1 15 087установок

Из того же набора157

Весь набор →
canvas-app-planner Субагент canvas-app-planner для Claude Code превращает одобренные изменения Canvas Apps в контракты реализации для каждого экрана, сохраняя логику и вёрстку. CX Codex ★ 1 167звёзд репо assemble-ppmplugin Скилл assemble-ppmplugin для Claude Code собирает .ppmplugin-бандл из манифеста и бинарников Android/iOS, проверяет их соответствие и упаковывает в архив. Запускается после /generate-ppmplugin-manifest и скиллов сборки. CX Codex +1 ★ 1 167звёзд репо add-geolocation Скилл add-geolocation помогает добавить в мобильное приложение фоновое GPS-отслеживание с сохранением данных и отправкой в Dataverse. Его вызывает команда /add-native geolocation. CX Codex +1 ★ 1 167звёзд репо diagnose-deployment Скилл diagnose-deployment для Claude Code ищет ошибки загрузки Power Pages и импорта решений в Dataverse. Запускается по просьбе разобраться с неудачным деплоем или исправить найденные проблемы. CX Codex +1 ★ 1 167звёзд репо canvas-app Скилл создаёт и редактирует Power Apps Canvas App через Canvas Authoring MCP. Он пригодится для работы с экранами, адаптивной компоновкой и ошибками компиляции. CX Codex +1 ★ 1 167звёзд репо set-app-registration-native Скилл set-app-registration-native связывает мобильное приложение Power Apps Wrap с регистрацией приложения в Entra ID через auth.config.json. Находит существующие регистрации в тенанте и проверяет права доступа. CX Codex +1 ★ 1 167звёзд репо preview-screens Скилл preview-screens генерирует автономный HTML-файл с экранами мобильного приложения в телефонной рамке 375 × 812 без запуска Metro и эмулятора. CX Codex +1 ★ 1 167звёзд репо build-flow Скилл build-flow для Claude Code собирает Power Automate flow по описанию, проверяет его определение и создаёт flow. Автоматизирует процесс без ручной сборки каждого шага. CX Codex +1 ★ 1 167звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой