Release Update File (RUF)

From wiki.eclass.eu
(Redirected from Release Update File)
Jump to: navigation, search

Contents

[edit] Release Update File (RUF)

The Release Update Files contain the information on what has changed in a new MajorRelease.

They are one among several files (RUF, TUF, SDF, CUF) to enable eCl@ss users to update their product data to a new release in a semi-automatic way. All of these files can be found here.

RUF contains the preceding and successive elements comparing an “old” and a “new” release using the basic structure regarding modifications, additions and deletions. Unmodified elements are not contained in RUF. RUF contains information regarding transaction and classification updates. RUF will be used only for exporting the basic version. Only information on changed structure elements which are contained in the basic version will be exported.

The RUF consist of two types of files:


The TU files (#eCl@ss-RUF-TU-CC and #eCl@ss-RUF-TU-PR) for classes and properties contain the predecessor-successor-relationship of the changed classes and properties respectively in the target release. In the several tables of the specific structural elements (e.g. …7_0_CC_en.csv) all absolute changes are listed, i.e. all elements and relations that are no more part of the target release (e.g. 7.0) are listed as “CLOSED”, all new ones are listed as “NEW”. Those elements marked with “VERSION NUMBER“ have been adapted, but their concept was not changed, i.e. their identifier has not changed, only their version number was raised.

You can only use these mapping tables, if you possess both the source release (e.g. 6.2) and the target release (e.g. 7.0) and if you are a registered eCl@ss user.


File Format Specification

RUF is a set of UTF-8 (without byte order mark) encoded CSV files, data sets separated by semicolon (1st line = field titles).

In the files only such elements are contained that were actually changed between source and target release.


[edit] Transaction Upgrades Files

[edit] eClass-RUF-TU-CC (Class-Update-Table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • MOVE: The class was moved in the hierarchy (CodedName changed), only level 4
  • SPLIT: The class was split into several other classes and deprecated, only level 4
  • JOIN: The class was joined into another class and deprecated, only level 4
  • VERSION: The element was changed without changing NUMBER the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED: The element from the SourceRelease was removed here in the TargetRelease
CHAR(20)
2 IrdiSourceRelease Primary key of the predecessor class in the SourceRelease; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (International Registry Date Identifier) (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 CodedNameSourceRelease eCl@ss class code (Coded name) of the predecessor (class in SourceRelease) CHAR(8)
4 IrdiTargetRelease Primary key of the successor class in the TargetRelease; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (International Registry Date Identifier)(Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
5 CodedNameTargetRelease eCl@ss class code (Coded name) of the successor (class in TargetRelease) CHAR(8)
6 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
7 TargetRelease e.g. eCl@ss 9.0 CHAR(13)

Examples:

Command IrdiSourceRelease CodedName SourceRelease IrdiTargetRelease CodedName TargetRelease Source Release Target Release
MOVE 0173-1#01-AGZ365#007 27250580 0173-1#01-AGZ365#008 19240101 eCl@ss7.1 eCl@ss8.0
JOIN 0173-1#01-AGZ364#007 27250506 0173-1#01-AEK865#001 19170125 eCl@ss7.1 eCl@ss8.0
JOIN 0173-1#01-AGZ360#007 27250502 0173-1#01-AEK865#001 19170125 eCl@ss7.1 eCl@ss8.0
SPLIT 0173-1#01-AKM388#009 24230101 0173-1#01-AAX040#012 23330103 eCl@ss7.1 eCl@ss8.0
SPLIT 0173-1#01-AKM388#009 24230101 0173-1#01-AEL161#001 23330113 eCl@ss7.1 eCl@ss8.0

Join: Classes 27250506 and 27250502 were joined in the new class 19170125 in release 9.0. The sources will not be published any more. Join means: from specific to more general.See also JOIN.

Move: Class 27250580 was moved to class 19240101 in release 9.0. Only the version number changes.See also: MOVE

Split: Class 24230101 was split into two new classes in release 9.0: 23330103 and 23330113. The two new classes persist, 24230101 will not be published any more. Split means: from general to more specific. See also SPLIT


[edit] eCl@ss-RUF-TU-PR (Property-Update-Table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New assignment in TargetRelease
  • VERSION: At least one of the elements was changed without changing the concept (e.g. textual correction). Identifiers do not change.
  • REPLACED_PROP: The element was replaced by another _COMPATIBLE identical element (a compatible replacement according to ISO Change Management). Valuations are still valid.
  • REPLACED_PROP: The element was substituted by another _INCOMPATIBLE similar element (an incompatible substitution according to ISO Change Management). Valuations might become invalid.
  • CLOSED The element from the SourceRelease was removed here in the TargetRelease
CHAR(20)
2 IrdiCCSourceRelease Primary key of the predecessor class in the SourceRelease; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 CodedNameSourceRelease eCl@ss class code of the predecessor (class in SourceRelease) CHAR(8)
4 IrdiPRSourceRelease Primary key of the assigned property in the SourceRelease; International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
5 IrdiCCTargetRelease Primary key of the successor class in the TargetRelease; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
6 CodedNameTargetRelease eCl@ss class code of the successor (class in TargetRelease) CHAR(8)
7 IrdiPRTargetRelease Primary key of the assigned property in the TargetRelease; International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
8 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
9 TargetRelease e.g. eCl@ss 9.0 CHAR(13)

The table contains those cases, where the relation between a property and a class has changed. If a property in a class was replaced or substituted by another property the old property will not be part of the target release in this context. Compatible replacement: The replacement of an old property by a new one is compatible, i.e. a user’s valuation is still valid. Incompatible replacement: The replacement of an old property by a new one is incompatible, i.e. manual adaption of the data is necessary. Note: the old property was incorrect and is substituted by the new correct one. The new property might differ in data type or unit.

Examples:

Command IrdiCC Source Release Coded Name Source Release IrdiPR Source Release IrdiCC Target Release Coded Name Target Release IrdiPR Target Release Source Release Target Release
NEW 0173-1#01-AEL428#001 24321109 0173-1#02-BAB678#006 eCl@ss8.1 eCl@ss9.0
REPLACED_PROP_COMPATIBLE 0173-1#01-AKF979#009 24340711 0173-1#02-AAO223#001 0173-1#01-AKF979#010 24340711 0173-1#02-AAO192#002 eCl@ss8.1 eCl@ss9.0
REPLACED_PROP_INCOMPATIBLE 0173-1#01-BAD966#007 34301104 0173-1#02-BAJ012#006 0173-1#01-BAD966#008 34301104 0173-1#02-AAS244#001 eCl@ss8.1 eCl@ss9.0
NEW The property BAB678 is newly assigned to the class 24321109 in the target release.
COMPATIBLE REPLACE Property AAO223 that was assigned to class 24340711 among others is replaced by the compatible property AAO192.

AAO223

  • Preferred name: Type of Battery
  • Definition: group of batteries with comparable attributes
  • Data type: STRING

AAO192

  • Preferred name: Designation of battery
  • Definition: coded description of a battery
  • Data type: STRING
INCOMPATIBLE REPLACE In the context of class 34301104 the property BAJ012 that was assigned to the class in 8.1 is substituted by property

AAS244 that has a different data type.

BAJ012

  • Preferred name: Pharmaceutical central number
  • Data type: INTEGER_MEASURE

AAS244

  • Preferred name: Pharmaceutical central number
  • Data type: STRING


[edit] Tables of the specific structural elements

[edit] eCl@ss-RUF-CC (Class table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • MOVE: The class was moved in the hierarchy (CodedName changed), only level 4
  • SPLIT: The class was split into several other classes and deprecated, only level 4
  • JOIN: The class was joined into another class and deprecated, only level 4
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element from the SourceRelease was removed here in the TargetRelease
CHAR(20)
2 IrdiCC Primary key of the class in the SourceRelease; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 VersionDate Publication date of version CHAR(10)
4 CodedName eCl@ss class code CHAR(8)
5 Level Hierarchichal level in class tree CHAR(1)
6 PreferredName Name CHAR(80)
7 ISOLanguageCode Language code according to ISO 639-1 / ISO 639-2, e.g. „en“ CHAR(2)
8 ISOCountryCode Country code according to ISO 3166-1 / ISO 3166-2, e.g. “US” CHAR(2)
9 Deprecated Specifies if the element is deprecated in the TargetRelease. Allowed values: {TRUE|FALSE}, true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
10 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
11 TargetRelease e.g. eCl@ss 9.0 CHAR(13)

[edit] eCl@ss-RUF-KW-SY (Keyword/Synonym table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element from the SourceRelease was removed here in the TargetRelease
CHAR(20)
2 IrdiKWSY Primary key of the keyword/synonym in the SourceRelease; International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 IrdiKWSY Primary key of the target element (KW to CC, SY to PR); International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(10)
4 KeywordValue/SynonymValue Name of the keyword/synonym CHAR(80)
5 ISOLanguageCode Language code according to ISO 639-1 / ISO 639-2, e.g. „en“ CHAR(2)
6 ISOCountryCode Country code according to ISO 3166-1 / ISO 3166-2, e.g. “US” CHAR(2)
7 Deprecated FALSE}, true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
8 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
9 TargetRelease e.g. eCl@ss 9.0 CHAR(13)


[edit] eCl@ss-RUF-PR (Property Table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element from the SourceRelease was removed here in the TargetRelease
  • REPLACE: The element was replaced by another identical element (a compatible replacement according to ISO Change Management)
  • SUBSTITUTE: The element was substituted by another similar element (an incompatible substitution according to ISO Change Management)
CHAR(20)
2 IrdiPR Primary key of the property in the SourceRelease; International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 VersionDate Publication date of version CHAR(10)
4 PreferredName Name CHAR(80)
5 DataType STRING_TRANSLATABLE | REAL_MEASURE | REAL_COUNT | REAL_CURRENCY | INTEGER_MEASURE | INTEGER_COUNT | INTEGER_CURRENCY | BOOLEAN | URL | RATIONAL | RATIONAL_MEASURE | TIME | TIMESTAMP | DATE), see 3.3.8
6 ISOLanguageCode Language code according to ISO 639-1 / ISO 639-2, e.g. „en“ CHAR(2)
7 ISOCountryCode Country code according to ISO 3166-1 / ISO 3166-2, e.g. “US” CHAR(2)
8 Deprecated FALSE}, true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
9 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
10 TargetRelease e.g. eCl@ss 9.0 CHAR(13)

Note 1 on data types: eCl@ss has introduced with release 8.0 many new data types that might not be interpretable by every system. In this case, eCl@ss recommends to distinguish between at least BOOLEAN, REAL, INTEGER (including count, measure and currency) and STRING properties. eCl@ss sees STRING as a suitable substitute for all other data types that are not interpretable by a system (STRING_TRANSLATABLE, URL, DATE, TIME, TIMESTAMP etc.). With eCl@ss release 8.0 the indication of digits before/after comma (REAL/INTEGER) and the number of characters (STRING) are no longer mandatory.


[edit] eClass-RUF-VA (Value table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element from the SourceRelease was removed here in the TargetRelease

CHAR(20)

2 IrdiVA Primary key of the value in the SourceRelease; International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 VersionDate Publication date of version CHAR(10)
4 Value The actual value, the name CHAR(80)
5 DataType STRING_TRANSLATABLE | REAL_MEASURE | REAL_COUNT | REAL_CURRENCY | INTEGER_MEASURE | INTEGER_COUNT | INTEGER_CURRENCY | BOOLEAN | URL | RATIONAL | RATIONAL_MEASURE | TIME | TIMESTAMP | DATE)
6 ISOLanguageCode Language code according to ISO 639-1 / ISO 639-2, e.g. „en“ CHAR(2)
7 ISOCountryCode Country code according to ISO 3166-1 / ISO 3166-2, e.g. “US” CHAR(2)
8 Deprecated FALSE},true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
9 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
10 TargetRelease e.g. eCl@ss 9.0 CHAR(13)


[edit] eClass-RUF-CC_PR (Relations eClass-RUF-CC / eClass-RUF-PR)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element of SourceRelease was removed
CHAR(20)
2 IrdiCC Primary key of the target class; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 IrdiPR Primary key of the assigned property; International Registration Data Identifier of the property, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
4 Deprecated FALSE},true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
9 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
10 TargetRelease e.g. eCl@ss 9.0 CHAR(13)


[edit] eClass-RUF-PR_VA (Relations eClass-RUF / eClass-RUF-VA)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element of SourceRelease was removed
CHAR(20)
2 IrdiPR Primary key of the target property; International Registration Data Identifier of the class, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 IrdiVA Primary key of the assigned value; International Registration Data Identifier of the property, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
4 Deprecated FALSE},true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
9 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
10 TargetRelease e.g. eCl@ss 9.0 CHAR(13)

Note 1: Prior to 8.0 eCl@ss interpreted its value lists as open, i.e. as suggestions that were never intended to be exhaustive. As the ISO defines value lists as restrictive and exclusive eCl@ss had to change its structure to be ISO-compliant. Therefore eCl@ss distinguishes now between value lists (ISO view) and proposal lists (proposed "open" lists that are not exhaustive). Therefore, most values that were noted until 6.2 are now marked as CLOSED as they are to be interpreted as restrictive. Correspondingly, all relations between properties and values in the context of a class listed in the value proposal file (eClass7_0_PR_VA_suggested_en_02.csv) are new, i.e. all relations listed in that file are interpreted as NEW and not published here again.


[edit] eClass-RUF-UN (Unit table)

No Attribute name Description Length
1 Command Specifies the type of change that occurred in the TargetRelease:
  • NEW: New element in TargetRelease
  • VERSION NUMBER: The element was changed without changing the concept (e.g. textual correction). Identifier (CHAR6) and coded name do not change.
  • CLOSED The element from the SourceRelease was removed here in the TargetRelease
CHAR(20)
2 IrdiUN Primary key of the eCl@ss unit; International Registration Data Identifier, globally unique eCl@ss Identifier (Supplier+TypeOfSE+Identifier+VersionNumber) CHAR(20)
3 StructuredNaming Structured Naming of the unit, e.g. “volt litre^-1 minute^-1” CHAR(1000)
4 ShortName Short name CHAR(1000)
5 NameOfDedicatedQuantity Name of the superordinate quantity according to DIN CHAR(1000)
6 Deprecated FALSE},true = element was deprecated and is no longer part of the TargetRelease BOOLEAN
9 SourceRelease e.g. eCl@ss 8.1 CHAR(13)
10 TargetRelease e.g. eCl@ss 9.0 CHAR(13)


[edit] Related Information

Personal tools