Teamcenter8---开始1

整个应用程序的入口点在

com.teamcenter.rac.aifrcp_8000.0.0.jar/com/teamcenter/rac/aifrcp 中该文件中存在application，

1介绍

teamcenter富客户端基于c/s架构。client和server都可以被客制化。client是用户接口层（UI layer），使用java语言进行构建和客制化。server层可以使用ITK和c语言进行客制化。本手册介绍了通用的客制化client的技术与工具，以及客制化server的用户（User）服务技术

PLM软件不支持使用未发布的和未证明的APIs或者扩展点（extension points）进行代码扩展（code extensions）。

前提：（必须遵循下列安装来客制化富客户端）

   （1）富客户端软件本身——teamcenter8.

   （2）The Java software development kit （sdk）

（3）The Eclipse integrated development environment (IDE).

         能够富客户端客制化：

         一旦安装了必须的前提，不需要进行任何操作就能进行富客户端客制化。

     配置富客户端客制化：

        一旦安装了前提和安装了eclipse IDE，不需要进行任何配置。

2理解eclipse富客户端平台

teamcenter富客户端宿主于eclipse 富客户端平台（RCP）框架。RCP是一个通用目的的应用程序框架，通过使用插件，提供了对模块化和基于可扩展的组件开发的强烈的支持。

You can find more information about the RCP's features, advantages, and use at the Eclipse Web site:

http://www.eclipse.org/

For more information about using Eclipse, see the Platform Plug-in Developer Guide:

http://help.eclipse.org/help33/index.jsp

To customize the RCP, you need to use the Eclipse IDE.

For more information about the IDE, see Set up the integrated development environment.

3集成化application integration framework（AIF）desktop和eclipse workbench

在富客户端下，主要的集成点是一个应用程序（application）。活动的应用程序定义了在主面板区域的显示和布局。当前应用程序控制主菜单条和工具条的内容。导航面板总是可见来帮助选择当前应用程序。在富客户端中，有一个主工具条来确定当前应用程序和如何在活动的应用程序之间进行切换。

使用portal.propeties（C:/Siemens/Teamcenter8/portal/plugins/configuration_8000.0.0目录下）文件来定义应用程序集，该文件仍然可以使用aif_application扩展点来支持和参数化。该扩展点支持三种不同类型的方式：

（1）增加新的传统的和基于继承的应用程序，不需要修改portal.proterties文件。

（2）增加新的纯粹的基于SWT的应用程序。

富客户端桌面建立在eclipse rcp工作台之上，包括菜单栏，工具栏以及状态栏。RCP工作台（workbench）通过外部的shell  trim进行扩展，这些shell trim 定义了主应用程序转换器、工具条和导航面板。保留区域是当前的活动的eclipse透视图。默认情况下，存在一个仅仅包含一系列视图的简单的teamcenter透视图。每一个富客户端应用程序都强制要求与一个eclipse透视图相关联。无论在任何情况下，一个富客户端应用程序是活动的，相关联的eclispe透视图也是活动的。默认情况下，一个应用程序与teamcenter透视图相关联。从而继承的应用程序不会强制要求定义一个相关联的透视图。如果一个应用程序包含一个非空的主Swing JPanel，则该panel6由awt_swt bridge视图进行包装，并放在视图堆（stack）中。

4Teamcenter plug-ins

针对富客户端，teamcenter有一个基本的eclispe插件集。它们放置在TC_ROOT/portal/plugins目录下，文件名以com.teamcenter.开始。

5建立集成化开发环境

teamcenter富客户端必须首先安装在本地机器上。

安装java2  Software development Kit（SDK）version 1.5.0.

使用eclipse进行客制化富客户端，需要进行下列步骤：

   （1）安装eclipse

①下载并安装eclipse3.3 software development Kit（SDK）和Plug-in Development Environment（PDE）SDK。

②创建批处理文件设置环境，开始服务，使用jdk命令行参数启动eclipse。

set FMS_HOME=TC_ROOT/fcc

set JAVA_HOME=TC_ROOT/portal/jre

set JRE_HOME=TC_ROOT/portal/jre

set TPR=TC_ROOT/portal

set CLASSPATH=.;

start "TAO ImR" /min cmd /c "TC_ROOT/iiopservers/start_imr.bat"

Eclipse-install-directory/eclipse.exe -vm jdk-install-directory/bin/javaw

比如：

@echo off

set TC_ROOT=C:/Siemens/Teamcenter8

set FMS_HOME=%TC_ROOT%/fcc

set JAVA_HOME=%TC_ROOT%/portal/jre

set JRE_HOME=%TC_ROOT%/portal/jre

set TPR=%TC_ROOT%/portal

set CLASSPATH=.;

start "TAO ImR" /min cmd /c "TC_ROOT/iiopservers/start_imr.bat"

C:/eclipse/eclipse.exe -vm "C:/Program Files/Java/jdk1.5.0_10/bin/javaw"

③运行该批处理文件，eclipse显示workspace launcher对话框，使用默认地的workspace location，该location会为eclipse存储工程相关的信息，点击ok进行welcome 页面。

   （2）设置工程首选项

 

   （3）从eclipse运行富客户端。

6富客户端客制化基本概念

在客制化富客户端前，不需理解富客户端是如何部署和打包的。安装富客户端时，会安装一些java archive（jar）文件，这些jar文件就是eclipse插件文件。这些文件构成了富客户端以及富客户端运行所需要的资源。

必须理解代码编写规则，以及如何本地化富客户端。

（1）文件以及目录标准

所有的包名必须是小写字母，在报名中不能使用空格。

通用（general）包注册必须同包名最后的名字相同。比如，针对包com.mycompany.rac.explorer，resourceBundle对象文件包含注册信息为explorer.proterties。

（2）属性（property）规范

property文件可以分为三类：

核心开发

本地化

用户属性

这样区分的原因是因为用户修订用户属性文件而能够维护对核心开发属性文件的链接。

explorer.properties                                   基本的属性文件

explorer_local.properties                              本地化目的的属性文件

explor_user.properties                                用户创建的属性文件

 

7富客户端调试工具

Print  Object

显示选中对象的内部属性值，可以检查是否存在不正确的属性值。

Communication Monitor

显示富客户端与服务器端的调用，检查数据在服务器端和客户端是否被正确的交换。

Performance Monitor

跟踪服务器与数据的调用，检查服务器与数据交互的速度。

8本地化location

存在两种方式本地化富客户端用户接口（界面）

(1)properties 文件

通过在application_local.properties文件中添加修改的字符串的方式本地化用户接口。这些文件在com.teamcenter.rac.tcapps_version.jar中或com.teamcenter.rac.application-name_version.jar文件中

（2）插件

the registry（注册）会检查本地化插件，来查看是否在com.teamcenter.rac.commom_version.jar文件中的plugin.proterties文件中存在定义的本地化属性。如果字符串需要本地化，在plugin.properties文件中使用%和键名来定义键值。

     For example, if you want to change the Software Update menu command to Update Software and the menu command label is %UpdateActionSet.menu.label, type UpdateActionSet.menu.label=Update Software in plugin.properties file.

9增加菜单和工具栏

eclipse采用声明的方式增加菜单栏、工具栏和快捷菜单。个人插件中的plugin.xml提供菜单栏、工具栏和context menus的定义。

mvc模式：

command

command有一个全局唯一性表示，呈现了一个行为的抽象的语义概念，比如拷贝、粘贴和保存。command不是行为的执行，也不是行为的可视化呈现。

     name="%com.teamcenter.rac.command.name">

 

menu contribution

menu contribution呈现一个特殊的视图或者command的可视化呈现。menu contribution创建菜单和工具栏结构，并把它们放到正确的eclipse位置。位置是通过URL进行配置，可以使用下面中的任何一个：

Main menu     

Main toolbar

View toolbar

View menu

Context（popup）menu

Trim area

menu contribution可以定义一个menu标签、助记符或者图标。它包含对已定义的commands的可视化的标识。command的可视化呈现可以包含标签（label）、图标和助记符。menu contribution也可以包含分隔符。分隔符只有在放置在可见的command的前后时才是可见的。menu contribution可以通过visibleWhen子句来定义什么时候menu是可见的。

                mnemonic="%command.refresh.mnemonic"

                style="push">

                mnemonic="%command.exit.mnemonic"

                style="push">

 

handler

handler是对command的特定实现。对于任何给定的command，可以存在零个或者多个handler。但是对于给定的command只能有零个或者一个handler是活动的。活动的handler控制command的激活状态。

handler通常继承自AbstractHandler类。handler在execute()方法中提供了一个应用程序上下文。如果command没有一个活动的handler，则对command定义的所有的menu contribution都是不可见的。comman可以定义一个默认的handler从而确保command总是有一个活动的handler。handler可以通过ActiveWhen子句声明或者编程的方式来激活。采用enbleWhen表达式定义一个handler来声明command在menu contribution中的可见性。The handler also defines declaratively when a command appears enabled in any menu contribution with the enabledWhen expression for the handler.

10创建新的富客户端应用程序插件

方法之一如下：

1、增加一个新的富客户端插件，该插件有一个透视图、一个视图并在导航面板中呈现该插件，作为主要的应用程序按钮。

2、在富客户端main menu中为该插件增加一个menu contribution。

3、为该插件增减一个main toolbar contribution

4、增加一个conditional 快捷menu contribution