Name property

The SetupNode object name is saved as the type attribute in the Setup DCO XML file:

<D type="NodeName">

The name is the identifier that is used to refer to child objects within the Setup DCO, as shown in this example:

<P type="Main_Page">
   .
   .
   .
   <F type="Vendor" pos="0" min="0" max="0"/>  <--Referencing the Vendor node by name

Syntax

VBScript

oSNO.Name as String

C#

string Name { set; get; }

Type

Read and write.

VBScript example

In the following example, the code populates a setup object from the BDOcs.xml setup DCO file. The code then uses the Name property to update the name of the second node of type Page to Invoice in the Setup object. The example also writes the updated Setup DCO file to disk.

Call oSO.ReadSetup("c:\Datacap\BDOcs\dco_BDOcs\BDOcs.xml")
Dim objInvPage
Set objInvPage = oSO.GetNode(2,1)
objInvPage.Name = "Invoice"
Call oSO.WriteSetup("c:\Datacap\BDOcs\dco_BDOcs\BDOcs.xml")

C# example

In the following example, after the code populates a setup object from the APT.XML setup DCO file, the code uses the Name property to update the name of the TM000001 node to Invoice in the Setup object. The example also writes the updated Setup DCO file to disk.

m_oDCO.ReadSetup("C:\\Datacap\\APT\\dco_APT\\APT.XML");
TDCOLib.DCOSetupNode m_oDCOSetupNode = m_oDCO.FindChild("TM000001").SetupNode();
m_oDCOSetupNode.Name = "Invoice";
m_oDCO.WriteSetup("C:\\Datacap\\APT\\dco_APT\\APT.XML");