Wir sagen Danke! Für d.velop inbound scan und d.velop inbound e-mail haben wir viel konstruktives Feedback bekommen. Dieses bezieht sich vor allem auf die Benutzeroberfläche. In diesem Beitrag möchten wir Euch aufzeigen wie wir die Oberfläche noch einfacher gestalten und was wir noch vorhaben, damit Ihr Eure Prozesse noch einfacher gestalten könnt.
Benutzeroberfläche
Die Benutzeroberfläche werden wir so gestalten, dass möglichst wenige Klicks ausgeführt werden müssen und das Interface nicht so viel hin und her wischt. Dazu gibt es drei Modi der Oberfläche, die den Anwender je nach Status unterstützen werden.
- Erfassungsmodus
- Exportmodus
- Indexmodus
Desweiteren werden wir eine Seitenleiste einführen über die der Anwender, je nach Modus, noch besser in bestehende Stapel oder Dokumente navigieren kann.
Erfassungsmodus
Der Erfassungsmodus ist der gewohnte Bereich. Hier kann der Anwender Papierbelege einscannen oder Dateien importieren. Anschließend kann er Seiten bearbeiten (löschen, verschieben, drehen) und manuell bzw. KI-gestützt Dokumente definieren. Wenn er diesen Arbeitsschritt beendet hat, kann er den "Import abschließen". Die Anwendung wechselt in den Exportmodus.
Exportmodus
In diesem Modus hat der Anwender einen Überblick über alle Dokumente und kann Dokumente, die er nicht speichern will demarkieren. Über die Speichern-Schaltfläche werden die markierten Dokumente direkt in das entsprechende System gespeichert. Durch einen Klick auf ein Dokument in auf der Übersichtsseite oder in der Seitenleiste gelangt der Anwender in den Indexmodus.
Indexmodus
Im Indexmodus sieht er die Vorschau des Dokumentes im Hauptbereich und kann über alle Seiten des Dokumentes scrollen. Rechts neben der Vorschau sind die Eigenschaften des Dokumentes zu sehen, die er auch bearbeiten kann. Über die linke Seitenleiste kann er zu den einzelnen Dokumenten navigieren. Auch in diesem Modus kann er das aktuell markierte Dokument oder alle Dokumente speichern.
Automatisierter E-Mail-Eingang
Mit d.velop inbound e-mail kannst Du für Dein Unternehmen (bzw. Mandanten) eigene Postfächer definieren. In der Postfachkonfiguration kannst Du ein Inbound-Profil angeben, mit dem die eingehende E-Mail verarbeitet wird. Hier werden zwei Profile bereitstehen. Das erste definiert, dass die E-Mails und deren Anhänge als Dokumente importiert werden. Wenn der Anwender den erstellen Stapel öffnet, landet er direkt im Exportmodus.
Das zweite Profil ermöglicht die automatische Ablage in d.velop documents. Eingehende E-Mails werden über d.velop inbound verarbeitet. Dabei erfolgt die Dokumenttrennung und -erkennung und die Metadatenanreicherung. Die Dokumente werden dann entsprechend dem Mapping in d.velop documents abgelegt, sofern alle Pflichtfelder gefüllt sind. Ist das nicht der Fall, kann der Anwender die Dokumente manuell wie gewohnt ablegen.
KI-gestützte Metadatenextraktion
Über einen KI-gestützten Dienst werden wir aus bestimmten Dokumentarten weitere Metadaten extrahieren, damit der Anwender möglichst wenig manuell eintragen muss.
Die o.g. Funktionen werden wir nach und nach umsetzen und veröffentlichen. Beobachtet den Blog, um zu erfahren wann wir welche Funktion bereitstellen.
Ihr findet hier eine kurze Beschreibung, welche Schritte zur Erstellung einer d.velop-cloud-app notwendig sind.
Es wird hier vorausgesetzt, dass die Amazon-Webservices (AWS) genutzt werden. Die Erstellung einer App wird hier anhand eines c#-Beispiels demonstriert
Voraussetzung
- Es sollte ein AWS Account vorhanden sein ( Anmeldung über https://aws.amazon.com/de )
- Registrierung in der d.velop Cloud unter http://my.d-velop.cloud
- Ein GitHub Account ( https://github.com ) ist notwendig
- Auf dem Rechner, auf dem entwickelt werden soll, sollte Docker Desktop in der aktuellen Version vorhanden sein.
Die Installation der Community Edition ist ausreichend. Stelle die Docker Container auf Linux-Container ein. - Für dieses Beispiel wird ein installiertes Visual Studio für c# vorausgesetzt.
Ablauf
- melde in der d.velop cloud http://my.d-velop.cloud an und notiere dein Provider -Präfix. Dieses Präfix findest du unter "meine Anbieter" . Dann klicke bitte die Details zu dem Anbieter an und wähle dann die Kachel "Anbieter". Im Feld "Kürzel/Präfix" findest du dann dein Provider - Präfix.
- Lade das vorbereitete c#-Projekt aus dem GitHub-Repository herunter.
Kommandozeilenbefehl: git clonehttps://github.com/d-velop/dvelop-app-template-cs
Es wird in dem aktuellen Verzeichnis ein Unterverzeichnis mit dem Namen dvelop-app-template-cs angelegt. - Öffne nun aus dem Visual Studio das Projekt "AcmeTemplate.sln" aus dem Verzeichnis .\dvelop-app-template-cs
- Starte den Build-Prozess für dieses Projekt und starte anschließend die Application "VacationProcess-CS".
Nach dem Start kann die Application über einen Browser ( Chrome empfohlen) lokal getestet werden. Rufe hierzu einfach die URL http://localhost:5000 auf.
Mit dieser App kann man nun vorhandene Urlaubsanträge ansehen und neue Anträge anlegen. Beende anschließend die Applikation wieder. - Nun vergeben wir dieser Applikation zunächst einen neuen Namen. Hierzu bitte den Befehl
docker-build rename NAME=<Anbieterpräfix>-AppKennzeichen ( z.B. acme-vacationxyz)
Achtung: bitte den Namen in Kleinbuchstaben schreiben
in der Kommandozeile in dem Verzeichnis .\dvelop-app-template-cs ausführen - Melde dich nun in deinem AWS-Account an und suche den Service "IAM" (Benutzerverwaltung)
Lege dort einen neuen Benutzer an und weise ihm den Zugriffstyp "Programmgesteuerter Zugriff" zu.
Weise ihm zusätzlich die Berechtigung AdministratorAccess zu. Dies kann nur über Zuweisung zu einer entsprechend berechtigten Gruppe geschehen. Diese Gruppe ggfs. neu anlegen und mit dieser Berechtigung versehen.
Zum Abschluss der Benutzeranlage erhälst du eine Detailansicht des angelegten Benutzers mit Zugriffschlüssel-ID und dem geheimen Zugriffschlüssel. Bitte diese beiden Werte kopieren bzw. notieren. - Öffne nun die Datei "Makefile" aus dem Verzeichnis .\dvelop-app-template-cs und ändere die Werte für
APP_NAME=acme-apptemplatecs
in
APP_NAME=<Anbieterpräfix>-AppKennzeichen ( z.B. acme-vacationxyz )
Die Bezeichnung
DOMAIN_SUFFIX=.hackathon.service.d-velop.cloud
sollte für die Tests während des Hackathons unverändert bleiben. - Öffne die Datei backend.tf aus dem Verzeichnis .\dvelop-app-template-cs\terraform und ändere den Wert
bucket = "acme-apptemplatecs-terraform"
in
bucket = <Anbieterpräfix>-AppKennzeichen-terraform
Achtung : dieser Wert kommt in der Datei an zwei Stellen vor. Bitte hier darauf achten die Sprachkodierung "UTF8 OHNE BOM" zu nutzen. - Öffne die Dateien docker-build.bat aus dem Verzeichnis .\dvelop-app-template-cs und ändere die Zeile
set APPNAME= acme-apptemplatecs
in
set APPNAME = <Anbieterpräfix>-AppKennzeichen - Öffne die Dateien docker-build.sh aus dem Verzeichnis .\dvelop-app-template-cs und ändere die Zeile
APPNAME= acme-apptemplatecs
in
APPNAME= <Anbieterpräfix>-AppKennzeichen - Öffne die Datein startup.sh aus dem Verzeichnis aus dem Verzeichnis .\dvelop-app-template-cs\remote und ändere die Zeile
Configuration["APP_NAME"] = Configuration["APP_NAME"]??"acme-apptemplatecs";
in
Configuration["APP_NAME"] = Configuration["APP_NAME"]??"<Anbieterpräfix>-AppKennzeichen"; - Möchtest du den Titel der App ändern, dann öffne bitte die Datei Root.cshtml aus dem Verzeichnis dvelop-app-template-cs\Remote\Views\Root und ändere die Zeile
<a href="./vacationrequest/">Vacation Process </a>
nach deinen Wünschen. - Setze nun in der Kommandozeile die beiden Umgebungsvariablen
SET AWS_ACCESS_KEY_ID=<YOUR-ACCESS-KEY-ID>
SET AWS_SECRET_ACCESS_KEY=<YOUR-SECRET-ACCESS-KEY>
mit deinen AWS-AIM-Benutzer-Informationen - Starte nun den Docker-Build-Prozess mit dem Befehl docker-build.bat deploy
Es kann nun vorkommen, das der Fehler "NoSuchBucket: The specified bucket does not exist" erscheint. Sollte dieser auch bei wiederholtem Aufruf des Befehls
erscheinen, dann bitte zusätzlich folgenden Schritt ausführen:
- melde dich in AWS and uns suche den Service "S3". Lege dort eine neues Bucket mit deinem Applicationsnamen <Anbieterpräfix>-AppKennzeichen in der Region Frankfurt an. - Nach erfolgreichem Build-Vorgang wird zum Abschluss der Konsolenausgaben die URL für den Zugriff ausgegeben ( Endpoint):
Beispiel:
endpoint = [
https://pejfvkxqhk.execute-api.eu-central-1.amazonaws.com/prod/acme-vacationxyz/,
https://pejfvkxqhk.execute-api.eu-central-1.amazonaws.com/dev/acme-vacationxyz/
]
Bitte eine der URLs in Zwischenablage kopieren. - Nun bitte im d.velop Cloudcenter ( my.d-velop.cloud ) eine entsprechende App anlegen. Hierzu die Kachel "meine Anbieter" anklicken, den passenden Anbieter auswählen und dort die Kachel "Apps" anklicken. Mit dem "Plus-Zeichen" in der ActionItemlist ( Icons auf der rechte Seite des Internetseite) kannst du nun eine App hinzufügen.
Bitte trage den korrekten Appnamen ein, also das AppKennzeichen , das zuvor auch für die Definition der App genutzt wurde.
Bitte die vorgegebene Endpoint-URL mit der zuvor notierten Endpoint-URL überschreiben.
Bitte die AppSecret zum Schluss des Anlagedialogs kopieren und in Zwischenablage kopieren. - Nun noch einmal in die Konsole wechsel und die Umgebungsvariable
SET SIGNATURE_SECRET=<AppSecret> setzen
Nutze hierzu den zuvor gemerkten AppSecret.
Starte nun einen erneuten Rebuild der App mit dem Befehl docker-build deploy