iiRDS+VDI 2770: Ziemlich beste Freunde?

Jan Oevermann von

Bild: Anwenderportal

Dem Anschein nach konkurrieren die Standards iiRDS und VDI 2770 um die Vorherrschaft als Austauschformat für digitale Technische Dokumentation. Doch ein Blick hinter die Kulissen zeigt: Es wurde viel Arbeit investiert, um die beiden Standards in Einklang zu bringen.

Zurück in die Zukunft

Die Digitalisierung der modernen Industrie macht auch vor der Technischen Dokumentation nicht Halt. Durch immer individuellere Produktvarianten, weitverzweigte globale Lieferketten und eine Vielzahl an beteiligten IT-Systemen wächst die Menge technischer Unterlagen. Klassifizierende Metadaten und einheitliche Dateiformate sind im Informationsmanagement das Mittel der Wahl, um der Lage Herr zu werden. Die Maßnahmen sind jedoch oft unternehmensspezifisch geprägt oder stark abhängig von der verwendeten Software. Dadurch werden wesentliche Vorteile eines übergreifenden Informationsaustauschs verspielt.

Das PDF-Format stellt aktuell so etwas wie den Standard für die Auslieferung digitaler Handbücher dar. In den meisten Fällen entsprechen Handbücher im PDFFormat dem Nutzwert einer gescannten Variante der Papierdokumentation. Weitergehende Möglichkeiten für Filterung, Zuordnung oder Organisation bieten sie nicht. Eine paradoxe Situation, wenn man bedenkt, in welcher Fülle Metadaten und Struktur in modernen Redaktionssystemen vorhanden sind. So wird bei der Publikation sowohl ein Großteil wertvoller Zusatzinformationen verworfen als auch dem Abnehmer die Einordnung der Inhalte ungemein erschwert. Gerade Content-Delivery- Portale profitieren jedoch von den so genannten „intelligenten Informationen“ und können dadurch einen echten Mehrwert für Anwender generieren.

Standards für den Informationsaustausch

DCC Document kind classification code; die in der DIN EN 61355 geregelte Klassifikation für technische Unterlagen, die auch in der VDI 2770 referenziert wird; siehe auch DIN EN 61355-1:2009-03.
eCl@ss Datenstandard für die Klassifizierung von Produkten und Dienstleistungen auf Basis von international genormten Merkmalen; wird in der VDI 2770 für die Objekt-Referenzierung verwendet und kann in iiRDS ebenfalls benutzt werden.
E.T. Kein Standard für den Informationsaustausch aber der Extra-Terrestrial fügt sich so schön in die Reihe der Abkürzungen und Filmtitel ein...
iiRDS intelligent information Request and Delivery Standard; ein vom iiRDS-Konsortium entwickelter Open-Source-Standard für den Austausch von digitaler Technischer Dokumentation; spezifiziert ein Containerformat und eine RDF-basierte Domänenontologie; siehe auch iiRDS 1.0.1:2019-07.
IRI Internationalized Resource Identifier; die internationalisierte Version des Uniform Resource Identifier (URI); ein global eindeutiger Bezeichner in festgelegter Form mit den Unterarten URL (zum Beispiel Web-Adressen) und URN (zum Beispiel ISBN).
IRDI International Registration Data Identifier; die von eCl@ss verwendeten und international genormten Bezeichner für die Referenzierung von Objekten.
RDF Resource Description Framework; Methode zur Beschreibung von Beziehungen zwischen Ressourcen durch Aussagen, den so genannten Tripeln; kann in verschiedenen Formaten ausgedrückt werden, etwa als RDF/XML; Basis für die iiRDS-Metadatendatei.
VDI 2770 Richtlinie des VDI, die Mindestanforderungen an den Austausch von digitalen Herstellerinformationen für die Prozessindustrie festlegt; spezifiziert ein Containerformat und ein XML-basiertes Metadatenschema; siehe auch VDI 2770-1:2020-04.
XML Extensible Markup Language; eine medienneutrale Auszeichnungssprache für strukturierte Daten, wird für die Erfassung von Inhalten oder zur Serialisierung von Metadaten verwendet.

Eine neue Hoffnung

Die Hoffnung der Unternehmen ruht auf einem standardisierten Austauschformat für digitale Technische Dokumentation. Es kann sowohl die Kommunikation mit Zulieferern als auch den internen Informationsaustausch erheblich vereinfachen. Zugleich kann es als stabile Basis für die Abbildung moderner datengetriebener Use Cases für Content dienen. Entwickelt von unabhängiger Stelle und in Einklang mit den Anforderungen der Industrie soll der Standard die Brücke zwischen Organisationen und Systemen schlagen, um einen verlustfreien Informationsfluss zu ermöglichen. Metadaten spielen dabei eine zentrale Rolle bei der Zuordnung zu Produkt- und Informationstypen und sollen explizit zugänglich gemacht werden.

Zunächst getrennt voneinander haben sich zwei Initiativen zur Festlegung technischer Regeln gebildet. Sie verfolgen die genannten Ziele:

  • Eine Arbeitsgruppe des Vereins Deutscher Ingenieure (VDI) zur Ausarbeitung von Mindestanforderungen an digitale Herstellerinformationen für die Prozessindustrie; das vorrangige Ziel lautet, den Austausch zwischen Zulieferern und Kunden aus der Prozessindustrie zu standardisieren und das Regelwerk in die nationale und internationale Normung zu überführen.
  • Eine Arbeitsgruppe der tekom zur Ausarbeitung eines Austauschformats für Inhalte der Technischen Kommunikation mit dem vorrangigen Ziel, Informationen intelligent bereitstellen zu können und den herstellerneutralen Austausch zwischen Systemen (zum Beispiel Redaktionssystemen und Content-Delivery-Portalen) zu ermöglichen; darüber hinaus hat die Arbeitsgruppe das Ziel, informationsbezogene Metadaten in einer Domänenontologie zu standardisieren, soweit dies übergreifend sinnvoll ist.

In mehreren Jahren sind dabei zwei Spezifikationen entstanden, die eine festgelegte Kategorisierung für technische Informationen vorschlagen. Außerdem geben sie Dateiformate für Inhalt und Metadaten vor und definieren den Aufbau eines Austauschpakets.

Der Herr der Dinge

Beide Vorhaben verfolgen das gleiche Ziel. Die Anforderungen, die daraus entstehen, setzen sie aber unterschiedlich um. Die VDI 2770 legt den Fokus auf ganze Dokumente und bildet mit PDF-Dateien als Pflichtformat den aktuellen Stand in der Technischen Dokumentation ab. Anders iiRDS, der Standard löst sich vom Dokumentenkontext und setzt im Kern auf ein topicorientiertes Vorgehen mit verschiedenen Content-Formaten und semantischen Beziehungen. Je nach Situation und Zielgruppe können dem Nutzer relevante Informationseinheiten geliefert werden.

Um die notwendigen semantischen Beziehungen für ein nutzerzentriertes Content Delivery zu modellieren, wurde für iiRDS eine auf Technische Dokumentation fokussierte Ontologie entworfen. Sie gibt einen Rahmen für die Vergabe von Metadaten vor. Basierend auf einer Sammlung von typischen Use Cases wurde hier besonders der Bezug zum Kontext (Tätigkeit, Zeitpunkt, Zielgruppe) und der Bezug zu den Dingen (Produkt, Baugruppe, Werkzeug) in den Vordergrund gestellt.

Ob nun VDI 2770 oder iiRDS – jeder Ansatz hat Vor- und Nachteile, die sich darauf auswirken, welches Format für ein Unternehmen passt. Viele Zulieferer, die aktuell Papierdokumentationen mit ihren technischen Produkten ausliefern, werden eher auf die VDI-Richtlinie zurückgreifen. So können sie in Zukunft die Mindestanforderungen großer Einkäufer erfüllen. Die Anforderungen an eine modulare topicorientierte Dokumentation werden eher durch iiRDS erfüllt.

Eine wichtige Grundlage modernen Informationsmanagements bilden beide Standards ab: die eindeutige Identifikation von Inhalten, Metadaten und (physischen) Objekten, wie etwa Produkte oder Baugruppen. Erst dadurch wird die Beziehungsbildung möglich und eine universelle Austauschbarkeit gewährleistet. Während iiRDS durchgängig IRIs verwendet (deren Spezialisierung, die URL, kennt man aus dem Internet), setzt die VDI 2770 auf eine Kombination von domänenspezifischen IDs, den in eCl@ss verwendeten IRDIs und bestimmten Kodierungen. Dazu zählen die DCCs aus der DIN EN 61355 oder ClassIds für VDI-2770-Dokumentkategorien. Sie können seit Version 1.0 als so genannte „Komplexe Identitäten“ in iiRDS mit angegeben werden, so dass eine eindeutige Zuordnung über beide Standards weiterhin möglich bleibt.

Gemeinsamkeiten und Unterschiede zeigen sich auch bei den konkreten technischen Vorgaben. Beide Standards nutzen als Container-Format ein ZIP-Archiv. Die Vorgaben zur Datei- und Verzeichnisstruktur im Container weichen aber voneinander ab. So macht die VDI-Richtlinie strenge Vorgaben zum Inhaltsformat (PDF/A und optionale Quelldateien). Bei iiRDS gibt nur die iiRDS/A-Variante Regeln für Dateiformate vor: XHTML5 oder PDF/A.

Die zentralen Metadaten werden bei der VDI 2770 pro Dokument als XML-Datei umgesetzt, bei iiRDS ist hingegen eine einzelne RDF-Datei für alle Dateien vorgesehen. Sie definiert auch die Zusammenhänge innerhalb des Gesamtpakets. Diese Aufgabe übernimmt bei der VDI-Richtlinie das so genannte Hauptdokument auf oberster Ebene (eine Art Inhaltsverzeichnis) sowie die verschachtelte Struktur des Paketinhalts.

Durch den Einsatz einer einzelnen RDF-Datei ergibt sich auch, dass iiRDS-Pakete aufgrund der hohen Komplexität nur durch spezielle Systeme erstellt und gelesen werden können. Beim VDI-Format bleibt hingegen durch relativ einfache Strukturen und XML-basierte Metadaten die Möglichkeit einer direkten Bearbeitung durch den Menschen bestehen.

Krieg der Welten

Die VDI 2770 integriert DIN EN 82045-2 und DIN EN 61355 und bringt einen erheblichen Teil von Vorgaben aus dem Dokumentenmanagement mit. Anders iiRDS, der Standard fokussiert sich auf semantische und funktionale Beziehungen zwischen verschiedenen Inhaltsarten und Produktbestandteilen. Reine Verwaltungsmetadaten wie Freigabe oder Statusübergänge rücken in den Hintergrund.

Weiterhin verfolgt iiRDS bei der Ausmodellierung der Metadaten den Ansatz der „Offenen Welt“. Er ist im semantischen Web verbreitet und erlaubt es dem Anwender, auf Basis der Ontologie neue Werte und Beziehungen zu definieren. Alle Modellierungen sind grundsätzlich erlaubt, solange sie nicht explizit eingeschränkt werden. So ist es ausdrücklich vorgesehen, dass zum Beispiel unternehmensspezifische Werte für Zielgruppen oder Produktlebenszyklusphasen ergänzt werden. Dies steht im Gegensatz zu den Vorgaben, die in der VDI-Richtlinie getroffen werden. Dort wird präskriptiv beschrieben, welche Modellierungen erlaubt sind.

Durch die Modellierungsansätze „offen“ und „geschlossen“ sowie den Umstand, dass der tekom-Standard neben Dokumenten noch eine Vielzahl weiterer Informationseinheiten zulässt, kann das Metadatenmodell der VDI-Richtlinie als Untermenge von iiRDS betrachtet werden. Auf Basis entsprechend vorbereiteter und reglementierter iiRDS-Daten kann also ein VDI-2770-Paket generiert werden, wenn auch häufig mit einem Informationsverlust auf Metadatenebene. Deutlich wird das anhand der Klassifikation von Dokumenten. Die 20 vordefinierten Dokumentarten aus iiRDS können den zwölf Dokumentkategorien aus der VDI 2770 eindeutig zugeordnet werden. Umgekehrt ist das jedoch nicht mehr ohne Zusatzwissen möglich.

Dokumenttypen in iiRDS und VDI 2770

iiRDS (Dokumentart) VDI 2770 (Dokumentkategorie)
Administrationsanleitung Bedienung
Montageanleitung Montage, Inbetriebnahme, Demontage
Stückliste Bauteile
CE-Konformitätserklärung Zeugnisse, Zertifikate, Bescheinigungen
Zertifikat Zeugnisse, Zertifikate, Bescheinigungen
Vertragliches Dokument Vertragsunterlagen
Elektronisches Typenschild Identifikation
Identifikationsdokument Identifikation
Installationsanleitung Montage, Inbetriebnahme, Demontage
Wartungsanleitung Inspektion, Wartung, Prüfung
Betriebsanleitung Bedienung
Teilekatalog Ersatzteile
Plan Zeichnungen/Pläne
Kurzanleitung Montage, Inbetriebnahme, Demontage
Reparaturanleitung Instandsetzung
Sicherheitsanleitung Allgemeine Sicherheit
Verkaufskatalog Vertragsunterlagen
Spezifikation Technische Spezifikation
Technische Zeichnung/Diagramm Zeichnungen/Pläne
Transportanleitung Montage, Inbetriebnahme, Demontage

Per Anhalter durch die Gremien

Nachdem im März 2016 die Arbeitsgruppe „Information 4.0“ der tekom ihre Arbeit mit dem Ziel aufgenommen hat, ein einheitliches Austauschformat für Technische Dokumentation zu definieren, konnte im April 2017 der erste Vorab-Entwurf von „iiRDS – intelligent information Request and Delivery Standard“ der Öffentlichkeit vorgestellt werden. Etwa zur gleichen Zeit war der Fachbereich „Betrieb verfahrenstechnischer Anlagen“ im VDI mit der Ausarbeitung der „VDI-Richtlinie 2770 Blatt 1“ beschäftigt. Im Oktober 2017 kam es zu einem ersten Treffen der beiden Gremien, um Gemeinsamkeiten und Unterschiede der Standardisierungsbestrebungen auszuloten.

Nach dem Beschluss zur Zusammenarbeit wurden die zur Kompatibilität notwendigen Umbauarbeiten in einem internen Exposé festgehalten und schrittweise innerhalb der Arbeitsgruppen umgesetzt. So wurden seit Version 0.9 von iiRDS die in der VDI 2770 obligatorischen Dokumentenmanagement-Metadaten integriert. Diese enthalten zum Beispiel Identitätsdomänen, Inhaltslebenszyklusphasen,Freigabe-Statusübergänge oder Bezüge zu Akteuren. Darüber hinaus wurden fehlende Dokumenttypen, Produktlebenszyklusphasen und Informationsthemen ergänzt. Nach dem Gründruck der VDI-Richtlinie wurde diese im Hinblick auf Unterordner in Dokumentcontainern so angepasst, dass eine Kompatibilität zu iiRDS gewahrt bleibt. Beide Standards haben sich aufeinander zubewegt, um einer Fragmentierung beim Austausch digitaler Dokumentation vorzubeugen.

Nach der Gründung des iiRDS-Konsortiums Anfang 2018 und der Veröffentlichung von „iiRDS 1.0“ im April wurden die Bestrebungen zur Zusammenarbeit wieder aufgenommen und ausgebaut. Ende 2018 hat das Konsortium einen „Implementation Guide“ in Auftrag gegeben. Der Guide beschreibt eine konkrete Umwandlung zwischen den Formaten und skizziert die Möglichkeit so genannter Hybridpakete. In Zuge dessen haben die Gremien weitere Mappings zwischen den Metadaten der Regelwerke festgelegt, außerdem haben sie gegenseitige Sitzungsbesuche beschlossen.

Inzwischen wurden die beiden Standards weiterentwickelt. Von iiRDS ist Version 1.0.1 verfügbar, die VDI-Richtlinie wurde Anfang April 2020 veröffentlicht. Daher wird eine überarbeitete Version des „Implementation Guide“ nötig, die in der ersten Hälfte des Jahres 2020 zur Verfügung stehen soll. Das große Interesse der Industrie an einer übergreifenden Lösung hat gezeigt, dass der Weg der Zusammenarbeit richtig und notwendig war, um austauschbare digitale Dokumentation möglich zu machen.

Das fünfte Element

Das zentrale Konzept der VDI-Richtlinie 2770 ist die Abbildung der physischen Produktstruktur in einer Verschachtelung von Dokumentcontainern. Dieses Matrjoschka- Prinzip (nach dem Bild der ineinander schachtelbaren russischen Puppen) ermöglicht, die Dokumentation eines Baugruppenherstellers relativ einfach in die übergeordnete Dokumentation des Gesamtprodukts zu integrieren oder auch zu ersetzen. Dabei bringt jeder Container seine eigenen Metadaten- und Verwaltungsinformationen mit. Auf diese Weise kann eine einfache Zusammenstellung der Gesamtdokumentation erfolgen, wenn alle Zulieferer ihre Dokumentation konform zur VDI 2770 abliefern.

Bislang sah iiRDS nur einen Container zur Auslieferung vor, in dem Content ausschließlich über die Metadaten eine hierarchische Struktur zugewiesen bekommt. In einem solchen Container sind zwar Unterordner möglich, haben aus semantischer Sicht jedoch keine Bedeutung. Was die Verschachtelung mehrerer iiRDS-Container ineinander angeht, hat die Spezifikation bis einschließlich Version 1.0.1 keine konkreten Aussagen getroffen. Eine direkte Abbildung der VDI-Logik war deshalb nicht ohne Weiteres möglich.

Die Matrjoschka-Container sind im allgemeinenNutzungskontext von iiRDS eine sinnvolle Erweiterung, etwa wenn es um die Integration von Zulieferdokumentation geht. Zur konkreten Form dieser verschachtelten Pakete wurde deshalb im Oktober 2019 eine Basis-Abstimmung über verschiedene Implementierungsvarianten innerhalb des Konsortiums durchgeführt, ein so genanntes „Technical Ballot“. Die bevorzugte Lösung wird aktuell in der iiRDS-Spezifikation verankert und mit der kommenden Version 1.1 in den Standard aufgenommen. Zusammen mit der finalen Version der VDI-Richtlinie und dem aktualisierten „Implementation Guide“ bildet iiRDS 1.1 somit die Grundlage für die Kompatibilität der beiden Standards.

Bild: Hybrid-Paket

Damit entsteht nun ein neues Element im Periodensystem der Paketformate: Ein hybrides Paket, das konform zu den Vorgaben beider Standards ist (abb. 01). Es kann sowohl von VDI-2770-Software als auch von iiRDS-kompatiblen Systemen eingelesen werden und erfüllt damit auch etwaige VDI-2770-Einkaufsbedingungen großer Konzerne. Zu beachten ist jedoch, dass die Inhalte zwar identisch für beide Lesarten sind – die Metadaten jedoch nicht. Die iiRDS-Datei enthält in einem solchen Kombi- Container wesentlich mehr Informationen als das VDI-Pendant. Ob sich in der Praxis das Hybrid-Paket durchsetzen wird oder zwei parallel generierte Pakete ausgeliefert werden, wird die Zukunft zeigen.

Die üblichen Verdächtigen

Beide Austauschstandards haben nicht zuletzt durch die unterschiedlich gesetzten Schwerpunkte ihre Daseinsberechtigung und werden für absehbare Zeit nebeneinander existieren. Dabei sind sie jedoch keineswegs inkompatibel, sondern können jeweils vom anderen profitieren, zum Beispiel durch den einfachen Einstieg in die VDI-2770-basierte Auslieferung von Dokumenten bis zur Ausbaustufe iiRDS, in der topicbasierte und vernetzte Informationen kontextsensitiv bereitgestellt werden. Durch die Zusammenarbeit der zuständigen Gremien sind die Formate gut aufeinander abbildbar und verfolgen gleiche Ideen und ähnliche Ziele. Das nützt vor allem Unternehmen, die sich nicht entscheiden wollen, auf welchen Standard sie in Zukunft setzen sollen, und bringt Licht in den Dschungel an Formaten. Mit einer guten Metadatenbasis und entsprechender Software ist es bereits möglich, beide Formate zu erzeugen oder eben Hybridpakete für den Austausch einzusetzen.

Die Vorgaben der Standards in Bezug auf Formate und Modellierung können darüber hinaus als etablierte Best Practices dienen. Das entkräftet auch das Auswahlkriterium der Verbreitung, das viele Firmen zur Beurteilung eines Standards heranziehen. Werden die Grundprinzipien eines soliden Informationsmanagements (Metadaten, Struktur und Identifikation) beachtet, ist der Schritt zu einem intelligenten Austauschformat nicht mehr weit. Die üblichen Verdächtigen dafür stehen bereits fest.

Abspann

Dieser Artikel wurde am 19.05.2020 veröffentlicht in Ausgabe 03/20 von technische kommunikation.

Normen und Standards zum Thema

  • DIN EN 61355-1:2009-03 „Klassifikation und Kennzeichnung von Dokumenten für Anlagen, Systeme und Ausrüstungen – Teil 1: Regeln und Tabellen zur Klassifikation“ (VDE 0040-3:2009-03, IEC 61355-1:2008)
  • DIN EN 62023:2012-08 „Strukturierung technischer Information und Dokumentation“ (IEC 62023:2012)
  • DIN EN 82045-2:2005-11 „Dokumentenmanagement – Teil 2: Metadaten und Informationsreferenzmodelle“ (IEC 82045-2:2004, VDE 0040-6:2012-08);
  • iiRDS 1.0.1:2019-07 „tekom iiRDS Standard – intelligent information Request and Delivery Standard“. Version 1.0.1. Release Date 12 July 2019. iirds.org
  • VDI 2770-1:2020-04 „VDI 2770 Blatt 1 – Betrieb verfahrenstechnischer Anlagen – Mindestanforderungen an digitale Herstellerinformationen für die Prozessindustrie – Grundlagen“

Weiterführende Literatur zum Thema