Info & Hilfe

Quickstart – von Helmut4 zur Auswertung

1. Konfiguration in Helmut4 sichern. Vor dem Export die Bereiche User, Lizenzen, Jobs und Projekte abwählen, damit die Sicherungsdatei nicht unnötig groß wird. Das Konfigurationsbackup als ZIP speichern.
2. Alle Streams exportieren. Zusätzlich die gesamten Streams aus demselben Helmut-System als .streams-Datei exportieren. Beide Dateien sollten denselben Konfigurationsstand abbilden.
3. Neue Konfiguration im Analyzer anlegen. Auf der Startseite Neue Konfiguration importieren wählen. Das System auswählen, bei Bedarf einen Anzeigenamen vergeben und beide Dateien hinzufügen: die ZIP-Datei unter Konfigurationsbackup, die .streams-Datei unter Passender Stream-Export. Mit Snapshot importieren bestätigen und den Abschluss abwarten.
4. Konfiguration öffnen und auswerten. In „Letzte Konfigurationen“ oder im Konfigurationsarchiv die Konfiguration über das Augen-Symbol (Öffnen) öffnen. Mit Analyse starten die Auswertung ausführen und anschließend Fehler, Warnungen und Hinweise prüfen. Beim Import wird bereits eine erste Analyse erstellt; der Button aktualisiert sie bei Bedarf erneut.

Zwei Konfigurationen vergleichen

Im Konfigurationsarchiv Konfigurationen vergleichen wählen oder aus einer geöffneten Konfiguration den Vergleich starten. Zwei Snapshots auswählen; ALT und NEU werden automatisch zugeordnet. Entscheidend ist zuerst das Datum im Helmut-Backup-Dateinamen, danach der gespeicherte Konfigurationsstand und erst zuletzt das Upload-Datum. Ein später hochgeladenes älteres Backup bleibt damit ALT. Zeitbasis und Upload werden auf beiden Seiten angezeigt; ALT/NEU tauschen erlaubt die manuelle Umkehr.

Die Übersicht zählt hinzugefügte, entfernte, geänderte, unveränderte und nicht eindeutig zuordenbare Objekte. Bereich, Änderungsart und Suche filtern die Unterschiede. Alte und neue Werte stehen direkt nebeneinander; Links öffnen den jeweiligen Snapshot oder die betroffene Node. Erstell-/Änderungszeitstempel sind optional einbeziehbar. Streams und Nodes besitzen getrennte Bereiche und Zähler. Stream-Karten fassen die Node-Änderungen kurz zusammen; „Nodes dieses Streams vergleichen“ führt zu den Einzeländerungen mit Stream-Kontext. Dort steht ein zusätzlicher Stream-Filter bereit. Node-Änderungen markieren auch ihren Stream als betroffen; unveränderte Objekte werden nur gezählt.

PDF-Export (gefiltert) bei der Ergebnisanzahl übernimmt ALT/NEU und alle angewandten Filter einschließlich Stream-Auswahl und Zeitstempeloption. Der Bericht enthält alle passenden Unterschiede über sämtliche Bildschirmseiten hinweg, mit alten und neuen Werten nebeneinander. Die PDF-Datei kann anschließend gedruckt werden.

Verglichen wird der importierte Bestand einschließlich gespeicherter Findings. Unterschiedliche Exportumfänge oder Analyseregeln können Unterschiede verursachen. Nicht mehr vorhandene Findings sind kein Nachweis einer Fehlerbehebung. Stream-Design/Layout und reine Node-Listenreihenfolge werden nicht verglichen; Start-Node, Verbindungen, Trigger-Reihenfolge und Parameter dagegen schon. Keine automatische Analyse oder Änderung der aktiven Konfiguration.

Wie sind die Meldungen zu verstehen?

Fehler

Ein konkreter Widerspruch im importierten Bestand, etwa eine fehlende Ziel-Node oder eine undefinierte Helmut-Variable. Definition, Schreibweise und Exportumfang prüfen.

Warnung

Ein mögliches Problem oder eine Abweichung von einer Best Practice. Kann beabsichtigt sein und muss fachlich geprüft werden.

Hinweis

Zusätzliche Information oder eine statisch nicht eindeutig prüfbare Situation. Kein nachgewiesener Laufzeitfehler.

Der Analyzer führt keine Streams oder Skripte aus. Er bewertet den importierten Snapshot, nicht das aktuell laufende Helmut-System. Ein unvollständiger Export begrenzt die Aussagekraft.

IO-Streams und Custom-Streams

Job Status Update: FX und Queued

FX-Streams dürfen keine Job Status Update (Job Progress)-Nodes enthalten. Jede solche Node erzeugt eine Warnung. Zusätzlich wird in IO, CO, HK und FX gewarnt, wenn eine Job Status Update-Node auf Queued steht. Geprüft wird der direkt gespeicherte Status; dynamische Ausdrücke werden dafür nicht aufgelöst.

Beide Regeln gelten auch für Custom-Streams und deaktivierte Streams oder Nodes; deaktivierte Einträge sind gekennzeichnet. Treffen beide Regeln auf dieselbe Node zu, erscheinen sie zusammen in einem Eintrag mit direktem Node-Verweis. Designkopien werden nicht zusätzlich gezählt.

Jobstatus im Dashboard sichtbar machen

Unsere Best Practice: IO-Streams sollen eine aktive Job Status Update-Node enthalten, damit Jobstatus im Dashboard nachvollziehbar sind. Bei aktiviertem Stream ohne diese Node erscheint eine Warnung; bei unbekanntem Aktivierungsstatus ein Hinweis. Deaktivierte Streams erhalten diese Meldung nicht.

Ausnahme: CUSTOM_IO. Dafür wird kein fehlender Job Status Update beanstandet. Die Statusprüfung zählt aktive Nodes; die Erreichbarkeit wird zusätzlich durch die Ablaufprüfung beurteilt, sofern der Graph eindeutig ist.

Gruppenfreigabe und Aktivierung prüfen

Die Gruppenansicht enthält eine Auswertung aller Stream-Zuordnungen je Bereich: unbekannte IDs, gemischte gültige/unbekannte IDs, ausschließlich unbekannte IDs, vollständig auflösbare und leere Zuordnungen. Aktivierungsstatus und Custom-Streams werden zusätzlich zusammengefasst. Die Zahlen führen zu gefilterten Streamlisten; eine eigene Liste zeigt jede unbekannte Gruppen-ID mit den betroffenen Streams. Diese Auswertung benötigt keinen Analyselauf.

Bei einer Meldung zur Gruppenfreigabe werden die zugeordneten Gruppen mit Namen und IDs aufgeführt. IDs, die im importierten Gruppenkatalog fehlen, sind rot und ausdrücklich als nicht gefunden gekennzeichnet. Fehlt der Katalog insgesamt, bleiben die IDs neutral als nicht prüfbar markiert.

Bei CUSTOM_IO und CUSTOM_FX Gruppenzuordnung sowie aktiviert/deaktiviert kontrollieren. Die Übersicht zeigt gespeicherte Gruppen und den Aktivierungsstatus. Fehlende oder nicht prüfbare Angaben ergeben Hinweise; unbekannte Gruppen-IDs eine Warnung. Eine leere Gruppenliste beweist allein keine Unsichtbarkeit in Helmut.

Die Abhängigkeiten-Ansicht kennzeichnet deaktivierte Aufrufe und Ziele gesondert. Die tatsächliche Freigabe und Ausführbarkeit weiterhin in Helmut prüfen.

Profile, Variablen und feste Pfade

Metadaten: Definitionen und Verwendung abgleichen

{project.metadata.FELD} wird gegen die FX-Metadatensets geprüft, {job.metadata.FELD} gegen die IO-Metadatensets. Lesen und Schreiben werden getrennt erfasst; Schreibzugriffe werden für Job-/Project Metadata Changer erkannt. Auch job.metadata.filename bekommt keine pauschale Ausnahme als Standardfeld.

• Mögliche Schreibfehler: Ähnliche Feldnamen im passenden Bereich ergeben eine Warnung.
• Feld ohne Set-Zuordnung: Ist eine Felddefinition vorhanden, aber keinem Set zugeordnet, erscheint eine Warnung.
• Schreibschutz / deaktiviert: Schreiben auf ausschließlich schreibgeschützte aktive Definitionen oder ausschließlich deaktivierte Definitionen erzeugt eine Warnung. Lesen ausschließlich deaktivierter Definitionen ergibt einen Hinweis.
• Leerer Feldname: Bei einem erkannten Schreibzugriff ein Fehler; bei einer Abfrage ein Hinweis.
• Fehlende Definition: Eine reine Abfrage ohne passende Set-Definition ist kein bewiesener Fehler. Auch zur Laufzeit geschriebene Felder sind möglich. Der Status bleibt in der Metadatenübersicht nachvollziehbar; konkrete Auffälligkeiten wie ähnliche Namen werden gesondert gemeldet.
• Dynamische Namen / fehlender Katalog: Nicht eindeutig abgleichbare Verwendungen werden als Hinweis behandelt.

Auto Mapper: Diese Helmut-Funktionalität ist von der Metadatenanalyse ausgenommen. Ein Feld ohne erkannte direkte Verwendung kann über Auto Mapper, Oberfläche oder dynamische Zugriffe genutzt werden und sollte deshalb nicht allein aufgrund dieses Hinweises gelöscht werden.

Verdrahtung, Fehlerpfade und Aufrufketten

• Start und Verbindungen: Fehlende Start-UUIDs, fehlende Startziele, fehlende oder doppelte Node-UUIDs sowie Verbindungen auf nicht vorhandene Nodes werden als Fehler gemeldet. Dynamische Ziele bleiben Hinweise.
• Unerreichbare Nodes: Eine aktive Node ohne Verbindung vom Start erhält eine Warnung. Erreichbarkeit wird nur bei einem vollständigen, eindeutigen Laufzeitgraphen beurteilt.
• Success und Fail auf dasselbe Ziel: Warnung bei aktiven, erreichbaren Nodes. Standardmäßig ausgenommen sind Set Temporary Streamvariable, Sleep Action, UserMessageOutput, Job Status Update, Metadata Auto Mapper, Set Store Variable und Regex Apply. Unter Einstellungen lässt sich diese Warnung insgesamt sowie jede Node-Ausnahme einzeln schalten. Die übrigen Strukturprüfungen gelten weiterhin. Die Einstellungen gelten global; gespeicherte Findings und Zähler erst durch erneute Analyse aktualisieren.
• Fehlender Fehlerpfad: Für ausgewählte kritische Datei-, HTTP- und Render-Aktionen wird ein expliziter Fehlerpfad empfohlen. Je nach Fortsetzung und asynchronem Verhalten erscheint eine Warnung oder ein Hinweis. Ein bewusstes Stream-Ende kann richtig sein.
• Hauptstream und Prestream: Profilziele werden auf Existenz und Aktivierung geprüft. Ein Prestream ist optional. Bei unvollständigem Katalog werden fehlende Ziele vorsichtiger bewertet.
• Execute Generic Stream: Fehlende oder deaktivierte Ziele werden gemeldet; dynamische oder mehrdeutige Aufrufziele bleiben Hinweise.
• Mögliche Rekursion: Aufrufketten über Streams und Profile, die zum Ausgang zurückführen können, erzeugen eine Warnung. Bedingungen und Abbruchlogik können den Zyklus begrenzen; eine Endlosschleife wird damit nicht bewiesen.
• Deprecated: Von Helmut im Export als veraltet markierte Nodes oder Streams erhalten eine Warnung. Der Analyzer erfindet keine eigene Liste veralteter Node-Klassen.

Analyse richtig nutzen

Streams filtern: Zuerst den Bereich IO, FX, CO oder HK wählen, danach unter „Auslöser / Streamart“ beispielsweise IMPORT, EXPORT, AUTOIMPORT oder Open Project. Angeboten werden die im Snapshot vorhandenen Auslöser des Bereichs. Beim Wechsel zwischen Konfiguration und Fachansichten zeigt ein eigener Ladedialog den Seitenaufruf an; dadurch wird keine neue Snapshot-Analyse ausgelöst.

Bei einem ausgewählten Auslöser zeigt die Streamliste die gespeicherte Reihenfolge und sortiert aufsteigend nach dem Streamfeld order, getrennt nach Bereich. Der Originalwert bleibt erhalten, auch wenn er mit 0 beginnt oder Lücken besitzt. Gleiche Werte werden alphabetisch sortiert, fehlende Werte am Ende. Deaktivierte Streams bleiben gekennzeichnet sichtbar. Bei „Alle Auslöser / Streamarten“ und „Ohne Auslöser“ bleibt die alphabetische Sortierung bestehen.

Import und Analyse: Ein modaler Dialog zeigt Upload-Prozent, anschließend die aktuellen Verarbeitungsschritte und die Laufzeit. Bei ZIP-Dateien wird der Dateizähler angezeigt. Analyse-Schritte haben keine geschätzte Gesamt-Prozentzahl. Während der Verarbeitung sind weitere Klicks und doppelte Starts gesperrt; nach Erfolg öffnet sich der Snapshot. Bei einem Fehler lässt sich der Dialog schließen. Nach einem Verbindungsabbruch zuerst im Archiv prüfen, ob der Vorgang serverseitig abgeschlossen wurde; es gibt keinen automatischen Neustart.

Snapshots verwalten: Im Konfigurationsarchiv öffnet das Zahnrad die Einstellungen mit der bestätigungspflichtigen Löschfunktion. Sie entfernt den Snapshot samt Analysedaten und zugehörigen Dateien. Housekeeping oben rechts zeigt den Speicherverbrauch der Dateiablage und SQLite-Datenbank einschließlich WAL/SHM sowie den verfügbaren Platz auf den zugehörigen Dateisystemen. Dort lässt sich die Importablage mit Vorschau und Bestätigung manuell bereinigen: verwaiste Dateien und temporäre Reste ab 24 Stunden Alter; vorhandene Snapshots bleiben geschützt. Freie SQLite-Seiten können intern wiederverwendet werden, ohne dass die Datei unmittelbar kleiner wird. Dieselbe Konfigurationsdatei kann mit verschiedenen Stream-Exports als separate Snapshots importiert werden. Nur die identische Dateikombination wird als Duplikat abgewiesen.

Für möglichst vollständige Abgleiche ein zusammengehöriges Konfigurationsbackup mit Stream-, Profil-, Variablen-, Gruppen- und Metadatendefinitionen importieren. Ein einzelner Stream-Export enthält nicht automatisch die zugehörigen Kataloge.

Die Fachansichten für Pfade, Metadaten und Ablauf fassen mehrere Treffer derselben Node zusammen. Die Einzelstellen bleiben dort sichtbar. Nicht jede Prüfungsart wird pauschal zu einer einzigen globalen Meldung je Node zusammengelegt.

Von der Konfigurationsübersicht aus die Findings und jeweiligen Fachansichten öffnen. Node-Verweise führen zur betroffenen Stelle; die grafische Ansicht und HView helfen beim Prüfen der Verdrahtung. Die allgemeine Suche findet wörtliche Vorkommen in Streamdaten und Skripten. Die Ansicht Abhängigkeiten zeigt direkte Aufrufer, Ziele und weitere Aufrufketten einschließlich gesondert gekennzeichneter inaktiver Verbindungen.

Best-Practice-Regeln: Unter Einstellungen sind IO-Streams mit Job Status Update, FX ohne Job Status Update, Status Queued, Custom-Gruppenfreigabe und eindeutige Aktivierung jeweils einzeln schaltbar. Weitere Schalter betreffen hart codierte Pfade/Profil-IDs, fehlende Fehlerpfade kritischer Aktionen, mögliche rekursive Aufrufe sowie Variablen und Metadatenfelder ohne direkte Verwendung. Standardmäßig sind alle Regeln aktiv. Die bestehenden Ausnahmen (etwa CUSTOM_IO bei der IO-Jobstatus-Empfehlung) gelten weiterhin. Die Schalter gelten global und werden in der Datenbank gespeichert. Bestandslisten und technische Fehlerprüfungen bleiben erhalten; gespeicherte Findings/Zähler erst durch einen erneuten Analyselauf aktualisieren.

Finding-Häufigkeiten: Die Snapshot-Auswertungsseite zeigt die Anzahl je konkretem Prüfcode (z. B. MISSING_FAILURE_PATH). Ein Klick filtert die Arbeitsliste. Die Übersicht zählt alle gespeicherten Findings inklusive geprüfter und ignorierter; mehrere Codes in einem Finding zählen in mehreren Kategorien. Die Häufigkeitssumme kann daher über der Anzahl der Findings liegen. Ungenutzte Store-Variablen (UNUSED_STORE_VARIABLE) und Helmut-Variablen sind in den Einstellungen getrennt schaltbar; MISSING_FAILURE_PATH steht beim Schalter für fehlende Fehlerpfade kritischer Aktionen.

FX-Path-Mappings: Die Kachel „Path-Mappings“ auf der Konfigurationsseite öffnet die gespeicherten Pfadzuordnungen als Tabelle. Angezeigt werden nur diese Zuordnungen, in Originalreihenfolge und ohne Bearbeitung oder zusätzliche Prüfung. Andere allgemeine Helmut-Einstellungen werden dort nicht angezeigt.

PDF-Export: Im Kopf der Finding-Arbeitsliste lädt „PDF-Export (gefiltert)“ die aktuell angezeigte Auswahl als Bericht herunter. Angewandte Filter und Gruppierung werden übernommen; für einen vollständigen Export Status „Alle“ wählen und andere Filter zurücksetzen. Der Bericht enthält Snapshot-Angaben, Häufigkeiten, konkrete Meldungen und Fundstellen. Er verwendet gespeicherte Ergebnisse und startet keine Analyse.

Nach Aktualisierungen der Prüfregeln die Analyse des vorhandenen Snapshots erneut ausführen. Für diese Hilfe-Seite selbst sind weder Reimport noch erneuter Analyselauf nötig.