agentleFS
logalitechlogalitech/abap-skills/skills/odata/SKILL.md

odata

Skill0 starsChanged 3 months agoMITView on GitHub

Servicios OData en ABAP, V2 y V4: exponer CDS con service definition/binding vs SEGW, CRUD, function imports, expand por asociaciones y $filter/$select para rendimiento. Úsala cuando el usuario cree/consuma un servicio OData, elija V2 vs V4, publique un CDS como OData o depure el gateway.

4 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

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

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 2

    Distinctive

    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:

    No modeles a mano en SEGW lo que puedes publicar con un binding sobre CDS: pierdes mantenibilidad y las capacidades de RAP.

    line 63
  2. Distinctive:

    No expongas más campos ni asociaciones de los necesarios: cada elemento expuesto es superficie de ataque y coste de payload.

    line 64

“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “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

OData Service Development

Guía para exponer datos ABAP como servicios OData: enfoque moderno (service definition + binding sobre CDS/RAP) frente al clásico SEGW, elección de V2 vs V4 y buenas prácticas de rendimiento con las opciones de consulta.

Cuándo y cómo usarla

  1. Identifica el objetivo: publicar un CDS o BO RAP como OData, elegir versión del protocolo, o depurar un servicio existente.
  2. Sitúa el contexto: en ABAP Cloud y desarrollos nuevos usa service definition/binding; SEGW es el mundo clásico (V2, modelado a mano).
  3. Aplica el patrón: para OData V4 y aplicaciones Fiori Elements transaccionales, publica el BO RAP; para exposición de solo lectura, publica una consumption CDS.

Enfoque moderno: service definition + binding

Publicar un CDS como OData son dos artefactos: la service definition (qué entidades se exponen) y el service binding (con qué protocolo y versión).

@EndUserText.label: 'Travel OData Service'
define service ZUI_Travel {
  expose ZC_Travel   as Travel;
  expose ZC_Booking  as Booking;
  expose I_Currency  as Currency;
}

El service binding se crea en ADT y define el tipo: OData V4 - UI (Fiori Elements moderno), OData V2 - UI (compatibilidad), o Web API (integración máquina a máquina). Tras activar el binding, se publica el servicio y queda disponible su URL y metadata ($metadata).

V2 frente a V4

  • OData V4: estándar actual. Mejor rendimiento, draft nativo, delta, mejor soporte analítico. Es la opción por defecto para servicios nuevos y RAP.
  • OData V2: se mantiene por compatibilidad con consumidores y librerías antiguas. Modelado clásico en SEGW o binding V2 sobre CDS.
  • Regla práctica: nuevo desarrollo con RAP/CDS y binding V4, salvo que un consumidor concreto exija V2.

CRUD, expand y function imports

  • CRUD: en un binding sobre un BO RAP, create/update/delete salen del behavior definition; sobre una CDS de solo lectura, el servicio expone únicamente lectura.
  • Expand por asociaciones: si publicas asociaciones (por ejemplo _Booking, _Customer), el consumidor navega con $expand.
  • Function imports / acciones: las acciones RAP (action confirmTravel result [1] $self) se exponen como acciones OData invocables por el cliente.
GET /sap/opu/odata4/sap/zui_travel/.../Travel
    ?$select=TravelId,TotalPrice,CurrencyCode
    &$filter=OverallStatus eq 'A' and TotalPrice gt 1000
    &$expand=_Booking($select=BookingId,FlightDate)
    &$orderby=TotalPrice desc
    &$top=50

Rendimiento con $select, $filter y $top

El coste de un servicio OData lo determina cuánto pides. Empuja la restricción al servidor:

  • $select: pide solo los campos que usas; evita traer entidades completas.
  • $filter: filtra en el servidor, no en el cliente. El filtro se traduce a WHERE sobre HANA.
  • $top / $skip: pagina en lugar de traer miles de registros.
  • $expand con moderación: cada expand es un join; expande solo lo que la pantalla necesita.

Buenas prácticas y errores comunes

  • No modeles a mano en SEGW lo que puedes publicar con un binding sobre CDS: pierdes mantenibilidad y las capacidades de RAP.
  • No expongas más campos ni asociaciones de los necesarios: cada elemento expuesto es superficie de ataque y coste de payload.
  • Delega el filtrado en el servidor: filtrar en el cliente tras traer todo anula el pushdown.
  • Publica una consumption CDS (ZC_*), no la interface (ZI_*) ni la raíz: la proyección de consumo es el contrato del servicio.
  • Revisa siempre $metadata tras activar el binding: confirma que las entidades, claves y asociaciones aparecen como esperas antes de conectar la UI.

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.