General Reference

Asset Strategy Implementation (ASI) System Requirements

License Requirements

The following licenses are required to take full advantage of ASI functionality:

  • Asset Strategy Management
  • SAP Content for ASI

SAP System Requirements

The following SAP system versions are required to update items in SAP with changes made in ASI:

  • To create ASI/ASM objects in SAP and import ASI/ASM objects from SAP: SAP ECC 6.0 - Enhancement Packs (EhP) 1 and above.
  • To update ASI/ASM objects in SAP: SAP ECC 6.0 - Enhancement Packs (EhP) 5 and above.
Note: For supported SAP releases, see the SAP System Requirements section in APM Connect System Requirements.

Additional Components Required

In addition to the basic GE Digital APM system architecture, your system must also contain the following additional components:

  • The Asset Strategy Management (ASM) module. ASI allows you to build Implementation Packages, which are containers of records that dictate the work that you want to perform and the Asset Strategies that contain the original work requests (i.e., Action Revision records). Asset Strategies are created in ASM.
  • An SAP System. The connectivity to SAP is required only if you want to create items such as Maintenance Plans, Maintenance Items, and Task Lists from ASI. To take full advantage of the ASI module, we recommend that you integrate ASI with SAP.

Deploying Asset Strategy Implementation

After you have installed and configured the basic GE Digital APM system architecture, you will need to perform some configuration steps specifically for Asset Strategy Implementation.

Supported Features in APM Now

This GE Digital APM module is not available in the APM Now environment.

ASI Data Model

Like all GE Digital APM modules, Asset Strategy Implementation consists of entity families, relationship families, and business rules. The ASI Overview page in ASI provides you with a custom view of ASI records that exist in the database. This page also helps facilitate the creation of new records.

When attempting to understand and make use of ASI functionality, it can be helpful to visualize the ASI data model. Because you should already be familiar with the concept of records and viewing records in Record Manager, as you attempt to get your bearings in ASI, it may be useful to remember that ASI is simply a customized view of individual records that work together to make up an Implementation Package.

All ASI implementation packages begin with an Implementation Package record. Each Implementation Package record will be linked to:

  • Zero or one SAP System records through the Has SAP System relationship.
  • At least one Asset Strategy record through the Implements Strategy relationship.
  • Zero or more Asset Strategy records through the Implements Secondary Strategy relationship.
  • One or more Action records through the Implements Actions relationship.
  • One or more other records through the Has Work Management Item relationship. These records store the details of work items that you want to implement, either in GE Digital APM or in an external SAP management system.

The following diagram illustrates how families are related to one another within the ASI data model. The boxes represent entity families, and the arrows represent relationship families. You can determine the predecessor and successor in each relationship by the direction of the arrow head. The box to which the arrow is pointing is the successor in the relationship.

ASI URLs

URL Paths for ASI Features

In Asset Strategy Implementation, there is one route for accessing the overview and one URL base path for building URLs elsewhere in the module: asi/overview. The following table describes the various paths that build on the route, and the elements that you can specify for each.

FeatureURL PathDescription
ASI Overview Pageasi/overviewDisplays the ASI Module Overview page. This path does not accept parameters.
Asset Strategy Implementation Administration Page/strategy/asi/admin Displays the Asset Strategy Implementation Administration page. This path does not accept parameters.
New Implementation Package /asi/package/0Displays the workspace for a new Implementation Package.
Specific Implementation Package /asi/package/<EntityKey>Displays the Implementation Package connected to the specific entity key.
New Maintenance Plan for a Specific Implementation Package/asi/package/<EntityKey>/wmi/0Displays the workspace for a new Maintenance Plan within an existing Implementation Package.
New Child Record for a Specific WMI in a Package/asi/package/<EntityKey>/wmi/{wmikey}/new/{type}Displays the workspace for a new child record under the specified WMI.

Example URLs

Example URL Destination
asi/overviewDisplays the ASI Module Overview page.
/strategy/asi/admin Displays the Asset Strategy Implementation Administration page.
/asi/package/0Displays the workspace for a new Implementation Package.
/asi/package/0228198107Displays the Implementation Package connected to the specified entity key.
asi/package/64252712975/wmi/64259880695/new/MI_MAINTITMDisplays the child task connected to the specified WMI.

About the ASI for SAP ABAP Add-on

GE Digital APM ASI for SAP extends the basic functionality of Asset Strategy Implementation (ASI) by offering integration with SAP. Deploying ASI for SAP requires two steps:

  • Activating the ASI for SAP license in the GE Digital APM database. This documentation assumes that you activated the license when you completed the steps for creating or upgrading your GE Digital APM database.
  • Deploying the ASI for SAP ABAP add-on, which is a package that must be deployed on your SAP system to allow for integration between your GE Digital APM system and your SAP system.

The files necessary to deploy ASI for SAP are provided on the ASI for SAP ABAP Add-on DVD, which is not included in the standard GE Digital APM distribution but can be obtained from GE Digital APM upon request.

The ASI for SAP ABAP Add-on DVD contains installation files, upgrade files, and exchange files. In this documentation, we provide details on using the installation and upgrade files. You will need to use the exchange files if you upgrade an SAP system on which the ASI for SAP ABAP Add-on package has been installed. In that case, the SAP upgrade procedure will prompt you to access the exchange files for ASI for SAP. You can find the files in the Exchange Upgrade Files folder on the ASI for SAP ABAP Add-on DVD. Within the Exchange Upgrade Files folder, you will see subfolders representing the version of SAP to which you are upgrading. When prompted for an ASI for SAP exchange file, use the files in these subfolders. This documentation does not provide specific instructions for using these files during an SAP upgrade.

For information about what is included in the ASI ABAP Add-on, see the file SAP_ASI_<version>_ObjectList.pdf, which is located on the ASI for SAP ABAP Add-on installation DVD in the root folder.

System Code Tables Used by ASI

The following table provides a list of the System Code Tables that are used by ASI.

Table ID

Table Description

Function

MI_WKMGMTDF_GROUP

Work Management Item Definition Groups

Used to populate the:

  • Group Name list on the Work Management Item Definition datasheet.
  • Packaging Tasks menu on the Implementation Packaging page in the GE Digital APM application.

MI_OPERTION_CALC

Operation Calc

Used to populate the Calc list on the Operation datasheet.

MI_MAINTPLN_INDICATOR

Maintenance Plan Scheduling Indicator

Used to populate the Scheduling Indicator list on the Maintenance Plan datasheet.

Values Mapped from GE Digital APM to SAP

Values Mapped to SAP Maintenance Plans

The following table explains the Maintenance Plan fields that are used to populate SAP Maintenance Plan fields when you implement an Implementation Package.

GE Digital APM Field CaptionSAP Field IDSAP Field Caption

Authorization Group

BEGRU

Technical Object Authorization Group

Call Confirm

CALL_CONFIRM

Only Create New Call Object After Completing Predecessor

Call Horizon

HORIZ

Call Horizon for Maintenance Plan Calls

Category

MPTYP

Maintenance Plan Category

Counter

POINT

Measuring Point

Cycle Modification Factor

SFAKT

IBIP: Cycle Modification Factor

Description

WPTXT

Maintenance Plan Text

Factory Calendar

FABKL

Factory Calendar Key

ID

WARPL

Maintenance Plan

Interval

ZYKL1

Maintenance Cycle

Interval Description

PAK_TEXT

Text for Maintenance Package/Cycle (Time/Performance)

Interval Unit

ZEIEH

Unit for the Performance of Maintenance Tasks

Maintenance Strategy

WSTRA

Maintenance Strategy

Offset

OFFS1

Maintenance Package Offset

Scheduling Indicator

STICH

Scheduling Indicator

Scheduling Period

ABRHO

Scheduling Period

Scheduling Unit

HUNIT

Unit in Scheduling Interval

Shift Factor for Early Completion

VSNEG

Shift Factor for Early Completion

Shift Factor for Late Completion

VSPOS

Shift Factor for Late Completion

Sort Field

PLAN_SORT

Sort Field for Maintenance Plans

Start Counter

SZAEH

Start Counter Reading

Start Date

STADT

Start Date

Tolerance for Early Completion

TONEG

Tolerance for Early Completion (%)

Tolerance for Late Completion

TOPOS

Tolerance for Late Completion (%)

Values Mapped to SAP Maintenance Items

The following table explains the Maintenance Item fields that are used to populate SAP Maintenance Item fields when you implement an Implementation Package.

GE Digital APM Field CaptionSAP Field IDSAP Field Caption

Activity Type

ILART

Maintenance Activity Type

Assembly

BAUTL

Assembly

Business Area

GSBER

Business Area

Category

MPTYP

Maintenance Plan Category

Equipment

EQUNR

Equipment Number

Functional Location

TPLNR

Functional Location

Group

PLNNR

Key for Task List Group

Group Counter

PLNAL

Group Counter

Item Description

PSTXT

Item Short Text

Maintenance Item

WAPOS

Maintenance Item

Maintenance Planner Group

WPGRP

Planner Group for Customer Service and Plant Maintenance

Maintenance Strategy

WSTRA

Maintenance Strategy

Notification Type

QMART

Notification Type

Order Type

AUART

Order Type

Planning Plant

IWERK

Maintenance Planning Plant

Priority

PRIOK

Priority

System Condition

ANLZU

Overall Condition of Technical System

Work Center

GEWERK

Main Work Center for Maintenance Tasks

Work Center Plant

WERGW

Plant Associated with Main Work Center

Values Mapped to SAP Maintenance Items

The following table explains the Object List Item fields that are used to populate SAP Object List Item fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

Equipment Number

EQUNR

Equipment Number

Functional Location ID

TPLNR

Functional Location

Functional Location Label

STRNO

Functional location Label

Sort Field

SORTF

Object List Sort Field

Values Mapped to SAP Task Lists

The following table explains the Task List fields that are used to populate SAP Task List fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

Assembly

ISTRU

Assembly

Description

KTEXT

Work Center Description

Equipment

EQUNR

Equipment Number

Functional Location

TPLNR

Functional Location

Group

PLNNR

Key for Task List Group

Key Date

STTAG

Key Date

Maintenance Strategy

STRAT

Maintenance Strategy

Planner Group

VAGRP

Responsible Planner Group/Department

Planning Plant

WERKS

Maintenance Planning Plant

Plant

AWERK

Plant

Status

STATU

Status

System Condition

ANLZU

Overall Condition of Technical System

Usage

VERWE

Use by User or System

Work Center

ARBPL

Work Center

Values Mapped to SAP Operations

The following table explains the Operation fields that are used to populate SAP Operation fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

Activity Type

LARNT

Activity Type

Calc

INDET

Key for Calculation

Control Key

STEUS

Control Key

Cost Element

SAKTO

Cost Element

Currency

WAERS

Currency Key

Description

LTXA1

Operation Short Text

Execution Factor

AUFKT

Execution Factor

Material Group

MATKL

Material Group

Normal Duration

DAUNO

IBIP: Normal Operation Duration

Normal Duration Unit

DAUNE

Normal Duration/Unit

Number of Resources

ANZZL

IBIP: Char. - No. of Required Capacity

Operation

VORNR

Operation/Activity Number

Order Quantity

BMEIH

Operation Order Quantity Unit

Order Quantity Unit

BMVRG

IBIP: Purchase Order Quantity Operation

Plant

WERKS

Plant

Purchasing Group

EKGRP

Purchasing Group for External Processing

Purchasing Organization

EKORG

Purchasing Organization

StdTxt

KTSCH

Standard Text Key

Sub Operation

UVORN

Suboperation

System Condition

ANLZU

System Condition

User Field 0

USR00

User Field with 20 Characters

User Field 1

USR01

User Field with 20 Characters

User Field 2

USR02

User Field with 10 Characters

User Field 3

USR03

User Field with 10 Characters

User Field 4

USR04

IBIP: User Field for Quantity (Length 10,3)

User Field 4 Units

USE04

User field: Unit for Quantity Fields

User Field 5

USR05

IBIP: User Field for Quantity (Length 10,3)

User Field 5 Units

USE05

User field: Unit for Quantity Fields

User Field 6

USR06

IBIP: User Field for Values (Length 10,3)

User Field 6 Units

USE06

User field: Unit for Quantity Fields

User Field 7

USR07

IBIP: User Field for Values (Length 10,3)

User Field 7 Units

USE07

User field: Unit for Quantity Fields

User Field 8

USR08

User field for Date

User Field 9

USR09

User field for Date

User Field 10

USR10

User-defined Field: Indicator for Reports

User Field 11

USR11

User-defined Field: Indicator for Reports

User Field Key Word ID

SLWID

Key Word ID for User-defined Fields

Work

ARBEI

IBIP: Operation Labor

Work Center

ARBPL

Work Center

Work Unit

ARBEH

Unit for Work

Values Mapped to SAP Materials

The following table explains the Material fields that are used to populate SAP Material fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

Material Number

IDNRK

Material Number

Quantity

MENGE

Quantity

Values Mapped to SAP PRTs

The following table explains the PRT fields that are used to populate SAP PRT fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

None. The value in the FHMAR field is always set to D.

FHMAR

Production Resources/Tools Category

Control Key

STEUF

Control Key for Management of Production Resources/Tools

Document

DOKNR

Document Number

Document Part

DOKTL

Document Part

Document Type

DOKAR

Document Type

Document Version

DOKVR

Document Version

Item Number

PSNFH

Item Number for Production Resource/Tool

Quantity

MGVGW

Standard Value for PRT Quantity

Quantity Unit

MGEINH

Quantity Unit of Production Resource/Tool

Values Mapped to SAP Maintenance Packages

The following table explains the Maintenance Package fields that are used to populate SAP Maintenance Package fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

Cycle

KTEXTZYK<#>

Note:

<#> is a number between one (1) and 32 that is determined by the sequence of the Operations on the associated Task List, regardless of the Operation  number.

Short Text for the Maintenance Cycle (Time/Performance)

Values Mapped to SAP Notifications

The following table explains the Notification fields that are used to populate SAP Notification fields when you implement an Implementation Package.

GE Digital APM Field Caption

SAP Field ID

SAP Field Caption

Equipment

EQUIPMENT

Equipment Number

Functional Location

FUNCT_LOC

Functional Location

Notification Type

NOTIF_TYPE

Notification Type

Priority

PRIORITY

Priority

Required End Date

DESENDDATE

-AND-

DESENDDATE

Required End Date

-AND-

Required End Time

Required Start Date

DESSTDATE

-AND-

DESSTTIME

Required Start Date

-AND-

Required Start Time

Short Text

SHORT_TEXT

Short Text

None. The value in the NOTIF_DATE field is populated automatically with the date and time that the Notification was created.

NOTIF_DATE

Date of Notification

None. The value in the NOTIFTIME field is populated automatically with the date and time that the Notification was created.

NOTIFTIME

Notification Time

About the Get SAP ID for <Equipment or Functional Location> Query

After providing a prompt for an Entity Key, the query Get SAP ID for Equipment returns the record with the provided Entity Key. In the baseline GE Digital APM database, the query returns records in the Equipment family. This query is not meant to be run on its own. Instead, GE Digital APM runs this query automatically to determine whether to populate the Equipment or Functional Location field when you build Notification or Maintenance Item records from Actions.

When GE Digital APM runs the query, GE Digital APM provides the prompt with the Entity Key of the predecessor record that is linked to the underlying Asset Strategy record:

  • If the Entity Key identifies a record that belongs to the query's source family, the Equipment field in the Notification and Maintenance Item records will be populated automatically with the ID of that record. GE Digital APM uses the value that is returned by the query as the ID. In the baseline query, the query returns the Equipment ID.
  • If the Entity Key does not identify a record that belongs to the query's source family, GE Digital APM runs the query Get SAP ID for Functional Location. If the Entity Key identifies a record that belongs to that query source's family (which is the Functional Location family if you have not modified the query), the Functional Location field in the Notification and Maintenance Item records will be populated automatically with the ID of that record.

For example, suppose an Asset Strategy record is linked to the Equipment record HX-112. If you build a Notification record from an Action that belongs to this Asset Strategy, GE Digital APM will:

  • Identify the Entity Key of the Equipment record HX-112.
  • Supply this Entity Key to the prompt in the Get SAP ID for Equipment query.
  • Identify the Equipment ID returned by the query: HX-112.
  • Populate the Equipment field in the Notification record with HX-112.

You will not need to modify the baseline query if your Asset Strategy records are linked to records in the baseline Equipment or Functional Location family.