Revision as of 10:47, 21 February 2008 (view source) Cmbrandt.us.ibm.com (Talk | contribs) (→‎<ContentType>) ← Older edit		Revision as of 10:47, 21 February 2008 (view source) Cmbrandt.us.ibm.com (Talk | contribs) (→‎<ContentType>) Newer edit →
Line 375:		Line 375:
	Notes:<br>		Notes:<br>
		+	If there are two matching pathnames, log a message to the user that the correct file needs to be chosen via a custom rule in order for DigestInfoGroup, charEncoding and length to be valid. The default rule will simply pick one, but it must pick DigestInfoGroup, charEncoding and length together as a set from one of the inputs.
	== <ContentsType> ==		== <ContentsType> ==

---

Revision as of 10:47, 21 February 2008

Common Schema Elements

DescriptorInfoGroup

<xsd:attributeGroup name="DescriptorInfoGroup">
  <xsd:attribute name="schemaVersion" type="xsd:string" fixed="1.0" use="required"/>
  <xsd:attribute name="descriptorID" type="sdd-common:UUIDType" use="required"/>
  <xsd:attribute name="lastModified" type="xsd:dateTime" use="required"/>
  <xsd:attribute name="descriptorLanguageBundle" type="xsd:token" use="optional"/>
  <xsd:anyAttribute namespace="##other" processContents="lax"/>
</xsd:attributeGroup>

Type	Element	Attribute	Data Type	Compare?
DescriptorInfoGroup
		schemaVersion	xsd:string	Throw Away
		descriptorID	<UUIDType>	Throw Away
		lastModified	xsd:dateTime	Throw Away
		descriptorLanguageBundle	xsd:token	Merge
		any	namespace="##other"

Notes:
DescriptorInfoGroup is always merged.

<DisplayTextType>

<xsd:complexType name="DisplayTextType">
  <xsd:simpleContent>
    <xsd:extension base="xsd:string">
      <xsd:attribute name="translationKey" type="xsd:NCName" use="optional"/>
    </xsd:extension>
  </xsd:simpleContent>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<DisplayTextType>			Extension Of: xsd:string	Yes
		translationKey	xsd:NCName	Merge

Notes:
DisplayTextType is always merged. When xsd:strings are equal, the merging algorithm must resolve translationKey and choose one of the translations to use.

<VersionType>

<xsd:simpleType name="VersionType">
  <xsd:restriction base="xsd:string"/>
</xsd:simpleType>

Type	Element	Attribute	Data Type	Compare?
<VersionType>			xsd:string	Yes

<FixIdentityType>

<xsd:complexType name="FixIdentityType">
  <xsd:sequence>
    <xsd:element name="Name" type="xsd:NMTOKEN"/>
    <xsd:element name="Description" type="sdd-common:DisplayTextType"/>
    <xsd:element name="ShortDescription" type="sdd-common:DisplayTextType" minOccurs="0"/>
    <xsd:element name="Symptom" type="sdd-common:DisplayTextType" minOccurs="0" maxOccurs="unbounded"/>
    <xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<FixIdentityType>
	Name		xsd:NMTOKEN	Yes
	Description		<DisplayTextType>	Merge
	ShortDescription		<DisplayTextType>	Merge
	Symptom		<DisplayTextType>	Merge
	any		namespace="##other"	?

<MaintenanceInformationType>

<xsd:complexType name="MaintenanceInformationType">
  <xsd:sequence>
    <xsd:element name="Severity" type="sdd-common:DisplayTextType" minOccurs="0"/>
    <xsd:element name="Category" type="sdd-common:DisplayTextType" minOccurs="0" maxOccurs="unbounded"/>	
    <xsd:element name="Fix" type="sdd-common:FixIdentityType" minOccurs="0" maxOccurs="unbounded"/>
    <xsd:element name="Supersedes" type="sdd-common:MaintenanceInformationType" minOccurs="0" maxOccurs="unbounded"/>
    <xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<MaintenanceInformationType>
	Severity		<DisplayTextType>
	Category		<DisplayTextType>
	Fix		<FixIdentityType>
	Supersedes		<MaintenanceInformationType>
	any		namespace="##other"	?

Notes:
In a MaintenanceInformationType, all Categories apply to all Fixes. When merging two or more instances, it's important to only keep information that is true for all inputs. So, all fixes are kept and as many categories as apply to all fixes are kept.

For example, if MI one contains category FUNCTION and fix A, MI two contains categories FUNCTION, PERFORMANCE and fixes B,C and MI three contains category PERFORMANCE and fix D - the merged MI could contain no categories and fixes A,B,C,D.

Another case is when MI one contains category FUNCTION and fix A and MI two contains categories FUNCTION,PERFORMANCE and fixes B,C. Then the merged MI would contain category FUNCTION and fixes A,B,C.

<BuildInformationType>

<xsd:complexType name="BuildInformationType">
  <xsd:attribute name="buildID" type="xsd:token" use="required"/>
  <xsd:anyAttribute namespace="##other" processContents="lax"/>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<BuildInformationType>
		buildID	xsd:token	Merge
		any	namespace="##other"	?

Notes:
If a buildID comes from a build system plugin, that buildID should be kept.

<LocationType>

<xsd:complexType name="LocationType">
  <xsd:sequence>
    <xsd:element name="Address" type="sdd-common:DisplayTextType" minOccurs="0"/>
    <xsd:element name="Country" type="sdd-common:DisplayTextType" minOccurs="0"/>
  </xsd:sequence>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<LocationType>
	Address		<DisplayTextType>	Merge
	Country		<DisplayTextType>	Merge

<ManufacturerType>

<xsd:complexType name="ManufacturerType">
  <xsd:sequence>
    <xsd:element name="Name" type="sdd-common:DisplayTextType"/>
    <xsd:element name="Location" type="sdd-common:LocationType" minOccurs="0"/>
    <xsd:element name="ContactInformation" type="sdd-common:DisplayTextType" minOccurs="0"/>
    <xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<ManufacturerType>
	Name		<DisplayTextType>	Yes
	Location		<LocationType>	Merge
	ContactInformation		<DisplayTextType>	Merge
	any		namespace="##other"	?

<IdentityType>

<xsd:complexType name="IdentityType">
  <xsd:sequence>
    <xsd:element name="Description" type="sdd-common:DisplayTextType" minOccurs="0"/>
    <xsd:element name="ShortDescription" type="sdd-common:DisplayTextType" minOccurs="0"/>
    <xsd:element name="Name" type="sdd-common:DisplayTextType" minOccurs="0" />
    <xsd:element name="Version" type="sdd-common:VersionType" minOccurs="0"/>
    <xsd:element name="MaintenanceInformation" type="sdd-common:MaintenanceInformationType" minOccurs="0"/>
    <xsd:element name="BuildInformation" type="sdd-common:BuildInformationType" minOccurs="0"/>
    <xsd:element name="Manufacturer" type="sdd-common:ManufacturerType" minOccurs="0"/>
    <xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
  </xsd:sequence>
  <xsd:attribute name="softwareID" type="xsd:string" use="optional"/>
  <xsd:anyAttribute namespace="##other" processContents="lax"/>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<IdentityType>
		softwareID	xsd:string	Yes
		any	namespace="##other"	?
	Description		<DisplayTextType>	Merge
	ShortDescription		<DisplayTextType>	Merge
	Name		<DisplayTextType>	Merge
	Version		<VersionType>	Merge
	MaintenanceInformation		<MaintenanceInformationType>	Merge
	BuildInformation		<BuildInformationType>	Merge
	Manufacturer		<ManufacturerType>	Merge
	any		namespace="##other"	?

<UUIDType>

<xsd:simpleType name="UUIDType">
  <xsd:restriction base="xsd:hexBinary">
    <xsd:length value="16"/>
  </xsd:restriction>
</xsd:simpleType>

Type	Element	Attribute	Data Type	Compare?
<UUIDType>			xsd:hexBinary	Yes

Package Descriptor Schema Elements

DigestInfoGroup

<xsd:group name="DigestInfoGroup">
  <xsd:sequence>
    <xsd:element ref="ds:DigestMethod"/>
    <xsd:element ref="ds:DigestValue"/>
  </xsd:sequence>
</xsd:group>

Type	Element	Attribute	Data Type	Compare?
DigestInfoGroup
	DigestMethod		<DigestMethodType>	Yes
	DigestValue		<DigestValueType>	Yes

<SDDContentPurposeType>

<xsd:simpleType name="SDDContentPurposeType">
  <xsd:restriction base="xsd:NCName">
    <xsd:enumeration value="readMe"/>
    <xsd:enumeration value="endUserLicenseAgreement"/>
    <xsd:enumeration value="responseFile"/>
    <xsd:enumeration value="deploymentDescriptor"/>
    <xsd:enumeration value="packageDescriptor"/>	
    <xsd:enumeration value="descriptorLanguageBundle"/>	
    <xsd:enumeration value="content"/>	
  </xsd:restriction>
</xsd:simpleType>

Type	Element	Attribute	Data Type	Compare?
<SDDContentPurposeType>			xsd:NCName	Yes

<ContentPurposeType>

<xsd:simpleType name="ContentPurposeType">
  <xsd:union memberTypes="sdd-pd:SDDContentPurposeType xsd:NCName"/>
</xsd:simpleType>

Type	Element	Attribute	Data Type	Compare?
<ContentPurposeType>			Union Of: <SDDContentPurposeType> + xsd:NCName	Yes

<ContentType>

<xsd:complexType name="ContentType">
  <xsd:sequence>
    <xsd:group ref="sdd-pd:DigestInfoGroup" minOccurs="0"/>
  </xsd:sequence>
  <xsd:attribute name="id" type="xsd:ID" use="required"/>
  <xsd:attribute name="pathname" type="xsd:anyURI" use="required"/>
  <xsd:attribute name="purpose" type="sdd-pd:ContentPurposeType" default="content" use="optional"/>
  <xsd:attribute name="charEncoding" type="xsd:string" use="optional"/>
  <xsd:attribute name="length" type="xsd:nonNegativeInteger" use="optional"/>
  <xsd:anyAttribute namespace="##other" processContents="lax"/>
</xsd:complexType>

Type	Element	Attribute	Data Type	Compare?
<ContentType>
	DigestInfoGroup		DigestInfoGroup	No
		id	xsd:ID	Throw Away
		pathname	xsd:anyURI	Yes
		purpose	<ContentPurposeType>	Merge
		charEncoding	xsd:string	No
		length	xsd:nonNegativeInteger	No
		any	namespace="##other"	?

Notes:
If there are two matching pathnames, log a message to the user that the correct file needs to be chosen via a custom rule in order for DigestInfoGroup, charEncoding and length to be valid. The default rule will simply pick one, but it must pick DigestInfoGroup, charEncoding and length together as a set from one of the inputs.

<ContentsType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<SDDPackageTypeType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ExtensiblePackageTypeType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PackageTypeType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PackageIdentityType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PackageDescriptorType>

Type	Element	Attribute	Data Type	Compare?

Notes:

Deployment Descriptor Schema Elements

DescriptionGroup

Type	Element	Attribute	Data Type	Compare?

Notes:

DisplayElementGroup

Type	Element	Attribute	Data Type	Compare?

Notes:

ResourceConstraintGroup

Type	Element	Attribute	Data Type	Compare?

Notes:

ContentListGroup

Type	Element	Attribute	Data Type	Compare?

Notes:

<VariableExpressionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PropertyType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResourceTypeNameType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResourceType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<TopologyType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<VersionValueType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<MaxVersionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<VersionRangeType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<VersionConstraintValueType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<VersionConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PropertyMatchType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PropertyValueListType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConditionalPropertyConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<UniquenessConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RelationshipConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConditionalResourceConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<AlternativeConditionalType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<OperationType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<OperationListType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConditionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<BaseParameterType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<BoundaryType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<IntegerParameterType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<StringCaseType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<StringParameterType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<BooleanParameterType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<URIParameterType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ParametersType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<BaseVariableType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResourcePropertyType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConditionalDerivedVariableExpressionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<DerivedVariableType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<VariablesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequiredBaseConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<AlternativeRequiredBaseConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequiredBaseType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CapacityValueType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CapacityConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConsumptionConstraintValueType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConsumptionConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PropertyConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequirementResourceConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<DependencyType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<InternalDependencyType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<AlternativeRequirementType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequirementType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequirementsType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<LanguageType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<LanguagesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<SDDCompletionTypeNamesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CompletionTypeNamesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CompletionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResultingPropertyType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RelationshipType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResultingResourceType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResultingChangeType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ArgumentType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ArgumentListType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<OutputVariableType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<OutputVariableListType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<SubstitutionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ArtifactTypeNameType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<AdditionalContentType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ArtifactType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<InstallationArtifactsType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<InstallableUnitType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConfigurationArtifactsType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConfigurationUnitType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<LocalizationUnitType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<LanguageSetType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<OptionalLanguagesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<LanguageSelectionsType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CompositeUnitType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ContentSelectionFeatureType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequiredContentSelectionType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResourceMapType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResultingResourceMapType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ResultingChangeMapType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ReferencedPackageType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<BaseContentType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<FeatureReferenceType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<GroupType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<GroupsType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<MultiplicityConstraintType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ConstrainedResourceType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<MultiplicityType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<ContentElementReferenceType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<PackageFeatureReferenceType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<NestedFeatureType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<FeatureType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<MultiSelectType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<FeaturesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<SelectableContentType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CompositeLocalizationUnitType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<LocalizationContentType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<CompositeInstallableType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<RequisitesType>

Type	Element	Attribute	Data Type	Compare?

Notes:

<DeploymentDescriptorType>

Type	Element	Attribute	Data Type	Compare?

Notes: