К основному содержанию
скилл CX Codex официальный · GitHub

sap-cloud-integration — скилл для GitHub Copilot: настройка

Скилл для GitHub Copilot помогает писать и разбирать iFlow в SAP Cloud Integration. Срабатывает при работе с CPI-скриптами Groovy, настройками обмена и ошибками адаптеров.

MIT ★ 41 430 обновлён 2026-10-23

Установить в GitHub Copilot · GitHub CLI Все способы и платформы ↓
gh skill install github/awesome-copilot skills/sap-cloud-integration
Открыть на GitHub

Что делает sap-cloud-integration

Скилл объясняет особенности среды SAP Cloud Integration и помогает создавать и разбирать интеграционные потоки iFlow. Он подсказывает, когда использовать заголовки или свойства обмена, как настраивать обработку ошибок и повторы через JMS, а также как работать с идемпотентностью и хранилищем данных.

Для диагностики нужны точные сообщения из Message Processing Log (MPL): скилл отделяет факты ошибки от предположений и предлагает конкретные проверки. Внутри есть справочные материалы по скриптам Groovy, заголовкам и свойствам, обработке ошибок и сбоям адаптеров. Скилл не предназначен для SAP PI/PO, ABAP или обычного Java/Groovy вне CPI.

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

  • разобрать ошибку адаптера по сообщению из MPL
  • выбрать между заголовком и свойством обмена
  • спроектировать обработку ошибок и повторные попытки через JMS

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

  • Разбери эту ошибку адаптера по сообщению из MPL и предложи проверку.
  • Проверь скрипт Groovy для CPI и укажи, как он обрабатывает большое тело сообщения.
  • Подскажи, где хранить значение для следующего iFlow: в заголовке или свойстве обмена?

Как установить sap-cloud-integration

1GitHub CLI

gh skill install github/awesome-copilot skills/sap-cloud-integration

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

.github/skills/sap-cloud-integration/SKILL.md

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

Вопросы о sap-cloud-integration

Как установить sap-cloud-integration в GitHub Copilot?

Выполни gh skill install github/awesome-copilot skills/sap-cloud-integration. Файл скилла находится по пути .github/skills/sap-cloud-integration/SKILL.md.

Что делает sap-cloud-integration?

Помогает разрабатывать и разбирать iFlow в SAP Cloud Integration: работать со скриптами Groovy, настройками обмена, повторами и ошибками адаптеров.

Для каких задач не предназначен sap-cloud-integration?

Скилл охватывает SAP Cloud Integration, а не SAP PI/PO, разработку на ABAP или Java/Groovy вне CPI.

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

SKILL.md · MIT
---
name: sap-cloud-integration
description: 'SAP Cloud Integration (CPI, part of SAP Integration Suite) runtime-specific guidance for building and troubleshooting iFlows. Use when writing or reviewing CPI Groovy scripts, choosing headers vs. exchange properties, designing exception subprocesses, JMS retry, idempotency or data store patterns, or diagnosing adapter errors (SFTP, HTTP/OAuth, SOAP, IDoc, OData, AS2, Cloud Connector) from Message Processing Log (MPL) text. Not for SAP PI/PO, ABAP development, or generic Java/Groovy outside CPI.'
---

# SAP Cloud Integration (CPI)

This skill supplies CPI runtime behavior that general models often get wrong: what survives a JMS or ProcessDirect hop, how End events change the monitored status, which Camel and `SAP_` headers the runtime reads, how scripts should touch large payloads, and how specific adapter error texts map to root causes.

## Required references

Read the matching reference before answering. Resolve paths relative to this file.

| Task | Read first |
|---|---|
| Write, review, or optimize a Groovy script | [references/groovy-scripting.md](references/groovy-scripting.md) |
| Decide header vs. property, write Simple expressions, use `SAP_`/`Camel` names | [references/headers-properties-expressions.md](references/headers-properties-expressions.md) |
| Exception subprocess, End events, retry, JMS, idempotency, data store | [references/error-handling-reliability.md](references/error-handling-reliability.md) |
| Diagnose an MPL error or adapter failure | [references/adapter-troubleshooting.md](references/adapter-troubleshooting.md) |
| Need SAP's own wording, a field not covered here, or a source link for the user | [references/sap-documentation-index.md](references/sap-documentation-index.md) |

## Rules that change the answer

1. **Exchange properties stay inside one iFlow.** They are not propagated over ProcessDirect. They are not stored in a JMS queue unless the JMS receiver's *Transfer Exchange Properties* option is on, which SAP does not recommend because of size limits. Pass what a downstream iFlow needs as a header or in the body. Headers that leave the tenant must not carry secrets.
2. **An Exception Subprocess that ends with a Message End event reports the message as Completed.** Use an Error End event when the failure must stay visible in monitoring. For synchronous senders, also set `CamelHttpResponseCode`.
3. **Check `message.getBodySize()` before reading a body with `getBody(String)`.** Treat `-1` (size unknown) as too large. For large payloads, use a streaming parser or a streaming splitter. Line-by-line reading only helps for line-delimited formats; minified JSON or XML is often a single line. Never attach payloads to the MPL unconditionally: gate attachments behind an externalized flag and cap their size. Tenants can write at most 1 GB of MPL attachments per 24 hours.
4. **Use `SAP_ApplicationID` for business keys.** It makes messages searchable in Monitor. Do not build custom correlation stores for this.
5. **Reliable delivery needs JMS (or a data store) for retry, and duplicate protection on the receiver side.** An Idempotent Process Call skips messages already processed successfully, but if a receiver commits and the acknowledgment is lost, a retry can still duplicate the effect (at least once). A failed synchronous call is not redelivered by the runtime; the caller must retry. To stop retrying after N attempts, route on `SAPJMSRetries`. The JMS sender sets it only for *Non-Exclusive* queues.
6. **Read credentials through the Security Material APIs** (`SecureStoreService`), never from externalized parameters or headers. Trust a server certificate chain only after verifying its fingerprints against an independent source, never just because a TLS test returned it, and never disable certificate validation as a fix.
7. **Diagnose from the exact MPL text.** Separate evidence (error text, HTTP status, step ID) from hypotheses, and give one concrete check per hypothesis (Connectivity Test, trace, keystore entry, Cloud Connector log).

## Output contract

- Code is complete and runnable in a CPI Script step: imports, null handling, guarded `messageLog`.
- Generated code contains no author names, credits, or promotional URLs.
- Say which iFlow step the code or setting belongs to and what to configure there (adapter field, End event, externalized parameter).
- Include test steps for the tenant (trace level, expected MPL status and properties).
- End with *Static analysis — not tested on a tenant* unless the user confirms a successful test run on their tenant; deployment alone is not enough.
- If a field name, limit, or behavior is not in these references and you are unsure, say so and point to the matching page in [references/sap-documentation-index.md](references/sap-documentation-index.md). Do not invent adapter fields, headers, or SAP Note numbers.
- Before designing a new integration between SAP products, check SAP Business Accelerator Hub for prepackaged integration content and SAP Architecture Center for a reference architecture. Extend standard content rather than rebuilding it.

## Authoritative sources

- SAP Integration Suite documentation: https://help.sap.com/docs/integration-suite (overview: https://help.sap.com/docs/integration-suite/sap-integration-suite/what-is-sap-integration-suite)
- Markdown source of the same documentation, for searching its text only: https://github.com/SAP-docs/btp-integration-suite
- Prepackaged integration content: https://api.sap.com/integrations/discoverintegrations
- Reference architectures: https://architecture.learning.sap.com/

When you cite a source to the user, link the public SAP page (SAP Help Portal, SAP Business Accelerator Hub, SAP Architecture Center, or another official SAP site), not the GitHub Markdown source. When these sources and this skill disagree, the SAP documentation wins. Tell the user about the difference.

© github · MIT · github/awesome-copilot

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

Все скиллы по теме «Бэкенд и API» →
sap-btp-integration-suite secondsky Скилл sap-btp-integration-suite для работы с SAP Integration Suite на BTP: сборка iFlow, прокси API Management, Event Mesh и B2B-интеграции. CX Codex +1 786установок sap-btp-master-data-integration secondsky Скилл sap-btp-master-data-integration для Claude Code помогает настроить SAP Master Data Integration и подключить к нему приложения. Запускается при настройке арендатора MDI, моделей распространения данных и репликации. CX Codex +1 838установок btp-sap-odata-to-mcp-server-optimized Raistlin82 MCP-сервер btp-sap-odata-to-mcp-server-optimized для Claude Code связывает SAP OData с ИИ-инструментами и Cloud Foundry. Преобразует запросы на естественном языке в OData-операции для аналитики и UI-сценариев. CX Codex +1 ★ 7звёзд репо sap-migrate sapdev-ai Плагин sap-migrate помогает переносить кастомный код в S/4HANA при brownfield-миграции, находить неиспользуемые Z/Y-объекты и массово вносить типовые правки. ★ 10звёзд репо azure-sap MicrosoftDocs Скилл azure-sap для Claude Code — справочник по SAP HANA на Azure Large Instances: развёртывание, HA/DR, мониторинг и безопасность. Даёт документацию Microsoft прямо в чате. CX Codex +1 171установок sap-fiori-eslint-plugin sap-fiori-tools Скилл sap-fiori-eslint-plugin для Claude Code настраивает, переносит и запускает ESLint с плагином @sap-ux/eslint-plugin-fiori-tools в проектах SAP Fiori. Закрывает три сценария: установка с нуля, миграция конфига, запуск проверки. CX Codex +1 673установок

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

Весь набор →
spring-observability Скилл spring-observability для GitHub Copilot настраивает наблюдаемость в сервисах на Spring Boot 3 и 4. Включается при добавлении метрик Micrometer, трассировки OpenTelemetry и структурированных логов с Actuator. CX Codex +1 ★ 41 430звёзд репо spring-boot-4-migration Скилл spring-boot-4-migration для GitHub Copilot переносит приложение со Spring Boot 3.x на 4.0. Запускается для миграции, разбора вызванных ею ошибок сборки и тестов или проверки уже выполненного перехода. CX Codex +1 ★ 41 430звёзд репо skill-distribution-audit Скилл skill-distribution-audit для GitHub Copilot проверяет репозитории со скиллами перед релизом. Сверяет исходные файлы с манифестом дистрибуции и реальной поисковой выдачей клиента. CX Codex +1 ★ 41 430звёзд репо scout-issue Скилл scout-issue для GitHub Copilot подбирает GitHub issues для вклада в открытые проекты. Он спрашивает об опыте, навыках, времени и типе вклада, затем ранжирует подходящие задачи. CX Codex +1 ★ 41 430звёзд репо pr-artifact-explorer Скилл pr-artifact-explorer для GitHub Copilot открывает GitHub PR, issues, запуски workflow, Actions-артефакты и веб-превью в общей панели. Он включается по запросу показать или изучить эти материалы. CX Codex +1 ★ 41 430звёзд репо ponder Скилл ponder для GitHub Copilot запускает цикл повторных проходов оценки проекта, пока выводы модели не перестанут меняться. Проверяет полное покрытие всех модулей без пропуска файлов. CX Codex +1 ★ 41 430звёзд репо openapi-to-application-java-spring-boot Скилл openapi-to-application-java-spring-boot для GitHub Copilot превращает спецификацию OpenAPI в основу приложения на Spring Boot. Он включается, когда нужно создать или доработать Java API по файлу OpenAPI или Swagger. CX Codex +1 ★ 41 430звёзд репо on-device-delegate Скилл on-device-delegate для GitHub Copilot передаёт объёмное чтение файлов локальному агенту. Основная сессия экономит контекст облачной модели при разборе логов или поиске фактов. CX Codex +1 ★ 41 430звёзд репо

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

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