DDI 3.3 Change Log

1

CodeValueType and InternationalCodeValueType have had all attribute names changed from codeListXxx to controlledVocabularyXxx. This aligns the naming with the Controlled Vocabularies published by the DDI and prevents name conflicts with the element CodeList in the DDI schemas. Note controlledVocabularyVersionID has changed from a default value of “1.0” to “optional”.  Change all codeListXxx attribute names to controlledVocabularyXxx names. If relying on the default value for controlledVocabularyXxx add the value “1.0” to your instance. NOTE that the old codeListName attribute has a name conflict with the new CodeListName added to CodeListType.

reusable.xsd

2

ComponentParts changed from type=”ComponentPartsType” to type=”LocationValueBundleType”. This makes it the same base as used for the new “ImmediateParentLocation”. The only structural difference between the old ComponentPartsType and LocationValueBundleType is that LocationValueReference changed from a cardinality of 0..1 to a cardinality of 0..n. Change does not affect parsing.

reusable.xsd

3

The ControlConstruct reference no longer supports the use of binding. If this is required for specifying the path of data into a Variable, route it through a ProcessingInstruction. The ProcessingInstructionReference continues to support the use of binding.

datacollection.xsd

4

DefiningConceptReference moved from conceptualcomponent.xsd to reusable.xsd. Used by UniverseType and SubUniverseType.

conceptualcomponent.xsd

5

Extension base of GenerationInstruction and GeneralInstruction changed from r:VersionableType to ProcessingInstructionType. Change does not affect parsing.

datacollection.xsd

6

Extension base of Individual and Organization changed from r:VersionableType to ArchiveType. Change does not affect parsing.

archive.xsd

7

CountryCode changes from a prescribed use of DDI country codes where were not published to a standard CodeValueType. Change affects parsing only if the default values were used as a) the names of the attributes have changed (see Change #1) and b) the referenced codes were not published.

reusable.xsd

8

Extension base of QuestionItem, QuestionGrid, and QuestionBlock changed from r:VersionableType to QuestionType. Change does not affect parsing.

datacollection.xsd

9

BUG FIX: Element declaration name=”FilterCategoryValueType” type=”CategoryValueType” was corrected to name=”FilterCategoryValue”

physicalinstance.xsd

10

GridResponseDomain (used in StructuredMixedGridResponseDomainType) changed to GridResponseDomainInMixed. GridResponseDomainInMixedType retains all of the content of GridResponseDomainType and adds ResponseAttachmentLocation and attachementBase. Change d:GridResponseDomain to d:GridResponseDomainInMixed and d:GridResponseDomainType to d:GridResponseDomainInMixedType.

datacollection.xsd

11

Extension base of OtherMaterialType changed from IdentifiableType to VersionableType. Change isIdentifiable=”true” to isVersionable=”true”

reusable.xsd

12

Interval changes name to InveralIncrement (element declaration and use in LevelType). The element type has not changed. Change name

reusable.xsd

13

Removed maxOccurs=”1” on ContributorType referenced element ContributorReference as redundant. Change does not affect parsing.

reusable.xsd

14

AggregationType xs:choice (1..1) of AggregationVariable (0..1) or AggregationVariableReference (0..1) corrected to remove cardinality from elements contained in the choice. xs:choice cardinality has be loosened to 0..1 Change does not affect parsing.

datacollection.xsd

15

ConditionalTextType xs:choice (1..1) of Express (0..1) or r:SourceParameterReference (0..1). Removed element cardinality statement of minOccurs=”0” as redundant Change does not affect parsing.

datacollection.xsd

16

AttachmentLocationType xs:choice cardinality minOccurs=”1” removed as redundant Change does not affect parsing.

datacollection.xsd

17

AbtractIdentifiableType and Refrencetype xs:choice of URN or sequence [Agency, ID, Version] cardinality minOccurs=”1” removed as redundant Change does not affect parsing.

reusable.xsd

18

BUG: FilterVariableCategoryType contained element name=”FilterCategoryValue” to ref=”FilterCategoryValue”. If a value is provided change <pi:FilterCategoryValue>[value]</pi:FilterCategoryValue> to <pi:FilterCategoryValue><r:Value>[value]</r:Value></pi:FilterCategoryValue> OR if the reference to a Code was provided change <pi:FilterCategoryValue>[URN]</pi:FilterCategoryValue> to <pi:FilterCategoryValue><r:CodeRefence><r:URN>[URN]</r:URN><r:TypeOfObject>Code</r:TypeOfObject></r:CodeReference></pi:FilterCategoryValue>

physicalinstance.xsd

19

BUG: IncludedCodeName contained element name=”CodeReference” to ref=”CodeReference”

Change <r:CodeReference>[URN]</ r:CodeReference > to <r:CodeRefence><r:URN>[URN]</r:URN><r:TypeOfObject>Code</r:TypeOfObject></r:CodeReference>

reusable.xsd

20

BUG: DimensionRankValueType contained element name=”Value” to ref=”Value” Change does not affect parsing.

reusable.xsd

21

OtherStatementOfQuality type changed name from OtherQualityStatement to OtherStatementOfQuality. Change all occurances of OtherQualityStatement to OtherStatementOfQuality

reusable.xsd

22

Renamed ProcessingInstructionReferenceType to ReferenceWithBindingType. Changed ProcessInstructionReference from ProcessingInstructionReferenceType to ReferenceWithBindingType. Change does not affect parsing.

reusable.xsd

23

Renamed the following names related to Quality: QualityStatementSchemeName to QualitySchemeName; QualityStatementSchemeReference to QualitySchemeReference; QualityStatementSchemeType to QualitySchemeType; and QualityStatementScheme to QualityScheme. Change all occurances of these names

reusable.xsd

24

ExternalAid and ExternalInformation changed from r:OtherMaterialType to an unidentified object containing a choice of r:OtherMaterial or r:OtherMaterialReference. Change example: FROM <d:ExternalAid isIdentifiable=”true”>[OtherMaterial content]</d:ExternalAid> TO <d:ExternalAid><r:OtherMaterial isVersionable=”true”>[OtherMaterial content]</r:OtherMaterial></d:ExternalAid>

datacollection.xsd

25

In RepresentedVariableType r:UniverseReference changed to r:UnitTypeReference Change contained element in RepresentedVariableType from r:UniverseReference to r:UnitTypeReference This will require creation of c:UnitType content, change of referenced URN, and change of TypeOfObject in reference to UnitType

logicalproduct.xsd

26

RepresentedVariableReference moved from logicalproduct.xsd to reusable.xsd Change FROM <l:RepresentedVariableReference> TO <r:RepresentedVariableReference> in RepresentedVariableSchemeType and RepresentedVariableGroupType 

logicalproduct.xsd

27

GenericMapType elements SourceSchemeReference and TargetSchemeReference  changed from cardinality 1..1 to 0..1 Change does not affect parsing.

comparative.xsd

28

ItemMapType elements changed from SourceItem and TargetItem to SourceItemReference to TargetItemReference. SourceItem and TargetItem both changed from type=”r:IDType” to type=”r:Reference” Change to full Reference content Example: FROM <cm:SourceItem>[ID]</cm:SourceItem> TO <cm:SourceItemReference><r:URN>urn:ddi:[agency]:[ID]:[version]</r:URN><r:TypeOfObject>[object type]</r:TypeOfObject></cm:SourceItemReference>

comparative.xsd

29

DDIMaintenanceAgencyIDType attribute startDate changes name to activationDate Change name of attribute

archive.xsd

30

BudgetDocuement and StimulasMaterial were changed from type=”OtherMaterial” to type=”BudgetDocumentType” and type=”StimulasMaterialType”. These new objects are not identifiable and bundle together an inline and by reference option for OtherMaterial. To change existing content to comply with 3.3 change:

·         Change the name of the object to r:OtherMaterial

·         Wrap the content in an element with the former name

·         Any references to the object will need the TypeOfObject changed to “OtherMaterial”

·         Example:

<r:BudgetDocument>

       <r:URN>ddi:urn:int.example:BD1111:1</r:URN>

       ….

</r:BudgetDocument>

TO

<r:BudgetDocument>

      <r:OtherMaterial>

            <r:URN>ddi:urn:int.example:BD1111:1</r:URN>

            ….

      </r:OtherMaterial>

</r:BudgetDocument>

31

Extension base for all Managed Representations was changed from VersionableType to the new ManagedRepresentationType. Change does not affect parsing.

reusable.xsd

32

Change of datatype from xs:integer to xs:nonNegativeInteger was made in allocations where a negative number would not be applicable by definition, such as the number of items in a collection. Locations are noted is spreadsheet. Change does not affect parsing.

various

33

OtherMaterial is now versionable and has been moved to the Versionable section of TypeOfObjectType enumerations. Change does not affect parsing.

reusable.xsd

34

RepresentedVariableType xs:choice for r:ConceptualVariableReference or the xs:sequence [r:UnitTypeReference (0..1) and r:ConceptReference (0..1) the cardinality statement on r:ConcptualVariableReference was moved from r:ConceptualVariableReference to the xs:choice as 0..1. The provides the option of not providing this information and clarifies the option for the choice. Change does not affect parsing.

logicalproduct.xsd

35

FragmentType now only references an r:OtherMaterial as the payload of the Fragment. The

instance.xsd

36

BUG FIX: BaseIDType and DDIAgencyIDType patterns were edited to allow a single “.” extension in the ID and multiple “.” Extensions in the AgencyID. Both are carried into the composite URN pattern. The use of “.”

reusable.xsd

37

xs:choice in StructuredMixedGridResponseDomain changed cardinality from minOccurs=”0” to minOccurs=”2”. As the usage of StructuredMixedGridResponseDomain implied the use of 2 or more response domains this change should not affect parsing.

datacollection.xsd

38

In GenerationInstructionType change SourceQuestion to InputQuestionReference and SourceVariable to InputVariableReference. A similar change has been made in the element declarations. Note that these both continue to be of type=”SourceReferenceType”. Change element name “SourceQuestion to “InputQuestionReference” and “SourceVariable” to “InputVariableReference”

datacollection.xsd

39

In UsedType change attribute “defaultValue” type=”xs:string” to element ref=”r:DefaultValue”

ddiprofile.xsd

40

CitationType element ref=”dc:elementsAndRefinements” has changed to “dcterms:elementsAnRefinements”. Note that this supports both “dc” and “dcterms” namespaces. The file dcterms.xsd has been updated to the current version. Change does not affect parsing.

reusable.xsd

41

Change element name “TopLevelReference” to “HighestLevelReference” in “SpatialCoverage” (type=”GeographicCoverageType”)

reusable.xsd

42

In IdentifierParsingInformationType and LimitedCodeSegmentCapturedType change attribute name=”arrayBase” to element ref=”ArrayBase” of type xs:nonNegativeInteger. The attribute used ArrayBaseCodeType all values of which were xs:nonNegativeInteger

reusable.xsd