Das Produkt
Der VDI_AASX Builder ist ein produktreifes ABAP-Add-on, das wir Industriekunden zur Verfügung stellen, die ihre technische Dokumentation nach VDI 2770 ausliefern müssen. Statt Excel-Listen, manueller ZIP-Erstellung und Validierungs-Pingpong erhalten Sie eine SAP-integrierte Lösung, die Lieferpakete in wenigen Minuten erzeugt.
Die erzeugten Container halten die Vorgaben der Richtlinie VDI 2770 Blatt 1 und das IDTA-Submodel-Template HandoverDocumentation aus dem Industrial Digital Twin Consortium ein. Sie sind XSD-validiert und werden von gängigen Empfängern (BASF, Bayer, Evonik, Wacker und andere Großabnehmer der Prozessindustrie) ohne Nacharbeit akzeptiert.
Funktionen
VDI 2770 Container mit Haupt- und Sub-Dokumenten
Pro Lieferung entsteht ein Hauptdokumenten-Container (ZIP) mit einer beschreibenden VDI2770_Metadata.xml und einem eingebetteten Document-Container pro Quelldokument. Die Sub-Container enthalten jeweils ihre eigene Metadaten-XML und die PDF-Datei. Die Auswahl des Hauptdokuments folgt der Norm: das Dokument mit Klasse 01 Identifikation wird automatisch als Primärverweis gesetzt — Fallback ist die erste verfügbare PDF.
AASX-Paket nach AAS V3
Parallel zum VDI-Container erzeugt der Builder ein AASX-Paket nach Asset Administration Shell V3. Es enthält genau eine AAS-Shell mit Asset-Info, einen Submodel HandoverDocumentation und pro Quelldokument eine SubmodelElementCollection mit DocumentId, DocumentClassifications und DocumentVersion. Die PDFs liegen im Paket unter /aasx/files/. Das Paket ist OPC-konform und lässt sich im AASX Package Explorer öffnen.
Multi-Datei-Upload und Per-Datei-Metadaten
Über das SAP-Selektionsbild wählen Sie mehrere PDFs vom Arbeitsplatz aus. Für jede Datei pflegen Sie in einem Folgedialog die Metadaten: Dokument-ID, Version, Sprache, Titel, VDI-Klasse und Klassenbezeichnung. Mehrfachklassifizierung wird unterstützt — eine Betriebs- und Wartungsanleitung kann gleichzeitig den Klassen 03-02 Bedienung und 03-05 Instandsetzung zugeordnet sein. Werthilfen (F4) liefern die zulässigen Klassen-IDs und produktspezifischen Bezeichnungen.
Dokumente aus SAP-Dokumenteninfosätzen
Der Builder bindet sich an die SAP-DMS-Stammdaten an. Dokumente lassen sich direkt aus Dokumenteninfosätzen (Transaktion CV04N) selektieren, statt sie vorab auf den Desktop zu exportieren. Material- und Equipment-Verknüpfungen werden ausgewertet, sodass die Doku zum Equipment aus dem SAP-Stamm automatisch zusammengestellt wird. Diese Funktion ergänzt den lokalen Datei-Upload — beide Quellen können in einer Auslieferung kombiniert werden. Weitere Informationen zur generellen DMS-Integration finden Sie unter SAP Dokumentenmanagement.
PDF/A-Konvertierung über Adobe Document Services
Großabnehmer fordern in der Regel PDF/A für die Langzeitarchivierung der Doku. Der Builder prüft jede PDF auf den PDF/A-Marker im XMP-Header. Fehlt er, ruft das Programm Adobe Document Services (ADS) auf und konvertiert die Datei. Mit der AUTO-Option versucht das Add-on zuerst die höchste Konformitätsstufe PDF/A-3A, fällt bei Bedarf auf PDF/A-2A und PDF/A-1A zurück. Erfolgreich konvertierte Dateien ersetzen das Original im Auslieferungspaket.
Klappbares Selektionsbild und Variantenpflege
Das Selektionsbild ist in sieben Blöcke gegliedert (Datei-Auswahl, Hersteller, Objekt, Dokument-Metadaten, AAS/AASX, Ausgabe, Per-Datei-Pflege). Jeder Block lässt sich aufklappen und zuklappen. Häufige Konstellationen — etwa wiederkehrende Hersteller-Stammdaten — speichern Sie als SAP-Variante und rufen sie bei jeder Auslieferung auf.
Was Sie davon haben
- Lieferzeit verkürzt: Auslieferungspaket in 5 Minuten statt 2 Stunden Excel-Bastelei.
- Validierte Ausgabe: Geprüft gegen den XSD-Validator des Digital Data Chain Consortium.
- Doppelter Output: VDI-2770-ZIP und AASX in einem Durchlauf — kein Tool-Wechsel.
- Industrie-4.0-fähig: AASX-Output direkt importierbar in AAS-Repositories wie Eclipse BaSyx.
- Kein Medienbruch: Doku bleibt in SAP, Anbindung an DIS und Equipment-Stamm.
- PDF/A inklusive: Konvertierung über vorhandene ADS-Infrastruktur, keine zusätzliche Lizenz.
Technische Architektur
Der Builder ist ein einzelnes ABAP-Report-Programm. Die Erzeugung der Container nutzt cl_abap_zip; XML- und JSON-Bausteine werden über String-Templates aufgebaut. Die Kommunikation mit ADS erfolgt über CL_FP_PDF_OBJECT und die Methode SET_TASK_CONVERTPDF2PDFA.
| Komponente |
Wert |
| Plattform |
SAP NetWeaver 7.50+ / SAP S/4HANA |
| Sprache |
ABAP (Objects + klassisches Reporting) |
| VDI-Schema |
VDI 2770:2018, Blatt 1 |
| AAS-Version |
V3 (IEC 63278), IDTA 02004-1-2 HandoverDocumentation |
| PDF/A-Konvertierung |
Adobe Document Services, PDF/A-1A bis -3A (mit Fallback-Stufen) |
| Lokale Datenquelle |
Frontend-Upload via CL_GUI_FRONTEND_SERVICES |
| SAP-Datenquelle |
DIS / DMS (Roadmap: aktuelle Integration) |
Einsatzszenarien
Wir setzen den Builder bei Herstellern aus dem Anlagenbau und der Komponentenfertigung ein. Typische Anwendungsfälle:
- Ventil- und Antriebshersteller liefern Gerätepass, Einbauzeichnung, Betriebsanleitung, ATEX-Zertifikate und Konformitätserklärungen als ein Paket pro Seriennummer aus.
- Pumpen- und Verdichterhersteller bündeln technische Spezifikationen, Wartungspläne und Ersatzteillisten je Equipment.
- EMSR-Lieferanten ergänzen Schaltpläne und Inbetriebsetzungsprotokolle.
- Anlagenbetreiber nutzen das AASX-Output, um Industrie-4.0-Verwaltungsschalen für ihre Bestandsanlagen aufzubauen — siehe SAP Industrie 4.0.
