Process Extensions FAQ 进程扩展常见问题
This section answers common questions about process extensions. 这部分回答了有关进程扩展的常见问题
What are process extensions? 什么是进程扩展
Process extensions extend the functionality of Agile PLM clients through custom actions ,external reports,custom autonumbering and tools,thus tailoring the system to fit a customer's business.
进程扩展通过用户操作外部报表以及用户自动号码以及其他工具扩展Agile PLM 客户端的功能，达到根据客户的需求定制系统的目的。
Process extensions can be used to connect the Agile PLM server and Agile PLM users to external systems.
进程扩展可以用来连接Agile PLM 服务器和用户与外部系统。
What types of actions can you define with process extensions?
进程扩展可以定义哪些类型的操作？
Process extensions support two types of process extensions actions.They are custom autonumber source and custom actions.
Custom autonumber sources define the numbering sequences used by classes of objects.Custom actions are programs that can be run from Agile PLM Clients.
进程扩展提供两种进程扩展操作类型。分别是用户自动号码和用户操作。用户自动号码资源用对像类型定义了号码的序列。用户操作是可以被Agile PLM 客户端调用的程序。
A process extension can also be a reference to a URL.The URL can be a simple Web site or the location of a Web-based application.
一个进程扩展可以引用一个网址。网址可以是一个简单的网站，或者是本地一个基于Web的应用程序。
Can Process Extenstions support asynchronous operatons?
进程扩展支持异步操作吗？
Agile Process Extensions only support synchronous operations .If your Process Extension requires asynchronous behavior,you must modify your PX code to implement asynchronous solutions of your choice .For example ,you can spawn a thread.
Agile 进程扩展只支持同步操作。如果你的进程扩展需要异步操作，你必须修改你的PX 代码去实现你选择异步解决方案。比如，你可以创建线程。
Can I use Agile's Java API within a process extension program?
我可以在进程扩展程序中使用Java API吗？
Yes . You can use Agile's Java API and other external Java APIs.The only requirement is that you implement either the ICustomActionNumber or the ICustomAction interface,depending on the type of extension.
是的。你可以使用Agile Java API 和其他外部Java APIs.唯一需要的是选择去实现ICustomActionNumber 接口还是ICustomAction 接口，这取决于扩展的类型。
How do you initiate a process extension in an Agile PLM client?
如何在Agile PLM 客户端启动一个进程扩展？
Custom actions can be triggered in the following ways:
用户操作可以通过以下方式被触发：
A change to a Workflow status.
当某个工作流状态改变
Selection a custom action from the Tools menu
从工具菜单中选择一个用户操作
Selection a custom action from the object's Actions menu.
从对象的操作菜单中选择一个用户操作
Selection an external report that uses a custom action.
利用用户操作选择一个外部报表
Creating an object of a class that uses a custom autonumber source.
创建一个类，他使用自定义的自动号码源对象
Do process extensions have special security requirements?
进程扩展是否有特殊的安全需求？
No .The process extensions stack sits on the Agile Application Server,so custom actions and custom autonumber sources operate within an environment where the user has already been authenticated and authorized.
没有。进程扩展库依赖于Agile 应用服务器，所以自定义操作以及自定义自动编码资源的操作是在一个用户已经被授权和验证过的环境中进行的。
How are roles and privileges defined for custom actions?
怎样定义自定义操作的角色和权限？
By default ,a custom action uses the roles and privileges of the current user.However,if you want to configure a custom action to have expanded privileges, you can specify the roles required for a custom action in the Process Extension Library of Agile Java Client.When you use a custom action in the Agile PLM client,roles and privileges that are specified for the custom action,override the roles and privileges of the current user.Once the custom action is completed, the client reverts to the user's original roles and privileges.
默认情况下，自定义操作使用当前用户的角色和权限。如果你想要给自定义操作扩展权限设置，你可以在Agile Java客户端的进程扩展库中对自定义操作的角色进行设置。当你在Agile 客户端对自定义操作的角色和权限进行了自定义设置，那么就会覆盖当前用户的角色和权限。当自定义操作结束后，客户端恢复原来的角色和权限。
How do I configure and deploy a process extensions?
如何配置和部署进程扩展？
Place the JAR file(s) for a process extension in the agile_home/integration/sdk/extensions folder on the application server.Included with the JAR file(s) should be a file named com.agile.px.ICustomAutoNumber or com.agile.px.ICustomAction in the META-INF/services directory. The content of these files are the fully qualified Java class names,one class per line ,for a custom autonumber source or a custom action,respectively.
将进程扩展的JAR 文件放置到应用服务器的agile_home/integration/sdk/extensions 目录下。引用JAR包com.agile.px.ICustomNumber或者com.agile.px.ICustomAction 在META-INF/services 目录。这些文件的内容必须使用使用全限定的Java类名并且每行一类，分别是自定义自动号码或者自定义操作。
After I deploy a process extension program on the application server,how do I enable it?
在应用服务器上部署完一个进程扩展后，如何使他可用？
Once process extensions have been deployed ,you can configure them for use within Agile PLM clients.In Agile Java Client,you can add custom actions to the Process Extension Library and custom autonumbers to the Autonumbers table.
当部署好一个进程扩展后，你可以通过在Agile PLM客户端中进行配置它们。在Agile Java客户端，你可以添加一个自定义操作到进程扩展库，添加自定义自动编码到自定编码表。
After I've deployed JAR file(s) for a custom action or custom autonumber source ,do I need to update the application server classpath?
当部署完自定义操作和自定义自动编码的JAR包后，我是否需要更新应用服务器的路径？
No .The classpath is updated automatically by a special-purpose classloader.The classloader extends the application server classpath with any class located in agile_home/integration/sdk/extensions(or the location specified for the sdk.extensions property in the agile.properties file).
不需要。路径由一个有特殊功能的classloader程序自动更新。classloader 扩展了应用服务器中位于agile_home/integration/sdk/extensions目录下的所有类的路径（具体路径可以有通过agile.properties文件中的sdk.extensions属性设置）。
How do you create a custom autonuber source?
如何创建一个自定义自动编码源
Create a Java class that implements the ICustomAutoNumber interface , a server-side API in the com.agile.px package .The code defines the autonumbering logic, for example ,prefix,sufiix,number of digits,and so on,and the persistence mechansim. The Agile PLM system gets the next number from the custom autonumber source by calling the getAutoNumber() method.
创建一个类，实现ICustomAutoNumber接口，一个在com.agile.px包离得服务器端API.代码定义自动编码的逻辑，例如前缀、后缀、数位 等等，以及持久性机制。Agile PLM系统通过调用getAutoNumber()方法从自定义自动编码源获取下一个号码。
How do you assign custom autonumber sources in Agile Java Client?
在Agile Java客户端中如何分配自定义编码源？
In the Classes node , you assign autonumber sources to specific subclasses. In the AutoNumbers node,you can also assign subclasses to an autonumber source .
在类节点，你把自动编码源分配给一个指定的子类。在自动编码节点，你也可以分配子类给一个自动编码源。
How do you create a custom action?
如何创建一个自定义操作？
Creae a Java class that implements the ICustomAction interface , a server-side API in the com.agile.px package. The code defines the custom action,whether to modify the current object,create an external report,integrate the Agile PLM client with an external system,or perform some other business logic.When an Agile PLM client initiates a custom action, the Agile PLM system calls the doAction() method.
创建一个类，实现ICustomAction 接口，在com.agile.px 包离得一个服务器端的API .代码中定义了自定义操作，是否编辑当前对象，创建一个外部报表，集成Agile PLM 客户端和外部报表，或者实现其他的业务逻辑。当一个Agile PLM 客户端启动一个自定义操作，Agile PLM 系统会调用doAction()方法。
How do you associate custom actions with the Tools menu, the Actions menu ,Workflow statuses,and external reports?
怎样把自定义操作与工具菜单，动作菜单，工作流状态以及外部报表建立关联？
In Agile Java Client, open the Process Extensions node to add and configure custom actions .You can associate custom action with Workflow statuses,the Tools menu,the Action menu for classes, and external reports.A custom action associated with a Workflow status is initiated automatically when the wokrflow assumes that status.A custom action appears on the Tools menu when its Initiate From property is set to Tool menu. A custom action appears on the Actions menu for an object when you add it to the Process Extensions tab for a subclass.A custom action associated with an external report is triggered automatically when that report is executed.
在Agile Java 客户端，打开进程扩展节点来添加和配置自定义操作。你可以把自定义操作与工作流状态，工具菜单，类的工具菜单，外部报表进行关联，一个与工作流状态关联的自定义操作，当工作流状态符合定义的时候，会自动启动。当一个自定义操作的Initiate From 属性设置为工具菜单时，它会出现在工具菜单中。对于一个在进程扩展选项卡中添加的类的定义操作,会出现在动作菜单中。一个与外部报表关联的自定义操作，当报表执行时被触发。
In what order do process extensions appear on the Tools menu or Actions menu of Agile PLM clients?
进程扩展按照什么次序出现分别在Agile PLM 客户端的工具菜单，动作菜单？
If you add process extensions to either the Tools menu or an object's Action menu, they are listed after standard menu commands in the order they were created.You can not reorder or oterwise manage commands on the Tools menu or Actions menu.
如果你添加了一个进程扩展到工具菜单或者一个对象的动作菜单，他们会按照你创建时候的次序列在标准菜单之后出现。你不能重新排序要么在工具菜单操作要么在动作菜单操作。
What is the inheritance model of custom actions that are assigned to classes?
分配给类的自定义操作的继承模型是怎样的？
Custom actions can be defined at the base class level ,the class level, or the subclass level.A custom action defined at the base class level is available to all classes and subclasses beneath the base class.A custom action defined at the subclass level is available only to that subclass.
自定义操作可以被定义在基类层，类层，或者子类层 。定义在基类层的自定义操作对所有的类和基类继承的子类都可用。定义在子类层的自定义操作只对子类有用。
Where do I put PX and WSX configuration property files？
在哪里可以找到PX 和 WSX的配置属性文件？
After deployment changes in Agile PLM Release 9.2.2.2 , the agileDomain\cofig directory is no longer in the classpath.You can put PX and WSX property files in this directory:
\oas\j2ee\home\applications\Agile\APP-INF\classes\.
在Agile PLM 9.2.2.2版本之后的部署改变了，agileDomain\config 目录不在classpath里了，可以在以下目录找到PX和WSX的属性文件：
\oas\j2ee\home\applications\Agile\APP-INF\classes\