Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.
Auszug
hiddentrue

Nuclos REST architecture: camelCase, FQN, UID, attributes, links, rel, methods, subforms, JSON conventions.

globe with meridians Language: Deutsch · English

light bulb Architecture decisions (INTERNAL)

Internal design decisions for the REST JSON structure – camelCase, FQNs, attributes key and link rendering.

Status
colourGreen
titleKonzept
Status
colourBlue
titleDeveloper
Status
colourGreen
titleUpdated: Jul 2026
Status
colourGrey
titleapplies to Nuclos 4.2026.x

Panel
bgColor#F4F5F7

On this page

Inhalt
maxLevel2
minLevel2
Hinweis
titleBackground

Internal design decisions (draft 2015) for the REST JSON structure. For using the service, the REST documentation is authoritative.

Conventions

  • JSON properties in camelCase (e.g. boMetaId instead of bo_meta_id), no underscores in keys.
  • FQNs instead of UIDs: the package and BO name instead of the BO-meta UID (de_test_Auftrag).
  • Attributes start lowercase (de_test_Auftrag_gesamtsumme) and – where possible – are not fully qualified (exceptions: VLP, layout-ML rules).
  • Separation of technical and business attributes: business content under the key attributes.
  • All links with a rel key, href and a methods array; subforms under subforms.
Info
titleRationale

Non-fully-qualified attributes were preferred because they cause less traffic, are clearer and simplify test cases.

Related pages

gear RESTful service


REST service.

Open →