# GrooveBox

> GrooveBox is a free online Groovy IDE and playground to run and test SAP Integration Suite (formerly SAP Cloud Platform Integration, CPI) Groovy scripts on Groovy 2.4 (Java 8) and Groovy 4 (Java 17), with mocks of the SAP Message API, value mapping, secure store, partner directory and Message Processing Log. No account or installation needed.

Key facts:

- Purpose: test and debug Groovy scripts for SAP Integration Suite iFlows before deploying them to a tenant.
- Runtimes: V1 = Groovy 2.4.21 on Java 8 with com.sap.gateway.ip.core.customdev.util.Message; V2 = Groovy 4.0.24 on Java 17 with the Script API v2 (com.sap.it.script.v2.api.Message and Exchange).
- Simulated SAP APIs: Message (body conversions, headers, properties, attachments), messageLogFactory (MPL), ITApiFactory with ValueMappingApi (getMappedValue, getMappedValues), SecureStoreService, PartnerDirectoryService.
- Output: body (XML/JSON beautified), header and property diff, MPL, console, SAP API calls, errors with the failing line.
- Free, no account, runs in the browser. Scripts run in isolated single-use containers without network; nothing is stored on the server.
- Independent tool, not affiliated with or endorsed by SAP.
- Also described as: online Groovy IDE for SAP Integration Suite, SAP CPI Groovy script tester, Groovy editor and debugger for SAP Integration Suite, Groovy playground for iFlow scripts. Works for scripts written for SAP Integration Suite on SAP BTP, formerly SAP Cloud Platform Integration (CPI) and HANA Cloud Integration (HCI).

## Pages

- [Playground](https://grooveboxide.com/): the app itself, to run a script
- [About](https://grooveboxide.com/about): Free online Groovy IDE and playground for SAP Integration Suite (formerly SAP CPI): run and test Groovy scripts on Groovy 2.4 and Groovy 4 with value mappings, headers, properties and MPL.
- [Guides](https://grooveboxide.com/guides): Practical guides for SAP Integration Suite Groovy scripts: examples, common errors, testing without a tenant, moving from Groovy 2.4 to Groovy 4, value mapping lookups.

## Guides

- [SAP Integration Suite Groovy script examples: a cheat sheet](https://grooveboxide.com/guides/sap-cpi-groovy-script-examples): Ready-to-use SAP Integration Suite Groovy snippets: body, headers, properties, XML, JSON, XML to JSON, MPL, value mapping, secure store, partner directory, dates. For Groovy 2.4 and Groovy 4.
- [Common SAP Integration Suite Groovy script errors and how to fix them](https://grooveboxide.com/guides/common-groovy-script-errors): unable to resolve class, No such property, Cannot invoke method on null object, Content is not allowed in prolog, JsonException, GroovyCastException: causes and fixes for SAP Integration Suite Groovy scripts.
- [How to test SAP Integration Suite Groovy scripts without deploying an iFlow](https://grooveboxide.com/guides/test-sap-cpi-groovy-scripts): Run SAP Integration Suite Groovy scripts in seconds with your own payload, headers, properties and value mappings, check the output and the MPL, then deploy with confidence.
- [Groovy 2.4 vs Groovy 4 in SAP Integration Suite: what changes for your scripts](https://grooveboxide.com/guides/groovy-2-4-vs-groovy-4): The changes that break SAP Integration Suite Groovy scripts on Groovy 4 and Java 17 (XmlSlurper package, BASE64Encoder, Date helpers, Script API v2 Message) and how to test on both runtimes.
- [Value mapping lookups in SAP Integration Suite Groovy scripts (ValueMappingApi)](https://grooveboxide.com/guides/value-mapping-groovy-script): How to read SAP Integration Suite value mappings from a Groovy script with ValueMappingApi getMappedValue, handle missing mappings and test lookups without a tenant.