Über die Funktion Extern auswerten können Sie EPLAN Harness proD-Auswertungen mithilfe eines (selbst erstellten) Auswertungsverarbeitungsprogramms exportieren. Dabei werden die in einer Auswertung enthaltenen Daten in eine temporäre XML-Datendatei exportiert. Dann wird automatisch das Auswertungsverarbeitungsprogramm gestartet, das aus diesen Daten die gewünschte Ausgabe erstellt. Im Abschnitt Informationen für Entwickler finden Sie weitere Informationen zum Erstellen eines solchen Programms.

Das Installationsverzeichnis von EPLAN Harness proD enthält eine Demo namens HReportExternally.exe: Dieses Programm nutzt eine .xlsx-Dateivorlage für die Ausgabe von Auswertungen in Microsoft Excel-Tabellen. Eine Vorlage für jede Art von Auswertung ist im Installationsverzeichnis enthalten. Schlüsselwörter für jede Art von Auswertung finden Sie hier:

• Schlüsselwörter für Zubehörauswertungen
• Schlüsselwörter für Baugruppen- / Geräteauswertungen
• Schlüsselwörter für zusammengefasste Stücklisten
• Schlüsselwörter für zeilenweise Stücklisten
• Schlüsselwörter für Kabelauswertungen
• Schlüsselwörter für Kabeleinheitenauswertungen
• Schlüsselwörter für verknüpfbare Objekte-Auswertungen
• Schlüsselwörter für Sonderkomponentenauswertungen
• Schlüsselwörter für Oberflächenschutzauswertungen
• Schlüsselwörter für Kabelbaumauswertungen
• Schlüsselwörter für Drahttabellenauswertungen

Alle Arten von Auswertungen können auch benutzerdefinierte Eigenschaften enthalten. Der Name der benutzerdefinierten Eigenschaft muss das Präfix userdef_ und statt Leerzeichen die Zeichenfolge _x0020_ aufweisen.

Erforderliches Setup für "Extern auswerten"

Bevor Sie "Extern auswerten" nutzen können, müssen zwei Voraussetzungen erfüllt sein:

• Ein geeignetes .exe-Programm für die Auswertungsverarbeitung muss auf dem Computer oder im lokalen Netzwerk verfügbar sein
• Der Dateipfad und die Parameterargumente müssen den Studio-Einstellungen hinzugefügt worden sein

Beim Beispiel des Demo-Programms HReportExternally.exe sähe es so aus:

1. Rufen Sie in Studio Extras > Einstellungen > Auswertungen > Extern auswerten auf.
   
   Sie sehen eine Liste von Auswertungstypen, jeweils mit zwei Feldern. Eines für einen Dateipfad zu einem Auswertungsverarbeitungsprogramm und eines für Parameterargumente.
   
2. Geben Sie beim zutreffenden Auswertungstyp den Pfad zum externen Programm ein
   
   Wählen Sie die zusammengefasste Stücklistenauswertung als Beispiel aus, und verwenden Sie dann das Demo-Programm <Harness proD-Installationsverzeichnis>\HReportExternally.exe.
   
3. Klicken Sie auf das benachbarte Feld, und geben Sie, falls erforderlich, weitere Argumente für das Programm ein.
   
   Beim Demo-Programm wäre das der Pfad zur geeigneten Auswertungsvorlage. Der Vorlagenpfad muss im folgenden Format eingegeben werden: -template "<Harness proD-Installationsverzeichnis>\Demo\Demo_ReportExternally\<template name>.xlsx". Für die zusammengefassten Stücklistenauswertungen können Sie die Vorlage bom_aggregated_template.xlsx verwenden.
4. Klicken Sie auf [OK].
   

Auswertung mit "Extern auswerten" exportieren

Nachdem Sie die Studio-Einstellungen für "Extern auswerten" eingerichtet haben, können Sie mit dieser Funktion Auswertungen exportieren:

1. Öffnen Sie die Auswertung, die Sie mit diesem Programm exportieren möchten.
2. Wählen Sie die Menüpunkte Datei > Extern auswerten.
   
   Wählen Sie ein Verzeichnis aus, in dem die endgültige Auswertung gespeichert werden soll, definieren Sie ihren Namen, und weisen Sie eine passende Dateierweiterung zu. Beim Demoprogramm muss die Erweiterung *.xlsx lauten.
3. Klicken Sie auf [Speichern].

Informationen für Entwickler

Der nicht kompilierte Quellcode für HReportExternally.exe ist in <Harness proD-Installationsverzeichnis>\Demo\Demo_ReportExternally\Demo_ReportExternally.zip gespeichert.

Wenn die Auswertung über die Funktion Extern auswerten gespeichert wird, führt Harness proD die folgenden Schritte durch:

• Harness proD erstellt die *.xml-Datei mit den Auswertungsdaten.
• Harness proD ruft das Programm mit folgenden Argumenten auf:
  
  
  • -source "<Dateipfad zur XML-Datendatei>"
  • -output "<Dateipfad zur Ausgabedatei, die vom Benutzer definiert wurde>"
  • Zusätzliche benutzerdefinierte Argumente wie -template "<Dateipfad zur Vorlage>" für das Demo-Programm HReportExternally.exe.

Das Programm verwendet diese Informationen zum Erstellen der endgültigen Auswertung.

Spezifische Vorlagenvariablen von HReportExternally.exe

In den Vorlagen des Demo-Programms HReportExternally.exe werden verschiedene Variablen verwendet:

Schlüsselwort	Beschreibung
PROJECT_NAME	Name des Projekts
DATE	Datum des Auswertungsexports
TIME	Uhrzeit des Auswertungsexports
START	Erforderliche Angabe, wo sich die erste Spalte der Tabelle befindet, die mit Daten gefüllt werden soll
END	Erforderliche Angabe, wo sich die letzte Spalte der Tabelle befindet, die mit Daten gefüllt werden soll