Komplexes forms⁺ - Schritt für Schritt Anleitung
Inhaltsverzeichnis:
Ausgangssituation
Sie möchten Ihren Kunden mithilfe eines forms⁺ die Möglichkeit geben, Mitarbeiter einer Firma anzulegen.
Sie haben in Ihrem Bestand für die Firmen die Niederlassungen als Geschäftsanschriften erfasst.
Weitere Hinweise zum Erfassen von Anschriften finden Sie hier: Wie verwalte ich Kontakt- und Partnerdaten?
Die fertige Lösung soll wie folgt aussehen:
Die Geschäftsadresse möchten Sie hierbei auch für die Anschrift des Arbeitnehmers übernehmen.
Lösung
Öffnen Sie Ihre gewohnte forms-Administration.
Wählen Sie hier den Button “ Neues forms⁺”.
Wählen Sie die Vorlage “Partnerdaten” und vergeben Sie einem treffenden Namen.
Ihr neues forms⁺ ist nun mit der ausgewählten Vorlage angelegt. Klicken Sie dann auf den Button “forms-Editor”.
forms⁺-Editor
Ihr forms⁺ wird im Editor geöffnet, und Sie können direkt mit der ersten Aufgabe anfangen.
Fachobjekte
Der erste Schritt in der Erstellung eines forms⁺ ist immer die Analyse der benötigten Fachobjekte.
In unserem Fall sind die beteiligten Fachobjekte der Arbeitgeber mit seinen Geschäftsanschriften, der Arbeitnehmer mit einem Arbeitsplatz (ausgewählte Geschäftsanschrift) und das Anstellungsverhältnis.
Klicken Sie auf “Fachobjekte”.
Hier können Sie nun die Fachobjekte konfigurieren:
Was haben wir hier im Beispiel eingestellt?
Ein forms⁺ braucht, um zu funktionieren, eine Angabe (“Eingabe bei Vorgangsanlage”), diese ist ein Kunde (Tabelle), die im Feld “Zuordnung” den Wert “FIRMA” hat und im Feld “Status” den Wert “KUNDE”.
"Eingabe bei Vorgangsanlage": Wenn "Pflichteingabe" oder "Optional" eingestellt ist, wird der Nutzer bei "Formularabfrage starten" gebeten, ein passendes Fachobjekt auszuwählen, mit dem in das Formular gestartet werden soll.
Der technische Name und Überschrift in der Oberfläche lauten “Arbeitgeber”
Das Fachobjekt “Arbeitgeber” steht in Beziehung mit einem Fachobjekt “Arbeitnehmer” (Partner-Fachobjekt)
Das Fachobjekt soll nicht verändert werden können, und ist daher schreibgeschützt
Bei der Initialisierung des Arbeitgebers werden Daten aus ams übernommen (Synchronisierung)
"Synchronisierung": Steuert den Datenfluss, d.h. ob die Daten in das Formular geladen und wieder ins ams zurückgespielt werden.
Wo finde ich Details zu den Beziehungen zwischen zwei Fachobjekten?
Sie können in ams6 über den Dialog “Beziehung erstellen” nach Beziehungen suchen:
Dann legen Sie den Arbeitnehmer mithilfe des “Fachobjekt hinzufügen” Buttons an.
… und füllen damit die “andere” Seite der Beziehung aus:
Der Arbeitnehmer wird in ams neu angelegt, deswegen ist die Auswahl der “Eingabe” bei der Anlage des forms⁺ nicht erlaubt, und die Synchronisierung der Daten ist nur in Richtung ams möglich.
Das Feld “Fachobjekt ist Partner in der Beziehung” sagt Ihnen, dass der Arbeitnehmer auf der “rechten” Seite der Beziehung.
Des Weiteren müssen Sie dem Anwender nun noch ermöglichen, eine Geschäftsadresse auszuwählen. Dafür benötigen Sie eine Liste der Adressen. Klicken Sie dazu auf das“+“ Symbol, und füllen die Felder entsprechend aus.
Es wird ein untergeordnetes Fachobjekt angelegt. Dies erkennen Sie ebenfalls am Namen (verbunden mit der Tilde “~“).
Mehrfacherfassung bedeutet, das Fachobjekt kommt mehrmals in forms⁺ vor (Liste).
Analog dazu legen Sie nun die Adressenauswahl an.
Klicken Sie auf “Speichern”, um Ihre Änderungen zu sichern.
Als nächstes gestalten Sie den Bereich des Arbeitgebers.
Löschen Sie dazu zunächst die existierenden Seiten mit dem “x” Symbol, und fügen dann eine neue Seite mit dem Button “Seite hinzufügen” hinzu.
Als nächsten Schritt müssen Sie die Eigenschaft “Zusammenfassung” aktivieren, damit Ihre forms⁺-Seite am Ende auch den “Übermitteln“ Button erhält.
Klicken Sie dann auf die “Gruppe” im Fragenbaum, und setzen die Eigenschaften im rechten Panel:
Hier können Sie die Überschrift angeben, einen Namen, sowie ein Symbol auswählen.
Geben Sie dann im Filter “Partnername” ein, und wählen den Knoten unter dem Arbeitgeber aus. Das neue Feld wird dann automatisch in die Gruppe eingefügt.
Sollte das Feld nicht in der Gruppe erscheinen, war es nicht richtig ausgewählt.
Ändern Sie dann die Überschrift auf “Name”. Damit haben Sie ein Feld im forms⁺ definiert, das automatisch bei der Anlage gefüllt wird (siehe Synchronisierung oben).
Entfernen Sie den Filter in den Fachobjekten und klicken Sie auf die Echtzeitabfrage. Am Rand können Sie die Abfrage verkleinen und in den oberen Bereich verschieben (drag & drop).
Geben Sie der Echtzeitabfrage die Überschrift “Geschäftsadresse“, klicken Sie auf die Auswahlmöglichkeiten und geben Sie folgende Optionen ein:
Die Quellentität bestimmt die angeboten Liste, die Zielentität ermöglicht, Daten aus der Selektion zu nutzen. Mit dem Anzeigefeld “__%Ort%__, __%Strasse%__“ können Sie die Darstellung der Listeneinträge definieren. Mit dem Wertfeld können Sie entscheiden, welches Merkmal der Adresse in Ihren Daten gespeichert werden soll.
forms⁺ testen
Jetzt ist der Moment gekommen, Ihre Arbeit auszuprobieren!
Geben Sie in der Versionsbeschreibung eine Beschreibung ein und klicken Sie auf den “Speichern” Button.
In der Versionverwaltung erscheint jetzt eine neue Version.
Mit jedem Speichern wird eine neue Version angelegt. Eine aussagekräftige Beschreibung vereinfacht Ihnen die Orientierung über die Veränderungen des forms⁺.
Klicken Sie dann auf den “Veröffentlichen” Button, um die Version zu aktivieren. Sie können beliebige ältere/neuere Version aktivieren. Mit dem “Bearbeiten” Button können Sie die Arbeit am gewünschten Stand fortsetzen.
Testen Sie Ihren Zwischenstand:
In der forms-Administration legen Sie dazu einen neuen forms-Vorgang mit einer Firma mit Geschäftsanschriften wie abgebildet an.
Klicken Sie auf “forms starten”. Bei einer sehr langen Liste von Vorgängen können Sie den Suchfilter verwenden.
Sie sollten den Namen Ihrer Auswahl und die Geschäftsadressen sehen.
Jetzt setzen Sie die Arbeit am forms⁺ selbst fort mit dem Arbeitnehmer. Dieser erhält jetzt auch noch eine Adresse beim Arbeitgeber. Dafür legen Sie das Fachobjekt “Arbeitnehmer~Kontakt” an. Damit haben Sie nun alle Fachobjekte angelegt.
Der Kontakt entspricht der Adresse in den Beziehungen:
Fügen Sie diese Felder dem forms⁺ hinzu. Sie können nach dem Feldernamen im Fachobjekte Baum suchen.
Bitte passen Sie die Überschriften für Telefonnummer und E-Mail-Adresse an. Die Felder für PLZ, Ort und Straße dürfen nicht verändert werden, setzen Sie diese bitte auf schreibgeschützt.
Damit haben Sie alle sichtbaren Felder definiert. Öffnen Sie jetzt öffnen die Vorschau und geben einige Werte ein.
Diese Ansicht ermöglicht Ihnen, die Maske im Anwendermodus zu sehen. Weiterhin können Sie mit einem Klick auf “Daten” die innere Struktur der Laufzeit-Daten sehen:
Hier sehen Sie nun, dass es keine Adressdaten gibt.
Sie haben oben bereits die Fachobjekte “Adressen” und “Adressenauswahl” definiert, um die Auswahl der Geschäftsanschrift zu ermöglichen. Jetzt werden die Adressdetails aus der Adressenauswahl in den Kontakt übertragen.
Dies geschieht über versteckten Komponenten, die Sie in einer neuen versteckten Hilfsmittel-Seite anlegen. Klicken Sie wieder auf den “Seite Hinzufügen” Button und setzen die Eigenschaften der Seite.
Fügen Sie der Seite diese Felder hinzu.
In den Auswahlmöglichkeiten des Felds “Status “setzen Sie nun “Mitarbeiter” als vorbelegten Wert.
Damit wird der neue “Kunde” zum Mitarbeiter.
Mit den anderen drei Feldern haben Sie dafür gesorgt, dass bei der Auswahl einer Geschäftsadresse die PLZ, Ort und Straße in unserer Datenstruktur gespeichert werden. Jetz müssen Sie diese Werte noch in die (für Anwender schreibgeschützten) Felder auf der Seite 1 übertragen.
Dafür setzen Sie eine Berechnunlogik ein. Klicken Sie auf Berechnunglogik der PLZ.
Im Dialog klicken Sie zunächst auf den “Wert aus anderer Frage” Button, und wählen dann “Arbeitgeber~Adressenauswahl~Plz” aus. Damit haben Sie eine Regel erstellt, die bei jeder Änderung der “Arbeitgeber~Adressenauswahl~Plz” den Wert in das Feld "Arbeitnehmer~Kontakt~Plz" überträgt. Damit kann der Anwender beliebig oft die Geschäftsadresse im forms⁺ ändern.
Wiederholen Sie dieses Vorgehen auch für den Ort und die Straße, und legen Sie die Regeln hier analog an.
Jetzt speichern und veröffentlichen Sie das forms⁺ (wie oben beschrieben). Suchen Sich eine Firma in ams6 aus und klicken auf den “Formularabfrage starten” Button rechts.
Wählen Sie Ihr neues forms⁺ aus.
Klicken Sie auf speichern, und es öffnet sich ein neuer Vorgang mit dem Link zur collaboration.
Sie können jetzt die Daten eingeben und mit dem “Übermitteln” Button die Daten in ams6 absenden.
Die Daten werden nun in ams6 angepasst.
Video
Ein kurzes Video, das die Anlage eines forms⁺ aus ams6 heraus zeigt, können Sie hier ansehen:
Noch Fragen? Ist etwas unklar geblieben?
Sollten Sie noch weitere Fragen zu diesem Thema haben, die in diesem Artikel nicht behandelt oder erklärt wurden, wenden Sie sich gerne über unser Kundenportal an unseren Support.