Skip to main content

Dynamic GUI Editor

The Dynamic GUI Editor is a tool of the SCCM Manager. It is used to configure dynamically generated user interfaces for certain plugins. These include the Client Creator Plugin, Reset Computer Plugin and the Custom Inventory Plugin. This allows the content and function of other elementscontrols to be specifically designed and controlled.

Table of contents
Update

Configuration






Update

The Dynamic GUI Editor is supplied with the SCCM Manager installation. When installing a newer version, only the files need to be exchanged.

The Dynamic GUI Editor files are by default located under:
"C:\Program Files (x86)\smcTeam\SCCM Manager\Tools\DynamicGuiEditor".

image.png

The existing files must be replaced with the new files.

image.png

After the files have been exchanged, on the first start of the Dynamic GUI Editor a Microsoft Defender message may appear. Press the “Run Anyway” button to continue.

Layout

Configuration

The configurations should ideally not be changed and are set correctly by default.

image.png

image.png

Value Explanation Default Value
SqlConnectionString

This ConnectionString is used to establish the connection to the SCCM Manager database.

Server=localhost;Database=SccmManager;Trusted_Connection=True;TrustServerCertificate=True;
InstanceQuery

This Query is used to determine the different Instances in the SCCM Manager database.

SELECT DISTINCT Component, Name, InstanceName FROM ApplicationVariables WHERE Type = 'Dxml'
XmlDefinitionQuery

This Query is used to get the different Xml from the SCCM Manager database.

SELECT Value FROM ApplicationVariables WHERE Component = '{COMPONENT}' AND Name = '{NAME}' AND InstanceName = '{INSTANCE}'

 

Plugin

Requirements
Create New GUI

TheAfter starting the Dynamic GUI Editor isnew usedcontrols can be added to configurethe canvas to create a new GUI.

image.png

Deleting controls

Via the user"Delete" interface of these plugin,button the Clientselected Creatorelement Plugin,can Resetbe Computerdeleted Plugin andfrom the Customcanvas.

Inventory

image.png

Plugin.
Testing GUI

The pluginsGUI havecan specificbe requirements of element that needtested, to besee presenthow it will look in the GUI.

SCCM
Opening
and
PluginRequirements
Client Creator Plugin

OSDSelection - ComboBox
OSDomputerName - TextBoxManager.

MACAddressimage.png

-
Clear TextBoxAll

With the "Clear All" button all controls can be removed from the canvas.

SMBIOSGUID - TextBoximage.png

Reset Computer PluginOSDSelection - ComboBox
Custom Inventory Plugininv_number - TextBox

Dynamic GUI Editor

Saving

The user interfaces created with the Dynamic GUI Editor can be loaded and saved as a file or in the SCCM Manager database in the "ApplicationVariables" table.
The GUIs must be saved in the database in order to be used by the SCCM Manager.

image.png


 

Control Overview

In

ComboBoxes

the

ComboBoxesoverview all controls and there settings can be addedseen viaand the "Add" button.
selected.

image.png

The new ComboBox is created at the bottom.

image.pngimage.png

Name Explanation
Name The name used internally by the Dynamic GUI Editor

Friendly Name

The name that will be shown to the user
Enabled Determines if the element will be shown in the user interface 
Mandatory Determines if the element needs to be filled out
Read Only Determines if the element can be edited
Internal Elements marked as Internal are essential for the functionality of a plug-in. If these are deleted or their name is changed, the function of the respective plug-in can no longer be guaranteed.

If the element is not marked as internal the value will be created as a computer variable in SCCM
Description The text will be shown as tool tip when hovered over the element

 

Properties

The ComboBoxcontrols can be editedconfigured in the settings menu. There are some small differences in the settings between ComboBoxes and TextBoxes.
image.png         image.png

SettingExplanation
TypeIndicates whether the control is a ComboBox or a TextBox. Can not be changed
NameThe name used internaly by the Dynamic GUI Editor

FriendlyName

The name that will be shown to the user

Mask (TextBoxes only)

Masks can be defined under "General"Mask". tab.This defines the formats of the input fields.

ValidationRegex (TextBoxes only)

The validation regex can be used to limit the characters allowed in the input. 

Value (TextBoxes only)

The value will be pre-assigned
Item (ComboBox only)More information on ComboBox Items down below

IsEnabled

If True, the control can not be edited active/enabled
IsReadOnly

If True, the control can not be edited

IsVisbleIf True, the control will be shown in the user interface 
IsMandatoryIf True, the control the element needs to be filled out
IsInternal

Controls marked as "Internal" are essential for the functionality of a plug-in. If these are deleted or their name is changed, the function of the respective plug-in can no longer be guaranteed.

 

If the element is not marked as internal the value will be created as a computer variable in SCCM

DescriptionThe description text will be shown as tool tip when hovered over the element

 

ComboBox Items

ComboBoxes can have n-many ComboBox Items. The Items have their own properties and can be assigned rules.

image.png Ncyimage.png

 

ComboBox Items can have Rules assigned to them. Rules can be provided to further support user interaction.

image.png

In this example the ComboBox Item has a rule that will define the selectable Item from the ComboBox "Location".

Rule Explanation
ProcessType

Default

All

Action

With "Action" additional actions can be configured.

 

None - No additional action will be done

Enable - Enable the TargetInstance

Disable - Disable the TargetInstance

Show - Show the TargetInstance

Hide - Hide the TargetInstance

Set Read Only - Sets the TargetInstance to read only

Set Writeable - Sets the TargetInstance to writeable

TargetInstance The UI element that is target by the selection of the item, in tis case another ComboBox Named "Location". 
TargetItemFilter Used to limit the selection of antoher ComboBox, in this Example the ComboBox "Location", will only display the Items "Italy" and "Germany".
TargetItemInstance
TargetItemValue Can not be used via a ComboBox Item

TextBoxes

TextBoxes can be added via the "Add" button.

image.png

The new TextBox is created at the bottom.

image.png

Name Explanation
Name The name used internaly by the Dynamic GUI Editor

Friendly Name

The name that will be shown to the user
Enabled Determines if the element will be shown in the user interface 
Mandatory Determines if the element needs to be filled out
Read Only Determines if the element can be edited
Internal Elements marked as Internal are essential for the functionality of a plug-in. If these are deleted or their name is changed, the function of the respective plug-in can no longer be guaranteed.

If the element is not marked as internal the value will be created as a computer variable in SCCM
Description The text will be shown as tool tip when hovered over the element

The TextBox can be edited in the "General" tab. 

image.png

MaskPlugin Requirements

The Dynamic GUI Editor is used to configure the user interface of these plugin, the Client Creator Plugin, Reset Computer Plugin and the Custom Inventory Plugin. The plugins have specific requirements of controls that need to be present in the GUI.

PluginRequirements
Client Creator Plugin

OSDSelection - ComboBox
OSDomputerName - TextBox

MACAddress - TextBox

SMBIOSGUID - TextBox

Reset Computer PluginOSDSelection - ComboBox
Custom Inventory Plugininv_number - TextBox

 

 

Masks

Masks can be defined under "Mask". This defines the formats of the input fields.

Mask Property
A Alphanumeric or a special character, required.
a Alphanumeric or a special character, not required
L Letter, required. Restricts the input to the ASCII letters a-z and A-Z. This mask element is equivalent to [a-zA-Z] in regular expressions.
l Letter, not required
\ Breaks out a mask character and turns it into a literal. "\" is the escape sequence for a backslash.
All other characters (Literals) All non-mask elements are displayed in RadMaskedTextInput as themselves. Literals always take a static position in the mask at runtime and cannot be moved or deleted by the user.

More information at Telerik Mask Tokens.

An example of a mask for entering a MAC address:
AA-AA-AA-AA-AA-AA

Validation regex

The validation regex can be used to limit the characters allowed in the input. 

An example of a regex that allows only letters from A to F, for entering a MAC address:
^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$

TextBoxes can be assigned Rules.

image.png

In this example the TextBox "DigitalAlphaNummeric" has a rule that will give the TextBox "OSDComputerName" its value.

Rule Explanation
ProcessType
Action
TargetInstance The Element that will be targeted by the rule, in this case the TextBox "OSDComputerName".
Target Value

The TargetValue is the value that be will written in the target TextBox, in this Case it will be the combination from the "Location" and "Type" ComboBoxes and the value of the "DigitalAlphanummeric" TextBox.

Seperated by { }.

 

XML Definition

The underlying XML definition is a general format for describing configurable graphical interfaces within the SCCM Manager.
The following explains the structure of the configurationGUI filefor "ClientCreater_OSDVariables.xml"the Client Creator Plugin.

  • You can define n-many controls. Two types can currently be defined: “TextBox” and “ComboBox”.
  • A name must be defined for each control. This must be unique, may not contain any spaces and has three functions (in the example Client Creator).
    • Internal name of the control to be able to control it by rule.

    • Name of the computer variable.

    • Label of the control, if no FriendlyName was defined.

  • In addition, a FriendlyName can be defined, this then serves as a label in the GUI.

  • Each control can optionally contain a description tag. A description can be stored there, which is then displayed as a tooltip above the respective control.

  • Each control can have n-many items.

    • An item again needs a mandatory name and optionally a FriendlyName to represent it (otherwise the name is used automatically).

    • In a ComboBox, the item should also have a value. In the Client Creator example, this is the value of the computer variable.

    • The default item of a ComboBox can be set via the IsDefault attribute. Otherwise, none is initially selected.

    • Each item can have n-many rules. As soon as this item is selected later in the GUI, all rules assigned to it are applied.

      • A target is always defined in a rule, i.e. the name of the control that is to be influenced.

      • In addition, a TargetItem is defined, e.g. the item that is to be automatically selected in another ComboBox.

      • Optionally, a so-called action can also be defined. There are currently four different ones: "Show", "Hide", "Enable", "Disable". This can be used to additionally influence other controls.

  • A TextBox can also have additional attributes and tags.

    • A mask can be defined, for this the attributes "Mask "and "MaskType "can be set (see example).

    • An additional tag "ValidationRegex" can be added. This gives the TextBox the possibility to validate itself on user input.

    • Furthermore, a TextBox recognizes only its first item. This is absolutely necessary so that there is a value at all and to be able to access it via a rule, for example.

  • For custom plugins this system can also be used

Example configuration and the GUI generated from it

<Controls>
 <Control Type="ComboBox" Name="OSDSelection" FriendlyName="Operating System" IsEnabled="True" IsMandatory="False" IsVisible="True" IsInternal="True">
  <Items />
  <Description></Description>
 </Control>
 <Control Type="TextBox" Name="OSDComputerName" FriendlyName="Computer Name" IsEnabled="True" IsMandatory="True" IsVisible="True" IsInternal="True" IsReadOnly="False" Mask="">
  <ValidationRegex>^[A-Za-z0-9\-_]{3,15}$</ValidationRegex>
  <Items>
   <Item Name="Text" Value="" IsDefault="True" />
  </Items>
  <Description>The computer name (max. 15 characters).</Description>
 </Control>
 <Control Type="TextBox" Name="SMBIOSGUID" FriendlyName="BIOS Guid" IsEnabled="True" IsMandatory="False" IsVisible="True" IsInternal="True" IsReadOnly="False" Mask="">
  <ValidationRegex>^[{]?[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}[}]?$</ValidationRegex>
  <Items>
   <Item Name="Text" Value="" IsDefault="True" />
  </Items>
  <Description>The bios guid like 936DA01F-9ABD-4D9D-80C7-02AF85C822A8</Description>
 </Control>
 <Control Type="TextBox" Name="MACAddress" FriendlyName="MAC Address" IsEnabled="True" IsMandatory="False" IsVisible="True" IsInternal="True" IsReadOnly="False" Mask="">
  <ValidationRegex>^([0-9A-Fa-f]{2}[:-]?){5}([0-9A-Fa-f]{2})$</ValidationRegex>
  <Items>
   <Item Name="Text" Value="" IsDefault="True" />
  </Items>
  <Description>The mac address.</Description>
 </Control>
</Controls>
  • The ComboBox "Operating System" belongs internally to the Client Creator. It does not have predefined values but gets them from the query configured in the ClientCreatorPlugin. The ComboBox is internal.

  • The computer name as TextBox, also internal has a regular expression (ValidationRegex) that expects at least 3 and at most 15 characters, uppercase letters, lowercase letters, numbers, - and _ are allowed.

  • NetbiosThe domainTextbox as"BIOS ComboBox: the corresponding FQDNGuid" is automatically selectedneeded by the associatedclient rule.creator plugin but can be left empty if a MAC Address is entered instead. 
    The regex checks that the entered text is in an valid GUID format.

  • PrimaryMAC SiteAddress Server:is Therequired FriendlyName forby the controlclient creator plugin, but can be left empty if a SMBIOS GUID is PrimarySiterServer=ExampleSite01,entered butinstead.
    The actuallyregex theonly variableallows valuea ExampleSite01format willvalid beinput. chosen later. This is the same for the variable name, this will be set later as OSDPrimarySiteServer.

 

 

image.png