@processpuzzle/base-app 0.2.1 → 0.4.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
@@ -1,12 +1,24 @@
1
- # @processpuzzle/base-app-frontend
1
+ # @processpuzzle/base-app
2
2
 
3
3
  ![Build and Test](https://github.com/ZsZs/processpuzzle/actions/workflows/build-base-app-frontend.yml/badge.svg)
4
4
  [![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=processpuzzle_base_app_frontend&metric=alert_status)](https://sonarcloud.io/summary?id=processpuzzle_base_app_frontend)
5
- [![Node version](https://img.shields.io/npm/v/%40processpuzzle%2Fbase-app-frontend?style=flat)](https://www.npmjs.com/package/@processpuzzle/base-app-frontend)
5
+ [![npm version](https://img.shields.io/npm/v/%40processpuzzle%2Fbase-app?style=flat)](https://www.npmjs.com/package/@processpuzzle/base-app)
6
6
 
7
7
  ## Introduction
8
8
 
9
- `@processpuzzle/base-app-frontend` is the front-end building block of the ProcessPuzzle application shell. It provides the Angular shell (workspace layout, navigation, dockable panels, task surfaces) that hosts the other ProcessPuzzle Low-Code building blocks. The library complements the [`base-app-backend`](../../java-shared/base-app-backend/README.md) Spring Boot module that exposes application-level services such as user workspace and preferences.
9
+ `@processpuzzle/base-app` is the front-end building block of the ProcessPuzzle application shell. It provides the Angular shell (workspace layout, navigation, dockable panels, task surfaces) that hosts the other ProcessPuzzle Low-Code building blocks. The library complements the [`base-app-backend`](../../java-shared/base-app-backend/README.md) Spring Boot module that exposes application-level services such as user workspace and preferences.
10
+
11
+ ## Modules: translations and assets
12
+
13
+ The Module form has two sections that are not form fields — nothing in them is saved with the module — so they are disabled controls the form never
14
+ submits. **Translations** downloads the prepared files (one per supported language), takes the translated zip or file back, and shows how far each
15
+ language is covered. **Assets** lists the files the module brings along and adds or removes them one by one.
16
+
17
+ When a module is mounted, its transloco scope is registered with an inline loader that reads the uploaded translations (draft in the Preview, released
18
+ in the live app) over whatever the scope already ships, and every route title is translated under its `translocoId` or the derived
19
+ `<scope>.route.<path>`. The mount also provides a `MODULE_ASSET_CONTEXT`: a widget property saying `module:docs/welcome.md` — `markdownSrc` of the
20
+ markdown widget, `src` of the image widgets — is looked up among the module's own files, and relative images and links inside a module's markdown file
21
+ resolve against that file's path. See [the plan](../../../docs/module-refinement-plan.md).
10
22
 
11
23
  ## Status
12
24
  This library is currently a scaffold. The public API will grow as the application shell takes shape.
@@ -24,13 +24,68 @@
24
24
  "modules": "Module",
25
25
  "tabs": {
26
26
  "preview": "{{ entity }} - Vorschau"
27
- }
27
+ },
28
+ "translations": "Übersetzungen",
29
+ "translations_panel": {
30
+ "hint": "Eine Datei je unterstützter Sprache enthält die Texte der eigenen Seiten der Anwendung. Tragen Sie die Werte unter den Schlüsseln ein, die Ihre Widgets nennen, und laden Sie das Zip (oder eine einzelne Datei) wieder hoch.",
31
+ "download": "Alle herunterladen",
32
+ "upload": "Übersetzungen hochladen",
33
+ "save_first": "Speichern Sie zuerst die Anwendung; die Texte gehören zur gespeicherten Anwendung.",
34
+ "stored": "{{count}} Schlüssel gespeichert",
35
+ "none_stored": "Es sind noch keine Texte gespeichert.",
36
+ "key": "Schlüssel",
37
+ "text": "Text"
38
+ },
39
+ "assets": "Dateien",
40
+ "assets_panel": {
41
+ "hint": "Fügen Sie Dateien einzeln hinzu, etwa die Bilder der Anwendungsseiten. Widgets verweisen als app:<Pfad> auf eine Datei.",
42
+ "path": "Verweis",
43
+ "type": "Typ",
44
+ "size": "Größe",
45
+ "remove": "Entfernen",
46
+ "none": "Noch keine Dateien.",
47
+ "folder": "Ordner",
48
+ "upload": "Dateien hochladen",
49
+ "save_first": "Speichern Sie zuerst die Anwendung; Dateien gehören zur gespeicherten Anwendung."
50
+ },
51
+ "_tooltips": {
52
+ "id": "Eindeutig innerhalb Ihrer Organisation und unverändert in der URL der Anwendung verwendet. Kurz, kleingeschrieben und mit Bindestrichen, z. B. claims-app; ändern Sie sie später möglichst nicht. — Leitfaden: Anwendung",
53
+ "name": "Der Name der Anwendung, wie Benutzer ihn sehen, z. B. im Widget app-title. — Leitfaden: Anwendung",
54
+ "translocoId": "Optionaler Übersetzungsschlüssel; wenn gesetzt, wird er in anderen Sprachen anstelle des Namens angezeigt. — Leitfaden: Anwendung",
55
+ "description": "Eine Notiz für Sie und Ihre Designer-Kollegen; Benutzer sehen sie nicht. — Leitfaden: Anwendung",
56
+ "status": "DRAFT, solange die Definition Änderungen hat, die die Organisation nicht freigegeben hat, danach PUBLISHED. Vom System gesetzt. — Leitfaden: Speichern, Vorschau und Freigabe",
57
+ "version": "Erhöht sich bei jedem Speichern. Wird vom System gesetzt. — Leitfaden: Speichern, Vorschau und Freigabe",
58
+ "publishedVersion": "Die Version, die die Benutzer derzeit erhalten. Ändert sich erst, wenn die Organisation im Bereich Freigabe des Designers freigegeben wird. — Leitfaden: Speichern, Vorschau und Freigabe",
59
+ "updatedAt": "Wann die Definition zuletzt gespeichert wurde. Wird vom System gesetzt.",
60
+ "materialTheme": "Die Farbpalette der gesamten Anwendung. processpuzzle ist das Marken-Design; die anderen färben auch Kopfzeile, Seitennavigation, Karten und Schaltflächen um. — Leitfaden: Theme",
61
+ "colorScheme": "Hell, dunkel oder automatisch (folgt dem Betriebssystem des Benutzers). — Leitfaden: Theme",
62
+ "logoUrl": "Adresse des Logobilds, das das Widget app-logo anzeigt. — Leitfaden: Theme",
63
+ "faviconUrl": "Adresse des kleinen Symbols im Browser-Tab. — Leitfaden: Theme",
64
+ "tokenOverrides": "Feinabstimmung über dem Theme: ein --pp-…-Farbtoken und sein Wert, z. B. --pp-surface-sidenav = #0d1b2a. — Leitfaden: Theme",
65
+ "preset": "Wo die Navigation sitzt: in einem Seitenbereich links oder rechts oder in der Kopfzeile (top-nav). — Leitfaden: Layout",
66
+ "sidenavMode": "side: Bereich neben der Seite · over: Bereich über der Seite · push: Die Seite rückt beiseite, solange der Bereich geöffnet ist. — Leitfaden: Layout",
67
+ "contentMaxWidth": "Maximale Breite der Seiten als CSS-Länge, z. B. 1280px; leer bedeutet volle Breite. — Leitfaden: Layout",
68
+ "sidenavCollapsible": "Ob Benutzer den Navigationsbereich schließen können. — Leitfaden: Layout",
69
+ "sidenavOpenByDefault": "Ob der Navigationsbereich anfangs geöffnet ist. — Leitfaden: Layout",
70
+ "regions": "Der Rahmen um die Seiten: header, sidenav und footer, von jedem höchstens einer. — Leitfaden: Bereiche",
71
+ "routes": "Die Seiten der Anwendung, eine Zeile pro Seite. Legen Sie sie vor den Navigationseinträgen an, die auf sie verweisen. — Leitfaden: Routen",
72
+ "modules": "Separat erstellte Teile der Anwendung, deren Routen unter einem Basispfad erscheinen. — Leitfaden: Module",
73
+ "assets": "Dateien, die die Anwendung mitbringt, etwa die Bilder ihrer Seiten. Ein Widget verweist als app:<Pfad> darauf. — Leitfaden: Anwendungen",
74
+ "translations": "Die Texte der eigenen Seiten der Anwendung, etwa der Karten ihrer Startseite, eine Datei je Sprache. Schlüssel sind die, die Widgets unter ihrem translocoPrefix nennen. — Leitfaden: Anwendungen",
75
+ "contexts": "Entitäten, die man einmal wählt und in denen man dann arbeitet. Eine Seite nimmt per Kontext erforderlich teil."
76
+ },
77
+ "contexts": "Kontexte"
28
78
  },
29
79
  "app_region": {
30
80
  "_self": "Bereich",
31
81
  "type": "Typ",
32
82
  "navItems": "Navigationseinträge",
33
- "widgets": "Widgets"
83
+ "widgets": "Widgets",
84
+ "_tooltips": {
85
+ "type": "header (oben), sidenav (Navigationsbereich) oder footer (unten). Jeder Typ kann einmal verwendet werden. Statusbar (unter der Kopfzeile) zeigt die aktiven Kontexte. — Leitfaden: Bereiche",
86
+ "navItems": "Die Menüeinträge der Seitennavigation. Nur vom Bereich sidenav verwendet. — Leitfaden: Navigationseinträge",
87
+ "widgets": "Die Widgets der Kopf- oder Fußzeile, in dieser Reihenfolge in einer Zeile angeordnet. Mit einem spacer schieben Sie die folgenden nach rechts. — Leitfaden: Kopfzeile (header)"
88
+ }
34
89
  },
35
90
  "app_route": {
36
91
  "_self": "Route",
@@ -44,12 +99,35 @@
44
99
  "documentSlug": "Dokument-Slug",
45
100
  "entityName": "Entitätsname",
46
101
  "entityMode": "Entitätsmodus",
47
- "rsqlFilter": "RSQL-Filter"
102
+ "rsqlFilter": "RSQL-Filter",
103
+ "_tooltips": {
104
+ "path": "Die Adresse der Seite relativ zur Anwendung, ohne führenden Schrägstrich, z. B. claims/open. Ein Segment :name ist ein Parameter, z. B. claims/:id. — Leitfaden: Routen",
105
+ "title": "Der Titel der Seite. — Leitfaden: Routen",
106
+ "translocoId": "Optionaler Übersetzungsschlüssel des Titels, in anderen Sprachen anstelle des Titels angezeigt. — Leitfaden: Routen",
107
+ "icon": "Ein Material- oder FontAwesome-Symbolname. — Leitfaden: Routen",
108
+ "roles": "Die Rollen, die diese Seite öffnen dürfen; leer bedeutet jedes angemeldete Mitglied Ihrer Organisation. Noch nicht durchgesetzt. — Leitfaden: Rollen",
109
+ "kind": "Was die Seite zeigt: WIDGETS, ENTITY (generierte Liste und Formular einer Entität) oder DOCUMENT. Die Felder darunter gelten nur für die gewählte Art. — Leitfaden: Routen",
110
+ "widgets": "Nur WIDGETS: die Widgets der Seite, in dieser Reihenfolge untereinander angezeigt. — Leitfaden: Widgets",
111
+ "documentSlug": "Nur DOCUMENT: der Slug des anzuzeigenden Dokuments. Wird noch nicht dargestellt. — Leitfaden: Dokumente",
112
+ "entityName": "Nur ENTITY: der Name einer unter Entitäten definierten Entität; Liste und Formular werden für Sie generiert. — Leitfaden: Entitäten",
113
+ "entityMode": "Nur ENTITY: mit der Liste oder den Details eines Datensatzes öffnen. Gespeichert, aber noch nicht angewendet. — Leitfaden: Entitäten",
114
+ "rsqlFilter": "Nur ENTITY + LIST: ein Vorfilter wie status==OPEN. Gespeichert, aber noch nicht angewendet. — Leitfaden: Entitäten",
115
+ "requiresContext": "Name eines Kontexts dieser Anwendung. Die Seite liegt dann unter ctx/<name>/<id> und zeigt „Auswählen …“, solange keiner aktiv ist.",
116
+ "contextPath": "Das Attribut der Kontext-Entität, deren Sammlung diese Seite auflistet, z. B. zones. Braucht „Kontext erforderlich“; der Entitätsname ist dann der Typ der Einträge.",
117
+ "filterByContext": "Zeigt nur die Zeilen der aktiven Entität dieses Kontexts, mit einem Schalter für alle. Das Feld „Kontext erforderlich“ bleibt leer: die Seite funktioniert ohne Kontext."
118
+ },
119
+ "requiresContext": "Kontext erforderlich",
120
+ "contextPath": "Kontextpfad",
121
+ "filterByContext": "Nach Kontext filtern"
48
122
  },
49
123
  "app_module_mount": {
50
124
  "_self": "Modul-Einbindung",
51
125
  "moduleKey": "Modulschlüssel",
52
- "basePath": "Basispfad"
126
+ "basePath": "Basispfad",
127
+ "_tooltips": {
128
+ "moduleKey": "Der Schlüssel eines unter Module erstellten Moduls. — Leitfaden: Module",
129
+ "basePath": "Das Präfix, unter dem die Routen des Moduls erscheinen: Basispfad claims macht aus der Modulroute open claims/open. — Leitfaden: Module"
130
+ }
53
131
  },
54
132
  "app_nav_item": {
55
133
  "_self": "Navigationseintrag",
@@ -59,14 +137,29 @@
59
137
  "icon": "Symbol",
60
138
  "routePath": "Route",
61
139
  "roles": "Rollen",
62
- "children": "Untereinträge"
140
+ "children": "Untereinträge",
141
+ "_tooltips": {
142
+ "id": "Eindeutiger Bezeichner des Eintrags innerhalb des Menüs, z. B. nav-claims. — Leitfaden: Navigationseinträge",
143
+ "label": "Der Text des Menüeintrags. — Leitfaden: Navigationseinträge",
144
+ "translocoId": "Optionaler Übersetzungsschlüssel der Bezeichnung, in anderen Sprachen anstelle der Bezeichnung angezeigt. — Leitfaden: Navigationseinträge",
145
+ "icon": "Ein Material- oder FontAwesome-Symbolname. — Leitfaden: Navigationseinträge",
146
+ "routePath": "Der Pfad der Route, die dieser Eintrag öffnet, genau wie bei der Route angegeben. Leer lassen, um den Eintrag zu einer Gruppe seiner Untereinträge zu machen. — Leitfaden: Navigationseinträge",
147
+ "roles": "Die Rollen, die diesen Eintrag sehen dürfen; leer bedeutet jedes angemeldete Mitglied Ihrer Organisation. Noch nicht durchgesetzt. — Leitfaden: Rollen",
148
+ "children": "Die Einträge unter einem Gruppeneintrag. Nur sinnvoll, wenn Route leer ist. — Leitfaden: Navigationseinträge"
149
+ }
63
150
  },
64
151
  "app_widget": {
65
152
  "_self": "Widget",
66
153
  "id": "Id",
67
154
  "type": "Typ",
68
155
  "props": "Eigenschaften",
69
- "placement": "Platzierung"
156
+ "placement": "Platzierung",
157
+ "_tooltips": {
158
+ "id": "Eindeutig innerhalb seiner Seite oder seines Bereichs, z. B. widget-claims-grid. Ein Container-Widget verweist über diese Id auf andere Widgets. — Leitfaden: Widgets",
159
+ "type": "Welches Widget dies ist; angeboten werden nur die in dieser Installation verfügbaren Widgets. — Leitfaden: Widgets",
160
+ "props": "Die Einstellungen des Widgets. Das Formular passt sich dem gewählten Typ an. — Leitfaden: Widgets",
161
+ "placement": "STANDALONE: dort angezeigt, wo es aufgeführt ist. REFERENCED: nur innerhalb des Container-Widgets angezeigt, das seine Id aufführt. — Leitfaden: Widgets"
162
+ }
70
163
  },
71
164
  "module_definition": {
72
165
  "_self": "Modul",
@@ -77,10 +170,134 @@
77
170
  "translocoScope": "Transloco-Bereich",
78
171
  "version": "Version",
79
172
  "updatedAt": "Geändert am",
80
- "routes": "Routen"
173
+ "routes": "Routen",
174
+ "translations": "Übersetzungen",
175
+ "translations_panel": {
176
+ "hint": "Eine Datei je unterstützter Sprache enthält alle übersetzbaren Texte des Moduls und die Texte, die seine Widgets unter dem Scope des Moduls nennen. Übersetzen Sie die Werte, behalten Sie die Schlüssel und laden Sie das Zip (oder eine einzelne Datei) wieder hoch.",
177
+ "language": "Sprache",
178
+ "translated": "Übersetzt",
179
+ "download": "Dateien herunterladen",
180
+ "upload": "Übersetzungen hochladen",
181
+ "save_first": "Speichern Sie zuerst das Modul; die Dateien werden aus dem gespeicherten Modul erstellt.",
182
+ "stored": "{{count}} Schlüssel gespeichert",
183
+ "additional": "{{count}} Widget-Texte behalten",
184
+ "missing": "{{count}} Schlüssel fehlen",
185
+ "untranslated": "{{count}} noch gleich dem Original"
186
+ },
187
+ "assets": "Dateien",
188
+ "assets_panel": {
189
+ "hint": "Fügen Sie Dateien einzeln hinzu; eine Markdown-Datei kann die anderen relativ verlinken. Widgets verweisen als module:<Pfad> auf eine Datei.",
190
+ "path": "Verweis",
191
+ "type": "Typ",
192
+ "size": "Größe",
193
+ "remove": "Entfernen",
194
+ "none": "Noch keine Dateien.",
195
+ "folder": "Ordner",
196
+ "upload": "Dateien hochladen",
197
+ "save_first": "Speichern Sie zuerst das Modul; Dateien gehören zum gespeicherten Modul."
198
+ },
199
+ "_tooltips": {
200
+ "id": "Eindeutig innerhalb Ihrer Organisation; Anwendungen binden das Modul über diesen Schlüssel ein. Darf sich nicht ändern, sobald das Modul verwendet wird. — Leitfaden: Module",
201
+ "name": "Der Name des Moduls. — Leitfaden: Module",
202
+ "translocoId": "Optionaler Übersetzungsschlüssel des Namens. — Leitfaden: Module",
203
+ "description": "Eine Notiz für Sie und Ihre Designer-Kollegen. — Leitfaden: Module",
204
+ "translocoScope": "Der Bereich, unter dem die Übersetzungen des Moduls geladen werden; leer bedeutet der Schlüssel. — Leitfaden: Module",
205
+ "version": "Erhöht sich bei jedem Speichern. Wird vom System gesetzt.",
206
+ "updatedAt": "Wann das Modul zuletzt gespeichert wurde. Wird vom System gesetzt.",
207
+ "routes": "Die Seiten des Moduls. Ihre Pfade sind relativ zum Basispfad, unter dem das Modul eingebunden ist. — Leitfaden: Module",
208
+ "translations": "Laden Sie die Übersetzungsdateien des Moduls herunter, übersetzen Sie sie offline und laden Sie sie wieder hoch. — Leitfaden: Module",
209
+ "assets": "Dateien, die das Modul mitbringt – Markdown-Seiten, Bilder. Ein Widget verweist als module:<Pfad> darauf. — Leitfaden: Module"
210
+ }
211
+ },
212
+ "concepts": {
213
+ "title": "Wie eine dynamische Anwendung aufgebaut ist",
214
+ "intro": "Eine <b>Anwendung</b> wird in ProcessPuzzle nicht programmiert – sie wird <b>beschrieben</b>. Alles, was Sie hier eingeben (der Rahmen, das Menü, die Seiten und was jede Seite zeigt), wird als Daten gespeichert, und die Anwendungsoberfläche baut daraus zur Laufzeit die laufende Anwendung auf. Um die Anwendung zu ändern, bearbeiten Sie ihre Definition und veröffentlichen sie erneut; es muss nichts neu gebaut oder neu ausgeliefert werden.",
215
+ "assembling": {
216
+ "title": "Ihre Anwendung Schritt für Schritt zusammenstellen",
217
+ "body": "<ol><li><b>Anwendung anlegen</b> – geben Sie ihr eine Id und einen Namen.</li><li><b>Aussehen wählen</b> – ein Material-Theme, ein Farbschema und eine Layout-Vorlage.</li><li><b>Seiten hinzufügen</b> – eine <b>Route</b> pro Seite; legen Sie fest, was jede davon zeigt: Widgets, eine Entität oder ein Dokument.</li><li><b>Rahmen bauen</b> – fügen Sie die Bereiche <b>header</b>, <b>sidenav</b> und <b>footer</b> hinzu; füllen Sie header und footer mit Widgets und die sidenav mit Navigationseinträgen, die auf Ihre Routen verweisen.</li><li><b>Prüfen</b> Sie das Ergebnis im Tab <b>Vorschau</b>.</li><li><b>Geben Sie sie frei</b> – im Bereich <b>Freigabe</b> des Designers –, damit die Benutzer die neue Version erhalten.</li></ol><p>Routen kommen bewusst vor der Navigation: Ein Navigationseintrag verweist über ihren Pfad auf eine Route, daher lässt er sich am einfachsten anlegen, wenn die Route bereits existiert.</p>"
218
+ },
219
+ "application": {
220
+ "title": "Anwendung",
221
+ "body": "<p>Der oberste Datensatz, der alles andere enthält. Ihre <b>Id</b> ist innerhalb Ihrer Organisation eindeutig und wird unverändert in der URL der Anwendung verwendet. Wählen Sie daher einen kurzen Wert in Kleinbuchstaben mit Bindestrichen, z. B. <code>claims-app</code>, und ändern Sie ihn später möglichst nicht. Der <b>Name</b> ist das, was die Benutzer sehen, zum Beispiel im Widget <code>app-title</code>; die optionale <b>Transloco-Id</b> ist ein Übersetzungsschlüssel, der anstelle des Namens verwendet wird, wenn die Anwendung in anderen Sprachen angezeigt wird. Die <b>Beschreibung</b> ist für Sie und Ihre Designer-Kollegen gedacht.</p>"
222
+ },
223
+ "theme": {
224
+ "title": "Theme",
225
+ "body": "<p>Bestimmt die Farben der gesamten Anwendung.</p><ul><li><b>Material-Theme</b> – <code>processpuzzle</code> ist das Marken-Design und die Voreinstellung; die anderen sind Angular-Material-Paletten, und jede davon färbt auch header, sidenav, Karten und Schaltflächen passend ein.</li><li><b>Farbschema</b> – hell, dunkel oder automatisch (richtet sich nach dem Betriebssystem des Benutzers).</li><li><b>Logo-URL</b> und <b>Favicon-URL</b> – die Bilder, die das Widget <code>app-logo</code> und der Browser-Tab anzeigen.</li><li><b>Token-Überschreibungen</b> – Feinabstimmung zusätzlich zum Theme: ein <code>--pp-…</code>-Farbtoken und sein Wert, z. B. <code>--pp-surface-sidenav</code> → <code>#0d1b2a</code>.</li></ul><p>Was Sie hier wählen, ist die <i>Voreinstellung</i> der Anwendung. Wenn Sie ein Widget <code>themes-button</code> im header platzieren, kann jeder Benutzer ein eigenes Theme wählen, das dann für ihn gespeichert wird.</p>"
226
+ },
227
+ "layout": {
228
+ "title": "Layout",
229
+ "body": "<p>Bestimmt, wo die Bereiche rund um die Seiten liegen.</p><ul><li><b>Layout-Vorlage</b> – <code>sidenav-left</code> oder <code>sidenav-right</code> zeigen die Navigation in einer Seitenleiste; <code>top-nav</code> zeigt sie stattdessen in der Kopfzeile.</li><li><b>Modus der Seitennavigation</b> – <code>side</code> hält die Leiste neben der Seite, <code>over</code> legt sie über die Seite, <code>push</code> schiebt die Seite beiseite, solange die Leiste geöffnet ist.</li><li><b>Seitennavigation einklappbar</b> / <b>Seitennavigation standardmäßig geöffnet</b> – ob die Benutzer die Leiste schließen können und ob sie anfangs geöffnet ist.</li><li><b>Maximale Inhaltsbreite</b> – eine CSS-Länge wie <code>1280px</code>, die Seiten auf breiten Bildschirmen gut lesbar hält; leer bedeutet volle Breite.</li></ul>"
230
+ },
231
+ "regions": {
232
+ "title": "Bereiche – der Rahmen um die Seiten",
233
+ "body": "<p>Ein Bereich ist ein fester Teil des Bildschirms, der an seinem Platz bleibt, während die Benutzer zwischen den Seiten wechseln. Es gibt drei Typen, und eine Anwendung hat von jedem höchstens einen: <b>header</b> (oben), <b>sidenav</b> (die Navigationsleiste) und <b>footer</b> (unten). Header und footer enthalten <b>Widgets</b>; die sidenav enthält <b>Navigationseinträge</b>. Die Fläche in der Mitte ist kein Bereich: Sie zeigt die <b>Route</b>, auf der sich der Benutzer gerade befindet. Ein Bereich, den Sie weglassen, wird einfach nicht angezeigt.</p>"
234
+ },
235
+ "header": {
236
+ "title": "Kopfzeile (header)",
237
+ "body": "<p>Die Leiste am oberen Rand der Anwendung. Ihre Widgets werden in einer Zeile von links nach rechts angeordnet, in der Reihenfolge, in der sie aufgeführt sind. Typischer Inhalt sind <code>app-logo</code> und <code>app-title</code> links, ein <code>spacer</code>, der alles danach nach rechts schiebt, und ein <code>themes-button</code> ganz rechts. Logo und Titel sind gewöhnliche Widgets, die die Logo-URL und den Namen der Anwendung lesen – Sie entscheiden also, ob und wo sie erscheinen. Beim Layout <code>top-nav</code> werden auch die Navigationseinträge in der Kopfzeile angezeigt.</p>"
238
+ },
239
+ "footer": {
240
+ "title": "Fußzeile (footer)",
241
+ "body": "<p>Die Leiste am unteren Rand der Anwendung. Sie funktioniert genau wie die Kopfzeile – eine Reihe von Widgets in der aufgeführten Reihenfolge, mit einem <code>spacer</code>, um sie auseinanderzuschieben – und eignet sich gut für Copyright-Hinweise, Kontaktdaten oder Links. Sie bleibt auch dann am unteren Bildschirmrand, wenn eine Seite kurz ist.</p>"
242
+ },
243
+ "navigation": {
244
+ "title": "Navigationseinträge",
245
+ "body": "<p>Die Einträge des Menüs, die dem Bereich <b>sidenav</b> hinzugefügt werden. Jeder hat eine <b>Bezeichnung</b> (optional über seine <b>Transloco-Id</b> übersetzt), ein <b>Symbol</b> (der Name eines Material- oder FontAwesome-Symbols) und eine <b>Route</b>: den <b>Pfad</b> der Route, die er öffnet, genau so geschrieben wie bei der Route, z. B. <code>claims/open</code>. Ein Eintrag ohne Route ist eine <b>Gruppe</b>: Er klappt die Einträge auf und zu, die Sie unter seinen <b>Untereinträgen</b> hinzufügen – so lassen sich Menüs verschachteln. Ein Pfad, zu dem es noch keine Route gibt, ist nur eine Warnung – er kann zu einem Modul gehören, das noch nicht erstellt wurde.</p>"
246
+ },
247
+ "routes": {
248
+ "title": "Routen – die Seiten",
249
+ "body": "<p>Jede Seite der Anwendung ist eine Route.</p><ul><li><b>Pfad</b> – die Adresse der Seite relativ zur Anwendung, ohne führenden Schrägstrich: <code>claims</code>, <code>claims/open</code>. Ein Segment <code>:name</code> ist ein Parameter, z. B. <code>claims/:id</code>.</li><li><b>Titel</b>, <b>Transloco-Id</b> und <b>Symbol</b> – wie die Seite benannt und dargestellt wird.</li><li><b>Zeigt</b> – was die Seite anzeigt: <code>WIDGETS</code>, <code>ENTITY</code> oder <code>DOCUMENT</code>. Die Felder darunter gelten nur für die gewählte Art.</li></ul><p>Routen sind eine flache Liste. Sie verschachteln sie nie von Hand: <code>claims</code> und <code>claims/open</code> sind zwei getrennte Einträge, und die Anwendungsoberfläche erkennt anhand ihrer Pfade, dass die eine unter der anderen liegt.</p>"
250
+ },
251
+ "widgets": {
252
+ "title": "Widgets – die Bausteine",
253
+ "body": "<p>Ein Widget ist ein fertiger Baustein der Benutzeroberfläche – ein Logo, ein Titel, ein Abstandhalter, eine Theme-Auswahl, ein Raster von Entitäten, ein Dokumentbetrachter und mehr. Widgets werden in Kopf- und Fußzeile verwendet sowie auf <code>WIDGETS</code>-Routen, wo sie untereinander gestapelt werden. Die Reihenfolge in der Liste ist die Reihenfolge auf dem Bildschirm.</p><ul><li><b>Id</b> – eindeutig innerhalb ihrer Seite oder ihres Bereichs, z. B. <code>widget-claims-grid</code>.</li><li><b>Typ</b> – um welches Widget es sich handelt; angeboten werden nur die Widgets, die in dieser Installation verfügbar sind.</li><li><b>Eigenschaften</b> – die Einstellungen des Widgets. Das Formular passt sich dem gewählten Typ an und zeigt nur die Einstellungen, die dieser Typ kennt.</li><li><b>Platzierung</b> – <code>STANDALONE</code>-Widgets werden dort angezeigt, wo sie aufgeführt sind. Ein Container-Widget (etwa ein Kartenraster) ordnet andere Widgets an, indem es deren Ids in seinen Eigenschaften aufführt; markieren Sie diese als <code>REFERENCED</code>, damit sie innerhalb des Containers erscheinen und nicht ein zweites Mal für sich allein.</li></ul>"
254
+ },
255
+ "entities": {
256
+ "title": "Entitäten – Datenseiten ohne Gestaltungsaufwand",
257
+ "body": "<p>Eine <code>ENTITY</code>-Route zeigt eine Art von Geschäftsdaten – Schadensfälle, Kunden, Bestellungen –, ohne dass eine Seite gestaltet werden muss. Setzen Sie den <b>Entitätsnamen</b> auf den Namen einer Entität, die im Designer unter <b>Entitäten</b> definiert ist, und das Framework erzeugt daraus anhand der Attribute der Entität eine durchsuchbare Liste und ein Detailformular, zusammen mit den für sie definierten Validierungsregeln. Von dort aus können Benutzer Datensätze öffnen, anlegen, bearbeiten und löschen.</p><p><b>Entitätsmodus</b> (<code>LIST</code> oder <code>DETAILS</code>) und <b>RSQL-Filter</b> (ein Vorfilter wie <code>status==OPEN</code>) werden mit der Route gespeichert, aber noch nicht angewendet: Die Seite öffnet derzeit immer die vollständige Liste.</p>"
258
+ },
259
+ "documents": {
260
+ "title": "Dokumente",
261
+ "body": "<p>Eine <code>DOCUMENT</code>-Route zeigt ein Dokument – Inhalt aus Text, Bildern, Datenwerten und Widgets, erstellt im Designer unter <b>Dokumente</b>. Setzen Sie den <b>Dokument-Slug</b> auf den Slug des Dokuments. Das Darstellen eines Dokuments als Seite ist noch nicht verfügbar, daher zeigt die Vorschau an dieser Stelle einen kurzen Hinweis; um Dokumentinhalte schon heute anzuzeigen, verwenden Sie eine <code>WIDGETS</code>-Route mit einem Widget <code>document-viewer</code>.</p>"
262
+ },
263
+ "modules": {
264
+ "title": "Module",
265
+ "body": "<p>Eine größere Anwendung lässt sich in <b>Module</b> aufteilen. Ein Modul wird separat unter <b>Module</b> erstellt und enthält eigene Routen; sein <b>Schlüssel</b> darf sich nicht mehr ändern, sobald das Modul verwendet wird. Eine Anwendung bindet ein Modul über eine <b>Modul-Einbindung</b> ein: Der <b>Modulschlüssel</b> benennt das Modul, und der <b>Basispfad</b> ist das Präfix, unter dem seine Routen erscheinen – bindet man ein Modul unter <code>claims</code> ein, wird aus seiner Route <code>open</code> die Route <code>claims/open</code>. Ein Modul kann keine weiteren Module einbinden; es gibt nur eine Ebene.</p>"
266
+ },
267
+ "roles": {
268
+ "title": "Rollen",
269
+ "body": "<p>Routen und Navigationseinträge können die <b>Rollen</b> nennen, die sie verwenden dürfen. Bleibt die Liste leer, darf jedes angemeldete Mitglied Ihrer Organisation sie verwenden. Rollen werden mit der Definition gespeichert, aber die Vorschau schränkt anhand von ihnen noch nichts ein.</p>"
270
+ },
271
+ "lifecycle": {
272
+ "title": "Speichern, Vorschau und Freigabe",
273
+ "body": "<p>Eine neue Anwendung beginnt als <b>Entwurf</b>. <b>Speichern</b> sichert Ihre Änderungen; der Reiter <b>Vorschau</b> zeigt dann die gespeicherte Definition genau so, wie die laufende Anwendung sie darstellt, einschließlich Theme – prüfen Sie sie dort, bevor Sie weitermachen. Die Benutzer sehen davon noch nichts: Die laufende Anwendung verwendet nur <b>freigegebene</b> Definitionen. Öffnen Sie den Bereich <b>Freigabe</b> des Designers, um alles zu sehen, was Sie geändert haben – diese Anwendung, ihre Module und die anderen Definitionen, die sie verwendet –, und <b>veröffentlichen</b> Sie alles zusammen; die gespeicherte Version wird zur <b>veröffentlichten Version</b>. Sie können danach weiter bearbeiten und speichern; die Benutzer sehen die Änderungen erst nach der nächsten Freigabe.</p>"
274
+ }
81
275
  },
82
- "publish": {
83
- "button": "Veröffentlichen",
84
- "tooltip": "Die gespeicherte Definition veröffentlichen: ihre Version wird zur veröffentlichten Version"
276
+ "app_context": {
277
+ "_self": "Kontext",
278
+ "name": "Name",
279
+ "entityName": "Entitätsname",
280
+ "parent": "Übergeordnet",
281
+ "basePath": "Basispfad",
282
+ "persist": "Merken",
283
+ "pickerSearchFields": "Suchfelder der Auswahl",
284
+ "pickerRecent": "Zuletzt in der Auswahl",
285
+ "displayLabel": "Anzeigetext",
286
+ "displayBadge": "Anzeige-Badge",
287
+ "displayExtra": "Zusatztext",
288
+ "confirmSwitchStates": "Zustände mit Rückfrage",
289
+ "_tooltips": {
290
+ "name": "Name und URL-Segment des Kontexts: Seiten liegen unter ctx/<name>/<id>.",
291
+ "entityName": "Der Entitätstyp, den man einmal wählt und in dem man dann arbeitet, z. B. Race.",
292
+ "parent": "Der Kontext, in dem dieser verschachtelt ist. Ein anderer Elternkontext hebt diesen auf.",
293
+ "basePath": "Pfad, unter dem die Seiten des Kontexts liegen, z. B. /conduct. Leer bedeutet Wurzel der Anwendung.",
294
+ "persist": "url merkt die Wahl nur in der Adresse; url-local-storage merkt sich zusätzlich den letzten auf diesem Gerät.",
295
+ "pickerSearchFields": "Die Attribute, die die Auswahl durchsucht. Leer bedeutet Titelattribut.",
296
+ "pickerRecent": "Wie viele zuletzt verwendete Einträge oben angeboten werden. Standard 3.",
297
+ "displayLabel": "Der Text in der Statusleiste mit {{Attribut}}-Platzhaltern. Leer bedeutet Titelattribut.",
298
+ "displayBadge": "Ein Attribut als Badge daneben; state steht für das Zustandsattribut.",
299
+ "displayExtra": "Ein zweiter, dezenter Text mit {{Attribut}}-Platzhaltern.",
300
+ "confirmSwitchStates": "Zustände, in denen das Verlassen der Entität erst nachfragt."
301
+ }
85
302
  }
86
303
  }