126 lines
5.0 KiB
Plaintext
126 lines
5.0 KiB
Plaintext
= Benutzungsanleitung - NV_MASTER Abgleich Makro =
|
||
'''(mapper_macro_2.x.py)'''
|
||
|
||
== 1. Was das Makro macht ==
|
||
Dieses Makro hilft dir dabei, Begriffe in der Auswertungstabelle zu vereinheitlichen.
|
||
Es vergleicht automatisch die Inhalte aus der Spalte „Objektbeschreibung“ mit einer
|
||
Normvokabular-Referenzdatei namens „NV_MASTER.ods“.
|
||
So findest du heraus, welche Begriffe schon genormt sind, wo es passende Vorschläge gibt
|
||
und wo etwas gar nicht erkannt wurde.
|
||
Das Makro markiert in der Auswertungstabelle jede Zeile unter „Objektbeschreibung“
|
||
farbig:
|
||
|
||
* <span style="color:green;">Grün</span>: Alles passt, alle Begriffe gefunden
|
||
* <span style="color:yellow;">Gelb</span>: Einige Begriffe wurden erkannt, andere nicht
|
||
* <span style="color:red;">Rot</span>: Kein einziger Begriff erkannt
|
||
|
||
Beispiel:
|
||
|
||
{| class="wikitable"
|
||
|+ Tabelle 1
|
||
|-
|
||
! Objektbeschreibung !! Norm_Treffer !! Norm_Vorschlag !! Kein_Treffer
|
||
|-
|
||
| (leer) || || ||
|
||
|}
|
||
|
||
Die Spalten „Norm_Treffer“, „Norm_Vorschlag“ und „Kein_Treffer“ legt das Makro
|
||
automatisch an, wenn sie fehlen.
|
||
|
||
! Tipps zur Nutzung !
|
||
* Wenn du die NV_MASTER-Datei änderst, starte das Makro neu – es liest sie bei
|
||
jedem Lauf neu ein.
|
||
* Erstelle ein Backup der Auswertungstabelle, bevor du das Makro ausführst.
|
||
* Schaue ab und zu in die Logdatei, um zu prüfen, ob alles korrekt läuft.
|
||
* Wenn ein Begriff rot markiert wird, aber deiner Meinung nach sinnvoll und zutreffend
|
||
für das beschriebene Objekt ist, schreibe den Begriff auf und sprich mit deinen
|
||
Vorgesetzten ab, ob er in das Normvokabular aufgenommen werden sollte.
|
||
|
||
== 2. Wo die Dateien des Makros liegen müssen ==
|
||
'''Unter Linux:'''
|
||
<pre>
|
||
/home/<dein-benutzername>/.config/libreoffice/4/user/Scripts/python/Vokabular_Abgleich_Makro/
|
||
</pre>
|
||
|
||
'''Unter Windows:'''
|
||
<pre>
|
||
C:\Users\<dein-benutzername>\AppData\Roaming\LibreOffice\4\user\Scripts\python\Vokabular_Abgleich_Makro\
|
||
</pre>
|
||
|
||
In diesem Ordner müssen liegen:
|
||
* mapper_macro_2.x.py (das Makro)
|
||
* NV_MASTER.ods (die Referenzdatei)
|
||
* optional: mapper_macro_2.x.log (wird automatisch erstellt)
|
||
|
||
== 3. Wie du das Makro startest ==
|
||
# Öffne deine Calc-Datei mit den Begriffen
|
||
# Gehe im Menü auf Extras → Makros → Makros ausführen...
|
||
# Wähle: Meine Makros → mapper_macro_2.x.py → run_mapper_macro
|
||
# Klicke auf Ausführen
|
||
|
||
Das Makro startet sofort. Je nach Tabellenumfang dauert der Abgleich ein paar Sekunden bis Minuten.
|
||
Wenn nichts passiert, liegt ein Fehler vor. In diesem Fall schaue in die .log-Datei, die das Makro bei jedem Durchlauf erstellt. Sie liegt im selben Ordner wie das Makro.
|
||
|
||
== 4. Wie du das Ergebnis liest ==
|
||
Nach dem Lauf schreibt das Makro die Treffer und Vorschläge direkt in deine Tabelle und markiert sie:
|
||
|
||
{| class="wikitable"
|
||
|+ Tabelle 2
|
||
|-
|
||
! Objektbeschreibung !! Norm_Treffer !! Norm_Vorschlag !! Kein_Treffer
|
||
|-
|
||
| Harfe, Noten, Bäume, Geldbeutel, Landschaft, Gewässer || Harfe (2.1) | Noten (3.4) | Landschaft (7.2) Gewässer (9.1) || Baum || Geldbeutel
|
||
|}
|
||
|
||
Farben:
|
||
* 🟩 <span style="color:green;">Grün</span>: Alle Begriffe wurden direkt erkannt → Perfekt!
|
||
* 🟨 <span style="color:yellow;">Gelb</span>: Einige Begriffe wurden erkannt, aber andere nur teilweise oder gar nicht → Vorschläge unter der Spalte „Norm_Vorschlag“ prüfen
|
||
* 🟥 <span style="color:red;">Rot</span>: Kein Begriff wurde gefunden → Objektbeschreibung anpassen, ggf. neue Begriffe in das Normvokabular aufnehmen
|
||
|
||
== 5. Wo das Protokoll liegt (Logdatei) ==
|
||
Das Makro schreibt alles, was passiert, in eine Logdatei:
|
||
|
||
'''Linux:''' /home/<dein-benutzername>/.config/libreoffice/4/user/Scripts/python/Vokabular_Abgleich_Makro/mapper_macro_2.x.log
|
||
'''Windows:''' C:\Users\<dein-benutzername>\AppData\Roaming\LibreOffice\4\user\Scripts\python\Vokabular_Abgleich_Makro\mapper_macro_2.x.log
|
||
|
||
Dort siehst du:
|
||
* wann das Makro gestartet wurde
|
||
* wie viele Zeilen verarbeitet wurden
|
||
* und ob Fehler aufgetreten sind
|
||
|
||
{| class="wikitable"
|
||
|+ Tabelle 3
|
||
|-
|
||
! Problem !! Ursache !! Lösung
|
||
|-
|
||
| Das Makro taucht nicht auf || Falscher Speicherort || Prüfe, ob das Skript wirklich im Ordner Scripts/python liegt
|
||
|-
|
||
| Fehlermeldung „Module not found“ || Python-Bibliotheken fehlen || Installiere pandas, odfpy, spacy, rapidfuzz
|
||
|-
|
||
| NV_MASTER wird nicht gelesen || Datei fehlt oder ist kaputt || Prüfe Name und Speicherort
|
||
|-
|
||
| LibreOffice stürzt ab || Sehr große Datei oder fehlerhafte NV_MASTER || Teste mit kleinerer Datei oder neuem NV_MASTER
|
||
|}
|
||
|
||
== 6. Was das Makro benötigt, um einwandfrei zu laufen ==
|
||
Alle folgenden Pakete sind für das Makro notwendig, egal ob LibreOffice oder Excel:
|
||
|
||
{| class="wikitable"
|
||
|+ Tabelle 4
|
||
|-
|
||
! Paket !! Zweck
|
||
|-
|
||
| pandas || Einlesen der Referenzdatei (NV_MASTER.ods)
|
||
|-
|
||
| odfpy || Ermöglicht Lesen von .ods-Dateien (für pandas.read_excel(..., engine="odf"))
|
||
|-
|
||
| spacy || Lemmatisierung (optional, aber empfohlen)
|
||
|-
|
||
| rapidfuzz || Schnelles Fuzzy-Matching (Alternativ zu difflib)
|
||
|-
|
||
| openpyxl || Wird benötigt, falls .xlsx genutzt wird
|
||
|-
|
||
| python-dateutil || Wird automatisch von pandas gebraucht
|
||
|}
|
||
|