8.4.12 SoftwareFolderType

The SoftwareFolderType is a subtype of FolderType. It allows adding and removing its items via the Add and Delete methods. With the SoftwareClass Variable the server exposes whether the folder holds a collection of applications or a collection of configurations. The ObjectType of the items is server specific, but the items shall at least support the SoftwareUpdate AddIn. They are identified by SoftwareSubclass and SoftwareName which is provided with the Add Method. After adding a new item, the SoftwareUpdate AddIn is used to transfer the initial software. After that it can be used to install updates. The SoftwareUpdate AddIn of each item shall support SoftwareClass, SoftwareSubclass and SoftwareName. SoftwareFolderType is defined in Table 107 and its usage is illustrated in Figure 55.

Figure 55 – Example use of SoftwareFolderType
Table 107 – SoftwareFolderType
Attribute Value
BrowseName1:SoftwareFolderType
IsAbstractFalse
References Node
Class
BrowseName DataType TypeDefinition Other
Subtype of the 0:FolderType defined in OPC 10000-5.
0:HasPropertyVariable1:SoftwareClass1:SoftwareClass0:PropertyTypeM
0:HasComponentMethod1:AddM
0:HasComponentMethod1:DeleteM
Conformance Units
DI SU SoftwareFolder

The SoftwareClass Property is a SoftwareClass enumeration. It declares what items are managed by the folder. The value shall either be Application or Configuration.

8.4.12.1 Add Method

The Add Method can be used to add a new item to the folder. The parameters Subclass and Name are exposed at the attached SoftwareUpdate AddIn as SoftwareSubclass and SoftwareName Properties. The Name shall be unique within the SoftwareFolderType.

Signature

	Add(
	[in] 0:String   Subclass,
	[in] 0:String   Name);
	
Table 108 – Add Method Arguments
Argument Description
SubclassSubclass of the new item.
NameName of the new item.
Table 109 – Delete Method AddressSpace definition
Attribute Value
BrowseName1:Add
References NodeClass BrowseName DataType TypeDefinition Other
0:HasPropertyVariable0:InputArguments0:Argument[] 0:PropertyTypeM
Conformance Units
DI SU SoftwareFolder
8.4.12.2 Delete Method

The Delete Method can be used to delete an item from the folder. The Delete can require a call to Uninstall at the InstallationStateMachine (see 8.4.9).

Signature

	Delete(
	  [in] 0:NodeId   ObjectToDelete);
	
Table 110 – Delete Method Arguments
Argument Description
ObjectToDeleteNodeId of the item to delete.

Method Result Codes (defined in Call Service)

Result Code Description
Bad_NotFoundThe specified item does not exist.
Bad_InvalidState

If the item shall be uninstalled before deletion.

(see InstallationStateMachineType 8.4.9).

Table 111 – Delete Method AddressSpace definition
Attribute Value
BrowseName1:Delete
References NodeClass BrowseName DataType TypeDefinition Other
0:HasPropertyVariable0:InputArguments0:Argument[] 0:PropertyTypeM
Conformance Units
DI SU SoftwareFolder