Konventionen
Die Konventionen enthalten definierte Ausdrücke, welche von den Administratoren in den Merkmalen der Metadaten hinterlegt werden können, um bestimmte Anzeigen oder Verhalten in der Datenpflegesicht sicherstellen zu können. Es gibt verschiedene Bereiche in den diese Konventionen andere Bedeutungen haben. diese werden nachfolgend beschrieben.
Angezeigt Attribute in Formularen
Um die angezeigten Attribute in den Formularen zu steuern sind folgende Eigenschaften eines Feldes wichtig:
- editable
- visible in list
Wenn ein Attribut "Sichtbar in Liste" ist, wird es im Formular angezeigt. Wenn ein Attribut "Editierbar" ist, dann muss es automatisch "Sichtbar in Liste" sein.
Per default, um Fehlertoleranter zu sein, wird ein Attribut angezeigt wenn es entweder "Editierbar" oder "Sichtbar in Liste" ist.
Layer-Bemerkungen
In den Bemerkungen der Layer kann man folgende Dinge angeben:
- Mit
BGwerden Layer als Hintergrund-Layer markiert zwischen denen umgeschaltet werden kann. - Mit
STARTwird der Hintergrund-Layer markiert, der beim Starten der Anwendung angezeigt wird. - Mit
PUBLICwerden Layer markiert, welche ohne definierte Anwenderberechtigung geladen werden können
Die Parameter werden durch einen ; und ohne Abstand eingegeben
Beispiel von Layer-Bemerkungen
- Man kann die Formate einer Antwort Punktabfrage angeben. Folgende Werte sind möglich:
- text/xml
- text/html
- text/plain
- application/json
Falls ein Format der Anwort einer Punktabfrage angegeben wird, wird dieser Layer mit einem Punkticon im Layermanager hervorgehoben.
Status-Farben
Die Code-Liste Aktionsstatus (337025ae-8208-4b32-840c-c0d4201a9ac4) definiert die Farben der Stati in der Tabelle mit Hex-Farbcodes im Feld Bemerkung.
Datensichten-Bemerkungen - Filter
In den Bemerkungen der Layer kann man folgende Dinge angeben:
| REMARK | RESULTAT | BEMERKUNGEN | Beispiel |
|---|---|---|---|
| cc.ENTITY.EY_CODE = 'd0b0806b-b3a2-4f47-ba04-49cc690597ae' | Filtert die Sicht auf den referenzierten Auswahlwert der Codeliste | gefilterte Datensicht basierend auf den Basisattributen | Organisation oder Mitarbeiter als gefilterte Sichten des Akteurs |
| cc.ENTITY.EY_CODE = 'f133a3b4-4d23-46e9-bbc1-27431edff946' and AK_KATEGORIE = '61d53063-d429-4c44-b855-19859d48c7ad' | Filtert die Sicht auf den referenzierten Auswahlwert der Codeliste und der referenzierten Kategorie im definierten Merkmal | gefilterte Datensicht basierend auf Basis- und Datensichtattributen |
Attribut-Bemerkungen - Default-Werte
In den Bemerkungen der Attribute kann man folgende Dinge angeben:
| REMARK | DATENTYP | RESULTAT | BEMERKUNGEN | Beispiel |
|---|---|---|---|---|
| (@TITLE) | String | Zeigt den Eintrag im Übersichtstitel | Hilfreich, wenn die menschlesbaren Nummern zu wenig aussagen | |
| (@CALENDAR Start) | Date | Startdatum des Kalendereintrags | Wenn mehrere Daten vorhanden sind | |
| (@CALENDAR End) | Date | Enddatum des Kalendereintrags | Wenn mehrere Daten vorhanden sind | |
| TY_ID eq guid'94bc0a0f-fbc0-4383-b2ad-a85ab24922cb' or TY_ID eq guid'07b6862f-b5ad-4a6d-90dc-6d1c2a322595' or TY_ID eq guid'3143b838-6685-4224-bace-5bbd05c1f85c' | GUID | Filter auf die referenzierte Auswahlwerte der Codeliste | Reduzierte Anzeige von Statusmöglichkeiten | Ticket-Stati |
Default-Werte für Attribute in Datensichten
| DEFAULTWERT | DATENTYP | RESULTAT | BEMERKUNGEN | Beispiel |
|---|---|---|---|---|
| Now | DateTime | Das heutige Datum | Achtung! Gross-/Kleinschreibung beachten | |
| Year | Ingeger | Das aktuelle Yahr | Achtung! Gross-/Kleinschreibung beachten | |
| UserId | Entitätsliste | Der verantwortliche User | Achtung! Gross-/Kleinschreibung beachten | |
| EditorId | Entitätsliste | Der aktuell angemeldete Bearbeiter | Achtung! Gross-/Kleinschreibung beachten | |
| Next,ABC,4 | String | menschlesbare Geschäftsnummer | Wird nomalerweise im Namen eingetragen und enthält keine Leerschläge | ABC.2021.0001 |
| true | Boolean | Wert auf "Ja" | Achtung! Gross-/Kleinschreibung beachten | |
| false | Boolean | Wert auf "Nein" | Achtung! Gross-/Kleinschreibung beachten | |
| {"Composed": { "method": "combine'" "fields": ['','',''] "prefix": ['','',''] "suffix": ['','',''] "empty": ['','',''] }} |
String | Combiniertes Feld mit Text-Feldern | Zusamengesetzte Felder sollten nicht editiert werden | |
| {"Composed":{ "method":"math", "fields": ["", ""], "operator": ["", "*"], "empty": ["0","0"], "round": 0 }} |
Double | Combiniertes Feld mit Zahlen-Feldern | Die Ausgangsmerkmale müssen Double oder Decimal sein | |
| POLYGON((2611268 1267866,2611264 1267853,2611280 1267856,2611268 1267866)) | Geometry | Default-Geometrieposition | Achtung! Korrekter WKT-String eingeben |
Die Komposition wurde im neuen Backend vereinfacht integriert.
Beispiel einer Komposition in der Datensicht
Mit dem Aufruf der Felderkomposition erstellen (1) wird ein neues Bearbeitungsfendter geöffnet, welches den Datenzugriff auf Bestehende Fleder (2) ermöglicht. Die daraus erstellte Komposition wird als JSON-Text in das Default-Feld (3) eingetragen.
Komposition erstellen im Bearbeitungseditor
Das Erstellen der Koposition erfolgt wie gesagt in einem separaten Bearbeitungsfenster, in welchem die Felder, Opperanden, Faktoren und Leerwerte eingetragen werden können, um damit den Kompositions-Text zu erstellen.
Achtung! Beim Runden muss geg. im Default-Wertfeld die Anpassung auf die eingestellte Anzahl Nachkommastellen nach der Bearbeitung eingestellt werden.
ViewGenerator
- Die Sichtbarkeit ist per Default auf "true"
Datensicht Attribute-Analyser
| Test | Type | DataType | Condition | Fehler |
|---|---|---|---|---|
| baseAttributeVisible | warning | Alle | Wenn das Attribut ein CoreAttribut ist muss es sichtbar sein (HIER genaue Liste editieren) | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} ist nicht sichtbar in den Metadaten |
| parentCheck | error | Alle | wenn CoreAttribute (Ausser _ID) => abgeleited von muss der Id des CoreAttributes der 'Entity'-Datensicht entsprechen. Bei einem nicht CoreAttribut muss abgeleitet der Id des Entitätsattribut entsprechen. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat einen falschen Wert in "abgeleited von", der Wert sollte ${coreAttribute.TY_ID} enthalten. ODER Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat einen falschen Wert in "abgeleited von" (nicht in den Entitätsattributen enthalten). ODER Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} scheint einen falschen Namen zu haben. ODER ${currentView.TY_LONGNAME} -- Keine Entitätsattribute vorhanden. (${attribute.TY_NAME}/${attribute.TY_LONGNAME}) |
| hasName | error | Alle | CoreAttribute EY_NAME muss Text enhalten | Feld ${attribute.TY_ID} hat keinen Namen |
| hasLongName | error | Alle | CoreAttribute EY_LONGNAME muss Text enhalten | Feld ${attribute.TY_ID} hat keine Bezeichnung |
| checkNullNotPossible | error | Alle | Wenn "Null möglich" auf "nein" ist, muss "sichtbar" auf "ja" sein. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat "NULL möglich" auf ja obwohl "sichtbar" nicht auf "ja" gestetzt ist. |
| checkEditable | error | Alle | Wenn "Editierbar" auf "ja" ist, muss "sichtbar" auf "ja" sein. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat "editierbar" auf ja obwohl "sichtbar" nicht auf "ja" gestetzt ist. |
| checkQueryable | error | Alle | Wenn "abfragbar" auf "ja" ist, muss "sichtbar" auf "ja" sein. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat "abfragbar" auf ja obwohl "sichtbar" nicht auf "ja" gestetzt ist. |
| checkVisibleInList | warning | Alle | Wenn "sichtbar in Liste" auf "ja" ist, muss "sichtbar" auf "ja" sein. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat "sichtbar in Liste" auf nein obwohl "sichtbar" auf "ja" gestetzt ist. |
| checkPrimaryKeyIsGuid | error | Alle | Wenn ein Attribut ein Primary Key ist, muss der DatenType "Guid" sein | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} ist ein Primary-Key aber nicht vom Typ Guid. |
| checkNextIdDefaultValue | error | String | Check der NextId definition im Defaultwert mit folgendem Regex: NextId,[a-zA-Z]*,\d{1} | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat einen Defaultwert vom Type NextId der falsch geschrieben ist. |
| checkDefaultValueBoolean | error | Boolean | Defaultwert für Booleans ist entweder null (leer)/0/1 | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} von Typ DateTime hat einen falschen Defaultwert. |
| checkDefaultValueDate | error | Date | Defaultwert für Daten ist "Now" | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} von Typ Boolean hat einen falschen Defaultwert. |
| notSimpleAttributeCheck | error | Guid | Ein Type Guid kann nicht ein "Einfaches Attribut" sein, wenn er nicht ein Primary Key ist | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} vom Typ Guid ist ein Simples Attribut |
| hasEntityList | error | Guid | Ein Type Guid der eine EntityList ist muss ein komplexes Attribut Objekt haben. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} vom Typ Entitätsliste hat keine Entitätsliste angegeben |
| hasCodeList | error | Guid | Ein Type Guid der eine CodeList ist muss ein komplexes Attribut Objekt haben. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} vom Typ Codeliste hat keine Codeliste angegeben |
| primaryKeyCheck | error | Guid | Ein Primary Key muss vom komplexen Attributtype "Simples Attribute" sein | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} vom Typ Guid (PRIMARY KEY) ist nicht ein Simples Attribut |
| simpleAttributeCheck | error | Simple Attribute (String, DateTime, Int16, Int32, Int64, Double, Decimal) | Die Datentypen String, DateTime, Int16, Int32, Int64, Double, Decimal benötigen einen komplexen Attributtype "Simples Attribute" | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} ist nicht ein Simples Attribut |
| defaultValueToLong | error | String | Der Defaultwert eines Stringes kann nicht die Länge von diesem überschreiten | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} hat einen Defaultwert der länger ist als das Feld |
| stringMinLength | error | String | Der Datentyp String braucht eine Mindestlänge und kann nicht null (leer) oder 0 sein. | Feld ${attribute.TY_NAME} / ${attribute.TY_LONGNAME} von Typ String hat keine Mindestlänge. (Länge <= 0) |