Learn about custom schema and mapping tools - Intergraph Smart 3D - Administration & Configuration - Hexagon

Intergraph Smart 3D Project Management

Language
English
Product
Intergraph Smart 3D
Subproduct
Project Management
Search by Category
Administration & Configuration
Smart 3D Version
13

Smart 3D provides the definition of classes, interfaces, properties, and mappings for a basic set of items common to most Reference 3D models. You can extend the delivered Reference 3D schema to include the addition of new classes and properties, and to extend the classification hierarchy with these new classes. These extensions and their mappings are specified in Excel .xls spreadsheets.

Customized Schema File

CustomReference3D adds customized classes, interfaces, properties, and mappings to the Smart 3D schema. These additions define items and their attributes in a Reference 3D model.

CustomR3DSchema.xls contains the definitions of the classes, interfaces, properties, and classification nodes you want to add to the schema definition. If you create this file, place it in the Reference3DComponents subfolder of the SharedContent folder. A template file is delivered in the [Reference Data Product Folder]\SharedContent\Data\ Reference3DComponents\Templates folder.

To add new object types or properties, copy this file to the Reference3DComponents folder of the active SharedContent folder for the respective catalog. Modifications to the template impact all Reference 3D models attached to the active model and other models sharing the same catalog. If you make modifications to the template, increase the version number on the PackageInformation sheet.

Customized Mapping File

CustomP3DtoR3Dmapping contains unmapped properties that come from the reference source and do not have matching properties in the Reference 3D schema. They have source information but no target information. When encountered in the input data, unmapped properties identified in the custom mapping file are assigned to Reference 3D objects.

CustomP3DtoR3Dmapping.xls contains the class-to-class and interface/property-to-interface/property mapping required to map classes and properties from Smart 3D schema to classes and properties in the Reference 3D schema. A template file is delivered in the [Reference Data Product Folder]\SharedContent\Data\Reference3DComponents\Templates folder. To use this template file, place it in the same folder as the .zvf and .xml/.drv input files of the respective R3D model. Changes there are specific to an individual Reference 3D model.

When publishing through SmartPlant integration, the data model published from Smart 3D is called the P3D schema.

The Rules

  • New classes, interfaces, and properties can be added in the CustomReference3D schema.

  • An interface can be added to a class in either the delivered Reference3D package or the user-defined CustomReference3D package.

  • A new property cannot be added to an existing interface defined in the delivered Reference3D package.

  • An existing property defined in the delivered Reference3D package cannot be modified or deleted from its interface.

  • Any mapping defined in the delivered mapping files cannot be overwritten.

    For example, suppose a mapping exists between an interface/property pair defined in the P3D schema and an interface/property pair defined in the R3D schema. You cannot replace that mapping with one the interface/property pair defined in the P3D schema and a new interface/property pair defined in the CustomP3DSchema. If the CustomP3DToR3DMapping.xls workbook contains such overwrite, it is ignored during the data import and logged as a warning.

  • Any mapping defined in the delivered mapping files cannot be removed.

  • The delivered mapping files cannot be edited. The software ignores any changes you make. You can add required mapping by creating a CustomP3DToR3DMapping.xls file as defined above.

You can add a new property to an existing class that is defined in either the delivered Reference 3D package or the customized CustomReference3D package defined in CustomR3DSchema.xls. Create a new line on the following worksheets:

  1. Define a new class in the Custom Reference 3D package. For more information, see Classes Worksheet.

  2. Define a new interface in the CustomReference3D package. For more information, see Interfaces Worksheet.

  3. Define the new property of the new interface in the CustomReference3D package. For more information, see InterfaceAttributes Worksheet.

  4. Define in the CustomReference3D package that the class implements the new interface. For more information, see ClassInterfaces Worksheet.

  5. Define a Business Object Classification (BOC) node in the Custom Reference 3D package. For more information, see BOCNodes Worksheet.

  6. Define in the CustomReference3D package the interface that identifies the new BOC node. For more information, see BOCDefiningInterfaces Worksheet.