Aras Innovator 9.1程序员开发全面指南

5星 · 超过95%的资源需积分: 46 180 浏览量更新于2024-07-30 5 收藏 1.71MB PDF 举报

Aras Innovator开发指南是一份针对PLM (Product Lifecycle Management) 和PDM (Product Data Management) 程序员的专业文档，适用于Aras Innovator 9.1版本。该文档编号为9.1.002272009，最后更新日期为2009年3月12日，版权属于Aras Corporation。Aras Corporation是一家总部位于美国马萨诸塞州安多弗的公司，提供全方位的PLM解决方案和服务。这份指南详细涵盖了Aras Innovator的各个方面，包括但不限于系统架构、接口设计、工作流管理、数据模型、以及定制开发的最佳实践。它旨在帮助开发者深入理解如何利用Aras Innovator平台进行高效的产品开发过程，提升企业对产品生命周期的管理和控制。学习者可以在这里找到关于如何创建和配置自定义对象、规则引擎的使用、事件驱动的工作流程、API（应用程序编程接口）调用、以及如何与第三方系统集成的信息。此外，文档还强调了版权保护的重要性，提醒开发者在复制、修改或分发文档时必须遵守Open Publication License V1.0或更高版本的规定，以确保内容的合法传播。对于商业用户来说，如果想要将Aras Innovator的工作成果出版成纸质书籍或其他形式的衍生作品，必须事先获得版权持有者的许可。同时，Aras Innovator、Aras和带有"A"标志的商标都是Aras Corporation在美国和其他国家享有的注册商标。 Aras Innovator开发指南是PLM和PDM领域的一本权威参考书籍，对于开发人员、系统管理员和项目管理人员来说，是理解和实现Aras Innovator功能，优化企业产品开发流程的关键资源。通过深入学习和遵循指南中的指导，开发者能够更好地定制并扩展Aras Innovator以满足特定业务需求。

Page 16

Aras Corporation.

3.3.1 Base Methods

The Item Class base method apply(…)submit the AML apply request to Innovator

Server using the context Item DOM as AML source and returns a new Item built on

the XML returned by the Server. In contrast, the base method loadAML(…) does not

return a new Item but rather rebuilds this.dom using AML taken as an argument.

You can call clone(…)method to get a new identical instance of the context Item and

you can call setNewID() method to replace the context Item id by newly generated

GUID.

3.3.2 Boolean Methods

Call method isCollection()to find out whether or not the Item represents a set of

Items, e. g. whether or not its dom property holds more then one Item node. Call

isError()method to find out whether or not the Item represents an Error. See IOM

API on-line reference for more boolean members of the Item Class.

3.3.3 Attribute Methods

Methods like getAction(), getID(), and getType() return a value of Item node

action, id, and type attribute respectively, while method getAttribute(…) takes an

attribute-name as an argument and, therefore, can be used to get any attribute by

name. Thus, getAction()is a short cut to getAttribute(“action”), getID() is a

short cut to getAttribute(“id”), and so on.

Each get method in this group has a corresponding set method: setAction(…),

setID(…),setType(…), and setAttribute(…). Notice that method

setAttribute(…) not only sets new value for an existing attribute but can also add

a new attribute to the Item node and then sets its value.

3.3.4 Property Methods

Property methods comprise set of accessors to Item properties and Item property’s

attributes: get_, set_ (which acts also as add_), and remove_. In addition, if

property has/need a nested Item there are methods to get/insert such nested Item.

Accessors to Properties are getProperty(…), setProperty(…), and

removeProperty(…).These methods take then property name as an argument.

Accessors to Property’s attribute are getPropertyAttribute(…),

setPropertyAttribute(…), and removePropertyAttribute(…). These methods

take property and attribute names as arguments.

Method setProperty(…)/setPropertyAttribute(…)not only sets new value for an

existing Item property/ property’s attributes but creates new property/ property’s

attributes and then sets its value if the property/ property’s attributes with a given

name does not yet exist.

The setProperty method requires property values to be in a locale-neutral format.

Decimal and float values should use the period symbol (.) as the decimal separator

and no digit separator (i.e. commas separating thousands). The dash symbol (-)

should be used to denote a negative value. Date/Time values should be in "YYYY-

MM-DD[Thh:mm:ss]" format and in the local (or corporate) time zone. Language-

specific values should be set using the language code as the third argument.

Page 17

Aras Corporation.

Accessors to Property’s nested Item are: getPropertyItem(…),

setPropertyItem(…), and createPropertyItem(…). All these methods take

property name as an argument, and method setPropertyItem(…) needs, in

addition, an Item Object as the second argument to create a DOM for the nested

Item.

3.3.5 File Methods

If the Item method getType() returns “File” then two methods getFileName() and

setFileName(…) can be used as accessors to the file name of the attached file. For

an item of type other then “File” these methods throw an exception.

3.3.6 Relationship Methods

Relationship methods comprise set of Item’s relationship accessors:

getRelationships(…), addRelationship(…), createRelationship(…), and

removeRelationship(…). The difference between createRelationship(…) and

addRelationship(…), two methods that both are adding an Item node to the

Relationship parent node, is subtle. Let’s consider the following server-side VB

method to illustrate how createRelationship(…)works:

Dim myInnovator As Innovator = Me.NewInnovator()

Dim myItem As Item = myInnovator.NewItem("myType","myAction")

myItem.createRelationship("User","add")

This code results in following myItem.dom XML

</Relationships>

</Item>

Similar code that exercises addRelationship(…) methods is

Dim myInnovator As Innovator = Me.NewInnovator()

Dim myItem As Item = myInnovator.NewItem("myType","myAction")

Dim relItem As Item = myInnovator.NewItem("User","add")

myItem.addRelationship(relItem)

and this code results in following myItem.dom XML:

<default_vault>67BBB9204FE84A8981ED8313049BA06C</default_vault>

</Item>

</Relationships>

</Item>

As you can see addRelationship(…) produces in this case more detailed Item node

under the Relationship parent node.

There are three methods getRelatedItem(…), setRelatedItem(…), and

createRelatedItem(…) that are valid for relationship Item only and are used as a

short cut to the Item.get/setPropertyItem() methods.

Page 18

Aras Corporation.

3.3.7 Item Collection Methods

This group comprises methods to work with collections. Collection in this context is a

set of Items as in the case for results from a query. Method appendItem(…) appends

its Item Object argument to an existing collection or converts a single Item instance

to set of Items. This mechanism is illustrated in a C# sample below:

Innovator myInnovator = this.newInnovator();

Item myItem = myInnovator.newItem("myType","myAction");

At this point, myItem presents a single Item instance, myItem.dom XML looks like

this:

and myItem.isCollection() returns false. But three extra line of code:

Item addedItem = myInnovator.newItem("added","myAction");

// set ID to be able to remove addedItem later

addedItem.setID(myInnovator.getNewID());

myItem.appendItem(addedItem);

converts myItem to a collection, e.g. myItem.isCollection() returns true, and

myItem.dom XML becomes as following:

<AML>

</AML>

If the Item object id is not NULL it can be removed from the collection:

myItem.removeItem(addedItem);

Use getItemCount() method to determine the size of a collection,

getItemByIndex(…) method to get an instance of the Item Object based on its

position inside of the collection, and method getItemsByXPath(…) to find an Item by

its XPath.

3.3.8 Logical Methods

The methods newOR(), newAND(), and newNOT() insert logical node with tag <or>,

<and> and <not> respectively under the parent Item node and return an Item

Object that represent a newly inserted logical node. For example, the code below :

Innovator myInnovator = this.newInnovator();

Item myItem = myInnovator.newItem("myType","myAction");

Item logicalOR = myItem.newOR();

logicalOR.setProperty("foo", "bar");

produces the following myItem.dom XML:

<or>

</or>

</Item>

The method getLogicalItems()returns collection of logical nodes, thus, the

expression

myItem.getLogicalItems().getItemByIndex(0).node in the code sample above

would point to the logical node <or>:

<or>

</or>

剩余96页未读，继续阅读

魔镜小童

粉丝: 12
资源: 6

Aras Innovator 9.1程序员开发全面指南

04Aras Innovator二次开发-客户端方法代码

Aras Innovator：ArasInnovator配置管理与版本控制技术教程.Tex.header.docx

Aras Innovator 11 开发指南 PLM PDM 程序员开发指南

Aras Innovator 12新手必读指南

Aras Innovator 11.0开发指南中如何介绍平台架构及其对开发的影响？

在Aras Innovator 11.0开发指南中，如何通过API实现自定义业务逻辑，并且有哪些最佳实践可以遵循？

Aras Innovator 11.0开发指南中提到的工作流引擎有哪些特点，以及如何利用这些特点进行流程设计和优化？

Aras Innovator 120 配置手册

Aras Innovator AML编辑器

ARAS Innovator12 Dotnet Hosting安装包介绍

最新资源