@processpuzzle/base-entity 1.3.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -31,7 +31,7 @@ The diagram below shows the main classes the library exposes:
31
31
  </a>
32
32
 
33
33
  - **BaseEntity** – interface your custom entity implements (only requires an `id`).
34
- - **BaseEntityRestService / BaseEntityFirestoreService** – concrete CRUD services to extend; both implement the `BaseEntityService` contract.
34
+ - **BaseEntityRestService** – the concrete CRUD service to extend; it implements the `BaseEntityService` contract.
35
35
  - **BaseEntityMapper** – interface for translating between your DTO and your entity. `SimpleEntityMapper` covers the trivial case.
36
36
  - **BaseEntityStore** – `@ngrx/signals` store feature backing the generated components. Composes with `BaseEntityTabsStore`, `BaseEntityContainerStore`, and the singleton `BaseFormNavigatorStore`.
37
37
  - **BaseEntityFacade** – optional one-stop class that wires entity, mapper, service, store, and descriptor together.
@@ -102,7 +102,7 @@ export class TestEntityMapper implements BaseEntityMapper<TestEntity> {
102
102
 
103
103
  ### 3. Extend the data service
104
104
 
105
- Pick `BaseEntityRestService` for an HTTP backend or `BaseEntityFirestoreService` for Firestore. Pass the mapper, a configuration key that resolves to the root URL, and the resource path.
105
+ Extend `BaseEntityRestService`. Pass the mapper, a configuration key that resolves to the root URL, and the resource path.
106
106
 
107
107
  The key is a `BaseConfiguration` property name, resolved through `serviceRootOf`. Use
108
108
  `BACKEND_SERVICE_ROOT` for a resource served by the platform's own backend — or the optional
@@ -173,6 +173,7 @@ export function createTestEntityDescriptor(): BaseEntityDescriptor {
173
173
  A few notes:
174
174
 
175
175
  - `linkedEntityType` is just the name of the related entity. The actual `BaseEntityDescriptor` is resolved at runtime through the facade registered in `BASE_ENTITY_FACADE_REGISTRY`.
176
+ - `multiplicity` says how many values an attribute holds: `'0..1' | '0..x' | '0..n' | '1..x' | '1..n'`, where `x` is the attribute's `maxOccurs` and `n` is unbounded. Absent means a single value; the attribute is *multi-valued* when the upper bound exceeds 1 (`isMultiValued()` / `upperBound()` are exported). Only `ARTIFACT` acts on it today, value counts are not validated, and `required` stays a separate flag. A metadata-defined entity carries both fields from its `EntityAttributeDefinition`.
176
177
  - `BaseEntityDescriptor` takes an options object (`{ entityName, attrDescriptors, store?, entityTitle? }`); `store` and `entityTitle` are usually set later in the host component.
177
178
 
178
179
  ### 6. Render the container
@@ -241,7 +242,7 @@ Every attribute's `FormControlType` selects the component that renders it in the
241
242
  | `RELATED_ENTITIES` | list of related-entity rows | array of related **ids** | **`linkedEntityType`**, `referenceIdField` | To-many **association**; the related entities exist independently. |
242
243
  | `COMPONENTS` | list of component rows | array of component **ids** | **`linkedEntityType`**, `referenceIdField` | To-many **containment**, child in its own table. Attaching stamps the parent's id into the child's foreign key; deleting destroys the child. |
243
244
  | `EMBEDDED_COMPONENTS` | inline sub-form per component | array of the **children themselves** | **`linkedEntityType`** | To-many **containment**, child inside the parent's payload. Backed by a `FormArray`; saved and deleted with the parent. |
244
- | `ARTIFACT` | file thumbnail/icon + upload/delete | `ArtifactAttr` (or `null`) | `label`, `showThumbnail` | Tricky — see below. |
245
+ | `ARTIFACT` | file thumbnail/icon + upload/delete | `ArtifactAttr` (or `null`); `ArtifactAttr[]` when multi-valued | `label`, `showThumbnail`, `multiplicity`, `maxOccurs` | Tricky — see below. |
245
246
  | `ADDITIONAL_PROPERTIES` | editable key/value list | `Record<string,string>` | `label` | Free-form string map. |
246
247
 
247
248
  `linkedEntityType` is **mandatory** for `LOOKUP`, `FOREIGN_KEY`, `RELATED_ENTITIES`, `COMPONENTS`, and `EMBEDDED_COMPONENTS` — it names the other entity, whose descriptor is resolved at runtime through `BASE_ENTITY_FACADE_REGISTRY` (or, for an embedded component, through `EMBEDDED_ENTITY_DESCRIPTOR_REGISTRY`); omitting it throws.
@@ -282,7 +283,7 @@ when they do not:
282
283
  - **`RELATED_ENTITIES`** is the to-many analogue: it normalizes heterogeneous items (strings/objects) into `{ id }` using `referenceIdField`, appends via the same navigator round-trip, and each row has a link and a delete button that detaches the reference only.
283
284
  - **`COMPONENTS`** looks like `RELATED_ENTITIES` but owns its rows. It resolves each row's text through the child's store (loading it if the parent's form is the first screen opened) and falls back to the id; **Add** takes the same navigator round-trip and then writes the parent's id into the attribute named by the child's `parentReferenceAttrName()`; **Delete** confirms and then calls the child store's `delete`. Like `ARTIFACT`, it therefore has an **immediate backend side-effect**, before the parent is saved.
284
285
  - **`EMBEDDED_COMPONENTS`** is the only control backed by a **`FormArray`** rather than a `FormControl`: each row is a sub-form built from the child's descriptor with the same `BaseEntityFormBuilder`, so the children are already part of `form.value` (no imperative write-back) and a child's `required` attribute keeps the *parent's* Save disabled. The sub-forms are handed the **parent's** store — an embedded child has none of its own. Rows are seeded from the attribute's value, which is also what restores them from a form snapshot.
285
- - **`ARTIFACT`** binds an `ArtifactAttr` (`{ bucket, objectId, name, mimeType }`). It fetches a thumbnail only for `image/*` types when `showThumbnail !== false`, otherwise shows a MIME-type icon; upload delegates to `ArtifactSelectorComponent` and **delete actually removes the stored object** (after a confirmation dialog). With `isHeading` it degrades to a plain heading. Requires an `ObjectStoreService` provider.
286
+ - **`ARTIFACT`** binds an `ArtifactAttr` (`{ bucket, objectId, name, mimeType }`). It fetches a thumbnail only for `image/*` types when `showThumbnail !== false`, otherwise shows a MIME-type icon; upload delegates to `ArtifactSelectorComponent`, which also offers **taking a photo or recording a video** with the device camera — shown only where `CameraSupportService` finds one (secure context, `getUserMedia`, a `videoinput` device); the capture then goes through the same name / MIME type / Upload step as a picked file. Delete **actually removes the stored object** (after a confirmation dialog). When the `multiplicity` is multi-valued the value is an `ArtifactAttr[]` (a `null` reads as empty, a lone object saved earlier as one entry): one row per artifact, an upload **appends** instead of replacing, delete removes only that row's artifact, and the selector disappears once the count reaches the upper bound. The list cell then shows one download link per artifact, and the PDF export joins their names. With `isHeading` it degrades to a plain heading. Requires an `ObjectStoreService` provider.
286
287
 
287
288
  These value-editing controls (`ARTIFACT`, `LOOKUP`, `FOREIGN_KEY`, `RELATED_ENTITIES`, `COMPONENTS`, `TAGS`, `ADDITIONAL_PROPERTIES`) write to their `FormControl` **imperatively** (`setValue` + `markAsDirty`), which is why the form's Save button reacts to `form.events` rather than a plain dirty binding. `EMBEDDED_COMPONENTS` is the exception: its `FormArray` is edited by the sub-forms themselves.
288
289
 
@@ -434,6 +435,17 @@ The tab captions take the resolved entity name as a parameter, so translators co
434
435
  }
435
436
  ```
436
437
 
438
+ ## Unsaved changes
439
+ An embedded child or a relationship is saved by its **container's** Save, which is easy to forget once the
440
+ child's own form is closed. Every `base-form` therefore reports whether it holds unsaved edits — its own
441
+ changes, or changes staged in its document by an embedded child — to `UnsavedChangesRegistry`:
442
+ - the status bar shows an "Unsaved changes" chip on its right while any open form has some;
443
+ - the form's details routes carry `unsavedChangesGuard` (`canDeactivate`), which asks for confirmation before
444
+ the user navigates elsewhere. Cancel, Delete and a successful Save leave without asking. Drilling down into
445
+ an embedded child keeps the owner's route active, so it is not interrupted.
446
+
447
+ A hand-written details route can reuse the guard by implementing `HasUnsavedChanges` on its component.
448
+
437
449
  ## Status-bar title
438
450
 
439
451
  The status bar labels the selected entity with the value of one identifying attribute. That attribute
@@ -451,7 +463,7 @@ new BaseEntityDescriptor({ entityName: 'Order Line', attrDescriptors, titleKey:
451
463
  The list toolbar carries two independent search inputs:
452
464
 
453
465
  - **Filter** — a client-side, case-insensitive substring match over the rows already loaded into the Material table. Instant, but limited to the current page of data.
454
- - **Query** — a server-side [RSQL/FIQL](https://github.com/jirutka/rsql-parser) expression. On <kbd>Enter</kbd> (or the ▶ button) the toolbar calls `store.load({ query })`; the REST service forwards it to the backend as a `where=<rsql>` request parameter (`BaseEntityFirestoreService` applies the equivalent constraints). Clearing the query reloads the unfiltered list.
466
+ - **Query** — a server-side [RSQL/FIQL](https://github.com/jirutka/rsql-parser) expression. On <kbd>Enter</kbd> (or the ▶ button) the toolbar calls `store.load({ query })`; the REST service forwards it to the backend as a `where=<rsql>` request parameter. Clearing the query reloads the unfiltered list.
455
467
 
456
468
  ### Query syntax
457
469
 
@@ -7,12 +7,42 @@
7
7
  "formControlType": "Steuerelementtyp",
8
8
  "displayOrder": "Anzeigereihenfolge",
9
9
  "required": "Erforderlich",
10
- "isMultiValued": "Mehrwertig",
10
+ "multiplicity": "Multiplizität",
11
+ "maxOccurs": "Max. Anzahl",
11
12
  "indexed": "Indiziert",
12
13
  "isLinkToDetails": "Benennt den Datensatz",
14
+ "autosizeColumn": "Passt die Listenspalte an",
13
15
  "linkedEntityType": "Verknüpfte Entität",
14
16
  "defaultValue": "Standardwert",
15
- "enumValues": "Aufzählungswerte"
17
+ "enumValues": "Aufzählungswerte",
18
+ "dateStyle": "Datumsstil",
19
+ "timeStyle": "Zeitstil",
20
+ "defaultAvatar": "Standard-Avatar",
21
+ "showMap": "Zeigt eine Karte",
22
+ "mapProvider": "Kartenanbieter",
23
+ "defaultCountry": "Standardland",
24
+ "_tooltips": {
25
+ "code": "Schlüssel, unter dem der Wert gespeichert wird, eindeutig innerhalb des Entitätstyps, z. B. orderNumber. Nicht mehr ändern, sobald Datensätze existieren.",
26
+ "name": "Die Beschriftung des Feldes, wie Benutzer sie in Formularen und Listenspalten sehen, z. B. Bestellnummer.",
27
+ "valueKind": "Welche Art von Wert das Feld enthält: Text, Zahl, Ja/Nein, Datum, Datum und Uhrzeit, eine Auswahl aus einer Liste (ENUM) oder einen Verweis auf einen anderen Datensatz. Bestimmt, wie Werte geprüft und verglichen werden.",
28
+ "formControlType": "Mit welchem Eingabeelement Benutzer das Feld ausfüllen, z. B. TEXT_BOX, TEXTAREA, DROPDOWN oder CHECKBOX. Wählen Sie eines, das zur Wertart passt.",
29
+ "displayOrder": "Position des Feldes im Formular und seiner Spalte in der Liste; kleinere Zahlen kommen zuerst, z. B. 10, 20, 30.",
30
+ "multiplicity": "Wie viele Werte das Feld aufnimmt: 0..1 höchstens einen, 0..n / 1..n beliebig viele (mit 1.. mindestens einen), 0..x / 1..x bis zu Max. Anzahl. Leer lassen für einen einzelnen Wert.",
31
+ "maxOccurs": "Obergrenze für die Anzahl der Werte, z. B. 5. Gilt nur für die Multiplizitäten 0..x und 1..x.",
32
+ "required": "Ob Benutzer das Feld ausfüllen müssen, bevor sie den Datensatz speichern können.",
33
+ "indexed": "Ankreuzen für Felder, nach denen oft gesucht oder gefiltert wird, z. B. eine Kundennummer; das macht solche Abfragen schnell.",
34
+ "isLinkToDetails": "Ankreuzen für das Feld, das den Datensatz benennt, z. B. die Bestellnummer: Es öffnet den Datensatz aus der Liste und steht als Überschrift im Formular. Höchstens ein Feld pro Entitätstyp.",
35
+ "autosizeColumn": "Ankreuzen, damit die Listenspalte des Feldes nur so breit wie ihr Inhalt ist, z. B. bei kurzen Codes oder Kennzeichen.",
36
+ "enumValues": "Für die Wertart ENUM: die Optionen, aus denen Benutzer wählen, je ein Chip, z. B. NEW, PAID, SHIPPED.",
37
+ "linkedEntityType": "Für Verweisfelder (FOREIGN_KEY) und eingebettete Zeilen (EMBEDDED_COMPONENTS): der Code des Entitätstyps, auf den sie zeigen, z. B. customer.",
38
+ "defaultValue": "Wert, der in neuen Datensätzen vorausgefüllt ist, z. B. NEW oder 1. Leer lassen für keinen.",
39
+ "defaultAvatar": "Für AVATAR-Steuerelemente: Icon-Name (z. B. person, sailing) oder Bild-URL, die vor dem Hochladen eines Bildes angezeigt wird.",
40
+ "showMap": "Für ADDRESS-Steuerelemente: die Adresse auf einer Karte zeigen, mit daraus ermittelten Koordinaten.",
41
+ "mapProvider": "Für ADDRESS-Steuerelemente mit Karte: wer sie zeichnet. Leer bedeutet OpenStreetMap; ein Klick öffnet immer Google Maps.",
42
+ "defaultCountry": "Für ADDRESS-Steuerelemente: der ISO-Ländercode, mit dem eine neue Adresse beginnt, z. B. DE. Leer nimmt das Land des Browsers.",
43
+ "dateStyle": "Für DATE- und DATE_TIME-Felder: wie das Datum angezeigt wird, von short (31.12.26) bis full (Donnerstag, 31. Dezember 2026). Leer bedeutet Standard.",
44
+ "timeStyle": "Für DATE_TIME-Felder: wie die Uhrzeit angezeigt wird, von short (14:30) bis long (mit Sekunden und Zeitzone). Leer bedeutet Standard."
45
+ }
16
46
  },
17
47
  "entity_definition": {
18
48
  "_self": "Entitätsdefinition",
@@ -21,13 +51,45 @@
21
51
  "description": "Beschreibung",
22
52
  "status": "Status",
23
53
  "isEmbedded": "Eingebettet",
54
+ "canContextObject": "Kontextobjekt",
24
55
  "componentParents": "Übergeordnete Komponenten",
25
56
  "attributes": "Attribute",
26
57
  "version": "Version",
27
- "updatedAt": "Aktualisiert am"
58
+ "updatedAt": "Aktualisiert am",
59
+ "releaseState": "Release-Stand",
60
+ "sharedFrom": "Geteilt von",
61
+ "_tooltips": {
62
+ "code": "Eindeutiger Schlüssel des Entitätstyps in Ihrer Organisation, wird in Adressen verwendet. Kurz, kleingeschrieben und URL-tauglich, z. B. order; später möglichst nicht ändern.",
63
+ "name": "Der Entitätsname, unter dem Seiten, Routen und Menüs der Anwendung diesen Typ ansprechen, z. B. Order.",
64
+ "description": "Eine Notiz für Sie und Ihre Mitgestalter, wozu dieser Entitätstyp dient; Benutzer sehen sie nicht.",
65
+ "status": "ACTIVE für einen Typ in Gebrauch, DEPRECATED, um ihn auszumustern: Die Anwendung zeigt einen ausgemusterten Typ nicht mehr an. Ob die Anwendung den Typ überhaupt kennt, entscheidet seine Veröffentlichung, angezeigt unter Release-Stand.",
66
+ "isEmbedded": "Ankreuzen, wenn Datensätze dieses Typs nur innerhalb eines anderen Datensatzes existieren, z. B. Bestellpositionen in einer Bestellung. Dann auch den übergeordneten Typ unter Übergeordnete Komponenten angeben.",
67
+ "canContextObject": "Ankreuzen, damit Benutzer einen Datensatz dieses Typs als Kontextobjekt wählen können: der Datensatz, dessen eingebettete Teile dann ohne erneute Auswahl aufgelistet und bearbeitet werden. Nicht für eingebettete Typen.",
68
+ "componentParents": "Für einen eingebetteten Typ: die Codes der Entitätstypen, deren Datensätze ihn enthalten, z. B. order. Pflicht, wenn Eingebettet angekreuzt ist.",
69
+ "attributes": "Die Felder des Entitätstyps, eine Zeile pro Feld. Sie werden zusammen mit der Definition gespeichert.",
70
+ "version": "Erhöht sich bei jedem Speichern. Wird vom System gesetzt.",
71
+ "updatedAt": "Wann die Definition zuletzt gespeichert wurde. Wird vom System gesetzt.",
72
+ "releaseState": "Ob die laufende Anwendung diese Definition so verwendet, wie sie ist: NEW wurde nie veröffentlicht, CHANGED weicht vom Veröffentlichten ab, RELEASED ist das, was die Anwendung verwendet. Veröffentlichen Sie im Bereich Release, um es zu ändern. Wird vom System gesetzt.",
73
+ "sharedFrom": "Das Common, aus dem dieser Typ stammt. Ihre Organisation liest den Typ, aber nur das Common veröffentlicht oder ändert ihn. Leer bei eigenen Typen. Wird vom System gesetzt."
74
+ }
28
75
  },
29
76
  "artifact": {
30
- "upload_failure": "Hochladen des Artefakts fehlgeschlagen. Bitte erneut versuchen."
77
+ "upload_failure": "Hochladen des Artefakts fehlgeschlagen. Bitte erneut versuchen.",
78
+ "invalid_file_type": "Nur Bilddateien sind erlaubt.",
79
+ "camera_capture": "Foto oder Video aufnehmen"
80
+ },
81
+ "camera_capture": {
82
+ "title": "Kamera",
83
+ "mode": "Aufnahmemodus",
84
+ "photo": "Foto",
85
+ "video": "Video",
86
+ "take_photo": "Foto aufnehmen",
87
+ "start_recording": "Aufnahme starten",
88
+ "stop_recording": "Aufnahme beenden",
89
+ "retake": "Wiederholen",
90
+ "use": "Übernehmen",
91
+ "cancel": "Abbrechen",
92
+ "unavailable": "Die Kamera konnte nicht gestartet werden. Prüfen Sie, ob der Kamerazugriff für diese Seite erlaubt ist."
31
93
  },
32
94
  "delete_artifact_confirmation_dialog": {
33
95
  "title": "Artefakt löschen?",
@@ -42,7 +104,15 @@
42
104
  "delete_button": "Löschen"
43
105
  },
44
106
  "statusbar": {
45
- "breadcrumb_label": "Datensatz-Hierarchie"
107
+ "breadcrumb_label": "Datensatz-Hierarchie",
108
+ "unsaved_changes": "Ungespeicherte Änderungen",
109
+ "unsaved_changes_hint": "Speichern Sie {{ entity }}, um diese Änderungen zu behalten"
110
+ },
111
+ "unsaved_changes_dialog": {
112
+ "title": "Ungespeicherte Änderungen",
113
+ "content": "Es gibt ungespeicherte Änderungen. Wenn Sie diese Seite verlassen, gehen sie verloren.",
114
+ "cancel_button": "Bleiben",
115
+ "leave_button": "Verlassen"
46
116
  },
47
117
  "tabs": {
48
118
  "list": "{{ entity }} - Liste",
@@ -55,7 +125,9 @@
55
125
  "filter_tooltip": "Geladene Zeilen nach Text filtern",
56
126
  "edit_tooltip": "Ausgewählten Datensatz bearbeiten",
57
127
  "new_tooltip": "Neuen Datensatz erstellen",
58
- "delete_tooltip": "Ausgewählte Datensätze löschen"
128
+ "delete_tooltip": "Ausgewählte Datensätze löschen",
129
+ "export_menu": "Exportieren",
130
+ "actions_menu": "Aktion wählen"
59
131
  },
60
132
  "pdf_export": {
61
133
  "button": "PDF",
@@ -78,6 +150,109 @@
78
150
  "apply_button": "Übernehmen"
79
151
  },
80
152
  "embedded_components": {
81
- "save_owner_first": "Speichern Sie diesen Datensatz, bevor Sie {{ entity }} hinzufügen — eine eingebettete Komponente wird darin gespeichert."
153
+ "save_owner_first": "Speichern Sie diesen Datensatz, bevor Sie {{ entity }} hinzufügen — eine eingebettete Komponente wird darin gespeichert.",
154
+ "move_up": "Nach oben",
155
+ "move_down": "Nach unten",
156
+ "hide_list": "Liste ausblenden",
157
+ "show_list": "Liste anzeigen",
158
+ "hidden_count": "{{ count }} ausgeblendet"
159
+ },
160
+ "rich_text": {
161
+ "toolbar": {
162
+ "label": "Textformatierung",
163
+ "bold": "Fett",
164
+ "italic": "Kursiv",
165
+ "strike": "Durchgestrichen",
166
+ "code": "Inline-Code",
167
+ "heading_1": "Überschrift 1",
168
+ "heading_2": "Überschrift 2",
169
+ "heading_3": "Überschrift 3",
170
+ "bullet_list": "Aufzählung",
171
+ "ordered_list": "Nummerierte Liste",
172
+ "blockquote": "Zitat",
173
+ "horizontal_rule": "Trennlinie",
174
+ "undo": "Rückgängig",
175
+ "redo": "Wiederherstellen"
176
+ }
177
+ },
178
+ "comments": {
179
+ "title": "Kommentare",
180
+ "new_placeholder": "Kommentar schreiben…",
181
+ "unknown_author": "Unbekannt",
182
+ "count": "{{ count }} Kommentare"
183
+ },
184
+ "address": {
185
+ "country": "Land",
186
+ "street": "Straße und Hausnummer",
187
+ "address_line2": "Adresszusatz",
188
+ "postal_code": "Postleitzahl",
189
+ "zip_code": "ZIP-Code",
190
+ "postcode": "Postcode",
191
+ "city": "Ort",
192
+ "town": "Ort",
193
+ "region": "Region",
194
+ "state": "Bundesstaat",
195
+ "province": "Provinz",
196
+ "county": "County",
197
+ "prefecture": "Präfektur",
198
+ "canton": "Kanton",
199
+ "latitude": "Breitengrad",
200
+ "longitude": "Längengrad",
201
+ "locate": "Aus der Adresse ermitteln",
202
+ "not_found": "Die Adresse wurde auf der Karte nicht gefunden.",
203
+ "no_location": "Noch kein Standort — Adresse oder Koordinaten eingeben.",
204
+ "map": "Karte der Adresse",
205
+ "open_in_google_maps": "In Google Maps öffnen"
206
+ },
207
+ "geo_location": {
208
+ "capture": "Meinen Standort erfassen",
209
+ "recapture": "Standort erneut erfassen",
210
+ "none": "Noch kein Standort erfasst.",
211
+ "captured_at": "Erfasst {{ time }}",
212
+ "unavailable": "Dieser Browser kann Ihren Standort nicht ermitteln, oder Sie haben es dieser Website nicht erlaubt.",
213
+ "open_in_google_maps": "In Google Maps öffnen",
214
+ "error": {
215
+ "PERMISSION_DENIED": "Der Standortzugriff wurde verweigert. Erlauben Sie ihn in den Website-Einstellungen des Browsers.",
216
+ "POSITION_UNAVAILABLE": "Das Gerät konnte seinen Standort nicht bestimmen.",
217
+ "TIMEOUT": "Die Standortermittlung hat zu lange gedauert. Bitte erneut versuchen.",
218
+ "UNAVAILABLE": "Dieser Browser kann Ihren Standort nicht ermitteln."
219
+ }
220
+ },
221
+ "working_context": {
222
+ "search": "Suchen",
223
+ "recent": "Zuletzt verwendet",
224
+ "all": "Alle",
225
+ "no_match": "Keine Treffer",
226
+ "empty_state": "{{ entity }} auswählen",
227
+ "switch_title": "{{ entity }} wechseln",
228
+ "select_to_continue": "Wählen Sie einen Eintrag und drücken Sie „Als Kontextobjekt setzen“, um zur gewünschten Seite zu gelangen.",
229
+ "show_list": "Gesamte Liste anzeigen",
230
+ "menu": "Kontextaktionen",
231
+ "switch": "Wechseln",
232
+ "open": "Zum Bearbeiten öffnen",
233
+ "clear": "Kontext aufheben",
234
+ "set_active": "Als Kontextobjekt setzen",
235
+ "is_active": "Aktiv",
236
+ "confirm_switch": {
237
+ "title": "Aktiven Kontext verlassen?",
238
+ "content": "{{ entity }} ist noch in Bearbeitung. Wirklich verlassen?",
239
+ "cancel_button": "Bleiben",
240
+ "confirm_button": "Verlassen"
241
+ },
242
+ "only_active": "Nur das aktive {{context}}"
243
+ },
244
+ "context_collection": {
245
+ "add": "Hinzufügen",
246
+ "edit": "Bearbeiten",
247
+ "delete": "Löschen",
248
+ "save": "Speichern",
249
+ "cancel": "Abbrechen",
250
+ "empty": "Noch nichts vorhanden.",
251
+ "delete_title": "Diesen Eintrag löschen?",
252
+ "delete_content": "Das lässt sich nicht rückgängig machen.",
253
+ "conflict": "Jemand anderes hat dies gleichzeitig geändert. Die Liste zeigt den gespeicherten Stand — bitte erneut versuchen."
254
+ },
255
+ "list": {
256
+ "show_retired": "Stillgelegte Datensätze anzeigen"
82
257
  }
83
258
  }
@@ -7,12 +7,42 @@
7
7
  "formControlType": "Control Type",
8
8
  "displayOrder": "Display Order",
9
9
  "required": "Required",
10
- "isMultiValued": "Multi-valued",
10
+ "multiplicity": "Multiplicity",
11
+ "maxOccurs": "Max occurs",
11
12
  "indexed": "Indexed",
12
13
  "isLinkToDetails": "Titles the record",
14
+ "autosizeColumn": "Hugs its list column",
13
15
  "linkedEntityType": "Linked Entity",
14
16
  "defaultValue": "Default Value",
15
- "enumValues": "Enum Values"
17
+ "enumValues": "Enum Values",
18
+ "dateStyle": "Date Style",
19
+ "timeStyle": "Time Style",
20
+ "defaultAvatar": "Default Avatar",
21
+ "showMap": "Shows a map",
22
+ "mapProvider": "Map provider",
23
+ "defaultCountry": "Default country",
24
+ "_tooltips": {
25
+ "code": "Key the value is stored under, unique within the entity type, e.g. orderNumber. Avoid changing it once records exist.",
26
+ "name": "The field's label as users see it on forms and list columns, e.g. Order number.",
27
+ "valueKind": "What kind of value the field holds: text, number, yes/no, date, date and time, a choice from a list (ENUM) or a reference to another record. Decides how values are checked and compared.",
28
+ "formControlType": "Which input users fill the field in with, e.g. TEXT_BOX, TEXTAREA, DROPDOWN or CHECKBOX. Pick one that suits the value kind.",
29
+ "displayOrder": "Position of the field on the form and of its column in the list; lower numbers come first, e.g. 10, 20, 30.",
30
+ "multiplicity": "How many values the field takes: 0..1 at most one, 0..n / 1..n any number (at least one with 1..), 0..x / 1..x up to Max occurs. Leave empty for a single value.",
31
+ "maxOccurs": "Upper limit on the number of values, e.g. 5. Only used with the multiplicities 0..x and 1..x.",
32
+ "required": "Whether users must fill the field in before they can save the record.",
33
+ "indexed": "Tick for fields users often search or filter on, e.g. a customer number; it makes those queries fast.",
34
+ "isLinkToDetails": "Tick for the field that names the record, e.g. the order number: it opens the record from the list and heads its form. At most one field per entity type.",
35
+ "autosizeColumn": "Tick to make the field's list column only as wide as its content, e.g. for short codes or flags.",
36
+ "enumValues": "For the ENUM value kind: the options users choose from, one chip each, e.g. NEW, PAID, SHIPPED.",
37
+ "linkedEntityType": "For reference fields (FOREIGN_KEY) and embedded rows (EMBEDDED_COMPONENTS): the code of the entity type they point at, e.g. customer.",
38
+ "defaultValue": "Value pre-filled in new records, e.g. NEW or 1. Leave empty for none.",
39
+ "defaultAvatar": "For AVATAR controls: icon name (e.g. person, sailing) or image URL to show before an image is uploaded.",
40
+ "showMap": "For ADDRESS controls: show the address on a map, with coordinates derived from it.",
41
+ "mapProvider": "For ADDRESS controls with a map: who draws it. Empty uses OpenStreetMap; a click always opens Google Maps.",
42
+ "defaultCountry": "For ADDRESS controls: the ISO country code a new address starts with, e.g. HU. Empty uses the browser's country.",
43
+ "dateStyle": "For DATE and DATE_TIME fields: how the date is shown, from short (12/31/26) to full (Thursday, December 31, 2026). Empty uses the default.",
44
+ "timeStyle": "For DATE_TIME fields: how the time is shown, from short (14:30) to long (with seconds and time zone). Empty uses the default."
45
+ }
16
46
  },
17
47
  "entity_definition": {
18
48
  "_self": "Entity Definition",
@@ -21,13 +51,45 @@
21
51
  "description": "Description",
22
52
  "status": "Status",
23
53
  "isEmbedded": "Embedded",
54
+ "canContextObject": "Context object",
24
55
  "componentParents": "Component Parents",
25
56
  "attributes": "Attributes",
26
57
  "version": "Version",
27
- "updatedAt": "Updated At"
58
+ "updatedAt": "Updated At",
59
+ "releaseState": "Release",
60
+ "sharedFrom": "Shared from",
61
+ "_tooltips": {
62
+ "code": "Unique key of the entity type within your organization, used in addresses. Short, lower-case and URL-safe, e.g. order; avoid changing it later.",
63
+ "name": "The entity name the application's pages, routes and menus refer to this type by, e.g. Order.",
64
+ "description": "A note for you and your fellow designers about what this entity type is for; users do not see it.",
65
+ "status": "ACTIVE for a type in use, DEPRECATED to retire it: the application no longer shows a deprecated type. Whether the application has the type at all is its release, shown under Release.",
66
+ "isEmbedded": "Tick when records of this type exist only inside another record, e.g. order lines inside an order. Then also name the parent under Component Parents.",
67
+ "canContextObject": "Tick to let users pick one record of this type as the context object: the record whose embedded parts are then listed and edited without naming it again. Not for embedded types.",
68
+ "componentParents": "For an embedded type: the codes of the entity types whose records contain it, e.g. order. Required when Embedded is ticked.",
69
+ "attributes": "The fields of the entity type, one row per field. They are saved together with the definition.",
70
+ "version": "Increases with every save. Set by the system.",
71
+ "updatedAt": "When the definition was last saved. Set by the system.",
72
+ "releaseState": "Whether the running application uses this definition as it stands: NEW was never published, CHANGED differs from what was published, RELEASED is what the application uses. Publish in the Release section to change it. Set by the system.",
73
+ "sharedFrom": "The common this type comes from. Its organization reads the type, but only the common releases or changes it. Empty for your own types. Set by the system."
74
+ }
28
75
  },
29
76
  "artifact": {
30
- "upload_failure": "Artifact upload failed. Please try again."
77
+ "upload_failure": "Artifact upload failed. Please try again.",
78
+ "invalid_file_type": "Only image files are allowed.",
79
+ "camera_capture": "Take photo or video"
80
+ },
81
+ "camera_capture": {
82
+ "title": "Camera",
83
+ "mode": "Capture mode",
84
+ "photo": "Photo",
85
+ "video": "Video",
86
+ "take_photo": "Take photo",
87
+ "start_recording": "Start recording",
88
+ "stop_recording": "Stop recording",
89
+ "retake": "Retake",
90
+ "use": "Use",
91
+ "cancel": "Cancel",
92
+ "unavailable": "The camera could not be started. Check that camera access is allowed for this site."
31
93
  },
32
94
  "delete_artifact_confirmation_dialog": {
33
95
  "title": "Delete artifact?",
@@ -42,7 +104,15 @@
42
104
  "delete_button": "Delete"
43
105
  },
44
106
  "statusbar": {
45
- "breadcrumb_label": "Record hierarchy"
107
+ "breadcrumb_label": "Record hierarchy",
108
+ "unsaved_changes": "Unsaved changes",
109
+ "unsaved_changes_hint": "Save the {{ entity }} to keep these changes"
110
+ },
111
+ "unsaved_changes_dialog": {
112
+ "title": "Unsaved changes",
113
+ "content": "You have unsaved changes. If you leave this page, they will be lost.",
114
+ "cancel_button": "Stay",
115
+ "leave_button": "Leave"
46
116
  },
47
117
  "tabs": {
48
118
  "list": "{{ entity }} - list",
@@ -55,7 +125,9 @@
55
125
  "filter_tooltip": "Filter the loaded rows by text",
56
126
  "edit_tooltip": "Edit the selected record",
57
127
  "new_tooltip": "Create a new record",
58
- "delete_tooltip": "Delete the selected records"
128
+ "delete_tooltip": "Delete the selected records",
129
+ "export_menu": "Export",
130
+ "actions_menu": "Choose action"
59
131
  },
60
132
  "pdf_export": {
61
133
  "button": "PDF",
@@ -78,6 +150,109 @@
78
150
  "apply_button": "Apply"
79
151
  },
80
152
  "embedded_components": {
81
- "save_owner_first": "Save this record before adding {{ entity }} — an embedded component is stored inside it."
153
+ "save_owner_first": "Save this record before adding {{ entity }} — an embedded component is stored inside it.",
154
+ "move_up": "Move up",
155
+ "move_down": "Move down",
156
+ "hide_list": "Hide the list",
157
+ "show_list": "Show the list",
158
+ "hidden_count": "{{ count }} hidden"
159
+ },
160
+ "rich_text": {
161
+ "toolbar": {
162
+ "label": "Text formatting",
163
+ "bold": "Bold",
164
+ "italic": "Italic",
165
+ "strike": "Strikethrough",
166
+ "code": "Inline code",
167
+ "heading_1": "Heading 1",
168
+ "heading_2": "Heading 2",
169
+ "heading_3": "Heading 3",
170
+ "bullet_list": "Bullet list",
171
+ "ordered_list": "Numbered list",
172
+ "blockquote": "Quote",
173
+ "horizontal_rule": "Divider",
174
+ "undo": "Undo",
175
+ "redo": "Redo"
176
+ }
177
+ },
178
+ "comments": {
179
+ "title": "Comments",
180
+ "new_placeholder": "Write a comment…",
181
+ "unknown_author": "Unknown",
182
+ "count": "{{ count }} comments"
183
+ },
184
+ "address": {
185
+ "country": "Country",
186
+ "street": "Street and number",
187
+ "address_line2": "Address line 2",
188
+ "postal_code": "Postal code",
189
+ "zip_code": "ZIP code",
190
+ "postcode": "Postcode",
191
+ "city": "City",
192
+ "town": "Town",
193
+ "region": "Region",
194
+ "state": "State",
195
+ "province": "Province",
196
+ "county": "County",
197
+ "prefecture": "Prefecture",
198
+ "canton": "Canton",
199
+ "latitude": "Latitude",
200
+ "longitude": "Longitude",
201
+ "locate": "Locate from the address",
202
+ "not_found": "The address could not be found on the map.",
203
+ "no_location": "No location yet — fill in the address or the coordinates.",
204
+ "map": "Map of the address",
205
+ "open_in_google_maps": "Open in Google Maps"
206
+ },
207
+ "geo_location": {
208
+ "capture": "Record my location",
209
+ "recapture": "Record my location again",
210
+ "none": "No location recorded yet.",
211
+ "captured_at": "Recorded {{ time }}",
212
+ "unavailable": "This browser cannot tell your location, or you have not allowed this site to read it.",
213
+ "open_in_google_maps": "Open in Google Maps",
214
+ "error": {
215
+ "PERMISSION_DENIED": "Location access was refused. Allow it in the browser's site settings to record a location.",
216
+ "POSITION_UNAVAILABLE": "The device could not determine its location.",
217
+ "TIMEOUT": "Reading the location took too long. Try again.",
218
+ "UNAVAILABLE": "This browser cannot tell your location."
219
+ }
220
+ },
221
+ "working_context": {
222
+ "search": "Search",
223
+ "recent": "Recent",
224
+ "all": "All",
225
+ "no_match": "Nothing matches",
226
+ "empty_state": "Select a {{ entity }}",
227
+ "switch_title": "Switch {{ entity }}",
228
+ "select_to_continue": "Select one and press \"Set as context object\" to continue to the page you asked for.",
229
+ "show_list": "Show the full list",
230
+ "menu": "Context actions",
231
+ "switch": "Switch",
232
+ "open": "Open for editing",
233
+ "clear": "Clear context",
234
+ "set_active": "Set as context object",
235
+ "is_active": "Active",
236
+ "confirm_switch": {
237
+ "title": "Leave the active context?",
238
+ "content": "{{ entity }} is still in progress. Do you really want to leave it?",
239
+ "cancel_button": "Stay",
240
+ "confirm_button": "Leave"
241
+ },
242
+ "only_active": "Only the active {{context}}"
243
+ },
244
+ "context_collection": {
245
+ "add": "Add",
246
+ "edit": "Edit",
247
+ "delete": "Delete",
248
+ "save": "Save",
249
+ "cancel": "Cancel",
250
+ "empty": "Nothing here yet.",
251
+ "delete_title": "Delete this item?",
252
+ "delete_content": "This cannot be undone.",
253
+ "conflict": "Someone else changed this at the same time. The list shows what is stored now — please try again."
254
+ },
255
+ "list": {
256
+ "show_retired": "Show retired records"
82
257
  }
83
258
  }