Add EdzImporter + collection-panel import action (M2)

Wires EPLAN .edz import into the elements panel. EdzImporter orchestrates EdzArchive -> EdzPart -> EdzElementBuilder and writes the generated .elmt into a destination collection folder (named by order number). A right-click "Importer une piece EPLAN (.edz)..." action on a writable collection directory opens a file picker, runs the importer into that folder's fileSystemPath() and reloads the panel; errors surface via QetMessageBox. Modeled on newElement(). EdzImporter verified headless against the Python oracle for KG6000/MFH200/ R1D200; the panel wiring is built/tested via the WSL Qt5+KF5 build. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-08-01 09:04:13 +02:00 · 2026-06-20 07:34:52 +12:00
parent 7cc5790f7c
commit f4ff6c81f9
5 changed files with 177 additions and 0 deletions
@@ -0,0 +1,83 @@
+/*
+	Copyright 2006 The QElectroTech Team
+	This file is part of QElectroTech.
+
+	QElectroTech is free software: you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by
+	the Free Software Foundation, either version 2 of the License, or
+	(at your option) any later version.
+
+	QElectroTech is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
+*/
+#include "edzimporter.h"
+
+#include "edzarchive.h"
+#include "edzpart.h"
+#include "edzelementbuilder.h"
+
+#include <QDir>
+#include <QDomDocument>
+#include <QFile>
+#include <QRegularExpression>
+
+/**
+	Import the .edz at @a edz_path, writing the generated .elmt into the
+	filesystem folder @a dest_dir. @return true on success; writtenPath() then
+	holds the created file. On failure errorString() explains why.
+*/
+bool EdzImporter::importToDirectory(const QString &edz_path,
+				    const QString &dest_dir)
+{
+	m_written.clear();
+	m_error.clear();
+
+	EdzArchive archive;
+	if (!archive.extract(edz_path)) {
+		m_error = archive.errorString();
+		return false;
+	}
+
+	EdzPart part;
+	if (!part.parse(archive.partXmlPath())) {
+		m_error = part.errorString();
+		return false;
+	}
+
+	const QDomDocument doc = EdzElementBuilder::build(part);
+
+	// Name the file from the order number (fall back to part number / source).
+	QString base = part.orderNumber();
+	if (base.isEmpty()) {
+		base = part.partNumber();
+	}
+	if (base.isEmpty()) {
+		base = QFileInfo(edz_path).completeBaseName();
+	}
+	base.replace(QRegularExpression(QStringLiteral("[^A-Za-z0-9._-]")),
+		     QStringLiteral("_"));
+
+	const QDir dir(dest_dir);
+	if (!dir.exists() && !dir.mkpath(QStringLiteral("."))) {
+		m_error = QStringLiteral("Destination folder does not exist: %1")
+				  .arg(dest_dir);
+		return false;
+	}
+	const QString out_path = dir.filePath(base + QStringLiteral(".elmt"));
+
+	QFile file(out_path);
+	if (!file.open(QIODevice::WriteOnly | QIODevice::Text)) {
+		m_error = QStringLiteral("Cannot write %1").arg(out_path);
+		return false;
+	}
+	file.write(EdzElementBuilder::toElmtString(doc).toUtf8());
+	file.close();
+
+	m_written = out_path;
+	return true;
+}
@@ -0,0 +1,45 @@
+/*
+	Copyright 2006 The QElectroTech Team
+	This file is part of QElectroTech.
+
+	QElectroTech is free software: you can redistribute it and/or modify
+	it under the terms of the GNU General Public License as published by
+	the Free Software Foundation, either version 2 of the License, or
+	(at your option) any later version.
+
+	QElectroTech is distributed in the hope that it will be useful,
+	but WITHOUT ANY WARRANTY; without even the implied warranty of
+	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+	GNU General Public License for more details.
+
+	You should have received a copy of the GNU General Public License
+	along with QElectroTech. If not, see <http://www.gnu.org/licenses/>.
+*/
+#ifndef EDZIMPORTER_H
+#define EDZIMPORTER_H
+
+#include <QString>
+
+/**
+	@brief Orchestrates importing an EPLAN .edz package as a QET element.
+
+	Ties together EdzArchive (extract) -> EdzPart (parse) -> EdzElementBuilder
+	(build) and writes the resulting .elmt into a destination collection folder.
+	UI-decoupled so it stays unit-testable headless; the collection widget calls
+	importToDirectory() and then refreshes the panel.
+*/
+class EdzImporter
+{
+	public:
+		bool importToDirectory(const QString &edz_path,
+				       const QString &dest_dir);
+
+		QString writtenPath() const { return m_written; }
+		QString errorString() const { return m_error; }
+
+	private:
+		QString m_written;
+		QString m_error;
+};
+
+#endif // EDZIMPORTER_H