安装和配置BMIDE——升级BMIDE

一、BMIDE升级过程

要安装较新版本的BMIDE，请执行以下步骤：

1.安装BMIDE的新版本

2.将旧项目迁移到新的数据模型格式。

   您还可以创建新项目。

3.如果您的项目有任何相关的模板dependent templates，请使用Teamcenter Environment Manager (TEM)工具将相关的模板添加回项目中。在“Feature Maintenance功能维护”面板中，选择“Add/Update Templates for working within the Business Modeler IDE Client”。

4.迁移过时的首选项。

5.如果您有以前版本的服务器代码自定义项，则必须重新生成代码并重新构建库。

6.卸载以前版本的BMIDE。

注意：

如果升级Business Modeler IDE是升级Teamcenter的大型过程的一部分，请参见Teamcenter升级。

二、将模板项目升级为当前数据模型格式

如果安装了新版本的BMIDE，则可以使用以前版本中的项目，但首先必须将项目升级到新的数据模型格式。此升级是必要的，因为用于数据模型文件的XML格式可能在不同的产品版本之间发生变化，必须调整项目以适应新的XML格式。您可以通过三种方式升级项目：

（1）Welcome window欢迎窗口

当您在安装BMIDE后第一次打开它时，会显示欢迎窗口。点击本窗口中的“Upgrade your BMIDE template from a previous Teamcenter release从以前的Teamcenter版本升级您的BMIDE模板”链接，运行import wizard导入向导。这会将您的模板导入到新版本的BMIDE中。

（2）导入向导

如果您的模板项目尚未在工作区中，请将其导入到新版本的BMIDE中：

1）选择文件→导入。

2）在“Import导入”对话框中，选择BMIDE→Import a BMIDE Template Project（导入BMIDE模板项目）。在导入项目时，BMIDE会自动将项目升级为新的数据模型格式。

（3） Re-run Template Project Upgrade wizard 重新运行模板项目升级向导。

如果您的模板项目已经在工作区中，请将其升级到BMIDE的新版本：

1）在菜单栏上选择“BMIDE→Upgrade Tools升级工具→Re-run Template Project Upgrade Wizard重新运行模板项目升级向导”

向导运行。

2）在“Template Project Upgrade 模板项目升级”对话框中，单击“Project项目”框中的箭头选择需要升级的项目。

3）单击Finish。

项目升级为新的数据模型格式。控制台视图显示升级成功或失败的消息。

升级完成后，打开Project Files文件夹，检查outputlupgrade文件夹下的日志中是否有错误或警告信息。

警告：

模板项目升级后，无法在以前版本的Teamcenter中安装或升级。要查找模板升级到的版本，请打开模板项目的extensions文件夹中的dependency.xml文件，查看currentTemplateVersion(当前版本)的值。

当您升级到最新版本的Teamcenter时，升级自定义模板可能是更大过程的一部分。

1. 将旧项目导入到最新版本的BMIDE中。这会将数据模型更新到最新的数据模型版本。

2. 在BMIDE中打包模板。

3.将打包好的模板安装到升级后的服务器上。

三、重构创建操作Refactor create operations

创建操作在内存中创建对象，save操作将创建的对象提交到数据库中。业务对象的创建操作后应该跟一个保存操作，以便将在内存中创建的对象提交到数据库，例如：

ITEM create_item()

ITEM_save_item(itemTag) or AOM_save_with_extensions (itemTag)

ITEM_create_rev()

ITEM_save_rev(revTag) or AOM_save_with_extensions (revTag)

这种创建和保存模式要求附加到create message (operation) 创建消息(操作)上的任何后置操作都不应该假设创建的对象已经保存到数据库中，任何创建operation overrides操作覆盖也不应该做出这种假设。The create operation overridel refers to the override of the create operations创建操作覆盖引用了创建操作的覆盖（finallizeCreateInput,validateCreatelnput,setPropertiesFromCreatelnput,and createPost)对自定义业务对象。

当一个pre-Teamcenter 9.1自定义模板被取消分级时，Teamcenter迁移服务将识别所有被附加到以下所有create messages创建消息的现有的后置操作。并将它们添加到Fnd0MigratedPostActions全局常量的附加值列表中：

AE_create_dataset

ITEM_create

ITEM_create_rev

FULLTEXT_create

GRM_create

你可以打开the Global Constants Editor 全局常量编辑器来查看Fnd0MigratedPostActions全局常量的附加值列表。附加值的格式如下:

business-object-namellextension-namellsource-message-namelltarget-message-name

例如:

Item||autoAssignToProject||ITEM_create||IMAN_save

CAEAnalysisRevision||createDefaultDatasets||ITEM_create||IMAN_save

Dataset||setOrgOnCreationIIAE_create_datasetlIAE_save_dataset

FullText||setOrgOnCreation||FULLTEXT_create||AE_save_dataset

Thumbnail||CreateTNRelationForIR||GRM_create||IMAN_save

附加值列表中的所有“the create postactions创建的后置操作”都作为保存消息的后置操作自动分派(或执行)。这样，创建和保存模式对现有的创建的后置操作没有影响，这些后置操作在没有强制重构的情况下继续工作。新的创建后置操作和创建操作重写都必须不对新创建的对象进行任何数据库查询。

您可以执行以下过程来重构现有的创建的后置操作。(创建的后置操作的重构是可选的)：

1、通过选择File→Import导入→BMIDE→Import a BMIDE模板项目来升级teamcenter 9.1之前的项目

当项目升级时，运行后操作迁移服务脚本，来标识被附加到前面描述的创建消息的后置操作。您可以在升级日志中找到该服务。要查看升级日志，请打开Project Files文件夹并查看\output\upgrade文件夹。

2、打开全局常量编辑器以查看被添加到Fnd0MigratedPostActions全局常量的创建的后置操作：

检查每个创建后置操作的代码，并执行以下操作之一：

（1）创建后置操作不会对新创建的对象进行任何数据库查询，也不需要重构。

使用全局常量编辑器来修改Fnd0MigratedPostActions全局常量附件，方法是删除与该后置动作对应的附加值。一旦从这个全局常量附件中删除，后置动作就会像之前一样作为创建操作的后置动作执行。

（2）创建后置操作对新创建的对象进行数据库查询，并且可以重构。

a、修改后置操作代码，以便不对新创建的对象进行数据库查询。

b、使用全局常量编辑器来修改Fnd0MigratedPostActions全局常量附件，方法是删除与该后置动作对应的附加值。一旦从这个全局常量附件中删除，后置动作就会像以前一样作为创建操作的后置动作执行。

3、通过选择“BMIDE-Reports”运行“创建操作覆盖报告Create Operation Override Report”(此报告仅在升级模板项目后才会出现在可用报告列表中)。该报告包括对以下业务对象的创建操作的覆盖:

Dataset

Form

Item

ItemRevision

对于每个创建覆盖操作，检查代码并确保没有针对新创建的对象进行数据库查询。

四、将首选项迁移到数据模型对象（data model objects）

一些首选项被转换为BMIDE模板数据模型对象，例如业务对象常量。这在BMIDE中集中了与数据模型相关的首选项。如果您的数据库包含任何已转换的首选项，则使用首选项迁移向导必须迁移它们。

以下首选项被转换：

ItemRevision-business-object_Maturity_Level

这些首选项设置了item revision必须达到的状态（These preferences set the status that an item revision must reach to be considered mature）。这些首选项已过时，并被迁移到Maturity status业务对象常量上的值（These preferences are obsolete and are migrated to values on the Maturity Statuses business object constant）。例如，如果您的数据库将DocumenRevision Maturity Level首选项设置为Frozen值，则它将迁移到DocumentRevision业务对象。

注意:

如果要从早期版本的Teamcenter升级，则应该验证所有正在BMIDE中进行管理的关系属性。要进行验证，请查看您添加的每个<关系类型relation type>_relation_primary首选项，并将其添加到BMIDE中的自定义模板中。

To find any custom preferences that fit the converted preferences, choose Edit-Options-Search in the My Teamcenter application in the rich client. If you find that your database contains at least one of the converted preferences, you must perform the following steps to migrate the preferences:要查找适合转换后的首选项的任何自定义首选项，请在胖客户端的My Teamcenter应用程序中选择Edit-Options-Search。如果发现数据库至少包含一个已转换的首选项，则必须执行以下步骤来迁移首选项:

1、使用preferences_manager实用程序从当前数据库提取站点级首选项。这是当前在您的站点上使用且尚未升级的数据库。

在Teamcenter命令提示符下运行该命令：

preferences_manager -u=user-name -p=password -g-group

-mode=export -scope=SITE -context=Teamcenter -out_file=c:\temp\exported_preferences.xml

这将把所有站点级首选项提取到指定的XML文件中。

2、在BMIDE中，选择BMIDE→Upgrade Tools（升级工具）→Preferences Migration Wizard（首选项迁移向导）。单击Next。

3、在“首选项迁移”对话框中执行以下步骤：

1）单击Project框中的箭头，选择要将首选项迁移到的项目。

2）单击Preferences XML文件右侧的Browse浏览按钮，定位运行preferences_manager实用程序产生的输出XML文件。

3）单击Finish。

将创建一个project\install\cleanup_preferences.txt文件，其中包含要从数据库中删除的首选项列表。不要删除该文件。这个文件必须在源代码管理中维护。当您在BMIDE中运行Generate Software Package(生成软件包)向导时，将对该文件进行打包，并在数据库升级期间使用该文件从数据库中删除已转换的首选项。此外，还会创建包含迁移日志的Project Files\output\upgrade\preferences_migration.log文件。

4、要验证迁移，请在BMIDE中打开由迁移流程创建的新业务对象。确保Business Object Constants业务对象常量表包含新的业务对象常量。

注意:

只有自定义ItemRevision-business-object_Maturity_Level首选项作为业务对象常量被迁移到项目中。所有其他首选项都会被忽略。首选项被迁移到名为ItemRevision-business-object_Maturity_Level， Maturity Statuses business object constant(成熟度状态业务对象常量)应用于这些新的业务对象。

5、要保存对数据模型的更改，请选择BMIDE→Save Data Model，或单击主工具栏上的Save Data Model按钮。这会保存模板扩展文件，这些文件现在包含转换为模板元素的首选项。

6、更新客户升级脚本，以便在客户数据库升级期间从数据库中删除已迁移的首选项。此步骤确保在升级数据库时，此步骤确保在升级数据库时，cleanup_preferences.txt中列出的过时的首选项也从数据库中删除。

（1）打开“upgrade_template-name_vversion.default”文件。如果这个文件不存在，使用旧的upgrade_template-name_vversion.default脚本创建一个。

（2）在文件post-non-schema-delete添加以下文本:

preferences_manager -u=infodba -p=${TC_USER_PASSWD}  -g=dba  -mode=removel

-scope=SITE  -file=${TC_INSTALL_DIR}/template-name/cleanup_preferences.txt

将template-name替换为自定义模板的名称。

7、更新现有的自定义首选项数据文件。您可能有一个自定义首选项数据文件，该文件将自定义首选项安装到数据库中。如果该文件包含刚刚迁移的任何首选项，请将它们从该文件中删除。这是为了确保首选项数据文件不会继续安装任何已迁移的首选项。