agentleFS
logalitechlogalitech/abap-skills/skills/released-abap-classes/SKILL.md

released-abap-classes

Skill0 starsChanged 3 months agoMITView on GitHub

Encontrar y usar clases/APIs ABAP liberadas para ABAP Cloud en lugar de las clásicas no permitidas. Úsala cuando el usuario busque un equivalente released, compruebe si un objeto está liberado, o sustituya una API clásica.

3 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    C4 Deprecated: no usar.

    line 39
  2. Distinctive:

    No asumas que una clase clásica conocida está liberada: comprueba siempre el API State antes de usarla en un paquete Cloud.

    line 80
  3. Distinctive:

    No copies el fuente de una clase SAP no liberada a una Z para "esquivar" la restricción: pierdes soporte y estabilidad de upgrade.

    line 81

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Released ABAP Classes

Guía para localizar y usar clases y APIs ABAP liberadas (released para Cloud Development) en lugar de las clásicas no permitidas, y para liberar tus propias clases cuando otros Software Components deban consumirlas.

Cuándo y cómo usarla

  1. Identifica el objetivo: encontrar el equivalente liberado de una API clásica, comprobar si un objeto está liberado, o exponer una clase propia.
  2. Sitúa el contexto: en ABAP Cloud solo compila lo que consume objetos liberados (C1); una clase no liberada no se puede usar desde otro Software Component.
  3. Aplica el patrón: busca el equivalente released, y si no existe, envuélvelo en un wrapper Tier 2 (Private Edition) o abre incidente con SAP (Public Edition).

Comprobar si un objeto está liberado

Un objeto liberado lleva un contrato de estabilidad (release contract). Formas de comprobarlo:

  • En ADT: la pestaña API State del objeto indica si está Released y con qué contrato (por ejemplo C1 - Use in Cloud Development).
  • Filtrando en el Project Explorer: rama Cloud Development muestra solo objetos consumibles desde Tier 1.
  • Con SQL sobre el catálogo de APIs:
SELECT ReleasedObjectType, ReleasedObjectName, ReleaseState
  FROM I_ApiObjects
  WHERE ReleaseState = 'RELEASED'
    AND ReleasedObjectType = 'CLAS'
  INTO TABLE @DATA(released_classes).
  • En el SAP API Business Hub (api.sap.com), filtrando por S/4HANA Cloud.

Niveles de liberación (contract classification)

  • C1 Use-In-Cloud-Development: consumible desde código Tier 1. Es el que buscas.
  • C2 Use-System-Internally: solo dentro del mismo Software Component.
  • C3 Use-In-Key-User-Apps: extensiones Key User.
  • C4 Deprecated: no usar.

Sustituir clases clásicas por equivalentes liberados

Muchas utilidades clásicas tienen equivalente liberado. Ejemplos habituales:

  • Fechas/timestamps: usa las clases y funciones liberadas de tratamiento de fecha/hora en lugar de módulos de función clásicos no liberados.
  • Mensajes y logs: APIs de application log liberadas en lugar de las clásicas.
  • Number ranges, GUIDs, conversión de unidades y monedas: existen APIs liberadas concretas para cada caso.

Si necesitas un dato de negocio (cliente, material, documento), la vía correcta no es una clase clásica sino consumir la vista I_* liberada del VDM.

Liberar tus propias clases

Para que otro Software Component consuma una clase global tuya, debes liberarla. En ADT, sobre la clase, usa la opción de release (API State) y marca el contrato adecuado (normalmente C1). Solo lo liberado forma parte del contrato estable que otros pueden usar.

Cuando no hay equivalente liberado: wrapper

Si la funcionalidad solo existe en una API no liberada (típico con BAPIs en Private Edition), aíslala en un Software Component Tier 2 y expón una interfaz Cloud-friendly.

CLASS zcl_wrapper_bp DEFINITION PUBLIC.
  PUBLIC SECTION.
    METHODS read_partner
      IMPORTING partner       TYPE bu_partner
      RETURNING VALUE(result) TYPE zif_bp_data.
ENDCLASS.

CLASS zcl_wrapper_bp IMPLEMENTATION.
  METHOD read_partner.
    CALL FUNCTION 'BAPI_BUPA_CENTRAL_GETDETAIL'   " no liberado, encapsulado
      EXPORTING businesspartner = partner
      IMPORTING ...             = result.
  ENDMETHOD.
ENDCLASS.

Tu código Tier 1 llama al wrapper por una interfaz liberada, nunca al BAPI directamente. En Public Edition no hay Tier 2 accesible: si falta la API, abre incidente con SAP.

Buenas prácticas y errores comunes

  • No asumas que una clase clásica conocida está liberada: comprueba siempre el API State antes de usarla en un paquete Cloud.
  • No copies el fuente de una clase SAP no liberada a una Z para "esquivar" la restricción: pierdes soporte y estabilidad de upgrade.
  • Prefiere consumir el VDM (I_*) para datos de negocio antes que cualquier clase de acceso a datos.
  • Al liberar clases propias, mantén la interfaz estable: liberar es un contrato, y romperlo afecta a los consumidores.
  • Valida con ATC (variante Cloud): marca como error el consumo de objetos no liberados y confirma que tu sustitución es correcta.

Referencias

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.