@aryacode/dsh-engineering 0.5.0 → 0.7.0

package/vendor/optix/netlogic/pages/designtime-tags-import.md

@@ -0,0 +1,531 @@
+# Design time import of PLC tags
+
+This feature is only supported for TwinCAT and RA Ethernet/IP drivers, and allows you to programmatically import tags from a PLC project file. This can be useful in scenarios where you have to import a determined set of tags from a large PLC project, or when you want to automate the import process as part of your project setup.
+
+> [!NOTE]
+> This feature is only available at DesignTime, so it cannot be used in a running application.
+
+## TwinCAT
+
+>[!NOTE]
+> This feature is available starting from FactoryTalk Optix 1.7.x
+
+To import tags from a TwinCAT PLC, you can use the `TwinCAT` driver. The import process allows you to filter tags based on specific criteria, such as tag name or data type.
+
+```csharp
+#region Using directives
+using System;
+using UAManagedCore;
+using OpcUa = UAManagedCore.OpcUa;
+using FTOptix.UI;
+using FTOptix.HMIProject;
+using FTOptix.NativeUI;
+using FTOptix.Retentivity;
+using FTOptix.CoreBase;
+using FTOptix.Core;
+using FTOptix.NetLogic;
+using FTOptix.TwinCAT;
+using FTOptix.CommunicationDriver;
+using static UAManagedCore.TagImporterAPI;
+using System.Threading.Tasks;
+#endregion
+
+public class DesignTimeNetLogic1 : BaseNetLogic
+{
+    [ExportMethod]
+    public void OfflineImport()
+    {
+        // First get the existing TwinCAT station from the project
+        var station = Project.Current.Get<FTOptix.TwinCAT.Station>("CommDrivers/TwinCATDriver1/TwinCATStation1");
+
+        // Then get the tag importer node from the station
+        var tagImporter = station.TagImporter;
+
+        // Set the file path to the TwinCAT TPY file you want to import
+        tagImporter.FilePath = ResourceUri.FromAbsoluteFilePath("D:\\test\\Optix\\Tools\\TwinCAT\\tpy\\AllSimpleType.tpy");
+        tagImporter.Mode = FetchMode.Offline;
+
+        // Fire and forget, import is run in a background thread
+        _ = tagImporter.Import();
+    }
+
+    [ExportMethod]
+    public void OfflineImportWithContinuation()
+    {
+        var station = Project.Current.Get<FTOptix.TwinCAT.Station>("CommDrivers/TwinCATDriver1/TwinCATStation1");
+        var tagImporter = station.TagImporter;
+
+        tagImporter.FilePath = ResourceUri.FromAbsoluteFilePath("D:\\test\\Optix\\Tools\\TwinCAT\\tpy\\AllSimpleType.tpy");
+        tagImporter.Mode = FetchMode.Offline;
+
+        // Import is started in a background thread,
+        // continuation is run in the current thread after the import is completed
+        var task = tagImporter.Import(Filter);
+        task.ContinueWith((t) =>
+        {
+            if (t.IsFaulted)
+            {
+                Log.Error("Import task failed: " + t.Exception?.GetBaseException().Message);
+            }
+            else if (t.IsCanceled)
+            {
+                Log.Info("Import task was canceled.");
+            }
+            else
+            {
+                Log.Info("Import task completed successfully.");
+            }
+        });
+    }
+
+    [ExportMethod]
+    public void OnlineImport()
+    {
+        var station = Project.Current.Get<FTOptix.TwinCAT.Station>("CommDrivers/TwinCATDriver1/TwinCATStation1");
+        var tagImporter = station.TagImporter;
+
+        tagImporter.Mode = FetchMode.Online;
+        _ = tagImporter.Import(Filter);
+    }
+
+
+    private bool Filter(string tag, string type)
+    {
+        // Filter by tag name
+        return tag.Contains("int");
+
+        // or
+
+        // Filter by type
+        // return type == "INT";
+    }
+}
+```
+
+An example of TPY file that can be used for testing:
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<PlcProjectInfo>
+   <ProjectInfo>
+      <Path>C:\Users\asem\Desktop\TestTwinCAT\TwinCAT Project1\TwinCAT Project1\Untitled1\Untitled1.plcproj</Path>
+      <ChangeDate>2018-02-11T04:39:01</ChangeDate>
+      <Library>
+         <Name>tc2_standard, 3.3.2.0 (beckhoff automation gmbh)</Name>
+      </Library>
+      <Library>
+         <Name>tc2_system, 3.4.17.0 (beckhoff automation gmbh)</Name>
+      </Library>
+      <Library>
+         <Name>tc3_module, 3.3.17.0 (beckhoff automation gmbh)</Name>
+      </Library>
+   </ProjectInfo>
+   <RoutingInfo>
+      <AdsInfo>
+         <NetId>172.17.17.35.1.1</NetId>
+         <Port>851</Port>
+         <TargetName>Untitled1</TargetName>
+      </AdsInfo>
+   </RoutingInfo>
+   <CompilerInfo>
+      <CpuFamily>Intel X86</CpuFamily>
+      <CompilerVersion>3.5.10.20</CompilerVersion>
+      <TwinCATVersion>3.4.0.0</TwinCATVersion>
+      <TCatPlcCtrlVersion>3.4.0.0</TCatPlcCtrlVersion>
+   </CompilerInfo>
+   <TargetInfo>
+      <CpuFamily>Intel X86</CpuFamily>
+      <DataAreaInfo>
+         <DataSize>10485760</DataSize>
+         <RetainSize>128000</RetainSize>
+         <MAreaSize>128000</MAreaSize>
+         <InputSize>128000</InputSize>
+         <OutputSize>128000</OutputSize>
+      </DataAreaInfo>
+   </TargetInfo>
+   <DataTypes>
+   </DataTypes>
+   <Symbols>
+      <Symbol>
+         <Name>MAIN.VarBit</Name>
+         <Type>BIT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512508</IOffset>
+         <BitSize>8</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarDateAndTime</Name>
+         <Type>DATE_AND_TIME</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512512</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarLTime</Name>
+         <Type>LTIME</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512520</IOffset>
+         <BitSize>64</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarTime</Name>
+         <Type>TIME</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512528</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarTod</Name>
+         <Type>TOD</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512532</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarDate</Name>
+         <Type>DATE</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512536</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarDT</Name>
+         <Type>DT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512540</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarBool</Name>
+         <Type>BOOL</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512594</IOffset>
+         <BitSize>8</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarByte</Name>
+         <Type>BYTE</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>512595</IOffset>
+         <BitSize>8</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarDint</Name>
+         <Type>DINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536300</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarDword</Name>
+         <Type>DWORD</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536304</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarInt</Name>
+         <Type>INT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536308</IOffset>
+         <BitSize>16</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarSint</Name>
+         <Type>SINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536310</IOffset>
+         <BitSize>8</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarUsint</Name>
+         <Type>USINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536311</IOffset>
+         <BitSize>8</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarLint</Name>
+         <Type>LINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536312</IOffset>
+         <BitSize>64</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarLreal</Name>
+         <Type>LREAL</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536320</IOffset>
+         <BitSize>64</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarLWord</Name>
+         <Type>LWORD</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536328</IOffset>
+         <BitSize>64</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarReal</Name>
+         <Type>REAL</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536336</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarUint</Name>
+         <Type>UINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536422</IOffset>
+         <BitSize>16</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarTimOfDay</Name>
+         <Type>TIME_OF_DAY</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536424</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarUdint</Name>
+         <Type>UDINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536428</IOffset>
+         <BitSize>32</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarUlint</Name>
+         <Type>ULINT</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536432</IOffset>
+         <BitSize>64</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarWord</Name>
+         <Type>WORD</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536440</IOffset>
+         <BitSize>16</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarWstring</Name>
+         <Type>WSTRING(80)</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>536442</IOffset>
+         <BitSize>1296</BitSize>
+      </Symbol>
+      <Symbol>
+         <Name>MAIN.VarString</Name>
+         <Type Decoration="40000050">STRING(80)</Type>
+         <IGroup>16448</IGroup>
+         <IOffset>537880</IOffset>
+         <BitSize>648</BitSize>
+      </Symbol>
+	</Symbols>
+</PlcProjectInfo>
+```
+
+## RA Ethernet/IP
+
+>[!NOTE]
+> This feature is available starting from FactoryTalk Optix 1.8.x
+
+To import tags from an Allen-Bradley PLC, you can use the `RA EtherNetIP` driver. The import process allows you to filter tags based on specific criteria, such as tag name or data type.
+
+```csharp
+#region Using directives
+using System;
+using UAManagedCore;
+using OpcUa = UAManagedCore.OpcUa;
+using FTOptix.UI;
+using FTOptix.HMIProject;
+using FTOptix.NativeUI;
+using FTOptix.Retentivity;
+using FTOptix.CoreBase;
+using FTOptix.Core;
+using FTOptix.NetLogic;
+using FTOptix.RAEtherNetIP;
+using FTOptix.CommunicationDriver;
+using static UAManagedCore.TagImporterAPI;
+using System.Threading.Tasks;
+#endregion
+
+public class DesignTimeNetLogic1 : BaseNetLogic
+{
+    [ExportMethod]
+    public void OfflineImport()
+    {
+        // First get the existing RA EtherNet/IP station from the project
+        var station = plcStation;
+
+        // Then get the tag importer node from the station
+        var tagImporter = station.TagImporter;
+
+        // Set the file path to the L5X file you want to import
+        tagImporter.FilePath = filePath;
+        tagImporter.Mode = FetchMode.Offline;
+
+        // Fire and forget, import is run in a background thread
+        _ = tagImporter.Import();
+    }
+
+    [ExportMethod]
+    public void OfflineImportWithContinuation()
+    {
+        var station = plcStation;
+        var tagImporter = station.TagImporter;
+
+        tagImporter.FilePath = filePath;
+        tagImporter.Mode = FetchMode.Offline;
+
+        // Import is started in a background thread,
+        // continuation is run in the current thread after the import is completed
+        var task = tagImporter.Import(Filter);
+        task.ContinueWith((t) =>
+        {
+            if (t.IsFaulted)
+            {
+                Log.Error("Import task failed: " + t.Exception?.GetBaseException().Message);
+            }
+            else if (t.IsCanceled)
+            {
+                Log.Info("Import task was canceled.");
+            }
+            else
+            {
+                Log.Info("Import task completed successfully.");
+            }
+        });
+    }
+
+    [ExportMethod]
+    public void OnlineImport()
+    {
+        var station = plcStation;
+        var tagImporter = station.TagImporter;
+
+        tagImporter.Mode = FetchMode.Online;
+        _ = tagImporter.Import(Filter);
+    }
+
+    private bool Filter(string symbolName, string type)
+    {
+        // List of tags to import (supports partial path matching for parent/child nodes)
+        var tagsToImport = new string[]
+        {
+            "Motor.Status.Running",
+            "Integer_tag",
+        };
+
+        foreach (var tagToImport in tagsToImport)
+        {
+            if (IsTagToImport(symbolName, tagToImport))
+                return true;
+        }
+
+        return false;
+    }
+
+    private bool IsTagToImport(string symbolName, string tagToImport)
+    {
+        // Match if the symbol is an exact match, a parent, or a child of the target tag
+        return symbolName == tagToImport ||
+            tagToImport.StartsWith(symbolName) ||
+            symbolName.StartsWith(tagToImport);
+    }
+
+    private FTOptix.RAEtherNetIP.Station plcStation = Project.Current.Get<FTOptix.RAEtherNetIP.Station>("CommDrivers/RAEtherNetIPDriver1/RAEtherNet_IPStation1");
+    private ResourceUri filePath = ResourceUri.FromAbsoluteFilePath("D:\\test\\Optix\\Tools\\RAEtherNetIP\\controller.L5X");
+}
+```
+
+An example of L5X file that can be used for testing:
+
+```xml
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<RSLogix5000Content SchemaRevision="1.0" SoftwareRevision="38.00" TargetName="test" TargetType="Controller" ContainsContext="false" ExportDate="Wed Mar 11 10:37:10 2026" ExportOptions="NoRawData L5KData DecoratedData ForceProtectedEncoding AllProjDocTrans">
+<Controller Use="Target" Name="test" ProcessorType="1756-L81E" MajorRev="38" MinorRev="11" ProjectCreationDate="Wed Mar 11 10:35:13 2026" LastModifiedDate="Wed Mar 11 10:36:56 2026" SFCExecutionControl="CurrentActive" SFCRestartPosition="MostRecent" SFCLastScan="DontScan" ProjectSN="16#0000_0000"
+ MatchProjectToController="false" CanUseRPIFromProducer="false" InhibitAutomaticFirmwareUpdate="0" PassThroughConfiguration="EnabledWithAppend" DownloadProjectDocumentationAndExtendedProperties="true" DownloadProjectCustomProperties="true" ReportMinorOverflow="false" AutoDiagsEnabled="true" WebServerEnabled="false" DataExchangeId="{7815DD91-43A8-4001-B823-F3594DA6D3FC}">
+<RedundancyInfo Enabled="false" KeepTestEditsOnSwitchOver="false"/>
+<Security Code="0" ChangesToDetect="16#ffff_ffff_ffff_ffff"/>
+<SafetyInfo/>
+<DataTypes>
+<DataType Name="Motor" Family="NoFamily" Class="User">
+<Members>
+<Member Name="Status" DataType="Status" Dimension="0" Radix="NullType" Hidden="false" ExternalAccess="Read/Write"/>
+<Member Name="Speed" DataType="INT" Dimension="0" Radix="Decimal" Hidden="false" ExternalAccess="Read/Write"/>
+</Members>
+</DataType>
+<DataType Name="Status" Family="NoFamily" Class="User">
+<Members>
+<Member Name="ZZZZZZZZZZStatus0" DataType="SINT" Dimension="0" Radix="Decimal" Hidden="true" ExternalAccess="Read/Write"/>
+<Member Name="Running" DataType="BIT" Dimension="0" Radix="Decimal" Hidden="false" Target="ZZZZZZZZZZStatus0" BitNumber="0" ExternalAccess="Read/Write"/>
+<Member Name="Faulty" DataType="BIT" Dimension="0" Radix="Decimal" Hidden="false" Target="ZZZZZZZZZZStatus0" BitNumber="1" ExternalAccess="Read/Write"/>
+</Members>
+</DataType>
+</DataTypes>
+<Modules>
+<Module Name="Local" CatalogNumber="1756-L81E" Vendor="1" ProductType="14" ProductCode="164" Major="38" Minor="11" ParentModule="Local" ParentModPortId="1" Inhibited="false" MajorFault="true"
+>
+<EKey State="Disabled"/>
+<Ports>
+<Port Id="1" Address="0" Type="ICP" Upstream="false">
+<Bus Size="7"/>
+</Port>
+<Port Id="2" Type="Ethernet" Upstream="false">
+<Bus/>
+</Port>
+</Ports>
+</Module>
+</Modules>
+<AddOnInstructionDefinitions/>
+<Tags>
+<Tag Name="Integer_tag" TagType="Base" DataType="DINT" Radix="Decimal" Constant="false" ExternalAccess="Read Only" OpcUaAccess="None">
+<Data Format="L5K">
+<![CDATA[0]]>
+</Data>
+<Data Format="Decorated">
+<DataValue DataType="DINT" Radix="Decimal" Value="0"/>
+</Data>
+</Tag>
+<Tag Name="Motor1" TagType="Base" DataType="Motor" Constant="false" ExternalAccess="Read Only" OpcUaAccess="None">
+<Data Format="L5K">
+<![CDATA[[[0],0]]]>
+</Data>
+<Data Format="Decorated">
+<Structure DataType="Motor">
+<StructureMember Name="Status" DataType="Status">
+<DataValueMember Name="Running" DataType="BOOL" Value="0"/>
+<DataValueMember Name="Faulty" DataType="BOOL" Value="0"/>
+</StructureMember>
+<DataValueMember Name="Speed" DataType="INT" Radix="Decimal" Value="0"/>
+</Structure>
+</Data>
+</Tag>
+</Tags>
+<Programs>
+<Program Name="MainProgram" TestEdits="false" MainRoutineName="MainRoutine" Disabled="false" UseAsFolder="false">
+<Tags/>
+<Routines>
+<Routine Name="MainRoutine" Type="RLL"/>
+</Routines>
+</Program>
+</Programs>
+<Tasks>
+<Task Name="MainTask" Type="CONTINUOUS" Priority="10" Watchdog="500" DisableUpdateOutputs="false" InhibitTask="false" SynchronizeRedundancyDataDisabled="false">
+<ScheduledPrograms>
+<ScheduledProgram Name="MainProgram"/>
+</ScheduledPrograms>
+</Task>
+</Tasks>
+<CST MasterID="0"/>
+<WallClockTime LocalTimeAdjustment="0" TimeZone="0"/>
+<Trends/>
+<TimeSynchronize Priority1="128" Priority2="128" PTPEnable="false"/>
+<EthernetPorts>
+<EthernetPort Port="1" Label="1" PortEnabled="true"/>
+</EthernetPorts>
+<OpcUaInfo EnabledPorts=""/>
+</Controller>
+</RSLogix5000Content>
+```

package/vendor/optix/netlogic/pages/dialog-boxes.md

@@ -0,0 +1,150 @@
+# DialogBox
+
+DialogBoxes are windows that can be opened from a UI session to display additional information, gather user input, or provide configuration options. They are defined as `DialogType` objects in the project and can be opened using the `UICommands.OpenDialog()` method.
+
+> [!NOTE]
+> DialogBoxes can only be displayed at runtime.
+
+## Opening a DialogBox
+
+The `UICommands.OpenDialog()` method opens a dialog (modal window) and associates it with a specific UI session. It has two overloads:
+- `OpenDialog(IUANode parentItem, DialogType dialogType, NodeId aliasNode = null)` - opens a dialog and binds a single alias node
+- `OpenDialog(IUANode parentItem, DialogType dialogType, NodeId[] aliasNodes)` - opens a dialog and binds multiple alias nodes
+
+The `parentItem` must be a UI `Item` or `Window` to determine which session receives the dialog.
+
+### Basic Example
+
+```csharp
+[ExportMethod]
+public void OpenMyDialogBox()
+{
+    // Get the DialogBox type definition
+    var myDialogType = (DialogType)Project.Current.Get("UI/Templates/DialogBox1");
+    
+    // DialogBoxes need a graphical container as parent to bind to the correct session
+    var parentPanel = (FTOptix.UI.Panel)Owner;
+    
+    // Open the dialog without alias bindings
+    UICommands.OpenDialog(parentPanel, myDialogType);
+}
+```
+
+### Pass a Single Alias Node
+
+Alias nodes are OPC UA references that the dialog can use to access objects. This is useful for passing data or objects to the dialog.
+
+```csharp
+[ExportMethod]
+public void OpenDialogWithAlias()
+{
+    var dialogType = (DialogType)Project.Current.Get("UI/Templates/ConfigDialog");
+    var configObject = Project.Current.Get("Objects/CurrentConfig");
+    
+    // Bind a single alias node - the dialog can access it through the alias
+    UICommands.OpenDialog((FTOptix.UI.Panel)Owner, dialogType, configObject.NodeId);
+}
+```
+
+### Pass Multiple Alias Nodes
+
+You can pass an array of alias nodes to provide the dialog with access to multiple objects.
+
+```csharp
+[ExportMethod]
+public void OpenDialogWithMultipleAliases()
+{
+    var dialogType = (DialogType)Project.Current.Get("UI/Templates/DetailDialog");
+    var primaryData = Project.Current.Get("Objects/PrimaryData");
+    var secondaryData = Project.Current.Get("Objects/SecondaryData");
+    var settings = Project.Current.Get("Objects/Settings");
+    
+    // Create an array of alias nodes
+    NodeId[] aliasNodes = new NodeId[]
+    {
+        primaryData.NodeId,
+        secondaryData.NodeId,
+        settings.NodeId
+    };
+    
+    // Open the dialog with multiple alias bindings
+    UICommands.OpenDialog((FTOptix.UI.Panel)Owner, dialogType, aliasNodes);
+}
+```
+
+### Open a DialogBox on all sessions (native and web)
+
+```csharp
+[ExportMethod]
+public void OpenDialogBox(string DialogBoxName, NodeId[] AliasArray = null)
+{
+    DialogType dialogBox = (DialogType)Project.Current.Get($"UI/Screens/{DialogBoxName}");
+    
+    // Open dialog on Native Presentation Engine
+    var nativePresentationEngine = Project.Current.Get("UI/NativePresentationEngine");
+    var nativePresentationEngineSessions = nativePresentationEngine.Get("Sessions");
+    var nativePresentationEngineSession = nativePresentationEngineSessions.Children[0];   // Native PE only has one session, so get the first one
+    var nativePresentationEngineWindow = nativePresentationEngineSession.Get("UIRoot");
+    UICommands.OpenDialog(nativePresentationEngineWindow, dialogBox, AliasArray);
+    
+    // Open dialog on Web Presentation Engine (may have multiple sessions)
+    var webPresentationEngine = Project.Current.Get("UI/WebPresentationEngine");
+    var webPresentationEngineSessions = webPresentationEngine.Get("Sessions");
+    foreach (var webPresentationEngineSession in webPresentationEngineSessions.Children)
+    {
+        var webPresentationEngineWindow = webPresentationEngineSession.Get("UIRoot");
+        if (webPresentationEngineWindow != null)
+        {
+            UICommands.OpenDialog(webPresentationEngineWindow, dialogBox, AliasArray);
+        }
+    }
+}
+```
+
+## Closing a DialogBox
+
+### Close all DialogBoxes in the current session
+
+> [!TIP]
+> The following snippet must be placed in a session-based object (e.g. the `MainWindow` of a project).
+
+```csharp
+[ExportMethod]
+public void CloseAllDialogs()
+{
+    // DialogBoxes are children of the current Session, so iterate through
+    // the children of UIRoot to find and close all open dialogs
+    var uiRoot = Session.Get("UIRoot");
+    foreach (Dialog dialog in uiRoot.Children.OfType<Dialog>().ToList())
+    {
+        dialog.Close();
+    }
+}
+```
+
+### Close a specific DialogBox
+
+```csharp
+[ExportMethod]
+public void CloseMyDialog()
+{
+    // Get reference to a specific dialog and close it
+    var myDialog = (Dialog)Session.Get("UIRoot/MyDialogBox");
+    if (myDialog != null)
+    {
+        myDialog.Close();
+    }
+}
+```
+
+### Close a DropDownButton
+
+```csharp
+/// <summary>
+/// Close a DropDownButton UI widget by calling its Close method.
+/// Input: assume `Owner` is the DropDownButton or that the code can access it via Owner.
+/// </summary>
+var dropDownButton = (DropDownButton)Owner;
+// Call the Close method exposed by the widget
+dropDownButton.ExecuteMethod("Close");
+```