Änderungen von Dokument CMS-Schnittstelle

Zuletzt geändert von MACH ProForms GmbH am 10.10.2024

Von Version 183.1
bearbeitet von MACH ProForms GmbH
am 10.10.2024
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 177.2
bearbeitet von MACH ProForms GmbH
am 05.01.2024
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,31 +6,26 @@
1 -## Voraussetzungen
2 -
3 -Sie benötigen einen gültigen [[CMS-Key bzw. CMS-Schlüssel|doc:Main.01_Systemadministration.03_Installation.03_Abschliessend.02_Datenbank.01_CMS.WebHome]].
4 -Sie benötigen einen gültigen [[CMS-Key|doc:Main.01_Systemadministration.03_Installation.03_Abschliessend.02_Datenbank.01_CMS.WebHome]].
5 -
6 6  ## Mehrwert technischer Kooperation
7 7  
8 -Durch die Implementierung einer Schnittstelle zwischen einem CMS, DMS, Fachverfahren etc. (nachfolgend Partnersystem genannt) und dem Formular-Server kann je nach Ausgestaltung ein erheblicher Mehrwert für gemeinsame Kunden erreicht werden. Eine technische Kooperation zwischen den Systemen ist dabei nicht nur ein weiteres Produkt, das den bestehenden Kunden als ein nützliches Add-On angeboten werden kann. Insbesondere im kommunalen Markt gewinnt Interoperabilität von IuK-Systemen (Informations- und Kommunikations-Systemen) rasant an Bedeutung und wird somit für alle Anbieter zu einem zentralen Vertriebsargument für ihr Basisprodukt.
3 +Durch die Implementierung einer Schnittstelle zwischen einem CMS, DMS, Fachverfahren etc. (nachfolgend Partnersystem genannt) und dem Formularserver kann je nach Ausgestaltung ein erheblicher Mehrwert für gemeinsame Kunden erreicht werden. Eine technische Kooperation zwischen den Systemen ist dabei nicht nur ein weiteres Produkt, das den bestehenden Kunden als ein nützliches Add-On angeboten werden kann. Insbesondere im kommunalen Markt gewinnt Interoperabilität von IuKSystemen eine rasant wachsende Bedeutung und wird somit für alle Anbieter zu einem zentralen Vertriebsargument für ihr Basisprodukt.
9 9  
10 10  Nachfolgend werden einige Implementierungsvarianten der Schnittstelle beschrieben, die mit einem relativ überschaubaren Aufwand umgesetzt werden können:
11 11  
12 12  ### Redundanzfreie Benutzerverwaltung
13 13  
14 -Durch die Verbindung des Partnersystems mit MACH formsolutions kann die Benutzerverwaltung für beide Systeme einheitlich aus der Oberfläche des Partnersystems erfolgen. Die doppelte Erfassung und Pflege der Benutzer entfällt somit künftig für den Kunden, wodurch sowohl der administrative Aufwand, wie auch das Risiko von Fehleingaben halbiert werden.
9 +Durch die Verbindung des Partnersystems mit dem Form-Solutions Formularserver kann die Benutzerverwaltung für beide Systeme einheitlich aus der Oberfläche des Partnersystems erfolgen. Die doppelte Erfassung und Pflege der Benutzer entfällt somit künftig für den Kunden, wodurch sowohl der administrative Aufwand, wie auch das Risiko von Fehleingaben halbiert werden.
15 15  
16 -Bei personell stets sparsam ausgestatteten IT-Abteilungen der öffentlichen Hand bedeutet die Aufhebung der Benutzerverwaltungsredundanz einen spürbaren monetären Nutzen, der bei der Auswahl von Software entscheidend sein kann.
11 +Bei personell stets sparsam ausgestatteten IT-Abteilungen der Öffentlichen Hand bedeutet die Aufhebung der Benutzerverwaltungsredundanz einen spürbaren monetären Nutzen, der bei der Auswahl von Software entscheidend sein kann.
17 17  
18 18  ### Single Sign On
19 19  
20 -Mitarbeiter der Kunden beider Systeme sind mit dem Einsatz der Schnittstelle nicht mehr gezwungen sich mehrfach in jedem System separat zu authentifizieren. Mit der einmaligen Passworteingabe beim Partnersystem erfolgt der Login beim Formularserver vollautomatisch. Mit der einfacheren, hindernisfreien Nutzung und der Zeitersparnis für alle Nutzer erhöht das Single Sign On die Effizienz beider Programme. Ferner führt der Wegfall des Umgangs mit mehreren Passwörtern für jeden Nutzer zur Reduzierung des Administrationsaufwands und zur Erhöhung der Sicherheit, da die Passwörter zur Gedächtnisstütze nicht mehr schriftlich notiert werden müssen.
15 +Mitarbeiter der Kunden beider Systeme sind mit dem Einsatz der Schnittstelle nicht mehr gezwungen sich mehrfach in jedem System separat zu authentifizieren. Mit der einmaligen Passworteingabe beim Partnersystem erfolgt der Login beim Formularserver vollautomatisch. Mit der einfacheren, hindernisfreien Nutzung und der Zeitersparnis für alle Nutzer erhöht das Single Sign On die Effizienz beider Programme. Ferner führt der Wegfall des Umgangs mit mehreren Passwörtern für jeden Nutzer zur Minderung des Administrationsaufwands und zur Erhöhung der Sicherheit, da die Passwörter zur Gedächtnisstütze nicht mehr schriftlich notiert werden müssen.
21 21  
22 -### Vorausgefüllte Formulare im Intranet-Bereich
17 +### Vorausgefüllte Formulare im Intranetbereich
23 23  
24 -Im Bereich des Intranets besteht der Vorteil, dass i.d.R. die gesamte Nutzergruppe und damit alle Absender und Empfänger von Formularen bekannt sind. Die im Partnersystem gespeicherten Personaldaten können ausgelesen und zur Vorbefüllung von Formularen verwendet werden. Je nach Geschäftsvorfall wird damit ein Großteil der Formularfelder automatisch ausgefüllt, wodurch die Fehlerquote und der Aufwand bei der manuellen Formularbefüllung auf ein Minimum reduziert und die gesamte Durchlaufzeit von internen Prozessen deutlich beschleunigt werden kann.
19 +Im Bereich des Intranets besteht der Vorteil, dass i.d.R. die gesamte Nutzergruppe und damit alle Absender und Empfänger von Formularen bekannt sind. Die im Partnersystem gespeicherten Personaldaten können ausgelesen und zur Vorbefüllung von Formularen verwendet werden. Je nach Geschäftsvorfall wird damit ein Großteil der Formularfelder automatisch ausgefüllt, wodurch die Fehlerquote und der Aufwand bei der manuellen Formularbefüllung auf ein absolutes Minimum reduziert und die gesamte Durchlaufzeit von internen Prozessen deutlich beschleunigt werden kann.
25 25  
26 26  ### Parametrisierungsdynamik
27 27  
28 -In bestimmten Lebenslagen muss der Bürger mehrfach in Interaktion zu seiner Gemeinde treten und damit i.d.R. gleichzeitig oder in einem kurzen Zeitraum eine Vielzahl von Formularen ausfüllen.
23 +In bestimmten Lebenslagen muss der Bürger gleich mehrfach in Interaktion zu seiner Gemeinde treten und damit i.d.R. gleichzeitig oder in einem kurzen Zeitraum eine Vielzahl von Formularen ausfüllen.
29 29  
30 30  **Beispiel: Lebenslage Wohnungswechsel/Umzug**
31 31  
... ... @@ -35,17 +35,17 @@
35 35  
36 36  ### Systemintegration und Mehrwertkonzentration
37 37  
38 -Aus dem Partnersystem-Bereich können Kunden direkt die wichtigsten Komponenten des Formular-Servers ansprechen, bedienen und konfigurieren und damit aus einer Umgebung heraus ohne jegliche Umstellung den Mehrwert beider Systeme vereinen. Trotz plattformübergreifender Funktionalität befindet sich der Nutzer auf einer einheitlichen Oberfläche und braucht bei der täglichen Arbeit nicht ständig zwischen einer Vielzahl von Userinterfaces zu wechseln.
33 +Aus dem Partnersystem-Bereich können Kunden direkt die wichtigsten Komponenten des Formularservers ansprechen, bedienen und konfigurieren und damit aus einer Umgebung heraus ohne jegliche Umstellung den Mehrwert beider Systeme vereinen. Trotz plattformübergreifender Funktionalität befindet sich der Nutzer auf einer einheitlichen Oberfläche und braucht bei der täglichen Arbeit nicht ständig zwischen einer Vielzahl von Userinterfaces zu wechseln.
39 39  
40 40  Unter anderem können die folgenden Komponenten aus dem Partnersystem angesteuert werden:
41 41  
42 -#### Formular-Recherche
37 +#### Formularrecherche
43 43  
44 -Der Formular-Server enthält ein umfassendes Recherche-System für Schlagwörter, Namen, Formularnummern und Volltext. Zusätzlich wird die Suche durch standardmäßige Klassifizierung der Formulare in u.a. Kategorie, Dateityp und Datum weiter präzisiert. Weiterhin kann zwischen Verlagsformularen und kundenspezifischen Formularen unterschieden werden.
39 +Der Formularserver enthält ein umfassendes Recherchesystem für Schlagwörter, Namen, Formularnummern und Volltext. Zusätzlich wird die Suche durch standardmäßige Klassifizierung der Formulare in u.a. Kategorie, Dateityp und Datum weiter präzisiert. Weiterhin kann zwischen Verlagsformularen und kundenspezifischen Formularen unterschieden werden.
45 45  
46 46  #### Formularkonfiguration
47 47  
48 -Vor der Veröffentlichung eines bestimmten Formulars können im Formular-Server zunächst die Eigenschaften und die Funktionalität desselben festgelegt werden. Durch die Definition der einzelnen Parameter wird bei der Veröffentlichung des Formulars je nach Einstellung der spezifische Link generiert. Hierzu gehört die Festlegung der:
43 +Vor der Veröffentlichung eines bestimmten Formulars können im Formularserver zunächst die Eigenschaften und die Funktionalität desselben festgelegt werden. Durch die Definition der einzelnen Parameter wird bei der Veröffentlichung des Formulars je nach Einstellung der spezifische Link generiert. Hierzu gehört die Festlegung der:
49 49  
50 50  * zu verwendeten Schaltflächen und damit die durch den Bürger ansprechbaren Funktionalitäten (z.B. Formular online senden, digital signieren etc.)
51 51  * Formularsicherheit, zu der die Dokumentenverschlüsselung und die Dokumenteneinschränkung zählen (z.B. Drucken nicht zulässig)
... ... @@ -80,7 +80,7 @@
80 80  
81 81  #### Interaktive Schnittstelle
82 82  
83 -Interaktive Schnittstellen wurden für Bereiche entwickelt, in denen häufige Änderungen von uns vorgenommen werden und die einer laufenden Nachbesserung bedürfen. Hierzu wird (in einem neuen Fenster) eine Webseite vom MACH ProForms aufgerufen, die nach Ablauf des Dialogs Daten an eine angegebene Webseite übergibt oder, wenn es keiner Datenübergabe bedarf, vom Benutzer geschlossen werden kann.
78 +Interaktive Schnittstellen wurden für Bereiche entwickelt, in denen häufige Änderungen von uns vorgenommen werden und die einer laufenden Nachbesserung bedürfen. Hierzu wird (in einem neuen Fenster) eine Webseite vom Form-Solutions aufgerufen, die nach Ablauf des Dialogs Daten an eine angegebene Webseite übergibt oder, wenn es keiner Datenübergabe bedarf, vom Benutzer geschlossen werden kann.
84 84  
85 85  ![[Abbildung 2: Interaktive Schnittstelle|@ws-interactive-diagram.jpg]]
86 86  
... ... @@ -215,7 +215,7 @@
215 215  Der Benutzer hat das Recht 2D-Barcode Formulare zu erstellen.
216 216  * **usr_anl**
217 217  `int(0,1)`
218 -Der Benutzer hat das Recht weitere Benutzer im System anzulegen.
213 +Der Benutzer hat das Recht weitere Benutzer im Form-Solutions System anzulegen.
219 219  * **usr_shw**
220 220  `int(0,1)`
221 221  Der Benutzer hat das Recht andere Benutzer zu verwalten.
... ... @@ -227,7 +227,7 @@
227 227  Der Benutzer hat das Recht sich als ein anderer Benutzer einzuloggen (dies wird meist zum debuggen benutzt).
228 228  * **usr_del**
229 229  `int(0,1)`
230 -Der Benutzer hat das Recht andere Benutzerdatensätze im System zu löschen.
225 +Der Benutzer hat das Recht andere Benutzerdatensätze im Form-Solutions System zu löschen.
231 231  * **give_right**
232 232  `int(0,1)`
233 233  Der Benutzer hat das Recht seine eigenen Rechte an andere Benutzer weiterzugeben.
... ... @@ -408,7 +408,7 @@
408 408  Der Benutzer hat das Recht 2D-Barcode Formulare zu erstellen.
409 409  * **usr_anl**
410 410  `int(0,1)`
411 -Der Benutzer hat das Recht weitere Benutzer im System anzulegen.
406 +Der Benutzer hat das Recht weitere Benutzer im Form-Solutions System anzulegen.
412 412  * **usr_shw**
413 413  `int(0,1)`
414 414  Der Benutzer hat das Recht andere Benutzer zu verwalten.
... ... @@ -420,7 +420,7 @@
420 420  Der Benutzer hat das Recht sich als ein anderer Benutzer einzuloggen (dies wird meist zum debuggen benutzt).
421 421  * **usr_del**
422 422  `int(0,1)`
423 -Der Benutzer hat das Recht andere Benutzerdatensätze im System zu löschen.
418 +Der Benutzer hat das Recht andere Benutzerdatensätze im Form-Solutions System zu löschen.
424 424  * **give_right**
425 425  `int(0,1)`
426 426  Der Benutzer hat das Recht seine eigenen Rechte an andere Benutzer weiterzugeben.
... ... @@ -484,7 +484,7 @@
484 484  
485 485  ### deluser
486 486  
487 -Deluser löscht einen spezifischen Benutzer aus der Datenbank.
482 +Deluser löscht einen spezifischen Benutzer aus der Form-Solutions Datenbank.
488 488  
489 489  #### Webservice-URL:
490 490  
... ... @@ -577,8 +577,8 @@
577 577  `text`
578 578  Beschreibung des Formulars
579 579  * **formtype** `varchar(3)`
580 -Die Software unterscheidet zwischen 2 Formulartypen.
581 -fs = ein von MACH ProForms erstelltes Formular
575 +Form-Solutions unterscheidet zwischen 2 Formulartypen.
576 +fs = ein von Form-Solutions erstelltes Formular
582 582  knd = ein vom Kunden erstelltes Formular
583 583  
584 584  ---
... ... @@ -587,7 +587,7 @@
587 587  
588 588  ### Sign-In
589 589  
590 -Mit dieser Funktion können Sie einen Benutzer ohne weitere Login-Abfragen im System einloggen.
585 +Mit dieser Funktion können Sie einen Benutzer ohne weitere Loginabfragen im FormSolutions System einloggen.
591 591  
592 592  #### URL:
593 593  
... ... @@ -602,7 +602,7 @@
602 602  * **type**
603 603  signin`
604 604  
605 -### Formular suchen und Formular-Link erstellen
600 +### Formular suchen und Formularlink erstellen
606 606  
607 607  Diese Funktion öffnet einen Suchdialog, in dem der Benutzer ein Formular suchen und konfigurieren kann. Nach Abschluss dieser Funktion wird die generierte URL an eine übergebene Ziel-URL weitergereicht.
608 608  
... ... @@ -619,14 +619,14 @@
619 619  * **type**
620 620  `formsearch`
621 621  * **return**
622 -URL, an die der erstellte Formular-Link übergeben werden soll. Diese URL muss so aussehen, dass am Ende der URL der Formular-Link angefügt werden kann. Bsp: <https://pdf.form-solutions.net//ws/back.php?data=>
617 +URL, an die der erstellte Formlink übergeben werden soll. Diese URL muss so aussehen, dass am Ende der URL der Formularlink angefügt werden kann. Bsp: <https://pdf.form-solutions.net//ws/back.php?data=>
623 623  Des Weiteren muss der übergebene Link urlencoded gesendet werden. In dem übergebenen Link wird zusätzlich urlencoded mit dem Parameter `title` der Titel des Formulars und mit dem Parameter `id` die Formularnummer mitgegeben.
624 624  
625 625  > _**Hinweis:**_
626 626  >
627 -> In der Variante mit dem type formsearch kann man ab der Release-Version 32.13.0 auch Assistenten suchen. Die Überarbeitung von Assistenten-Links erfolgt ebenso über diese Variante.
622 +> In der Variante mit dem type formsearch kann man ab der Release-Version 32.13.0 auch Assistenten suchen. Die Überarbeitung von Assistentenlinks erfolgt ebenso über diese Variante.
628 628  
629 -### Basisformular-Link erstellen
624 +### Basisformularlink erstellen
630 630  
631 631  Die Funktion `getbaselink` übergibt einen sicheren Link zu einem Formular ohne weitere Funktionen wie Senden, Barcode, S-Internetkasse oder eCash.
632 632  
... ... @@ -653,7 +653,7 @@
653 653  >
654 654  > Diese Funktion steht für Assistenten nicht zur Verfügung.
655 655  
656 -### Individualformular-Link erstellen
651 +### Individualformularlink erstellen
657 657  
658 658  Diese Funktion öffnet einen Konfigurationsdialog, in dem der Benutzer ein übergebenes Formular konfigurieren kann. Nach Abschluss dieser Funktion wird die generierte URL an eine übergebene Ziel-URL weitergereicht.
659 659  
... ... @@ -672,8 +672,8 @@
672 672  * **formular**
673 673  Formularnummer
674 674  * **formtype**
675 -Ist dies ein von MACH ProForms oder ein vom Kunden erstelltes Formular? (`fs`, `knr`) (siehe 3.6.3.2 getformlist - Zurückgegebene Daten, Variable `formtype`)
676 -* **return** URL an die der erstellte Formular-Link übergeben werden soll. Diese URL muss so aussehen, dass am Ende der URL der Formular-Link angefügt werden kann.
670 +Ist dies ein von Form-Solutions oder ein vom Kunden erstelltes Formular? (`fs`, `knr`) (siehe 3.6.3.2 getformlist - Zurückgegebene Daten, Variable `formtype`)
671 +* **return** URL an die der erstellte Formlink übergeben werden soll. Diese URL muss so aussehen, dass am Ende der URL der Formularlink angefügt werden kann.
677 677  Bsp: <https://pdf.form-solutions.net/ws2/back.php?data=>
678 678  Des Weiteren muss der übergebene Link urlencoded gesendet werden. In dem übergebenen Link wird zusätzlich urlencoded mit dem Parameter title der Titel des Formulars und mit dem Parameter `id` die Formularnummer mitgegeben.
679 679