Wiki-Quellcode von Aktualisieren

Zeige letzte Bearbeiter
1 {{figure image="form_menu_update_de.png" width="300" clear="h1"}}
2 Über das [[Formularmenü>>doc:Formcycle.UserInterface.MyForms.WebHome||anchor="form_menu"]] können existierende Formulare aktualisiert werden.
3 {{/figure}}
4
5 {{info}}
6 **Achtung!** Beim Aktualisieren eines Formulars werden sämtliche Einstellungen des Formulars, einschließlich des [[Workflows>>doc:Formcycle.Designer.Workflow.WebHome]], überschrieben. Anwender sollten sich dessen bewusst sein, insbesondere wenn es sich um Formulare handelt, mit denen bereits Daten erfasst wurden.
7 {{/info}}
8
9 Formularexporte können dazu verwendet werden, um bestehende Formulare zu aktualisieren oder gar komplett zu transformieren.
10
11 == Voraussetzung ==
12
13 Um ein Formular zu aktualisieren, ist ein Formularexport nötig, welcher aus {{formcycle/}} ab Version **6.2** exportiert wurde (sowohl [[Standardformat>>doc:Formcycle.UserInterface.MyForms.Export.Form||anchor="li_default_format"]] als auch [[Kompatibilitätsformat>>doc:Formcycle.UserInterface.MyForms.Export.Form||anchor="li_compatibilty_format"]] sind möglich).
14
15 == Ablauf ==
16
17 Nachdem der Menüeintrag {{icon name="refresh"/}}**Aktualisieren** aus dem [[Formularmenü>>doc:Formcycle.UserInterface.MyForms.WebHome||anchor="form_menu"]] gewählt wurde, öffnet sich ein Auswahldialog, mit welchem eine Formularexportdatei ausgewählt werden kann. Wie Formulare exportiert werden können, ist [[hier>>doc:Formcycle.UserInterface.MyForms.Export.Form]] beschrieben.
18
19 Der Aktualisierungsprozess beginnt, nachdem eine Datei ausgewählt wurde. {{formcycle/}} versucht automatisch, den Status des bestehenden Formulars jeweils einen Status aus dem Formularexport zuzuordnen. Dies ist nicht in jedem Fall möglich. Kann nicht jeder Status einem neuen Status zugeordnet werden, muss der Benutzer diese [[Status manuell zuordnen>>||anchor="subsec_state_mapping"]].
20
21 Wenn keine Statuszuordnung nötig war oder diese abgeschlossen wurde, muss der Nutzer entscheiden, was mit der aktiven Formularversion passieren soll (siehe [[Formularversion>>||anchor="subsec_form_version"]]).
22
23 Besitzt der Nutzer keine Berechtigung für das Formular aus dem Formularexport, erhält dieser die Möglichkeit, die [[Zugriffsberechtigung>>||anchor="subsec_access_config"]] zu ändern.
24
25 Im Anschluss an die Formularaktualisierung muss der Benutzer nicht aufgelöste [[Formularabhängigkeiten auflösen>>doc:||anchor="subsec_dependencies"]].
26
27 {{id name="subsec_state_mapping"/}}
28
29 === Statuszuordnung ===
30
31 {{figure image="form_update_state_mapping_de.png" width="300" clear="h1"}}
32 Wenn {{formcycle/}} keinen passenden Status finden konnte, wird der Nutzer aufgefordert, alte Status einem neuen Status aus dem Formularexport zuzuordnen.
33 {{/figure}}
34
35 Eine manuelle Statuszuordnung durch den Benutzer ist nur dann nötig, wenn es Status gibt, in denen sich Vorgänge befinden und für die, basierend auf dem Namen, kein passender neuer Status gefunden werden konnte.
36
37 Jeder Status, für den kein passender neuer Status gefunden werden konnte, wird hier mit der Anzahl der Vorgänge, die sich in diesem Status befinden, aufgelistet. Für jeden dieser Status muss ein neuer Status aus dem Formularexport zugeordnet werden. Vorgänge, die sich in diesem Status befinden, befinden sich nach der Formularaktualisierung in dem zugeordneten Status.
38
39 {{id name="subsec_form_version"/}}
40
41 === Formularversion ===
42
43 {{figure image="form_update_form_version_de.png" width="300" clear="h1"}}
44 Bevor die Aktualisierung des Formulars startet, muss der Benutzer entscheiden, ob die aktive Formularversion mit der aus dem Formularexport überschrieben werden soll oder ob die Formularversion des Formularexports stattdessen als eine neue Formularversion angelegt werden soll.
45 {{/figure}}
46
47 Bevor das Formular endgültig aktualisiert wird, muss der Benutzer entscheiden, ob die aktive Formularversion überschrieben werden soll oder ob eine neue Formularversion erstellt werden soll. Dies ist insbesondere wichtig, wenn Formulare aktualisiert werden, mit denen bereits Daten erfasst wurden.
48
49 Besitzt ein Formular [[Vorgänge>>doc:Terminology.WebHome]] in der aktiven [[Formularversion>>doc:Formcycle.UserInterface.MyForms.Versions.WebHome]], wird empfohlen, eine neue Formularversion zu erstellen. Hier wird dann die aktive Formularversion des Formularexports als neue Formularversion erstellt. Somit können bereits erfasste Daten weiterhin in der ursprünglichen Formularversion betrachtet werden.
50
51 Wird die aktive Formularversion stattdessen überschrieben, kann dies dazu führen, dass die erfassten Daten zum Teil oder gar vollständig nicht mehr einsehbar sind, da die Namen der Formularelemente komplett unterschiedlich sein können.
52
53 Nachdem der Nutzer entschieden hat, ob die aktive Formularversion überschrieben oder eine neue angelegt werden soll, startet die Formularaktualisierung. Dabei versucht {{formcycle/}}, möglichst alle Formularabhängigkeiten automatisch aufzulösen. Gibt es im Anschluss Abhängigkeiten, die nicht automatisch aufgelöst werden konnten, muss der Benutzer diese manuell auflösen (siehe [[Formularabhängigkeiten>>doc:||anchor="subsec_dependencies"]]).
54
55 {{id name="subsec_access_config"/}}
56
57 === Zugrifssbeschränkung ===
58
59 {{figure image="form_update_access_config_de.png" width="300" clear="h1"}}
60 Enthält das Formular der Formularexports eine Zugriffsbeschränkung, welche den Benutzer ausschließt, kann dieser die Beschränkung entfernen.
61 {{/figure}}
62
63 Besitzt das Formular des Formularexports eine [[Zugriffsbeschränkung>>doc:Formcycle.UserInterface.MyForms.Access.WebHome||anchor="admin_restriction"]] auf bereits exisitierende [[Benutzergruppen>>doc:Formcycle.UserInterface.UserSettings.UserGroups.WebHome]] und gehört der Benutzer keiner dieser Benutzergruppen an (und ist auch kein Mandantadministrator), dann hat dieser die Möglichkeit, die Zugriffsbeschränkung zu ändern:
64
65 Existiert eine Beschränkung für die //Formularsichtbarkeit// oder //Formulareditierbarkeit//, dann hat der Benutzer jeweils die folgenden Optionen:
66
67 ; {{icon name="user"/}} Einer Benutzergruppe beitreten
68 : Diese Option steht nur zur Verfügung, wenn der Benutzer die nötige [[Rollenberechtigung>>doc:Formcycle.UserInterface.UserSettings.Roles.WebHome]] besitzt, um [[Benutzergruppen>>doc:Formcycle.UserInterface.UserSettings.UserGroups.WebHome]] zu bearbeiten. Indem der Benutzer der gewählten Benutzergruppe beitritt, erhält dieser auch die nötige Formularberechtigung.
69
70 ; {{ficon name="trash-alt2"/}}Zugriffsbeschränkung entfernen
71 : Es gibt keine Beschränkung mehr für die Sichtbarkeit beziehungsweise die Editierbarkeit des Formulars.
72
73 ; {{ficon name="close-circle-outline"/}}Zugriffsbeschränkung beibehalten
74 : Die Beschränkung wird unverändert beibehalten. {{info}}Dies führt allerdings dazu, dass das Formular nach Abschluss der Aktualisierung für den Benutzer nicht mehr editierbar oder gar nicht mehr sichtbar ist.{{/info}}
75
76 {{id name="subsec_dependencies"/}}
77
78 === Formularabhängigkeiten ===
79
80 {{figure image="form_import_dep_exisiting_02_de.png"}}
81 {{id name="fig_form_import_dep_exisiting" /}}
82 Eine Formularabhängigkeit konnte nicht automatisch aufgelöst werden. In diesem Fall gibt es eine unaufgelöste Abhängigkeit. Jede Abhängigkeit wird mit ihrem Namen (1) und einer Beschreibung (2), wo sie im Formular verwendet wird, aufgelistet. Es können alternative bestehende CSS-Templates benutzt werden, welche bereits im Backend erstellt (3). Hier existiert das CSS-Template bereits, welches als Theme für das Formular verwendet wird. Allerdings ist es nicht identisch mit dem CSS-Template aus der Exportdatei. Der Nutzer hat nun die Möglichkeit, das Template zu überschreiben (4), das Template als ein Neues anzulegen (5) oder diese Abhängigkeit zu ignorieren (6).
83 {{/figure}}
84
85 Formularabhängigkeiten sind vom Formular verwendete [[Dateien & Templates>>doc:Formcycle.UserInterface.FilesAndTemplates.WebHome]], [[Postfächer>>doc:Formcycle.UserInterface.Inboxes.WebHome]], [[Datenquellen>>doc:Formcycle.UserInterface.Data.Sources.WebHome]], etc. Diese Abhängigkeiten können im Formular selbst (etwa Datenquellen an [[Auswahlelementen>>doc:Formcycle.Designer.Form.FormElements.Selection]]), in den Formulareinstellungen oder im [[Workflow>>doc:Formcycle.Designer.Workflow.WebHome]] (etwa Einstellungen von Aktionen) vorkommen. Abhängig vom Typ und der Existenz der Formularabhängigkeit können folgende Optionen zur Verfügung stehen, um die Abhängigkeit aufzulösen (siehe [[Abbildung>>doc:||anchor="fig_form_import_dep_exisiting"]]):
86
87 ; {{icon name="refresh"/}} Überschreiben
88 : Existiert das Element bereits im System, so kann es überschrieben werden. Diese Option steht nicht für Postfächer oder Benutzergruppen zur Verfügung.
89
90 ; {{ficon name="plus-circle-outline"/}}Anlegen
91 : Das Element wird im System angelegt. Wenn nötig, wird der Name des Elements angepasst.
92
93 ; {{icon name="chevron-down"/}} Alternative verwenden
94 : Anstatt das Element neu anzulegen, kann eine bereits existierende Alternative verwendet werden.
95
96 ; {{ficon name="close-circle-outline"/}}Ignorieren (nicht empfohlen)
97 : Die Formularabhängigkeit wird ignoriert. Dies kann zu Fehlern in der Darstellung oder Verarbeitung des Formulars führen.
98
99 === Besonderheiten ===
100
101 ; Standardpostfach
102 : Ist eine Formularbhängigkeit das //Standarpostfach// des Formulars, ist zu beachten, dass alle neuen Vorgänge in diesem Postfach landen werden. Um diese einzusehen, benötigt der Benutzer Zugriff auf dieses Postfach. Wird die Abhängigkeit ignoriert, so wird das //Zentrale Postfach// als Standardpostfach verwendet. Für mehr Informationen siehe [[Postfachkonfiguration>>doc:Formcycle.UserInterface.MyForms.Inbox.WebHome]] und [[Postfächer>>doc:Formcycle.UserInterface.Inboxes.WebHome]].
103
104 ; Formularsichtbarkeit / Formulareditierbarkeit
105 : Ist eine Formularbhängigkeit eine Benutzergruppe für die //Formularsichtbarkeit// oder //Formulareditierbarkeit// und konnte die Benutzergruppe nicht aufgelöst werden, ist zu beachten, dass nur Benutzer der neu angelegten oder ausgewählten Benutzergruppe das Formular sehen beziehungsweise editieren können. Ist der Benutzer also nicht Teil der ausgewählten Benutzergruppe und kein Mandantadmin, führt dies dazu, dass der Benutzer das Formular nicht mehr sehen beziehungsweise editieren kann, bis dieser Teil der Benutzergruppe ist. Wird die Abhängigkeit ignoriert, entfällt diese Zugriffsbeschränkung. Für mehr Informationen siehe [[Formularzugriffskonfiguration>>doc:Formcycle.UserInterface.MyForms.Access.WebHome||anchor="admin_restriction"]] und [[Benutzergruppen>>doc:Formcycle.UserInterface.UserSettings.UserGroups.WebHome]].