Dieser Guide erklärt Ihnen, wie Sie eine Dynamic Form Vorlage erstellen können und diese an einem Beispiel Service hinterlegen. Zusätzlich wird Ihnen erklärt, wie Sie das Dynamic Form als Service Formular für den Service nutzen können und wie dieses Formular in der Katalog Ansicht genutzt werden kann. Für den Service wird ein Beispiel Bereitstellungsworkflow erstellt, welcher die Dynamic Form ID holt und mit Hilfe der Dynamic Forms Workflow Activities Werte aus dem Dynamic Form zieht. Die ausgelesenen Werte werden in die Beschreibung einer neu erstellten Aufgabe geschrieben.
Dynamic Form Vorlage
Zuerst wird die Dynamic Form Vorlage für den Service erstellt. In unserem Beispiel wollen wir eine Dynamic Form Vorlage für den Service Demo Sharepoint-Zugriff erstellen. Bei der Bestellung des Service wollen wir die Felder Ordner, Zugriffsrechte und die Nutzer befüllen können. Zur Erstellung der Vorlage gehen Sie in die Applikation Administration und navigieren Sie zu der Ansicht Dynamic Form Vorlagen. Klicken Sie dort auf die Aktion Dynamic Form Vorlage hinzufügen.
Vergeben Sie der Vorlage den Namen Demo Template Sharepoint Access. Die Checkbox Relationiertes Objekt Erforderlich bleibt aktiviert, damit Dynamic Forms ohne Relation zu einem Service Form durch die Engine Labtagon Dynamic Forms – Clean Up Dynamic Forms gelöscht werden. Genaueres zur Engine finden Sie hier unter Clean Up Dynamic Forms.
Anschließend fügen wir die erste Felddefinition hinzu. Ziehen Sie dazu das Control Text von links nach rechts in das Layout. Diese Felddefinition wird für die Hinterlegung des Ordners genutzt. Die Konfigurationen finden Sie rechts in dem Konfigurationspanel, welches sich bei Klick auf eine Felddefinition öffnet. Konfigurieren Sie die Felddefinition, wie im Bild zu sehen. Sie können zusätzlich eine Beschreibung hinzufügen, welche als Hilfetext an dem Feld im Dynamic Form gezeigt wird.
Als nächstes wollen wir angeben können, welche Nutzer für diesen Ordner berechtigt werden sollen. Ziehen Sie das Control Objektwähler unter die Ordner-Felddefinition. Vergeben Sie hier die allgemeinen Konfigurationen wie folgt:
- Technischer Name: users
- Titel: Nutzer
- Erforderlich: Wahr
Wechseln Sie auf den Tab Erweitert in dem Konfigurationspanel. Geben Sie bei Datendefinition die SPSUserClassBase an. Hinterlegen Sie den Typ SPSUserType, um den Typ auf die Person zu beschränken. Wir wollen in dem Dynamic Form mehrere Nutzer zeitgleich in das Formular eintragen können, weshalb wir die Checkbox Mehrere Objekte auswählbar aktivieren. Optional könnten Sie den Anzeigenamen ändern, indem Sie eine alternative Datenquellenspalte auswählen, andernfalls wird der Anzeigeausdruck des Objektes genutzt. Des Weiteren könnte Sie über den Filter Ausdruck die Objekte mit Hilfe von ASQL filtern. Im Spalten Ausdruck geben Sie Mailaddress an. Dadurch wird die Email Adresse der Person als Wert im Feld gespeichert, anstelle der Fragment ID aus der SPSUserClassBase. Die erweiterten Konfigurationen sollten bei Ihnen folgendermaßen aussehen.
Fügen Sie das Control Pickup in das Layout hinzu. Vergeben Sie der letzten Felddefinition den technischen Namen accessRights und als Titel hinterlegen Sie Zugriffsrechte. Markieren Sie diese Felddefinition als erforderlich. Wechseln Sie zu dem Tab Erweitert und klicken Sie auf die Lupe bei Pickup.
Klicken Sie im Anschluss auf das +, um ein neues Dynamic Forms Pickup zu erstellen.
Vergeben Sie dem Pickup den Namen Zugriffsrechte. Erstellen Sie über das + drei Werte für das Pickup. Die Position bestimmt die Reihenfolge der Werte, welche angezeigt werden sollen. Entnehme die Werte anhand der Tabelle.
| Wert | Position | Anzeigeausdruck |
|---|---|---|
| 0 | 0 | Lesen |
| 1 | 1 | Schreiben |
| 2 | 2 | Alle |
Speichern und schließen Sie den Dialog.
Wenn Sie dies durchgeführt haben, landen Sie wieder im Dialog der Vorlage und das erstellte Pickup wurde vor belegt. Sie können als Standardwert das Zugriffsrecht Lesen hinterlegen.
Zuletzt muss die Vorlage gespeichert und geschlossen werden.
Dynamic Form Vorlagen Verknüpfung im Service Dialog einrichten
Falls Sie diesen Schritt durch den Schnellstart Guide bereits erledigt haben, können Sie diesen Schritt überspringen.
Bleiben Sie in der Applikation Administration und wechseln Sie zur Ansicht der Dialoge über Benutzeroberfläche > Layout Vorlagen. Suchen Sie nach dem Dialog Service Dialog und klicken Sie in der Schnellansicht auf die Aktion Layout ändern.
Im Layout Designer wechseln Sie zuerst in die Ansicht Bereitstellung. Im Datenmodell des Layout Designers suchen Sie nach DynamicFormTemplate. Ziehen Sie die Eigenschaft DynamicFormTemplate aus der Quelle SPSArticleTypeService > SPSArticleClassBase in das Layout. Es soll ein Objektwähler erstellt werden. Dieser ist bereits vorausgefüllt, anhand der Eigenschaft DynamicFormTemplate. Veröffentlichen oder Speichern Sie den Dialog.
Erstellen des Bereitstellungsworkflows für den Service
Bleiben Sie in der Administration und wechseln Sie zum Navigationselement Workflow Studio unter Dienste & Prozesse. Klicken Sie in der Landing Page auf den Button Workflow Studio, um das Workflow Studio zu öffnen. Erstellen Sie im Workflow Studio einen neuen Workflow basierend auf den Create Task – Provisioning WF.
Wenn Sie auf Create geklickt haben, öffnet sich ein Assistent zum Hinterlegen des Workflow Namen. Geben Sie bei Name Demo Sharepoint Access Provisioning Workflow an. Klicken Sie anschließend auf Speichern, um in die Layout Ansicht des Workflow Studios zu gelangen.
Klicken Sie im Layout auf die Workflow Activity Get Booking Data und bearbeiten Sie diese über die drei Punkte, rechts neben Data Definition.
Fügen Sie einen neue Ausgabe-Variable hinzu.
Wählen Sie ID des RelatedLabtagonDynamicForms aus. Sie finden RelatedLabtagonDynamicForms unter SimpleServiceForm. Erstellen Sie, wie im unterem Abschnitt zu sehen, eine neue Variable über die Aktion Create Variable und nennen Sie diese dynamicFormId. Klicken Sie auf OK und bestätigen Sie den Assistent Configure Get Data activity.
Gehen Sie links in die Navigation unter Labtagon und öffnen Sie den Ordner Dynamic Forms. Ziehen Sie die Workflow Activity GetFieldValue und GetFieldValues zwischen dem Switch und der Create Install Task Workflow Activity in das Layout, wie im Video zu sehen. Die Workflow Activity GetFieldValue ist vom Typ System.String, da wir mit dieser Workflow Activity den Ordner separat holen wollen.
Bevor die Argumente der Workflow Activities befüllt werden, müssen die Ausgabe-Variablen definiert werden. Klicke oben im Menü auf Variablen und fügen Sie zwei neue Variablen ein. Die Variablen werden folgendermaßen konfiguriert.
- outputFolder: System.String
- outputFieldValues: ArrayOf<Labtagon.M42.DynamicForms.Contracts.DataContracts.FieldValueObject>
Befüllen Sie die Argumente der Workflow Activities wie folgt.
GetFieldValueActivity:
- Dynamic Form ID: dynamicFormId
- Field Definition Technical Name: „folder“
- Value: outputFolder
GetFieldValuesActivity:
- Dynamic Form ID: dynamicFormId
- Value: outputFieldValues
Bearbeiten Sie die Beschreibung der Workflow Activity Create Install Task.
In dem Assistent wählen Sie Type Expression aus und geben Sie folgendes Visual Basic ein. Dies dient dazu, die Beschreibung der zu erstellenden Aufgabe mit den Werten des Dynamic Form auszufüllen.
„Folder: “ & outputFolder & „<p>Field Values: “ & String.Join(„; „, outputFieldValues.Select(Function(obj) obj.TechnicalName & „: “ & obj.Value)) & „</p>“
Checken Sie den Workflow ein und veröffentlichen Sie ihn.
Konfigurieren des Service
Gehen Sie in die Applikation Service Katalog und navigieren Sie zu Services über Service Katalog > Services. Suchen Sie den Service Demo Sharepoint-Zugriff und bearbeiten Sie diesen. Konfigurieren Sie die gewünschte Dynamic Form Vorlage in der Ansicht Bereitstellung. Zusätzlich müssen Sie unter Formular für Self Service Portal das Service Form (LABTAGONDFServiceFormType) hinterlegen. In der Ansicht Bereitstellung können Sie den erstellten Workflow in das Feld Bereitstellungsworkflow hinterlegen. Speichern Sie den Service.
Dynamic Forms Button in Self Service Portal Katalog Ansicht einbinden
Diesen Schritt können Sie überspringen, wenn Sie Ihn bereits durch den Schnellstart Guide implementiert haben.
Gehen Sie in der Administration unter Datenquellen und bearbeiten Sie die Datenquelle Catalog_Services.
Fügen Sie zwei Spalten hinzu, indem Sie auf das + klicken. Es öffnet sich ein Assistent zum Bearbeiten der Spalte. Tragen Sie folgende Werte für die einzelnen Spalten ein und speichern Sie die Datenquelle. Die Spalten werden für den Control Deskriptor Zum Warenkorb hinzufügen von Dynamic Forms benötigt.
| Ausdruck | Name | Titelart | Breite | Anzeige |
|---|---|---|---|---|
| CustomFormEntityId | CustomFormEntityId | Kein Titel | 100 | Kein(e) |
| CustomFormEntityName | CustomFormEntityName | Kein Titel | 100 | Kein(e) |
Anschließend navigieren Sie in der Administration über Benutzeroberfläche > Layout Vorlagen zu den Datenlisten. Bearbeiten Sie das Layout der Datenliste Catalog Services Tiles (Self Service Portal).
Entfernen Sie den Dem Warenkorb hinzufügen Button. Fügen Sie den Dynamic Forms: Dem Warenkorb hinzufügen Button ein. Konfigurieren Sie den Button, wie im Video zu sehen oder anhand der Hilfetexte. Achten Sie darauf, dass Sie alle Eigenschaften im Model setzen. Wenn Sie den Button zentriert anzeigen lassen wollen, aktivieren Sie die Checkbox Zentrieren. Speichern und veröffentlichen Sie die Datenliste.
Bestellen eines Service mit Dynamic Forms
Sie haben alle Konfigurationsschritte erledigt. In diesem Abschnitt wird Ihnen erklärt, wie Sie die Dynamic Forms in der Katalog Ansicht im Self Service Portal nutzen können. In diesem Guide wurde eine Dynamic Form Vorlage für den Service Demo Sharepoint Zugriffsrechte erstellt. Diesen Service können Sie in der Applikation Self Service Portal über das Navigationselement Katalog > Services bestellen. Wie Sie im Bild bereits sehen, wird Ihnen, statt des Zum Warenkorb hinzufügen Buttons, an dem Service ein Formular gezeigt. Dieses Formular (Dynamic Form) können Sie mit Beispiel Daten befüllen und im Anschluss zum Warenkorb hinzufügen.
Im folgenden Video wird demonstriert, wie der Service zum Warenkorb hinzugefügt wurde. Das Formular kann in der Warenkorbansicht für Services mit konfigurierten Dynamic Forms weiterhin bearbeitet werden. Der Dialog für das Service Formular wird für diese Services in der Warenkorbansicht ausgeblendet.
Da dieser Service in unserem Fall eine Genehmigung erfordert, müssen Sie zurück in die Applikation Service Katalog. Navigieren Sie zu den Bestellungen und führen Sie an Ihrer Bestellung die Aktion Genehmigung abschließen aus.
Gehen Sie anschließend unter Zusammenarbeit > Aufgaben zu der Aufgabe, welche durch den Bereitstellungsworkflow erstellt wurde. In der Schnellansicht der Aufgabe werden die Feldwerte des Dynamic Form angezeigt.
