Warum die Dokumentationserstellung seit 2024 fehlschlagen oder sich anders verhalten kann

Seit 2024 hat Microsoft in Microsoft 365 und Office 2024 ActiveX-Steuerelemente standardmäßig deaktiviert (siehe offizielle Ankündigung von Microsoft).
Dieses Plugin steuert MS Word über dessen COM/ActiveX-Automatisierungsschnittstelle, und Word verweigert nun das Erstellen neuer ActiveX-Objekte, solange es auf diese Weise automatisiert wird, sofern Sie dies nicht ausdrücklich zulassen.
Am stärksten betroffen ist das Tag recursiveimg mit einem *.xlsx-Filter, das ein aktives MS Excel-Arbeitsblatt als ActiveX/OLE-Objekt in das Dokument einbettet – genau diese Art von Vorgang blockiert die neue Standardeinstellung von Microsoft. Normale Bilder (*.png, *.jpg, ...) sind keine ActiveX-Objekte und nicht betroffen.

So umgehen Sie das Problem:

• Öffnen Sie in Word Datei » Optionen » Trust Center » Einstellungen für das Trust Center » ActiveX-Einstellungen (engl. File » Options » Trust Center » Trust Center Settings » ActiveX Settings) und wählen Sie „Mit minimalen Einschränkungen vor dem Aktivieren aller Steuerelemente auffordern“ (engl. "Prompt me before enabling all controls with minimal restrictions").
  Beachten Sie, dass diese Einstellung für alle Office-Anwendungen auf diesem Computer gilt (Word, Excel, PowerPoint, Visio), nicht nur für die von diesem Plugin erzeugten Dokumente.
• Schlägt die Erstellung mit einer Vorlagendatei danach weiterhin fehl, wählen Sie unten die Option "MS Office interactive mode".
  Word bleibt dann während der Erstellung des Dokuments sichtbar, sodass Sie jede Sicherheitsabfrage von Word sehen und manuell bestätigen können, statt dass sie die Automatisierung im Hintergrund stillschweigend blockiert.
• Wenn Sie keine eingebetteten Excel-Arbeitsblätter benötigen, verwenden Sie in Ihrer Projektdatei das Tag recursiveimg nicht mit einem *.xlsx-Filter – so umgehen Sie genau den Vorgang, der die Blockierung auslöst.
• Hilft nichts davon und schlägt die Dokumentationserstellung weiterhin fehl, entfernen Sie den Pfad zur Vorlagendatei und lassen Sie dieses Feld leer. Das Plugin erstellt dann ein neues, leeres Word-Dokument, statt Ihre angepasste Vorlage zu öffnen, und die Dokumentationserstellung wird erfolgreich abgeschlossen.
  Der einzige Nachteil dieser Lösung: Das erzeugte Dokument enthält keine Titelseite, die sonst die Vorlage liefert (Firmenlogo, vorformatiertes Deckblatt usw.) – alle übrigen erzeugten Inhalte (Abschnitte, Tabellen, Bilder, Referenzen) sind nicht betroffen und werden wie gewohnt erstellt. So können Sie weiter Dokumentation erzeugen, während das zugrunde liegende Word-Automatisierungsproblem auf Ihrem Rechner behoben wird.

Wir arbeiten an einer Methode zur Dokumentationserstellung, die nicht mehr auf der Automatisierung von MS Word beruht, damit künftige Sicherheitsänderungen von Microsoft dieses Plugin nicht mehr beeinträchtigen.

Kommen Sie trotzdem nicht weiter? Auch andere Software auf Ihrem Rechner (Sicherheitssuiten, Add-ins für Rechteverwaltung/DLP, alte zurückgebliebene Treiber, ...) kann die Automatisierung von Word/Excel stillschweigend blockieren, manchmal ganz ohne eindeutige Fehlermeldung. Mehr zu diesem Problem mit der Word-Automatisierung und seiner Diagnose »

• Überblick
• Plugin-Fenster
• Einfache Projektdatei
  • FanucDocumentationProProject
    • section
    • makeindex
    • stations
      • app
      • filelist
      • calltree
      • reference
      • img
      • recursiveimg
      • text
      • robot
      • breakline
      • breakpage
      • date
• Beispiele
• Ressourcen

---

▲ Überblick

Das Plugin Documentation Generator Pro erzeugt automatisch eine Dokumentation für die Archivdateien mehrerer Roboter im Format MS Word oder PDF.

Um das Aussehen der erzeugten Dokumente anzupassen, können Sie eine XML-Projektdatei für die Dokumentation bearbeiten oder neu erstellen.

Das Plugin verwendet ein angepasstes MS-Word-Dokument als Vorlage für die endgültige Dokumentation.
Sie können eine MS-Word-Vorlage mit eigener Kopf- und Fußzeile und sogar eigener Titelseite vorbereiten.

In der folgenden Abbildung sehen Sie ein Beispiel für eine Dokumentationsvorlage.
In das erste leere Textfeld auf der ersten Seite wird automatisch der Robotername geschrieben.
Das zweite Textfeld kann den vom Benutzer festgelegten Projektnamen enthalten.




Nachfolgend finden Sie die Beschreibung einer einfachen Projektdatei und der vordefinierten XML-Tags, mit denen Quelltexte externer Dateien eingebunden, Systeminformationen des Roboters angezeigt, die Referenztabelle der Variablen ausgegeben werden kann und vieles mehr.
Wenn Sie eine eigene Projektdatei für die Dokumentation erstellen möchten, kontaktieren Sie uns – wir helfen Ihnen kostenlos.

Erzeugen Sie vor dem Start unbedingt die aktuelle Referenzliste des Roboters.

---

▲ Plugin-Fenster

---

▲ Einfache Projektdatei

Um das Aussehen der erzeugten Dokumentation anzupassen, können Sie eine einfache XML-Projektdatei mit einigen vordefinierten Tags erstellen oder bearbeiten.
Mit diesen Tags schreiben Sie normalen Text mit festgelegter Schriftart, Farbe und Ausrichtung oder fügen zusätzliche Informationen über den Roboter ein.

▲ Die XML-Projektdatei beginnt mit dem Haupt-Tag FanucDocumentationProProject.
Zwischen diesen Tags definieren Sie den gesamten Inhalt der Dokumentation.

Eigenschaft	Werte	Beschreibung
version	Beliebiger gültiger Versionsnummer-Text	Versionsnummer der Projektdatei.

---

▲ Das Tag section dient zum Einfügen von Roboterinformationen und Auflistungen externer Dateien.

Eigenschaft	Werte	Beschreibung
title	Beliebiger gültiger Text	Titel des Abschnitts.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des Abschnittstitels. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Ausrichtung des Abschnittstitels.
include	[ 1 | 0 ]	Bei 1 wird der Abschnitt in das Dokument aufgenommen. Bei 0 oder ohne Angabe wird dieser Abschnitt nicht angezeigt.

Das Tag section kann folgende Unter-Tags enthalten: img, text, robot, breakline, breakpage, filelist, reference.

---

▲ Das Tag makeindex erstellt ein Seitenverzeichnis.
Wenn für jeden im Dokument enthaltenen Abschnitt die richtige Seitenzahl angezeigt werden soll, fügen Sie dieses Tag am Ende der Projektdatei ein.
Nur so kann das Plugin korrekt auf die Seitenzahlen verweisen.

Eigenschaft	Werte	Beschreibung
title	Beliebiger gültiger Text	Titel der Verzeichnisseite.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des Titels des Seitenverzeichnisses. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
style2	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text der Seitenliste mit den Abschnittsnamen. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Textausrichtung.
include	[ 1 | 0 ]	Bei 1 wird das Seitenverzeichnis in das Dokument aufgenommen. Bei 0 oder ohne Angabe wird dieser Abschnitt nicht angezeigt.

---

▲ Das Tag app definiert die Beschreibung der Roboteranwendung.

Eigenschaft	Werte	Beschreibung
text	Beliebiger gültiger Text	Beschreibungstext der Anwendung, z. B.: Handling, Kleben, Schweissen.
makro	Durch Semikolon getrennte Textliste	Durch Semikolon getrennte Liste der Makronummern, die von der angegebenen Anwendung verwendet werden. Zum Beispiel verwenden Handling-Anwendungen die Makros 340;342;343 und Kleben die Makros 180;181;190;191;200;201.

Weitere Details siehe Tags robotapplication und robot.

---

▲ Das Tag stations definiert die langen Namen der Stationen.

Eigenschaft	Werte	Beschreibung
short	Beliebiger gültiger Text
long	Beliebiger gültiger Text

Weitere Details siehe Tag robot.

---

▲ Das Tag filelist dient zum Einbinden des Quelltexts der Roboterprogramme.

Eigenschaft	Werte	Beschreibung
filter	Gültiger regulärer Ausdruck	Dieser reguläre Ausdruck definiert einen Filter für die Dateien, die gesucht und in die Dokumentation aufgenommen werden. Wenn Sie zum Beispiel nur vom Benutzer definierte Makros aufnehmen möchten, verwenden Sie den Filter makro5[0-9].src. Dieser Filter nimmt die Makros 50, 51, 52, 53, 54, 55, 56, 57, 58 und 59 auf, sofern sie vorhanden sind. Der Filter folge*.src nimmt alle Folge-Dateien auf, up*.src nur die UPs.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des angezeigten Dateinamens. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
style2	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des Quelltexts der eingebundenen Dateien. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Textausrichtung.
viewer	[ -1 | 0 | 1 ]	Bei 0 wird der Dateiinhalt als reiner Text angezeigt. Bei 1 wird der Text so angezeigt wie im VFanuc-Viewer. Bei -1 wird der Dateiinhalt nicht angezeigt.
comment	[ 0 | 1 ]	Bei 1 wird der Dateikommentar nach dem Dateinamen angezeigt.

---

▲ Das Tag calltree dient zum Einbinden des rekursiven Aufrufbaums der Programme.

Eigenschaft	Werte	Beschreibung
comment	[ 1 | 0 ]	Bei 1 wird der Programmkommentar angezeigt.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des angezeigten Dateinamens. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.

---

▲ Das Tag reference dient zum Einbinden einer Referenzliste für die angegebene Variable.
Diese Referenzliste wird aus der Referenzliste des Roboters erzeugt. Stellen Sie sicher, dass Sie die Referenzliste des Roboters vor dem Start erstellt haben.

Das Ergebnis dieses Befehls ist eine Tabelle mit 3 Spalten.
Die erste Spalte enthält den Variablennamen, die zweite den Langtext der Variablen und die dritte die Dateien, in denen diese Variable verwendet wird.

Eigenschaft	Werte	Beschreibung
variable	Regulärer Ausdruck mit Variablenname(n)	Der Variablenname ist eine der gültigen Variablen aus der Referenzdatei, z. B.: (E|A) – zeigt alle Eingänge und Ausgänge an, Makro, M, bin, F, I usw.
from	Zahl	Untere Grenze des Variablenbereichs. Weglassen oder leer lassen, um bei 1 zu beginnen.
to	Zahl	Obere Grenze des Variablenbereichs. Weglassen oder leer lassen, um bei der letzten verfügbaren Variablen zu enden.
exclude	comment:<Regulärer Ausdruck>	Mit dieser Eigenschaft lassen sich bestimmte Langtexte ausschließen. Derzeit wird ein Filter auf Basis des Variablenkommentars unterstützt. Zum Beispiel schließt exclude="comment:Roboterfreigabe\s+d+" alle Variablenkommentare aus, die Roboterfreigabe gefolgt von einer Zahl enthalten.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des angezeigten Textes. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Textausrichtung.
cellpadding	Beliebiger positiver Zahlenwert	Legt den Abstand (horizontal und vertikal) zwischen Zellenrand und Inhalt fest.
border	Beliebiger positiver Zahlenwert	Legt die Stärke des Rahmens um die Tabelle fest.

---

▲ Das Tag img fügt das angegebene Bild aus der Ressource ein.

Eigenschaft	Werte	Beschreibung
src	Bild	Enthält einen URI, der auf den Speicherort der Bildressource verweist.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des Bildes. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
width	<Länge> px	Legt die Breite des Bildes fest.
height	<Länge> px	Legt die Höhe des Bildes fest.
rotation	<Winkel>	Legt den Drehwinkel in Grad fest. Positiver Wert für Drehung im Uhrzeigersinn, negativer Wert für Drehung gegen den Uhrzeigersinn.
align	[ left | right | center | justify ]	Horizontale Ausrichtung des Bildes.

---

▲ Das Tag recursiveimg fügt Bilder rekursiv ein.
Damit können Sie Traglastprotokolle, die Sicherheitskonfiguration usw. einfügen.

Wenn Sie mehr als ein Bild eines Traglastprotokolls einfügen möchten, können Sie die Dateinamen wie folgt festlegen:
und folgenden Dateifilter verwenden:

Das Tag __ROBOTNAME__ wird durch den aktuellen Roboternamen ersetzt.

Eigenschaft	Werte	Beschreibung
path	Beliebiger gültiger Systempfad	Pfad zum Verzeichnis mit den Bildern.
filter	Durch Semikolon getrennte Liste von Dateifiltern	Mit dem Filter werden passende Bilder im Verzeichnis gefunden, z. B.: *.png;*.bmp;*.gif;*.jpg;*.jpeg Sie können sogar eine Acrobat-Reader-Datei einfügen. Verwenden Sie in diesem Fall den Filter *.pdf. Im Filter können Sie das Tag __ROBOTNAME__ verwenden, das durch den aktuellen Roboternamen ersetzt wird.
align	[ left | right | center | justify ]	Horizontale Ausrichtung des Bildes.
scaleW	Beliebige gültige Gleitkommazahl	Skalierungsfaktor für die Bildbreite.
scaleH	Beliebige gültige Gleitkommazahl	Skalierungsfaktor für die Bildhöhe.
rotation	<Winkel>	Legt den Drehwinkel in Grad fest. Positiver Wert für Drehung im Uhrzeigersinn, negativer Wert für Drehung gegen den Uhrzeigersinn.
breakpage	[true | false]	Bei true folgt nach diesem Bild ein Seitenumbruch.

---

▲ Das Tag text fügt reinen Text in das Dokument ein.
Für das Zeichen < verwenden Sie bitte &lt;, für das Zeichen > &gt;.

Eigenschaft	Werte	Beschreibung
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des eingefügten Textes. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Textausrichtung.

---

▲ Das Tag robot fügt zusätzliche Informationen über das Robotersystem ein.

Eigenschaft	Werte	Beschreibung
attr	[ name | plc | safety | id |   swserial | swversion |   vagupdate | controlid | ip |   station | tool | base | load | justage |   interia | moment | armload |   limits:1 | limits:2 | limits:3 | limits:4 |   application | used_coll ]	Name der anzuzeigenden Robotereigenschaft. Einige Eigenschaften liefern nur eine einzelne Textzeile (die Eigenschaft station gibt eine Stationsbeschreibung aus, sofern definiert; siehe stations).
title	Beliebiger gültiger Text	Name der Eigenschaft, der vor dem Textwert angezeigt wird.
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des Namens der Eigenschaft. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
style2	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des eingefügten Eigenschaftswerts. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Textausrichtung.
regexp	Beliebiger gültiger regulärer Ausdruck	Sucht den regulären Ausdruck im angegebenen Roboterattribut und liefert den erfassten Text. So lässt sich ein Teil einer Zeichenkette extrahieren, z. B. der Stationsname aus dem Roboternamen.
from	Beliebiger gültiger Zeichenindex	Liefert einen Teilstring des angegebenen Roboterattributs, beginnend an der Position from bis zur Position to. So lässt sich ein Teil einer Zeichenkette extrahieren, z. B. der Stationsname aus dem Roboternamen.
to	Beliebiger gültiger Zeichenindex	Liefert einen Teilstring des angegebenen Roboterattributs, beginnend an der Position from bis zur Position to. So lässt sich ein Teil einer Zeichenkette extrahieren, z. B. der Stationsname aus dem Roboternamen.
stationname	[ 1 | 0 ]	Fügt den Stationsnamen zum aktuellen Attributwert hinzu. Weitere Details siehe Tag stations.

---

▲ Das Tag breakline fügt am Ende der aktuellen Zeile einen Zeilenumbruch ein.

---

▲ Das Tag breakpage beendet die aktuelle Seite und setzt den Textcursor in die erste Zeile der nächsten Seite.

---

▲ Das Tag date fügt das aktuelle Datum im angegebenen Format ein.

Eigenschaft	Werte	Beschreibung
style	Stylesheet	Ermöglicht Formatierungsangaben für den Rich Text des Namens der Eigenschaft. Mit einer eingeschränkten Teilmenge der CSS-Syntax lässt sich das Aussehen des Textes ändern. Weitere Details finden Sie unter Ressourcen.
align	[ left | right | center | justify ]	Horizontale Textausrichtung.
format	Datumsformat	Ist es leer, wird der Standardwert dd.MM.yyyy verwendet. Weitere Details finden Sie in der Qt-Online-Dokumentation.

---

▲ Beispiele

Alle aufgeführten Beispiele wurden automatisch mit unserem Plugin erzeugt.

K1U1A2211950R01.pdf

---

▲ Ressourcen

• Eingeschränkte Teilmenge der CSS-Syntax in Qt