Changes between Version 12 and Version 13 of FDORfc60

Timestamp:

Apr 13, 2011, 8:57:11 AM (13 years ago)

Author:

gregboone

Comment:

--

FDORfc60

@@ -191 +191 @@
 Through such an organization of Annotation properties into !FdoAnnotationPropertyDefinition and !FdoAnnotationTextElementClass types, multiple Annotation definitions can then be created and added to a single feature class definition, each named uniquely and pointing to a distinct !TextElement class. 
 
+===== Enhanced FDO Class and Property Types =====
+
+In order for the !AnnotationTextElement class type to be recognizable when reading an FDO schema, the FDO API Class Type enumeration will be extended to include an enumeration value for type !AnnotationTextElementClass.  
+
+
+{{{
+enum FdoClassType
+{
+    FdoClassType_Class,
+    FdoClassType_FeatureClass,
+    ...
+    ...
+    FdoClassType_AnnotationTextElementClass
+};
+}}}
+
+This enumerated value will be returned by the implementation of 
+        
+
+{{{
+FdoClassType FdoAnnotationTextElementClass::GetClassType();
+}}}
+
+In order for the !AnnotationPropertyDefinition type to be recognizable when reading an FDO schema, the FDO API Property Type enumeration will be extended to include an enumeration value for type !AnnotationPropertyDefinition.  
+
+
+{{{
+enum FdoPropertyType
+{
+    FdoPropertyType_DataProperty,
+    FdoPropertyType_ObjectProperty,
+    FdoPropertyType_GeometricProperty,
+    FdoPropertyType_AssociationProperty,
+    FdoPropertyType_RasterProperty,
+    FdoPropertyType_AnnotationProperty
+};
+}}}
+
+This enumerated value will be returned by the implementation of 
+        
+
+{{{
+FdoPropertyType FdoAnnotationPropertyDefinition::GetPropertyType();
+}}}
+
+==== FDO Logical Schema to Physical Schema ====
+
+Using the same FDO classes and physical schema elements introduced in the above sections, here is an FDO code example on how an !ApplySchema Command would be executed to create a physical schema from an FDO logical schema.
+
+
+{{{
+// Create the schema
+FdoFeatureSchemaP schema = FdoFeatureSchema::Create(L"Default", L"");
+FdoClassCollectionP classes = schema->GetClasses();
+
+// Create the RoadAnnotation TextElements Class
+FdoAnnotationTextElementClassP txtElementClassDef = 
+    FdoAnnotationTextElementClass::Create(L"RoadAnnotation", L"");
+FdoPropertyDefinitionCollectionP txtElementProps = 
+    txtElementClassDef->GetProperties();
+FdoDataPropertyDefinitionCollectionP txtElementIdProps = 
+    txtElementClassDef->GetIdentityProperties();;
+
+// Create a ParentId property to hold the parent ID that owns the text element
+FdoDataPropertyDefinitionP dataProp = 
+    FdoDataPropertyDefinition::Create(L"ParentId", L"");
+dataProp->SetDataType(FdoDataType_Int32);
+dataProp->SetNullable(false);
+dataProp->SetReadOnly(false);
+dataProp->SetIsAutoGenerated(false);
+
+// The ParentId property is a class ID property
+txtElementProps->Add(dataProp);
+txtElementIdProps->Add(dataProp);
+
+// Explicitly set the ParentId property
+txtElementClassDef->SetParentIdentityProperty(dataProp);
+
+// Create a ParentId property so that Text Elements can be ordered
+dataProp = FdoDataPropertyDefinition::Create(L"SequenceId", L"");
+dataProp->SetDataType(FdoDataType_Int32);
+dataProp->SetNullable(false);
+dataProp->SetReadOnly(false);
+dataProp->SetIsAutoGenerated(false);
+
+// The SequenceId property is a class ID property
+txtElementProps->Add(dataProp);
+txtElementIdProps->Add(dataProp);
+
+// Explicitly set the SequenceId property
+txtElementClassDef->SetSequenceProperty(dataProp);
+
+// Create a string data property that will hold the Text Element Value
+dataProp = FdoDataPropertyDefinition::Create(L"TextValue", L"");
+dataProp->SetDataType(FdoDataType_String);
+props->Add(dataProp);
+
+// Explicitly set the Text Element Value property
+txtElementClassDef->SetTextValueProperty(geoProp);
+
+// Create a string data property that will hold the Text Element Attributes
+dataProp = FdoDataPropertyDefinition::Create(L"TextAttributes", L"");
+dataProp->SetDataType(FdoDataType_String);
+props->Add(dataProp);
+
+// Explicitly set the Text Element Attributes property
+txtElementClassDef->SetTextAttributesProperty(geoProp);
+
+// Create a Geometry Location property for the Text Element
+FdoGeometricPropertyDefinitionP geoProp = 
+FdoGeometricPropertyDefinition::Create(L"Location", L"");
+geoProp->SetSpatialContextAssociation(L"EPSG:4326");
+geoProp->SetGeometryTypes((int)(FdoGeometryType_Point)); // Point
+props->Add(geoProp);
+
+// Explicitly set the Geometry Location property
+txtElementClassDef->SetGeometryProperty(geoProp);
+
+// Create a Geometry LeaderLine property for the Text Element
+geoProp = FdoGeometricPropertyDefinition::Create(L"LeaderLine", L"");
+geoProp->SetSpatialContextAssociation(L"EPSG:4326");
+geoProp->SetGeometryTypes((int)(FdoGeometryType_MultiCurveString)); 
+props->Add(geoProp);
+
+// Explicitly set the Geometry LeaderLine property
+txtElementClassDef->SetLeaderLineProperty(geoProp);
+
+// Add the class to the schema
+classes->Add(txtElementClassDef);
+
+// Create the Read class
+FdoFeatureClassP classDef = FdoFeatureClass::Create(L"Road", L"");
+FdoPropertyDefinitionCollectionP props = classDef->GetProperties();
+FdoDataPropertyDefinitionCollectionP idProps = classDef->GetIdentityProperties();;
+
+// Create an Annotation property to allow reference to the TextElements 
+FdoAnnotationPropertyDefinitionP annotationProp = 
+    FdoAnnotationPropertyDefinition::Create(L"Annotation", L"");
+props->Add(annotationProp);
+
+// Create a Road Identity property
+dataProp = FdoDataPropertyDefinition::Create(L"FeatId", L"");
+dataProp->SetDataType(FdoDataType_Int32);
+dataProp->SetNullable(false);
+dataProp->SetReadOnly(false);
+dataProp->SetIsAutoGenerated(true);
+
+// The FeatId property is an ID property
+props->Add(dataProp);
+idProps->Add(dataProp);
+
+// Set the annotation identity property
+annotationProp->SetIdentityProperty(dataProp);
+
+// Create a Name property
+dataProp = FdoDataPropertyDefinition::Create(L"Name", L"");
+dataProp->SetDataType(FdoDataType_String);
+props->Add(dataProp);
+
+// Create a Width property
+dataProp = FdoDataPropertyDefinition::Create(L"Width", L"");
+dataProp->SetDataType(FdoDataType_Double);
+props->Add(dataProp);
+
+// Create a Geometry to contain the Road location
+geoProp = FdoGeometricPropertyDefinition::Create(L"Location", L"");
+geoProp->SetSpatialContextAssociation(L"EPSG:4326");
+geoProp->SetGeometryTypes((int)(FdoGeometryType_CurveString)); // CurveString
+props->Add(geoProp);
+
+// Set the geometry property for the class
+classDef->SetGeometryProperty(geoProp);
+
+// Create a Geometry Envelope to contain the TextElements extents
+geoProp = FdoGeometricPropertyDefinition::Create(L"TextEnvelope", L"");
+geoProp->SetSpatialContextAssociation(L"EPSG:4326");
+geoProp->SetGeometryTypes((int)(FdoGeometryType_CurveString)); // CurveString
+props->Add(geoProp);
+
+// Set the annotation envelope property
+annotationProp->SetTextEnvelopeProperty(geoProp);
+
+// Create a string data property that will hold the default TextElement Value
+dataProp = FdoDataPropertyDefinition::Create(L"TextDefaultValue", L"");
+dataProp->SetDataType(FdoDataType_String);
+props->Add(dataProp);
+
+// Explicitly set the Text Element Value property
+annotationProp->SetDefaultTextValueProperty(dataProp);
+
+// Create a string data property that will hold the default TextElement Attributes
+dataProp = FdoDataPropertyDefinition::Create(L"TextDefaultAttributes", L"");
+dataProp->SetDataType(FdoDataType_String);
+props->Add(dataProp);
+
+// Explicitly set the Text Element Attributes property
+annotationProp->SetDefaultTextAttributesProperty(dataProp);
+
+// Add the class to the schema
+classes->Add(classDef);
+
+// Execute ApplySchema to create the schema
+FdoIApplySchemaP applyschema = 
+    (FdoIApplySchema*)(connection->CreateCommand(FdoCommandType_ApplySchema));
+applyschema->SetIgnoreStates(true);
+applyschema->SetFeatureSchema(schema);
+applyschema->Execute();
+}}}
+
+
+
 == Implications ==