Structure Difference File

From wiki.eclass.eu
Jump to: navigation, search

Contents

[edit] Structure Difference File (SDF)

[edit] Application

  • UseCase: Update eCl@ss dictionary
  • NonUseCase: Viewing differences by human

[edit] Available for eCl@ss Version

BASIC and ADVANCED

[edit] Definition

The main purpose of the Structure Difference File (SDF) is to update from one eCl@ss release to its subsequent release, if these cannot be kept parallel for technical or business reasons. It is recommended to keep different dictionary releases parallel. If dictionary releases are kept in parallel, the SDF become more obsolete.

These files are one among several supporting files (RUF, TUF, CUF, SDF) which enable a user to update an eCl@ss classified and property described material master to a new version. All of these can be found here.

SDF is an XML genericode list for BASIC and ADVANCED of all those identifiers that were changed in a certain dictionary release. SDF shows all elements that have changed or have been added on element level (like class, property, value etc.) information on the relations is not included.

[edit] Files and Format

There are two different XML files:

  • eCl@ssXML 1.0 (until Release 7.0) location is here.
  • eCl@ssXML 2.0 (since Release 8.0) location is here.


C4.png
Figure 1 - SDF Overview (eCl@ssXML 1.0)- as Genericode


The SDF is a two column table.

  • The first column represents the Structure element identifier represented as an IRDI.
  • The second column is the “Structure element change” from the set {DEL, DEPR, NEW, UPD}
    • DEL (delete - delete an element)
    • DEPR (deprecated - assigned to be deleted)
    • NEW (new - new element)
    • UPD (update - update an element)

[edit] Example

The file contains all absolute changes of elements and the type of change, but not the content of the change. I.e. all elements that are no more part of the TargetRelease are listed as “DEPR” (deprecated), all new ones are listed as “NEW”. Those elements marked with “UPD“ have been updated, i.e. their version number was raised.

SDFExampleXML.jpg

Personal tools