General Reference

APM Connect Version Compatibility Table

This topic provides the installation files that are required for an APM Connect installation, and the version structure for APM Connect.

Version Structure

Example:EAMSAPV152
Description:Area of APM Connect (that is, Data Loaders, EAM, M2M)EAM System released against (that is, SAP, SAP PI, Maximo)Architecture ReleaseMajor ReleaseMaintenance or Patch Release

The following are examples of how to interpret the versions.

  • EAM SAP V1.5.0 is the fifth major release on the APM Connect V1.x architecture; it can be applied to the EAM system SAP.
  • EAM SAP V1.5.1 is a maintenance release that can be applied to EAM SAP V1.5.0.
  • DL V1.4.0 is the fourth major release on the APM Connect V1.x architecture.

APM Compatibility Table

This table includes only the APM versions for which a corresponding APM Connect version was released.

Table 1. APM Compatibility Matrix
APM Framework VersionAPM Connect BaseIntegrated Pack VersionSAP ABAP Version
V4.6.10.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.9.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.8.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.7.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.6.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.5.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.4.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.3.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.2.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.1.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.6.0.0.0APM Connect Services V5.1.2.0.0Integration Pack (IP-Release_5_1_2)V7.X
V4.5.0.0.0APM Connect Base V2.0.0UDLP Version:

UDLP V2.9.0 or V2.8.0 or v2.9.0.1 (with ABAP V7.X)

V4.X
Table 2. SAP ABAP Package Certification Matrix
SAP Certificate NumberCertificate Issue DateCertificate Expiration DateSAP VersionABAP Interface Version (as displayed on the certificate)APM Versions
16649June 26, 2020June 25, 2023S4/HANA 1909V4.X4.4.x, 4.5.x, 4.6.x, (UDLP 3.3.0)
13857October 6, 2020October 5, 2023ERP (ECC) 6 EHP8V7.X4.6.x, 5.x
16864January 21, 2021January 20, 2024S4/HANA Cloud Extended Edition 1909V7.X4.5.x*, 4.6.x, 5.x
17051January 21, 2021January 20, 2024S4/HANA 1909V7.X4.5.x*, 4.6.x, 5.x
17336January 21, 2021January 20, 2024S4/HANA Cloud Extended Edition 2020V7.X4.5.x*, 4.6.x, 5.x
17337January 21, 2021January 20, 2024S4/HANA 2020V7.X4.5.x*, 4.6.x, 5.x
20873October 12, 2022October 11, 2025S4/HANA Cloud Extended Edition 2021V7.X4.5.x*, 4.6.x, 5.x
20874October 12, 2022October 11, 2025S4/HANA 2021V7.X4.5.x*, 4.6.x, 5.x
21395July 20, 2023July 20, 2026S4/HANA 2022V7.X4.5.x*, 4.6.x, 5.x
S4/HANA 2023V7.X5.x
Note: *You must have UDLP 2.9.0.1 or later to use APM V4.5.0.0.0 with SAP ABAP packages of certificate numbers 16864, 17051, 17336, 17337, 20873, 20874, and 21395.

The Automatic Data Loader Directories

The automatic data loader job uses directories within the directory identified in the SCAN_DIR parameter to identify the data loader to use for a particular workbook.

Data Loaders and Directories

The following table lists the directories that are created when the job starts that correspond to the various data loaders.
Data Loader NameDirectory Name
APM FamilyManageAPM
Asset Criticality Analysis (ACA)ACADataLoader
Asset Criticality Analysis (ACA Checklist)ACACheckListDataLoader
Asset Ingestion LoaderAssetIngestionLoader
Asset Strategy Management (ASM)ManageASM
Asset Strategy Management (ASM) TemplatesManageAssetStrategyTemplate
CalibrationCalibration Loader
Custom Asset HierarchyCustom Asset Hierarchy Loader
Equipment and Functional LocationManageEquipmentAndFunctionalLocation
Failure Modes and Effects Analysis (FMEA)ManageRCMFMEA
Failure Modes and Effects Analysis (FMEA) Analysis TemplatesManageFMEAAnalysisTemplate
Failure Modes and Effects Analysis (FMEA) Asset TemplatesManageFMEAAssetTemplate
Generation Availability Analysis (GAA) Amplification CodesGAA GADS Amplification Code
Generation Availability Analysis (GAA) Cause CodeGAA GADS Cause Code
Generation Availability Analysis (GAA) EventsGAA Events
GAA Wind Asset HierarchyGAA Wind Asset Hierarchy
GAA Wind EventsGAA Wind Events
GAA Wind Sub Group CapacityGAA Wind Sub Group Capacity
Geographic Information System (GIS)GISDataLoader
HazardsHazards Loader
Inspection Management (IM) AssetsManageInspections
Inspection Management (IM) Functional LocationManageInspectionsFL
Production Loss Analysis (PLA) AdminPLA Admin Data
Production Loss Analysis (PLA) PlanPLA Plan Data
Production Loss Analysis (PLA) Production EventProduction Event Data
Reliability Centered Maintenance (RCM)ManageRCM
RCM Analysis TemplateManageRCMAnalysisTemplate
Risk Based Inspection (RBI) 580ManageRBI580
Risk Based Inspection (RBI) 581ManageRBI581
Risk Based Inspection (RBI) Corrosion LoopLoad RBI Corrosion Loop
Risk MatrixRiskMatrixDataLoader
RoleRoleDataLoader
Root Cause Analysis (RCA)Manage RCA
Rounds Allowable ValuesRounds Allowable Value
Rounds ReadingsRounds Readings
Rounds RoutesRounds Route
Rounds TemplatesRounds MLTG
Tags to Assets RelationshipManageTagLinks
TaxonomyManageTaxonomy
Thickness Monitoring (TM) EquipmentManageTMLGroup
Thickness Monitoring (TM) Functional LocationManageTMLGroupFL
Work HistoryManageWorkHistory

About Time Zone Data

APM stores the dates and times of transactions in Universal Coordinated Time (UTC) format. This enables the data to flow through the system in a single time zone format. APM Connect supports the time zones defined in https://docs.microsoft.com/en-us/previous-versions/windows/embedded/gg154758(v=winembedded.80).

To provide information with the time stamp relevant to your operations, the system converts UTC to your time zone by using the time zone information configured in your user definition.

Important: If you change the time zone information configured in your user definition, all the records will reflect the new time zone.

The following sections contain the time zone considerations relevant to specific systems.

Maximo

APM stores the time stamp associated with the data extracted from Maximo in UTC and displays the time stamp based on your configured time zone.

SAP

SAP provides a set of baseline time zone codes, which contain most of the standard time zones across the world. SAP also provides the ability for administrators to define their own custom time zone, as needed. Before you use a customized time zone, you must configure the timezone_control table in APM Connect to include the customized time zone.

SAP defines two types of time zones:

  • System: This time zone is based on SAP Application Server Operating System and is derived from the context file. You cannot modify this type of time zone.
  • User: This time zone is based on the user who created the SAP record. You can modify and store this type of time zone in the SAP user interface.

APM stores the time stamp associated with the data extracted from SAP in UTC and displays the time stamp based on the time zone configured for the user who created the SAP record.

Note: If the data extracted from SAP contains only the date, then APM will assign the time 00:00:00 and adjust the assigned time with the SAP system or user time zone. This may lead to a date mismatch when you choose to display the data in APM. To prevent this, APM stores the assigned reference time stamp as a string within the data, which is hidden by default. If you need this information, you can configure APM to display the data.

Support for Multiple Source Systems

Whether in a cloud environment or an on-premise installation, APM Connect enables you to connect multiple source systems to a single APM system.

There are occasions when you need to connect multiple source systems to a single APM system. For example, when your company acquires another company, rather than immediately attempting to merge two systems together, you need to keep the systems running separately but want to implement strategies centrally. The two systems might be the same type or of different types. You can configure APM Connect to handle either scenario.

The steps to configure these scenarios is similar to configuring a single system; you repeat the steps that define the EAM system records and, after creating the intermediate repository for the first system, run a job that adds the other systems to the intermediate repository with any required extraction filters.

Multiple Source Systems of the Same Type

This scenario is most useful when you all systems you need to support are the same type. The context file configuration for each source system will look the same for the target APM and APM Connect system for all the source systems. The unique parts of the context file are those that describe the particulars of the source system, for example, the system ID and filters used.

Multiple Source Systems of Different Types

Use this scenario if you need to support multiple disparate systems, for example, an SAP and a Maximo system. In this case, you will need to configure context files for each different type of source system, each pointing to the same target APM and APM Connect system. This does not preclude having multiple systems of a specific type (for example, one SAP, one ServiceMax, and two Maximo).

Considerations

There are some things to consider when connecting multiple source systems to a single APM with APM Connect:

  • You must make sure that each source system has a unique system ID.
  • The logs will contain the messages from all of the source systems. Each message will identify the source system using the system ID.
  • Some source system types have unique requirements that must be performed for each source system. For example, you must run the Static Data job for all SAP systems.
  • Each source system in a cloud environment will need an intermediate repository, even though they are communicating with a single tenant.
  • Do not schedule running the same adapter job types (for example, functional location extractions) simultaneously from different source systems.

Support for Multiple Culture Settings from a Single Source System

APM Connect enables you to send data to APM from a single source system that supports plants using different language or extraction requirements.

Important: This feature is not supported for Technical Characteristics, Work Management, Asset Criticality Analysis, Asset Strategy Management, or Asset Strategy Implementation.

Globalization has increased the need to improve management of assets in different culture settings. Your solution may involve including these new plants in a single source system that communicates with APM but requires the data to be presented to the user in their native language. You can accomplish this by configuring APM Connect so that the plants that require specific languages or extractions appear to be different source systems, one for each language or extraction requirement. This capability provides a better user experience for all users of APM regardless of their location.

A key advantage of this support is that you can combine your source systems and then configure APM Connect to extract the data correctly.

Considerations

  • The user defined in the source system that communicates with APM must use the same decimal notation.
  • You must have unique system IDs and the correct language parameter value or extraction requirements for each plant.
  • You must configure filters to make sure that the data is routed correctly to the specific location.