Lesson 1 of 6
Setup and prerequisites
9 min
Listen to this lesson
SAP Joule for Developers, ABAP AI capabilities (often shortened to J4D) changed shape in June 2026. Before then it was embedded in specific cloud releases. Since June SAP has offered it as a side-by-side service on its cloud, which SAP calls the ABAP AI Hub service, licensed in AI Units. Existing users kept free access under a promotion until 30 September 2026; since 1 October 2026 the AI capabilities need AI Units. The hub handles authentication, the license check, access to SAP AI Core and the logic behind each capability, and it plugs straight into the developer's IDE. That's why SAP could extend support down to SAP S/4HANA Cloud Private Edition 2021.
Which products and releases are covered
| Capability | SAP BTP ABAP environment | SAP S/4HANA Cloud Public Edition | SAP S/4HANA Cloud Private Edition |
|---|---|---|---|
| Joule chat, documentation chat | Yes | Yes | 2021 or higher |
| Predictive code completion, Explain | Yes | Yes | 2021 or higher |
| ABAP Unit and CDS test generation | Yes | Yes | 2021 or higher |
| CDS annotation generation | Yes | Yes | Yes (no release given) |
| OData UI Service from Scratch, RAP business logic prediction | Yes | Yes | 2025 or higher |
| Custom Code Migration AI Assistant | No | No | 2021 or higher |
| Embedded Analytics Star Schema Generator | Yes | Yes | No |
From SAP's Availability page on 17 October 2026. SAP adds that on-premise SAP S/4HANA 2021 to 2025 depends on special RISE with SAP contract conditions; ECC is not covered.
What the administrator does
Activation is an administrator task in SAP for Me, not a developer setting. SAP's administrator guide and its June 2026 blog describe these steps:
- Buy AI Units: customers order material 8019164; partners order 8019670 for test, demo and development. SAP Note 3740750 describes the commercial setup.
- In SAP for Me, open Portfolio & Products, choose the tab My Product Packages and the package Joule (partners: Joule (TDD)).
- On the Applications tab, choose SAP Joule for Developers, ABAP AI capabilities and start provisioning: select an SAP Cloud Identity Services system, a region and a formation name.
- Activate the feature in SAP Central Business Configuration, which needs the right policies for the user in the connected Identity Services tenant.
- Assign named developers to the Identity Services group for the service (SAP's blog names it
j4d_abap-enterprise-user). - Copy the new tenant's Main URL from the Resources tab and give it to the developers.
SAP lists only these data center regions for the side-by-side solution: EU10, EU11 (EU access only), US30, AP20 and JP10. Pick the one your data protection officer accepts before provisioning; it's awkward to change later.
What the developer does
In ADT for Eclipse, update to client 3.58.3 or higher, open the ABAP project's properties, select Enable project-specific settings, choose Use Joule side-by-side, enter the URL and use Check Connection. ADT for VS Code has an equivalent setting for all projects. SAP also asks for backend notes on Private Edition systems: SAP Note 3752299 (enable ADT for J4D), 3751297 (Private Edition instructions), 3558794 (AI functionality in Private Edition) and 3721223 (AI capabilities for ATC findings). Some of these are TCI notes; SAP Note 3437407 explains how to implement a TCI.
In the system, the developer also needs authorizations. SAP's guide lists a business role with business catalog SAP_A4C_BC_DEV_AIQ_PC and authorization object S_AIQADTLO with AIQ_TYPE = JADC_CODE, JADC_TEXT and ACTVT = AF. Ask your security team which role carries these in your landscape.
- Release checkProduct and release on SAP's Availability page
- CommercialsAI Units ordered (8019164) and visible in SAP for Me
- ProvisionJoule package, application, region, formation
- ActivateFeature active in Central Business Configuration
- UsersDevelopers in the Identity Services group; roles in the system
- Backend notesSAP Notes 3752299, 3751297, 3558794, 3721223 on Private Edition
- IDEADT 3.58.3+ or ADT for VS Code; URL entered; connection checked
When activation goes wrong
| Symptom | Likely cause | Check |
|---|---|---|
| Check Connection fails for one developer only | Old ADT client or user not in the Identity Services group | ADT version (3.58.3+); group membership |
| Check Connection fails for everyone | Wrong URL, feature not active, or provisioning incomplete | Main URL from Resources tab; feature status Active in Central Business Configuration |
| Joule works in one system but not another | Backend SAP Notes missing in that system | Notes 3752299, 3751297, 3558794 per system |
| Chat works but ATC AI features are missing | ATC AI note not implemented | SAP Note 3721223 |
| Requests fail after months of working | AI Units used up or expired | Balance in SAP for Me |
Most activation problems are configuration, not product defects; check these before opening a case.
What would you do?
Two weeks into the pilot, Joule chat and Explain work for all six developers in CMD, but nobody sees AI explanations or code proposals on ATC findings. In CMQ, which Kenji's team uses only for read-only analysis, Joule doesn't connect at all. What should Kenji ask Sam to check?
- Since June 2026, J4D runs as a side-by-side service licensed in AI Units; since 1 October 2026 every customer needs them.
- Covered: ABAP environment, Public Edition, Private Edition 2021+; some features need Private Edition 2025+.
- Administrators provision in SAP for Me, activate in Central Business Configuration and assign users in Identity Services.
- Developers enter the service URL in ADT 3.58.3+ (or ADT for VS Code) and need S_AIQADTLO.
- Private Edition systems need SAP Notes 3752299, 3751297, 3558794 and 3721223.
Check your understanding · not graded
Lesson check
1. Where does an administrator provision Joule for Developers, ABAP AI capabilities?
2. Which authorization object does SAP list for using J4D in the system?
3. Which J4D capability needs SAP S/4HANA Cloud Private Edition 2025 or higher?
4. Which ADT for Eclipse client version does SAP require for the AI Units setup?