2024-07-19

2024-07-19

Allgemeine Informationen

Hinweise zur enaio 11.10 Beta-Phase (Sven, 5 min.)

>> enaio® 11.10 Beta-Programm <<


enaio® Integration

ModalDialog-AddOn | ModalDialog API | Kommunikationsbibliothek (20 min.)

(11.10 FINAL)

Standardsoftware - Integrationsmöglichkeiten (Inga/Andreas)

Das ModalDialog-AddOn ermöglicht es Ihnen, im Projekt

  • ein eigenes AddOn zu realisieren, das ausgewählte Daten (auch Tabellencontrols) der Datenmaske grafisch zur Anzeige bringt,

  • ggf. die angezeigten Daten um weitere Quellen anreichert und

  • anschließend die angereicherten und bei Bedarf neu organisierten Daten auf die Maske zurück speichert.

Das ModalDialog-AddOn stellt im enaio® client einen modalen Dialog  mit einem Webcontrol und im enaio® webclient mit einem iFrame zur Verfügung und wird im Projekt via HTML, CSS und JavaScript implementiert. Damit für beide Clients nur eine Implementierung erzeugt werden muss, steht eine gemeinsame API die ModalDialog API zur Verfügung, die die jeweiligen APIs von Rich- und Webclient kapselt. Der HTML- und Javascript-Code des ModalDialog-AddOns wird im Projekt üblicherweise auf enaio® service-manager gehostet werden und ist somit von allen Clients erreichbar. 

Das ModalDialog-AddOn steht Ihnen für DMS-Masken und für WF-Masken gleichermaßen zur Verfügung. Alternativ zur Verwendung als AddOn mit einer Konfiguration über die Objektdefinition kann es auch direkt über API-Funktionen (client COM API: Application.openModalBrowserDialog, enaio® webclient: FormHelper.OpenModalDialog) aus einem clientseitigen Buttonevent aufgerufen werden. Somit kann der Aufrufpunkt des AddOns nach Belieben auf der Maske positioniert werden. Eine Beispielimplementierung, die per Skript auf einer Datenmaske eingebettet werden kann, ist verfügbar ("Demo für einen modalen Dialog"). Mit dieser Demo können Sie  sich mit der Funktionalität und der Programmierung eines eigenen Scriptings vertraut machen. OPTIMAL SYSTEMS liefert als Projektlösung ein standardisiertes Kontierungstool aus, das auf Basis eines per Skript angebundenen ModalDialog-AddOn realisiert wurde.

Hinweis: mit der Version 11.10 FINAL ist das ModalDialog-AddOn im enaio® webclient nur über Scripting anbindbar. Die Unterstützung über eine AddOn-Konfiguration in der Objektdefinition wird in einem der nächsten Service Release zur Verfügung gestellt.

Wir geben Ihnen in dieser Produktpräsentation einen kurzen Überblick über die Verwendung des ModalDialog-AddOns per AddOn-Konfiguration sowie auch als Skriptlösung und geben Ihnen anhand der Vorführung der obigen Beispielimplementierung, die Sie als Referenz der ModalDialog API heranziehen können, einen Überblick über den Aufbau der API.

Im Weiteren wird ein konkreter Anwendungsfall des AddOns präsentiert: Das "enaio® kontierungstool".

Anwendungsfall - enaio® kontierungstool (Jacky/Christoph)

In vielen ECM-Szenarien soll die Bearbeitung strukturierter Datensätze ermöglicht werden, die in der Regel in Tabellen vorgehalten werden. Teilweise werden zur Manipulation der Datensätze Funktionen benötigt, die sich mit den vorhandenen Möglichkeiten der enaio®-Tabellen (DMS wie auch Workflow) nicht abbilden lassen. Anforderungen an die Bearbeitung von Tabellen sind beispielsweise:

  • Aufsplitten einer Zeile mit automatischer Anpassung von Summenwerten einer Spalte

  • Dynamische Katalogelemente, um abhängig vom Tabelleninhalt passende Kataloge anzubieten

Mit dem enaio® kontierungstool ist eine Möglichkeit geschaffen worden, diese weiterführenden Anforderungen umzusetzen. Dem Tool wird dazu aus dem enaio®-System eine beliebige Tabelle übergeben, durch das Tool manipuliert und anschließend wieder an enaio® zurückgegeben. Die Anwendung ist clientunabhängig und ohne Installation einsetzbar.

Besonders häufig wird das Kontierungstool im Rahmen der workflowbasierten Rechnungseingangsverarbeitung eingesetzt (daher auch der Name), da technisch gesehen lediglich Tabellen manipuliert werden, sind auch andere Einsatzszenarien denkbar, beispielsweise eine workflowbasierte Abarbeitung dynamischer Lauflisten.

Was ist unsere Motivation?

  • Hybrid (enaio® client, enaio® webclient (browser) und enaio® webclient als Desktop-Anwendung)  

  • Moderne Technologie

  • Übersichtlichere Benutzeroberfläche

Aktuelle Funktionalitäten ...

  • Clientunabhängige Bereitstellung im DMS und Workflow (keine Installation pro Arbeitsplatz notwendig)

  • Umfassende Konfigurationsmöglichkeiten: Feldtypen, -eigenschaften, Kataloge, Summenvalidierung

  • Manipulation von Kontierungszeilen (Aufsplitten, Zusammenführen, Zurücksetzen)

  • Validierung

  • Anzeige von Übergabedokumenten

  • Versionierung, Fehlerdiagnose (Logging)

Wo soll es hingehen ...

  • Mehrsprachigkeit

  • Bedingter Schreibschutz

  • Automatisches Befüllen von Zellen

  • Kontextabhängige Bereitstellung von Katalogen

  • Kontierungsvorlagen

  • Schnittstelle für die Anbindung von Drittsystemen

Das enaio® kontierungstool kann in Projekten mit geringfügigen Anpassung (per Konfiguration) eingesetzt werden und wird Ihnen von OPTIMAL SYSTEMS auf Nachfrage zur Verfügung gestellt (Ansprechpartner: Christoph Dorschfeldt).

enaio® client

Zweifaktor-Authentifizierung in client, capture und administrativen Tools (Andreas, 5 min.)

Zweifaktor-Authentifizierung (2FA) kann in enaio sowohl für den enaio® webclient als auch für den enaio® client verwendet werden. Die Einstellung für den enaio® webclient wird, wie bereits allgemein bekannt, in der Konfiguration von enaio® gateway vorgenommen. Die Konfiguration der 2FA für den enaio® client, enaio® capture sowie für die administrativen Tools wird im enaio® administrator benutzerspezifisch vorgenommen. Durch diese benutzerspezifische Konfiguration ist es möglich, administrative/technische Benutzer ggfs. von einer Zweifaktoranmeldung auszunehmen. Als 2FA kommen in enaio client® und den anderen Tools zeitbasierte temporäre Einmal-Passwörter (TOTP) zum Einsatz. Die Synchronisation mit gängigen TOTP-Clients auf mobilen Endgeräten (z. B., Google Authenticator, MS Authenticator App, u.v.m) ist über einen einmalig zur Initialisierung angezeigten QR-Code möglich. Der 2FA-Mechanismus ist auf die bisherige clientseitige Authentifizierung aufgesetzt und ist daher bei allen verwendbaren Authentifizierungsmechanismen anwendbar (NTLM, Kerberos, enaio PWD, LDAP Auth, ...). Falls durch einen Wechsel des mit dem Client synchronisierten mobilen Endgerätes eine Neusynchronisation erforderlich sein sollte, kann die bisherige Verbindung aufgelöst und ein neuer Barcode zur Synchronisation erzeugt werden. Die 2FA ist bei Aktivierung für folgende Clients wirksam:

  • enaio® client

  • enaio® capture

  • enaio® admin

  • enaio® editor

  • enaio® wf-editor

  • enaio® wf-admin

enaio® start ist als administrative Komponente, die ohne Benutzerinteraktion lauffähig sein muss, von 2FA ausgenommen. Dasselbe gilt für Tools wie enaio® enterprise-manager und enaio® monitor.


enaio® administration

Verschiedene Automatische Aktionen nun unabhängig von Trefferlistenbegrenzung (Andreas, 3 min)

Verschiedene Automatische Aktionen sind abhängig von Trefferlistenbegrenzungen des enaio® Systems. Diese Begrenzungen gelten systemweit und sind über die Parameter dbp/MaxHits und dms.ResultRowsetLimit je nach den Anforderungen des Projekts einstellbar. Sie begrenzen in der Regel die Trefferlisten in den verwendeten Clients, wirken aber auch auf Automatische Aktionen. Zentrale Automatische Aktionen für die Verwaltung und Kontrolle des Systems, die vor allem bzgl. der Verwaltung von Langzeitarchivierungen relevant sind, sind von diesen Trefferlistenbegrenzungen gelöst. Damit braucht der Administrator eines enaio® Systems diese Grenzen nicht mehr in seiner Konfiguration der Automatischen Aktionen zu berücksichtigen und kann seine Konfigurationen ausschließlich mit Blick auf die inhaltlichen Anforderungen bzw. der erwarteten Laufzeit einer Ausführung erstellen. Folgende Automatische Aktionen sind nun unabhängig von den jeweiligen Begrenzungseinstellungen:

  • dbp/MaxHits

    • Medien-Dearchivierung und

    • Signieren lassen sich über Trefferlisten über MaxHits hinaus ausführen

  •  dms/ResultRowSet

    • Dearchivierung und

    • Hashwertberechnung auf Objekttypebene lassen sich in ihren Anfragedateien ein eigenes Limit konfigurieren, dass die entsprechende Servereinstellung für die Ausführung der Aktion überschreibt

Parallele Archivierung über Microservice Archive (Andreas, 2 min)

Ziel dieser parallelen Archivierung ist eine Optimierung der Laufzeiten für Archivierungsläufe zum enaio® cloud archive. In der Konfiguration der Langzeitarchivierung über den Microservice Archive kann eine Threadanzahl N festgelegt werden, über die parallel archiviert wird. Während einer Archivierung macht der Server in diesem Fall N gleichzeitige Kanäle zum Microservice auf, um die Daten zum LZA zu übertragen. Die Übertragung findet in Gruppen von N Dokumenten (sogenannten Chunks) statt. Zur optimalen Nutzung der Laufzeiten werden dabei die zu archivierenden Dokumente der Größe nach sortiert. Damit ist gewährleistet, dass die Dokumente innerhalb eines Chunks in etwa gleich groß sind. Sie können also mit einem Server N Objekte parallel beim Langzeitarchiv archivieren. 

enaio® directory-sync  / Benutzerimport/-export (Andreas, 10 min.)

  • Die mit Version 11.0 als BETA eingeführte AAD-Sync heisst ab Version 11.10 nun enaio® directory-sync.

  • Verwendung des Benutzerimports / Benutzerexport nun unabhängig von der Benutzersprache des angemeldeten Benutzers. Konfiguration können zwischen Benutzern unterschiedlicher Sprachen geshared werden.

  • Verbesserte Logik beim Disablen von Benutzer per enaio® directory-sync. Benutzer, die per enaio® directory-sync auf WFM.deleted gesetzt werden, sind nun gleichzeitig in der Orgstruktur inaktiv und Abwesend gesetzt .

  • per Video (Jessica)

    • Überblick über enaio® directory-sync

    • Anbindung der enaio® directory-sync an LDAP

    • Benutzer und Gruppen können per enaio® directory-sync einem Workflow Organisationsobjekt zugeordnet werden. Damit lassen sich organisatorische Strukturen im Workflow direkt von der AD-Seite her verwalten


Mehrsprachige Workflows in enaio® (Andreas, 5 min.)

Spaltenbezeichner in der Anzeige des WF-Protokolls im Client in Benutzersprache

In einigen Workflowprojekten von enaio® wird per Skript eine Ablaufhistorie implementiert, diese Ablaufhistorie des Workflows wird als Reiter auf der WF-Maske dargestellt. Um die dort angezeigten Spaltenheader in der GUI-Sprache des Benutzers anzeigen zu können, wurde die in enaio® vorhandene WF-Variable wfProtocoltype geändert. Die dort enthalten Record-Member wurden umbenannt und dienen nun als technische Bezeichner. Bei Neuerstellung eines WF-Projektes wird die Variable neu nach diesem Muster in das WF-Projekt eingefügt. Vorhandene WF-Projekte werden nicht beeinflusst. Sollen existierende WF-Projekte  in dieser Hinsicht auf Mehrsprachigkeit umgestellt werden, ist die Benamung der Record-Member nachträglich anzupassen.

WF-Variable wfProtocoltype

Anzeige der Spaltenheader in GUI Sprache

WF-Variable wfProtocoltype

Anzeige der Spaltenheader in GUI Sprache

Dynamische Mehrsprachige Kataloge

Im enaio® Workflow werden Kataloge auf der WF-Maske häufig je nach Kontext mit unterschiedlichen Katalogeinträgen angezeigt. Dies wird über gescriptete dynamische Kataloge erreicht. Auch mehrsprachige Kataloge unterstützen diese Vorgehensweise. Wenn mehrsprachige dynamische Kataloge mit einer WF-Variablen verknüpft sind, ist es analog zu statischen mehrsprachigen Katalogen möglich, diese übersetzt in der jeweiligen Benutzersprache im Eingangskorb anzuzeigen.    


enaio® webclient allgemein

Mehrsprachige Workflows (Andreas/Tetiana, 6 min.)

Ab 11.10 werden wir mehrsprachige Workflows verwenden, indem wir im Client durch die festgelegte Objektdefinitionssprache (insbesondere Masken in den Workflows) wechseln, sodass der Benutzer nicht wie bisher einen vollständigen Workflow für jede clientseitige Sprache entwerfen muss.

Dynamische mehrsprachige Kataloge

(ab 11.10)

Ein mehrsprachiger Listen-/Baum-/Hierarchiekatalog auf einer Workflow Maske, der ohne Werte konfiguriert ist, kann über die Scripting API Methode "setCustomListEntries" dynamisch mit mehrsprachigen Werten ergänzt werden. Die gespeicherten Katalogwerte lassen sich im Eingangskorb in der Objektdefinitionssprache des Benutzers anzeigen.

Lokalisierter "Betreff" in Workflows

(ab 11.10)

In Eingangskorb ("Meine Eingänge | Laufende Workflows") wird ebenfalls der "Betreff" eines Arbeitsschrittes in der Objektdefinitionssprache des Benutzers angezeigt.

Neue Version – eigene "Identität" (Tetiana, 1 min.)

(ab 11.10)

Jede unserer neuen Major-Versionen erhält ihre eigene "Identität" über den exklusiv gestalteten Hintergrund.

Für enaio® webclient 11.10 basiert dieser auf aktuellen Designtrends des Jahres 2024: Runde Formen und sanfte Farbverläufe werden in einem Muster kombiniert, das gut sichtbar und angenehm für das Auge ist, während ihre spielerische Überschneidung und Schichtung interessante Akzente innerhalb der Komposition setzt.

Anmeldung

Dunkles Farbschema

Helles Farbschema

Anmeldung

Dunkles Farbschema

Helles Farbschema

 

Barrierefreiheit – BITV Konformität (Tetiana, 10 min.)

Wir beschäftigen uns intensiv mit dem Thema Barrierefreiheit weiter  – dies ist eines unserer langfristigen Ziele im Bereich des UX-Designs. Barrierefreiheit bedeutet, dass jeder Mensch ungehindert überallhin gelangen kann und alles ohne Probleme nutzen kann.

Indem wir enaio® webclient gut bedienbar machen, erleichtern wir Men­schen die Teilhabe am digitalen Leben. 

Wir arbeiten an der barrierefreien Gestaltung des enaio® webclients, um diesen Ansprüchen gerecht zu werden und damit weitestgehend ein uneingeschränktes Arbeiten zu ermöglichen. Als Grundlage dient uns die Barrierefreie-Informationstechnik-Verordnung (BITV 2.0) auf Basis des Behindertengleichstellungsgesetzes.

Dabei liegt unser Umsetzungsfokus auf der Lesbarkeit, der Zoom-Vergrößerung der Inhalte, der Erkennbarkeit von Bedienelementen (Kontrasten) und der Tastaturbedienung sowie der Nutzung von Screenreadern (Vorleseanwendungen).

Meldungen werden länger angezeigt oder können ausgeblendet werden

(ab 11.0.500)

Meldungen, die Benutzern angezeigt werden, werden länger angezeigt wenn der Benutzer diese anklickt oder können aktiv über das X-Symbol ausgeblendet werden.

Zoom im Browser kann über Tastaturkombinationen verändert werden

(ab 11.0.500)

Die Skalierung ("Zoom") im Browser kann über Tastaturkombinationen verändert werden und mitlaufenden Screenreader („Bildschirmvorleser“) informieren. 

  • <Strg + Plus/Mausrad> zoomt rein

  • <Strg + Minus/Mausrad> zoomt raus

  • <Strg + 0> – setzt auf 100 % Zoom zurück

Die Zoom-Level des enaio® webclients (Browser) und der Dokumentenvorschau funktionieren unabhängig voneinander. 

Detailvorschau ist über die Tastatur bedienbar

(ab 11.10.0)

In der Detailvorschau kann innerhalb der zum Objekt angezeigten Indexdaten (Funktion "Indexdaten"), Wiedervorlagen (Funktion "Wiedervorlagen"), Workflow angezeigten Daten (Funktion "Workflow") und zu den Schaltflächen, die weitere Funktionen für die Detailvorschau (Vorschaubereich) anbieten, mittels Tastatur navigiert werden und mitlaufende Screenreader („Bildschirmvorleser“) stellen alle Informationen zur Verfügung.

  • Kopfzeile und Menüs der Detailvorschau (ab 11.0.500)

Das Symbol zum Ein-/Auschecken wird nach oben unter die Überschrift „Detailvorschau“ mit dem Namen der Person verschoben, die ausgecheckt hat. Im Tooltip des Symbols wird außerdem angezeigt, durch wen und seit wann das Dokument ausgecheckt ist.
Hinweis: Dieses Symbol erscheint nur, wenn das angezeigte Dokument ausgecheckt ist.

  • Indexdaten

Tabellen und ausklappbare Bereiche in der Detailvorschau der Indexdaten folgen dem Schema für gleiche Dialogelemente.

      Visuelle Änderungen an den Schaltflächen „Empfänger“/"Recipients" und „Aktionen“:

11.0.500 - 11.10.0                                                                                                                                          11.0.500 - 11.10.0          


enaio® Services

enaio® appconnector (Inga, 1 min)

In enaio® werden in einem Workflow-Arbeitsschritt Kataloge auf der Workflow-Maske häufig abhängig vom Kontext mit unterschiedlichen Katalogeinträgen angezeigt. Hierfür stehen dynamische Kataloge zur Verfügung, wo ausschließlich per Script die Einträge für den Katalog definiert werden. Auch mehrsprachige Kataloge unterstützen diese Vorgehensweise. Sind dynamische mehrsprachige Kataloge mit einer Workflow-Variablen verknüpft, ist es analog zu statischen mehrsprachigen Katalogen möglich, diese übersetzt in der jeweiligen Objektdefinitionssprache im Eingangskorb anzuzeigen.

Endpunkt: /osrest/api/workflows/forward (osappconnector_setup.exe 11.0.0.168)

Wird eine Workflow-Aktivität in einem kundenindividuellen Szenario über den enaio® appconnector weitergeleitet, dann müssen für mehrsprachige dynamische Kataloge (gescripted) in der JSON Property "resources" die Anzeigewerte für alle aktiven Objektdefinitionssprachen übermittelt werden, damit die Anzeige in den Clients sprachabhängig funktioniert.

Ergebnis-JSON
... resources: { "EF873EECABCA463083BD0E4354591B61": { "de_DE": "Katalogwert 1 - DE", "en_US": "Catalog value 1 - EN", "fr_FR": "Valeur catalogue 1 - FR", "es_ES": "Valor de catálogo 1 - ES"         } ...