Beruflich Dokumente
Kultur Dokumente
Contents
Ellipse EAM Screen Personalisation ......................................................................................................... 6
Personalising Screens in Ellipse EAM ......................................................................................................7
Personalisation Screen - Toolbars and Fields ............................................................................... 8
Move Component Positions ............................................................................................................. 11
General - Modify Field Groups .......................................................................................................... 12
Modify Field Properties ..................................................................................................................... 13
Create List Values for Fields .............................................................................................................15
Maintaining Personalisations ................................................................................................................. 16
Copy a Personalised Screen ............................................................................................................. 18
Name an Existing Personalised Screen ......................................................................................... 19
Modify Personalisation Scope Details........................................................................................... 20
Activate or Deactivate a Personalised Screen .............................................................................. 21
Delete a Personalised Screen .......................................................................................................... 22
Upgrade a Personalised Screen ...................................................................................................... 23
Upgrade All Personalised Screens .................................................................................................. 24
Export Personalised Screen Definitions ....................................................................................... 25
Import Personalised Screen Definitions ....................................................................................... 26
Maintaining Custom Attributes ............................................................................................................. 27
Create Custom Attribute Type ........................................................................................................ 28
Update Custom Attribute Type ...................................................................................................... 29
Delete Custom Attribute Type ........................................................................................................ 30
Create Custom Attribute for a Service ........................................................................................... 31
Maintain Custom Attributes for a Service .................................................................................... 32
Export Service Custom Attributes ................................................................................................. 33
Import Service Custom Attributes ................................................................................................. 34
Ellipse Screen Personalisation Reports ................................................................................................ 35
MSBCSD - Upgrades Personalisations .......................................................................................... 36
Ellipse Screen Personalisation - Screens ............................................................................................... 37
Dialog Box - Add Attribute ...................................................................................................................... 38
Dialog Box - Change Scope ..................................................................................................................... 39
Dialog Box - Copy ...................................................................................................................................... 40
Dialog Box - Name Personalisation ....................................................................................................... 41
Dialog Box - Set Active ............................................................................................................................. 42
MSEATT - Search Service Custom Attributes ..................................................................................... 43
MSEATT - Service Custom Attributes ................................................................................................... 44
MSECAT - Search Custom Attribute Types ......................................................................................... 45
MSECAT - Custom Attribute Types detail ............................................................................................ 46
MSECSD - Search Personalisation ......................................................................................................... 48
5
Ellipse Screen Personalisation
6
Ellipse Screen Personalisation
Business Rules
The following business rules govern this process:
Only MSE screens can be personalised.
7
Ellipse Screen Personalisation
Personalise a Screen
To personalise a screen:
1. Access the application to be personalised.
2. Select the ellipsis in the application toolbar and select Open Personalisation.
Ellipse EAM displays a screen preview on the left and the screen layout to the right of the
screen.
Screen Preview
Displays a screen preview of the application to be personalised.
Note: This is a display screen only, no data can be entered into the screen preview.
Screen Layout
The screen layout panel displays a tree structure containing all the components that make up
the application (such as, fields, field groups and tabs).
Note: Functions, Actions and Dialog Boxes are not included in the screen layout components.
Reverts to the original screen or the last saved personalisation (if one
exists).
Deletes the personalisation for the screen. The screen reverts to the
default screen layout.
Tree Structure
All available components (fields) associated with the application display in the tree structure.
This includes fields that are hidden from screen view. For example, fields which display only if a
specific module is installed or are set in the district and system controls.
Form displays at the top of the tree structure and represents the screen in its entirety. The
Form can be expanded to view all its associated components.
By selecting a component in the tree structure, the corresponding component in the screen
preview to the left of the screen is outlined.
On selection of a component in the tree structure, the properties of the component display in
the field settings to the right of the screen layout.
8
Ellipse Screen Personalisation
Note: Only fields that are correctly defined as attributes in MSEATT can added to the field
group.
Field Settings
The properties that display in the field settings vary according to:
the field selected
the property types that are set up for the field
whether the screen is a search or detail screen
The example below displays the properties for the Equipment Number input field in an update
screen.
Mark Field Mandatory Select this check box to switch the field to mandatory or optional
when performing a search or creating/updating a record.
Disable on Update Disable the selected field when the screen is in update mode.
Disable on Create Disable the selected field when the screen is in create mode.
Initial Value The default display of information in a field can be from either:
An initial value provided as part of personalisation
The default from a service call (this overrules the
personalised initial value if entered).
9
Ellipse Screen Personalisation
10
Ellipse Screen Personalisation
Activity Steps
1. From the application to be personalised,select the ellipsis in the application toolbar and
select Open Personalisation.
2. Expand the components in the tree structure until the required component displays.
3. Drag and drop the component to the required position.
A blue line indicates the position where the component will be dropped. The component is
highlighted yellow once the move is complete.
Note: If you are moving a field group or a tab, all the components belonging to the group or
tab are moved.
11
Ellipse Screen Personalisation
To add a field:
1. Select the field group.
The properties of the component display in Field Settings.
2. Select Add Custom Attribute.
The Add Custom Attribute dialog displays.
3. Enter data in the following fields
Entity
Attribute
4. Click OK.
5. Select Submit to save the personalisation.
12
Ellipse Screen Personalisation
13
Ellipse Screen Personalisation
Note: A default from a service call overrides the personalised initial value.
3. Select Submit to save the personalisation.
To add/show or hide list of values:
Refer to Personalisation Screen Layout »Field Settings.
14
Ellipse Screen Personalisation
On Preview or Submit, the field displays a drop-drop down with your specified values.
15
Ellipse Screen Personalisation
Maintaining Personalisations
The MSECSD - Personalisation screen is used to manage your personalised screens.
Watch the video
(https://search.abb.com/library/Download.aspx?DocumentID=9AKK107046A4225&Languag
eCode=en&DocumentPartId=&Action=Launch)
Change the scope of a personalised screen
Personalised applications can be applied to all users at a system, district, position, global
profile or user (individual) level. These levels are referred to as Scope. The following is the order
of hierarchy for the scopes.
User - The specified user sees the personalised screen as their default screen.
District - Users logged into this district see the personalised screen as their default screen.
System - Users using this system see the personalised screen as their default screen and
the original screen cannot be accessed by anyone other than the System Administrator.
Position - Users logged in to this position see the personalised screen as their default
screen.
Global Profile - Users belonging to this security global profile see the personalised screen as
their default screen.
Name a personalised screen
Personalised screens can be given a custom name so they can be easily identified. For example,
if you have multiple personalisations of a specific screen, the screens can be given a single
custom name so all users can readily identify the screen.
Note: When personalising related search and detail screens, ensure the screens refer to the
same MSE as part of the custom name.
16
Ellipse Screen Personalisation
Business Rules
The following business rules govern this process:
The MSECSD - Personalisation screen can only be accessed and managed by the System
Administrator or an employee who has been given security access to manage
personalisations.
17
Ellipse Screen Personalisation
Note: This activity can only be carried out by the System Administrator or an employee who has
been given security access to manage personalisations.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check box beside
the application name.
2. Select the Copy from the grid actions.
3. From the Copy dialog box, enter data in following fields:
Custom Name
Scope Type
Scope Value
Active
4. Click OK.
The copy is saved and displays when you perform a new search.
18
Ellipse Screen Personalisation
Note: This activity can only be carried out by the System Administrator or an employee who has
been given security access to manage personalisations.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check box beside
the application name.
2. Select Name Personalisation.
3. From the Name Personalisation dialog box, enter a Custom Name.
4. Click OK.
19
Ellipse Screen Personalisation
Note: This activity can only be carried out by the System Administrator or an employee who has
been given security access to manage personalisations.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check box beside
the application name.
2. Select Change Scope.
3. From the Change Scope dialog box, modify the following fields:
Scope Type
Note: If System is selected, no scope value is required.
Scope Value
4. Click OK.
20
Ellipse Screen Personalisation
Note: This activity can only be carried out by the System Administrator or an employee who has
been given security access to manage personalisations.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check box beside
the application name.
2. Select Set Active.
3. From the Set Active dialog box, select or clear the Active Flag check box.
4. Click OK.
21
Ellipse Screen Personalisation
Note: This activity can only be carried out by the System Administrator or an employee who has
been given security access to manage personalisations.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check box beside
the application name.
2. Click Delete.
A message displays prompting you to confirm the deletion.
3. Click Confirm.
22
Ellipse Screen Personalisation
Note: Under some circumstances, it may not be possible to upgrade the application and it may
be necessary to manually upgrade the personalisation.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check boxes
beside the application names.
Note: Applications which are upgradeable are checked in the Is Upgradeable column in the
grid.
2. Select Upgrade.
If the conditions are met, the applications are upgraded.
23
Ellipse Screen Personalisation
Note: Under some circumstances, it may not be possible to upgrade the application and it may
be necessary to manually upgrade the personalisation.
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check boxes in the
grid.
Note: Applications which are upgradeable are checked in the Is Upgradeable column in the
grid.
2. Select Upgrade All.
The MSBCSD - Upgrade Personalisations batch file runs to update all custom screen
definitions.
If the conditions are met, all applications are upgraded.
24
Ellipse Screen Personalisation
Activity Steps
1. From MSECSD - Search Personalisation search results, select the required check boxes in the
grid.
2. Select Export.
The personalisations are downloaded as a .JSON file.
This file can be used to import those personalisations to another instance.
25
Ellipse Screen Personalisation
Note: When importing screen definitions, the current system must have the same conditions as
the old system from where the definition was exported. This includes the same Ellipse EAM
version and custom attributes of the services as exported using MSEATT.
Activity Steps
1. From MSECSD - Search Personalisation, select Import.
2. Browse for the .JSON file previously exported using the Export Personalised Screen
Definitions activity.
3. Click OK.
The screen must be refreshed to see the imported screen definitions.
26
Ellipse Screen Personalisation
Notes:
• Custom attributes definitions cannot be added to a personalised screen, although an existing
personalised screen with custom attributes will work from earlier versions that have been
upgraded.
• If custom attribute values have been assigned against data on an Ellipse EAM entity, the
custom attribute definition cannot be modified or deleted (values may become invalid), this
includes data that has been carried through from an earlier version or a different environment.
The standard functions available for managing custom attribute types include searching or
reviewing, creating, updating, and deleting.
27
Ellipse Screen Personalisation
Activity Steps
1. From MSECAT - Search Custom Attribute Types, select New.
2. From MSECAT - Create Custom Attribute Types, enter data in the following fields:
Name
Label
Data Type
3. Select Add to create a new grid row.
4. Perform one of the following steps:
a. If the Data Type is Integer/Decimal, enter data in the following additional fields:
Start Value
End Value
b. If the Data Type is Decimal, enter data in the additional field:
Scale
c. If the Data Type is String, enter data in the additional field:
Field Length
d. If the Data Type is List, a List Values tab displays.
1. Select Add.
2. Enter data in the following fields:
Sequence
Code
Description
5. Select Add in the Categories tab to add a custom category to the attribute type. This is
used to group an attribute type with other related attribute types.
6. Enter data in the Category Name field.
7. Select Add in the Validation tab to add a literal value to a customer-defined attribute type
for validation purposes.
Service Name
Service Operation
Service Field
Literal
Service Field (related to the Literal)
8. Click Submit..
The attribute type is added as a customer-defined type.
28
Ellipse Screen Personalisation
Activity Steps
1. From MSECAT - Search Custom Attribute Types search results, select the required item.
2. From MSECAT - Update Custom Attribute Types, modify custom attribute details as
required.
3. Click Submit.
The update is complete.
29
Ellipse Screen Personalisation
Activity Steps
Delete custom attribute type from the search screen:
1. From MSECAT - Search Custom Attribute Types search results, select the required check
boxes against the items.
2. Click Delete.
3. Select Confirm to delete the custom attribute type.
Delete custom attribute type from the detail screen:
1. From MSECAT - Search Custom Attribute Types search results, select the required item.
2. From MSECAT - Update Custom Attribute Types, select Delete.
3. Select Confirm to delete the custom attribute type.
30
Ellipse Screen Personalisation
Activity Steps
1. From MSEATT - Search Service Custom Attributes search results, select the required service.
From MSEATT - Update Service Custom Attributes, select Add.
2. Enter data in the following field:
Attribute Name
Attribute Type
Multiplicity
3. Click Submit.
The customer-defined attribute type created for the service.
31
Ellipse Screen Personalisation
Activity Steps
1. From MSEATT - Search Service Custom Attributes search results, select the required service.
To update custom attribute details:
1. From MSEATT - Update Service Custom Attributes, update details in the following fields in
the grid.
Attribute Type
Multiplicity
2. Click Submit.
To a custom attribute associated with a service:
1. From MSEATT - Update Service Custom Attributes, select delete beside the attribute in the
grid.
Note: You cannot delete the attribute if it is already in use.
2. Click Submit.
32
Ellipse Screen Personalisation
Activity Steps
1. From MSEATT - Search Service Custom Attributes search results, select the required check
boxes in the grid.
2. Select Export.
The service custom attributes are downloaded.
This file can be used to import the service custom attributes to another instance.
33
Ellipse Screen Personalisation
Note: When importing custom attributes, the current system must have the same conditions as
the old system from where the attributes were exported. This includes the same Ellipse EAM
version.
Activity Steps
1. From MSEATT - Search Service Custom Attributes, select Import.
2. Browse for the previously exported file and select OK.
The screen must be refreshed to see the imported service custom attributes.
34
Ellipse Screen Personalisation
35
Ellipse Screen Personalisation
36
Ellipse Screen Personalisation
37
Ellipse Screen Personalisation
Attribute Name
The name of the field attribute to apply to the service.
Attribute Type
The type of attribute to apply to the field. This type needs to be previously defined in MSECAT
and can be a boolean, string, date or integer type.
Multiple Values
Select this check box to create a list of fields instead of a single field. A grid displays into which
you can add multiple values.
38
Ellipse Screen Personalisation
Scope Type
The scope type. Valid options are:
User - the specified user sees the personalised screen as their default screen.
District - users logged into this district see the personalised screen as their default screen.
System - users using this system see the personalised screen as their default screen and the
original screen cannot be accessed by anyone other than the system administrator.
Position - users logged in to this position see the personalised screen as their default
screen.
Global Profile - users belonging to this security global profile see the personalised screen as
their default screen.
Scope Value
The scope value. Entry in this field is only needed if a District or User, Position or Global Profile
has been entered in the Scope Type field.
39
Ellipse Screen Personalisation
Custom Name
A unique name for the personalised screen.
Scope Type
The scope type. Valid options are:
User - the specified user sees the personalised screen as their default screen.
District - users logged into this district see the personalised screen as their default screen.
System - users using this system see the personalised screen as their default screen and the
original screen cannot be accessed by anyone other than the system administrator.
Position - users logged in to this position see the personalised screen as their default
screen.
Global Profile - users belonging to this security global profile see the personalised screen as
their default screen.
Scope Value
The scope value. Entry in this field is only needed if a District or User, Position or Global Profile
has been entered in the Scope Type field.
Active
Indicates if the personalised screen is active or inactive.
40
Ellipse Screen Personalisation
Custom Name
A unique name for the personalised screen.
41
Ellipse Screen Personalisation
Active Flag
Select or clear the check box to activate or deactivate the personalised screen.
42
Ellipse Screen Personalisation
Service Name
The name of the service you want to review.
43
Ellipse Screen Personalisation
Service Name
The name of the service you want to review.
Service Type
The type of the service.
A sub-grouping within Service Name. If there is only one service type, then it has the same name
as the service name.
SUMMARY GRID
Name
The customer-defined name given to the field attribute to be used as part of customising
screens. This displays in the Service Attributes tab of the Personalisation panel.
Name
The customer defined Attribute Type name that defines the properties that are associated with
this field.
It displays under the Attributes tab in the Personalisation pane. For example, Distance
Travelled.
This name comes from MSECAT - Search Custom Attribute Types.
Multiplicity
If selected, more than one entry is valid for this field.
This field impacts how Service Attributes (fields) display in the create and update screens, but
not in the search screen.
In the search screen, the field displays as a single entry field, for example drop-down, check box,
text box, or entry box for the field types date, time, decimal and integer.
In the create and update screens, the field that has Multiplicity selected displays as a grid and
provides the ability to add multiple entries. Examples of this use could be:
The addition of multiple dates to record that a task was performed on each of those dates.
The selection of more than one value from a drop-down list to record a range of tasks that
were performed.
Note: Each field that has Multiplicity is independent of other fields and cannot be linked to
create a table of related column fields.
44
Ellipse Screen Personalisation
Name
The name given to the customer defined attribute type.
Label
This is the customer defined label given to the attribute type.
Category Name
The customer defined name that is used to group related attribute types.
45
Ellipse Screen Personalisation
Attribute Type
The attribute type name. Attribute types can be used when creating custom attributes.
Label
This is the customer defined label given to the attribute type.
Data Type
The attribute type's field data type, for example Date, Decimal, Integer, String, Timestamp, List
or Boolean.
Start Value
The start of the number range that defines the allowable data for the attribute type.
Note: This field only displays for Data Type - Integer or Decimal. Even though Integer values
show decimals, only the integer is used.
End Value
The end of the number range that defines the allowable data for the attribute type.
Note: This field only displays for Data Type - Integer or Decimal. Even though Integer values
show decimals, only the integer is used.
Scale
The allowable variation between numbers of the decimal data type. It is an integer scale with a
minimum value of 1.
Field Length
The maximum number of characters allowable in the string field.
TABS
Categories
List Values
Validation
Categories tab
Category Name
The customer defined name that is used to group related attribute types.
Sequence
A system-defined number displaying the sequence of each item in the list.
46
Ellipse Screen Personalisation
Code
The list value.
Description
A description of the list value.
Validation tab
Service Name
The name of the service against which this attribute type is validated. This field is mandatory if
validation is required.
Service Operation
The type of operation against which this attribute type is validated. This field is mandatory if
validation is required.
Service Field
A reference to a service field that contains values against which the attribute type is validated.
This field is mandatory if validation is required.
Literal
This field provides the ability to input values that are used as part of the validation process.
Service Field
This is a service field that is associated with the literal, for example, District is associated with
the literal R100.
47
Ellipse Screen Personalisation
Note: This screen can only be accessed by the system administrator or an employee who has
been given security access to manage personalisations.
Application Name
The name of the application. For example, MSE600.
Custom Name
A unique name for the personalised screen.
Screen Name
The name of the screen. For example, search, detail, review and so on.
Scope Type
The scope type. Valid options are:
User - the specified user sees the personalised screen as their default screen.
District - users logged into this district see the personalised screen as their default screen.
System - users using this system see the personalised screen as their default screen and the
original screen cannot be accessed by anyone other than the system administrator.
Position - users logged in to this position see the personalised screen as their default
screen.
Global Profile - users belonging to this security global profile see the personalised screen as
their default screen.
Scope Value
The scope value. Entry in this field is only needed if a District or User, Position or Global Profile
has been entered in the Scope Type field.
Active Flag
Indicates if the personalised screen is active or inactive.
48
Ellipse Screen Personalisation
49