Kleine Helfer in der Technischen Dokumentation: TANNER-doCom-Tool

Detailbild Arbeiterfiguren

Das zweite Tool in meiner Reihe zu „Kleine Helfer in der Technischen Dokumentation“ ist das TANNER-doCom-Tool. Dieses Tool ist ein Dokumenten-Konfigurator, der Word-Dokumente – gesteuert von einer Excel-Liste – zu einem Dokument zusammenfügt. Damit kann unser kleiner Helfer deutlich mehr als die eingebaute Textbausteinfunktion von Word, ist aber kein Redaktionssystem á la Docuglobe. Unser Kunde und ich sind davon überzeugt: Genau das richtige Tool, wenn man nur wenige Male im Monat Word-Dokumente zusammenfügen muss.

Dokumenterstellung aus vielen Modulen schwierig

Möchte man von Fall zu Fall unterschiedliche Dokumente erstellen, die aus standardisierten, immer wiederkehrenden Inhalten zusammengestellt sein sollen, so kann es sinnvoll sein, die Inhalte zu modularisieren. Probleme können beim Versuch entstehen, aus einer großen Anzahl von Modulen schnell ein Dokument zusammenzustellen.

Da meist die Reihenfolge der Inhalte vorgegeben ist, gewisse Inhalte immer wieder vorkommen und gewisse Inhalte einfach nur durch andere ausgetauscht, eingesetzt oder nicht verwendet werden sollen, kann man von einer Makrostruktur – einem Master – ausgehen. So wird in einer Excel-Tabelle quasi das vollständige Inhaltsverzeichnis aufgelistet, also alle erstellten Module in ihrer richtigen Reihenfolge hintereinander gelistet. Im Falle von Optionen, also Inhalten, die vorkommen können oder nicht (Varianten bzw. Inhalte, die „entweder – oder“ vorkommen), werden auch diese Module in die Liste aufgenommen.

Modularisierung: So viel wie nötig, so wenig wie möglich

Die Module selbst werden streng nach Redaktionsregeln erstellt, am besten basierend auf einer Word-Vorlage. Wie immer gilt auch hier die Regel, so viel wie nötig und so wenig wie möglich zu modularisieren, um den Überblick behalten zu können. Es bietet sich an, als kleinste Einheit nur Topics zu modularisieren, also Abschnitte mit einer Überschrift beginnend.

Ein Problem beim Modularisieren in Word stellen Querverweise dar. Wir haben deshalb bei der Programmierung des Tools auf die Buchfunktion von Word zugegriffen. Damit nutzen wir die Funktionalität von Word so umfassend wie möglich und sind zuversichtlich, dass der Anpassungsaufwand bei zukünftigen Updates gering bleibt.

Möchte man nun ein Dokument konfigurieren, steigt man in die Excel-Liste ein und zeichnet in einer separaten Spalte alle Module aus, die man verwenden möchte. Das TANNER-doCom-Tool wird nun aufgerufen. In einer Eingabemaske in Excel werden noch folgende Informationen abgefragt:

•    Quelle (Inputfolder)
•    Speicherort
•    Sprache

Das Tool liest nun die Excel-Liste, setzt die Word-Module nacheinander und kontrolliert, ob die Querverweise stimmen und auch zu einem existierenden Ort führen. Fehlermeldungen, zum Beispiel nicht-gefundene Grafik-Dateien, schreibt das Tool in ein Log-File.

Das Tool generiert nun ein Word-Dokument mit den ausgewählten Modulen. Abschließend muss dieses nur noch geöffnet und Felder, wie Inhaltsverzeichnis sowie Kopf- und Fußzeile, aktualisiert werden. Das Word-Dokument kann man anschließend noch weiter verarbeiten.

Modularisierungsstrategie vorab festlegen

Um das Tool nutzen zu können ist es hilfreich, bereits sauber in Worddokumenten zu schreiben – am besten basierend auf einer Word-DOT-Vorlage. Im Vorfeld bietet es sich an, eine Modularisierungsstrategie zu definieren, dauerhaft sollten die Module in einer Excelliste aufgelistet und gepflegt werden.

Nützlich ist das Tool vor allem bei kleinen Modularisierungsaufgaben, die eine Investition in ein CMS nicht rechtfertigen oder – wenn man modularisieren möchte – sich aber nicht für ein CMS entscheiden kann. Ein Redaktionssystem lohnt sich dann, sobald mehrere Redakteure, mehrere Sprachen, viele Varianten und Optionen zu händeln sind.

TANNER-doCom-Tool im Überblick:

  • Word-Module mit gleichen Formatvorlagen und Layoutstrukturen
  • Ideal basierend auf einer WORD-DOT
  • Für Querverweise zu anderen Modulen ist die Word-Buch-Funktion nötig
  • Sauberes Arbeiten ist in einer solchen Umgebung unabdingbar
  • Nur Word und Excel als Lizenzen nötig

 Weitere Beiträge zu „Kleinen Helfern in der Technischen Dokumentation“:

Tomislav "Tomek" Matievic bringt seit 2008 als kroatischer Österreicher noch mehr europäischen Schwung in die TANNER AG. Neben Kundenbetreuung, Projektmanagement und Teamleitung als Unit Manager Technische Dokumentation ist er Geschäftsführer von TANNER Schweiz. Seinen Wohnort hat er im Kanton Tessin in der Schweiz.
6 Responses
  1. Birgit Brunner

    Guten Tag!
    Ist das beschriebene doCom-Tool nur bei TANNER im Einsatz oder gibt es das Tool irgendwo zum download?

    Freundliche Grüße,
    Birgit

    1. Tomislav Matiević

      Guten Morgen,

      vielen Dank für Ihre Rückfrage. Das Tool wurde für einen TANNER-Kunden erstellt und spezifisch auf dessen Bedürfnisse zugeschnitten. Daher steht es in dieser Form leider nicht zum Download zur Verfügung. Wenn Sie daran Interesse haben, dann kontaktieren Sie mich gern einfach direkt: tomislav.matievic@tanner.de

      Beste Grüße,
      Tomislav Matiević

  2. Mathias Dreßler

    Hallo Tomislav!

    Was genau ist mit der „Buchfunktion“ von Word gemeint?
    Ich kenne nur die Buchfunktion von InDesign, etwas Vergleichbares in MS Word wäre mir neu.

    Viele Grüße
    Mathias

    1. Tomislav Matiević

      Hallo Mathias,

      wenn ich von Buchfunktion spreche, meine ich die Word-Funktion Masterdokument bzw. Zentral- und Filialdokumente. Die Funktion ist vergleichbar mit der Buchfunktion von InDesign oder FrameMaker oder auch der Ditamap bei XML. Hierbei können mehrere Filialdokumente in einem Zentraldokument zusammengefasst werden und als Gesamtwerk bearbeitet und publiziert werden.

      Gerne kannst Du Dich bei mir melden, wenn Du Interesse am Tool hast.

      Mit freundlichen Grüssen
      Tomislav Matiević

    1. Tomislav Matiević

      Hallo Jan,

      vielen Dank für Ihre Rückfrage. Das Tool wurde für einen TANNER-Kunden erstellt und spezifisch auf dessen Bedürfnisse zugeschnitten. Daher steht es in dieser Form leider nicht zum Ausprobieren zur Verfügung. Wenn Sie daran Interesse haben, dann kontaktieren Sie mich gern einfach direkt: tomislav.matievic@tanner.de

      Schöne Grüße
      Tomek Matiević

Hinterlasse einen Kommentar