Show Templates

Ob eine Entität überhaupt etwas erzeugt, und was, hängt davon ab, wie die installierten Pakete auf sie passen. Ohne eine Möglichkeit zu fragen, sieht man das erst nach einer vollständigen Generierung – und wenn die Antwort „nichts" lautet, sieht ein Lauf, der keine Datei erzeugt, genauso aus wie einer, der nichts zu tun hatte.

Show templates beantwortet das je Entität, auf Anforderung.

Fragen

Klicken Sie mit der rechten Maustaste auf die Titelleiste eines Objekts auf der Zeichenfläche und wählen Sie Show templates. Der Reiter Templates öffnet sich im unteren Bereich mit dem Ergebnis.

Zwei Dinge dazu, wo Sie klicken. Innerhalb des Kastens, unter dem Titel, ist jede Zeile ein Attribut und trägt stattdessen das Attribut-Menü – Edit Attribute, Trace lineage, Delete Attribute. Und die Titelleiste, nicht der Baum: ein Rechtsklick auf eine Entitätszeile im linken Baum öffnet derzeit kein Menü, während Gruppenordner und Ansichten dort eines haben. Nehmen Sie den Knoten auf der Zeichenfläche oder die Entitätsaktionen in der rechten Leiste.

Der Client ruft den Server nicht bei jedem Klick. Die Vorschau wird nur geholt, wenn Sie Show templates ausführen, und die Auswahl einer anderen Entität löscht das vorige Ergebnis, statt stillschweigend eines nachzuladen, nach dem Sie nicht gefragt haben.

Die Antwort lesen

Jeder Treffer ist eine Zeile:

Spalte	Bedeutung
Definition	Die Regel im Paket, die gepasst hat – ebo_object_schema, demo_hub, …
Artifact	Die Datei, die sie erzeugen würde
Pack	Aus welchem installierten Paket die Definition stammt

Zwei Aktionen je Zeile:

• Explain why – die Regel, die diese Definition auf diese Entität passen liess.
• View code – das Artefakt, das erzeugt würde, ohne alles zu generieren.

Und zwei leere Zustände, bewusst auseinandergehalten: kein aktives Template-Paket ist ein anderes Problem als diese Entität passt auf nichts, und zu erfahren, welches von beidem vorliegt, ist der ganze Zweck.

An zwei Entitäten ausprobieren

Probieren Sie es an zwei Entitäten der Business-Object-Demo. Bei Customer bekommen Sie eine Zeile: Definition ebo_object_schema, Artefakt Customer.schema.json, Paket demo_retail_ebo. Bei Address – einem Value Object – bekommen Sie den Zustand „passt auf nichts", weil keine Definition in diesem Paket nach einem Value Object fragt.

Das ist dieselbe Tatsache wie „ein Value Object erzeugt keine Datei", nur von der Entität aus gesehen statt vom Ausgabeordner. Es einmal an beiden zu tun, ist der kürzeste Weg zu sehen, wie die Konfiguration Ihre Ausgabe bestimmt.

info

Der Schlüssel, nicht der Name: eine Definition passt auf den Schlüssel des Typs, ein Umbenennen in Einstellungen → Typen beendet das Passen also nicht. Anzeigenamen sind für Menschen, Schlüssel für das Passen.

Eine Definition kann auch mehr verlangen als einen Typ – den Wert einer benutzerdefinierten Eigenschaft, den Namen der Entität, einen Gruppenpfad. Explain why meldet immer, welche Bedingungen geprüft wurden und wie sie ausgingen, Sie müssen also nie das Paket lesen, um es herauszufinden. Der vollständige Satz steht in How generation works.

Wenn nichts passt

Drei Gründe, in der Reihenfolge, in der sie zu prüfen sind:

1. Es ist kein Paket installiert – der Reiter sagt das eindeutig. Installieren Sie eines aus dem Marketplace.
2. Die Entität hat keinen Typ oder einen Typ, den kein installiertes Paket beansprucht. Das ist der häufige Fall, und er bleibt bei der Generierung stumm.
3. Das Paket erwartet Typen, die Ihr Modell nicht hat. Nach der Installation prüft ITB das Modell gegen die Anforderungen des Pakets und bietet an, Fehlendes zu ergänzen – wurde dieser Dialog weggeklickt, existiert das Vokabular, auf das das Paket passt, womöglich noch nicht.

Woraus die Definitionen bestehen, steht in Pack Configuration, und in der Einführung sehen Sie das Passen sich ändern, während Sie ein Modell bearbeiten.