Mit Hilfe von diesem Guide können Sie den Control Deskriptor Labtagon Dynamic Form Editor in Ihrem Computer Dialog einbauen und im Anschluss nutzen. Falls Sie den Control Deskriptor in eine Schnellansicht einbauen wollen, finden Sie einen kurzen Guide dazu hier auf der Support Seite der Erweiterung Dynamic Forms.
Das Dynamic Form soll in dem Computer Dialog die Möglichkeit bieten den genaueren Standort des Computers zu hinterlegen.
Dynamic Form Vorlage
Für die Hinterlegung des genauen Standort des Computers wurde bereits eine Dynamic Form Vorlage erstellt. Sollten Sie Unterstützung bei der Dynamic Form Vorlage benötigen, schauen Sie sich gerne den Abschnitt Konfiguration auf der Support Seite von Dynamic Forms und den Abschnitt Dynamic Form Vorlage im Guide Nutzung der Dynamic Forms Vorlagen als Service Formulare an. Folgende Felddefinitionen wurden mit den jeweiligen Konfigurationen erstellt.
Felddefinitionen:
- location (Objektwähler)
- Technischer Name: location
- Titel: Standort
- Erforderlich: wahr
- Datendefinition: SPSLocationClassBase
- Filter Ausdruck: Name <> ‚Global‘
- building (Text)
- Technischer Name: building
- Titel: Gebäude
- Erforderlich: wahr
- Regulärer Ausdruck: [A-Z]
- Dadurch können nur die Buchstaben eines Gebäudes angegeben werden.
- roomNumber (Numerisch)
- Technischer Name: roomNumber
- Titel: Zimmernummer
- Erforderlich: wahr
- Format: Integer
Computer Dialog konfigurieren
Zur Integration des Labtagon Dynamic Form Editor Control Deskriptor in den Computer Dialog, gehen Sie zuerst in die Applikation Administration. Navigieren Sie zu den Dialogen über die Navigationselemente Benutzeroberfläche > Layout Vorlagen und klicken Sie oben auf den Tab Dialoge. Suchen Sie nach Computer Dialog. Öffnen Sie die Schnellansicht des Dialogs und führen Sie die Aktion Layout ändern aus, um in den Layout Designer zu gelangen.
In diesem Guide fügen wir eine neue Ansicht hinzu, um dort das Dynamic Form anzuzeigen. Sie können alternativ das Control in eine bereits vorhandene Ansicht hinzufügen. Zum Hinzufügen der neuen Ansicht klicken Sie auf Neue Ansicht hinzufügen. Vergeben Sie der neuen Ansicht den Titel Standort und den technischen Namen location. Optional können Sie die Position der Ansicht ändern.
Gehen Sie rechts in der Leiste auf die Toolbox und suchen Sie nach dem Control Labtagon Dynamic Form Editor. Ziehen Sie das Control in Ihre Ansicht.
Anschließend muss eine neue Eigenschaft dem Kontext hinzugefügt werden. In diese Eigenschaft wird, nach Beendigung der Konfiguration, die Fragment ID des Dynamic Form gespeichert. Dazu navigieren Sie in der rechten Leiste im Datenmodell zu Context und klicken Sie auf Context. Führen Sie die Aktion Eigenschaft hinzufügen aus.
Es sollte sich der Assistent Berechnetes Attribut konfigurieren geöffnet haben. Fügen Sie dort bei Feldname OutputDynamicFormFragmentID ein. Den Typ müssen Sie auf Guid ändern. Speichern Sie den Assistent.
Nun muss die Relation RelatedLabtagonDynamicForms in der Klasse SPSCommonClassBase angepasst werden. Dies dient dazu, dass der neue Computer mit dem Dynamic Form relationiert werden kann.
Diese Relation finden Sie in der SPSCommonClassBase und in der SvcServiceFormBase. Sollten Sie einen anderen Dialog bearbeiten, achten Sie darauf, dass das Konfigurationselement, welches bearbeitet wird, eine der beiden Datendefinitionen beinhaltet. Wenn dies nicht der Fall ist, kann kein Dynamic Form mit dem Objekt relationiert werden. Alternativ könnten Sie bei diesen Konfigurationselementen eine benutzerdefinierte Relation zu einem Dynamic Form (LABTAGONDFDynamicFormClassBase) erstellen und den Editor anhand der beschriebenen Konfigurationen auf der Support Seite unter Umfang der Lieferung konfigurieren.
In diesem Guide werden Computer bearbeitet. An dem SPSComputerType existiert die Datendefinition SPSCommonClassBase. Gehen Sie nun rechts über die Leiste in das Datenmodell und suchen Sie die Relation RelatedLabtagonDynamicForms. Bearbeiten Sie die Eigenschaft.
Es öffnet sich ein Assistent. Gehen Sie auf Erweiterter Modus und fügen Sie die zuvor erstellte Eigenschaft OutputDynamicFormFragmentID hinzu. Im Anschluss fügen Sie unter Ausdruck (JavaScript) folgendes JavaScript ein. Speichern Sie die Eigenschaft über den Speichern Button unten rechts.
Gehen Sie zurück in das Layout und bearbeiten Sie den Labtagon Dynamic Form Editor. Befüllen Sie die Eigenschaften wie folgt:
- Dynamic Form Vorlagen-ID: Fragment ID (LABTAGONDFDynamicFormTemplateClassBase) der erstellten Dynamic Form Vorlage. Sollten Sie Hilfe benötigen, um die Fragment ID der Vorlage herauszufinden, folgen Sie dem Abschnitt Fragment ID der Dynamic Form Vorlage herausfinden.
- Relationierte Objekt ID: SPSComputerType.ID
- Datendefinitionsname des relationierten Objektes: SPSCommonClassBase
- Relationiertes Objekt ist neu: SPSComputerType.IsNew
- Automatischen Speichern: True
- Schreibgeschützt: False
- Ausgabe: Dynamic Form Fragment ID: Context.OutputDynamicFormFragmentID
Speichern oder veröffentlichen Sie den Dialog.
Nutzung des Dynamic Form im Computer Dialog
Die Konfiguration ist mit den oben genannten Schritten abgeschlossen. Navigieren Sie in der Applikation Assets zu den Endgeräten und fügen Sie einen neuen Computer hinzu.
Vergeben Sie dem Computer einen Namen und wechseln Sie zu der Ansicht Standort. Befüllen Sie hier das Dynamic Form und speichern Sie den Computer.
Im Anschluss können Sie den Computer bearbeiten und sich das Dynamic Form erneut anschauen und bearbeiten. Zusätzlich könnten Sie den Labtagon Dynamic Form Editor in die Schnellansicht des Computer einbauen, um das Dynamic Form in der Schnellansicht zu sehen. Lesen Sie sich dazu den Abschnitt Nutzen des Dynamic Form Editors Control Deskriptor im Schnellstart-Guide durch.
Fragment ID der Dynamic Form Vorlage herausfinden
Gehen Sie in die Applikation Administration und navigieren Sie zu den Dynamic Form Vorlagen. Drücken Sie in Ihrem Browser F12 auf Ihrer Tastatur. Es öffnet sich das Webentwicklungstool. Klicken Sie dort auf den Tab Netzwerk und leeren Sie die Liste.
Lassen Sie das Webentwicklungstool offen und klicken Sie auf Ihre Dynamic Form Vorlage, um die Schnellansicht zu öffnen. Gehen Sie zu dem Webaufruf /m42services/api/WidgetCommon/GetData und wechseln Sie zur Vorschau. Klappen Sie dort Entity und LABTAGONDFDynamicFormTemplateClassBase auf. Kopieren Sie sich dort die ID ohne Anführungszeichen raus.
