ROSA — Released Objects Search Assistant

Skill Instructions

Base URL

https://sap-released-objects-server-production.up.railway.app

All endpoints return JSON. All parameters are passed as query string. All endpoints support CORS.

Common Parameters

These parameters appear on most endpoints:

Endpoints

GET /api/search

Search for SAP objects with fuzzy matching and relevance ranking.

Parameters:

Example:

GET /api/search?query=purchase+order&object_type=DDLS&limit=5

Response:

{
  "query": "purchase order",
  "system_type": "public_cloud",
  "clean_core_level": "A",
  "version": "latest",
  "total": 42,
  "offset": 0,
  "limit": 5,
  "hasMore": true,
  "objects": [
    {
      "objectType": "DDLS",
      "objectName": "I_PURCHASEORDER",
      "state": "released",
      "cleanCoreLevel": "A",
      "applicationComponent": "MM-PUR-PO",
      "softwareComponent": "S4CORE",
      "typeDescription": "Data Definition Language Source (CDS View)",
      "relevance": 100
    }
  ]
}

GET /api/object

Get full details of a specific SAP object.

Parameters:

Example:

GET /api/object?object_type=TABL&object_name=MARA

Response (found):

{
  "found": true,
  "object": {
    "objectType": "TABL",
    "objectName": "MARA",
    "state": "deprecated",
    "cleanCoreLevel": "A",
    "applicationComponent": "LO-MD-MM",
    "softwareComponent": "S4CORE",
    "typeDescription": "Database Table / Structure",
    "source": "Released APIs (Tier 1)",
    "successor": {
      "classification": "successor available",
      "objects": [
        { "objectType": "DDLS", "objectName": "I_PRODUCT", "typeDescription": "Data Definition Language Source (CDS View)" }
      ]
    }
  },
  "assessment": {
    "level": "A",
    "message": "DEPRECATED. Was previously released but should no longer be used. Check successor information."
  }
}

Response (not found) — HTTP 404:

{
  "found": false,
  "message": "Object TABL ZTEST was NOT found in the Cloudification Repository..."
}

GET /api/successor

Find released successor(s) for a deprecated or non-released object.

Parameters:

Example:

GET /api/successor?object_name=MARA&object_type=TABL

Response:

{
  "query": "MARA",
  "object_type": "TABL",
  "results": [
    {
      "objectType": "TABL",
      "objectName": "MARA",
      "state": "deprecated",
      "cleanCoreLevel": "A",
      "hasSuccessor": true,
      "successor": {
        "classification": "successor available",
        "objects": [
          {
            "objectType": "DDLS",
            "objectName": "I_PRODUCT",
            "typeDescription": "Data Definition Language Source (CDS View)",
            "state": "released",
            "cleanCoreLevel": "A"
          }
        ]
      },
      "assessment": "Successor(s) available."
    }
  ]
}

GET /api/compliance

Check Clean Core compliance of a list of objects.

Parameters:

Example:

GET /api/compliance?object_names=MARA,BSEG,I_PRODUCT&target_level=A

Response:

{
  "targetLevel": "A",
  "system_type": "public_cloud",
  "version": "latest",
  "totalChecked": 3,
  "compliant": 1,
  "nonCompliant": 1,
  "notFound": 1,
  "complianceRate": 33,
  "results": [
    { "input": "MARA", "status": "compliant", "objectType": "TABL", "objectName": "MARA", "cleanCoreLevel": "A", "state": "deprecated", "successor": { "objects": [{"objectType": "DDLS", "objectName": "I_PRODUCT"}] } },
    { "input": "BSEG", "status": "not_found" },
    { "input": "I_PRODUCT", "status": "compliant", "objectType": "DDLS", "objectName": "I_PRODUCT", "cleanCoreLevel": "A", "state": "released" }
  ]
}

GET /api/types

List all TADIR object types with counts.

Parameters: system_type, clean_core_level, version (all optional, defaults above).

Example:

GET /api/types

Response:

{
  "system_type": "public_cloud",
  "clean_core_level": "A",
  "totalTypes": 47,
  "types": [
    { "type": "DDLS", "count": 2847, "description": "Data Definition Language Source (CDS View)", "byLevel": { "A": 2847 } },
    { "type": "CLAS", "count": 1926, "description": "ABAP Class", "byLevel": { "A": 1926 } }
  ]
}

GET /api/statistics

Get overall repository statistics.

Parameters: system_type, clean_core_level, version (all optional).

Example:

GET /api/statistics

Response:

{
  "source": "objectReleaseInfoLatest.json",
  "loadedAt": "2025-01-15T10:30:00.000Z",
  "totalObjects": 9500,
  "byLevel": { "A": 9500 },
  "byState": { "released": 8200, "deprecated": 1300 },
  "topObjectTypes": [ { "type": "DDLS", "count": 2847, "description": "Data Definition Language Source (CDS View)" } ],
  "topApplicationComponents": [ { "component": "MM-PUR", "count": 450 } ],
  "availableVersions": ["2022", "2022_1", "2023", "2023_1", "2023_2", "2023_3", "2024", "2025", "2025_1"]
}

GET /api/versions

List available S/4HANA PCE versions.

No parameters.

Example:

GET /api/versions

Response:

{
  "total": 9,
  "versions": [
    { "version": "2022", "label": "2022 base release" },
    { "version": "2022_1", "label": "2022 FPS01 / SP01" },
    { "version": "2025_1", "label": "2025 FPS01 / SP01" }
  ]
}

GET /health

Health check.

Response: { "status": "ok", "server": "rosa" }

Typical Use Cases

"Is BAPI_MATERIAL_GETLIST released?"

1. Call /api/object?object_type=FUGR&object_name=BAPI_MATERIAL_GETLIST
2. If found === true, check object.state and object.cleanCoreLevel
3. If state === "released" and cleanCoreLevel === "A" → yes, it's released for ABAP Cloud
4. If state === "deprecated" → it was released but is now deprecated, check successor
5. If found === false → the object is not in the repository (likely Level C/D), suggest searching for alternatives with /api/search

"What is the successor of MARA?"

1. Call /api/successor?object_name=MARA
2. Check results[0].successor.objects for the replacement object(s)
3. If hasSuccessor === false → no known successor in the repository

"List all released CDS views for purchasing"

1. Call /api/search?query=purchase&object_type=DDLS&limit=50
2. Results are ranked by relevance
3. All returned objects are within the requested Clean Core Level
4. Optionally, add app_component=MM-PUR to narrow results to a specific SAP application component

"Is my code Clean Core compliant?"

Given a list of objects used in custom code:

1. Call /api/compliance?object_names=MARA,BSEG,CL_GUI_ALV_GRID,I_PRODUCT&target_level=A
2. Check complianceRate for the overall percentage
3. Check individual results entries — status: "non_compliant" items need remediation
4. Look at successor field for recommended replacements

"What object types exist in the repository?"

1. Call /api/types
2. Returns all types sorted by count, with description and level breakdown

Instructions for LLM

How to interpret results

• cleanCoreLevel: The most important field. A = safe for ABAP Cloud. B = classic, OK for private cloud. C/D = avoid.
• state: released is best. deprecated means use the successor. classicAPI is Level B.
• relevance: 0-100 score relative to the best match. Use this to rank results when presenting to the user or agent.
• successor: When present, always mention the successor. It's the recommended replacement.
• assessment.message: Human-readable summary of the object's status. Use this directly in your response.

Search strategy

1. If the user or agent gives an exact SAP name (e.g. "MARA", "CL_GUI_ALV_GRID", "I_PurchaseOrderItemAPI01"): Use /api/object with the correct type, or /api/search with the name as query.
2. If the user or agent describes a functional object (e.g. "purchase order", "material", "billing document" — always singular): Use /api/search with natural language. The API handles fuzzy matching and SAP abbreviation expansion.
3. If the user or agent asks about successors/replacements: Use /api/successor.
4. If the user or agent has a list of objects to check: Use /api/compliance.

Object types

The object_type parameter filters by TADIR type. Most commonly used:

• DDLS — CDS View (most common for released APIs)
• CLAS — ABAP Class
• INTF — ABAP Interface
• TABL — Database Table / Structure
• BDEF — RAP Business Object Definition
• SRVD — Service Definition
• SRVB — Service Binding (OData)
• FUNC — BAPIs and function modules
• DTEL — Data Element
• DOMA — Domain
• SUSO — Authorization Object

Use /api/types to get the full list of available object types with counts.

Error handling

• HTTP 400: Missing required parameter. The message field explains what's needed.
• HTTP 404: Object or type not found. Suggest alternatives.
• HTTP 500: Server error. Retry once, then inform the user.
• "error": "no_results": The query matched nothing. Suggest broadening the search.
• "error": "unknown_type": The object_type doesn't exist. availableTypes lists valid ones.