Skip to content

[BUG] Texts specific navigation paths not exposed in generated docs #136

@HenriqueJRech

Description

@HenriqueJRech

Is there an existing issue for this?

  • I have searched the existing issues

Current Behavior

Some endpoints for localized entities aren't being exposed when compiling to openapi.

Methods: GET, PATCH, DELETE
Navigation path: /Entity(<entity_key>)/texts(ID=<entity_key>,locale='<locale>')

CAP documentation states that update (reference) and delete (reference) operations to localized can happen using the navigation. I couldn't find explicit references to read, but a GET to this navigation path works.

Update navigation path:

PUT/PATCH /Entity(<entity_key>)/texts(ID=<entity_key>,locale='<locale>')/<field_name> HTTP/1.1
Content-Type: application/json

{
  "name": "Ein neuer Name"
}

Delete navigation path:

DELETE /Entity(<entity_key>)/texts(ID=<entity_key>,locale='<locale>') HTTP/1.1

Currently, for the Books entity in the Bookshop sample, the following paths are generated:

Image

Expected Behavior

All the available paths for specific texts maintenence paths should be generated in the openapi docs.

Example (manually edited json):

Image

Steps To Reproduce

  1. Clone the https://github.com/capire/bookshop locally
  2. Run npm i
  3. cds compile ./srv --to openapi -s all -o openapi
  4. Open the ./openapi/AdminService.openapi3.json file and check for the available paths

Environment

- **OS**: macOS 26.2 (25C56)
- **Node**: v22.21.1
- **npm**: 11.7.0
- **@cap-js/openapi**: 
- **cds**:
| @capire/bookshop | https://github.com/<your/repo> |
|:---------------------- | ----------- |
| Node.js                | v22.21.1    |
| @sap/cds               | 7.6.3       |
| @sap/cds-compiler      | 4.6.2       |
| @sap/cds-dk            | -- missing  |
| @sap/cds-dk (global)   | 7.6.1       |
| @sap/eslint-plugin-cds | 2.6.5       |
| @sap/cds-mtxs          | 1.15.0      |
| @cap-js/cds-types      | 0.2.0       |

Repository Containing a Minimal Reproducible Example

https://github.com/capire/bookshop

Anything else?

No response

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions