typische Anwendungsfälle

einfache Admin-Aufgaben

Selten auftretende Admin-Aufgaben lassen sich gut mittels Python-Scripten automatisieren. Es ist sehr einfach möglich, auf die DB, aber auch auf SOAP-Schnittstelle der APP-Serverse zuzugreifen. Zudem ist rudimentärer Zugriff auf ASMX-Seiten implementiert. Ich habe dies vor allem für Wartungsarbeiten an Anpassungstabellen genutzt, die für eigene Erweiterungen entwickelt wurden.

Als triviales Beispiel sucht folgender Code alle DOCUMENTS Einträge in Artikeln (angezeigt als Bild in ArtikelRec.aspx), für die Datei, auf die verwiesen wird, nicht im Dateisystem existiert. Diese fehlenden Dateien werden ausgegeben und das Feld DOCUMENTS gelöscht. Das Löschen erfolgt dabei über useXML, so dass die Felder UPDDATE und UPDUSER korrekt gesetzt werden.

import pathlib
import PyAPplus64
import applus_configs
from typing import Optional


def main(confFile: pathlib.Path, updateDB: bool, docDir: Optional[str] = None) -> None:
    server = PyAPplus64.applus.applusFromConfigFile(confFile)

    if docDir is None:
        docDir = str(server.scripttool.getInstallPathWebServer().joinpath("DocLib"))

    sql = PyAPplus64.sql_utils.SqlStatementSelect("ARTIKEL")
    sql.addFields("ID", "ARTIKEL", "DOCUMENTS")
    sql.where.addConditionFieldStringNotEmpty("DOCUMENTS")

    for row in server.dbQueryAll(sql):
        doc = pathlib.Path(docDir + row.DOCUMENTS)
        if not doc.exists():
            print("Bild '{}' für Artikel '{}' nicht gefunden".format(doc, row.ARTIKEL))

            if updateDB:
                upd = server.mkUseXMLRowUpdate("ARTIKEL", row.ID)
                upd.addField("DOCUMENTS", None)
                upd.update()


if __name__ == "__main__":
    main(applus_configs.serverConfYamlTest, False)

Man kann alle Python Bibliotheken nutzen. Als Erweiterung wäre es in obigem Script zum Beispiel einfach möglich, alle BMP-Bilder zu suchen, nach PNG zu konvertieren und den DB-Eintrag anzupassen.

Ad-hoc Reports

APplus erlaubt es mittels Jasper-Reports, flexible und schöne Reports zu erzeugen. Dies funktioniert gut und ist für regelmäßig benutzte Reports sehr sinnvoll.

Für ad-hoc Reports, die nur sehr selten oder sogar nur einmal benutzt werden, ist die Erstellung eines Jasper-Reports und die Einbindung in APplus jedoch zu zeitaufwändig. Teilweise genügen die Ergebnisse einer SQL-Abfrage, die direkt im MS SQL Server abgesetzt werden kann. Wird es etwas komplizierter oder sollen die Ergebnisse noch etwas verarbeitet werden, bietet sich evtl. Python an.

Folgendes Script erzeugt zum Beispiel eine Excel-Tabelle, mit einer Übersicht, welche Materialen wie oft für Artikel benutzt werden:

import PyAPplus64
import applus_configs
import pathlib


def main(confFile: pathlib.Path, outfile: str) -> None:
    server = PyAPplus64.applus.applusFromConfigFile(confFile)

    # Einfache SQL-Anfrage
    sql1 = ("select Material, count(*) as Anzahl from ARTIKEL "
            "group by MATERIAL having MATERIAL is not null "
            "order by Anzahl desc")
    df1 = PyAPplus64.pandas.pandasReadSql(server, sql1)

    # Sql Select-Statements können auch über SqlStatementSelect zusammengebaut
    # werden. Die ist bei vielen, komplizierten Bedingungen teilweise hilfreich.
    sql2 = PyAPplus64.SqlStatementSelect("ARTIKEL")
    sql2.addFields("Material", "count(*) as Anzahl")
    sql2.addGroupBy("MATERIAL")
    sql2.having.addConditionFieldIsNotNull("MATERIAL")
    sql2.order = "Anzahl desc"
    df2 = PyAPplus64.pandas.pandasReadSql(server, sql2)

    # Ausgabe als Excel mit 2 Blättern
    PyAPplus64.pandas.exportToExcel(outfile, [(df1, "Materialien"), (df2, "Materialien 2")], addTable=True)


if __name__ == "__main__":
    main(applus_configs.serverConfYamlTest, "myout.xlsx")

Dieses kurze Script nutzt Standard-Pandas Methoden zur Erzeugung der Excel-Datei. Allerdings sind diese Methoden in den Aufrufen von pandasReadSql und exportToExcel gekapselt, so dass der Aufruf sehr einfach ist. Zudem ist es sehr einfach, die Verbindung zur Datenbank und zum APP-Server mittels der YAML-Konfigdatei herzustellen. Bei diesem Aufruf kann optional ein Nutzer und eine Umgebung übergeben werden, die die Standard-Werte aus der YAML-Datei überschreiben. pandasReadSql nutzt intern completeSQL, so dass der für die Umgebung korrekte Mandant automatisch verwendet wird.

Anbindung eigener Tools

Ursprünglich wurde PyAPplus64 für die Anbindung einer APplus-Anpassung geschrieben. Diese Anpassung ist als Windows-Service auf einem eigenen Rechner installiert und überwacht dort ein bestimmtes Verzeichnis. Bei Änderungen an Dateien in diesem Verzeichnis (Hinzufügen, Ändern, Löschen) werden die Dateien verarbeitet und die Ergebnisse an APplus gemeldet. Dafür werden DB-Operationen aber auch SOAP-Calls benutzt. Ebenso wird auf die SysConf zugegriffen.

Viele solcher Anpassungen lassen sich gut und sinnvoll im App-Server einrichten und als Job regelmäßig aufrufen. Im konkreten Fall wird jedoch für die Verarbeitung der Dateien viel Rechenzeit benötigt. Dies würde dadurch verschlimmert, dass die Dateien nicht auf der gleichen Maschine wie der App-Server liegen und somit viele, relativ langsame Dateizugriffe über das Netzwerk nötig wären. Hinzu kommt, dass die Verarbeitung der Dateien dank existierender Bibliotheken in Python einfacher ist.

PyAPplus64 kann für solche Anpassungen eine interessante Alternative zur Implementierung im App-Server oder zur Entwicklung eines Tools ohne spezielle Bibliotheken sein. Nach Initialisierung des Servers:

import PyAPplus64

server = PyAPplus64.applus.applusFromConfigFile("my-applus-server.yaml")

bietet P2APplus64 wie oben demonstriert einfachen lesenden und schreibenden Zugriff auf die DB. Hierbei werden automatisch die für die Umgebung nötigen Mandanten zu den SQL Statements hinzugefügt. Zudem ist einfach ein Zugriff auf die Sysconf möglich:

print (server.sysconf.getString("STAMM", "MYLAND"))
print (server.sysconf.getList("STAMM", "EULAENDER"))

Dank der Bibliothek zeep ist es auch sehr einfach möglich, auf beliebige SOAP-Methoden zuzugreifen. Beispielsweise kann auf die Sys-Config auch händisch, d.h. durch direkten Aufruf einer SOAP-Methode des APP-Servers zugegriffen werden:

client = server.getAppClient("p2system", "SysConf");
print (client.service.getString("STAMM", "MYLAND"))