Aras Innovator ConfiguringSolutions StudentGuide July2023
Aras Innovator ConfiguringSolutions StudentGuide July2023
2
Table of Contents
3
Aras Innovator Configuring Solutions Student Guide
4
Unit 1 Introduction
Introduction
In this five-day course, you learn the fundamental concepts and skills needed to configure, manage, and
extend the Aras Innovator environment. Through hands-on exercises and lab activities, you gain an
understanding of how Aras Innovator can be used to create a variety of business solutions.
Course Goals
• Understand and create an ItemType.
• Create a user interface that allows operators to interact with the solution.
• Assign appropriate security policies to a solution.
• Define Classifications, Lifecycles, and versioning.
• Create and enhance Workflow maps.
• Support file upload/download as well as file replication.
• Automatically generate email correspondence.
• Define and implement Poly Items.
• Configure Command Bars.
• Design, develop and package a solution that incorporates a Lifecycle, supports versioning, and
uses a workflow.
The Configuring Solutions Course teaches you how to design and create simple solutions built with
custom categories (ItemTypes) that include forms, properties and relationships to other items being
managed by Aras Innovator. You will also learn how to replicate business processes by creating
workflows and to create a custom security model to define who can access or edit data. To make sure
that other Aras Innovator users get informed when they have tasks to perform, you will learn to set up
automated email notifications. We will also discuss how Aras Innovator can be configured to manage
the secure storage of third-party files in one or more vaults. The process of creating file replication and
distribution rules will be demonstrated in class exercises.
5
Aras Innovator Configuring Solutions Student Guide
6
Unit 1 - Introduction
7
Aras Innovator Configuring Solutions Student Guide
REQUIREMENTS QUALITY
PRODUCT
ENGINEERING MANAGEMENT
ENGINEERING
SYSTEM
PROGRAM COMPONENT
MANAGEMENT ENGINEERING OFFICE
TECH
DOCS SYSTEMS CONNECTOR
ARCHITECTURE
SIMULATION MANAGEMENT
VARIANT MANAGEMENT
DIGITAL TWIN
DIGITAL THREAD
The Application layer represents specific business functions commonly used by a business to support
their operations. These applications are built using the modeling engine and platform services.
• Subscribers of the Aras platform not only have access to all the existing applications, but they
also have access to changing the application through the modeling engine to meet their needs.
• A critical advantage of the Aras Platform is that all the applications existing today or being
developed in the future (by Aras or your organization) will use the same data model across the
end-to-end processes.
• Aras manages growing application base by ensuring their single data model is completely
aligned across applications.
8
Unit 1 - Introduction
Basic Architecture
Aras Innovator is an Internet application framework based on the Microsoft .NET platform. The basic
components include:
Aras Innovator Client
Aras Innovator uses a web-based browser interface which requires very few client resources. Aras
Innovator client runs in Microsoft Edge, Mozilla Firefox, or Google Chrome browsers.
Aras Innovator Server
Running as a Microsoft .NET application on Microsoft IIS 7 or higher requires the Microsoft Windows
Server platform.
Database
All configuration rules and code, as well as solution business objects are stored in the Microsoft SQL
Server database.
Vault Server
A separate server application maintains information about files that are linked to objects in the SQL
Server database.
Vault(s)
A file directory location made known to the vault server to store physical files.
9
Aras Innovator Configuring Solutions Student Guide
10
Unit 1 - Introduction
11
Aras Innovator Configuring Solutions Student Guide
12
Unit 2 Users and Identities
Overview
In this unit, you create Users and Identities in Aras Innovator.
Objectives
• Define Users and Identities
• Assign Members to Group Identities
• View Report on Identity Membership
• View System Identities
13
Aras Innovator Configuring Solutions Student Guide
Alias Identities
Whenever a User item is created, the Innovator Server automatically generates a corresponding system
record known as an Alias Identity. Every logged-on User needs an Alias Identity to represent them as
actors in system operations.
Identities are used in:
• ItemType Permissions
• User Interface selection
• Rights to create new item instances
• Workflow Assignments
• Lifecycle Promotions, etc.
14
Unit 2 - Users and Identities
Creating Users
The following fields define a User record:
Login Name Must be unique and is supplied by the user at log on.
Manager The user specified as the manager of the user. There is no specific
functionality attached to the Manager.
15
Aras Innovator Configuring Solutions Student Guide
In this exercise, you will create a login for yourself to use throughout this course. Make sure you are in
the correct database as specified by your instructor.
1. Login to your assigned database as ‘Admin’ with the password provided by your instructor.
2. Navigate to Administration > Users.
3. Click Create New User.
4. Complete the following fields with your desired user information (Please use a login name and
password that you will easily remember for the remainder of the class):
Logon Vault
Login Name First Name Last Name Password Email Enabled?
<login> <first name> < last name> <password> <email> Yes Default
16
Unit 2 - Users and Identities
17
Aras Innovator Configuring Solutions Student Guide
Group Identities
The following fields define a Group Identity:
Name The Name of the Group (typically a role in the organization).
Member Name The Member tab lists all members of this group Identity.
A Group Identity may contain as many members as necessary for an organization. Once the company
structure is in place, the top internal department Identities should be added as members to the All
Employees Identity. It creates a distinguishable Identity between Employees and external groups such as
All Suppliers and All Customers.
18
Unit 2 - Users and Identities
System Identities
There are several System Identities in Aras Innovator that are reserved for specific purposes (and cannot
be deleted or changed).
World
Represents all identities in the system. Every user in Aras Innovator belongs to the World.
Administrators
Allows an Identity to have administrative access to Aras. This includes but is not limited to access to the
Administration templates in the TOC and the ability to create further group identities with other
administrative rights, and the ability to break an Item Claim.
Creator
This identity represents the User that created (first saved) an item. When an item is saved, the
created_by_id System Property on the item is updated to point to the User creating the item (this value
cannot be changed). To use this individual in a security policy, lifecycle, or workflow, the reserved
identity Creator can be specified.
Owner
This Identity represents the value of the owned_by_id System Property on an item. Often it is useful to
allow a Creator to be able to specify another individual (or group) that will have some interaction with
this item later (e.g., lifecycle promotion, security, and/or workflow assignment). By placing the
owned_by_id property on a Form, a user or group can be chosen when the item is created or edited.
The value of this field can be accessed by using the Owner identity in a security permission or workflow
assignment.
As an example, the Owner identity is used by a Part item to allow assignment of an Assigned Creator, or
the identity responsible for the technical content and review of the item.
19
Aras Innovator Configuring Solutions Student Guide
Manager
This identity represents the value of the managed_by_id System Property on an item. You can use the
same technique as described for Owner to obtain the value of the managed_by_id property on a Form
using the reserved identity named Manager.
Super User
The Super User is a special user identified as the “root” user of the system. The “Super User” is defined
by the system to ignore all Permission settings; thereby, having access to all Items independent of their
Permissions. You should use this special Super User only in exceptional cases.
Administrator passwords should be changed to different passwords for different instances of Aras
Innovator. For example, the admin password should differ between your Test environment and your
Production environment.
20
Unit 2 - Users and Identities
Defining Identities
Identities can be grouped into Group Identities. A Group Identity may be composed of Individual
Identities or other Group Identities. The idea behind this Identity structure is to define a membership
structure for controlling and managing access rights as well as other system functionality.
Some other systems implement separate data models for individuals, groups, and roles. In Aras
Innovator, Identities generalize these concepts so one user can be assigned to one or many without
impacting the data model.
Identities, particularly Group Identities, serve many purposes in Aras Innovator.
• Identities define and control user/group security, or permissions allowed for the group.
• Identities determine what actions may be performed on an Item, such as add, get, update,
delete and/or discovery privileges.
• Identities determine activity assignments, such as an approval process in a workflow step.
• Identities can promote Life Cycle States and be assigned to Workflow Activities.
Multi-tiered hierarchy access can be created using Group Identities. All members of a Group Identity
inherit the access privileges of the Group Identity they belong to. Members are assigned through the
Member relationship tab in the Group Identity. Identities may belong to more than one group identity,
in which case the user's access or permissions are always cumulative.
Tip
Use Group or Role Identities for workflow assignments and lifecycle promotions; they are more flexible
than Alias Identities. It is easier to change group membership than individual Identity permissions.
21
Aras Innovator Configuring Solutions Student Guide
Hierarchy Example
In the example above, the three users are employees in the company’s Engineering department. Their
Alias Identities are added to the Engineering Group Identity. The Engineering Group Identity is added to
the All Employees Group Identity, creating a hierarchy.
22
Unit 2 - Users and Identities
23
Aras Innovator Configuring Solutions Student Guide
The Identity
Membership
Report shows the
entire Identity
structure, plus
rolled-up alias
membership.
9 © 2022 Aras
24
Unit 2 - Users and Identities
Summary
In this unit, you learned how to create Users and Identities in Aras Innovator.
You should now be able to:
• Define Users and Identities
• Assign Members to Group Identities
• View Report on Identity Membership
• View System Identities
Review Questions
1. What is automatically created when you create a new User?
2. What is the best way to see a Group Identity hierarchy that has been defined in the system?
3. What should be done if a User leaves the Organization?
25
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Create a new User and Identity based on a set of security requirements.
Scenario
You will be extending Identities so that when you are finished the organization looks like the following:
All Employees
Engineering CRB
Preparations
You should already have built the Engineering Identity with: Peter Smith, Susan Harris, and John
1.
Young Identities by following along with the instructor. If not, you will need to create them
before you start this lab exercise.
Users and Identities
1. Create a new User named Ann Reddy (Login Name: areddy with the innovator password), select
Logon Enabled, click Done, and check to ensure the Alias Identity is also created.
2. Edit the Group Identity named CRB (Change Review Board) and add the Ann Reddy Identity as a
member.
3. Also add the Ann Reddy Identity as a member of the Engineering Identity Group.
4. Run the Identity Membership report for Ann Reddy and check her group membership(s).
26
Unit 3 Exploring ItemTypes
Overview
In this unit, you review the main configuration settings of an ItemType and learn how to create new
ItemTypes. You also review several reports related to ItemType definitions.
Objectives
• Define the purpose of an ItemType
• Create a New ItemType
• Understand the ItemType Form
• Display ItemType Properties
• Run an ItemType Report
• Create an Item from an ItemType
27
Aras Innovator Configuring Solutions Student Guide
ItemType Overview
Almost everything in Aras Innovator is defined through an ItemType. ItemTypes define Properties,
Forms, or Views available for the item, Lifecycle maps and Workflow Maps associated with the item,
permissions, relationships, server and client methods and events that occur on the item, and much
more.
ItemTypes are the templates that define what kind of items a user will create in a solution.
28
Unit 3 - Exploring ItemTypes
What is an ItemType?
An ItemType is a template, a definition of Items created in the system. An item is an instance of an
ItemType, a created business object and managed by Aras Innovator.
• An ItemType defines data structure and behavior, analogous to a class in object-oriented
systems.
• ItemTypes are created by using a simple user interface and stored in the database.
• ItemType instances are called Items.
• ItemTypes are the basis for what makes Aras Innovator self-describing.
• ItemTypes have corresponding tables in the database.
Each Item that is created from an ItemType is assigned a unique 32-character identifier that is
guaranteed to be unique for the enterprise (id property). This is commonly referred to as the GUID
(Globally Unique Identifier).
Try it … Open an Existing Item Type Definition for Viewing
1. Login as an Administrator (your student login)
2. Navigate to Administration > ItemTypes in the Navigation Panel.
3. Search for and open the ItemType named Part.
29
Aras Innovator Configuring Solutions Student Guide
Name ItemType Names may contain letters, numbers, spaces, and underscores.
Since the ItemType name is stored as a table name in SQL Server,
ItemType names can be just about anything. A SQL table name is created
with all caps and spaces converted to underscores. In the above example,
the table name is Part.
Singular Label Labels are displayed throughout the system and come in either singular or
plural forms. The singular label appears on the form for each item.
Plural Label The system displays the plural label as a category of items in the TOC
pane.
Small Icon A small icon displays next to the item within the TOC and the Structure
Browser.
Large Icon The Large icon displays in the Form Layout as part of Item_info.
Aras Innovator supports the Scalable Vector Graphic (SVG) format, which allows an image to be scaled
to any size. Scalable Vector Graphic (SVG) files can be created and modified using many graphic editing
tools including the open source Inkscape utility (www.inkscape.org).
All SVG images provided by the Aras Innovator software are in a folder on the server:
<Root>\Innovator\Client\images\. An additional folder is reserved for any custom SVG images created
by customers: <Root>\Innovator\Client\customer\
30
Unit 3 - Exploring ItemTypes
31
Aras Innovator Configuring Solutions Student Guide
Auto Search The Aras Innovator client automatically performs a search when the
ItemType is selected on the TOC. Selecting this checkbox sets it to
true; however, it can slow the loading of items since it assumes a full
query search. This setting should be used mostly on ItemTypes
expected to have few instances (less than 100 would be a good rule of
thumb) but setting a Max Records and a Default Page Size to a low
value can also produce quicker results.
Default Page Size You can specify the default page size, which defines how many items
will appear on the search grid. Typically, this number is set to 25. If left
blank, the page size equals the Max Records field. Note that users can
override the page size setting when they perform a search.
Max Records You can specify the default Max Records size. This limits the size of the
returned data set, which can improve performance. Users can
override the Max Records size when they perform a search.
32
Unit 3 - Exploring ItemTypes
33
Aras Innovator Configuring Solutions Student Guide
History Template
History Templates are used to define the set of actions that trigger a history record to be stored by the
system. Aras Innovator provides a Default History Template that can be used as a reference for
configuring the history of an ItemType. Alternatively, you can create custom History Templates.
Track History Setting for Properties
Track History may be enabled to record property value changes as part of the Item history. Set Track
History on for each property on the ItemType that you want included in the history report. If the Track
History option is deselected, no property changes are recorded for this ItemType.
34
Unit 3 - Exploring ItemTypes
Class Structure
ItemTypes may contain a structure of subclasses where each class can refer to its own specific
properties, forms, and Lifecycle map.
A class structure can be many levels deep and wide depending on the complexity required. Also, this
Class Structure is ItemType specific. The assignment of a standard classification to an Item can only be
done at the lowest level.
Classification allows you to share properties among subclasses. If you define a property at a parent level
class, all subclasses will inherit those properties.
In the examples above, the Part ItemType has a defined class structure. Because each of the subclasses
share common attributes, it can be more efficient to use class structure versus creating entirely new
ItemTypes to differentiate different types of Parts.
Each of these subclasses can have their own:
• Additional specific properties (in addition to the properties defined by the parent ItemType)
• Lifecycle Map
• User Interface (View of a form)
• Can Add capability
The following choices are available for the field named Show Parameters Tab:
• Never – never show the Parameters tab on Items of this ItemType.
• When Populated – only show the Parameters tab on Items of this ItemType when classified
properties are available.
• Always – always show the Parameters tab on Items of this ItemType.
The Show Parameters Tab only becomes active in the special case when using a classification and would
show a proper tab in the Relationship accordion.
35
Aras Innovator Configuring Solutions Student Guide
36
Unit 3 - Exploring ItemTypes
Selecting a Classification
A user can select a classification by clicking on a configured form field. When the field is selected, the
Class Structure dialog displays. The user can use the filter, expand/contract, and layout features (if
necessary) to locate a specific class. The Return Selected button sets the classification for the current
Item.
The displayed form may change based on the selected classification.
In this example, a new Document Item is created and set as a Specification type. The Document form
contains a Type field that allows a user to select a classification for the Document Item.
This Class Structure is ItemType specific.
Try it … Select a Classification for an Item
1. Navigate to Documents > Documents and create a New Document.
2. On the new Document Form, type in a Document Number (required), a Name, and use either
Type Ahead or the Lookup button (…) to select Specification for the Type field.
3. Click the Done button.
4. Close the new Document tab and return to the tab containing the Part ItemType template.
37
Aras Innovator Configuring Solutions Student Guide
38
Unit 3 - Exploring ItemTypes
Demo Scenario
For demonstration in class, we will be working with a simple example scenario to illustrate various
features in Aras Innovator.
A large company that sells consumer electronics would like to track Design Requests made by both
Customers as well as internal employees of the company. Submitted Design Requests are then reviewed
by appropriate staff members to either approve or reject the request before changes to the product line
are made.
The Design Request should be linked to supporting documents as well as the customer that made the
request.
Can you identify the ItemTypes we will need to accomplish this solution?
39
Aras Innovator Configuring Solutions Student Guide
40
Unit 3 - Exploring ItemTypes
Creating an ItemType
Working with the Instructor, create the Design Request ItemType.
Try it … Create the Design Request ItemType
1. Navigate to Administration > ItemTypes and create a new ItemType.
2. Enter or select the following values on the ItemType Form:
Name Design Request
Singular Label Design Request
Plural Label Design Requests
History Template Default
Default Structure
Tabs Off
View
Small/Large Icons Choose from provided image list
41
Aras Innovator Configuring Solutions Student Guide
1. Navigate to the ‘Properties’ tab as shown above and use the ‘New Property’ button to create a new
Property with the following column values:
Name Label Data Type Length Width Sort Order
_title Title String 64 150 20
2. Save the Design Request ItemType. You will see 23 System Properties added to the Properties tab.
3. Next locate the created_by_id and created_on system properties on the properties grid and
uncheck the “Hidden” checkbox. Add respectively “Author” and “Date Created” in the Label column
as well:
42
Unit 3 - Exploring ItemTypes
Allowing Access
As mentioned previously, you must provide access for Users to be able to work with your new ItemType.
Depending on access permissions, the new ItemType also displays on the Main Grid’s Tile view.
Try it … Provide Access Permissions to the Design Request ItemType
1. Provide the following values by clicking on each Relationship Tab and adding a new row
(the Add button):
Relationship Tab Name Value
Can Add World (Can Add is checked)
43
Aras Innovator Configuring Solutions Student Guide
44
Unit 3 - Exploring ItemTypes
45
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how ItemTypes are configured and how to build new ItemTypes.
You should now be able to:
• Define the Purpose of an ItemType
• Create a new ItemType
• Understand the ItemType Form
• Display ItemType Properties
• Run an ItemType Report
•
Review Questions
1. What is the difference between an Item and an ItemType?
2. What are some key requirements you should consider when creating an ItemType?
5. An administrator creates an ItemType, but the end users cannot see it in the TOC Pane – why?
46
Unit 3 - Exploring ItemTypes
Lab Exercise
Goal
Create a Change Request ItemType.
Scenario
Use Aras Innovator to create a basic change management system that allows request items to follow a
prescribed Lifecycle map. In this lab, you first define and configure the Change Request ItemType so that
users can create one or more Change Request Items.
Steps
1. Make sure you are logged on to the correct database
as an Administrator (your student login).
2. Create an ItemType.
3. Provide the following information for the new Item Type:
Name Change Request
Singular Label Change Request
Plural Label Change Requests
History Template Default
Default Structure View Tabs Off
Search - Auto Search Yes [Selected]
Search - Default Page Size 20
Search – Max Records 100
47
Aras Innovator Configuring Solutions Student Guide
4. Select a small and large icon to represent the ItemType in the user interface.
5. Create a class structure to support these subclasses:
• Enhancement
• Defect
6. Save the Change Request ItemType.
Next, you need to allow users to be able to add new Items of type Change Request to the
database. For initial testing, we will allow everyone in the system (World) to add new Change
Requests. Later in the course we will fine tune the security of this ItemType to a select set of
users.
7. Configure the following for the Change Request ItemType using the Relationship tabs on the
ItemType form:
Can Add World
Permissions Default Access – (Ensure this is set as the Default permission)
8. Click the Done button to Save and unclaim the Change Request ItemType.
Note that, if you had been able to create a Change Request Item, the Tab title would show a
simple naming pattern to describe the Item, usually the GUID.
9. Edit the Change Request ItemType so that the Keyed Name uses the modified_on property, set
the Keyed Name Order to a positive number (integer) for the modified_on property in the
Relationships Grid, and click Done.
48
Unit 4 The Table of Contents (TOC)
Editor
Introduction
In this unit, you learn how to use the new Table of Contents (TOC) Editor.
Course Goals
• Describe the benefits of the TOC Editor
• Describe the TOC Editor interface and Toolbar buttons
• Create and Move a Category
• Add an ItemType button to a Category
• Customize the ItemType button in the TOC
• Preview the TOC as a specific Identity
49
Aras Innovator Configuring Solutions Student Guide
50
Unit 4 - The TOC Editor
51
Aras Innovator Configuring Solutions Student Guide
Move Down Moves the selected Category or ItemType button within its parent
Category. This button is disabled if the selected Category or
ItemType button cannot be moved lower.
Add to Package Add a newly created category or dashboard item to a Package
Definition Definition
52
Unit 4 - The TOC Editor
53
Aras Innovator Configuring Solutions Student Guide
54
Unit 4 - The TOC Editor
55
Aras Innovator Configuring Solutions Student Guide
You will now be able to access the Main Search Grid for the Design Request ItemType from the TOC.
56
Unit 4 - The TOC Editor
Using View As
The TOC Editor’s View As feature allows you to quickly see how changes to the TOC impact different
Identities without having to log out and back in. The View As filters also allow an administrator to
preview the TOC configuration in another language. After the admin chooses a language configured in
the database, the TOC Editor content will refresh and display the multilingual values stored for that
language. The TOC Editor enters a read-only mode when the View As filter is active.
Try it … View the TOC using the All Employees Identity
1. In the Contents pane, click View As.
2. For the Identity field, click the Select items button.
3. In the Select Items window, search for and select the All Employees Identity.
4. Click Clear to return to Edit mode.
57
Aras Innovator Configuring Solutions Student Guide
58
Unit 4 - The TOC Editor
Summary
In this unit, you learned how to use the new TOC Editor.
You should now be able to:
• Describe the benefits of the TOC Editor
• Describe the TOC Editor interface and Toolbar buttons
• Create and Move a Category
• Add an ItemType button to a Category
• Customize the ItemType button in the TOC
• View the TOC as a specific Identity
Review Questions
1. What can you add to the TOC using the TOC Editor?
2. How would you get a preview of the TOC without logging in as a different user?
59
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Add the Change Request to the Table of Contents.
Scenario
Use the TOC Editor to add the Change Request ItemType to the Product Management category.
Preparation
If you did not create the Product Management category earlier with the instructor, create it now.
1. Navigate to TOC > Administration > Configuration and click on the TOC Editor.
2. Do not select an existing Category.
3. Click the Add Category button and enter Product Management for the Label.
4. Click Save. The new Product Management category is created at the bottom of the TOC.
5. Move the Product Management category directly above the Sourcing category.
6. Click Save.
Steps
Create a Child Category for Change Requests
1.Under the Product Management category, add a child category named Improvement.
2. Add a Change Request ItemType button to the Improvement category.
3. Change the Access to All Employees and save.
Customize an ItemType button in the TOC
1. Use the TOC Editor to add the Change Request and Design Request ItemTypes to the My
Innovator category.
2. Change the Label to CRs and DRs, respectively.
3. Change the Access field’s value to Engineering.
4. If desired, change the icon.
5. Save the changes.
6. Use View As Engineering.
7. Click Clear to return the TOC Editor to Edit mode.
60
Unit 5 Itemtype Properties
Overview
In this unit, you learn how to assign properties to an ItemType. You also learn how properties are used
in the database.
Objectives
• Describe Property Basics
• Identify Property Types
• Explore Property Data Types and Settings
• Define an ItemType Property
61
Aras Innovator Configuring Solutions Student Guide
Property Basics
The Properties tab on the ItemType form contains all properties for a given ItemType (both custom
properties and system properties). Property names must use lowercase characters and the underscore
“_” character in place of spaces, which are not allowed.
ItemType Properties support a variety of Data Types, which are handled automatically by the Client and
Server for presentation and storage purposes. Properties can optionally be initialized with default
values, configured to be required (not null), enforce uniqueness, or formatted.
Display settings applied to search grids include sorting, column order, labels (spaces allowed), display
widths, or hidden completely. Properties also correspond directly to Fields in User Interface Forms,
which will recognize a Property by Data Type and provide the correct behavior.
The ItemType schema is represented in its corresponding database table, which contains a column for
each property from the Properties tab. Specifically, the table contains:
• A row for each Item instance of the ItemType (Item instance)
• A column for each Property under the ItemType
• Values in each Property column for each Item instance row
62
Unit 5 - Itemtype Properties
Types of Properties
Properties are also referred to as attributes or meta data. Aras Innovator supports properties that are
set by the server as well as custom properties created by administrators.
System Properties
System properties are created by the Aras Innovator System when a new ItemType template is created.
Some of the included properties are: creation date, created by, Lifecycle State, revision, generation, etc.
System Properties are used by the functionality of Aras Innovator; therefore, they should not be
deleted, and their functionality must not be modified.
Custom Properties
Custom properties are created by an Aras Innovator administrator for a specific ItemType to store
custom information specific to the ItemType. For example: Title, Description, Completion Date, Patent,
etc.
Extended Properties
Extended Properties are a pool of properties created on a global scope by a Classification Administrator.
They are often used to store information that is common across ItemTypes, such as model, series,
dimensions, color, weight, shipping method, etc. Extended Properties can be organized into a
hierarchical classification tree (Extended Classification). Alternatively, they can be maintained
programmatically.
63
Aras Innovator Configuring Solutions Student Guide
System Properties
When an ItemType is saved, the system creates 23 System Properties by default, as follows:
Property Description Property Description
classification class path of the item major_rev major revision of versioned
item
config_id common id across generations managed_by_id id of Manager identity
of an item
created_by_id id of user that created the item minor_rev not used
created_on date item was created modified_by_id id of last user that changed
item
css cascading style sheet modified_on date item changed
current_state id of current Lifecycle State new_version
item
generation sequential version number not_lockable true (1) if item cannot be
claimed (i.e., edited)
id a 32 character globally unique owned_by_id id of Owner identity
identifier (GUID) for the item
is_current true (1) if this is the most permission_id id of the current Permission
current version item
is_released true (1) if this item is released state current state (text)
keyed_name value of the keyed name, in team_id id of current Team item
order
locked_by_id id of user that has claimed item
64
Unit 5 - Itemtype Properties
Custom Properties
Custom properties are created by an Aras Innovator administrator for a given ItemType to store
information specific to that ItemType according to the specified Data Type.
For example:
• Title,
• Description,
• Completion Date,
• Patent, etc.
We will be using them throughout the exercises we complete during this class.
65
Aras Innovator Configuring Solutions Student Guide
Each Data Type setting will be recognized by the User Interface automatically for input/output purposes.
The underlying Database also stores Property values according to the configured datatype.
66
Unit 5 - Itemtype Properties
67
Aras Innovator Configuring Solutions Student Guide
68
Unit 5 - Itemtype Properties
Property Settings
ItemType Property Settings are configured in the Relationships Grid under the Properties tab.
Length
Length sets the maximum number of characters for string values.
69
Aras Innovator Configuring Solutions Student Guide
Hidden2
The Hidden2 setting determines the property visibility on the Relationship Grid. If set to true, the
property is not displayed on the relationship grid.
Alignment
Alignment determines the left/right/center alignment of the property in grids.
Width
Sets the width of the property column on the Search Grid (in pixels).
Sort Order
Sort Order determines the column order of the property on grids. Use integer values that control the
relative position of columns in a search grid display with lower values displaying from left to right.
Keyed Name Order
Keyed Name Order controls the keyed name of an item. A keyed name is an alternate way to identify an
item. A keyed name is comprised of one or more item properties separated by a space. If no keyed
name for an ItemType is specified, the keyed name is the same as the Item id property (the GUID). The
keyed name may use as many property values as necessary to identify the item in a meaningful way. You
assign the order of the properties in the keyed name field using numbers (low to high) to control the
sort in returned records. For example, an Employee item has two properties defined: first_name and
last_name. To create a keyed name with the value of the last name [space] first_name, order the
properties using numbers in the Keyed Name Order field (e.g., property last_name = Keyed Named
Order 10 and property first_name = Keyed Name Order 20). A keyed name is set when the item is saved
to the database.
Order By
Order By controls the ascending sort order of the items displayed in the main item grid, after either a
manual or an automatic search. Whichever property has the lowest value set with Order by, is the first
one to control the order. For example, if you want to order the employees by last name and then by first
name, last name will have a value of 1 in the Order By property, and first name would have a value of 2.
70
Unit 5 - Itemtype Properties
71
Aras Innovator Configuring Solutions Student Guide
If the property is of type String, the Pattern follows basic regular expression syntax. For example, to
require that a user enters a telephone number in the format ###-###-#### you could use the regular
expression: [0-9]{3}- [0-9]{3}- [0-9]{4}$
If the property is type Filter List, then Pattern is the pointer to the property which defines the filter.
Class Path
The Class path property setting indicates that the property is only available to this subclass (and any
additional subclasses of this subclass). Only use this property setting if a Class Structure has been
implemented on the ItemType.
Foreign Property
Foreign properties work with Item data type properties to allow you to refer to and display properties of
another related Item. The Foreign Property stores the Property name of the referenced Item.
Track History
The Track History property setting indicates that the changed to and changed from values of the
property will be stored in the Item’s audit history depending on the ItemType History Template selected.
Item Behavior
Item Behavior refers to properties where the data type is Item, and the target item specified by the
property is versionable. Item Behavior can be Fixed or Float.
72
Unit 5 - Itemtype Properties
73
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how Properties are configured and how to build Custom Properties for an
ItemType.
• You should now be able to:
• Describe the difference between System Properties, Custom Properties and Extended Properties
• Create a Custom Property for an ItemType
• Identify Property Settings
• Use the Property Data Types for different situations.
Review Questions
1. Where are Custom Property definitions stored in the database?
74
Unit 5 - Itemtype Properties
Lab Exercise
Goal
Be able to create custom properties for an ItemType and understand where the property data gets
stored in the database.
Scenario
In this exercise, you make a property required and create custom properties for the Change Request
ItemType.
Steps
Before you can make a Property required, you must first delete any existing items because their values
for the Property are null.
1. Open the Change Request ItemType for editing.
2. Set the owned_by_id label to Owner.
3. Select the Properties Tab and set the owned_by_id to Required.
4. Click Save.
5. Add the following properties to the Change Request ItemType:
Property Name Label Data Type Length Precision Scale Width Sort Class
Order Path
_title Title String 64 150 40
_reason Reason String 256 250 60
_target_date Target Date Date
_cost_estimate Cost Estimate Decimal 6 2
_defect_details Defect Details String 128 Defect
6. For the state property, uncheck the Hidden checkbox and set the Sort Order to 20.
7. Click the Done button to save the Change Request ItemType and release your claim.
75
This page intentionally left blank
76
Unit 6 Creating Object Properties
Overview
In this unit, you create properties of several different data types. Using these different data types can
provide a more robust user interface. Users will be able to populate values using searches, by selecting
from a dropdown list and even browse for an image. Some of these data types even auto-populate data,
saving users from having to enter data manually.
Objectives
• Define an Item Property
• Define a Foreign Property
• Define a List Property
• Define a Filtered List Property
• Build a Sequence
• Use an Image Property
77
Aras Innovator Configuring Solutions Student Guide
78
Unit 6 - Creating Object Properties
79
Aras Innovator Configuring Solutions Student Guide
80
Unit 6 - Creating Object Properties
81
Aras Innovator Configuring Solutions Student Guide
82
Unit 6 - Creating Object Properties
83
Aras Innovator Configuring Solutions Student Guide
Note: it is very important to think about the user’s experience when using Filtered Lists. The standard
practice is to setup the Primary List as Required, in order to have the correct value selection in the
Secondary List.
In addition, using the List No Blank setting on the Form Field Type tab can avoid mistakes or confusion
during data entry.
84
Unit 6 - Creating Object Properties
3. Click Done.
85
Aras Innovator Configuring Solutions Student Guide
Data Source The Filtered List to be used for this list box.
Pattern The property that has been configured to store the value of the source
list.
Try it … Configure a List
In these two exercises, you first configure the List Data Type, then you configure the Filter List data
Type.
1. Return to the Design Request ItemType and click the New Property button.
2. Enter _product_division for the Name, Product Division for the Label, and enter List for the Data
Type using the Product Divisions List as the Data Source.
3. Your data should look like this example:
Name Label Data Type Data Source
_product_division Product Division List Product Divisions
4. Click Save.
86
Unit 6 - Creating Object Properties
3. Click Save.
87
Aras Innovator Configuring Solutions Student Guide
Defining a Sequence
Sequences provide auto-numbering capabilities for Items. Properties of data type Sequence are
populated on the server when the user saves the item after the check for required properties.
You should not mark a Sequence Property as required, since the server populates a Sequence Property
only after having checked the existence of required Properties.
88
Unit 6 - Creating Object Properties
Creating a Sequence
The following fields are used to create a Sequence:
Prefix Up to 16 characters that will prefix each sequence number.
Initial Value This value is used to set the Current Value or import to another Aras
database if the Current Value field is NULL.
Current Value Current sequence number value.
Suffix Up to 16 characters that will follow each sequence number.
Pad With Padding character to use (if blank no padding characters display).
Pad To Total number of characters in the sequence number (excluding prefix
and suffix).
Step Increment of sequence number (typically 10).
Set Data Add a new property to an ItemType and specify Sequence as the Data
Source Type.
89
Aras Innovator Configuring Solutions Student Guide
4. Click Done.
5. Return to the Design Request ItemType tab and ensure you are in Edit mode.
6. On the Properties Tab, click the New Property button.
7. Add a new property named _item_number, with a Label of Request Number, and with Data Type
Sequence that uses the Design Request Sequence as the Data Source.
8. Delete the Keyed Name Order value for the created_on property and the _title property.
9. Add a Keyed Name Order value of 10 for the new _item_number property.
10. Set Sort Order to 10, and Width to 150
Click Save.
90
Unit 6 - Creating Object Properties
91
Aras Innovator Configuring Solutions Student Guide
92
Unit 6 - Creating Object Properties
Summary
In this unit, you learned how to create properties that use another Item as their value and how to access
the Properties of this other Item. You also learned about Lists and Sequences.
You should now be able to:
• Define Item Properties
• Define a Foreign Property
• Define List and Filtered List Properties
• Build a Sequence
• Use an Image Property
Review Questions
1. Foreign Property values can be edited by an end user in a Form. (True or False?)
93
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Add Properties to an ItemType that uses another Item as the Data Source. Add additional Data Type
properties to an ItemType that allows automatic sequencing, selection from a list, and access to Foreign
Properties.
Scenario
You define an automatic sequence number for Change Requests when they are created and add some
additional properties that presents a list to a user. You also define Properties linking a Change Request
with a Document and display the name of the document to the user.
Steps
1. Create a new sequence named Change Request Sequence that includes the following settings:
2. Create a new List named Regions. The List should display the following:
3. Create a new Filtered List named Design Centers. The filtered list should be tied to the Regions
list you built above. As this second list is a filtered list, please make sure to populate the second
tab ‘Filter Value’. The Filtered List should respond as follows:
94
Unit 6 - Creating Object Properties
4. Open the Change Request ItemType for editing and remove the Keyed Name Order for
modified_on.
5. Add the following properties to the Change Request ItemType:
Property Name Label Data Type Data Source Sort Keyed Name Pattern
Order Order
_item_number Request Sequence Change 10 10
Number Request
Sequence
_region Region List Regions
_design_center Design Filter List Design Centers _region
Center
_attachment Document Item Document
6. Add a Foreign Property named _attachment_name that will be used to display the name of a
selected document based on the _attachment property above.
(HINT: In the Data Source dialog, click the plus sign (+) next to _attachment and select name as
the Foreign Property.)
7. Click Done.
95
Aras Innovator Configuring Solutions Student Guide
96
Unit 7 Creating the User Interface
Overview
In this unit, you create a user interface for a solution that allows a user to interact with web forms.
Objectives
• Understand Forms and Views
• Create a User Interface using the Form Editor
• Review Field Settings
• Review Form Settings
• Build an ItemType View
97
Aras Innovator Configuring Solutions Student Guide
98
Unit 7 - Creating the User Interface
99
Aras Innovator Configuring Solutions Student Guide
Regenerating a Form
A Form with the same name as the ItemType is automatically created when the ItemType is created and
saved in the database. You can manually add Custom ItemType properties to Forms using a Form Editor
tool, but we can also run an Action to get us started. The RebuildViewAction resets the Form, adding any
non-hidden Properties defined for the ItemType. Use the RebuildViewAction only on new Forms, as it
removes any previously added Form items. Make sure the Form is not claimed before attempting to
regenerate it.
You can reposition Fields on a Form by dragging them or using X and Y coordinates. Field characteristics
can be changed using the Field tabs.
Try it … Regenerate a Form
We want to regenerate the Form so the new properties we recently created are displayed.
1. Navigate to Administration > ItemTypes and open the Design Request ItemType for viewing.
2. On the Views relationship tab, right-click the Design Request (Default) Form and select Actions >
RebuildViewAction from the context menu.
3. Right-click the Design Request (Default) Form again and select Open to open the Form Editor to
see the Custom Properties have been added.
100
Unit 7 - Creating the User Interface
Field and Form Specific information about the Form and each Field on the Form.
Definitions
Empty Fields A series of Controls you can add to a Form – you can then
Toolbar associate the field to a property. This is where you can also add
the xClass Tree Hierarchy for Extended Classification.
Form Layout A drag and drop area to design the Form the user sees at
runtime.
101
Aras Innovator Configuring Solutions Student Guide
102
Unit 7 - Creating the User Interface
2. Click Save.
103
Aras Innovator Configuring Solutions Student Guide
Field Toolbar
Use the Field Toolbar to add empty field controls to a Form. If you use the Unused Properties option,
Fields are added automatically with the Property Data Type. You can add the following fields:
Text field
Password field New Button
Text Area Field Date field
Dropdown Field Color field
Single Select List Box field HTML field
Multi Select List Box field xClassification control
Checkbox field Unused Properties Dropdown
104
Unit 7 - Creating the User Interface
2. Click Done.
105
Aras Innovator Configuring Solutions Student Guide
106
Unit 7 - Creating the User Interface
107
Aras Innovator Configuring Solutions Student Guide
Field Physical
The following fields define a Physical Field:
Positioning Absolute X and Y: measured from top left of Form, default and
recommended.
Relative X and Y: measured from where browser would place the
field in field order.
Static: position determined by browser, X and Y ignored.
XY Row, Column Position.
X and Y are measured in pixels.
Field Order Number representing the order of each field in a Group Box
Tab Index Tab key order of field if Tab Stop checkbox is selected.
108
Unit 7 - Creating the User Interface
109
Aras Innovator Configuring Solutions Student Guide
Identity Defines who has access to this Form (defined in ItemType View).
Function Specifies what the Form is used for (editing, viewing, printing, etc.)
Default includes edit and view.
Classification ItemType classification associated with this Form.
Width Sets the actual width of the Form (in pixels). Impacts the size of any
Form displayed in a tab.
Height Determines the actual height of the Form (in pixels). Impacts the
height of an accordion (if set too small, fields set may not be visible
and a vertical scrollbar is added to the accordion).
Stylesheet Stylesheet that is applied to the Form when opened.
110
Unit 7 - Creating the User Interface
111
Aras Innovator Configuring Solutions Student Guide
Creating a View
Views are the relationship between an ItemType and a Form. For an end user to see the Form, you must
associate it with an ItemType. Aras Innovator automatically creates a view to a Form with the same
name as the ItemType the first time you save an ItemType to the database. Additional forms can be
associated with an ItemType using the Views relationship tab.
Try it … Create and Classify a View
In this example, we modify the Design Request ItemType to support an Internal Classification View and
allow only employees to view the Internal Form.
1. Open the Design Request ItemType for Editing.
2. On the Views tab, click the Add Forms button.
3. Search for and select the Design Request Internal Form.
4. Set the Type to Default, the Identity to All Employees, and Classification to Internal.
112
Unit 7 - Creating the User Interface
Configuring Views
Multiple views can be configured for an ItemType to provide custom displays based on function,
identity, and class:
Type Default – Form used when adding, editing, viewing, or printing an Item.
Add – Form used the first time an Item is added.
Edit – Form used when the Item is locked for editing.
View– Form used for viewing the Item.
Print – Form used to print the Item.
Complete – Form used for configurable InBasket dialog.
Preview – Form displayed when Preview > Form is enabled in the Search
tab.
Identity Form available for members of defined Identity.
Classification If Class Structure is implemented, the Form to display for a specific class.
Display If more than one Form meets the selection criteria, the form display order
Priority priority (1 = highest priority, 2, 3, etc.).
113
Aras Innovator Configuring Solutions Student Guide
114
Unit 7 - Creating the User Interface
115
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how to create an Item View using the Form Editor.
• You should now be able to:
• Create a User Interface with the Form Editor
• Configure the Form and Body Properties
• Include an xProperties Hierarchy on a Form
• Describe available Field Types
• Create and Configure an ItemType View
Review Questions
1. What is the difference between a Form and a View?
116
Unit 7 - Creating the User Interface
Lab Exercise
Goal
Configure a Form for an ItemType allowing changes to property values.
Scenario
You edit the Change Request Form to allow a user to supply values to the custom properties created
earlier. The original Form, associated to the Change Request ItemType with a View relationship, does
not display any properties. To save time, you can regenerate the Form, which automatically adds the
custom properties.
Please configure the Change Request Form like the following image:
Steps
1. Open the Change Request ItemType for editing and select the Views tab in the Relationships
Grid.
2. Right-click and select Actions > RebuildViewAction from the menu.
3. Select the Change Request Form and set the Identity to All Employees.
4. Save, then right-click on the Change Request Form again and select Open from the context
menu.
5. Notice the properties that have been added to the Form.
6. Click the Edit button to edit the Form.
7. Set the Title field’s Display Length to 350.
8. Rearrange the custom properties on the form.
117
Aras Innovator Configuring Solutions Student Guide
9. Set both Region and Design Center to List no Blank and save the Change Request Form.
10. Using the Unused Properties dropdown, add the following system properties to the Form and
label them as shown below:
Property Label
created_on Date Created
is_released Released
created_by_id Creator
classification Type
owned_by_id Owner
11. Set Tab Stop values if desired and click Done. Close the form.
12. Create several Document items using Documents > Documents. Be sure to fill in the Document
Names. These will be available to become related items to the Change Request item.
13. Test your work by creating a new Change Request Item.
14. Make sure you can select a Region, Design Center and select a related Document Item.
15. When the Item is saved, the name of the selected Document Item should display.
16. Click Done.
Classify a View
To differentiate a defect from an enhancement request, build a new Form to capture defect details.
1. Create a copy of the Form you created in the previous steps (use Save as from the Forms’ search
grid).
2. Edit and name the copied Form Change Request Defect.
3. Edit the Change Request ItemType, add the new Change Request Defect Form in the Views
relationship. Set the Type to Default, and set the Classification to Defect.
4. Change the Identity to All Employees.
5. Save the Change Request ItemType and close the Change Request Defect Form (this will enable
the class-specific selection in the Unused Properties pull-down).
6. Re-open the Change Request Defect Form for editing. Add the _defect_details property to the
Form, click Done.
7. Test your work by creating a new Change Request and selecting the Defect subclass from the
Type field.
118
Unit 8 - Creating Item Relationships
119
Aras Innovator Configuring Solutions Student Guide
Each RelationshipType is represented as a separate tab on the Form. Relationship Items (instances of
Relationship ItemTypes) can be added as rows under each tab by users in the Relationships Grid.
120
Unit 8 - Creating Item Relationships
RelationshipType
When you create a Relationship, the required source and the related ItemTypes are defined in the
RelationshipType Item.
You can configure how many items can be related to the source item (one-to-one, one-to-many) and
how versions should be treated among related Items.
You can also configure some general default settings for how items will be displayed on the source item
relationship search grid (tab location, auto-search, and several items for page controls).
Additionally, you can configure whether to allow the related items to be selected from items that have
been previously created and stored within the database, to allow creation of a new item as a
relationship is being made, or both.
121
Aras Innovator Configuring Solutions Student Guide
Relationship ItemType
When you create a RelationshipType, a Relationship ItemType is automatically created in the database
with the same name. This template defines the information that the Relationship Items will be able to
store.
Relationships are also Items, and they can store additional information about the relationship in the
database. For example, the Part BOM relationship in the standard PE Solution stores the number of
related Parts from a parent Part in a property named Quantity.
The display of certain properties and the location of columns displayed on the parent item are set on the
Property tab of the Relationship ItemType.
122
Unit 8 - Creating Item Relationships
123
Aras Innovator Configuring Solutions Student Guide
124
Unit 8 - Creating Item Relationships
125
Aras Innovator Configuring Solutions Student Guide
Hide in All If checked, hides the relationship on the Relationships Grid of the
parent Item.
Paste Defaults Copy Permissions- a user can copy a relationship from one item to
another by choosing the Copy action in the Relationship grid (right
click menu).
Note: If a user performs a Paste Special and selects the Create
Related option, the related Item is copied. If the related Item has a
Private Permission, the Private Permission is also copied to the new
related Item(s).
Related Item The name of the Child ItemType.
Type
Min Occurs The Minimum number of related items required.
Behavior Establishes whether the links to the related items are fixed to a
specific version or float to the most current version.
126
Unit 8 - Creating Item Relationships
Grid View Right - places the related Item Properties (the columns) on the
right side of the grid; the relationship properties are listed to the
left of those columns.
Left - places the related item properties on the left of the grid
before all the relationship properties have been listed.
Intermix - the columns are ordered only by the sort_order value of
each property, so the relationship properties and the related
properties will be intermixed.
On New Related Allows the user to select existing Items, create new ones, or both.
Option
Requires Related When selected, removes the “No Related” choice in the
relationships grid. A user must either select an existing related Item
or create a new one.
Open Related If checked, the related Item form displays, allowing a user to enter
Form data in a Form rather than using the Relationship Grid columns.
Auto Search Display search results automatically for related Items of this
Relationship Type.
Default Page Size The number of items returned in the Search grid (Results per page).
127
Aras Innovator Configuring Solutions Student Guide
128
Unit 8 - Creating Item Relationships
129
Aras Innovator Configuring Solutions Student Guide
130
Unit 8 - Creating Item Relationships
131
Aras Innovator Configuring Solutions Student Guide
132
Unit 8 - Creating Item Relationships
133
Aras Innovator Configuring Solutions Student Guide
RelationshipType Patterns
Aras Innovator has three typical RelationshipType patterns, but there are others like relationships
relating to other relationships.
• A Direct RelationshipType is a commonly used pattern and is best described as having a Source
ItemType and a Related ItemType. See Diagram A above.
• A Circular RelationshipType simply references itself, such as a standard Aras Innovator Part
ItemType. Viewing the Part BOM RelationshipType reveals the Source and Related ItemTypes
are both a Part ItemType. In a Bill of Materials (BOM) hierarchy, Parts are connected to other
Parts through the Part BOM RelationshipType.
• Null relationships must have at least one visible property in the Relationship ItemType or they
will fail since they have no related ItemType. The Part ItemType contains a good example of a
Null RelationshipType named Part Goal. The Part Goal RelationshipType does not have a Related
Item since we only need it to display properties in the relationship grid.
Relationships may also be linked to other Relationships. An example is the (Part) BOM Substitute in the
standard PE Solution. The Part BOM Relationship contains a link to the BOM Substitute Relationship
which contains a pointer to a Related Item Part used as a substitute in form, fit, and function for that
BOM entry. To see this Relationship example, view a Part BOM entry (using a right mouse-click) on a
Part and then select the Substitutes tab.
134
Unit 8 - Creating Item Relationships
135
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how to relate one ItemType to another ItemType using a Relationship. You also
learned how to use NULL relationships to solve certain problems.
• You should now be able to:
• Define Relationships between ItemTypes
• Understand the Relationship ItemType
• Understand the RelationshipType
• Describe Typical Relationship Patterns
• Describe the Benefits of NULL Relationships
• Search for Items using Relationship Criteria.
Review Questions
1. What is the difference between a RelationshipType and a Relationship ItemType?
136
Unit 8 - Creating Item Relationships
Lab Exercise
Goal
Create a relationship between two or more Items, assign the appropriate configuration, and define and
use a Null Relationship.
Scenario
The original requirements for the Change Request system stated:
• Establish a required connection to a Customer.
• Allow a user to attach Parts to a request.
• Log one or more review notes made by the Change Review Board for tracking progress.
In this exercise, you establish relationships from the Change Request to a Customer Item as well as Part
Items. You also add the ability to create review notes for a Change Request using a Null relationship.
Steps
1. Open the Change Request ItemType for editing and set the Default Structure View field to
Tabs On.
2. Open the RelationshipTypes tab and using the Add ItemTypes button, add two new
RelationshipTypes (Part and Customer).
3. For each Relationship, enter a Relationship Name and Tab Label. See example below.
4. Click Done.
137
Aras Innovator Configuring Solutions Student Guide
A Change Request requires a relationship to a Customer; therefore, open the Change Request
5.
Customer RelationshipType and modify it so that Min Occurs is set to a value of 1.
6. Parts related to a Change Request should only be created or selected.
7. Next, create a new Change Request Item. Verify the Parts and Customers tabs are visible in the
Relationships grid.
8. Add at least one Customer.
9. Now add a Part Item.
10. Create some additional Change Requests with Customer and Part relationships to test your
work.
Capture Review Notes
Next, we want to add the ability to capture Review Notes in the Change Request.
You accomplish this using a Null relationship.
1. Open the Change Request ItemType for editing.
2. On the RelationshipTypes tab, click the New RelationshipType button to create a new
RelationshipType not pointing to any other ItemType. Set the Relationship Name to Change
Request Memo, the Tab Label to Review Notes. The Name field will remain empty, as shown
below.
3. Save
4. Open for editing the ItemType named Change Request Memo that was automatically generated
by defining the new RelationshipType.
5. Add a String property to hold the Review Note text.
138
Unit 9 Assigning Security
Overview
In this unit, you define security so that only authorized users have access to a solution by configuring the
system to grant specific permissions to groups of individuals.
Objectives
• Explore the Aras Innovator Security Model
• Create Permissions
• Configure Special Permissions
• Create Private Permissions
• Assign Team Permissions
• Understand Password Policies
139
Aras Innovator Configuring Solutions Student Guide
Security Overview
Authentication
Authentication provides a way of identifying a user, typically by having the user enter a valid username
and password before access is granted. The process of authentication is based on each user having a
unique set of criteria for gaining access. The server compares a user's authentication credentials with
other user credentials stored in a database. If the credentials match, the user is granted access to Aras
Innovator. If the credentials are at variance, authentication fails, and access is denied.
Authorization
After logging into a system, for instance, the user may try to create or edit Items. The authorization
process determines whether the user has the authority to perform such actions. Authorization is the
process of enforcing policies: determining what types or qualities of activities, resources, or services a
user is permitted. Usually, authorization occurs within the context of authentication. Once a user is
authenticated, the user may be authorized for different types of access or activity.
User Identities and Permissions
Aras Innovator provides security Authentication with configured User records as well as Authorization
through Permissions.
In this unit, you learn how to create and configure Permissions.
140
Unit 9 - Assigning Security
Permissions
A Permission defines what access a user or group has to an Item. A Permission identifies one or more
Identities and the rights and privileges assigned to each Identity, such as the ability to view, edit, etc.
Permissions are assigned to an ItemType to define the default security for all Items of that type.
Permissions can also be assigned to LifeCycle states to change the security of an Item over its lifetime.
A system property named permission_id identifies the Permission for the current Item being viewed or
edited by a user. An Item can only have one Permission active at any one time, but many Items can
share the same Permission definition.
Assigning Lifecycle Maps to subclasses of ItemTypes allows you to have different Permissions for
different subclasses.
A special type of Permission, known as Private, allows you to define a Permission that is specific to one
Item only and is never shared.
141
Aras Innovator Configuring Solutions Student Guide
Creating a Permission
Permissions are defined with a name and are related to one or more Identities having the following
access rights.
Get Access
Enables Identities to retrieve and view an Item.
Update Access
Enables Identities to edit existing Items.
Delete Access
Enables Identities to delete Items.
Can Discover
Allows the user to search for items and view limited information about them in the search grid, but not
view the detailed information that would be present on the Item form.
Can change access
Enables Identities to select or create different permissions for an Item.
Show Permission Warnings
Permission Warnings inform users about not having access to Items.
Note
Remember that Can Add and TOC Access are configured separately from a Permission. Can Add is set
directly on the ItemType and TOC Access is configured in the TOC Editor.
142
Unit 9 - Assigning Security
143
Aras Innovator Configuring Solutions Student Guide
3. Click Done.
We added the Update permission to Engineering, but this group cannot yet create items. For the
sake of consistency, we will add this access in the next steps.
4. Navigate to Administration > Item types and open the Manufacturer Part Item type for editing.
5. In the Can Add relationship tab, add Engineering Identity and tick ‘Can Add’.
6. Click Done.
144
Unit 9 - Assigning Security
145
Aras Innovator Configuring Solutions Student Guide
146
Unit 9 - Assigning Security
147
Aras Innovator Configuring Solutions Student Guide
148
Unit 9 - Assigning Security
149
Aras Innovator Configuring Solutions Student Guide
150
Unit 9 - Assigning Security
151
Aras Innovator Configuring Solutions Student Guide
Team Members Name An Identity that is defined as a member of the Team. This can
be a Group or Alias Identity.
Role A Team Role. Can choose Team Manager, Team Member, or
Team Guest. If you leave it blank, the Identity assumes the
role of Team.
152
Unit 9 - Assigning Security
153
Aras Innovator Configuring Solutions Student Guide
Team Permissions
By creating Teams, you can supplement the robust security system provided in Aras Innovator. Team
Roles can be assigned to a Permission to enhance access to Items. The actual user that represents the
Team Role gains access based on the selected Team for an item.
Once Permissions are edited to include Team Roles, and the Team property is added to an item, access
for team members is enhanced.
In this example, the Design Request Permission has been modified to include both the Team Manager
and the Team Member roles with appropriate security rights based on their level of responsibility.
Try it … Assign Team Permissions
1. Navigate to Administration > Permissions and open the Design Request Permission for editing.
2. On the Access relationship tab, grant access to the following Identities using the values as
shown.
3. Click Done.
154
Unit 9 - Assigning Security
11. You can logout (as Tom Chan) and close the browser.
155
Aras Innovator Configuring Solutions Student Guide
156
Unit 9 - Assigning Security
Data Location
The Data Location dimension of SEA describes where the data that the external user accesses is
physically located, either inside or outside your company’s firewall. This configuration is implemented by
your IT department and dependent upon your business use cases. The choice for your configuration
tends to be strongly dictated by your corporate policy, which drives decisions about the other two
dimensions.
• Inside the Firewall – Single Database: Data is contained in a single database inside of the firewall.
• Outside the Firewall - Multi-Database: This approach involves setting up a separate Aras server and
database instance in a location outside the firewall. Either in an isolated network positioned between
the Internet and the private network) or in the cloud.
Client Access
Client Access defines the type of client front-end that you use to gain access to the system. Two
fundamental types of clients are predominantly used, although other types are possible.
• Standard Aras Web Client: Using the standard HTML client, suppliers and partners can make use of
full functionality within Aras Innovator.
157
Aras Innovator Configuring Solutions Student Guide
Password Policies
If you are not using External Authentication, then Password policies allow flexibility for administrators to
configure and maintain User passwords. System variables are used to specify password restrictions. In
addition, each Identity has some restrictions that can be independently applied such as aging and
history.
There are two Password settings for each user. Maximum Password Age indicates the password must be
changed after this specified number of days. Password History Length specifies how many old passwords
are saved and prevented from being used again when resetting a password.
You can view or change any of the following Variables.
User_pwd_symbols_min_number defines a minimum number of characters for a password.
-1 means there is no minimum number.
User_pwd_digits_min_number defines the minimum number of integers in a password.
-1 means there is no minimum number.
AccountLockoutThreshold_triesNum defines the number of incorrect password tries before an account
is locked out. Must be used with
AccountLockoutDuration_minutes.
AccountLockoutDuration_minutes defines the number of minutes before an account is released from
being locked out. Must be used with
AccountLockoutThreshold_triesNum.
Try it … View or Change Password Settings
1. Navigate to Administration > Identities and locate the alias Identity for Peter Smith.
2. Notice the available settings for Maximum Password Age and Password History Length.
158
Unit 9 - Assigning Security
Summary
In this unit, you learned about how to implement the Aras Innovator security model.
You should now be able to:
• Create Permissions
• Create Private Permissions
• Assign Discovery Privileges
• Assign Team Permissions
• Assign Password Policies and Permissions
Review Questions
1. Can a Private permission apply to more than one Item?
2. How would you prevent someone from being able to search and see an Item in the search grid?
3. How can you block someone from the system after 3 failed logons?
159
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Refine the security of the Change Request ItemType to allow only certain users to perform specific
operations on new or existing Change Request Items.
Scenario
Refine the permissions for the Change Request ItemType.
Preparation
Before beginning this exercise, delete any existing Change Request Items you created in
1.
previous exercises. This will make it easier to see how making changes in security affects a user’s
ability to work in the system.
Permissions
1. Create a Permission named Change Request and configure the Permission as follows:
2. Click Done and open the Change Request ItemType for editing and replace the Default Access
permission you used earlier with the Change Request permission created above. Ensure you
select it as the Default permission.
3. Currently the Can Add security setting for the Change Request ItemType is assigned to the
World Identity. Replace the World Identity with the Engineering Identity. Ensure the “Can Add”
checkbox is selected for the Identity:
160
Unit 9 - Assigning Security
To make it easier for testing, we want to allow Administrators to also be able to add new Change
Requests to the system. You will need to log out and back in to see the permission added in the next
step.
1. Edit the Change Request ItemType to allow Administrators to create Change Requests.
Display the Team Property on the Change Request Form and Test Team Permissions
1. Open the Change Request form for editing, add the team_id property (Unused Properties),
move it to a desired location, and click Done.
2. Navigate to Administration > Permissions, open the Change Request Permission for editing, and
on the Access relationship tab, grant access to the following Identities using the values as
shown:
3. Click Done.
4. Create a Change Request item, add John Young as the Owner, add the Computing Products
team, click Done, and note the Request Number.
5. Using a different browser, sign in as Tom Chan (tchan, innovator), a Team Member. Open a
search grid, right-click on the Change Request you just created, and select More > Delete.
6. In the resulting Confirm message dialog window, click Delete.
161
Aras Innovator Configuring Solutions Student Guide
162
Unit 10 Visualizing Data
Overview
In this unit, you learn how to present Item data to a user in an easily navigable format. Using a graphical
interface, you define and save complex reusable query definitions that retrieve property data from the
Aras Innovator database. Query results are then mapped to a configurable Tree Grid View (TGV) that
allows a user to visualize information in a hierarchical display. Knowledge of AML is not required to
create query definitions, though a basic understanding of the data constructs is helpful. You also learn
how to incorporate Effectivity Services into Product Engineering by creating and applying effectivity
scope and variables.
Objectives
• Review Existing Data Tools
• Create a new Query Definition
• Create and Use a Tree Grid View
• Enable Query Parameters
163
Aras Innovator Configuring Solutions Student Guide
164
Unit 10 Visualizing Data
Query
Query
Definition
Builder Query Response
<AML>
165
Aras Innovator Configuring Solutions Student Guide
166
Unit 10 Visualizing Data
167
Aras Innovator Configuring Solutions Student Guide
Selecting Properties
After saving the Query Definition, you enter the query-editing mode by clicking the Editor button in the
sidebar. Then you can select the property values to be retrieved for each ItemType by using the Editor.
You can add and remove properties at any time during the definition process. In this exercise, we define
which Part property values we want to be returned.
Select an item in the right pane and use the context menu to choose properties from the Query Element
or related Items and Relationships. Once selected, properties can be displayed and edited by hovering
over the property icon in the left pane.
Try it … Select Properties
1. Click the Editor sidebar button.
2. Select the first row (Part) in the right-side pane, right-click and choose
Edit Query Element > Selected Properties… from the context menu.
3. Use the Properties dialog to add the following properties to the query definition:
Part Number, Name, Cost, and id.
4. Click Save to accept the values which also closes the Query Element dialog box.
5. Click the Save button to save the Query Definition.
168
Unit 10 Visualizing Data
Executing Queries
You can test a query definition at any time by using the Execute Query Action. The AML results of the
executed definition display in a Query Result window.
You can also specify Conditions and Parameters to filter the results. To supply a test condition, enter the
name of a property in the Conditions editor. The editor auto-fill prompts for properties defined on the
item.
The Conditions editor supports basic SQL evaluation including =, >, <>, LIKE, IS NULL, etc. You can also
create more complex statements using Boolean operators AND, OR, and NOT. A default Max Count of
100 displays in the Start Execution window to limit the number of test results.
You can save the query results as a file by selecting the Result as File checkbox before executing the
query.
Try it … Execute a Query
1. Make sure you saved the current query definition and then, from the More button, choose
Execute Query.
2. In the Conditions field, enter the following value:
Cost >= 5
3. Click the Execute button to start the query and display in results.
4. Close the Query Result window.
169
Aras Innovator Configuring Solutions Student Guide
9 © 2022 Aras
170
Unit 10 Visualizing Data
171
Aras Innovator Configuring Solutions Student Guide
172
Unit 10 Visualizing Data
Max Visible Children On The maximum number of Children to display when the
Expand Tree Grid View is expanded.
Linked Toolbar/Context An optional Toolbar menu that has been created using
Menu the Configurable User Interface (CUI).
Max Grow Levels The maximum number of levels to display when the
Tree Grid View is expanded.
Auto Grow On Refresh When selected, automatically grow the Tree Grid View
upon clicking the Refresh button.
173
Aras Innovator Configuring Solutions Student Guide
174
Unit 10 Visualizing Data
Adding Columns/Labels
Data can be displayed to the user in a table format using the Tree Grid View. You can create additional
columns to show the values of properties from the Query Definition. You decide which properties will
display in each column and label each column header with appropriate text. You can adjust the width of
each column by using the column slider.
The following options are available from the column context menu.
Add New Column Adds (or inserts) a new column to the right of the
currently selected cell.
Change Column Label Allows editing of the column header text.
Remove Column Removes the currently selected column from the TGV.
175
Aras Innovator Configuring Solutions Student Guide
Mapping Elements
Exposing property values in a Tree Grid View requires mapping an element of the Query Definition to
the TGV control. All elements are unmapped by default. In the Tree Grid View Editor, select the row to
be mapped and then choose Map Element from the (right-click) context menu. To remove element
mapping, select Unmap Element from the context menu.
In the example above, the Query Definition retrieves Part items that are related to other Part items
using the Part BOM relationship.
To suppress elements that will not be mapped in the editor, choose Hide Unmapped Elements. For
larger Query Definitions this can make property mapping easier by eliminating rows that will not be
used.
Try it … Map Elements
Use this exercise to map all three rows of the Query.
1. Select all 3 rows, right-click, and select Map Element.
2. Save the Tree Grid View.
176
Unit 10 Visualizing Data
Combining Rows
The Tree Grid View contains common configurable features to enhance the display and usability of the
view. One common configurable feature allows Query Definition rows to be combined so that property
data from more than one item can be displayed on a single row. To combine properties, you can use the
Ctrl key to select the rows to be combined, right-click, and choose Combine from the context menu.
When you combine rows, any settings you previously configured for displaying the properties in the cells
will be removed. We will configure the cell display settings after combining the rows.
Try it … Combine Rows
1. Combine both the Part BOM element (row 2) and the related Part element (row 3) by selecting
both rows, right-click, and choose Combine.
2. Select OK in the pop-up to continue.
3. Save the Tree Grid View.
Try it … Change the Icon
1. Right-click on the Part BOM --- Part (second) row and choose Change icon.
2. In the resulting Image browser window, select Images.
3. Since this row represents the Child Parts, find and select the Part icon.
177
Aras Innovator Configuring Solutions Student Guide
178
Unit 10 Visualizing Data
7. For the Part BOM --- Part row, right-click in the Quantity column, and choose {Part
BOM.quantity} from Cell Display Settings and click Save.
8. Click the Save button to save the Tree Grid View.
179
Aras Innovator Configuring Solutions Student Guide
180
Unit 10 Visualizing Data
17 © 2022 Aras
181
Aras Innovator Configuring Solutions Student Guide
Results
To display a Tree Grid View, open an item based on the targeted ItemType and select the assigned
relationship tab that corresponds to the Tree Grid View.
Try it … Review the TGV Result
In this exercise, we look at part number C4703A.
1. Navigate to Design > Parts and open the Part Number C4703A for viewing.
2. In the Relationship accordion, select the Part Custom BOM tab and then expand the Part view
by clicking the Grow button.
3. When you are done, close the C4703A Part tab to clear the cached TGV data.
182
Unit 10 Visualizing Data
3. In the Query parameters window, click the New (+) button to create a new Parameter.
4. Name the Parameter FilterCost (no spaces allowed) and the use the Label of Filter Cost >=
5. Click in the Default Value cell and in the Text Dialog window, enter a value of 5.
6. Close the Query Parameters window (by clicking the X) to accept the values, then save the
Query Definition.
183
Aras Innovator Configuring Solutions Student Guide
184
Unit 10 Visualizing Data
4. Click Save.
Your result should look like this one:
185
Aras Innovator Configuring Solutions Student Guide
3. On the FilterCost row, click to select the Visible checkbox and choose Decimal for the Data Type.
4. Click the Save (green checkmark) button to accept the values and close the Map Parameters
window, then click Done for the Tree Grid View.
5. Open Part C4703A, and verify you only see parts with cost >= the default value of $5.00 on the
Part Custom BOM tab.
6. Test the Cost parameter by clicking the Modify Parameters button and setting different values.
(For example, change the value to $2.00 or $10.00.)
186
Unit 10 Visualizing Data
187
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how to create a Query Definition that populates a Tree Grid View control.
You should now be able to:
• Review Existing Data Tools
• Describe the Tree View Grid
• Describe the Query Builder
• Create a new Query Definition
• Create a Tree Grid View
• Assign Tree Grid View Usage
• Enhance the Tree Grid View Display
• Enable Query Parameters
Review Questions
1. The Query builder creates reusable Query Definitions to retrieve data from the Aras Innovator
database.
What does the Query Definition use to return child items?
3. Since users often want to see data returned from the database displayed in columns and rows,
what can you create to show results of a Query in a table format?
4. What must you do to elements of a Query Definition to expose property values in a Tree Grid
View?
5. An end user can influence the results displayed by setting a parameter value. As an
administrator, what do you need to configure to provide parameters?
6. How can you enhance a Tree Grid View to allow a property value to become a hyperlink to
another item?
188
Unit 10 Visualizing Data
Lab Exercise
Goal
Be able to create a new Query Definition that references relationship and item property data and map
the query results to a Tree Grid View control.
Scenario
In this exercise, you will create a Query Definition that retrieves all referencing Change Requests for a
Customer and add a Customer Change Requests tab that displays the results.
Steps
Ensure you are logged into Aras Innovator as the Admin user.
Create the Query Definition
1. Create a new Query Definition item named Customer Requests, choose Customer as the Context
ItemType, enter a description, and save the changes.
2. Click the Editor sidebar button to begin to build the definition.
3. Right-click on the Customer ItemType (first row) and select Add Related Item > Using
Referencing Item from the context menu.
4. Select Change Request Customer (related_id) from the Add Related Item Using Referencing
Item dialog window and click Add.
5. To avoid a SQL error due to name length, on the Change Request Customer relationship (row 2),
select Change Alias from the context menu, enter Requests from Customer as the new alias, and
click the green checkmark to save the change.
6. From the Change Request Customer relationship (row 2: Requests from Customer), select Add
Related Item > Using Item Property from the context menu and choose the source_id property,
then click Add.
7. Select the Change Request element (row 3), and then add the following properties to the query
definition: (Change) Request Number, Classification, Title, and id.
189
Aras Innovator Configuring Solutions Student Guide
10. To see requests for only a single Customer, first ensure you have created a CR for a specific
customer.
11. Execute the query using that customer as a condition.
This example uses Customer EDA.
Name = ‘EDA’
3. Add two new columns and configure the cell headings to show the Change Request Item
Number (Request Number), Title, and Classification as shown here:
190
Unit 10 Visualizing Data
2. Save the changes and then select Set Tree Grid View Usage from the More menu.
3. In the Set Tree Grid View Usage dialog window, select Relationship tab, and click Next.
4. Accept the Customer value for the Used On field, ensure the Relationship Name is set to New,
and click Next.
5. For the Label field, you can enter: Change Requests.
6. For the Access identity, you can enter: Component Engineering.
7. Click next, accept the Starting Conditions by clicking Next, and click Generate.
8. When the TGV is generated, click Done in the dialog window, then click Done on the TGV.
• Before you can test the results, you must open the Customer ItemType for editing, set the Default
Structure View setting to Tabs On, and click Done.
5. Click Save in the cell Display Settings dialog window, then click Done.
6. Open the same Customer and test the Hyperlink for the Change Requests Relationship TGV.
191
Aras Innovator Configuring Solutions Student Guide
192
Unit 11 Defining Extended Classification
Overview
In this unit, you learn how to create and assign Extended Properties to one or more ItemTypes using
Extended Classes. Extended Properties remove some of the restrictions imposed by standard Properties
and allow for greater control over security.
Objectives
• Define Extended Properties and Classes
• Explain the responsibilities of the Classification Administrator
• Create Extended Properties and Classes
• Create and Manage Extended Classification Trees
• Set an xClass/xProperty private Permission
193
Aras Innovator Configuring Solutions Student Guide
194
Unit 11 - Defining Extended Classification
195
Aras Innovator Configuring Solutions Student Guide
196
Unit 11 - Defining Extended Classification
197
Aras Innovator Configuring Solutions Student Guide
198
Unit 11 - Defining Extended Classification
199
Aras Innovator Configuring Solutions Student Guide
Name The name always begins with the characters xp- to distinguish it
from standard Properties.
Label The Label text displayed for this xProperty on a Form and in
grids.
Column Alignment Text alignment of the xProperty value.
200
Unit 11 - Defining Extended Classification
201
Aras Innovator Configuring Solutions Student Guide
Name/Label Name and Label text displayed in the UI for this classification.
Restrict Selection to When selected, end users can only choose one xClass from this
a Single Class tree for each Item. Disabling this flag allows a user to assign
multiple xClasses from this tree to a single Item so that
properties from all the selected xClasses are available on the
Item.
Restrict Selection to When selected, end users can only classify an item using a leaf
Only Leaf Classes subclass in the xClassification Tree.
202
Unit 11 - Defining Extended Classification
203
Aras Innovator Configuring Solutions Student Guide
204
Unit 11 - Defining Extended Classification
Assigning xProperties
Once the necessary root and leaf xClasses are established, you can assign xProperties to each xClass.
Also, you can override certain xProperty values when they are assigned to an xClass. End users see the
override xProperty values when they classify an item.
xProperties display in the order they are added to the xClass. To change the display order, click in the
Reorder column and drag the row up or down.
Try it … Assign xProperties
1. Select the Fastener root level xClass, click the New Relationship button, and assign
the xp-material xProperty.
2. In the Default Value column, click the Override Switch, and set the default value to Steel.
3. Again, click the New Relationship button (for the Fastener xClass), and assign the xp-
iso_certified xProperty.
4. Click the Override Switch in the Default Value column and set the default value to 0 (zero).
5. Save the x-Classification Tree.
6. Click the Screw xClass and notice that the inherited root level xProperties display with a gray
background.
7. Click the New relationship button to assign the xp-length xProperty to the Screw xClass.
8. Click the Override Switch in the Label column to change the Label Length to Screw length cm.
9. Click the Washer xClass and notice that the inherited root level xProperties display with a gray
background. Click the New relationship button to assign the xp-size xProperty.
10. Click the Override Switch in the Label column and change the Label of Size cm to Bolt size cm.
11. Click Save.
205
Aras Innovator Configuring Solutions Student Guide
206
Unit 11 - Defining Extended Classification
207
Aras Innovator Configuring Solutions Student Guide
Get Members of the assigned Identity can see the value of an xProperty.
The word Restricted appears in the place of the value if a user does not
have Get access.
Update Members of the assigned Identity can assign or change the value of an
xProperty.
Can Change Members of the assigned Identity can set a private permission on an
Access xProperty.
Try it … Change Access for an xProperty Value Permission
1. Navigate to Extended Classification > xProperty Value Permissions.
2. Open the pre-defined permission named Part All Users for editing.
3. Remove Update access for the World Identity.
4. Now, add Classification Administrators with the Get, Update, and Can Change Access rights.
5. Click Done.
208
Unit 11 - Defining Extended Classification
209
Aras Innovator Configuring Solutions Student Guide
210
Unit 11 - Defining Extended Classification
211
Aras Innovator Configuring Solutions Student Guide
212
Unit 11 - Defining Extended Classification
4. We want Engineering to be able to both Get and Update the Material xProperty value for this
Manufacturer Part. Add the Identities, and set the following values for this new xProperty
Private Permission:
5. Click Done.
6. Return to the (FPW-10) Manufacturer Part and click Done to save the new private permission
relationship.
213
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how Extended Properties and Extended Classes are used to classify an item.
You should now be able to:
• Define Extended Properties and Classes
• Explain the responsibilities of the Classification Administrator
• Create Extended Properties and Classes
• Create and Manage Extended Classification Trees
• Set an xClass/xProperty private Permission.
Review Questions
1. What are the benefits of using Extended Properties and Classes?
4. What are two permissions that must be configured for each ItemType associated with a
Classification Tree?
214
Unit 11 - Defining Extended Classification
Lab Exercise
Goal
Be able to create xClasses and xProperties to support Extended classification.
Scenario
In this exercise, you create several new xProperties and assign them to a new xClassification Tree. You
then assign the xClassification Tree to the Part and the Manufacturer Part ItemTypes.
Steps
1. As an Administrator, create a new List item named Resistor Types, provide the following entries,
and click Done.
Label Value
Fixed Fixed
Variable Variable
Thin Film Thin Film
2. Navigate to Extended Classification > xProperties and create four new Extended Properties.
Property Name Label Data Type Data Source Precision Scale
xp-voltage Voltage Decimal 6 2
xp-tolerance Tolerance Decimal 6 3
xp-resistor_type Resistor Type List Resistor Types
xp-capacitance Capacitance Decimal 4 2
Note: Please create the x-property named xp-iso_certified if you did not build it with the instructor
earlier.
Property Name Label Data Type Data Source
xp-iso_certified ISO Certified Boolean
3. Create a new xClassification Tree using the following settings:
Number E-100
Name Electrical
Label Electrical
Description Classification Tree used for Parts and Manufacturer
Parts
Restrict Selection to Only Leaf Checked
Classes
Restrict Selection to a Single Class Checked
4. Save the configuration.
5. Click the Editor sidebar button and create two new Sub-classes in the Electrical xClassification
Tree named Resistor and Capacitor.
215
Aras Innovator Configuring Solutions Student Guide
6. Using the xClassification Tree Editor, assign the xp-voltage, xp-tolerance, and xp-iso_certified
xProperties to the root Electrical xClass.
9. Click the Form sidebar button to display the xClassification Form and add the Part and
Manufacturer Part ItemTypes to the ItemTypes relationship grid.
10. Right click on each ItemType to pick both the Item Classification Permission and xProperty Value
Permission. Select the existing Part All Users xProperty Value permission and Part World Item
Classification permission and apply to each ItemType.
11. Click Done.
12. Create or edit some Parts/Manufacturer Parts and classify them with the new xClass /Sub-class.
216
Unit 12 Defining Lifecycle Maps and
Versioning
Overview
In this unit, you learn how to define Lifecycle maps for an ItemType and how to control how a user
promotes an Item through a Lifecycle. You also learn how to control Item versions and how to configure
different behaviors when related Items are versioned.
Objectives
• Identify the Lifecycle States
• Define Lifecycle Transitions
• Create a Lifecycle Map for an ItemType
• Define Lifecycle State Permissions
• Promote an Item through Lifecycle States
• Configure and View Item Versions
• Define Versioning Behavior
217
Aras Innovator Configuring Solutions Student Guide
218
Unit 12 - Defining Lifecycle Maps and Versioning
219
Aras Innovator Configuring Solutions Student Guide
Lifecycle States
Items must go through all the appropriate Lifecycle states as designed in the Lifecycle map. The
following fields define a Lifecycle State:
Name The Name of the State in the Lifecycle map. If you supply a label, it displays to
the user instead of the name and can be localized for foreign languages.
Image A Custom image for the state.
Released Signifies the Item is released and should be revised to the next major revision
if versioning is supported for the Item. The Lifecycle map is also reset to the
first Lifecycle state.
Not Lockable The Item is not editable while in this State.
State State Permissions overrides any default ItemType Permissions while in this
Permissions State. The permission persists until another state sets another permission.
State permissions must also appear as allowed permissions on the ItemType
definition to work correctly.
Workflow The State starts a Workflow.
History Allows the History Template defined on the ItemType to be overridden by this
Template defined template. For the override to work correctly the original ItemType
must have a History Template defined.
Configure E-Mail Allows email messages to be sent when this state becomes current on an Item.
220
Unit 12 - Defining Lifecycle Maps and Versioning
221
Aras Innovator Configuring Solutions Student Guide
222
Unit 12 - Defining Lifecycle Maps and Versioning
Lifecycle Transitions
The following fields define a Lifecycle Transition:
Role The Identity that can interact with this Transition (Promote).
Server Methods Custom server Methods you create to provide custom behavior
before and after this transition.
Get Comment Presents a dialog box to the end-user when a promotion occurs to
capture user remarks.
Configure E-Mail Configures message(s) to send when this transition occurs.
223
Aras Innovator Configuring Solutions Student Guide
2. Add a breakpoint in the Transitions between the Submitted and the Incomplete States to make
the diagram mode readable.
a. To add a break, right-click on a transition arrow and select Add Break.
b. Drag the transition line as required.
A Lifecycle map can use the classification subclasses if the ItemType is configured with a Class Structure.
The Class Path value represents the classification subclass.
224
Unit 12 - Defining Lifecycle Maps and Versioning
225
Aras Innovator Configuring Solutions Student Guide
226
Unit 12 - Defining Lifecycle Maps and Versioning
Item Versioning
major_rev is the Version Property used for major changes. It is controlled by business rules that cause
the Version to increment when changes are made to an Item in its Released state.
minor_rev is reserved for custom programming.
Generation (version) is an Integer Property that automatically increments from Aras Innovator core
processes and rules. A new generation is created whenever an Item Is Claimed and Saved. When an Item
is Unclaimed, no additional edits can be made to the current generation.
Lifecycle map is a customer-defined sequence of States and Transitions used as a primary driver for
business rules. All Items are defined to be in one State within their specified Lifecycle map. Flags defined
for each State determine Item behaviors.
Lifecycle Start State is the State within the Lifecycle map that has specifically been designated as the
starting point for the Lifecycle map. When a new Item instance is created, it is automatically set to the
Start State. When Versioning is enabled, the Item is set back to its Lifecycle Start State when its Revision
is incremented.
Lifecycle Release State is a State within the Lifecycle map that has specifically been flagged as a
Released State. There may be more than one Released State in a Lifecycle map, but when an Item that is
in the Released State is versioned, its major_rev is incremented, it is set to its Lifecycle Start State, and
its Revision is incremented.
Promote is an action performed by a user to change the state of an Item. It assigns another State from
the same Lifecycle map that is connected by the Transition between the two states.
Edit and Done is a set of actions used to initiate and save changes to Items resulting in Versioning when
Automatic Versioning is activated on an ItemType. Edit and done actions explicitly affect the Generation
and the major_rev of an Item.
227
Aras Innovator Configuring Solutions Student Guide
228
Unit 12 - Defining Lifecycle Maps and Versioning
Caution
Create a Revision Item rather than modifying the existing Default Revision. The Default Revision is used
internally as you develop a solution and could cause problems with Aras Innovator if modified.
229
Aras Innovator Configuring Solutions Student Guide
Viewing Versions
Each time a versioned Item is unclaimed, then edited and saved again, a new generation is created.
Every generation creates a new row in the ItemType table with a unique Id and the generation property
is incremented by one. An Item also maintains a property named config_id. The config_id property
contains a 32-character hexadecimal value that remains constant throughout the entire span of an
Item's existence. Regardless of how many generations of an Item are created, the config_id is common
across all generations. This is how the system maintains traceability of an Item.
Try it … View a Version
1. Navigate to Design > Parts and create a new Part.
2. Type in some property values and click the Done button.
3. Click the Edit button and make a change to one of the property values.
4. Click the Done button once again.
5. Click the Navigate button and select Versions from the menu.
6. In the Item versions dialog window, choose the previous version (generation 1) to view.
7. Click Splitscreen to display both versions side by side.
230
Unit 12 - Defining Lifecycle Maps and Versioning
231
Aras Innovator Configuring Solutions Student Guide
232
Unit 12 - Defining Lifecycle Maps and Versioning
233
Aras Innovator Configuring Solutions Student Guide
234
Unit 12 - Defining Lifecycle Maps and Versioning
235
Aras Innovator Configuring Solutions Student Guide
236
Unit 12 - Defining Lifecycle Maps and Versioning
237
Aras Innovator Configuring Solutions Student Guide
238
Unit 12 - Defining Lifecycle Maps and Versioning
Summary
In this unit, you learned how to define a Lifecycle map for an Item as well as version Items in the
database. You also learned about related item behaviors when connected Items are revised.
You should now be able to:
• Identify the Lifecycle States
• Define Lifecycle Transitions
• Create a Lifecycle Map for an ItemType
• Define Lifecycle State Permissions
• Promote an Item through Lifecycle States
• Configure and View Item Versions
• Define Versioning Behavior
Review Questions
1. What triggers a new Major Revision for an Item?
3. Where is Item behavior (e.g., float, fixed) configured as it relates to related Items?
239
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Be able to define a Lifecycle map for an ItemType and promote an Item through the Lifecycle map. Be
able to define relationship behaviors based on the requirements of the situation. Set an appropriate
permission for when the request reaches the In-Validation state.
Scenario
In this exercise, you create a Lifecycle map for the Change Request ItemType. You review the
relationship behavior between the Change Request Item and related Parts to support a fixed or float
versioning scheme.
The following Lifecycle map has been determined for the Change Request:
240
Unit 12 - Defining Lifecycle Maps and Versioning
2. Click Done, return to the Change Request Lifecycle map, and select the In Validation state in the
map canvas.
3. In the Items Settings area, choose the new In Validation Request permission in the State
Permissions field.
4. Set the In-Review state to Not Lockable.
5. Click Done for the Lifecycle map.
The permission assigned to the Change Request as a default is used when an item is at the Preliminary
State. The new permission is used when an item is promoted to In Validation. Since no other
Permissions are set for later states, the In Validation permission persists since we do not want edits after
Validation.
Working with Versions
1. Open the Part ItemType for editing.
2. Locate the generation property in the Properties tab and uncheck (clear) the Hidden and
Hidden2 columns and click Done. This allows you to see the generation property in the search
grid and relationship grids.
3. Create a new Part Item and set the Assigned Creator and Designated User to Administrators.
4. Click Done.
5. Edit the Part and make a small change to the Name property.
6. Click Done.
7. Promote the Part to the Released state.
8. Review the versions of the Part by selecting Navigate > Versions.
241
Aras Innovator Configuring Solutions Student Guide
242
Unit 13 Creating a Workflow Map
Overview
In this unit, you review a Workflow Map and learn how to create a new Workflow Map that incorporates
Activities and Paths. You assign the Workflow to an ItemType and test the new process.
Objectives
• View and create a Workflow Map
• Assign a Workflow Map to an ItemType
• Define an Activity Template
• Create and Configure Workflow Paths
• Assign an Activity to an Identity
• Create a Task
• Define Activity Variables
243
Aras Innovator Configuring Solutions Student Guide
244
Unit 13 - Creating a Workflow Map
245
Aras Innovator Configuring Solutions Student Guide
246
Unit 13 - Creating a Workflow Map
247
Aras Innovator Configuring Solutions Student Guide
248
Unit 13 - Creating a Workflow Map
Managed By An identity that can make changes to the Assignment list of a running
activity. For example, you could assign Peter Smith as the Managed By
ID of the In-Work activity on the Design Request workflow. This means
he could view the running workflow of a Design Request and edit the
Assignment(s) on the In-Work activity.
Role This field is used in conjunction with the Managed By Identity described
above. If left blank, the Managed By Identity of an Activity can edit the
Assignment list and choose anyone in the system for reassignment. If a
role is provided, the user is restricted to reassigning the activity to only
members of that role.
Escalate To The Identity that is notified when an Activity is escalated, i.e., when it
becomes overdue, when it is refused, or when no decision was
achieved through voting. When there is no identity specified,
assignments are escalated to the Process Owner. If no Process Owner
Identity is specified, the assignments escalate to the Creator of the
Workflow Process.
Subflow The workflow map to be instantiated as a subflow. An Activity will not
be considered complete until its subflow is complete. The exit path
from an activity that represents a subflow is typically marked as the
Default Path.
249
Aras Innovator Configuring Solutions Student Guide
End Activity End Activity closes the workflow process. There can be more than
one End Activity in a workflow.
Automatic This activity has no user interaction and completes automatically.
Activity
Can Refuse Allows a user to refuse this activity.
250
Unit 13 - Creating a Workflow Map
251
Aras Innovator Configuring Solutions Student Guide
Automatic Activity
An Automatic Activity requires no user interaction and completes automatically if the Automatic Activity
checkbox is selected (true).
• Automatic activities must have a Default Exit Path.
• Automatic activities cannot have any Required Tasks or use Password/E-Signature
Authentication.
• The Start Activity is an example of an Automatic Activity.
Try it … Define an Automatic Activity
1. For the Design Request Workflow, set both the Approve Request, Reject Request and Cancel
Request activities to Automatic Activity (checkbox selected).
2. For the Approve Request, Cancel Request, and Reject Request activities, uncheck the Can
Refuse and Can Delegate checkboxes.
The following activities should now all be set to Automatic: Start, Approve Request, Reject
Request, and Cancel Request.
3. Save the Workflow.
252
Unit 13 - Creating a Workflow Map
Creating an Assignment
Assignments are used to define who will perform an operation in a workflow. Assignments can be Voted
on, Delegated, Refused, and Automatically Escalated. Assignments display in users InBaskets. The
following fields define an assignment:
Name The Identity to receive an assignment. Note that aside from any
Identity, Team Roles are also supported as Workflow Assignments
(Team, Team Manager, Team Member, Team Guest) but the Voting
Weight distribution may differ.
Required At least one member of a Group identity must complete this
assignment (regardless of other voting rights).
For All This option applies to Team Roles or group identities assigned to this
Members activity; if false, only one member of the group identity must complete
and vote on the activity, which then automatically removes this activity
from the other group members' InBaskets. If true, all members
complete and vote on the activity and it is assigned equal voting
weight, with the cumulative weight equal to the assigned voting
weight.
Voting The percentage of the vote for this assignment. For a path to be
Weight selected, it must reach at least a 100% vote.
Escalate To If the assignment is refused or rejected it goes to this identity. If no
identity is specified, then the Activity Template Escalate To identity
receives this assignment.
253
Aras Innovator Configuring Solutions Student Guide
254
Unit 13 - Creating a Workflow Map
255
Aras Innovator Configuring Solutions Student Guide
256
Unit 13 - Creating a Workflow Map
257
Aras Innovator Configuring Solutions Student Guide
Creating a Task
Use Tasks to provide some instruction on what work needs to be accomplished to complete an
assignment.
The following fields define a task:
Sequence
The order of tasks in the assignment voting dialog.
Required
A task must be completed to complete the assignment.
Description
Task instructions.
Try it … Create Tasks within a Activity
1. Locate the Tasks relationship tab for an Activity node and create a new Task relationship.
2. For the Design Request Workflow, add the Task values shown below to the Review Request
Activity.
Sequence Required Description
1 Yes Verify the Product Division and Product Type selected
2 Yes Fully describe the product request
3 No Set Change Type
4 No Notify the Lead Engineer
3. Save the Workflow.
258
Unit 13 - Creating a Workflow Map
Refusing an Assignment
If an Activity allows an Identity to refuse an assignment, an escalation of the assignment begins.
If an Assignment is actively refused, it escalates directly to the Assignment Escalate To Identity. If the
Escalate To identity is blank on the Assignment, then the system looks for an Escalate To Identity on the
Activity Template. The assignment continues to be escalated, if necessary, to the Workflow Process
Owner. If all other Escalate To Identities are blank, the system notifies the Creator of the Workflow Map.
259
Aras Innovator Configuring Solutions Student Guide
Delegating an Assignment
A user can delegate an assignment to another valid Identity in the system.
Consolidate Delegated
The Consolidate Delegated flag is useful when one activity is delegated to the same Identity several
times. Normally, the targeted user would receive multiple assignments to perform the same operation.
For example, an activity has three Assignees each with a Voting Weight of 40. When the Activity
becomes active, each Assignee gets a task in their InBasket. Assignee One and Assignee Two both
delegate to Assignee Three.
For this example, if the Consolidate Delegated flag is NOT checked, Assignee Three receives three
identical assignments - each with a Voting Weight of 40. One is their own assignment and the other two
were delegated from Assignees One and Two. Assignee Three must now open each assignment
individually and vote a total of three times for the system to calculate a Path.
If the Consolidate Delegated flag is used, Assignee Three sees only one assignment in their InBasket with
a Voting Weight of 120 and only needs to vote once.
Another benefit of the Consolidate Delegated feature is in the timing of the vote. If Assignee Three in
the above example already voted – when Assignee One and Assignee Two delegate their votes later -
the system automatically consolidates their votes (and their weight). Assignee Three does not have to
process any further assignments.
260
Unit 13 - Creating a Workflow Map
Source The Data Source of the variable (if reference data type).
261
Aras Innovator Configuring Solutions Student Guide
Activity Variables
Developers can use variable values collected during voting to programmatically steer workflows down
certain paths or to call subflows.
262
Unit 13 - Creating a Workflow Map
Default Path This path will be followed if no cumulative voting weight reaches
100 for a single path.
Override Path If this path is chosen when voting on an activity, no additional votes
are collected and this path is followed.
263
Aras Innovator Configuring Solutions Student Guide
264
Unit 13 - Creating a Workflow Map
265
Aras Innovator Configuring Solutions Student Guide
Override Path
Use Override Paths to potentially make a workflow more efficient. If a user chooses an Override path, no
additional votes are collected for the activity, and processing continues using the Override path.
Override paths take precedence over the Wait For All Votes option.
In the example above, the Incomplete Info path is configured as an Override Path. If any assignees
choose this path, any votes for Submit to Tech Review are ignored and the Provide Missing Info activity
is invoked.
Try it … Set an Override Path with Authentication
1. For the Design Request Workflow map, on the Incomplete Info path, select the Override Path
checkbox.
2. For the Authentication field, select Password.
3. Click Done.
266
Unit 13 - Creating a Workflow Map
267
Aras Innovator Configuring Solutions Student Guide
268
Unit 13 - Creating a Workflow Map
269
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how to create and configure a new Map.
You should now be able to:
• View and create a Workflow Map
• Assign a Workflow Map to an ItemType
• Define an Activity Template
• Create and Configure Activity Paths
• Assign an Activity to an Identity
• Create a Task
• Define Activity Variables
Review Questions
1. What is the difference between a Workflow Map and a Workflow Process?
2. How do I configure an assignment so that all users belonging to a Group Identity must complete
and vote on the activity?
5. What two forms of authentication are available to restrict who can complete an assignment?
270
Unit 13 - Creating a Workflow Map
Lab Exercise
Goal
Be able to define a new Workflow Map and configure activities with assignments and tasks. Be able to
create transition paths between activities.
Scenario
In this exercise, you create the basic Workflow Map for the Change Request Workflow.
Requirements
The following requirements have been established for the first phase of the Change Request Workflow.
Draw the workflow below before attempting to create it as a Map.
1. Once a user creates a Change Request and assigns an Owner, the owner should receive an
InBasket assignment to recheck the request before submitting it for verification/validation and
review. If the Owner cancels the request the process should end. If the Owner attempts to
cancel the order, the Owner must provide their e-Signature password.
2. If the Owner submits the request to verification/validation, it should be sent to the Engineering
group so that any member can verify the request. At the same time, a member of the Change
Specialist I Identity should receive an assignment to validate the request.
3. Once both the verification and validation activities are completed, the request should then be
submitted to the CRB group for the final review.
4. A member of the CRB must either Approve or Reject the request which ends the process.
Draw the Workflow Diagram:
271
Aras Innovator Configuring Solutions Student Guide
Steps
1. Create a new Workflow Map named Change Request using the diagram you drew above as a
guideline. You will need to create new Activities and connect them with Transition Paths. Name
the Activities and Paths using the suggested names in the following table.
2. Set the Process Owner as Administrators.
3. Define the Assignments as follows:
Activity Name Assignment Identity Tasks (all required)
Confirm Request Owner None
Cancel Request
Branch
Verify Request Engineering Review reason and ensure all fields completed
Validate Request Change Specialist I Validate cost estimate.
Review Request CRB Enter any recommendations in the provided field.
Approve Request
Reject Request
4. Apply the settings so that the Branch activity should split when the reaches it and then process
both the Verify Request and Validate Request activities in parallel.
5. The path from Confirm Request to Cancel Request should require an e-Signature.
6. Apply the settings so the Review Request Activity assignment is not reached until the Verify
Request and Validate Request activities have been completed.
7. None of the Activities should allow Refusal except for the Review Request. If the Review Request
is refused, it should be escalated to the Administrators Identity.
8. Click Done for the Workflow Map and navigate to Administration > ItemTypes, add the
Workflow Map to the Change Request ItemType as the Default, and click Done.
9. Create a new Change Request, assigning the Engineering group identity as the Owner and click
Done.
10. Log on as an Engineering group member and view the InBasket.
11. Vote to Submit to Verify the Item.
12. Log on as the member for the next assignment and perform the task to complete the workflow
process.
13. Walkthrough the complete workflow process noting the Identities that are assigned to each
activity.
272
Unit 14 Enhancing a Workflow
Overview
In this unit you learn how integrate an Item Lifecycle with a Workflow. You also learn about Subflows
and Dynamic Assignments.
Objectives
• Promote an Item from a Workflow
• Launch Workflows from a Lifecycle State
• Create and call a Subflow
• Change Assignments on Active Windows
273
Aras Innovator Configuring Solutions Student Guide
274
Unit 14 - Enhancing a Workflow
Lifecycle Map The Controlled Item Lifecycle map to be used in the promotion.
Role The identity defined on the transition in the Lifecycle map. However,
a promotion that is triggered by a workflow activity bypasses the role
defined on the transition. The promotion occurs based upon the
person voting on the activity and the specified event.
275
Aras Innovator Configuring Solutions Student Guide
Promotion Guidelines
The Controlled Item’s current Lifecycle State must match one of the defined Lifecycle Promotion’s From
State values when the promotion is initiated. If no matching From State or Lifecycle transition is found,
the system rolls back to the prior Workflow Activity and displays an error on the Voting Dialog. For
example, if the Controlled Item is currently in the Draft state and an Activity with a Lifecycle
Promotion is initiated, there must be at least one Promotion defined for the Activity which has a
From State = Draft.
A Lifecycle Promotion from a Workflow cannot be used for promoting ItemTypes that are not defined as
the Controlled Item for the Workflow. A good practice is to use the Aras PLM identity as the Role on the
Transition in a Lifecycle map that will be initiated from Workflow Activities.
Try it … Change the Lifecycle Map
Use the Aras PLM Identity to disallow manual promotions.
1. Open the Design Request Lifecycle map for editing.
2. Select each transition and change the role to Aras PLM.
3. Click Done for the Lifecycle map.
276
Unit 14 - Enhancing a Workflow
277
Aras Innovator Configuring Solutions Student Guide
278
Unit 14 - Enhancing a Workflow
279
Aras Innovator Configuring Solutions Student Guide
Using Subflows
Any workflow may be added as a subflow to any other Workflow to enable a process reuse or to clarify
the graphical display.
The parent Workflow continues when the subflow is complete.
Subflows allow for a Workflow hierarchy by creating a form of branching. The current Workflow activity
is suspended until the Subflow completes and returns control. A Subflow can be used with branching,
because only the Activity containing the Subflow suspends, not the whole Workflow Process.
In this example, the Calculate Price Activity calls a separate Workflow, as a Subflow, to step through the
process of collecting Support Documents and determining a Price. When all the steps in the Subflow are
complete, the main workflow activity continues.
Notes
Activities with Subflows should always be set to Automatic.
In the main workflow map, the path following the automatic activity should be a Default path.
The End Activity on the Subflow should always be set to Automatic to return to the calling Activity.
Subflows must also be set as allowed workflows for the ItemType involved.
The Subflow will not be set as the Default workflow on the ItemType.
280
Unit 14 - Enhancing a Workflow
281
Aras Innovator Configuring Solutions Student Guide
8. Ensure that both the Begin and Complete Verification activities remain configured as Automatic.
9. Feel free to change the icons, if desired.
10. Click Done for the Calculate Price Workflow Map and close the tab.
282
Unit 14 - Enhancing a Workflow
Configuring Subflows
A called workflow is also referred to as the subflow. To configure a subflow into a workflow, specify the
workflow to call from the Activity Template and ensure the Automatic Activity setting for the calling
activity is set to true. The path returning from the subflow to the main workflow must be set as the
Default Path. Then, edit the ItemType definition to include the subflow as one of the allowed workflows
for the item.
Try it … Configure a Workflow to Call a Subflow
1. Navigate to Administration > Workflow Maps and open the Design Request Workflow Map for
editing.
2. Select the path between the Verify Request and Review Request activities, right-click, and
choose Insert Activity from the context menu.
3. Name the new Activity Check for Pricing.
4. Below the Check for Pricing activity, add another new activity named Calculate Price.
5. Edit or create Workflow Paths with the suggested settings as shown below:
From Activity To Activity Path Name Options
Check for Pricing Review Request Pricing Exists
Check for Pricing Calculate Price Calculate Price
Calculate Price Review Request Price Calculated Default Path = True
6. On the Check for Pricing activity, create an assignment to the PE Student with Voting Weight of
100.
7. On the Calculate Price activity, call a subflow by selecting the Calculate Price workflow.
283
Aras Innovator Configuring Solutions Student Guide
8. Set the Calculate Price activity to be an Automatic Activity, uncheck Can Refuse and Can
Delegate, and ensure the Price Calculated path is set as a Default Path.
9. Click Done for the Design Request Workflow Map.
284
Unit 14 - Enhancing a Workflow
285
Aras Innovator Configuring Solutions Student Guide
Changing Assignments
If the Managed By Property is set, Assignments can be altered in the Assignments section of the
workflow process dialog.
Try it … Change Assignments
1. As PE Student, navigate to Product Management > Design Request, and create a new Design
Request item with PE Student as the Request Owner.
2. Save and notice the DR- number.
3. Click Done for the DR.
4. In your InBasket, process each workflow assignment (Vote) until the Design Request Workflow
process is in the Review Request activity.
The simplest path is Pricing Exists.
5. Login as a member of the Engineering Identity.
(John Young, Susan Harris, or Peter Smith).
6. From the InBasket, process the Design Request to Perform Tech Review.
(Vote Submit to Tech Review.)
7. As an Administrator, search for and open the Design Request item you processed through to the
Perform Tech Review workflow activity.
8. On the Navigate menu, select Workflow to display the workflow process diagram.
9. Click the Edit button to make changes to the active assignment.
10. In the Assignments section of the window, right-click on the current assignment (CRB) and select
Pick/Replace Identity from the context menu.
286
Unit 14 - Enhancing a Workflow
287
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how to enhance a Workflow.
You should now be able to:
• Promote an Item from a Workflow
• Launch a Workflow from a Lifecycle State
• Create and call a Subflow
• Change Assignments on Active Workflows
Review Questions
1. If a Workflow promotes an Item to a new state, what Identity is used to process the promotion?
3. How do you limit what Identities can be assigned using the Managed By property?
288
Unit 14 - Enhancing a Workflow
Lab Exercise
Goal
Be able to integrate an Item Lifecycle map with a Workflow.
Scenario
In this exercise, you add promotions to the current Change Request Workflow to allow the Workflow to
control the state of an Item.
Steps
1. Open the Change Request Lifecycle map for editing.
2. Select each transition and change the role to Aras PLM.
289
Aras Innovator Configuring Solutions Student Guide
Add a Subflow
1. Create a new Workflow Map named Quality Control
(Process Owner: Administrators) using the following diagram:
2. Assign the Quality Checks Activity to Administrators and create a required Task for the assignee
to perform standard quality control checks.
3. Click Done for the Quality Control workflow.
4. Open the Change Request Workflow and assign the Quality Control workflow as the subflow of
the Verify Request activity.
You will need to make this Activity automatic, as the subflow will control the Assignment.
5. Set the Submit for Review path as the Default Path and then click Done for the Change Request
workflow.
6. Open the Change Request ItemType and add the Quality Control workflow to the ItemType
(non-default).
7. Login as a member of the Engineering identity (John Young, Susan Harris, Peter Smith, or Ann
Reddy) and create a new Change Request assigning a member of the Engineering identity as the
Owner.
8. Process the Change Request item through to approved and keep in mind the following Activity
identities:
a. The Engineering identity you used as the Request Creator, will need to Confirm the Request
and Submit it.
b. Change Specialist I (PE Student) will need to Validate the request and a member of
Engineering will need to Verify the request.
c. Verify Request goes through the Quality Control subflow (Administrators).
d. Finally, Review Request to Approve or Reject is voted on by the CRB group identity (PE
Student or Ann Reddy).
290
Unit 15 Working with Files
Overview
In this unit, you learn how a vault is configured to store files uploaded by users. You learn how to assign
a User to a vault as well as learn about the association of File Items to a container Item. You also learn
how to configure an ItemType or Relationship to support file upload/download.
Objectives
• Understand where files are stored
• Define the purpose of a File Item
• Upload and Download files
• Understand the Options for Configuring File Items
• Configure an ItemType to Support File Items
291
Aras Innovator Configuring Solutions Student Guide
Reviewing Vaults
Files are stored in a vault (a secure file store - not the SQL database) and an IIS Vault Server application
is dedicated to each vault that is configured. The Vault Server communicates with the Aras Innovator
Server to keep track of files and their locations (file meta-data) in the database.
When Aras Innovator is installed, a vault named Default is created to store user files. You can configure
additional vaults if necessary. Steps to install more than one vault are described in the Aras Innovator
Installation Guide.
Reviewing the Aras Innovator Vault
When Aras Innovator is installed, a Default vault is automatically created and configured for the system.
A vault contains a URL address to the Vault Server.aspx file used for processing files into the vault.
The Vault Server
Configure the Vault Server application using the VaultServerConfig.xml file, which contains the
appropriate URL for the Aras Innovator server as well as the matching vault name. The following keys
are defined in the file:
• AppServerURL – The URL of the installed Aras Innovator application.
• LocalPath – The top-level directory used as the file store.
• name – The name of the vault.
• login_name – The system user that has access to the Vault Server application. (vadmin is the
default user).
• password – The password of the login user defined above.
• version – Aras Innovator version number.
292
Unit 15 - Working with Files
293
Aras Innovator Configuring Solutions Student Guide
Vault URL Pattern The IIS path to the VaultServer.aspx. The URL can also contain the
following symbols which are substituted when the vault Item is
saved:
HTTP_PREFIX_SERVER = http:// or https://
HTTP_HOST_SERVER= server name.
HTTP_PORT_SERVER = server port number (if exists).
HTTP_PATH_SERVER = Innovator web alias specified at
installation.
Vault URL This read only field displays any substitution that occurs on the
URL Pattern when the vault Item is saved.
Note
If you require more than one vault (or a custom configuration), see the Aras Innovator Installation Guide
for more information.
294
Unit 15 - Working with Files
295
Aras Innovator Configuring Solutions Student Guide
296
Unit 15 - Working with Files
297
Aras Innovator Configuring Solutions Student Guide
298
Unit 15 - Working with Files
299
Aras Innovator Configuring Solutions Student Guide
Managing Files
1
2 3 4
11 © 2022 Aras
Managing Files
Once a file is uploaded to a vault, a user with the proper privileges can then manage the file using the
Manage File property dialog box. A Manage File button displays to the left of the name of the uploaded
file and can be clicked to display the Manage File property dialog box.
The Manage file property dialog box contains the following options:
View File When you click the filename’s hyperlink, the file is displayed (if
possible) in the browser. If the file cannot be displayed, the
browser prompts for a file download.
Select and Upload Allows you to choose a physical file from your local computer and
upload to a vault, replacing the previously linked file.
Delete File Removes this file association from the current container. Note
that the physical file is not deleted from the vault. The File Item is
reassigned to a system container named Orphaned Files
Container and is only available to the Aras Administrator.
Download file Downloads (and/or overwrites) a file using the browser download
options.
300
Unit 15 - Working with Files
301
Aras Innovator Configuring Solutions Student Guide
302
Unit 15 - Working with Files
14 © 2022 Aras
303
Aras Innovator Configuring Solutions Student Guide
304
Unit 15 - Working with Files
305
Aras Innovator Configuring Solutions Student Guide
306
Unit 15 - Working with Files
Summary
In this unit, you learned how to work with files. You should now be able to:
• Understand where files are stored
• Associate a User to a vault
• Define the purpose of a File Item
• Upload or Download files
• Understand the Options for Configuring File Items
• Configure an ItemType to Support File Items
Review Questions
1. Files are stored in the SQL Server database. (True/False?)
4. Which Configuration Option does not require the use of a Relationship Item?
307
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Be able to configure an ItemType to support file upload/download from the Default vault.
Scenario
In this exercise, you add the capability for users to upload a file to a vault directly from a Change
Request. Once the file is added, a user can manage the file using the Manage File dialog box.
Steps
1. Edit the Change Request ItemType and add a new RelationshipType (Add ItemTypes button)
named Change Request File that uses File as the related ItemType. (You can click Done and close
the tab after making these changes.)
308
Unit 16 Replicating Files
Overview
In this unit, you learn how to configure file replication between multiple vaults. File replication is useful
in enterprise installations where multiple vaults can be used to store different files based on type or size
– or to allow faster retrieval of files when users are in different geographic areas. You can configure file
replication in several different ways depending on the requirements of the solution. Note that the
"Push" replication is only available to subscribers and requires a subscriber license key to operate. On
demand replication with multiple vaults is available without subscription.
Objectives
• Create Replication Rules
• View Replication Transactions and Logs
• Describe Additional vaults
• Configure a Preferred vault
• Deactivate and Remove Replication Rules
309
Aras Innovator Configuring Solutions Student Guide
310
Unit 16 - Replicating Files
Retrieving a File
This example shows a process for on demand file retrieval and file replication. There are many other
options available. This example uses two vaults that have been configured to support file replication
from the AlternateVault vault to the Default vault.
A User is always assigned to a Default vault in the User profile. In this example, the User’s
default vault is named Default.
The user selects a file to retrieve from the Aras Innovator Server. The Aras Innovator Server
maintains meta-data about each file stored in a vault (actual file data is contained in the File
Store). The file exists in the AlternateVault vault (and not the User’s Default vault). The Aras
Innovator Server sends a request to the AlternateVault vault to copy the file to the Default
vault and deliver the file to the user.
The AlternateVault vault has been configured to replicate files on demand.
The file resides in the AlternateVault vault.
A Replication Transaction is created based on the onDemand Replication Rule on the
AlternateVault vault.
The file is copied to the User’s Default vault, based on the schedule defined in the
Replication Rule, and delivered to the user.
311
Aras Innovator Configuring Solutions Student Guide
Adding/Changing a File
This example shows a process for onChange file replication. This example uses two vaults that have been
configured to support file replication from the Default vault to the AlternateVault vault.
A User is always assigned to a Default vault in the User profile. In this example, the User is
assigned to the default vault named Default.
The Default vault has been configured to copy to the AlternateVault vault when a file is
added or changed in the Default vault.
The file is first uploaded to the User’s Default vault.
A Replication Transaction is created to copy the file to the targeted AlternateVault vault.
The replicated file now resides in both the AlternateVault and Default vaults.
312
Unit 16 - Replicating Files
Replication Transactions
Replication is configured by creating Replication Rules that are associated with each vault. When a
matching Replication Rule is found on a vault, a replication transaction is created to process the file.
Replication Rule settings include:
• onDemand - A user requests a file from a vault. The vault is configured with an onDemand rule
to copy (or move) the file immediately to another vault.
• onChange - A file is changed or added to a vault. The vault is configured to copy or move the file
when the file is added or changed.
• onEvent - A vault is configured to respond to a programmed event that is invoked from a
Method. This Method may be associated with an Action menu item or a system event (e.g.,
Promote Item) that causes a file replication transaction to be created.
• Timing - Several options are available to indicate when the transaction should be invoked,
including immediate execution, delayed, at a scheduled time, or by program invocation.
• Move or Copy - The Replication Rule indicates whether a file should be moved or copied to a
new vault location.
313
Aras Innovator Configuring Solutions Student Guide
314
Unit 16 - Replicating Files
315
Aras Innovator Configuring Solutions Student Guide
Additional Vaults
To use file replication, you need an Aras.EssentialsSubscription feature license and at least two vault
servers installed and running. The Aras Agent Service must also be installed. IIS web services are utilized
to send messages to/from the Aras Innovator server to one or more vault servers.
The Aras Innovator server sends execution requests to the target vault servers. The requests are
acknowledged, processed by the vault server, and when complete, a message is sent back to the Aras
Innovator server to be logged.
Once the vault servers are installed, additional vaults must be configured on the Aras Innovator server.
This is done by creating new Vault items. There are two required properties to create a new vault.
• Name – New (The name of the vault server we are configuring).
• Vault URL Pattern – This is the IIS path to the VaultServer.aspx. Because this is not the default
vault, the URL should be hard coded using the following pattern:
http://<servername>/<web_alias>/vault/VaultServer.aspx
Try it … View the available Vaults
An additional vault (AlternateVault) was installed and exists in our classroom training image.
1. View the vaults by navigating to Administration > File Handling > Vaults and running a search.
2. You should see two vaults: Default and AlternateVault.
3. Open the Default vault and explore its settings.
4. Open the AlternateVault vault and explore its settings.
316
Unit 16 - Replicating Files
Configuring a Vault
When a user saves a file, it is always saved into their assigned default vault. When a user gets a file from
Aras Innovator, the vault selected for onDemand replication transactions can be defined by configuring
a Read Priority. The Read Priority property is set from lowest to highest for the most to the least
preferred vaults. For any file retrieved, the vault with the lowest numeric value, with a non-stale version
of the file, is selected to return the file to the user. If no vaults are listed with a Read Priority (none were
defined), the file is returned by the user’s Default vault, or finally by any other vault having a non-stale
version.
For an OnDemand rule, the read priority is used to get a copy of the file.
For an OnChange rule, the file is always saved in the user’s Default vault first (upload). Then rules are
checked to see if the file should stay in the current vault or be moved or copied to the additional vaults.
If there are no rules that replicate files, Aras Innovator always checks the files table to determine where
files are located and delivers the correct version of the file to the user.
317
Aras Innovator Configuring Solutions Student Guide
318
Unit 16 - Replicating Files
319
Aras Innovator Configuring Solutions Student Guide
Filter Method A custom Method that tests if a file should be replicated (or not)
when the Replication Transaction is processed. When the
Replication Transaction is invoked, the Method receives the
current file id, which can be used to determine if a file should be
replicated. Example: files over a certain size or in a certain
Lifecycle state are not replicated based on business rules.
Replication Type A Copy or Move of the replicated file.
Is Active Allows you to choose when rules are active or ignored. You must
deactivate a rule and wait for any transactions to finish before it
can be deleted.
Timeout Maximum time (hhmm) allowed between start and completion of
a transaction before it is considered Failed. Default value is 0100
(one hour).
320
Unit 16 - Replicating Files
321
Aras Innovator Configuring Solutions Student Guide
322
Unit 16 - Replicating Files
323
Aras Innovator Configuring Solutions Student Guide
324
Unit 16 - Replicating Files
325
Aras Innovator Configuring Solutions Student Guide
326
Unit 16 - Replicating Files
327
Aras Innovator Configuring Solutions Student Guide
328
Unit 16 - Replicating Files
Deactivating a Rule
You can delete a Replication Rule completely if it is no longer needed. However, if there are any
outstanding Replication Transactions, you cannot delete a rule until those transactions are completed. If
you wish to delete a rule, you can first set it as Inactive, to inhibit the creation of any new replication
transactions, wait for any existing transactions using that rule to complete or manually delete them,
then delete the Replication Rule.
329
Aras Innovator Configuring Solutions Student Guide
330
Unit 16 - Replicating Files
331
Aras Innovator Configuring Solutions Student Guide
332
Unit 16 - Replicating Files
Summary
In this unit, you learned how to configure file replication. You should now be able to:
• Create Replication Rules
• View Replication Transactions and Logs
• Describe Additional vaults
• Configure a Preferred vault
• Deactivate and Remove Replication Rules
Review Questions
1. Where do all files added or changed by a User get written to first?
2. How do you specify which vaults should receive a copy of a file when it is changed?
3. How would you restrict a replication rule so that only AUTOCAD files were replicated?
333
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Configure a file replication rule.
Scenario
In this exercise, you configure file replication. You define a Replication Rule using the configured Default
and AlternateVault vaults.
Steps
1. Make sure your student login (an Administrator) is assigned to the Default vault.
2. Ensure that the Read Vault Priority is set as follows:
Default = 1, AlternateVault = 2
3. Navigate to Administration > File Handling > Vaults and open the Default vault Item for editing.
4. Open the Replication Rule tab in the Relationships grid, click the Add Identities button, and
choose your student login (an Administrator).
5. With the Default vault open for editing, select onDemand for the Initiator Type field.
6. Select Immediate for the Replication Mode field.
7. Choose Copy for the Replication Type field.
8. Click to select (enable) the Is Active checkbox.
9. Click the Save button.
10. Right-click on the onDemand Replication Rule row and choose Replication Rule > Open from the
context menu.
11. Click the Edit button and from the File Types tab on the relationships grid, add a new
relationship (Add FileTypes button) for each file type to be supported, as follows:
334
Unit 17 Sending Notifications
Overview
In this unit, you learn about the two types of Notifications that can be sent from Aras Innovator: User
Notifications and e-mail Notifications.
User Notifications appear as alerts to users in an Aras Innovator session. These notifications can be used
to alert a user about an upcoming event (e.g., system maintenance, updated feature, etc.).
E-mail Notifications are customized e-mail messages that can be sent to users. For example, when an
Item is promoted to a new Lifecycle state or on a workflow activity. You will learn how to create e-mail
Message items and configure them for a Lifecycle map or Workflow map.
Objectives
• Understand Notification Types
• Explore User Notification Messages
• Create E-Mail Messages
• Use Variables in E-Mail Text
• Configure an E-Mail in a Lifecycle map
• Configure an E-Mail in a Workflow
Workflow
Map
Lifecycle
Map
335
Aras Innovator Configuring Solutions Student Guide
Notification Types
Aras Innovator offers two Notification Types, User Notification Messages and E-Mail Notifications.
User Notification Messages
There may be times when you need to notify a group of users while they are working in the Aras
Innovator Environment. An administrator can configure a message that will be broadcast to one or more
users.
E-mail Notifications
You can configure notifications from Aras Innovator that send e-mails to one or more individuals based
on an Item Lifecycle state or workflow event.
336
Unit 17 - Sending Notifications
337
Aras Innovator Configuring Solutions Student Guide
338
Unit 17 - Sending Notifications
Type Standard indicates that the message will appear in the Header.
Popup indicates the message will only appear as a pop-up window
when the message is received.
Text The message text (multilingual strings supported).
URL If supplied, the Title text becomes a hyperlink to the web URL
provided.
Priority Higher priority messages appear above lower ones, ordered by
importance.
Target The Identity that will receive the message – this can be a group
Identity.
Expiration Date The date that the message will expire. Expired messages are
removed from each users’ queue. If blank, the message will never
expire and will only be removed if the administrator deletes the
notification message template.
339
Aras Innovator Configuring Solutions Student Guide
Acknowledge Once Indicates that when users click the OK button on a message it
will be removed from their message queue and the event will be
recorded for later viewing by an administrator.
Always indicates the message will always appear in the user’s
message queue until it expires, or the administrator deletes the
notification.
Show OK button The OK button is considered the acknowledgement button for a
message that is configured to be acknowledged once, then the
window is closed.
OK button Label The text for the OK button (supports multilingual string).
Show Exit button The Exit button closes the window without further activity, which is
useful if the user wants to read the message text later.
Exit button Label The text for the Exit button (supports multilingual string).
Use Standard When enabled, it uses a default template xml file, located on the
Template Aras Innovator server. Disable for custom HTML templates
Icon Select an image to display on the message.
340
Unit 17 - Sending Notifications
341
Aras Innovator Configuring Solutions Student Guide
E-mail Notifications
To use e-mail, your Aras Innovator server must be configured to work with a valid SMTP e-mail server.
The default configuration uses the IIS mail queue (which must be enabled) but you can also define a
specific server. See the Aras Innovator - Installation Guide for more information.
If an e-mail server is not available (for testing purposes) you can enable the e-mail debug option. Locate
the Aras InnovatorServerConfig.xml file in the Aras server installation directory and remove the disabled
setting from the operating parameter of the e-mail debug option:
<operating_parameter key="email_debug_option" value="file"/>
Text files representing the generated e-mails will now be created in the directory associated with the
temp_folder operating parameter instead of being sent from the SMTP server.
In a Lifecycle map, use e-mail to notify selected identities that an item has either entered a specific
Lifecycle state, or that it is in transition between states. In a workflow, use e-mail to notify selected
identities that a workflow event has occurred. Common workflow events include an Activity becoming
active, when an assignment reaches an InBasket, or when an Activity is delegated or escalated to
another identity.
342
Unit 17 - Sending Notifications
343
Aras Innovator Configuring Solutions Student Guide
344
Unit 17 - Sending Notifications
345
Aras Innovator Configuring Solutions Student Guide
346
Unit 17 - Sending Notifications
347
Aras Innovator Configuring Solutions Student Guide
Target
All Assignments - All assignees listed in the Assignments tab for this activity. If there is an
assignee, which is a group Identity, all members of that Identity will receive this
notification.
Open Assignments - All assignees that have not completed the Activity. Typically, this
Target is used with the On Remind or On Due event.
Closed Assignments - All assignees who have completed the Activity. Typically, this Target
would be used with the On Close event.
From Identity - Used only for escalation or delegation, this Identity is the one from which
the assignment is being delegated or escalated.
To Identity - Used only for escalation or delegation, this Identity is the one being delegated
to or escalated to.
Alternate - the Identity defined in the Alternate field.
Alternate
If the Alternate Target is chosen above, this value is the Identity to receive the message.
Try it … Configure a Workflow Notification
In this example, a simple e-Mail Message Item is configured to notify a user to review a Design Request.
It is configured on the Review Request Activity of the Design Request Workflow.
1. Navigate to Administration > Workflow Maps and open the Design Request Workflow map for
editing.
2. Click to select the Review Request Activity, then click the Notifications tab in the Relationships
grid.
3. Using the Add E-Mail message button, search for and choose the Notify in Review message.
4. In the new Relationship grid row, click in the Event field and choose On Activate.
5. In the same Relationship grid row, click in the Target field and choose All Assignments.
6. Click Done for the Design Request Workflow Map.
348
Unit 17 - Sending Notifications
349
Aras Innovator Configuring Solutions Student Guide
350
Unit 17 - Sending Notifications
351
Aras Innovator Configuring Solutions Student Guide
Note
There are four system variables available that can be used for any e-mail message.
Variable Definition
$[USER] The current logon name
$[ALIAS] The alias identity of the user
$[DATE] String containing today's date
$[TIME] String containing the current time
352
Unit 17 - Sending Notifications
Summary
In this unit, you learned about User Notifications and E-mail Notifications.
You should now be able to:
• Describe User Notifications
• Create an E-mail Message Item
• Use Variables in E-mail Text
• Send an E-mail Message when an Item is Promoted
• Send an E-mail Message using a Workflow Notification.
Review Questions
1. Describe the difference between a User Notification and an E-Mail Notification. Specifically,
where does the user see each notification?
3. What are the four places from which you can initiate an E-Mail Notification?
6. How can you notify a user that an assignment has been delegated to him/her?
353
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Be able to send an e-mail notification from a Lifecycle map and a Workflow.
Scenario
In this exercise, you create notifications for the Change Request to alert users about Lifecycle state
changes and active assignments.
Steps
1. The Creator should receive an e-mail message that resembles the following when a Change
Request is created. Configure the email message on the Preliminary (starting) Lifecycle state.
Name: Change Request Created
Subject: Change Request ${Item[@type=”Change Request”]/_item_number} created
Message (Body Plain):
Change Request ${Item[@type=”Change Request”]/_item_number} has been created.
Reason: Printer assembly needs to be replaced.
Cost $: ${Item[@type=”Change Request”]/_cost_estimate}
Please submit for review.
Identity: Engineering
2. The Review Request Activity of the Change Request Workflow should send the following
message to the CRB group.
Name: Change Request Review
Subject:
Change Request ${Item[@type=”Change Request”]/_item_number} needs review.
Message: An assignment has been placed in your InBasket.
Please review and approve Change Request ${Item[@type=”Change Request”]/_item_number}.
3. On the Change Request Workflow’s Notification Relationship tab, choose the event of: On
Activate and choose All Assignments for the Target field.
4. As an Engineering identity, create a Change Request and process it through its workflow to test
your work, keeping in mind the following Activity identities:
a. The Engineering identity you used as the Creator, will need to Confirm the Request and
Submit it.
b. Change Specialist I (PE Student) will need to Validate the request and a member of
Engineering will need to Verify the request.
c. Verify request goes through the Quality Control Subflow (Administrators).
d. Finally Review Request to Approve or Reject is by the CRB group identity (PE Student or Ann
Reddy).
354
Unit 18 - Implementing Poly Items
355
Aras Innovator Configuring Solutions Student Guide
Change
Controlled Item
© 2020 Aras
356
Unit 18 - Implementing Poly Items
2
© 2020 Aras
s
Reviewing Poly Item Example
A Poly Item is defined by an ItemType that uses the implementation type of Poly Item.
The Aras Product Engineering application uses a “Change Controlled Item” to represent either a Part, a
Document, or a CAD Document that is reviewed and modified under change control.
Implementation Type
Poly Item indicates this ItemType will represent two or more ItemTypes that are already
defined in the database.
Poly Sources
Defines the “parent” ItemTypes that will define the resulting Poly Items.
A Poly Item ItemType does not implement all the features of a Single implementation ItemType.
Try it … View a Poly Item ItemType
1.Locate the ItemType named Changed Controlled Item and open it for viewing.
2. Close the tab when you finished viewing it.
Note
Once an ItemType has been designated as a Poly Item, it is always a Poly Item. The database table for
this ItemType is deleted and any existing Items of that ItemType are lost. A Poly ItemType can’t change
back to a single ItemType.
357
Aras Innovator Configuring Solutions Student Guide
358
Unit 18 - Implementing Poly Items
© 2020 Aras
359
Aras Innovator Configuring Solutions Student Guide
© 2020 Aras
360
Unit 18 - Implementing Poly Items
© 2020 Aras
361
Aras Innovator Configuring Solutions Student Guide
© 2020 Aras
362
Unit 18 - Implementing Poly Items
© 2020 Aras
3. Click Done and test the new Relationship by editing a Design Request and using the Catalog
Items Relationship tab to choose Parts and/or Products.
363
Aras Innovator Configuring Solutions Student Guide
© 2020 Aras
2. Click Done and then modify the Design Request Form to add the property to display on the
form.
3. Click Done and test the Poly Item Property by editing a Design Request and using the Catalog
Entry property to choose a Part or a Product.
4. Click Done.
364
Unit 18 - Implementing Poly Items
Summary
In this unit, you learned how to define and create Poly Items. You should now be able to:
• Define the purpose of a Poly Item
• Use Poly Items for establishing Relationships or Item Data Type Properties
• Create a Poly Item as a Property
Review Questions
1. How do you configure which ItemTypes will define a Poly Item?
365
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Create a new Poly Item ItemType using the ItemTypes you created in this course.
Scenario
In this exercise, you create a new Poly Item ItemType named Product Request that allows a user to
query both the Design Requests and the Change Requests you configured earlier in the course in a single
search grid.
Steps
1. Create a new ItemType named Product Request and provide the appropriate labels and icons.
2. Choose the implementation type of Poly Item.
3. Select the Design Request and Change Request ItemTypes as Poly Sources for the new ItemType.
4. Allow the World Identity TOC Access and choose the Product Management category to place
this ItemType in the TOC.
366
Unit 18 - Implementing Poly Items
Note
If you did not build the Properties for the Design Request ItemType with the instructor earlier, please do
it now.
Name Label Data Type Length
_item_number Request Number String 32
_title Title String 64
7. Click Done and locate the new ItemType in the TOC and run a query to display the results.
The following example is sorted by Title and your results may differ.
367
Aras Innovator Configuring Solutions Student Guide
368
Unit 19 Configuring Command Bars
Overview
The Aras Innovator client uses configurable command bars that allow you to add, remove and revise
buttons, menus, and associated windows shortcut keys without any programming.
In this unit, you learn how to add new command buttons and shortcut keys that are defined in the
Configurable User Interface (CUI) data model.
Objectives
• Introduce the Configurable User Interface (CUI) Data Model
• Review Command Bar Section Locations
• Identify Command Bar Item Actions
• Understand Command Bar Item Action Ranking and Security
• Add a Command Bar Button and Windows Shortcut
369
Aras Innovator Configuring Solutions Student Guide
370
Unit 19 - Configuring Command Bars
371
Aras Innovator Configuring Solutions Student Guide
Implementation Types
Customization of the user interface is accomplished in two ways: either through the Data Model or
through Methods.
Data Model
A reserved set of ItemTypes provides the ability to add, revise and remove menu entries and command
bar buttons in the locations described on the previous page. Method code is not required to create new
controls using the data model implementation. Controls can also be configured to determine who
should have access to the controls and when they should appear.
In this course, we will make changes to the existing data model to create new controls.
Methods
The Aras API also allows UI controls to be created dynamically with programming logic using either a
client or server Method. This approach is best when the access to a control is based on complex
business rule(s).
Using Methods to create UI controls is outside of the scope of this course.
372
Unit 19 - Configuring Command Bars
373
Aras Innovator Configuring Solutions Student Guide
374
Unit 19 - Configuring Command Bars
Action Ranking
Actions are ranked by a sort order that indicates the order of execution within a section. The lowest
order number executes first and so on.
In the case of the Add action, this dictates the position order of a command bar item or window section.
In the example above, a series of buttons are added to a toolbar in the sequence indicated by the sort
order number.
375
Aras Innovator Configuring Solutions Student Guide
376
Unit 19 - Configuring Command Bars
377
Aras Innovator Configuring Solutions Student Guide
378
Unit 19 - Configuring Command Bars
379
Aras Innovator Configuring Solutions Student Guide
380
Unit 19 - Configuring Command Bars
381
Aras Innovator Configuring Solutions Student Guide
382
Unit 19 - Configuring Command Bars
383
Aras Innovator Configuring Solutions Student Guide
384
Unit 19 - Configuring Command Bars
385
Aras Innovator Configuring Solutions Student Guide
386
Unit 19 - Configuring Command Bars
Summary
In this unit, you learned how to configure command bar buttons and windows shortcut keys using the
Configurable User Interface (CUI).
You should now be able to:
• List the components of the Configurable User Interface (CUI) Data Model
• Be able to identify the command bar section locations
• Use a command bar item Action and define Action ranking and security
• Add a Command Bar button and Shortcut.
Review Questions
1. Because the Configurable User Interface provides the ability to reconfigure how users interact
with the Aras client, it is strongly recommended that you make a _____________________ of
the database before changing any UI controls that are standard in the Aras interface.
3. How can you control the order of command bar buttons in a toolbar?
387
Aras Innovator Configuring Solutions Student Guide
Lab Exercise
Goal
Add command bar items using the CUI Data Model implementation.
Scenario
A request has been made to make the following adjustments to the client user interface:
• Add a button to the Item View Command Bar to allow users to create a new item from an
existing item.
• Add a shortcut key (alt+h) which brings up Aras Innovator Help.
Steps
Add a Command Bar button
1. Open the Global Client Presentation for viewing.
2. Locate and edit the Command Bar Section for the Item View Command Bar named
itemview.itemcommandbar.default.
3. Add a new Button named training.itemview.new with Action Add, supply a sort order (e.g.,
1000), and an Identity (e.g., World).
4. Right click on the row and select Open to continue configuring the new command button.
5. Locate and enter the Click Method named cui_command_new_item_execute.
6. Select an image for the Button, e.g., the New symbol and add text in the Label field if desired.
7. Check the result of your work by opening a new ItemView. If necessary, logout and login again.
8. The updated Item View Command Bar should look something like the following:
388
Unit 20 Packaging a Solution
Overview
In this unit, you learn how to package the solutions you built in this course so they can be exported and
moved to a different database. You build a package definition, add Items (Elements) to it, and export the
package to the file system. You can then import the exported files to a different database.
Objectives
• Identify Package Components
• Create a Package Definition
• Review Package Dependencies
• Add Package Elements
• Review a Package Definition
• Export a Package
• Review the Logs
• Review the Manifest File
• Import a Package.
389
Aras Innovator Configuring Solutions Student Guide
Moving a Solution
When you create a solution, you typically work on a Development server to build and configure the new
application. You also use the Development server to correct bugs as well as make enhancements and
add new features to the solution. In this course, your cloud server is used as the Development server.
Once a solution is ready for testing, a copy is typically moved to a Test/QA server for assessment of any
problems, etc. When the solution is approved for general use, it is then moved to the Production server
where end users begin to use the solution. You should never make changes to the Production server
until they have been verified through careful testing.
Your exact configurations may differ (and are more detailed), but this general configuration is
recommended for developing/deploying solutions.
In this unit, you learn how to package a solution so that it can be transported to a new server. You also
learn some best practices for moving solution elements.
390
Unit 20 - Packaging a Solution
Package Overview
As you learned, everything you create in Aras Innovator is an Item. The templates you created in this
course to define ItemTypes, Relationship Types, Forms, etc. are all Items that define your solution.
You also learned that all Items are described using Adaptive Markup Language (AML). In effect, the Aras
Innovator database can be represented as a large collection of AML documents that describe the
configuration of your solution as well as the data. To move a solution to another system requires careful
planning to determine what components comprise your solution.
Package Definition
The first step in moving a solution is to create a Package Definition. A Package Definition is a collection
of Package Groups that contain Package Elements. Each Package Group defines a collection of templates
that is exported from the database.
In the example above, the Package Definition contains an ItemType Package Group. That group contains
one Package Element, which is the Design Request ItemType. Each subsequent group contains
respective element(s) for that group (Workflow, Lifecycle map, Relationship Type, etc.).
391
Aras Innovator Configuring Solutions Student Guide
392
Unit 20 - Packaging a Solution
393
Aras Innovator Configuring Solutions Student Guide
394
Unit 20 - Packaging a Solution
395
Aras Innovator Configuring Solutions Student Guide
1. Navigate to Administration > Forms and search for all the Design Request forms.
2. Select all the Design Request forms, right-click and choose Admin > Add to Package Definition.
3. In the dialog window, use the dropdown list to select the Design Request package, then click the
OK button.
4. Add the Design Request Lifecycle map to the Design Request package.
5. Add the Design Request and Calculate Price Workflow maps to the Design Request package.
396
Unit 20 - Packaging a Solution
1. Navigate to Administration > Configuration > Package Definitions and open the Design Request
package definition for viewing.
2. Right-click on a Package Group and select Package Group > Open from the context menu to see
each individual Element Id.
3. Close each open Package Group and return to the Design Request package definition tab.
397
Aras Innovator Configuring Solutions Student Guide
1. For the Design Request Package definition, open the PackageDependsOn Relationship tab.
2. If you do not see the com.aras.innovator.solution.PLM package definition, click the Edit button,
and then click the New PackageDependsOn button.
3. In the name field, enter com.aras.innovator.solution.PLM and click Done.
398
Unit 20 - Packaging a Solution
Exporting a Package
Once the Package Definition is complete, the package can be exported using the Export utility. This
utility is a separate executable named export.exe that is available on the Aras Innovator CD image. It is
important to select the Export utility belonging to the version and service pack of the installation from
which you do the export.
The Export utility allows you to select a Package Definition from the database and create a package
folder structure in the file system. Each Package Group (ItemType, Form, etc.) becomes a separate
subfolder in the file. Within each subfolder, each exported Item is represented as an AML file with the
same name as the exported Item.
In the example above, two Form definitions are exported and contained in the Form subdirectory. Note
the remaining subfolder names – each represents an exported Item from the database.
399
Aras Innovator Configuring Solutions Student Guide
1. Use Windows File Explorer and navigate to the place where you have stored the export.exe file.
For example: C:\Program Files (x86)\PackageImportExportUtilities\Export
2. Double click the export.exe file to run the Export Utility.
3. In the Server field, enter the URL of the Aras Innovator Server.
4. Click the ellipsis (…) button to the right of the Database field to populate the dropdown list.
5. Select the desired database.
6. Enter a valid administrator username and password in the respective fields.
7. Click the Login button.
400
Unit 20 - Packaging a Solution
401
Aras Innovator Configuring Solutions Student Guide
402
Unit 20 - Packaging a Solution
1. Use Windows File Explorer and navigate to the folder where your Export utility is stored.
For example: C:\Program Files (x86)\PackageImportExportUtilities\Export.
A subdirectory named logs exists that stores a log of each export.
2. Open the log file with today’s date using a text editor to view results and any errors.
3. Close the text editor when you are finished viewing the log file.
403
Aras Innovator Configuring Solutions Student Guide
404
Unit 20 - Packaging a Solution
405
Aras Innovator Configuring Solutions Student Guide
Importing a Package
Package import is accomplished by using a separate executable named Import.exe that is available on
the Aras Innovator CD image. It is important to select the Import utility belonging to the version and
service pack of the installation to which you do the import.
The Import utility uses an existing manifest file to locate the AML export files. Each file is then parsed to
create (or edit) new Items in the destination database.
The Import Utility imports Package Groups from a Package Definition in the following order:
1. List 11. Email Message 20. Field
2. Sequence 12. Action 21. Property
3. Revision 13. Report 22. View
4. Variable 14. Form 23. SQL
5. Identity 15. Workflow Map 24. Metric
6. Member 16. Lifecycle Map 25. Chart
7. User 17. Grid 26. Dashboard
8. Permission 18. ItemType
9. Method 19. RelationshipType
If this sequence is not supporting you well enough, please use different packages and define the control
using dependencies.
406
Unit 20 - Packaging a Solution
407
Aras Innovator Configuring Solutions Student Guide
408
Unit 20 - Packaging a Solution
409
Aras Innovator Configuring Solutions Student Guide
Summary
In this unit, you learned how to create a Package Definition to export your solution for transport to
another server. You should now be able to:
• Identify the Package Components
• Create a Package Definition
• Add Package Elements
• Review a Package Definition
• Export a Package
• Review the Logs and Manifest File
• Import a Package
Review Questions
410
Unit 20 - Packaging a Solution
Lab Exercise
Goal
Export the Change Request solution using a Package Definition and the Export utility.
Scenario
In this exercise, you will create a Package Definition for the Change Request solution. You will need to
determine all the required components for the solution to create a new Package Definition. You will
then export the solution.
Steps
Relationship Types
Forms
Lifecycle Maps
Workflow Maps
Lists
Sequences
411
Aras Innovator Configuring Solutions Student Guide
Identities
Permissions
1. Create a new Package Definition named Change Request and capture all the elements you have
listed in the previous step.
2. Use the Export utility to extract the elements from the database to the file system into a
directory named C:\ExportPackage.
3. Review the log and manifests files that are created and resolve any errors.
412
List of Exercises and Labs
Unit 1 Introduction .................................................................................................... 5
Unit 2 Users and Identities ...................................................................................... 13
Try it … Create a New User ........................................................................................ 16
Try it … Add a User to a Group .................................................................................. 22
Try it … Create Engineering Users.............................................................................. 23
Try it … Create a Group Identity and Add Users ........................................................ 23
Try it … Run an Identity Membership Report ............................................................ 24
Lab Exercise ................................................................................................................ 26
Unit 3 Exploring ItemTypes...................................................................................... 27
Unit 4 The Table of Contents (TOC) Editor ............................................................. 49
Unit 5 Itemtype Properties ...................................................................................... 61
Try it … Make a Property Required, and Modify its Label: ........................................ 70
Try it … Create Custom Properties for the Design Request ItemType....................... 73
Lab Exercise ................................................................................................................ 75
Unit 6 Creating Object Properties............................................................................ 77
Try it … Create a Foreign Property ............................................................................. 81
Try it … Create a List and Use it for a New Property ................................................. 83
Try it … Create a Filtered List ..................................................................................... 85
Try it … Configure a List ............................................................................................. 86
Try it … Configure a Filtered List ................................................................................ 87
Try it … Create a Sequence ........................................................................................ 90
Try it … Defining an Image Property .......................................................................... 92
Lab Exercise ................................................................................................................ 94
Unit 7 Creating the User Interface ........................................................................... 97
Try it … Regenerate a Form ..................................................................................... 100
Try it … Edit the Design Request Form .................................................................... 102
Try it … Configure Additional Properties on the Form ............................................ 103
Try it … Add Unused Properties to the Form ........................................................... 105
Try it … Copy a Form ................................................................................................ 109
Try it … Hide Properties on a Form .......................................................................... 111
413
Aras Innovator Configuring Solutions Student Guide
414
Appendix A
Review and Lab Questions Answer Key
415
Aras Innovator Configuring Solutions Student Guide
416
Appendix A Review and Lab Questions
Answer Key
Unit 2 – Users and Identities
Review Questions
1. An Alias Identity. User privileges are defined and managed through identities.
An alias identity is unique for each user.
Additional rights and access will be inherited from groups or roles that the alias identities belong
to.
2. The Identity Membership report is the best way to see a Group Identity hierarchy.
3. Disable logon.
Unit 3 – Exploring ItemTypes
Review Questions
1. ItemTypes are templates which define properties, forms and views, Lifecycles, Workflows,
permissions, relationships and server, and client methods. Items are instances created from an
ItemType template.
2. Minimum requirements are: Name, Can Add Identity, and Default Permissions. TOC Access
should also be considered.
3. Allows the Aras Administrator to select one or more properties to identify an object in searches,
tab titles, reports, etc. that is more descriptive and user friendly than the object GUID, or
numbered Items.
4. ItemType Definition Report.
5. Aras Administrator did not grant TOC Access to their identity or a group that they belong to.
6. Shared properties can be defined at the parent level and inherited by all subclasses.
Subclasses can then be differentiated by additional properties, a different Lifecycle, a different
view of a form, or different permissions for who can create a new item.
Unit 4 – The TOC Editor
Review Questions
1. Categories and ItemType buttons.
2. Use the TOC Editor’s “View As” feature. .
Unit 5 – Creating Properties
Review Questions
1. In the SQL table named PROPERTY.
2. Values are stored in rows in a table created for each Item Type.
417
Aras Innovator Configuring Solutions Student Guide
3. If Hidden is checked, the property is not visible or searchable in the main search grid using a
Simple Search. If unchecked, the property is visible as a column in the main search grid and can
be included in simple searches. If Hidden2 is checked, it is not visible on a relationship grid tab. If
unchecked, the property appears as a column on a relationship tab.
4. Properties maintain a label that can be changed, and it is used for displaying in search grids and
form views.
5. System Properties – 23 properties automatically created and needed for each new ItemType by
the Aras Innovator System.
Custom Properties –Properties for one ItemType, defined by an administrator to store data
specific to the ItemType.
Lab Exercises
Follow the Lab instructions.
Unit 6 – Creating Object Properties
Review Questions
1. False, Foreign properties are populated from the values of existing properties of a different
item. They are displayed as read only when referenced on the form.
2. Select or create an Item Property and use this as the Data Source.
3. An administrator can edit a Sequence and set or change the current value.
Lab Exercises
Follow the Lab instructions.
Unit 7 – Creating the User Interface
Review Questions
1. A form establishes the main user interface for adding, viewing, and editing items. A view is the
relationship between an ItemType and a Form.
2. There is an unlimited number of forms that can be linked to an ItemType. However, each form
must be linked through the view relationship tab on the ItemType.
3. If you have already built and saved a customized form. This action rebuilds the form, placing
unhidden propertied on the form.
4. The width and height can be set on the Form Properties tab of the Form Editor.
Lab Exercises
Follow the Lab instructions.
Unit 8 – Creating Item Relationships
Review Questions
1. RelationshipType Item defines the connections or links to other items. This can control the
number of items allowed to be attached and versioning behavior. A Relationship ItemType
stores the properties about the specific link, such as Parent item, child, quantity, etc.
2. A Relationship ItemType.
3. A Null relationship allows the ability to add multiple rows of information of a similar type to an
item such as remarks, comments, etc. without connecting to another DB Table.
Lab Exercises
Follow the Lab instructions.
418
Appendix A
Review and Lab Questions Answer Key
419
Aras Innovator Configuring Solutions Student Guide
4. The standard Lifecycle behavior takes precedence over the RelationshipType behavior setting,
foreseen on the RelationshipType with the setting as Float or Fixed. With Hard Float or Hard
Fixed the Relationship Type behavior takes precedence.
5. Use the Navigate > Versions menu. Or you can use the Structure Browser and click the Side-by-
Side with Other Version button.
Lab Exercises
Follow the Lab instructions.
Unit 13 – Creating a Workflow Map
Review Questions
1. A Workflow Map graphically represents the template for a business process. It usually contains
activities, paths, assignments, and tasks. A Workflow Process is an instance created using the
Workflow Map, tracking actual participants and which assignments are completed.
2. From the assignments tab, select the desired Group Identity and then check For All Members.
3. Create an automatic activity and then create multiple default paths to link to other activities
(branching out).
4. One or more Default Path(s) must follow automatic activity.
5. Password and E-signature.
Lab Exercises
Lab Workflow Diagram:
420
Appendix A
Review and Lab Questions Answer Key
421
Aras Innovator Configuring Solutions Student Guide
2. When consistent Properties are used in multiple ItemTypes and a single view is needed to
search for an item. When the related item of a relationship can be represented by more than
one ItemType. When a Property of Data Type Item may be represented by more than one
ItemType.
3. RelationshipTypes, Views, Workflows, Permissions, Reports, Actions, Client Events, Secure Social
Collaboration and xProperties.
4. When the relationship can support different types of Items (multiple ItemTypes).
Lab Exercises
Follow the Lab instructions.
Unit 19 – Configurable User Interface
Review Questions
1. Be sure to make a BACKUP copy of the database before changing the UI in Aras.
2. Presentation Configuration
3. By the Sort Order of the Command Bar Item inside a Command Bar Section. Please be aware
that the ItemType Client Style Presentation can overlap command bar sections, menu entries,
toolbar buttons or shortcut keys and thus will finally decide about the presentation of the
buttons..
4. Command Bar Items can be qualified by an Identity as well as Item Classification.
Lab Exercises
Follow the Lab instructions.
Unit 20 – Packaging a Solution
Review Questions
1. Most solutions reference elements from other solutions. On import, required dependencies
must be resolved before any new elements are accepted. If the required package is missing on
the new destination, the import will fail with an error condition.
2. The Package Definition is an item that can be found under the Administration category in the
TOC. Select Administration > Configuration > PackageDefinition and search for the desired
definition.
3. AML documents.
4. A manifest file is used at Import to locate the package element AML files.
Lab Exercises
Follow the Lab instructions.
If you have followed along with the naming suggestions in the labs, you can filter searches by naming
patterns or use dates that items were created or modified on.
The following table lists the items that were created or edited in the Change Request lab assignments
this week. Be sure to add all of them to your package definition before using the Export utilities.
ItemTypes Change Request
Relationship Change Request Customer, Change Request Memo, Change Request
Types Product
Forms Change Request, Change Request Defect
Lifecycle Maps Change Request
422
Appendix A
Review and Lab Questions Answer Key
423