SAP ABAP IMG Activity BADI_PHIN_TEMPLATES (BAdI: Determination of Copy Reference)

Hierarchy

☛ EA-APPL (Software Component) SAP Enterprise Extension PLM, SCM, Financials
   ⤷ PM-EQM-THO (Application Component) Takeover/Handover of Technical Objects
     ⤷ PHIN (Package) Takeover/Handover of Technical Objects

IMG Activity

ID	BADI_PHIN_TEMPLATES	BAdI: Determination of Copy Reference
Transaction Code	S_E36_82000168	(empty)
Created on	20070823
Customizing Attributes	BADI_PHIN_TEMPLATES	BAdI: Determination of Copy Reference
Customizing Activity	BADI_PHIN_TEMPLATES	BAdI: Determination of Copy Reference

Document

Document Class	SIMG	Hypertext: Object Class - Class to which a document belongs.
Document Name	BADI_PHIN_TEMPLATES

Use

You can use this BAdI to:

• Determine a copy reference for pieces of equipment, functional locations, and equipment BOMs
• Influence which fields should be copied from the copy reference object during technical object creation.

We provide an example implementation that the customer can use to implement customer-specific logic for searching for copy references.

Requirements

You must do one of the following:

• To differentiate between technical objects with and without copy references, enter TEMPL as follows:
• For equipment, in field Technical Identification Number (TIDNR),
• For functional locations, in field Sort (EQFNR).
• For equipment and equipment BOMs, the manufacturer part number (MPN) (MAPAR) must be given.
• For functional locations, the functional location number (TPLNR) must be given.
• You must have created an appropriate user status to ensure that there is exactly one template for each material.

Standard settings

There is no default implementation for this BAdI.

Activities

This BAdI has two methods:

• GET_TEMPLATE
• FILL_ADD_FIELDS_FROM TEMP

You use method GET_TEMPLATE to search for a unique technical object using the given parameters.

Importing parameters:

• IV_OBJECT: determines the type of object indicator (E - Equipment, M - BOM item, L - Functional location).
• IS_PHINT (a line in the PHINT table) contains the corresponding technical object numbers.

Exporting parameters:

• EV_EQUNR: unique equipment number
• ES_ITOB: ITOB structure
• EV_TPLNR: unique functional location number
• ES_STPO: BOM item document structure

Exceptions:

• NOT_FOUND: there is no reference object (copy reference) in the system
• NOT_UNIQUE: there is more than one reference object (copy reference) in the system

You use method FILL_ADD_FIELDS_FROM TEMP to take over additional fields from the copy reference object using the given parameters for a specific technical object (either functional location or piece of equipment or equipment BOM item).

Importing parameters:

• IV_TO_TYP: determines the type of object indicator (E - Equipment, M - BOM item, L - Functional location).
• IS_TEMP_ITOB: ITOB data structure of functional location or equipment to be created.
• IS_TEMP_STPOB: STPOB data structure of equipment BOM item to be created.

Changing parameters:

• CS_GENERAL: General ITOB data passed into the BAPIs for creation of new functional locations and pieces of equipment.
• CS_SPECIFIC_EQ: Specific ITOB data passed into the BAPI for creation of new pieces of equipment.
• CS_SPECIFIC_FL: Specific ITOB data passed into the BAPI for creation of new functional locations.
• CS_STPOB: STPOB data passed into the API for creation of a new equipment BOM item.

Example

Business Attributes

ASAP Roadmap ID	204	Establish Functions and Processes
Mandatory / Optional	2	Optional activity
Critical / Non-Critical	2	Non-critical
Country-Dependency	A	Valid for all countries

Assigned Application Components

Documentation Object Class	Documentation Object Name	Current line number	Application Component	Application Component Name
SIMG	BADI_PHIN_TEMPLATES	0	PRN0000041	Takeover/Handover of Technical Objects

Maintenance Objects

Maintenance object type

E

Business Add-In - Definition

History

Last changed by/on	SAP	20070926
SAP Release Created in	603