====== Dokumente - Modify Office Files ======
Modify Office Files (MOF) erlaubt das Bearbeiten und Verarbeiten von zumeist XLSX Dateien.
* XSLX/XSLM - Variablen füllen, auslesen, Office füllen
* DOCX/DOCM - Sicherheitsstufe öffnen ohne MS Office (Nur lesender Zugriff)
* :righty: **Bitte nutzen Sie den Server (wie unten beschrieben), wenn Sie Pfade unter Windows nutzen, die ein ''!'' beinhalten.**
== Nutzt die folgenden Bibliotheken ==
* [[http://commons.apache.org/|Apache Commons]] - [[http://www.apache.org/licenses/|License]]
* [[https://poi.apache.org/|Apache POI]] - [[https://poi.apache.org/legal.html|License]]
* [[http://logging.apache.org/log4j/2.x/|Apache Log4j 2]] - [[http://logging.apache.org/log4j/2.x/license.html|License]]
* [[https://github.com/ralfstx/minimal-json|minimal-json]] - [[https://github.com/ralfstx/minimal-json/blob/master/LICENSE|License]]
==== Logging ====
Sie können über die Butler Konfiguration {{:de:butler:edit.png?nolink&|}} Apache **Log4j** 2 aktivieren.
Betrifft [[https://www.cve.org/CVERecord?id=CVE-2021-44228|CVE-2021-44228]]
Log4J ist im Standard **nicht** aktiv und selbst wenn Sie Modify Office Files als Server betreiben, ist dieser **nur über localhost** verfügbar.
Wir haben dennoch zur Sicherheit ein Update von Modify Office Files herausgebracht, welches Log4J 2.15 nutzt. Das Update erhalten Sie über [[de:setup:setup:sideboard:setup:options:update_widgets|Konfiguration – Butler Aktualisierung / Installation]].
Wenn Sie den Modify Office Files Server nutzen und Log4J aktiviert hatten (Siehe Konfiguration des Butlers oben), starten Sie den Server nach dem Update bitte neu.
==== Fehler Unsupported major.minor version 52.0 ====
Sie haben eine sehr alte Version von Java am Server (Vor Java 8).
* Aktualisieren Java - Siehe: [[de:installation:java_installation|Java am Server]].
===== Modify Office Files Server =====
:righty: Bitte über die Butler Konfiguration {{:de:butler:edit.png?nolink&|}} deaktivieren, wenn es zu einem Problem mit dem Server kommen sollte.
Diese Variante beschleunigt oben genannte Funktionen, erfordert aber etwas Konfiguration durch Ihre Systembetreuer:in.
:righty: Die Beschleunigung ist ab dem **zweiten** Zugriff merkbar.
Wenn Sie **Java 11 oder neuer** nutzen, ist dieser Server nicht mehr empfohlen.
Java 11 ist typischerweise auch ohne diese Servervariante schnell genug.
Wenn Sie die Modify Office Files Version anpassen, müssen Sie auch die .bat/.plist/.sh Datei anpassen!
* **Fügen Sie den Butler zur Startseite hinzu**
* {{:de:butler:mof.png?350|}}
* und öffnen Sie die Konfiguration des Butlers {{:de:butler:edit.png?nolink&|}}.
* Stellen Sie sicher, dass der Haken bei "Server aktiv" aktiviert ist und speichern Sie.
* {{:de:butler:3.png?400|}}
* Kopieren Sie **den gesamten angezeigten Inhalt** (Windows: ohne ''&&'') und fügen Sie den Text in die .bat/.plist/.sh Datei ein ((Siehe unten)).
* {{:de:butler:5.png?400|}}
* Starten Sie den Server wie beschrieben.
* Java muss dazu in [[https://www.java.com/de/download/help/path.xml|PATH vorhanden]] sein.
* :righty: Stellen Sie sicher, dass der Server automatisch beim Hochfahren des Servers gestartet und beim Herunterfahren beendet wird. Nutzen Sie dazu die Bordmittel Ihres Betriebssystems.
* :righty: Starten Sie den Server nach jedem Update von Modify Office Files neu.
* :!r: Wenn der **Server nicht aktiv**, der **Haken "Server aktiv"** aber **aktiv**iert ist, können keine XSLX/XSLM genutzt werden. **Deaktivieren** Sie dann den Haken und/oder melden Sie das Problem **Ihrer Systembetreuer:in**.
* Klicken Sie auf aktualisieren {{:de:butler:refresh.png?nolink&|}} um den Server Status zu prüfen.
=== Windows ===
^ **:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR. ** ^
| Die Firma untermStrich Software GmbH übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen! |
Ein Beispiel, wie das Starten unter Windows aussehen kann:
* Erstellen Sie eine neue Batch Datei: C:\start_ustrich_java_server.bat
* Fügen Sie den Befehl zum Start des Server der im Butler angezeigt wird ein. Das ''cd ..'' ist dabei notwendig!
* Öffnen Sie die Windows Aufgabenplanung und erstellen Sie eine neue Aufgabe "start_ustrich_java_server".
* Wählen Sie bei den Sicherheitsoptionen den Benutzer mit dem der Apache Dienst gestartet ist [[de:installation:windows_server_network|HTTP Server, PHP, ionCube Bundle für Netzwerkzugriff konfigurieren]].
* Aktivieren Sie weiters: "Unabhängig von der Benutzeranmeldung ausführen"
* Läuft der Apache allerdings mit dem Systembenutzer wählen Sie den Benutzer "SYSTEM"
{{ :de:butler:aufgabenplanung1.png?600 |}}
* In der Registerkarte "Trigger" erstellen Sie einen neuen Trigger der beim Start von Windows ausgelöst wird.
* Stellen Sie die Verzögerung auf 1 Minute.
{{ :de:butler:aufgabenplanung2.png?600 |}}
* In der Registerkarte "Aktionen" erstellen Sie eine neue Aktion um die zuvor erstellte Batch Datei zu starten.
{{ :de:butler:aufgabenplanung3.png?600 |}}
* Speichern Sie die Aufgabe durch einen Klick auf OK
== Neustart ==
Beenden Sie zuerst den Java Prozess.
* Öffnen Sie den Task Manager und fügen Sie unter Details eine Spalte ein
* {{:de:butler:modify1.png?340|}}
* Fügen Sie die "Befehlszeile" hinzu
* {{:de:butler:modify2.png?140|}}
* Suchen Sie den Prozess "modify_office_files.jar" und beenden Sie den Prozess
* {{:de:butler:modify3.png?900|}}
Danach starten Sie den Server über die Aufgabenplanung.
=== macOS ===
^ **:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR. ** ^
| Die Firma untermStrich Software GmbH übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen! |
Ein Beispiel, wie das Starten auf aktuelleren macOS Versionen aussehen kann:
Label
ustrich.modify_office_files
StandardOutPath
/var/log/ustrich/modify_office_files.log
StandardErrorPath
/var/log/ustrich/modify_office_files_error.log
UserName
root
GroupName
wheel
RunAtLoad
ProgramArguments
/usr/bin/java
-jar
/Library/WebServer/Documents/ustrich/writeable/applications/com_untermstrich_modify_office_files/portlets/modify_office_files.jar
server
/Library/WebServer/Documents/ustrich/writeable/applications/com_untermstrich_modify_office_files/writeable/conf.json
* :righty: Die Datei oben anpassen (Pfade 2x)
* Die Datei als ''ustrich.modify_office_files.plist'' nach ''/Library/LaunchDaemons/'' kopieren und darauf achten, dass die Datei dem ''chown root:wheel /Library/LaunchDaemons/ustrich.modify_office_files.plist'' gehört
* Ob das alles erfolgreich war, können Sie durch ''sudo launchctl load /Library/LaunchDaemons/ustrich.modify_office_files.plist'' testen
* Kontrollieren Sie die Ausgabe in ''/var/log/ustrich/modify_office_files.log''
== Neustart ==
* Server stoppen: ''sudo launchctl unload /Library/LaunchDaemons/ustrich.modify_office_files.plist''
* Server starten: ''sudo launchctl load /Library/LaunchDaemons/ustrich.modify_office_files.plist''
=== Ubuntu Linux ===
^ **:!: ACHTUNG: ANLEITUNG OHNE GEWÄHR. ** ^
| Die Firma untermStrich Software GmbH übernimmt keine Haftung für etwaige Schäden oder Fehler die direkt oder indirekt durch die Benutzung oder nicht Benutzung dieser Anleitung entstehen! |
Ein Beispiel, wie das Starten auf Ubuntu Linux aussehen kann:
* sudo mkdir /ustrich
* Erstellen Sie ''/ustrich/start_com_untermstrich_modify_office_files.sh''
#!/bin/bash
cd /ustrich
nohup
* Nach dem ''nohup'' fügen Sie den **Startbefehl** aus dem Butler ab ''java ...'', gefolgt von '' &'' ein. Beispiel:
#!/bin/bash
cd /ustrich
nohup java ... &
* ''sudo chmod u+x /ustrich/start_com_untermstrich_modify_office_files.sh''
* Ubuntu bis 16.04
* Öffnen Sie die ''/etc/rc.local'' und fügen Sie __**vor**__ der ''exit 0'' Zeile den Aufruf ein:
/ustrich/start_com_untermstrich_modify_office_files.sh
* Ubuntu ab 18.04
* Erstellen Sie die ''/etc/rc.local'':#!/bin/sh -e
/ustrich/start_com_untermstrich_modify_office_files.sh
exit 0
* Machen Sie die Datei ausführbar: sudo chmod +x /etc/rc.local
* Starten Sie den Server neu oder führen Sie das Kommando aus:
sudo /ustrich/start_com_untermstrich_modify_office_files.sh