A Package Supplement File, as the name suggests, is a file that provides supplemental information about an Install Manager compatible package. The supplemental information contained within the file is required by the application so that it can display certain information and perform various tasks.

A Package Supplement File is automatically created upon completing the download of a package through Install Manager. The information contained within this file is derived from product and account history data, retrieved from the Daz 3D store when you log into your account from within Install Manager.

As packages can be downloaded manually outside of Install Manager, and/or originate from sources other than Daz 3D, and then be placed in the “Package Archive” folder specified in the application settings, Install Manager will generate a Package Supplement File for each package that follows the Package Naming guidelines and doesn't already have one.

If the package contains a “Supplement.dsx” file in the root of the package, Install Manager will parse a subset of the information described below to produce a Package Supplement File next to the package.

If the package does not contain the expected file in the expected location, or if the file cannot be successfully parsed, Install Manager will generate the Package Supplement File from the name and bytes of the package itself.

Click the name of the example below to save it as a file.

IM00016280-01_Genesis2FemaleStarterEssentials.dsx

<?xml version="1.0" encoding="UTF-8"?>
<ProductSupplement VERSION="0.1">
	<ProductName VALUE="Genesis 2 Female Starter Essentials"/>
	<ProductStoreIDX VALUE="16280-1"/>
	<UserOrderDate VALUE="2013-05-03T18:51:15Z"/>
	<InstallerDate VALUE="2013-07-01T20:04:05Z"/>
	<ProductFileGuid VALUE="8c843235-46af-8eef-eb28-41094d9d57c9"/>
	<ProductTags VALUE="DAZStudio4_5,DSON_Poser"/>
</ProductSupplement>

• ProductSupplement - An enclosing element that identifies the contents of the file as being one which provides supplemental information about a product to Install Manager.
  • This element is expected to exist in an adjacent dsx
  • This element is expected to exist in an embedded Supplement.dsx

• ProductName - The name displayed to the user within the Install Manager User Interface (UI).
  • This element is expected to exist in an adjacent dsx
  • This element is expected to exist in an embedded Supplement.dsx

• ProductStoreIDX - A hyphenated value, comprised of two integers, that is used to uniquely identify the product and package within a given source. The left portion of the value corresponds with the Stock Keeping Unit (SKU) used to identify the product, while the right portion of the value is used to uniquely identify the package within the product. The left portion of the value should be greater than 0 and should not exceed 99,999,999. The exception to this being packages from 3rd party sources, in which case the Source Prefix for the package is encoded. The right portion of the value should be greater than 0 and should not exceed the number 99.
  • This element is expected to exist in an adjacent dsx
  • This element is expected to exist in an embedded Supplement.dsx

• UserOrderDate - The UTC datetime that the package was added to the current account, in ISO 8601 extended format. This datetime can be used to sort product lists displayed in the Install Manager UI.
  • This element is expected to exist in an adjacent dsx
  • This element is ignored if it exists in an embedded Supplement.dsx

• InstallerDate - The UTC datetime of the package itself, in ISO 8601 extended format. This datetime can be used to sort product lists displayed in the Install Manager UI by their respective package dates.
  • This element is expected to exist in an adjacent dsx
  • This element is ignored if it exists in an embedded Supplement.dsx

• ProductFileGuid - A Globally Unique Identifier (GUID) created from a MD5 digest of the associated package. This GUID is used to determine whether the associated package is an update for a product/package that is already installed, as well as whether an update for the product/package exists on the Daz 3D store.
  • This element is expected to exist in an adjacent dsx
  • This element is ignored if it exists in an embedded Supplement.dsx

• InstallTypes - A comma delimited list of predefined Types that have been assigned to the package and describe the manner in which files are installed.
  • This element is expected to exist in an adjacent dsx
  • This element is expected to exist in an embedded Supplement.dsx

• ProductTags - A comma delimited list of predefined Tags that have been assigned to the package and describe the association of files in the package.
  • This element is expected to exist in an adjacent dsx
  • This element is expected to exist in an embedded Supplement.dsx