====== Modify Office Files ====== 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 == * [[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:basics:basics:butler:edit.png?nolink&|}} Apache **Log4j** 2 aktivieren. ==== Fehler Unsupported major.minor version 52.0 ==== Sie haben eine sehr alte Version von Java am Server (Vor Java 8). * Entweder Sie aktualisieren Java - Siehe: [[de:basics:basics:butler:de:installation:java_installation|]] * Oder Sie Wählen Sie alte Version aus: * Fügen Sie den Butler zur Startseite hinzu * {{:de:basics:basics:butler:1.png?350|}} * und öffnen Sie die Konfiguration des Butlers {{:de:basics:basics:butler:edit.png?nolink&|}}. * Wählen Sie Version 1 aus. ===== Modify Office Files Server ===== :righty: Bitte über die Butler Konfiguration {{:de:basics:basics: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 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:basics:basics:butler:1.png?350|}} * und öffnen Sie die Konfiguration des Butlers {{:de:basics:basics:butler:edit.png?nolink&|}}. * Stellen Sie sicher, dass der Haken bei "Server aktiv" aktiviert ist und speichern Sie. * {{:de:basics:basics: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:basics:basics: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:basics:basics: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:basics:basics: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:basics:basics:butler:aufgabenplanung2.png?600 |}} * In der Registerkarte "Aktionen" erstellen Sie eine neue Aktion um die zuvor erstellte Batch Datei zu starten. {{ :de:basics:basics: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:basics:basics:butler:modify1.png?340|}} * Fügen Sie die "Befehlszeile" hinzu * {{:de:basics:basics:butler:modify2.png?140|}} * Suchen Sie den Prozess "modify_office_files.jar" und beenden Sie den Prozess * {{:de:basics:basics:butler:modify3.png?900|}} Danach starten Sie den Server über die Aufgabenplanung. === Mac OS X === ^ **:!: 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 Mac OS X 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'' * Ö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 * Starten Sie den Server neu oder führen Sie das Kommando aus: sudo /ustrich/start_com_untermstrich_modify_office_files.sh