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

platform-agentexchange-partner-offers-configure — скилл

Скилл platform-agentexchange-partner-offers-configure включает или выключает получение партнёрских офферов из Transactable Marketplace в Salesforce-орге через настройку enableTransactableMarketplaceReceivePartnerOffers.

Apache-2.0 5 000 установок ★ 1 183 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add forcedotcom/sf-skills --skill platform-agentexchange-partner-offers-configure -a claude-code
Открыть на GitHub

Что делает platform-agentexchange-partner-offers-configure

Скилл управляет параметром enableTransactableMarketplaceReceivePartnerOffers через Metadata API (TransactableMarketplacePrivateOfferSettings). Сначала запрашивает текущее значение через Tooling API, затем записывает XML-файл настроек в <packageDir>/settings/TransactableMarketplacePrivateOffer.settings и разворачивает его в целевую оргу командой sf project deploy start.

Скилл проверяет текущее состояние перед изменением и запрашивает подтверждение перед деплоем — развернуть в неправильную оргу нельзя отменить простой командой. Требует Salesforce CLI sf ≥2.0.0, jq ≥1.6.0 и API версии 67.0 или новее — на младших версиях тип TransactableMarketplacePrivateOfferSettings недоступен.

Параметр не отображается в Setup UI, проверить его можно только через Tooling API. Если деплой проходит успешно, но значение не меняется — в проекте может быть другой файл TransactableMarketplacePrivateOffer.settings, который его переопределяет.

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

  • включить приём партнёрских офферов из Transactable Marketplace
  • выключить enableTransactableMarketplaceReceivePartnerOffers в орге
  • развернуть настройки TransactableMarketplacePrivateOfferSettings через Metadata API
  • проверить текущее значение TransactableMarketplaceReceivePartnerOffers через Tooling API

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

  • Включи получение партнёрских офферов в орге dev-sandbox
  • Отключи enableTransactableMarketplaceReceivePartnerOffers для staging
  • Проверь, включён ли TransactableMarketplaceReceivePartnerOffers в текущей орге

Как установить platform-agentexchange-partner-offers-configure

1Через Skills CLI (Vercel)

npx skills add forcedotcom/sf-skills --skill platform-agentexchange-partner-offers-configure -a claude-code

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

~/.claude/skills/platform-agentexchange-partner-offers-configure/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/platform-agentexchange-partner-offers-configure/

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

Вопросы о platform-agentexchange-partner-offers-configure

Как установить platform-agentexchange-partner-offers-configure в Claude Code?

Выполни npx skills add forcedotcom/sf-skills --skill platform-agentexchange-partner-offers-configure -a claude-code, скилл запишется в ~/.claude/skills/platform-agentexchange-partner-offers-configure/SKILL.md.

Что делает platform-agentexchange-partner-offers-configure?

Включает или отключает параметр enableTransactableMarketplaceReceivePartnerOffers через Metadata API, который управляет приёмом партнёрских офферов из Transactable Marketplace в Salesforce-орге.

Что нужно для работы platform-agentexchange-partner-offers-configure?

Salesforce CLI sf версии 2.0.0 или новее, утилита jq 1.6.0 или новее, и Salesforce API версии 67.0 или выше — на младших версиях тип TransactableMarketplacePrivateOfferSettings недоступен.

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

SKILL.md · Apache-2.0
---
name: platform-agentexchange-partner-offers-configure
description: "Enable or disable the org preference that controls whether a Salesforce org can receive partner offers from the Transactable Marketplace. Use this skill when the user wants to turn partner offer reception on or off for an org. TRIGGER when: user asks to enable or disable partner offers, configure TransactableMarketplaceReceivePartnerOffers, configure enableTransactableMarketplaceReceivePartnerOffers, set up marketplace partner offer reception, toggle the TM partner offers setting, edit a TransactableMarketplacePrivateOffer.settings file, or configure org preferences related to transactable marketplace. DO NOT TRIGGER when: user needs to create or manage the partner offer records themselves, configure marketplace listing settings, or work with SfdcPartnerOffer objects (use platform-metadata-deploy or platform-apex-generate instead)."
metadata:
  version: "1.0"
  domains: ["Platform"]
  minApiVersion: "67.0"
  relatedSkills:
    - "platform-apex-generate"
    - "platform-metadata-deploy"
  cliTools:
    - tool: ["sf"]
      semver: ">=2.0.0"
    - tool: ["jq"]
      semver: ">=1.6.0"
---

# Enabling Transactable Marketplace Receive Partner Offers Org Preference

This skill configures the `enableTransactableMarketplaceReceivePartnerOffers` org preference via the `TransactableMarketplacePrivateOfferSettings` Metadata API type, which controls whether a Salesforce org is eligible to receive partner offers through the Transactable Marketplace. It is required for subscriber orgs that participate in the TM partner offer flow.

## Scope

- **In scope**: Reading the current value of the pref, enabling or disabling it via Metadata API (`TransactableMarketplacePrivateOfferSettings`), and verifying the change took effect.
- **Out of scope**: Creating or managing partner offer records, configuring marketplace listings, or any Apex/trigger changes related to offer processing.

---

## Required Inputs

- **Target org alias or username**: The org where the pref should be set. Ask if not provided.
- **Desired state**: `true` (enable) or `false` (disable). Default: `true`.

---

## Workflow

### Phase 1 — Check current state

1. **Query the current preference value** by running:
   ```bash
   sf data query -q "SELECT Preference, Value FROM OrgPreference WHERE Preference = 'TransactableMarketplaceReceivePartnerOffers'" --target-org <alias> --use-tooling-api
   ```
   If the record exists and `Value = true`, the pref is already enabled — confirm with the user before proceeding.
   If the query returns no rows, the pref is not yet set (defaults to `false`).

2. **Resolve the org's package directory** to determine where to write metadata. Run this and use its output as `<packageDir>`:
   ```bash
   jq -r '.packageDirectories[0].path // "force-app/main/default"' sfdx-project.json
   ```

### Phase 2 — Apply the preference

3. **Write the TransactableMarketplacePrivateOfferSettings metadata file** — load `assets/org-pref-template.md` for the exact XML structure, then write the file at:
   ```text
   <packageDir>/settings/TransactableMarketplacePrivateOffer.settings
   ```
   Set `<enableTransactableMarketplaceReceivePartnerOffers>true</enableTransactableMarketplaceReceivePartnerOffers>` (or `false` if disabling).

4. **Deploy the metadata** to the target org. Before running the deploy, confirm with the user:
   - [ ] Confirmed the target org alias with the user (deploying to the wrong org is not easily reversible)
   - [ ] Confirmed the desired state (`true`/`false`) matches the user's intent
   ```bash
   sf project deploy start --metadata TransactableMarketplacePrivateOfferSettings --target-org <alias>
   ```

### Phase 3 — Verify

5. **Confirm the change** by re-running the Tooling API query from step 1 and verifying the `Value` column matches the desired state.

6. **Report to the user** — see Output Expectations below.

---

## Rules / Constraints

| Rule | Rationale |
|------|-----------|
| Always query the current value before writing metadata | Avoids unnecessary deploys and detects conflicting changes |
| Use `TransactableMarketplacePrivateOfferSettings` as the metadata type | This is the concrete type registered in the platform for this pref, not the generic `OrgPreferenceSettings` |
| The settings file must be named `TransactableMarketplacePrivateOffer.settings` | Metadata API requires the filename to match the settings node name |
| Do not hardcode `force-app/main/default/` | Always read `sfdx-project.json` for the actual package directory |
| Never deploy without confirming the org alias with the user | Deploying to the wrong org is not easily reversible |

---

## Gotchas

| Issue | Resolution |
|-------|------------|
| Tooling API query returns no rows | Pref is unset (defaults to `false`). Safe to create a new settings file. |
| Deploy fails with `INVALID_TYPE` | The metadata type name is `TransactableMarketplacePrivateOfferSettings` — check the `--metadata` flag value. |
| Deploy succeeds but value doesn't change | Another settings file in the project may be overriding this one. Search for other `TransactableMarketplacePrivateOffer.settings` files in the project. |
| `INSUFFICIENT_ACCESS_OR_READONLY` on deploy | User running the deploy must have the "Modify All Data" or org preference admin permission in the target org. |
| Pref not visible in UI | `enableTransactableMarketplaceReceivePartnerOffers` is not surfaced in Setup UI — the Tooling API query is the only way to verify it. |
| Available from API version 67.0+ only | The type is available from API v67.0 — deploying against an older API version will fail. |

---

## Output Expectations

After completing all phases, report:

```text
Org: <alias>
Preference: enableTransactableMarketplaceReceivePartnerOffers
Previous value: <true|false|unset>
New value: <true|false>
File written: <packageDir>/settings/TransactableMarketplacePrivateOffer.settings
Deploy status: Success
```

---

## Reference File Index

| File | When to read |
|------|-------------|
| `assets/org-pref-template.md` | Phase 2, step 3 — use as the exact XML structure for the settings file |
| `examples/org-preference-settings.xml` | To verify the generated file matches expected format |

© forcedotcom · Apache-2.0 · forcedotcom/sf-skills

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

Все скиллы по теме «DevOps и инфраструктура» →
integration-listing-optimization Samuel Berthe Скилл integration-listing-optimization помогает B2B SaaS-командам оптимизировать карточки интеграций в каталогах Salesforce AppExchange, Shopify, HubSpot и Atlassian для роста конверсии просмотров в установки. CX Codex +1 10 300установок salesforce-developer https://github.com/Jeffallan Скилл salesforce-developer пишет Apex-классы, собирает Lightning Web Components, оптимизирует SOQL-запросы и настраивает пакетную обработку на платформе Salesforce. Следит за governor limits и булкифицирует код. CX Codex +1 4 700установок salesforce jdrhyne Скилл водит Salesforce CLI вместо вас: SOQL и SOSL, чтение и правка записей, bulk-выгрузка, Apex и метаданные прямо из чата Claude. CX Codex +1 ★ 239звёзд репо mtdt — Salesforce DevOps mtdt-io mtdt — Salesforce DevOps — MCP-сервер для Claude Code: подключает ИИ-агента к mtdt.io для управления релизами Salesforce, проверяет метаданные, запускает тесты Apex и развёртывает пакеты между организациями. CX Codex +1 data-cloud-2025 JosiahSiegel Скилл data-cloud-2025 для Claude Code содержит архитектурные шаблоны Salesforce Data Cloud для проектирования потоков данных, объединения профилей и активации сегментов в CRM. CX Codex +1 155установок salesforce-development davila7 Скилл salesforce-development для Claude Code с паттернами разработки на платформе Salesforce: Lightning Web Components, триггеры и классы Apex, REST/Bulk API, Connected Apps и Salesforce DX. CX Codex +1 90установок

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

Весь набор →
experience-ui-bundle-site-generate Скилл experience-ui-bundle-site-generate для Claude Code создаёт метаданные Digital Experience Site для хостинга React UI bundles в Salesforce. Разворачивает контейнер сайта и настраивает языковые параметры. CX Codex +1 5 100установок data360-schema-get Скилл data360-schema-get для Claude Code и других кодеров запрашивает схему объектов Data Lake Object (DLO) и Data Model Object (DMO) из Salesforce Data Cloud через REST API. CX Codex +1 5 100установок dx-devops-test-failures-analyze Скилл dx-devops-test-failures-analyze разбирает сбои тестов Salesforce DevOps Center и предупреждения Code Analyzer простыми словами. Помогает понять корень ошибки и создать задачу WorkItem. CX Codex +1 5 100установок dx-code-analyzer-custom-rule-create Скилл dx-code-analyzer-custom-rule-create для Claude Code создаёт пользовательские правила Salesforce Code Analyzer на базе Regex, PMD и ESLint. Закрывает пробелы во встроенных проверках Apex и метаданных. CX Codex +1 5 000установок data360-code-extension-generate Скилл data360-code-extension-generate для Claude Code создаёт и развивает Code Extensions для Data 360. Он включается при работе со скриптами и функциями на PySpark, их локальной проверке и развёртывании. CX Codex +1 5 000установок experience-cms-brand-apply Скилл experience-cms-brand-apply для Claude Code и других платформ ищет бренд в Salesforce CMS, извлекает его правила и применяет их к генерируемому контенту — тексту, странице или компоненту. CX Codex +1 5 000установок experience-ui-bundle-agentforce-client-generate Скилл experience-ui-bundle-agentforce-client-generate встраивает клиент Agentforce Conversation в React и Angular UI Bundle: находит нужный пакет, проверяет agentId и подключает компонент на страницу. CX Codex +1 5 000установок dx-devops-test-suite-run Скилл dx-devops-test-suite-run запускает наборы тестов DevOps Center на стадиях пайплайна Salesforce и опрашивает статус до завершения. Пригодится перед продвижением изменений и для повторной проверки Quality Gate. CX Codex +1 5 000установок

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

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