Version 8.0.0

Hinweis

Für ein Upgrade auf diese Version muss vorher mindestens die Version 7.1.0 installiert sein.

Unterarchive

In einem Archiv kann ein anderes Archiv nun als Unterarchiv verlinkt in einem Vorgang gefiltert mit angezeigt werden.

Dazu muss das Unterarchiv als Datenfeld hinzugefügt und (wie vorher auch schon bei den Untertabellen) als Spaltentyp ausgewählt werden.

In den erweiterten Datenfeld-Einstellungen des Unterarchivs kann dann ein Filter konfiguriert werden, der die im Unterarchiv angezeigten Vorgänge filtert. Der Filter kann dabei genau wie bei den Vorschlagsfiltern auf die Formularwerte des übergeordneten Vorgangs zugreifen.

Im folgenden Beispiel gibt es ein Archiv mit einem Datenfeld, das den Kurznamen name hat. Darüber hinaus wird ein Unterarchiv hinzugefügt, in dem es eine Spalte mit dem Kurznamen fullname gibt. Es sollen in dem Unterarchiv nur diejenigen Vorgänge angezeigt werden, bei denen die Spalte fullname den gleichen Wert wie das Datenfeld name des aktuell geöffneten Vorgangs hat. Dann sieht der Filter folgendermaßen aus:

table.fullname = input.name

Standardmäßig werden 10 Einträge pro Seite angezeigt, in Formularen kann dies durch die Einstellung „Zeilen pro Seite“ angepasst werden.

Für das Unterarchiv gelten die Rollenberechtigungen, die direkt im Unterarchiv eingestellt sind, mit zwei Ausnahmen:

  1. Das Archiv kann auch dann als Unterarchiv eingestellt werden, wenn das Unterarchiv in den Rollen eigentlich auf „Versteckt“ eingestellt ist. Somit ist es möglich, dass ein Archiv ausschließlich als Unterarchiv und gefiltert sichtbar ist, aber ansonsten für Anwender nicht direkt aufrufbar ist.

  2. Wenn das Datenfeld, das das Unterarchiv enthält, in einem Status auf „Nur lesen“ eingestellt ist, wird der Button zum Archivieren von neuen Vorgängen auch dann ausgeblendet, wenn in der Rolle für das Unterarchiv selbst die Option „Vorgänge archivieren“ aktiviert ist.

Verknüpfung von Vorgängen in Datenfeldern

Auf Basis der in Version 7.3 hinzugefügten Key-Value-Felder wurde eine neue Vorschlagsart „Vorgänge“ hinzugefügt, die es erlaubt, in einem Datenfeld eine Verknüpfung zu einem Vorgang in einem festgeleten Archiv herzustellen und im Datenfeld Werte aus dem verknüpften Vorgang anzeigen zu lassen. Dabei zeigt die Verknüpfung immer auf die neueste Version des anderen Vorgangs.

In der Vorschlagsart „Vorgänge“ müssen zwei zusätzliche Einstellungen konfiguriert werden:

  • In der „Vorschlagsquelle“ wird das Archiv ausgewählt, zu dem die Verknüpfung hergestellt wird.

  • In „Darstellung“ muss ein Formatierungs-String im gleichen Format wie im bereits existierenden Postfach-Betreff eingegeben, in dem die Datenfelder aus dem verknpüften Archiv in geschweiften Klammern (Kurzname mit einem vorangestellen Unterstich) als Platzhalter eingefügt werden können.

Beispiel-Darstellung:

{_employee_id} - {_employee_name}

Wie bei bei der Vorschlagsart „Datentabelle“ kann über ein Icon in der ComboBox auch ein Dialog geöffnet werden, in dem man den verknüpften Vorgang über ein Datengitter auswählen kann.

Länderkonfiguration für Mwst-Sätze

In der Administrations-Oberfläche lässt sich nun unter der Konfiguration „Übersicht“ das Land für die Mehrwertsteuer einstellen. Zur Zeit werden Deutschland (de), Schweiz (ch) und Österreich (at) unterstützt. Die Konfiguration lässt sich ebenfalls pro Mandant speichern. Wird bei einem Mandanten kein Mehrwertsteuer-Satz eines Landes ausgewählt, gilt die global konfigurierte Option.

Optimale Spaltenbreite in Untertabellen

Wenn man im Vorgangsdialog in Untertabellen auf den Drop-Down-Pfeil im Spaltentitel klickt, gibt es dort einen neuen Menüpunkt „Optimale Spaltenbreite“.

Ein Klick auf diesen Menüpunkt verändert die Breite von allen Spalten in der Untertabelle so, dass sowohl die Spaltentitel als auch die Werte in allen Zellen vollständig dargestellt werden.

Generischer API-Client

Es ist nun möglich, mittels der pa_client.exe selbstgeschriebene Python-Skripte auszuführen, denen ein HTTP-Client zur Kommunikation mit der API bereitgestellt wird.

Dazu wird das Kommando exec verwendet und eine Skript-Datei angegeben:

pa_client.exe exec myscript.py

Dafür benötigte Informationen werden für das exec-Kommando in einer client.ini oder auf der Kommandozeile konfiguriert. Eine beispielhafte client.ini sieht folgendermaßen aus:

[DEFAULT]
url = https://www.phoenixdocuments.de/test_org/
token = bvWgGa9a5OvFLAtawshxlQ1QfNor4s26

Ein Aufruf via Kommandozeile erfolgt in der Syntax:

pa_client.exe --url <application_url> --token <generated_token> exec myscript.py

Die Optionen token und url müssen dabei vor exec angegeben werden. Das bereitgestellte Skript muss eine main Funktion mit folgenden Parametern haben.

def main(client, args):
client

Ist ein APIClient, der dem Skript zur Verfügung gestellt wird und mit dem man die API-Endpunkte abfragen kann.

args

Sind eine weitere Liste von Kommandozeilen-Argumenten, die nach dem Skript Namen angegeben werden und für das Skript selbst gedacht sind.

Import-Service

OCR-Text aus Datei

Im Import-Service wird die Methode get_file_text() zur Verfügung gestellt. Diese Methode extrahiert Text aus einer Datei, sei es ein Bild oder Textdokument. Wenn der Parameter ocr=True verwendet wird, erfolgt zusätzlich eine optische Zeichenerkennung (OCR). Der Rückgabewert kann ein Text oder None sein.

class ImportService(importservice.Base):
    def process(self, file, result):
        text = self.get_file_text(file, ocr=True)

HTTP-Client

Der HTTP-Client steht nun im Import-Service zur Verfügung und wird wie folgt aufgerufen.

class ImportService(importservice.Base):
    def process(self, file, result):
        archives = self.client.jget("archives")

Attribute von Datums-Objekten in STAR

In STAR wurde der Zugriff auf die Attribute der Datums-Objekte relativedelta und timedelta ermöglicht. Somit lassen sich Operationen, wie z.B. Abfragen auf .days oder .seconds, durchführen.

date_1 = date(2020, 2, 03)
date_2 = date(2021, 10, 05)
time_delta = date_2 - date_1
print(time_delta.days)
print(time_delta.seconds)

Mehr dazu in der STAR-Dokumentation.

Verschiedenes

  • Tabs mit ungültigen Feldern werden beim Speichern jetzt durch eine rote Umrandung und ein Ausrufezeichen gekennzeichnet.

  • Im Formular-Editor kann jetzt die maximale Höhe (Anzahl der Zeilen) für Untertabellen festgelegt werden. Im Formular wird die Höhe auf die eingestellte Anzahl der Zeilen begrenzt. Wenn mehr Zeilen vorhanden sind, erscheint eine Scrollleiste in der Untertabelle.

  • Der Dialog, in dem Benutzer ihre individuellen Einstellungen anpassen können, wurde übersichtlicher gestaltet. Die Passwortänderung erfolgt nun in einem separaten Dialog, der von diesem Dialog aus aufgerufen wird.

  • In der Administrations-Oberfläche wird nun in allen Datengittern eine Statuszeile angezeigt, welche die Anzahl der gefundenen Einträge angibt.

  • Beim Export großer Datentabellen wird jetzt eine Lademaske eingeblendet. Zuvor war nichts sichtbar, bis der Download begann, was bei großen Dateien den Anschein erweckte, als würde der Export nicht verarbeitet.

  • In der Workflow-Aktion „Feldwert setzen“ wurde die Fehlermeldung verbessert, falls einem Datenfeld ein inkompatibler Wertentyp zugewiesen wird.

  • In den Dateieigenschaften der pa_client.exe wird unter dem Detail-Tab nun die Datei-Versionsnummer dargestellt.