User Tools

Site Tools


Package Supplement File

This page is a WIP. There is likely to be incomplete and or missing information while the page is being built.

Summary

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.

Detail

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.

Adjacent

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 “Download To” 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.

Embedded

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.

Fallback

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.

Example

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>

Elements & Attributes

  • 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

Predefined Types

  • Software
  • Plugin
  • Content

Predefined Tags

Tags are used to associate a package with an intended application [or major version of application], so that when a user sets their preference for which application(s) they wish to see downloads for, they only see the downloads that are intended to work with the application(s) they choose. In some cases, one package is intended to be used with multiple applications and will be assigned multiple tags, while in other cases the intent can be for one package to be used for only one application and will be assigned a single tag.

The tags that are assigned to a package can be dynamic. As products are updated over time (i.e. a new version specific package becomes available and supersedes an older version), the tags that are assigned to them can sometimes change.

The tables below list all of the predefined tags that are currently supported by Install Manager:

Standard Tags

The tags listed here are those that are not specific to the Daz Connect service.

Label Value
Bryce Bryce
Carrara 8.5 Carrara8_5
Carrara 8 Carrara8
Carrara 7.2 Carrara7_2
Carrara 7 Carrara7
Carrara (< 7) CarraraLegacy
DAZ Studio 4.5+ DAZStudio4_5
DAZ Studio 4 DAZStudio4
DAZ Studio 3 DAZStudio3
DAZ Studio (< 3) DAZStudioLegacy
DSON Importer for Poser DSON_Poser
Hexagon Hexagon
Install Manager InstallManager
LightWave Lightwave
Maya Maya
Photoshop Photoshop
Poser 9+ Poser9
Poser (< 9) PoserLegacy
Vue Vue
General General
Software Software
Plugin Plugin
Windows 32-bit Win32
Windows 64-bit Win64
Mac 32-bit Mac32
Mac 64-bit Mac64
Public Build PublicBuild
Private Build PrivateBuild

Daz Connect Tags

The tags listed here are those that are specific to the Daz Connect service.

Label Value
Connect Available CloudAvailable
Connect Installed CloudInstalled