Configuration Guide For PLM System Integration For SAP S/4HANA
Configuration Guide For PLM System Integration For SAP S/4HANA
2 Initial Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
3 PLMSI Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
This guide describes the configuration of PLM system integration for SAP S/4HANA for the integration with an
external PLM system.
For more information about the installation as well as security and operations, refer to the Administration
Guide in the SAP Help Portal.
Product Information
● System administrators
● Technical consultants
● Key users
Make sure you carry out the initial configuration steps outlined here.
Configuration Content
We provide standard content in the form of BC Sets for the integration of an external PLM system.
You can leverage this content for the initial configuration of your SAP system. You can change and extend the
configuration wherever necessary, to fit your needs.
Prerequisites
Before you can activate standard content, you need to carry out the following activity:
Content Activation
1. Use transaction SCPR3 to view the available content in /PLMF/BCS_OVERALL and /PMLS/BCS_CO.
2. Use transaction SCPR20 to select and activate /PLMF/BCS_OVERALL and /PMLS/BCS_CO.
Note
If there are activation issues, please choose the Expert Mode and start the activation again.
3. On the same screen, verify that the activation has been successful.
You can use the built-in content repository DMS_C1_ST to test your content server setup. For more information,
see the chapter Installing the SAP Content Server in the Administration Guide for PLM system integration.
Note
You need to make the following settings to ensure correct data exchange when using the built-in content
repository DMS_C1_ST: Call up the Display Content Repositories: Detail screen and ensure the following
settings are active:
This chapter outlines the configuration activities you need to carry out to make full use of system integration
via this add-on.
You carry out all necessary configuration settings in Customizing under Cross-Application Components
PLM System Integration. Here, you find all necessary customizing activities to configure this add-on.
For general information on Customizing, search for the chapter The IMG Structure on the SAP Help Portal.
Version Configuration
You can configure which scenario is selected for a certain business process (based on a list of pre-defined
scenarios), which key and value mappings are to be used on which fields, and which fixed values (for example,
material industry sector, default document type, default class for documents, and so on) are used.
Value Mapping
This version supports 1:1 value mapping. Use Customizing for Define Domain Model Code Lists [page 5] to
view and enhance the list of fields for which a value mapping is possible.
In this Customizing activity, you define code lists that provide field values for the data exchange between the
SAP system and the external PLM system.
The Meta Domain Model uses code lists to define allowed or expected values for certain fields. These values
can then be used, for example, to map certain values from an external PLM system to the respective values in
the SAP system (for example, material type).
In real-time business scenarios, fields can have different sets of valid values based on the context. For example,
while creating a document in SAP S/4HANA, the list of possible values for DocumentType may be different
from the valid list of DocumentTypes in the external PLM system.
In addition, it's also possible for the source of the valid document types to be different in each of these
scenarios. For example, the list of valid document types for an SAP document can come from the SAP system,
while the list of valid document types for a document from an external PLM system can come from a domain.
This means that the source of valid values is different depending on the software version. Code Lists have been
developed to cater to these scenarios.
Note
Default code lists are provided via BC Sets (see PLMSI Configuration [page 5]). You can enhance and
modify the default code lists.
In this Customizing activity, you carry out a number of definitions for the scenario and version. These settings
are used to differentiate between integration configuration setups.
These settings will be used to distinguish between different sets of integration configurations. A scenario
includes settings for inbound and outbound messages. The external application selects the relevant scenario
either as defined by an incoming message or based on the following attributes:
● External application
● API version
● Component version
● Logical instance
Inbound, the external application is the sending application. Outbound, it’s the receiving application. We
recommend that you follow the following configuration steps in the given order.
Note
Prerequisites
For a specific integration configuration, you first create a scenario and an initial version. Subsequently, you can
create additional scenario versions for each scenario. A scenario version defines a certain set of configurations.
Scenario versions can be maintained independently.
You define specific scenario determination criteria that are used to determine which scenario and scenario
version is used for a specific integration run.
Note
The default setting is Overwrite. This allows that the sending system changes the key mapping, thus
creating a new object for a certain time.
Note
You can find the change number in Create Change Number (transaction CC01) or Display Change
Number (transaction CC03) in the SAP system.
6. If Compatibility Mode is selected, a key mapping is created between inbound object IDs and SAP PLM
entities if existing objects have not been created by the integration and if preconditions are met. You can
set Compatibility Mode as follows:
○ Off - Compatibility mode is inactive. If a key mapping does not exist but the object exists in the SAP
system, then the error message “No integration for bus.ID &1 exists, but the SAP object already exists”
is logged and the process flow is stopped.
Note
The default package size defines the ideal size for packages. Depending on the available data, the
package size may differ.
X X X X SAP_De X
fault
10. Define External System: Here, you define the external system for outbound data transfer. You define the
receiving (target) systems for sending data from the SAP system to an external PLM System.
For an External Logical System and External Application, specify RFC Destination (mandatory), APIVersion
(default is 0), and Component Version. Note that as of release 2.0 FP02, the API version must be 2. For
more information, see Installing PLM System Integration for SAP S/4HANA.
You can designate one logical system to be the default destination for change objects and product versions
by selecting Change Object Default Destination and Product Version Default Destination.
For existing objects by receiving DM object type, the external system configuration is used to determine
the logical instance, RFC destination and external application. The scenario determination logic uses
values from the external system configuration to retrieve the scenario/version that will be used to build up
the payload.
In this Customizing activity, you make the required settings for the number ranges used for generating unique
names for constraints and constraint nets in order to restrict available values.
Prerequisites
● At least one interval should be created. Without an interval for number ranges, constraints and constraint
nets cannot be created and the restriction of available values for characteristics is not possible.
Activities
In this Customizing activity, you make the required settings for the number ranges used for generating unique
names for variant definitions in order to restrict available values.
Prerequisites
● At least one interval should be created. Without an interval for number ranges, variant definitions cannot
be created and the restriction of available values for characteristics is not possible.
Activities
In this Customizing activity, you make the required settings for the number ranges used for generating unique
names for variant options in order to restrict available values.
Prerequisites
● At least one interval should be created. Without an interval for number ranges, variant options cannot be
created and the restriction of available values for characteristics is not possible.
Note: If the length of a variant option ID exceeds the length of the Characteristic Name (ATNAM) field of 30
characters, the ID cannot be used for a variant option. In this case, the number range must be defined in the
Customizing activity Maintain Range: Variant Option ID Number Range. This is then used to determine the
variant option ID name.
Activities
In this Customizing activity, you make the required settings for number ranges for naming variant tables. The
numbers are used to generate unique names for variant tables, which are created for constraints and
constraint nets in order to restrict available values.
Prerequisites
● At least one interval should be created. Without an interval for number ranges, variant tables cannot be
created and the restriction of available values for characteristics is not possible.
Activities
In this Customizing activity, you maintain all necessary definitions to map the change object data from the
Meta Domain Model to the respective SAP change object.
The SAP change object represents a change number from the change master and its revision.
We recommend that you follow the configuration steps below in the given order.
Prerequisites
● You have made all relevant settings in Customizing for Define Domain Model Code Lists [page 5]. You can
add additional values as required before you start mapping or during the mapping process.
● Scenarios and versions have been configured in the system, in Customizing for Define Scenario and
Version [page 6].
● You have maintained a change master (CM) profile in Customizing for Maintain Profile under Cross-
Application Components Engineering Change Management .
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define structure version data. Choose Continue.
2. Define Mapping of Change Object Type: Here, you map a Domain Model change object type to the SAP
change object type.
Choose the Domain Model change type, default authorization group, and Change Master (CM) profile. For
outbound mapping, you can select and set a Default Output Type, and if the Outbound Communication ID
Mode will be defined by the SAP system or the exernal PLM system. You can also set a Valid From date. For
more information on the Valid From date, see Define Scenario and Version [page 6].
You can maintain a change master profile in Customizing for Maintain Profile under Cross-Application
Components Engineering Change Management .
When you integrate the following objects, please ensure that the profile enables ECN usage as outlined in
the table below:
Material BOM SV
Document DV
For mapping during inbound processing (sending from an external PLM system to the SAP system):
○ Change Object Type specifies whether the Domain Model change type is mapped to a change master
(ECN) or a change record.
○ Change Record Type specifies the type for change record. You can maintain change record types in
Customizing for Logistics – General under Product Lifecycle Management (PLM) Change Records
Settings for Engineering Changes Define Engineering Change Record Types .
○ Change Record Responsible sets the Business Partner ID of the person responsible for the change
record if no Business Partner ID can be determined based on information from the external PLM
system.
For mapping during outbound processing (sending from the SAP system to an external PLM system):
○ Default Outbound Type indicates that this is the default CO type. You can set this only once per CO
type.
○ Default Outbound Item Type specifies the default item type for the CO type.
This field is used only for the ECN scenario. For the CR scenario, the Item type is determined based on
the settings in Define Relation Type (when Outbound Relevant is selected).
○ Outbound Communication ID Mode sets how the change object ID is determined:
○ Defined by SAP – The Domain Model ID is sent as the change object ID to the external system
○ Defined by external PLM – The change object is sent with an empty Domain Model ID and external
PLM system sets the change object ID
Note
For change objects, the valid from date is used from the change object payload. For production
operation lists, the valid from date is used from the production operation payload.
3. Define Change Object Status: Here, you define a combination of Domain Model status, maturity code, and
SAP ECN status. If there is a change, the change object status will be modified as set here. Select the
conditions under which the update happens. The following update modes are available:
○ Update always: This value will be updated during create and update actions.
○ Update only when initial: The system sets the planned status only when no status has been set yet for
the document in the SAP system.
○ Ignore during update: You can use this mode to block the configured status value from being used
during the update.
4. Define Inbound Field Mapping and Define Outbound Field Mapping:
Use field mapping to decide how fields from the source structure are transferred to fields in the target
structure. You can use F4 help to find the respective values. The help provides all fields including fields from
the structure and included structures. To define field mapping, you do the following:
○ Choose Create, Update, or Modify in the column MapMode, to define what is valid for this line. (Modify
includes Create and Update).
○ Define an SAP Target structure and SAP Target Attribute to define which field in the SAP system shall
be set
○ Define a source structure and source field to define which data shall be mapped to the target system.
○ Define a conversion in case you want to transform the inbound data before setting it to the target field.
For more information, see BAdI: Define Custom Conversions [page 27].
○ Define a default value if you want to set the standard value in case no data is received in the source
field or if no source field is mapped. Note that you must define a value in internal format.
Field and value mapping supports customer field extensibility by extension fields.
You can select the following structures:
○ SAP Target Structure
○ SAP Target Attribute: Choose F4 to see the available values. If the Overwrite checkbox is selected, the
system uses the stored value instead of an incoming empty value from the payload. This checkbox is
for information purposes only and the setting can't be changed.
○ Domain Model Source Structure: Here you can also use <EXTENSION_FIELDS>
○ Domain Model Source Attribute
○ Conversion: You can use preconfigured as well as customer-specific or target-data-specific
conversions. For more information, see BAdI: Define Custom Conversions [page 27].
You can use <EXTENSION_FIELDS> to map extension fields that are sent from the external PLM system to
a standard field or classification in the SAP system. The name of the extension field must be passed to the
source attribute field.
The assignment is done using standard technical conversion rules. You can define a domain value mapping
in order to do data conversions via tables. You can also define a conversion function. The system offers a
In this Customizing activity, you make the required settings for the document version integration.
You define the mapping of Domain Model document version types to the SAP document types. In addition, you
can define the required details like semantic file types, status and maturity codes, and so on. We recommend
that you follow the configuration steps below in the given order.
Prerequisites
● You have made all relevant settings in Customizing for Define Domain Model Code Lists [page 5]. You can
add additional values as required before you start mapping, or during the mapping process.
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define structure version data. Choose Continue.
2. Map MIME Types: Map the Domain Model MIME types to the file extensions for PLM. You can enter a
workstation application and an SAP storage category. Use the Outbound-Relevant checkbox to define the
mapping in case of outbound requests.
3. Define Mapping of Document Type: Here, you map a Domain Model document type to the SAP document
type.
○ CAD Indicator: Sets the CAD indicator in the document info records for documents of this type to
indicate that a document is managed by CAD integration.
○ Version Schema for Document indicates how version numbers are assigned for the document. Select
External numbering to use the version number from the payload, or Internal numbering for the version
number to be generated internally.
To be able to use internal numbering, in Define Document Types (transaction DC10) configuration must
be set to use internal numbering and internal versioning. This is indicated by setting Number
Assignment to Only internal number assignment and by selecting Version Assigned Automatically for
the document type.
○ Document Version Revision Level indicates that a revision level is automatically assigned for a
document revision. You can only set this if Version Schema for Document is set to Internal numbering.
○ Document Version Attachment: Attach a document version to a change object. This document acts as
a supporting document for the change object:
○ When activated, the document version gets created as an attachment to change object.
○ When deactivated, the document version gets created but without an attachment to the change
object.
4. Define Document Status: Here, you define a combination of status and maturity code. If there is a change,
the document status is modified as set here. Select under which conditions the update happens. The
following update modes are available:
○ Update always: This value will be updated during create and update actions.
○ Update only when initial: The system sets the planned status only when no status has been set yet for
the document in the SAP system.
○ Ignore during update: You can use this mode to block the configured status value from being used
during the update.
Use the Outbound-Relevant checkbox to define the relevant SAP status to DM status & DM maturity
mapping in case of outbound requests.
In this Customizing activity, you assign a factory to an SAP plant. You can use this assignment during product
configuration as part of plant-specific material configuration.
You can assign a combination of factory ID and type to an SAP plant. The assignment enables you to set a
plant-specific status for this assignment in the activity Define Product Version [page 19]. When you create a
product in a specific plant, the status will be mapped according to this assignment. Moreover, you can select
the maintained plant-specific data in field mapping dialogues, for example in Define Inbound Field Mapping for
a product version.
We recommend that you follow the configuration steps below in the given order.
Prerequisites
● You have made all relevant settings in the Customizing for Define Domain Model Code Lists [page 5],
including a Sourcing Strategy Code. You can add additional values as required before you start mapping, or
during the mapping process.
● Scenarios and versions have been configured in Customizing for Define Scenario and Version [page 6].
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario and version for which
you would like to define a factory. Choose Continue.
2. Define Factory Assignment: Here, you assign the factory to an SAP plant. Choose the Domain Model factory
ID and the Domain Model factory type. Then, choose the plant you want to assign. Select the Outbound-
Relevant checkbox if you want to send the data for the factory assignment to an external PLM system
during outbound processing.
Note
You can only enter and save one record for each combination of Plant and Outbound-Relevant.
3. Define Work Area and Work Center: Here, you can map incoming work area data to a work center in the SAP
system. You can use the Domain Model work area ID and type to assign the work center.
Subsequently, you can define a plant-specific status and template material, and define inbound field mapping
for plant data in Define Product Version [page 19].
In this Customizing activity, you maintain all necessary definitions to map the product version data from the
Meta Domain Model to the respective SAP product version.
The SAP product version represents a material from the material master and its revision. We recommend that
you follow the configuration steps below in the given order.
Prerequisites
● You have made all relevant settings in Customizing for Define Domain Model Code Lists [page 5]. You can
add additional values as required before you start mapping, or during the mapping process.
● Scenarios and versions have been configured in the system, in Customizing for Define Scenario and
Version [page 6].
● You have maintained a change master (CM) profile in Customizing for Maintain Profile under Cross-
Application Components Engineering Change Management . Most objects that are received from the
external PLM system include a valid-from date. The SAP system uses this date in combination with the
data from the change master profile to create the change master for the object.
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define product version data. Choose Continue.
2. Define Mapping of Product Type: Here, you map a Domain Model product type to the SAP product type.
Confirm your selections and save. In Workflow for Auto UoM, enter the workflow to be triggered after the
creation of an alternative unit of measure (UoM) (instead of the base UoM of the BOM), as specified by
Create Alternative Product Version UoM under Define Mapping of Structure Type in Customizing activity
Define Structure Version [page 24].
3. Define Product Templates: Here, you define a reference product as a template for a certain product type.
This template will be used during product creation in the SAP system. When a product version is received
for creation in the SAP system, and the data below is missing in the payload, the system will create this
data based on the existing template for the respective product type. The following material views are used:
○ Basic data 1 and 2
○ MRP1
○ MRP2
○ MRP3
○ MRP4
○ Plant Stock Data
However, if this data is already included in the incoming payload, the received data will be used during
creation. If the data is sent later, during update, it will replace the data previously created based on the
template.
If the template comprises plant data, this data will be copied, too, without creating key mapping for the
factory. Therefore, you cannot receive factory data from subsequent payloads from the external PLM
system for this factory. You can customize factory-specific template data in Define Factory [page 18].
4. Define Product Status: Here, you define which combination of status and maturity code results in which
cross-plant product status. Select under which conditions the status is set. The following update modes
are available:
○ Update always: This value will be updated during create and update actions.
○ Update only when initial: The system sets the configured status only when no status has yet been
assigned to the created product in the SAP system.
○ Ignore during update: You can use this mode to block the configured status value from being used
during the update.
Use the Outbound-Relevant checkbox to define the relevant SAP status to DM status and DM maturity
mapping to be sent to an external PLM system during outbound processing.
Note
You can only enter and save one record for each combination of Cross-Plant Product Status and
Outbound-Relevant.
5. Define Factory-Specific Status: Here, you define which combination of status and maturity code results in
which plant-specific status in the SAP system. If you have assigned a factory to an SAP plant in the
Customizing activity Define Factory [page 18], you can set a plant-specific status for this assignment here.
The system will use this status when processing a status record that includes a Domain Model status for a
specific factory. The available update modes and other settings correspond to those described above for
Define Product Status.
6. Define Factory Template Material: Here, you can define a product template for a specific factory. You can
define one template per factory. The system uses this template during the creation of factory data, if no
based-on material is provided as part of incoming data, or as described in the step Define Product
Templates above.
7. Define Factory Template Views: Here, you define which views you want to process when creating a plant-
specific product. These views are maintained in Customizing under Logistics-General Material Master
Field Selection Maintain Field Selection for Data Screens .
Note
The APIs will only create the view if data is provided via field and value mapping. Likewise, if a view
doesn't contain any fields, the view will not be created.
8. Define Inbound Field Mapping and Define Outbound Field Mapping: Use field mapping to decide how fields
from the source structure are transferred to fields in the target structure. You can use F4 help to find the
respective values. The help provides all fields including fields from the structure and included structures.
To define field mapping, you do the following:
○ Choose Create, Update, or Modify in the column MapMode, to define what is valid for this line. (Modify
includes Create and Update).
○ Define an SAP target structure and SAP target attribute to define which field in the SAP system shall
be set.
○ Define a source structure and source field to define which data you want to map to the target system.
Related Information
In this Customizing activity, you make the required settings for routing integration. You define the mapping of
Domain Model production operation list types to the SAP product types and routing types. In addition, you can
define essential control parameters for routing management. We recommend that you follow the configuration
steps below in the given order.
Prerequisites
● You have made all relevant settings in the Customizing for Define Domain Model Code Lists [page 5].
Domain Model code lists have been defined. You can add additional values as required before you start
mapping, or during the mapping process.
● Scenarios and versions have been configured in Customizing activity Define Scenario and Version [page 6].
● You have maintained a change master (CM) profile in Customizing for Maintain Profile under Cross-
Application Components Engineering Change Management . Most objects that are received from the
external PLM system include a valid-from date. The SAP system uses this date in combination with the
data from the change master profile to create the change master for the object. For more information on
the Valid From date, see Define Scenario and Version [page 6].
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define structure version data. Choose Continue.
2. Define Mapping of Production Operation List Type: Here you map a Domain Model production operation list
type to the SAP product type and routing types. Confirm and save your selections.
○ Set default Valid From date. Used if external system does not provide a valid from date. The system
uses a fallback date if you leave this field empty. For more information on the Valid From date, see
Define Scenario and Version [page 6].
For change objects, the valid from date is used from the change object payload. For production
operation list, the valid from date is used from the production operation payload.
○ Enforce Internal Numbering: When this checkbox is selected, internal numbering range will be
consumed to generate the routing group ID for the provided external business ID.
○ Suboperation Mode: Determines how suboperations received from an external PLM system are
handled in the SAP system. Select DM sub-operation as sub-operation for suboperations to be used 1:1,
or select DM sub-operation as operation for suboperations to be flattened and handled as operations.
○ Initial Operation/Activity Number: Sets the first number of the operation.
○ Operation/Activity Increment: Sets the increment for automatically increasing the number for the
operation.
○ Effectivity Type: Here, you can assign an effectivity type to specify that the validity of changes is
determined by the parameters of the effectivity type, instead of by a valid-from date.
○ Model Unit Template ECN: Template change number used to uniquely identify a change master record.
It defines a template change number that is used when operations in a product operation list or bill of
material (BOM) items are received without dedicated model unit effectivity but the object is under
model unit control.
3. Define Production Operation List Status: Here, you define a combination of status and maturity code. In
case of a change, the routing status will be modified as set here. Select the conditions under which the
update happens. The following update modes are available here and in the subsequent activities:
1. Update always: This value will be updated during create and update actions.
2. Update only when initial: The system sets the planned status only when no status has been set yet for
the structure created in the SAP system.
3. Ignore during update: You can use this mode to block the configured status value from being used
during the update.
4. Define Inbound Field Mapping: Here, you use field mapping to decide how fields from the source structure
are transferred to fields in the target structure. You can use F4 help to find the respective values. The help
provides all fields including fields from the structure and included structures. To define field mapping, you
do the following:
○ Choose Create, Update or Modify in the MapMode column to define what is valid for this line. (Modify
includes Create and Update).
○ Define an SAP target structure and SAP target attribute to define which field in the SAP system you
want to set.
○ SAP Target Attribute: Choose F4 to see the available values. If the Overwrite checkbox is selected,
the system uses the stored value instead of an incoming empty value from the payload. This
checkbox is for information purposes only and the setting can't be changed.
○ Define source structure and source field to define which data you want to map to the target system.
○ Define a conversion in case you want to transform the inbound data before setting it to the target field.
For more information, see BAdI: Define Custom Conversions [page 27].
○ Define a default value if you want to set the standard value in case no data is received in the source
field or if no source field is mapped. Note that you must define a value in an internal format.
5. Define DM Parameters Mapping: Here, you define the mapping of DM unit effectivity to effectivity
parameters in the SAP system. You define effectivity parameters in Customizing for Engineering Change
Management under Parameter Effectivity Define Parameters .
In this Customizing activity, you maintain all necessary settings for structure version integration.
You define the mapping of Domain Model structure types to the product types and BOM types. In addition, you
can define essential control parameters for BOM management. You can create plant-specific structure
versions. We recommend that you follow the configuration steps below in the given order.
Prerequisites
● You have made all relevant settings in Customizing for Define Domain Model Code Lists [page 5]. You can
add additional values as required before you start mapping, or during the mapping process, for example a
Default Plant.
● Scenarios and versions have been configured in the system, in the Customizing activity Define Scenario
and Version [page 6].
● You have maintained a change master (CM) profile in Customizing for Maintain Profile under Cross-
Application Components Engineering Change Management .
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define structure version data. Choose Continue.
2. Define Mapping of Structure Type: Here, you map a Domain Model structure type to the SAP product type
and BOM types.
In Default Plant, you can specify the plant to be set by default for a BOM if the Domain Model structure type
is not plant-specific.
Select Create Alternative Product Version UoM to specify that an alternative unit of measure (UoM)
(instead of the base UoM of the BOM) is created in the product of the corresponding BOM item.
If PV Implicit Plant Creation is enabled, then materials are automatically assigned to the plant for a plant-
specific BOM, and the product version is created with one or more plant assignments. All plant-specific
data is transferred from the template product.
In Effectivity Type, you can assign an effectivity type to specify that the validity of changes is determined by
the parameters of the effectivity type, instead of by a valid-from date.
Confirm your selection and save.
Prerequisites
● You have made all relevant settings in Customizing for Define Domain Model Code Lists [page 5]. Domain
Model code lists have been defined. You can add additional values as required before you start mapping, or
during the mapping process.
● Scenarios and versions have been configured in Customizing for Define Scenario and Version [page 6].
● You have maintained a change master (CM) profile in Customizing for Maintain Profile under Cross-
Application Components Engineering Change Management . Most objects that are received from the
external PLM system include a valid-from date. The SAP system uses this date in combination with the
data from the change master profile to create the change master for the object. Confirm and save your
selections.
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define structure version data. Choose Continue.
2. Define Variant Definition Type: Here, you define a variant definition type by class type and change
management (CM) profile.
3. Define Mapping of Variant Definition Status: Here, you define which Domain Model variant definition status
maps to which class status for a class type. In case of a change, the class status will be modified as set
here. Select the conditions under which the update happens. The following update modes are available:
1. Update always: This value will be updated during create and update actions.
2. Update only when initial: The system sets the planned status only when no status has been set yet for
the structure created in the SAP system.
3. Ignore during update: You can use this mode to block the configured status value from being used
during the update.
4. Define Field Value Mapping: Here, you can define value mappings which can be used to define inbound and
outbound field mappings. These are used to map values coming from the external PLM system to values in
the SAP system. You can create or maintain a value mapping ID and assign specific values to this value
mapping ID. You can use preconfigured as well as customer-specific or target-data-specific conversions.
For more information, see BAdI: Define Custom Conversions [page 27].
5. Define Variant Option Type: Here, you map a Domain Model variant data type to the SAP data type. You
specify the attributes of the SAP data type.
○ In the SAP Boolean True and SAP Boolean False fields, you specify the true and false values that are set
in the SAP system for variant options of type Boolean that are loaded from the external PLM system.
You can maintain language-dependent descriptions for the Boolean values in step Define Variant
Option Boolean Value Description.
Note
/PLMF/ES_FVM_CONVERSION
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to extend the preconfigured conversion functions for the integration.
This BAdI offers standard conversions that you can use as a template. You can choose one or several of the
offered conversion possibilities from the value help in the activities Define Inbound Field Mapping and Define
Outbound Field Mapping in Customizing activities, for example Define Product Version. For more information
about the standard settings (filters, single or multiple uses), see the Enhancement Spot Element Definitions tab
in the BAdI Builder (transaction SE18).
● /PLMF/BI_FVM_CONV_CONDENSE: Field and Value Mapping: Condense Values: Use this BAdI to remove
leading and trailing spaces.
● /PLMF/BI_FVM_CONV_ALPHA: Field and Value Mapping: Alpha Conversion: Use this BAdI to convert
incoming data to the internal SAP format, for example, leading zeros: For inbound messages, missing zeros
are added to the input, for outbound messages, zeros from internal table data are removed.
Activities
Example
You need a custom field mapping, for example, the field Labor for a product version. You want to create an
implementation that derives the value via a custom table access.
/PLMF/BD_DV_SET_SAP_KEY
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI).
You can use this BAdI to modify the SAP document version key in order to have control over documents to be
created. The SAP document version key consists of document type, document number, document version, and
document part. It is derived from the business ID.
The BAdI implementations can be filtered by the document version type received in the messages from
external systems.
Prerequisites
The SAP document ID has been derived from the business ID as part of the incoming data flow of document
version creation.
/PLMF/BD_OUTBOUND_CO_ECN
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI).
You can use this BAdI to specify the engineering change numbers (ECN) that are sent as change objects (CO)
to an external PLM system.
Standard Settings
● For which the status is in the list of relevant statuses specified in Define Change Object Define ECN
Status for CO Update in Ext Syst
● Which have not been created in the external PLM system (that is, no key mapping in exists in /PLMF/
CO_KM)
● For which object management records refer to objects integrated by PLMSI, for example, document
version or product version
For more information about the standard settings (filters, single or multiple uses), see the Enhancement Spot
Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
1. In the activity, choose Create. Create the implementation of the enhancement spot.
2. Adapt the data from the template as required.
3. Save your entries.
/PLMF/BD_VC_SELECTION_COND
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI).
You can use this BAdI to modify the selection condition for structure version.
Prerequisites
The incoming Structure Version data must contain a selection condition in the external format.
Activities
/PLMF/BD_POL_SELECTION_COND
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI).
You can use this BAdI to modify the selection condition for production operation list.
Prerequisites
The incoming production operation list data must contain a selection condition in the external format.
You can use these BAdIs to enhance the SAP integration with customer-specific steps after all inbound
processing has been performed.
/PLMF/BD_CO_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all change object processing has been
performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_DV_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all document version processing has been
performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_FC_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all file upload confirmation processing has
been performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
/PLMF_BD_PV_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all product version processing has been
performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note
You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_PV_READ_EXTN_FLD
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all product version processing has been
performed for inbound read request types.
Note
You cannot use this BAdI to change the payload or process structure.
This BAdI offers the example BAdI implementation /PLMV/PV_READ_EXTN_FLD: Product Read Request:
Aggregated Stock Prices. For more information about the standard settings (filters, single or multiple uses), see
the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_PV_KR_CUST_PSTPR_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all product version key reservation
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_POL_CUST_POSTPRC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all production operation list processing has
been performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_SV_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all structure version processing has been
performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
/PLMF/BD_VD_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all variant definition processing has been
performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
This BAdI can raise messages that influence the overall status. Additional messages are added to the existing
messages and are written to the logs after the SAP process flow. The status is set accordingly based on the
error category.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
/PLMF/BD_VO_CUST_POSTPROC_STEP
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to enhance the SAP integration with customer-specific steps after all variant option processing has been
performed for inbound maintain request types.
You can use this BAdI to enhance the SAP integration with customer-specific steps after all change object
processing has been performed for inbound maintain request types.
Note: You cannot use this BAdI to change the payload or process structure.
This BAdI is has no default implementation. For more information about the standard settings (filters, single or
multiple uses), see the Enhancement Spot Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
In this Customizing activity, you set the default processing mode for variant configuration.
Prerequisites
● Scenarios and versions have been configured in the system, in Customizing for Define Scenario and
Version [page 6].
Activities
1. In the dialog box, select a Scenario ID and Scenario Version to specify the scenario ID and version for which
you would like to define structure version data. Choose Continue.
2. Select one of the following processing modes:
○ LO-VC – SAP – Standard Variant Configuration Profile: This is the default value for the configuration.
○ Advanced VC – Advanced Variant Configuration in SAP S/4HANA: This uses the same database tables
for configuration and master data, but has some additional features, for example, this mode allows you
to customize sales, planning, production, and engineering with process and data integration.
/PLMS/BD_CR_RESPONSIBLE
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to change the mapping of a change object (CO) stakeholder to an SAP business partner.
This BAdI offers a default implementation which is called at runtime but can be overridden.
For more information about the standard settings (filters, single or multiple uses), see the Enhancement Spot
Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
You need a custom field mapping, for example, the field Labor for a product version. You want to create an
implementation that derives the value via a custom table access.
/PLMS/BD_OUTBOUND_CO_CR
This Business Add-In (BAdI) is used in the component PLM System Integration (PLMSI). You can use this BAdI
to specify the change records (CR) that are sent as change objects (CO) to an external PLM system.
Standard Settings
● For which the status is in the list of relevant statuses specified in Define Change Object Define CR
Status for CO Update in Ext Syst
● Which have not been created in the external PLM system (that is, no key mapping in exists in /PLMS/
CO_CR_KM)
● For which change items refer to objects integrated by PLMSI, for example, document version or product
version
For more information about the standard settings (filters, single or multiple uses), see the Enhancement Spot
Element Definitions tab in the BAdI Builder (transaction SE18).
Activities
Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:
● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:
● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.
● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.
Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.
Bias-Free Language
SAP supports a culture of diversity and inclusion. Whenever possible, we use unbiased language in our documentation to refer to people of all cultures, ethnicities,
genders, and abilities.
SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.