Skip to end of metadata
Go to start of metadata

The following enterprise services are available with the Information System Integration ES bundle:


All service operations are optimized for synchronous communication between service consumer and service provider.

| Process Component | Business Object | Service Operation | EhP3 | EhP4 | Description |

Business Partner Data Management

Employee

Find Employee by Elements

ECC-SE 603

 

This inbound operation uses selected selection criteria to determine all persons (employees).

If you implement the Defense Forces & Public Security component and have activated the enhancements for this service available for this component, you can use this inbound operation to determine persons, including the Authority, Responsibility, and Activity rankings specified for them.

You can search for employees based on the proficiency of a qualification.

First name, last name, or academic title of person.

You have used the functions of Personnel Administration , Personnel Development , and Defense Forces & Public Security to configure all data required for the selection criteria in the ERP system.

Dependent on the selection criteria entered, the inbound operation reads the objects of object type P (person) and the relevant data records of the following infotypes:
- Personal Data (0002)
- Addresses (0006)
- ADT (1513)


Only employees that have the status Active are returned.

 

 

Read Employee Rank

 

ECC-SE 604

The rank describes which office or service of a public administration a person works for or what their position is. This inbound operation determines rank information for employees ( Employee business object) that were selected via their ID.

Selection criteria are: EmployeeID and the value "ValidityPeriod" of rank assignment.
 If "ValidityPeriod" is not filled as default the time period from current date until open end is used. The objects and relationships shall be found which have the end date or begin date within the specified "ValidityPeriod".

This means for example, if a defense organization wants to assemble a national contingent for a joint NATO task force the operation planner can first use the Service "Find Employee by Elements" for getting all EmployeeIDs. Using the EmployeeIDs you can now display not only the work agreement but the rank and equivalent NATO rank.
To get the NATO equivalent rank information the customer must implement the customer BADI of this Service to read the NATO Rank Values. The customer can also enhance the Proxy structures of this service to add additional fields to input or output.

You have implemented the job index function (infotype 0783) of component Position Budgeting and Control (PA-PM-PB). For more information, see SAP Library under SAP ERP Central Component -> Human Resources -> Personnel Management -> Budget Management -> Position Budgeting and Control.

Human Capital Master Data Management

Employment

Find Employment Country by Employee

ECC-SE 603

 

The Read Employment Country inbound operation reads the relevant country for an employee's employment relationship.

The inbound operation processes the following message types:

- EmploymentCountryByEmployeeQuery
- EmploymentCountryByEmployeeResponse

The message returns the country indicators, sorted using the following criteria:
- WorkAgreement_ID
- Country indicator (The output is based on key dates. The country indicator returned is formatted according to the standard ISO 3166)

 

Work Agreement

Find Work Agreement by Elements

ECC-SE 603

 

The Find Work Agreement by Elements inbound operation reads an employee's WorkAgreement_IDs depending on certain selection criteria.

This inbound operation provides a request message for selecting work agreements by attributes of employees. After the selection, the operation provides a response message in order to deliver the work agreements.

If you want to use the system user (UserAccount_ID) as the selection criterion, you must have maintained the Communication infotype (0105) for your employees in the SAP back-end system.

Organisational Management

Functional Unit

Find Functional Unit Material Requirement by Elements

 

EA-DFPS 604

This inbound operation determines the material requirements (authorized material) of a Functional Unit. The data about authorized material is enhanced with information on authorized/actual comparison results.
Authorized material is used specifically by armed forces, police, and aid organizations for mapping material requirements considered in planning processes, e.g. for planning exercises or operations.  

This inbound operation provides a request message for selecting material requirement information by Functional Unit IDs. After the selection the operation provides a response message in order to deliver the material requirement information as well as authorized/actual comparison results.

For preparing an operation (deployment, disaster relief etc.) the logistics planner needs an authorized-actual-comparison of material to evaluate the logistic situation and to brief his commanding officer. Selecting the ObjectID of a unit, material requirement group and type code, the service provides the logistic assignment (e.g. PlantID, SupplyPlanningAreaID, LocationID), the material requirement assignment, the abstract material (MPO - authorized material of a force element) as well as the total quantities. The latter leverages the authorized-actual-comparison of required material.

Runtime limitation: 
Depending on the system configuration and input parameters, execution of this operation might take longer than 0.5 seconds.

You have used the functions of the component Defense Forces & Public Security to map the authorized material and stock of Functional Units representing non-consumable goods you want to access in the ERP system.

The BAdI for service FunctionalUnitERPMaterialRequirementByElementsQueryResponse_In (/ISDFPS/SE_FU_ERP_MATR_BYE_QR) Business Add-In (BAdI) is available for this operation to enhance this operation to suit your requirements.

 

 

Read Functional Unit

ECC-SE 603

 

This inbound operation determines the following characteristics for Functional Units that are specific for armed forces, police, and aid organizations:
- Operational capability
- Actual readiness in terms of qualification, personnell, and material
- Required operational readiness
- Deployment
- Logistic assigments

This inbound operation provides a request message for selecting the characteristics by Functional Unit IDs. After the selection, the operation provides a response message in order to deliver the characteristics.

You have use the following functions of the component Defense Forces & Public Security to map the characteristics of force elements that you want to access in the ERP system:
- Infotype Characteristics (1950)
- Infotype Classification (1951)
- Infotype Deployment (1952)
- Table /ISDFPS/FORCE]

 

 

Read Functional Unit

 

ECC-SE 604

If an operation planner wants to enhance the operational picture with the capability, readiness level, deployment and logistic assignment of a specific unit (e.g. NAVY vessel, fire fighter brigade, tank battalion, recce company) this service provides the appropriate information after selecting the input parameter SelectionbyFunctionalUnitID.

The inbound operation is used to read the information of the Functional Unit with specified ID.
The service response of "Read Functional Unit" returns the fields for stock element, provision element and real estate element to get relationships of OrganizationalUnits (OU) to the corresponding material management objects.

Stock element means the totality of the relationships of an OU to a plant, storage location, and MRP area, with regard to the management of non-consumable goods. 

Provision element means the totality of the relationships of an OU to a plant, storage location, and MRP area, with regard to the management of individual and bulk consumable goods. 

Infrastructure element means the totality of the relationships of an OU to a plant, MRP area, and storage location for managing the inventory of non-consumable goods that are used to set up the infrastructure.´
Further logistic data provide fields for purchasing party.

 

 

Read Functional Unit Support Assignment

 

EA-DFPS 604

This inbound operation determines assignment information regarding support relationships for Functional Units.
The following support relationships between Functional Units specifically used by armed forces, police, and aid organizations are determined by this operation:
- Supply Relationships in terms of material management
- Maintenance Relationships in terms of plant maintenance
- Services that a Functional Unit provides for other Functional Units (e.g. Medical care)
- Services that a Functional Unit procures from other Functional Units (e.g. Medical care)

You have used the functions of the component Defense Forces & Public Security to map the support relationships and service assignments that you want to access in the ERP system:
- Support relationships between force elements
- Maintenance relationships between force elements
- Service offer (infotype 1953)
- Service provider (infotype 1954)]

 
Example: 
For planning or executing deployment operations the tactical leader needs actual information about supply and maintenance relationships and their directions (in terms of who is supplier for ammunition of frigate A, who is supplied for spare parts by Log battalion B or who maintains the sighting units of tank battalion C, the turbine engines of strike fighter wing D is maintained by whom during a specific time period).
Selecting an ObjectID of a functional unit, supply assignment with optional product category, maintenance assignment with optional damage type and service assignment this service operation provides the appropriate information. It reads either the service offer or service use or both.

 

 

Read Functional Unit Task Organisation Assignment

 

EA-DFPS 604

This inbound operation determines assignment information regarding task organization relationships for Functional Units. Task organization relationships are used specifically by armed forces, police, and aid organizations for mapping temporary changes to organizational and exercise or operation-specific command and control relationships.

Example: 
The service operation reads the Task Organization Relationships (Relationship 809) of a specific Organizational Unit (force element). This service operation enables a GIS User or CCIS operator to get the command relationship (in terms of "who reports to whom / who is Line Manager of") of a specific unit given by the ObjectID. In combination with "Update Functional Unit Task Organisation Assignment" the command relationship of a specific unit (e.g. company, battalion, navy vessel, police unit etc.) could be read and maintained afterwards.

 

 

Update Functional Unit

ECC-SE 603

 

This inbound operation changes characteristics of a structure (force) element (Business Object Functional Unit ). The service operation was modeled as an idempotent service.

This inbound operation supports the message types FunctionalUnitERPUpdateRequest_sync and FunctionalUnitERPUpdateConfirmation_sync with the following values; e.g.:

FunctionalUnit - General characteristics of the structure (force) element from Infotype 1000 and the table /ISDFPS/FORCE
- ID for identifying the last change to these general characteristics
- Object ID of the structure (force) element
- Name of the structure (force) element
- Code that defines the business role of the Organisational Centre
- Code that defines the type of hierarchy relationship between the Organisational Centres
- Indicator that specifies that the Organisational Centre is active
- Level of readiness of the structure (force) element (material, training and personnel)
- Validity period of the structure (force) element


OperationalCapability - Characteristics of the structure (force) element from infotype 1950

OperationalReadiness - Characteristics of the structure (force) element from infotype 1951; Required readiness

Deployment - Characteristics of the structure (force) element from infotype 1952; Geocoordinates (longitude and latitude) of the structure (force) element (subtype 0008); Geolocation (LogFAS) of the structure (force) element (subtype 0008)

You have used the functions of the Organizational Management component or the Defense Forces & Public Security component to map the organizational structures that you want to access in the ERP system.

To be able to use the operation, you must implement the application component Defense Forces & Public Security (IS-DFS).

 

 

Update Functional Unit

 

ECC-SE 604

After using service operation Read Functional Unit and displaying the latest information about a specific unit (e.g. NAVY vessel, fire fighter brigade, tank battalion, recce company), the operation planner changes parameters of readiness level and capability in his control system.
While confirming these changes the inbound operation updates the modified attributes of this Functional Unit in the logistic support system (SAP ERP). It allows updates on stock elements, provision elements, infrastructure elements as well as purchasing party information and further logistic data which are assigned to a Functional Unit. The status can be changed for each relationship and infotype record.

It is only allowed to update storage locations for Functional Units if no inventory or receipts exists.
The service request provides fields for Functional Unit attributes, Operational Capability, Operational Readiness, Deployment (e.g. GeoCoordinates, GeoLocationName etc.), Communication Data (Phone Number etc.), Logistic Assignment, Stock Handling, Provision Handling, Infrastructure Handling as well as Purchase Party.

The service response confirms the updated values and provides the similar fields as the inbound operation.

 

 

Update Functional Unit Maintenance Assignment

 

EA-DFPS 604

The service operation creates or updates the Maintenance Assignments of a Functional Unit of a specific Organizational Unit (force element).
 
This service operation is similar to Update Functional Unit Supply Assignment.

Example: 
A maintenance unit is responsible for the readiness of several emergency vehicles. Due to operational reason the maintenance assignment of a task force has to be changed. This service operation updates immediately the appropriate assignments in the logistic support system.

 

 

Update Functional Unit Service Offer

 

EA-DFPS 604

The inbound operation is used to update the Service Offers of a Functional Unit.
 

Example: 
During a military operation or an emergency situation the Service Offer of a supply unit has to be changed several times depending on the actual requirements.When the modification on operational level is finished this service operation updates accordingly the service offer in the logistic support system.

 

 

Update Functional Unit Supply Assignment

 

EA-DFPS 604

The service operation creates or updates the Supply Assignments of a Functional Unit of a specific Organizational Unit (force element).


Example:
This means, if a deployment is moved to a different area of operation usually the supply assignment (relationship between supporter and consumer for ammunition, gaz, provision etc.) will be changed from the tactical perspective in principle or partly. When adjustments in the operational system are accomplished this service operation updates the supply assignment in the appropriate logistic support system.

 

 

Update Functional Unit Task Organisation Assignment

 

EA-DFPS 604

The service operation creates or updates the Task Organization Relationships (Relationship 809) of a specific Organizational Unit (force element).
After reading the ObjectID of the Functional Unit (force element) with Read Functional Unit Task Organization Assignment this service operation could be used to update the relevant relationship between organizational units.

Example:

Due to tactical reason, the command relationship has to be modified during joint operations. Alpha Company of battalion B will be assigned for a specific operation to battalion C. Therefore Alpha Company becomes temporarily subordinate of battalion C. The service operation updates this new relationship in the logistic support system.

 

Organisational Centre

Find Employee by Elements

ECC-SE 603

 

This inbound operation determines the assigned persons (employees) for an organizational unit (Business Object Organisational Centre).
If you implement the Defense Forces & Public Security component and have activated the enhancements for this service available for this component, you can use this inbound operation to determine the assigned persons (including the Authority, Responsibility, and Activity rankings specified for the positions or persons) for a structure element.
To be able to use the operation for structure elements, you must implement the application component Defense Forces & Public Security (IS-DFS).

 
You have used the functions of the component Organizational Management or Defense Forces & Public Security to map the organizational structures that you want to access in the ERP system.

 
To be able to use the enhancements for the component Defense Forces & Public Security , in the Implementation Guide (IMG) for the ERP system: Cross-Application Components -> Enterprise Services -> Activate Industry Views for Enterprise Services , you must select the entry Defense (5010) .

For the entered Organisational Centre , the inbound operation reads all organizational objects of type O (organizational unit), S (position), and object type P (person/employee) for Personnel Administration, and the relevant data records of the following infotypes:
- Object (1000)
- Relationships (1001)
- Department/Staff (1003)
- Employee Group/Subgroup (1013)
- ADT (1513)
- Command and Control Relationships (1955)
- Relationships Operation/Exercise (1985)
- Temporary Duty and Assignments (0748)

 

 

Find Multiple Hierarchy Level Assignment by Organisational Centre_V1

 

ECC-SE 604

The operational user finds Organizational Centres in an upper and lower hierarchy relationship assigned to an Organisational Centre specified in the selection criteria.
This means, assuming the selected Organizational Unit (ObjectID) is on Company level, then the organizational structure inclusive of the superordinated/subordinated Organizational Units is listed either bottom-up (Company -> Battalion -> Brigade) or top-down (Company -> Platoon -> Squad).

 

 

Find Organisational Centre Basic Data by Elements

ECC-SE 603

 

This inbound operation uses selected selection criteria to determine organizational units (Business Object Organisational Centre ).
If you implement the Defense Forces & Public Security component and have activated the enhancements for this service available for this component, you can use this inbound operation to determine structure elements and their readiness.

To be able to use the operation for structure elements, you must implement the application component Defense Forces & Public Security (IS-DFS) .

 
You have used the functions of the component Organizational Management or Defense Forces & Public Security to map the organizational structures that you want to access in the ERP system.

 
To be able to use the enhancements for the component Defense Forces & Public Security , in the Implementation Guide (IMG) for the ERP system: Cross-Application Components -> Enterprise Services -> Activate Industry Views for Enterprise Services , you must select the entry Defense (5010) .

Dependent on the entered selection criteria, the inbound operation reads the data records for the following infotypes:
- Object (1000)
- Relationships (1001)
- Department/Staff (1003)
- Address (1028)

- Properties (1950); Usage type of the structure element (organizational plan, defense, operation, exercise and task organization)

- Stationing (1952)
- Command and Control Relationships (1955)
- Relationships Operation/Exercise (1985)

 

 

Find Organisational Centre Basic Data by Elements

 

ECC-SE 604

This service operation is used to find Organisational Centre's Basic Data matching the selection criteria.
This means for example, after selecting the input attribute OrganisationalCentreID, the GIS or C2IS operator can display not only the relevant object(s) (ObjectID and / or Name) but the status of each object and relationship.

 

Position

Find Position Basic Data by Elements

ECC-SE 603

 

This inbound operation determines all assigned positions for an organizational unit (Business Object Organisational Centre ).
If you implement the Defense Forces & Public Security component and have activated the enhancements for this service available for this component, you can use this inbound operation to determine the assigned positions, including their Authority, Responsibility, and Activity rankings, for a structure element.

Service Request 
The inbound operation processes the following message types:
- ID of the Organisational Centre for which the data is to be determined
- Indicator that states whether the Organisational Centre is active (If you use the enhancement for the component Defense Forces & Public Security , this operation only searches for objects with the status Active)

The following selection criteria are optional:
- Key for the employee group for which the data is to be determined
- Validity period in which the data is to be read

This message provides the following additional selection criteria for the component Defense Forces & Public Security:
- Usage type of the structure element (This operation supports the following usage types: organizational plan (value 1), defense (value 2), operation (value 3), exercise (value 4), and task organization (value 5). If no usage type is specified, the operation automatically uses the value 1)

Service Response
The message provides the determined positions according to the following criteria:
- ID and description of the position
- Country key and name of country of the position (If you use the enhancements for the component Defense Forces & Public Security , this operation determines the country key via the infotype 1958)

- Key and name of the approval status of the position
- Indicator that states whether the position is Active
- Type and name of the work agreement that is valid for the position
- Validity period of the position

The following criteria are also available for the component Defense Forces & Public Security :
- Usage type of the position
- Lowest and highest Authority, Responsibility, and Activity rankings defined for the position

For the entered Organisational Centre , the inbound operation reads all objects of type S (position) for Organizational Managment and the relevant data records of the following infotypes
- Object (1000)
- Relationships (1001)
- Employee Group/Subgroup (1013)
- Armed Forces-Specific Position Characterisitics (1958)
- Command and Control Relationships (1955)
- Relationships Operation/Exercise (1985)


To be able to use the operation for structure elements, you must implement the application component Defense Forces & Public Security (IS-DFS).

 
You have used the functions of the component Organizational Management or Defense Forces & Public Security to map the organizational structures that you want to access in the ERP system.

 
To be able to use the enhancements for the component Defense Forces & Public Security , in the Implementation Guide (IMG) for the ERP system: Cross-Application Components -> Enterprise Services -> Activate Industry Views for Enterprise Services , you must select the entry Defense (5010) .
You can use the Business Add-In (BAdI) RHOM_POSBD_ELMNT_QR_CONV to enhance this service. The implementation for the enhancements for the component Defense Forces & Public Security are provided inactive. Activate this implementation if you want to use the enhancements.

 

 

Find Position Basic Data by Elements

 

ECC-SE 604

The inbound operation is used to find the basic data of a position matching the selection criteria. It provides new defense-related selection on rank and output of command and control support (Peacetime establishment: A003: O - S; B008: S - P / Operation: A824: O - S; B805: S - P / Exercise: A827: O - S; B825: S - P
This service operation enables the user to display the basic data of positions (authorized personnel) of a unit (e.g. battalion, military vessel, fire fighter brigade etc.) selected by OrganisationalCentreID, ValidityPeriod and RankGroupCode

 

 

Read Position Rank

 

ECC-SE 604

Operators can use the inbound operation ReadPositionRank to read the rank and the equivalent NATO rank of a position (authorized personnel).
Selection criteria are: PositionID and the value "ValidityPeriod" of rank assignment. If "ValidityPeriod" is not filled as default the time period from current date until open end is used. The objects and relationships shall be found which have the end date or begin date within the specified "ValidityPeriod". This means, if you want to assemble a national contingent for a joint NATO task force you can first use the Service Operation "Find Position Basic Data by Elements" for getting PositionID(s). Using the PositionID(s) you can now display not only the position attributes but the required rank(s) and the equivalent NATO rank(s).

Product Data Maintenance

Individual Material

Find Individual Material by Elements_V2

 

SAP APPL 6.04

This service operation allows a maintenance technician to get a list of individual materials based on the selection criteria.

A value must be supplied for the following element:
- MaintenanceAllowedIndicator


This inbound operation supersedes the Find Invidual Material by Elements_V1 service operation.

It contains the following additional elements:
- TypeCodeCategoryCode


Wildcard search is possibe for the following elements:
- MaterialIdl
- SerialId
- ManufacturerInformation
- PartNumberID
- ManufacturerInformation
- SerialID



To be able to use this operation, you must have implemented the Equipment (PM-EQM-EQ) application component and have made the basic Customizing settings for this component and the Plant Maintenance (PM) application component.

 

 

Read Individual Material_V1

 

SAP APPL 6.04

This service operation allows a maintenance planner to retrieve a given existing individual material. This is necessary to either view, change, or update the individual material in question. 
 
The service operation provides the optional defense related output parameters VehicleLicensePlateID, WeaponSystemTypeCode and WeaponSystemTypeName as well as the additional output parameters of Operational Information (User Status and Technical User Status).


Values must be supplied for the following elements:
- IndividualMaterialID
- CategoryCode

This service operation supersedes the service operation IndividualMaterialByIDQueryResponse_In.

The following new elements have been added:
- TypeCode, PlannerGroup
- TextCollection
- SearchText
- Party
- OperationStartDate
- ManufacturingYear
- ManufacturingMonth

  
To be able to use this operation, you must have implemented the Equipment (PM-EQM-EQ) application component and have made the basic Customizing settings for this component and the Plant Maintenance (PM) application component.

 

Material

Read Material Basic Data

 

ECC-SE 604

The Read Material Basic Data inbound service operation reads and returns the detailed information of the basic data of a material with a given ID.

The message type MaterialBasicDataByIDQuery_sync receives the material ID, and the message type MaterialBasicDataByIDResponse_sync returns detailed information on the material including:
- Material ID (ProductInternalID element)
- Material type (MaterialTypeCode element)
- The industry sector to which the material belongs (IndustrialSectorCode element)
- The division with responsibilty for the material belongs (DivisionCode element)
- Material description (SHORT_Description element)
- Global Trade Item number (ProductStandardID element)
- Quantity and unit information

Industry-specific information for Defense Forces & Public Security

This operation determines additional industry-specific information of an material:
- Information on usage as value for planning the authorized materials of an organization
- Assigned NATO Stock Number (NATO-specific alternative material number for standardized and NATO-wide grouping and classification of materials)

- Assigned Reportable Item Code (NATO categorization for devices and personnel required for operations)
- Code for determining whether and how a material can be returned
- Level in the supply chain to which a material can be returned


You have implemented the functions of SAP ERP component Defense Forces & Public Security for using material planning objects and Reportable Item Codes.

You have also maintained the relevant Customizing activities under Defense Forces & Public Security -> Materials Management:
- Return Delivery
NATO Stock Number


To be able to use the enhancements for the component Defense Forces & Public Security , in the Customizing for the ERP system under Activate Industry Views for Enterprise Services , you must select the entry Defense (5010).

 

 

Find Material by Elements

ECC-SE 603

 

Clerks can use this inbound operation to search for materials according to different criteria. They specify the selection criteria as intervals.

They receive a list of all materials with the following data:
- MaterialID
- MaterialDescription
- TypeCode
- MerchandiseTypeCode (only relevant for IS Retail)
- ProductCategory

You can use the following fields as selection criteria:
- MaterialID
- MaterialDescription
- TypeCode
- PreviousName
- GTIN (StandardID)
- MerchandiseTypeCode (only relevant for IS Retail)
- PlantID
- SalesSpec - SalesOrg
- SalesSpec - DistributionChannelCode
- SalesSpec - DivisionCodeProductCategory

 

Search text
The scope of the search includes both short and long texts, as well as most attributes of a material.


Industry-specific information for Defense Forces & Public Security

You can use an abstract material to which the material is assigned in order to plan the authorized materials of an organization as additional search criteria in the query message.
This operation determines an abstract material to which the material is assigned in the response message. You have implemented the functions of SAP ERP component Defense Forces & Public Security for using material planning objects.

To be able to use the enhancements for the component Defense Forces & Public Security , in the Customizing for the ERP system under Activate Industry Views for Enterprise Services , you must select the entry Defense (5010).

 

 

Find Material by Elements

 

ECC-SE 604

The service operation "Find Material by Elements" is enhanced by defense specific optional input node AbstractMaterialID with fields to read the assigned materials (models) of authorized material of a force element (MPO). The output provides a defense related field to get the assignment between material and an abstract material.

Industry-specific information for Defense Forces & Public Security

You can use an abstract material to which the material is assigned in order to plan the authorized materials of an organization as additional search criteria in the query message.
This operation determines an abstract material to which the material is assigned in the response message.
You have implemented the functions of SAP ERP component Defense Forces & Public Security for using material planning objects.

To be able to use the enhancements for the component Defense Forces & Public Security , in the Customizing for the ERP system under Activate Industry Views for Enterprise Services , you must select the entry Defense (5010).