Show TOC

 Change Utilities Time Series Item As Bulk

 

To request the change of utilities time series items as bulk.

Technical Data

Entity Type

Service Operation

Software Component Version

IS-UT 606

Release State

released

Technical Name

UtilitiesTimeSeriesERPItemBulkChangeRequest_In

Namespace

http://sap.com/xi/IS-U/Global2

Application Component

IS-U

Web Service Definition (Back End)

ISU_TSITEMCHGBLKRQ

Category

SAP A2A

Direction

inbound

Mode

asynchronous

Idempotency

not applicable

Change/Update Behavior

not applicable

P2P Communication Enabled

yes

Business Context and Use

The Change Utilities Time Series Item as Bulk inbound service operation is used by a third party system (for example, MDUS) to import and modify bulked profile values using the respective profile numbers.

Features

To create the time series values, you must specify the profile ID (UtilitiesTimeSeriesID). You can only specify one status value for the ElementItemStatus.

The upload of profile data is logged using the AMI monitor.

Related Operations

The outbound counterpart for this inbound operation is the UtilitiesTimeSeriesERPItemBUlkCreateConfirmation_Out operation.

Error Handling

The UtilitiesTimeSeriesERPItemBulkChangeRequest_In operation supports Forward Error Handling (FEH). The following error categories are used:

  • DCE.VME: Value mapping error

  • PRE: Processing error

  • PRE.AUE: Authorization error

  • PRE.CVE: Cross validation error

  • PRE.IDE: Identification error

  • PRE.TEE.LRE: Lock request error

  • PRE.VAE: Value error

For more information about individual error categories, see the code list for the global data type LogItemCategoryCode. You can use the global data type catalog (GDT catalog) at https://wiki.sdn.sap.com/wiki/display/GDT/SAP%20Global%20Data%20Type%20Catalog Information published on SAP site to search for additional information about specific fields.

Notes on SAP Implementation

To use this service operation, activate the Utilities business function set (ISU_UTIL_1).

Enhancements

The Business Add-In (BAdI) ISU_SE_TSITEMCHGBLKRCI_ASYN is available for this service operation. You can use this BAdI to create a customer-specific logic for the outbound mapping of application data. This BAdI is found in the enhancement spot ISU_SPOT_SE_TIMESERS.

You can define the AMI monitoring response in the BAdI ISU_SE_TSITEMCHGBLKRCI_ASYN, Method INBOUND_PROCESSING as follows:

  • Log all AMI messages

  • Log AMI messages that contain errors

  • Do not log AMI messages