Eigene Blöcke im Register der Organisation
Wo Ihre eigenen Blöcke gesammelt stehen, welche Versionen es gibt, wie Sie einen Block in eine andere Umgebung bereitstellen und warum der Code nie auf dem Server läuft.
Worum es geht
Blöcke, die Sie aus dem Code Ihrer Website schreiben, landen nicht nur in einer Umgebung. Scorebase legt sie zusätzlich im Register der Organisation ab. Dort sehen Sie alle eigenen Blöcke an einem Ort und können sie in weitere Umgebungen bereitstellen. Sie finden das Register in Sites unter Eigene Blöcke.
Der Code dieser Blöcke läuft nie auf dem Server. Das Register hält nur die Beschreibung: Name, Eigenschaften und Version. Eine Website zeigt einen Block erst, wenn ihr Projekt die Komponente enthält.
Voraussetzungen
- Das Recht Block-Definitionen verwalten. Ohne es zeigt die Ansicht keine Daten.
- Zum Schreiben ins Register ein Token mit Verwaltung (Kommandozeile) oder der Assistent-Zugang.
Einen Block ins Register bringen
Legen Sie den Block im Projekt Ihrer Website an und schreiben Sie ihn in die Umgebung:
hcms block neu wartezeit-anzeige --felder titel:text,schwelle_rot:number
hcms blocks pushDer Push trägt den Block in die Umgebung ein und legt eine Version im Register ab. Ändert sich die Beschreibung, entsteht beim nächsten Push eine neue Version; bleibt sie gleich, bleibt es bei der bisherigen. Schlägt das Ablegen im Register fehl, bleibt der Push trotzdem gültig und meldet nur eine Warnung. Blöcke, die über die Bausteinbibliothek oder eine Installation aus dem Marktplatz kommen, stehen nicht im Register.
Die Ansicht
Die Liste zeigt je Block den Namen, die neueste Version, die Umgebungen, in denen er liegt, und den Letzten Push. Ein Klick auf Ansehen öffnet das Detail:
- Eigener Code kennzeichnet den Block.
- Vorschaubild, falls vorhanden.
- Eigenschaften mit Feld, Schlüssel und Typ.
- Versionen mit der neuesten zuerst und der Quelle (Kommandozeile oder Assistent).
- Umgebungen mit dem Stand je Umgebung.
Stand je Umgebung
| Anzeige | Bedeutung |
|---|---|
| aktuell | Die Umgebung hat die neueste Version. |
| Version 2 (eine ältere Nummer) | Die Umgebung hat eine ältere Version des Blocks. |
| abweichend | Die Beschreibung in der Umgebung stimmt mit keiner Version im Register überein, etwa weil sie dort von Hand geändert wurde. |
| nicht bereitgestellt | Die Umgebung hat den Block nicht. |
Verwaltete Umgebungen, die eine App selbst betreut, erscheinen nicht.
In Umgebung bereitstellen
- Öffnen Sie den Block und klicken Sie auf In Umgebung bereitstellen.
- Wählen Sie die Umgebung. Zur Auswahl stehen nur Umgebungen Ihrer Organisation.
- Wählen Sie die Version, vorbelegt ist die neueste.
- Der Dialog sagt, was geschieht: Er legt den Block neu an oder ersetzt die bisherige Definition, bei einer abweichenden Umgebung mit entsprechendem Hinweis.
- Klicken Sie auf Bereitstellen.
Bereitgestellt wird nur die Beschreibung der Eigenschaften. Den Code bringt das Projekt der Website mit: Legen Sie die Komponente dort an und tragen Sie sie in registry.tsx ein, sonst zeigt die Website den Block nicht. Dafür ist das Recht Block-Definitionen verwalten nötig.
Vorschaubild
Legen Sie neben die Block-Datei ein Bild cms/blocks/<slug>.vorschau.png (auch .jpg oder .webp), am besten ein Bildschirmfoto der lokalen Seite, etwa 1200 Pixel breit. hcms blocks push lädt es einmal hoch; mit --vorschau-neu erzwingen Sie ein neues Hochladen. Schlägt der Upload fehl, ist das nur eine Warnung. Im Trockenlauf (--dry-run) wird nichts hochgeladen.
Wenn etwas nicht klappt
| Symptom | Ursache | Lösung |
|---|---|---|
| Die Ansicht sagt, das Register sei noch nicht eingerichtet | Die Aktualisierung mit dem Register ist noch nicht eingespielt | Später erneut öffnen; der Push funktioniert bis dahin weiter |
| Die Ansicht zeigt keine Daten | Das Recht Block-Definitionen verwalten fehlt | Eine Admin-Person um das Recht bitten |
| Eine Umgebung fehlt im Dialog | Sie wird von einer App verwaltet | Dort lassen sich keine Blöcke bereitstellen |
| Der Block erscheint auf der Website nicht | Die Komponente fehlt im Projekt der Website | Komponente anlegen und in registry.tsx eintragen |
| Der Stand lautet abweichend | Die Umgebung wurde nach dem letzten Push geändert | Mit In Umgebung bereitstellen auf eine Version zurücksetzen oder die Änderung per Push übernehmen |