aras12开发手册说明书_aras

Aras

aras12

4星 · 超过85%的资源需积分: 50 13 浏览量更新于2023-03-16 评论 4 收藏 2.36MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源评论

资源推荐

Aras Innovator 12

Programmer’s Guide

Document #: 12.0.02019054101

Last Modified: 05/24/2019

 
2019 Aras Corporation All Copyrights Reserved.    3    
   
   
Aras Innovator 12 
Programmer’s Guide 
Table of Contents 
Send Us Your Comments ............................................................................................. 6 
Document Conventions ................................................................................................ 7 
Introduction .............................................................................................................. 8 
1  The Item ....................................................................................................................................... 8 
2  The Aras Markup Language (AML) .............................................................................................. 9 
3  Methods and the IOM ................................................................................................................. 10 
AML ......................................................................................................................... 11 
1  <Item> Tag ................................................................................................................................. 11 
2  <Relationships> Tag .................................................................................................................. 11 
3  <property> Tags ......................................................................................................................... 11 
4  Attributes .................................................................................................................................... 12 
4.1  Item Attributes ............................................................................................................. 12 
4.2  Property Attributes ....................................................................................................... 14 
IOM Reference ........................................................................................................ 16 
1  IOMCredentials Class ................................................................................................................ 17 
2  Innovator Class .......................................................................................................................... 17 
3  Item Class .................................................................................................................................. 17 
3.1  Base Methods .............................................................................................................. 17 
3.2  Boolean Methods ......................................................................................................... 18 
3.3  Attribute Methods ........................................................................................................ 18 
3.4  Property Methods ........................................................................................................ 18 
3.5  Relationship Methods .................................................................................................. 19 
3.6  Item Collection Methods .............................................................................................. 19 
3.7  Logical Methods .......................................................................................................... 20 
3.8  Creating New Item Method .......................................................................................... 20 
3.9  Error Methods .............................................................................................................. 21 
3.10  Extended Item Class methods..................................................................................... 21 
Methods .................................................................................................................. 23 
1  Item Actions Extend the Item Class ........................................................................................... 23 
1.1  Context Item ................................................................................................................ 24 
1.2  Methods are Item Factories ......................................................................................... 24 
1.3  Handling the Wrong ItemType ..................................................................................... 24 
1.4  Methodology ................................................................................................................ 25 
2  Built in Action Methods ............................................................................................................... 25 
3  Generic Methods ........................................................................................................................ 27 
3.1  Context Item ................................................................................................................ 27 
3.2  Methods are Item Factories ......................................................................................... 27 
3.3  Methodology ................................................................................................................ 28 

 
  2019 Aras Corporation All Copyrights Reserved.    4    
   
Aras Innovator 12 
Programmer’s Guide 
4  Server Events ............................................................................................................................. 28 
4.1  Context Item ................................................................................................................ 28 
4.2  Methodology ................................................................................................................ 28 
4.3  Available Server Events .............................................................................................. 29 
4.4  Polymorphic ItemTypes Server Event Inheritance ...................................................... 32 
4.5  Required Server Events .............................................................................................. 32 
4.6  Server Event Version ................................................................................................... 32 
5  Client Events .............................................................................................................................. 33 
5.1  Context Item ................................................................................................................ 33 
5.2  Form Events ................................................................................................................ 33 
5.3  Field Events ................................................................................................................. 34 
5.4  Grid Events .................................................................................................................. 35 
5.5  Item Type Events ......................................................................................................... 38 
5.6  Item Actions and Server Event .................................................................................... 39 
Action Items ........................................................................................................... 40 
1  Client Side Method Rules ........................................................................................................... 40 
2  Server Side Method Rules ......................................................................................................... 40 
3  Use Cases .................................................................................................................................. 42 
3.1  Client side - has cache Item is dirty ............................................................................. 42 
3.2  Client side - no cache Item - no item_query value ...................................................... 42 
3.3  Client side - has cache Item not dirty - no item_query value ...................................... 43 
3.4  Client side - has cache Item not dirty - has item_query value ..................................... 43 
3.5  Client side - no cache Item - has item_query value .................................................... 44 
3.6  Server side - has cache Item/is dirty ........................................................................... 44 
3.7  Server side - no cache Item - no item_query value ..................................................... 45 
3.8  Server side - has cache Item/not dirty - no item_query value ..................................... 45 
3.9  Server side - has cache Item/not dirty - has item_query value ................................... 46 
3.10  Server side - no cache Item - has item_query value ................................................... 46 
Aras Innovator Methodology ................................................................................ 48 
Cookbook ............................................................................................................... 49 
1  Create an Aras Innovator Object................................................................................................ 49 
2  Create an Item Object ................................................................................................................ 49 
3  Query for an Item ....................................................................................................................... 50 
4  Query and iterate over a set of Items ......................................................................................... 51 
5  Query for an Item and return its configuration ........................................................................... 52 
6  Query using AML to construct the query .................................................................................... 56 
7  Query for the Item next promotion states ................................................................................... 56 
8  Query using relationships as search criteria .............................................................................. 57 
9  Add an Item configuration in one transaction ............................................................................. 59 
10  Add a Named Permission .......................................................................................................... 60 
11  Set a Private Permission for an Item ......................................................................................... 61 
12  Apply a Generic Method ............................................................................................................. 62 
13  Need to Save text to a File ......................................................................................................... 62 
14  Need to Send Email from a Method ........................................................................................... 63 
15  Need to Add a UI Control ........................................................................................................... 64 
16  Need for Speed ApplySQL ......................................................................................................... 67 
17  Need a callback for a Relationships Grid Row Event ................................................................ 68 

 
  2019 Aras Corporation All Copyrights Reserved.    5    
   
Aras Innovator 12 
Programmer’s Guide 
18  Need a callback for a Relationships Grid Cell Event ................................................................. 70 
19  Show relationships in a Grid control on the Form ...................................................................... 71 
20  Want the Identities for the User.................................................................................................. 72 
21  Want a field to be either a sequence or user entered value ...................................................... 72 
22  Want to Vault a File .................................................................................................................... 73 
23  Want to get an existing Vaulted File and save it with a new Document .................................... 75 
24  Need to reject an Item Promote ................................................................................................. 76 
25  How to build XML for grid ........................................................................................................... 77 
26  How to build XML for a Menu ..................................................................................................... 79 
27  How to handle multilingual properties ........................................................................................ 80 
28  How to handle date properties ................................................................................................... 81 
29  How to pass values from  onBeforeX to  onAfterX events ......................................................... 82 
30  How to reference custom DLL from server method ................................................................... 83 
31  How to add sub menus to context menu in search grid ............................................................. 85 
32  How to Create a Dynamic List .................................................................................................... 85 
33  How to Download a File from Aras Innovator to a Client Machine ............................................ 86 
34  How to Convert Strings .............................................................................................................. 87 
35  How to Load an XML File URL................................................................................................... 87 
36  How to Create a List of Nodes ................................................................................................... 87 
37  How to Select a Single Node ..................................................................................................... 88 
38  How to Transform a Node .......................................................................................................... 88 
39  How to Create a NodeType ........................................................................................................ 88 
40  How to Get Text Associated with a Node .................................................................................. 88 
41  How to Set Text For a Node ....................................................................................................... 89 
42  How to Convert an Object into a String ...................................................................................... 89 
43  How to Return an Error .............................................................................................................. 89 
Aras Innovator Solution Studio ............................................................................ 90 
1  Features ..................................................................................................................................... 90 
Debugging .............................................................................................................. 91 
1  Enabling Debugging in Aras Innovator ...................................................................................... 91 
2  Setting up VS.NET to debug Server side Methods .................................................................... 91 
3  Setting up VS.NET to debug Client side Methods ..................................................................... 93 
4  Setting up the server side logging .............................................................................................. 94 
External APIs ................................................................................................. 95 
1  .NET IOM ................................................................................................................................... 95 
2  COM-compatible IOM ................................................................................................................ 96 
3  RT IOM ....................................................................................................................................... 96 
4  iOS IOM ...................................................................................................................................... 97 
5  Android IOM ............................................................................................................................... 97 
Using CheckinManager ................................................................................. 99 
1  Submitting Images ..................................................................................................................... 99 
2  Submitting Drawings ................................................................................................................ 101 
3  Async Processing ..................................................................................................................... 104 