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.
Additional Components Required
In addition to the basic 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 APM system architecture, you will need to perform some configuration steps specifically for Asset Strategy Implementation.
ASI Data Model
Like all 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 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.
| Feature | URL Path | Description |
|---|---|---|
| ASI Overview Page | asi/overview | Displays 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/0 | Displays 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/0 | Displays 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/overview | Displays the ASI Module Overview page. |
| /strategy/asi/admin | Displays the Asset Strategy Implementation Administration page. |
| /asi/package/0 | Displays the workspace for a new Implementation Package. |
| /asi/package/0228198107 | Displays the Implementation Package connected to the specified entity key. |
| asi/package/64252712975/wmi/64259880695/new/MI_MAINTITM | Displays the child task connected to the specified WMI. |
About the ASI for SAP ABAP Add-on
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 APM database. This documentation assumes that you activated the license when you completed the steps for creating or upgrading your 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 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 APM distribution but can be obtained from 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:
|
|
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 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.
| APM Field Caption | SAP Field ID | SAP 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.
| APM Field Caption | SAP Field ID | SAP 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 Object List
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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 |
Values Mapped from SAP to APM on Import
Values Mapped from SAP Fields to Maintenance Plans
The following table explains the SAP fields that are used to populate Maintenance Plans fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| BEGRU | Technical Object Authorization Group | Authorization Group |
| CALL_CONFIRM | Only Create New Call Object After Completing Predecessor | Call Confirm |
| HORIZ | Call Horizon for Maintenance Plan Calls | Call Horizon |
| MPTYP | Maintenance Plan Category | Category |
| POINT | Measuring Point | Counter |
| SFAKT | IBIP: Cycle Modification Factor | Cycle Modification Factor |
| WPTXT | Maintenance Plan Text | Description |
| FABKL | Factory Calendar Key | Factory Calendar |
| WARPL | Maintenance Plan | ID |
| ZYKL1 | Maintenance Cycle | Interval |
| PAK_TEXT | Text for Maintenance Package/Cycle (Time/Performance) | Interval Description |
| ZEIEH | Unit for the Performance of Maintenance Tasks | Interval Unit |
| OFFS1 | Maintenance Package Offset | Offset |
| STICH | Scheduling Indicator | Scheduling Indicator |
| ABRHO | Scheduling Period | Scheduling Period |
| HUNIT | Unit in Scheduling Interval | Scheduling Unit |
| VSNEG | Shift Factor for Early Completion | Shift Factor for Early Completion |
| VSPOS | Shift Factor for Late Completion | Shift Factor for Late Completion |
| PLAN_SORT | Sort Field for Maintenance Plans | Sort Field |
| SZAEH | Start Counter Reading | Start Counter |
| STADT | Start Date | Start Date |
| TONEG | Tolerance for Early Completion (%) | Tolerance for Early Completion |
| TOPOS | Tolerance for Late Completion (%) | Tolerance for Late Completion |
| STRAT | Maintenance Strategy | Maintenance Strategy |
| CYCLESEQIND | Cycle Set Sequence | Cycle Set Sequence |
| NUMMER | NA | ID Number |
Values Mapped from SAP Fields to Maintenance Items
The following table explains the SAP fields that are used to populate Maintenance items fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| ILART | Maintenance Activity Type | Activity Type |
| BAUTL | Assembly | Assembly |
| GSBER | Business Area | Business Area |
| MPTYP | Maintenance Plan Category | Category |
| EQUNR | Equipment Number | Equipment |
| TPLNR | Functional Location | Functional Location |
| PSTXT | Item Short Text | Item Description |
| WAPOS | Maintenance Item | Maintenance Item |
| WPGRP | Planner Group for Customer Service and Plant Maintenance | Maintenance Planner Group |
| WSTRA | Maintenance Strategy | Maintenance Strategy |
| QMART | Notification Type | Notification Type |
| AUART | Order Type | Order Type |
| IWERK | Maintenance Planning Plant | Planning Plant |
| PRIOK | Priority | Priority |
| ANLZU | Overall Condition of Technical System | System Condition |
| GEWRK | Main Work Center for Maintenance Tasks | Work Center |
| WERGW | Plant Associated with Main Work Center | Work Center Plant |
| STRNO | Functional Location Label | Functional Location Label |
| EQKTX | Description of technical object | Equipment Description |
| CYCLESEQIND | Cycle Set Sequence | Cycle Set Sequence |
Values Mapped from SAP Fields to Object List
The following table explains the SAP fields that are used to populate Object List fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| EQUNR | Equipment Number | Equipment Number |
| TPLNR | Functional Location | Functional Location ID |
| STRNO | Functional location Label | Functional Location Label |
| SORTF | Object List Sort Field | Sort Field |
| EQKTX | Description of technical object | Equipment Description |
Values Mapped from SAP Fields to Task List
The following table explains the SAP fields that are used to populate Task List fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| ISTRU | Assembly | Assembly |
| KTEXT | Work Center Description | Description |
| EQUNR | Equipment Number | Equipment |
| TPLNR | Functional Location | Functional Location |
| PLNNR | Key for Task List Group | Group |
| STTAG | Key Date | Key Date |
| STRAT | Maintenance Strategy | Maintenance Strategy |
| VAGRP | Responsible Planner Group/Department | Planner Group |
| WERKS | Maintenance Planning Plant | Planning Plant |
| AWERK | Plant | Plant |
| STATU | Status | Status |
| ANLZU | Overall Condition of Technical System | System Condition |
| VERWE | Use by User or System | Usage |
| ARBPL | Work Center | Work Center |
| PLNAL | Group Counter | Group Counter |
| EQKTX | Description of technical object | Equipment Description |
| STRNO | Functional Location Label | Functional Location Label |
Values Mapped from SAP Fields to Operations
The following table explains the SAP fields that are used to populate Operations fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| LARNT | Activity Type | Activity Type |
| INDET | Key for Calculation | Calc |
| STEUS | Control Key | Control Key |
| SAKTO | Cost Element | Cost Element |
| WAERS | Currency Key | Currency |
| LTXA1 | Operation Short Text | Description |
| AUFKT | Execution Factor | Execution Factor |
| MATKL | Material Group | Material Group |
| DAUNO | IBIP: Normal Operation Duration | Normal Duration |
| DAUNE | Normal Duration/Unit | Normal Duration Unit |
| ANZZL | IBIP: Char. - No. of Required Capacity | Number of Resources |
| VORNR | Operation/Activity Number | Operation |
| BMEIH | Operation Order Quantity Unit | Order Quantity |
| BMVRG | IBIP: Purchase Order Quantity Operation | Order Quantity Unit |
| WERKS | Plant | Plant |
| EKGRP | Purchasing Group for External Processing | Purchasing Group |
| EKORG | Purchasing Organization | Purchasing Organization |
| KTSCH | Standard Text Key | StdTxt |
| UVORN | Suboperation | Sub Operation |
| ANLZU | System Condition | System Condition |
| USR00 | User Field with 20 Characters | User Field 0 |
| USR01 | User Field with 20 Characters | User Field 1 |
| USR02 | User Field with 10 Characters | User Field 2 |
| USR03 | User Field with 10 Characters | User Field 3 |
| USR04 | IBIP: User Field for Quantity (Length 10,3) | User Field 4 |
| USE04 | User field: Unit for Quantity Fields | User Field 4 Units |
| USR05 | IBIP: User Field for Quantity (Length 10,3) | User Field 5 |
| USE05 | User field: Unit for Quantity Fields | User Field 5 Units |
| USR06 | IBIP: User Field for Values (Length 10,3) | User Field 6 |
| USE06 | User field: Unit for Quantity Fields | User Field 6 Units |
| USR07 | IBIP: User Field for Values (Length 10,3) | User Field 7 |
| USE07 | User field: Unit for Quantity Fields | User Field 7 Units |
| USR08 | User field for Date | User Field 8 |
| USR09 | User field for Date | User Field 9 |
| USR10 | User-defined Field: Indicator for Reports | User Field 10 |
| USR11 | User-defined Field: Indicator for Reports | User Field 11 |
| SLWID | Key Word ID for User-defined Fields | User Field Key Word ID |
| ARBEI | IBIP: Operation Labor | Work |
| ARBPL | Work Center | Work Center |
| ARBEH | Unit for Work | Work Unit |
Values Mapped from SAP Fields to Materials
The following table explains the SAP fields that are used to populate Materials fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| IDNRK | Material Number | Material Number |
| IMENG | Quantity | Quantity |
| MEINS | Base Unit of Measure | Unit of Measure |
Values Mapped from SAP Fields to PRTs
The following table explains the SAP fields that are used to populate PRTs fields when you import Work Management items from SAP.
Only document type PRTs are supported in APM.| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| STEUF | Control Key for Management of Production Resources/Tools | Control Key |
| DOKNR | Document Number | Document |
| DOKTL | Document Part | Document Part |
| DOKAR | Document Type | Document Type |
| DOKVR | Document Version | Document Version |
| MGVGW | Standard Value for PRT Quantity | Quantity |
| MGEINH | Quantity Unit of Production Resource/Tool | Quantity Unit |
Values Mapped from SAP Fields to Maintenance Packages
The following table explains the SAP fields that are used to populate Maintenance Packages fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| KZYK1 | Short text for the maintenance cycle (time/performance) | Cycle |
| PAKET | Maintenance Package Number | Maintenance Package Number |
| ZYKZT | Maintenance package cycle/offset | Cycle Length |
| ZEIEH | Unit for the performance of maintenance tasks | Cycle UOM |
Values Mapped from SAP Fields to Notifications
The following table explains the SAP fields that are used to populate Notifications fields when you import Work Management items from SAP.
| SAP Field ID | SAP Field Caption | APM Field Caption |
|---|---|---|
| QMNUM | Notification No | Notification Number |
| QMART | Notification Type | Notification Type |
| EQUNR | Equipment Number | Equipment |
| EQKTX | Description of technical object | Equipment Description |
| TPLNR | Functional Location | Functional Location |
| STRNO | Functional Location Label | Functional Location Label |
| QMTXT | Short Text | Short Text |
| PRIOK | Priority | Priority |
| STRMN + STRUR | Required start date + Required start Time | Required Start Date |
| LTRMN + LTRUR | Required end date + Required end Time | Required End Date |
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 APM database, the query returns records in the Equipment family. This query is not meant to be run on its own. Instead, 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 APM runs the query, 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. 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, 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, 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.