Vorhandenes TYPO3
- TYPO3 13.4 und 14.3
- Eigene Extension, mit automatisierten Tests abgesichert
- Dateien in einem geschützten Bereich, Zugriff nur über das Portal
Ein Unternehmen mit mehreren Sparten hatte Hunderte Betriebsanleitungen als PDF in gewachsenen Ordnern. Kunden riefen an, weil sie die passende Ausgabe nicht fanden. Wir haben im vorhandenen TYPO3 ein Anleitungsportal gebaut: QR-Code am Gerät, Suche, die Tippfehler verzeiht, ältere Ausgaben klar unter der aktuellen.
Die Dateien lagen in Ordnern, die über Jahre gewachsen waren: je Sparte eine Struktur, je Mitarbeiter eine Logik. Welche Ausgabe für welches Baujahr gilt, wusste nur der Service. Dazu kam ein Termin: Ab 20. Januar 2027 erlaubt die EU-Maschinenverordnung die digitale Betriebsanleitung nur unter klaren Bedingungen.
Kunden riefen im Service an und beschrieben ihr Gerät. Ein Mitarbeiter suchte im Ordner, verschickte ein PDF und hoffte, dass es die richtige Ausgabe war. Jede Anfrage kostete Zeit, und niemand wusste, welche Anleitungen überhaupt gesucht wurden.
Der QR-Code am Gerät führt zur passenden Auswahl. Die Suche versteht, was auf dem Typenschild steht, auch mit Tippfehler. Ältere Ausgaben bleiben online und sind als ersetzt markiert. Und das Unternehmen sieht, welche Suchen ohne Treffer bleiben.
Frontend
Der Kunde tippt, was auf dem Typenschild steht. Schon beim Tippen schlägt das Portal passende Typen vor, ein Tippfehler bricht die Suche nicht ab. In der Trefferliste steht die aktuelle Ausgabe oben, ältere Ausgaben klappen darunter auf, mit Gültig-ab und Gültig-bis.
Findet das Portal nichts, bekommt der Kunde ein Anfrageformular statt einer leeren Seite.
Backend
Die Redaktion sieht jede Anleitung als Versionsreihe: Welche Ausgabe ist aktuell, welche ist ersetzt, seit wann gilt sie. Eine neue Ausgabe ist ein neuer Datensatz mit neuer Datei. Die alte bleibt online und auffindbar.
Die Auswertung zeigt, wonach Kunden suchen und was sie nicht finden. So sieht die Redaktion, welche Anleitung fehlt.
Am Gerät
Auf dem Typenschild oder einem Aufkleber sitzt ein QR-Code je Gerätetyp. Wer ihn scannt, landet auf der Auswahlseite dieses Typs: alle Dokumentarten, alle gültigen Ausgaben, mit dem Hinweis, Modelljahr und Ausführung zu prüfen.
Erscheint eine neue Ausgabe, bleibt der Code gleich. Das ist der Zugangshinweis, den die Maschinenverordnung verlangt, ohne dass ein Aufkleber je neu gedruckt wird.
Vier Schritte, vom Bestand in den Ordnern bis zum laufenden Betrieb. Der wichtigste Grundsatz: Nichts geht ungeprüft online.
Wie viele Anleitungen, wie viele Ausgaben, welche Sparten, wo liegen die Dateien. Daraus entsteht die Struktur: Sparte, Kategorie, Gerätetyp, Dokumentart, Ausgabe.
Suche mit Filtern und Autovervollständigung, QR-Ziel je Gerätetyp, Download mit Zähler, Anfrageformular. Dazu zwei Backend-Module: Pflege und Auswertung.
Die vorhandenen PDFs wurden automatisch den Gerätetypen zugeordnet. Danach prüfte das Team jede Zuordnung in einer Prüfliste. Erst dann ging eine Anleitung online.
Suchen ohne Treffer zeigen, welche Anleitung fehlt. Die Redaktion pflegt nach, ohne Entwickler.
01 · Viele Baureihen, lange Nutzungsdauer. Wer Geräte baut, die zehn Jahre und länger laufen, braucht Anleitungen, die genauso lange auffindbar bleiben. Die Versionsreihe beantwortet die Frage, welche Ausgabe für welches Baujahr gilt.
02 · Die Verordnung setzt die Frist. Ab 20. Januar 2027 erlaubt die EU-Maschinenverordnung die digitale Betriebsanleitung nur mit Zugangshinweis am Gerät, Download und Online-Verfügbarkeit über mindestens zehn Jahre (Verordnung (EU) 2023/1230, Artikel 10 Absatz 7). Das ist ein Termin, kein Trend.
03 · Kein Zusatzsystem. Das Portal läuft im vorhandenen TYPO3. Die IT pflegt ein System, die Redaktion einen Ort.
Du siehst das Portal mit Demo-Daten: fiktive Geräte, fiktive Dokumentnummern. Den Auftraggeber nennen wir nicht. Die Suchlogik und die Regeln der Versionsreihen beschreiben wir bewusst nicht im Detail.
Nein. Das Portal ist eine Extension für TYPO3 ab Version 13. Es nutzt die vorhandene Installation, die Dateien liegen in einem geschützten Bereich.
Zuerst eine Bestandsaufnahme: Wie viele Anleitungen, wie viele Ausgaben, wo liegen sie heute. Danach ordnen wir den Bestand automatisch zu, und dein Team prüft die Zuordnung, bevor etwas online geht.
Es deckt die vier Punkte ab, die Artikel 10 Absatz 7 nennt: Zugang über einen Hinweis am Gerät, Zuordnung zum Modell, Download und Verfügbarkeit über die Lebensdauer. Ob deine Produkte unter die Verordnung fallen, klärst du mit deiner Rechtsberatung. Wir liefern die Technik.
Der erste Schritt ist eine Bestandsaufnahme: Anzahl der Anleitungen, Anzahl der Ausgaben, Sparten, Ablageorte. Schick uns diese vier Angaben. Wir sagen dir, was ein Portal in deinem TYPO3 kostet und wie lange es dauert.