SP3d Guidlines For Reference Data Guide
SP3d Guidlines For Reference Data Guide
: XXXX-XX-XXX-XXXXX-XXX-XX-X
SP3D Guidelines for Reference Data
October 2010
Instrumentation and Control Department
Descon Integrated Projects (Pvt.) Limited.
IT RESOURCE GROUP
Table of Contents
1. General 4
1.1 Scope 4
2. Overview Of Reference Data......................................................................................................5
2.1 Fork Flow Of Creating Reference Data....................................................................................5
2.2 Reference Data Types...............................................................................................................6
2.2.1 Graphical Data.......................................................................................................................6
2.2.2 Non-graphical Data................................................................................................................7
2.3 How the Catalog Database Fits In.............................................................................................8
2.3.1 Reports Database & Schema..................................................................................................9
2.3.2 Site Database & Schema........................................................................................................9
2.3.3 Catalog database & Schema...................................................................................................9
2.3.4 Model database .....................................................................................................................9
2.4 Using the Excel Migration Tool................................................................................................9
2.4.1 Excel Migration Dialog Box................................................................................................10
2.4.2 Migrate Excel Workbooks to the Current Version...............................................................12
3. Using Excel Workbooks to Configure Reference Data.............................................................13
3.1 Delivered Excel Workbooks...................................................................................................13
3.2 Naming Rules Reference Data................................................................................................14
3.2.1 Name Limitations in Reference Data...................................................................................14
3.3 Minimum Reference Data.......................................................................................................14
3.4 Common Sheets in the Workbooks.........................................................................................16
3.4.1 Revision History Sheet........................................................................................................16
3.4.2 Legend Sheet.......................................................................................................................16
3.4.3 Index Sheet..........................................................................................................................16
3.4.4 GUIDs (Globally Unique Identifiers) Sheet.........................................................................16
3.4.5 CatalogRoot Sheet...............................................................................................................17
3.4.6 ClassNodeType Sheet..........................................................................................................17
3.4.7 R-ClassNodeDescribes Sheet...............................................................................................17
3.4.8 R-Hierarchy Sheet...............................................................................................................17
3.4.9 Custom Interfaces Sheet......................................................................................................17
3.4.10 Part Class Sheet.................................................................................................................17
3.5 Adding and Modifying Custom Interfaces..............................................................................18
3.5.1 Add User Attributes to a Class.............................................................................................19
3.6 Add Part Classes to New Classification Folders.....................................................................20
3.7 Add Part Classes to Existing Classification Folders...............................................................22
4. Using the Bulkload Utility........................................................................................................25
4.1 Bulkload Dialog Box..............................................................................................................26
4.1.1 Excel files............................................................................................................................26
4.1.2 Excel codelist files...............................................................................................................26
4.1.3 Bulkload mode.....................................................................................................................27
4.1.3.1 Bulkload to a New Catalog...............................................................................................27
4.1.3.2 Append to an Existing Catalog.........................................................................................28
4.1.3.3 Add, Modify or Delete Records in Existing Catalog.........................................................28
4.1.3.4 Delete and Replace Records in Existing Catalog..............................................................30
4.1.4 Create flavors.......................................................................................................................30
4.1.5 Database Type.....................................................................................................................31
4.1.6 Database name.....................................................................................................................32
4.1.7 schema Information.............................................................................................................32
4.1.7.1 Catalog schema server......................................................................................................33
1. GENERAL
This is a guideline which describes how to use the SP3D Reference Data for Catalog
Task in SP3D Project.
You must have reference data to use the software to design process plants. Reference data
can be Graphical or Non-graphical in nature.
A workflow that keeps the data in the Excel workbooks synchronized with the
changes you make in the Catalog task.
1.1 SCOPE
This document is limited to instrument discipline scope of work related to the SP3D
reference databases that contain graphic and property information about the types of
objects that you can place in your model.
Catalog data includes the parts that you place in the model, such as cable tray
components and equipment. Specification data includes the rules that govern how those
parts are placed and connected.
The catalog information is also user-customizable in terms of its data structure. You can
organize the delivered reference data into groups in the way that makes sense for your
company or project. For example, you can group the objects by type. These groups are
often referred to as classes.
You can translate and migrate previous reference data to use with the current software.
The software provides tools to assist in the translation and migration processes.
To add a large amount of reference data to the catalog, use the Bulkload utility to transfer
Excel workbook data into the Catalog database. Each workbook is organized in a
particular way in order to specify the objects, their properties, and the relationship of the
objects to the rest of the hierarchy.
The overall workflow of creating reference data for the software can be summarized as:
A. You can create graphical data in Symbol 2D, Solid Edge, or Visual Basic.
Figure 2.1
For example, reference data includes graphical symbols that you can place in the model,
such as equipment or piping components. Reference data also includes non-graphical,
tabular data, such as catalog data and specification data.
"One-off" equipment design can be done using Solid Edge, which provides several
graphical primitives to build the geometry of the equipment definition. The geometry can
be parametrically defined but requires Solid Edge to be loaded on every client
workstation that will be used to place the equipment in the model. Or, you must make
sure that every possible size has been generated and cached in the catalog.
This type of data includes specifications, rules, and other tabular information.
CLASSES
A part class is a group of related parts. For example, a part class can be an Inline
Centrifugal Fan. The parts could be models that run 1/3, 1/6, or 1/8 horsepower.
PARTS
SPECIFICATIONS
Specifications are the collection of standards for the types of objects placed in a model.
You can customize specifications based on what makes sense for your company
RULES
Rules determine how the specifications are applied. You can customize rules as per
requirement of company.
TABLES
The reference data tables in the Catalog contain non-graphical property data. For
example, the codelists in the AllCodeLists.xls workbook are stored in tables in the
Catalog database.
(A)
Reports Database
(E) (F)
Site Schema Database Catalog Schema Database
(G)
Reports Schema Database
Figure 2.2
A Plant is all three databases used together: Catalog database, Catalog Schema, and
Model database
To view the hierarchy and contents of the Catalog, start the Catalog task. To view the Site
database, start the Project Management task.
The Reports database and schema interact with the other databases to generate tabular
reports from the model data.
The Site database and schema are containers for the other databases. The Site database
stores work-breakdown and user access for the model. A site database can have multiple
plant and catalog databases. Typically, there is one site database set for each customer
location.
The Catalog database contains reference data, which includes part dimensions and
industry standards.
Using the Bulkload utility, you can create a starting Catalog database and schema from a
data file delivered with the software. You can use your own custom Excel workbooks and
custom symbols to create a new Catalog database specifically for your project.
After creating the Catalog database, you can modify the delivered reference data. Two
methods exist to modify the reference data: edit the workbooks in Excel and bulk load the
data, or use the commands in the Catalog task to edit the data (Bulkload is not necessary
in that case).
The Model database contains all instances of parts in the physical model of the plant.
The Excel Migration tool allows you to update your reference data Excel workbooks to
fit with the current version of the software.
To move to the current version, you must use the delta files located in
[Product Directory] \ CatalogData \ BulkLoad \ AdditionalDataFiles \.
This dialogue box allows you to set options for converting Excel workbook reference
data to the current version of the software.
V5 FORMAT FILE
It specifies the Version 5.0 Excel workbook. This workbook is the file that you want to
migrate to the current version. You can migrate only one workbook at a time.
LOG FILE
It specifies the log file that records the progress of the migration process. The default
name of the log file is the name of the Excel workbook in the V5 Format File box,
appended with V6 and a .log extension. Specifying a log file is mandatory. If you do not
specify one, a message on the status bar of the dialog box asks you to specify the log file.
Figure 2.3
CONVERTED FILE
It specifies the Version 6.0 Excel workbook. The default name is the Excel workbook
name in the V5 Format File box, appended with V6. If this file already exists before the
migration begins, the utility asks if you want to overwrite it.
CATALOG DATABASE
SCHEMA DATABASE
It specifies the Catalog Schema database. The Catalog database and schema information
is used to migrate the GUIDs sheets.
CONVERT TO V6 FORMAT
NOTE:
When you prepare workbooks for migration, you must format cells with the Text option
if the information in the cell contains a leading zero (for example, a part number). You
can set the Text option in the Category list on the Format Cells dialog box. If you use a
cell formatted with the General option, data will be lost during the migration.
You must manually migrate some data, such as codelists and naming rules.
Sheets that are new in the current version will not have data on them after the
migration tool runs. You must enter the relevant data and then bulk load.
The Excel Migration tool does not account for any changes made in the code for
a symbol, such as the addition of a new attribute to the symbol.
The reference data for Structure and Hangers and Supports is not migrated.
3. In the V5 Format File box, browse to select the Excel workbook that you
want to migrate. You can migrate only one workbook at a time.
4. In the Log File box, browse to specify the log file that provides the results
of the migration process. The default name of the log file is the name of the Excel
workbook in the V5 Format Files box, appended with V6 and a .log extension.
6. In the Catalog information area, specify the Catalog database server and
Catalog database name.
Use the Bulkload Utility for any additions, modifications, and deletions into the Catalog
database. The Catalog task was read-only, except for the capability to modify permission
group and status on the Properties dialog for certain reference data.
Note:
To edit the Excel data, you must understand the content and format of the workbooks.
Many of the delivered workbooks contain data unique to a given function or discipline.
For example, there are separate Excel workbooks for Cabling, Structure, and so forth.
There are also common workbooks that contain data for more than one discipline.
HS_Anvil_Codelist.xls,
HS_Assembly.xls,
HS_Assembly_Codelist.xls,
HS_HgrAisc.xls, HS_LRParts.xls,
HS_System.xls, HS_Utility.xls,
HS_Utility_Codelist.xls
ModuleTypes.xls Defines part classes for the
Copy to Catalog and Paste from Catalog
commands.
Each task in the software that creates new parts in the model automatically generates a
name for the parts using defined rules.
You must consider naming limitations when creating and modifying data used by the
software. Naming limitations include restrictions on the length and content of names,
such as database table, view, and column names. These restrictions also affect reference
data names.
The following table shows the name length limitations in the reference data.
When you create a new catalog, you must bulk load a minimum amount of reference data
in order for the software to function properly. You must bulk load the workbook(s) for
the disciplines that you want to work with and any other workbooks with related data
such as codelists, naming rules, and so forth.
When using the Bulkload utility to create a new catalog, you must use the AppRepos.dat
template file to create the Catalog Schema. This file is located in [Product
Directory]\DatabaseTemplates on the administrator computer.
Cable AllCodelists.xls
Cabling.xls
GenericNamingRules.xls
Cable Tray AllCodelists.xls
AllCommon.xls
CableTray.xls
GenericNamingRules.xls
Cableway AllCodelists.xls
AllCommon.xls
CableWay.xls
GenericNamingRules.xls
Conduit AllCodelists.xls
Conduit.xls
GenericNamingRules.xls
Drawings and Reports AllCodelists.xls
Drawings.xls for volume drawings
BulkLoadIsoKeys.xls for isometric drawings or spooling
Reports.xls for report templates
Equipment and AllCodelists.xls
Furnishings AllCommon.xls
Equipment.xls
EquipmentComponent.xls
GenericNamingRules.xls
InsulationData.xls
Shapes.xls for designed equipment
Grids AllCodelists.xls
GenericNamingRules.xls
Hangers and Supports AllCodelists.xls
GenericNamingRules.xls
HS_Anvil.xls, HS_Anvil_Codelist.xls,
HS_Assembly.xls, HS_Assembly_Codelist.xls
HS_HgrAisc.xls
HS_Lisega.xls, HS_Lisega_Codelist.xls
HS_LRParts.xls
HS_System.xls
HS_Utility.xls, HS_Utility_Codelist.xls
Space Management AllCodelists.xls
GenericNamingRules.xls
Shapes.xls for volumes
SpaceMgmt.xls
The following sheets appear in most of the Excel workbooks, which are located in the
[Product Directory]\CatalogData\BulkLoad\DataFiles.
This sheet contains comments that describe modifications to the workbook, the person
who made the modifications, and the date modified. Updates to this sheet are not
mandatory, but they are recommended for internal tracking purposes. This sheet is not
processed by the Bulkload utility. The text on this sheet is purely for the benefit of
change tracking, notes, and revision records.
This sheet provides information about common conventions in the workbook. It lists the
keywords and the associated meanings. This sheet is not processed by the Bulkload
utility.
This sheet provides a list of all the classes in the workbook and links to each sheet.
This sheet is not processed by the Bulkload utility.
This sheet defines the name of the root folder for the data in a workbook. The catalog
root is the highest allowable level in the hierarchy for a discipline.
This sheet allows you to create classification folders in the Catalog hierarchy. A
classification folder is similar to a folder in Windows Explorer, except a classification
folder can only contain other folders, not individual items. The ObjectName column
contains the folder object name, which represents the internal name for the node in the
software. The Name column contains the identifier name that appears in the Catalog task
user interface.
The ClassNodeType sheet does not specify the hierarchy of the classification folders.
This sheet defines the parent-child relationships between the classification folders and the
part classes. This sheet uses the object names of the classification folders and the names
of the part classes. The RelationSource column contains the parents (classification
folders), and the RelationDestination column contains the children (part classes).
This sheet defines the parent-child relationships among the folders in the Catalog
hierarchy that are above the classification folders. This sheet uses the object names of the
folders.
This sheet defines user attributes that are in the reference data. This sheet describes the
names of attributes, such as length and weight, and contains information about the units
of measurement. The Custom Interfaces sheet also defines links between reference data
parameters and parametric symbol arguments.
Many of the reference data workbooks contain part class sheets. Each part class sheet
consists of the class definition and the parts definition. The class definition is marked
with the keyword Definition, and the parts definition is marked with the keywords
Head/Start/End.
To add a part class to the Catalog hierarchy, you must edit the Excel workbook for your
task. Save a backup copy, before you modify a workbook. That way, you can always bulk
load the previous data. You also must add a specific part class sheet to the workbook.
You can copy an existing part class sheet and modify it as necessary.
The addition and modification of custom interfaces, categories, and attributes in catalog
should be planned. To bulk load interfaces and attributes, you must have write or full
control on at least one of the catalog permission groups, which are defined in Project
Management.
INTERFACES
You can create a new interface on the Custom Interfaces sheet and then add it to the
catalog using the Bulkload utility
You can delete an existing interface by typing the letter D in the first column of the
interface row.
You should not modify the name of an interface, but you can change the category to
which it was assigned.
CATEGORIES
Categories are listed in the Property Categories codelist. If you want to use a new
category name on an interface, you must add the new category name in the codelist and
then bulk load. You can modify category names by editing the codelist.
Categories are plant-wide and catalog-dependent. If multiple models make use of the
same catalog, then the two models' interfaces and attributes are categorized identically.
ATTRIBUTES
You cannot modify or delete existing attributes after bulk loading them. However, you
can add attributes to existing interfaces by typing A in the first column of the rows to add.
If you try to delete or modify existing attributes, the Bulkload utility will include
warnings in the log file.
3. Click Insert > Worksheet, and add two sheets: CustomInterfaces and
CustomClassInterfaceList.
This interface will contain the attributes that you want to add.
Begin the interface name with "IJUA".
Figure 3.1
If you do not type a category name (leave the column blank), the custom
attributes will appear in the Standard category in the software.
To add a new category, you must add the category name to a codelist. For
example, in the delivered AllCodeLists.xls, you would add the category name to
the PropertyCategories sheet and then bulk load. The short description text and
the text on the CustomInterfaces sheet must match.
9. In the InterfaceName column, type the same name you specified for the new
interface on the CustomInterfaces sheet.
11. Bulkload the workbook in the Append mode, to ensure the schema update and
regeneration of the views in the database. If you are using any codelists, remember to
add the codelist files on the Bulkload dialog box.
When you add a part class to a new classification folder, you must edit the
ClassNodeType, R-Hierarchy, and RClassNodeDescribes sheets. Clear all the existing
data on these sheets and fill it as per requirement.
In this example we shall add a Part class (Cable Tray Cross) to a new classification
folder Cable Tray Objects under the Cableway as shown in Fig 3.2.
Figure 3.2
1. On the ClassNodeType sheet, insert a row before the End keyword and enter a
name for the classification folder in the ObjectName column.
Type CableTrayObjects in the ObjectName column as shown in Fig 3.3. The object
name of the classification folder is important because you will use it again in this
procedure.
Also on the ClassNodeType sheet, enter the user interface name for the classification
folder in the Name column. This name appears in the Catalog task user interface.
Type Cable Tray Objects as shown in Fig 3.3.
Figure 3.3
2. On the R-Hierarchy sheet, relate the folder object names in the hierarchy. The
default hierarchy contains CatalogRoot in the RelationSource column and
RefDataCablewayRoot in the RelationDestination column.
Figure 3.4
Note:
All folders must be related in the hierarchy on the R-Hierarchy sheet, except the
classification folder and the part class (these folders are related on the R-
ClassNodeDescribes sheet).
In the RelationDestination column, type the name of the part class, CTCross. This
name must be same as name of Part Class Sheet as shown in Fig 3.5.
Figure 3.5
Figure 3.6
5. Mark all of the rows that you added on the ClassNodeType, R-Hierarchy, and
R-ClassNodeDescribes sheets with the letter A.
When you add a part class to an existing classification folder, you just need to edit the R-
ClassNodeDescribes sheet.
1. Open a reference data workbook in Microsoft Excel. We shall follow the same
example which we used in last topic.
Figure 3.7
Figure 3.8
This name must match with the part class sheet name as indicated through double
arrow in fig 3.8.
Figure 3.9
Note:
Figure 4.1
Bulkloading is a process that imports data from the Excel workbooks into the Catalog
database. Because there is no way to export data from the Catalog database back into
Excel, these workbooks are the "master" copy of your reference data and should be
backed up appropriately before you make modifications and begin the loading process.
The time taken by the bulk loading process varies. More time is required when a schema
change (such as adding a codelist value, a new interface, or a part class) is made. Schema
changes trigger the re-creation of the views in the database. The loading process has
several modes available.
This utility sets options for adding reference data from Excel workbooks to the Catalog
database.
It displays one or more Excel workbooks for loading into the Catalog database. These
workbooks contain the reference data. The software bulk loads the files in the order they
are listed in the Excel files box.
Figure 4.2
Add
Delete
Removes currently selected Excel workbooks from the Excel files box.
It lists the codelist Excel workbooks. Click the browse button to access the Open dialog
box, which allows you to select one or more Excel codelist workbooks for loading into
the Catalog Schema database. To remove a codelist workbook, you must click Reset to
clear all boxes on the Bulkload dialog box.
Figure 4.3
You must select a codelist workbook when one of the following criteria is met:
You have updated the codelist information and want to bulk load the modified
data into the live database.
You are creating a new catalog with the Bulkload to a new catalog option.
For all other instances, the Excel codelist files box can remain empty.
It allows you to select the type of bulkload. There are different modes available in
Bulkload Utility to load data as shown in Fig 4.4.
Figure 4.4
You should use the New mode when you are creating a new Catalog database.
Figure 4.5
The New mode is different from the Append and the Add/Modify/Delete modes in that a
live database set (Catalog and Catalog Schema) is not already available on the server. In
the New mode, you choose the database type and enter a name for the catalog that you
want to create. You also select a template file to create the Catalog Schema.
When you run the Bulkload utility in the New mode, the utility creates interfaces.
You can use the Append mode when you want to add data from many new workbooks or
worksheets to the Catalog database. When you use this mode, the software scans the data
and adds only the new classes and parts to the database. The software does not observe
any Add/Modify/Delete flags in this mode.
Figure 4.6
The Append mode is normally used for large updates to the catalog.
The Add/Modify/Delete mode is best used when you are modifying the database on a
smaller scale or when you are modifying preexisting classes. In this mode, the Bulkload
utility scans the workbook(s) for flags at the beginning of each row. The table below
defines the flags and the actions associated with them.
If the Bulkload utility sees an M at the beginning of a row, the software modifies that
entry in the Catalog database with the changes in that row.
The Bulkload utility removes the A and M designations from the workbook(s) during the
loading process. However, the rows marked with D are still marked with D. You can
open the workbook(s) with rows marked D and comment out those rows manually after
the bulkload. Type the ! symbol at the beginning of each row that you want to comment
out. If you do not remove or comment out the deleted rows, you will receive errors the
next time that you bulk load, because the Bulkload utility will attempt to delete objects
that no longer exist in the catalog.
Figure 4.7
You should be aware of the rules that affect deleting part classes and parts. You can
delete a part class by typing a D at the beginning of the Definition row on the part class
sheet. When you delete a part class, you can reuse the part class name in the same
database set. If you delete parts (line items within a class, not the class itself), you can
also reuse the names of the parts.
To modify a part name, you can use a combination of deleting and adding operations.
Copy a part row, insert the row in the Head/Start/End section, and change the name.
Then mark the original row with D and the inserted row with A. The row marked with D
must come before the row marked with A going from top to bottom on the sheet. The
reason is that the bulkload operations occur sequentially from top to bottom on a sheet.
The Delete and Replace mode is useful when you would like to replace all the data in the
Catalog database with the data currently in Excel workbooks. New part classes are
appended to the Catalog.
Figure 4.8
This option has some limitations. You can change the definition of a part class, but you
cannot change the part class type. Also, this option is not supported for sheets common to
all the workbooks, including the ClassNodeType and R-Hierarchy sheets.
If you are re-creating part classes or parts, you must include the RClassNodeDescribes
sheets in the workbooks in order to establish relationships among the hierarchical nodes
in the reference data.
The Create flavors option computes and stores in the catalog the specific geometry for
each different size of a part class. Flavors apply to Solid Edge parts only. When we mark
Create Flavor box as check then we receive a pop up as shown in Fig 4.9. You can use
the Create flavors option with any of the bulkloading modes.
For example, the reference data might include two parts with different symbol input
parameters. Both parts refer to the same Solid Edge assembly set.
At the time of bulkloading, if you select the Create flavors option, then the Bulkload
utility creates a one-to-one relationship symbol using the symbol parameters for each part
and stores this symbol in the Catalog database. If you do not select the Create flavors
option, then at placement time in the model, the workstation placing the symbol performs
the parameterized changes to the symbol, based on the reference data, before the
placement.
Figure 4.9
You can add flavors for Solid Edge parts that are already in the catalog. Mark the rows
for the parts with M and bulk load in the Add/Modify/Delete mode with the Create
flavors option selected.
Select the type of database, either ORACLE or MSSQL. This box is enabled only if you
are creating a new database set.
Figure 4.10
The following box is labeled Database server name if you chose MSSQL. It is labeled
Oracle Service if you chose ORACLE
Figure 4.11
Oracle Service
Select the name of the Oracle net service for the Catalog database connection.
Figure 4.12
Select the name of the Catalog database into which you want to load reference data. If
you are using the Bulkload to a new catalog mode, select <New Database> and type a
name in the Database name box. If you select a site or model database in this box, the
utility displays a notification message.
Figure 4.13
The following two boxes shown in Fig 4.14 appear only for the Append and
Add/Modify/Delete modes.
Figure 4.14
It displays the name of the server that stores the Catalog Schema database. This server is
the same as the name in the Database server name box.
For pre-existing catalog sets, select the name of the Catalog Schema database.
If the necessary schema database does not appear in the Schema database name
list, click <Refresh>. This situation occurs if you created a schema database after
opening the Bulkload dialog box.
If you are using the Bulkload to a new catalog mode, the Catalog schema server and
Catalog schema database boxes do not appear. Instead, complete the box labeled
Template file to be used to create schema
Figure 4.15
For MSSQL, use the AppRepos.dat file to create the Catalog Schema. This file
is located in [Product Directory]\DatabaseTemplates on the server computer.
For ORACLE, use the AppRepos.dmp file to create the Catalog Schema. This
file is located in [Product Directory]\DatabaseTemplates on the server computer.
Click the browse button to specify a location and name for the log file, which records the
bulkloading status, including any error messages. The log file name must follow
operating system constraints and cannot contain any special characters. However, you
can use the backslash when specifying a UNC path to a log file.
Figure 4.16
You must use the file extension .log for the log file.
You must have write privileges to the folder to which you are saving the log file.
Figure 4.17
It displays the location for symbols in Solid Edge or Visual Basic format. In the Append
and Add/Modify/Delete modes, the Bulkload utility automatically populates this box with
the current symbol location. For these modes, you should not modify the location unless
you are sure that you want to change the symbol path for the catalog. In the New mode,
you can click the browse button to specify the location. You can also change the location
in the Project Management task on the Properties dialog box.
This location is stored in the Catalog database and is accessed by the other tasks at run-
time in order to read and compute the symbol files. To allow all workstations to access
the symbols, specify a UNC path (for example, \\MyServer\Symbols) to a shared folder
on a remote computer, such as the server. At a minimum, users need read access to this
share. They need change access in order to modify the symbols.
You can also specify a path (such as D:\Symbols) on the local computer, but this action
does not allow other workstations to access the symbols.
4.1.10 LOAD
1. Click Start > Programs > Intergraph SmartPlant 3D > Database Tools >
2. In the Excel files box, specify the Excel workbooks to load by clicking Add. You can
select more than one workbook to bulk load. Hold CTRL and click each workbook
in the Open dialog box.
3. In the Excel codelist files box, click the browse button to specify the codelist
workbooks. You must specify a workbook in this box if you are creating a new
catalog, adding a new codelist, or modifying an existing codelist. In all other cases,
you are not required to populate this box.
Mode Description
Bulk load to a new catalog Creates a new Catalog database.
Append to existing catalog Adds new classes only to an existing
database.
Add, modify, or delete records in Reads flags in Excel workbook to add,
existing catalog modify, or delete data.
Delete and replace Deletes all records in the Catalog database
and replaces with data in Excel
workbooks. New part classes are
appended to the Catalog.
5. If you want to store geometry for each unique part defined by the Solid Edge model,
select Create flavors.Do not select Create flavors when you are creating
symbols.If you are loading Solid Edge flavors, you must have Solid Edge installed
on the bulkload computer.
If you selected ORACLE, select the name of the Oracle net service for the
Catalog database connection in the Oracle Service box. The service must exist
before you choose it in this box.
7. In the Database name box, select the name of the Catalog database that you want to
update with new reference data.
To create a new database, select <New Database>, and you can type a
name for the new database.
8. If you are modifying an existing catalog, select the Catalog Schema database name in
the Schema database name box. The Schema server name box is read-only.
9. If you are creating a new catalog, click the browse button beside the Template file to
be used to create schema box to specify the template file for the Catalog Schema.
For MSSQL, use the AppRepos.dat file to create the Catalog Schema.
This file is located in [Product Directory]\DatabaseTemplates on the server
computer.
For ORACLE, use the AppRepos.dmp file to create the Catalog Schema.
This file is located in [Product Directory]\DatabaseTemplates on the server
computer.
10. In the Log file box, click the browse button to specify the name and location of the
log file.
You must have write privileges to the folder in which you are saving the
log file.
You must use the file extension .log for the log file.
11. If you are bulk loading to a new catalog, click the browse button under Symbol and
custom program file location and select a shared symbol folder on the server.
12. Click Load. You can see messages in the status bar of the Bulkload utility while it is
running.
Figure 4.18
13. Open the log file to check for any errors or warnings in the bulkloading process. You
can quickly scan the Error Analysis section at the end of the log file to check for
errors.
Figure 4.19
Note:
You can modify the Excel workbooks and bulk load again to correct errors.The default
location for reference data workbooks is
[Product Directory] \ CatalogData \ BulkLoad \ DataFiles.