/
ISMT Note 2022_01_3

ISMT Note 2022_01_3

Document History

Version

Changes

Effective Date

1.0

First approved version

3Keys ISMT Add-On Note 2022_01_3

18-Jan-2022

1.    Overview

This document describes changes in the 3Keys ISMT connector ABAP part.

2.    Description

Improvements for transaction /K3TMT/SN_INFO:

  • Error “Please specify Object Selection criteria” appears on press Multiple selection button at selection screen if both fields Object code (EPC) and Object code (EPC) -multiple are empty. Empty control logic for object code is corrected.

Implementation error

 

Improvements for transaction /K3TMT/REP_MONITOR:

  • New selection screen fields added: Global Location Number, GLN Extension

  • New fields added into report header ALV grid: Location name

  • New function “Change ISMT GUID” added into report item ALV grid toolbar to change report ISMT GUID after data correction process at ISMT system. To use this function report header and item must be in error status and document from ISMT system for old ISMT GUID and new ISMT GUID must be identical.

  • Allow sum for column SGTIN qty at report header ALV grid

  • Cancel button change status of confirmed report item due to ABAP code error. Logic corrected to ignore confirmed part.

New feature

 

Improvements for transaction /K3TMT/RCP_MONITOR:

  • Translation to language RU for selection screen fields skipped – translations added

  • Function “Display document summary” and “Download document summary” return different JSON file – error in ABAP code

  • If Configuration ID field is not specified on selection screen no data is displayed

Implementation error.

 

DISAGGREGATION_DOCUMENT report is not created for empty SGTIN object. Report creation logic was corrected to allow:

  • Use SGTIN object at DISAGGREGATION_DOCUMENT report

  • Empty object allowed for DISAGGREGATION_DOCUMENT report. New parameter NTF_ALLOW_EMPTY_AGGR = X added to allow aggregation with empty parent object.

  • Change rule customizing via transaction /K3TMT/CUST – change mapper class for report DISAGGREGATION_DOCUMENT to new class /K3TMT/CL_UNPACK_ML_MAPPER

New feature.

 

Support SGTIN object with existing hierarchy output as KITU with children at LP_INTRODUCE_GOODS report. Report LP_INTRODUCE_GOODS structure corrected to support child objects for KITU.

The following customizing needs to be done:

  • Add new parameter ITM_AGGR_CHECK_TYPE = 1 via transaction /K3TMT/PARAM. (This parameter defines how system analyzed SGTIN object is parent object for other SGTINs: 1 – GTIN attribute ZRU_AGGR_SGTIN expected; 2 – Check current SGTIN has child object at object hierarchy)

  • Add new attribute ZRU_AGGR_SGTIN into view /STTP/V_PROPNAME via transaction SM30

  • Fill GTIN attribute ZRU_AGGR_SGTIN = X for GTINs need to be displayed as KITU

  • Change rule customizing via transaction /K3TMT/CUST – change mapper class for report LP_INTRODUCE_GOODS to new class /K3TMT/CL_INT_G_ML_MAPPER

New feature.

 

Rule selection from /K3TMT/CONF transaction works incorrectly for event containing objects with different industries due to ABAP code error.

Implementation error.

 

Sequence check logic corrected to delete objects from sequence check table after report confirmation from ISMT system.

Implementation error.

 

Necessary structures and customizing for ISMT report FTS_INTRODUCE_DOCUMENT support added. Mapper class example /K3TMT/CL_FTS_INT_MAPPER added but own class implementation required to fill notification fields correctly. Activate BC set /K3TMT/CUST_ISMT_300_2022_01_03 using transaction SCPR20.

New feature.

 

Documents with ISMT status “IN_PROGRESS” received from ISMT system with program /K3TMT/UD_IN not updated after first download. New logic added to check and update status until document final status. Documents with creation time from week ago to now processed with this status check logic. This overlap value could be redefined with custom value using transaction /K3TMT/PARAM (parameter name UD_IN_PROCESS_OVERLAP, parameter value – overlap value in seconds).

New feature.

 

True API version 4 support added but will not be implemented automatically – manual activities are required.

Both connector part corrections required connector cloud part and connector ABAP part.

In order to setup correct service paths for communication with ISMT system using True API for all industries revision 600 you should update customizing via SM30.

Steps:

  1. Start transaction SM30.

  1. Enter view name /STTP/V_RSRVPATH , press Maintain.

  1. Make the following changes for entries with all industries, RU System NTF , System Rev 600, REST operations CREATE_DOCUMENT, ZZGET_CISES_AGG_LIST, ZZGET_CISES_INFO, ZZGET_CIS_INFO, ZZGET_DOCUMENTS, ZZGET_DOCUMENT_INFO, ZZGET_RECEIPT_INFO, ZZGET_RECEIPT_LIST, ZZGET_UTD_INFO

(for more convenience you could press Selection->By contents and enter all needed restrictions:

Industry = FS

RU Reporting System = NTF

AND RU System Revision = 600 )

CREATE_DOCUMENT        /api/v3/true-api/lk/documents/create?pg=lp

ZZGET_CISES_AGG_LIST    /api/v3/true-api/cises/aggregated/list

ZZGET_CISES_INFO /api/v3/true-api/cises/info

ZZGET_CIS_INFO    /api/v3/true-api/cises/list

ZZGET_DOCUMENTS        /api/v3/true-api/doc/listV2

ZZGET_DOCUMENT_INFO           /api/v3/true-api/documents/{document_id}/info

ZZGET_RECEIPT_INFO      /api/v3/true-api/receipt/{receiptId}/info

ZZGET_RECEIPT_LIST        /api/v4/true-api/receipt/list

ZZGET_UTD_INFO  /api/v3/true-api/documents/edo/tpr/ud

Industry = other value (for example TR)

RU Reporting System = NTF

AND RU System Revision = 600 )

CREATE_DOCUMENT        /api/v3/true-api/lk/documents/create?pg=tires

Repeat for other industry by setting create?pg=  own value for each industry

New feature

3.    Solution

Import related to the transport request.

3.1    Correction instruction ATTP 3.0

Transport request

Description / Dependencies

D14K900218

3Keys ISMT Add-On 3.0 Note 2022_01_03

Required transport D14K900188

3.2    Correction instruction ATTP 3.1

Transport request

Description / Dependencies

D13K900026

3Keys ISMT Add-On 3.1 Note 2022_01_03

Required transport D13K900008

4.    Recommendation

Activate BC set /K3TMT/CUST_ISMT_300_2022_01_03 using transaction SCPR20.

Perform manual activities from True API version 4 support part of description section.

Test corrections from description section

5. Source code objects

Short description

Program

Object type

Object name

Translation for: Data Element Definition

LANG

DTED

/K3TMT/E_ISMT_RCP_NUMBER

Translation for: Data Element Definition

LANG

DTED

/K3TMT/E_ISMT_RCP_NUMBER_SHORT

Translation for: Data Element Definition

LANG

DTED

/K3TMT/E_ISMT_RCP_TYPE

Translation for: Data Element Definition

LANG

DTED

/K3TMT/E_RCPID

Translation for: Report Source Code

LANG

REPS

/K3TMT/RCP_MONITOR

Translation for: Report Texts

LANG

REPT

/K3TMT/RCP_MONITOR

Class Definition (ABAP Objects)

LIMU

CLSD

/K3TMT/CL_DATA_PRVDR_ISMT

Class Definition (ABAP Objects)

LIMU

CLSD

/K3TMT/CL_EVT_PROP_LIST_READER

Class Definition (ABAP Objects)

LIMU

CLSD

/K3TMT/CL_ISMT_STATUS

Class Definition (ABAP Objects)

LIMU

CLSD

/K3TMT/CL_ISMT_UD

Class Definition (ABAP Objects)

LIMU

CLSD

/K3TMT/CL_REP_CONST

Class Definition (ABAP Objects)

LIMU

CLSD

/K3TMT/CL_UI_HELPER

Protected Header (ABAP Objects)

LIMU

CPRO

/K3TMT/CL_DATA_PRVDR_ISMT

Protected Header (ABAP Objects)

LIMU

CPRO

/K3TMT/CL_ISMT_STATUS

Protected Header (ABAP Objects)

LIMU

CPRO

/K3TMT/CL_UI_RCP_MON

Public Header (ABAP Objects)

LIMU

CPUB

/K3TMT/CL_DATA_PRVDR_ISMT

Public Header (ABAP Objects)

LIMU

CPUB

/K3TMT/CL_EVT_PROP_LIST_READER

Public Header (ABAP Objects)

LIMU

CPUB

/K3TMT/CL_ISMT_STATUS

Public Header (ABAP Objects)

LIMU

CPUB

/K3TMT/CL_ISMT_UD

Public Header (ABAP Objects)

LIMU

CPUB

/K3TMT/CL_REP_CONST

Public Header (ABAP Objects)

LIMU

CPUB

/K3TMT/CL_UI_HELPER

Documentation

LIMU

DOCU

NA/K3TMT/COM308

Function Module

LIMU

FUNC

/K3TMT/AIF_RCP_IN_GEN

Function Module

LIMU

FUNC

/K3TMT/AIF_UD_IN_GEN

Single Message

LIMU

MESS

/K3TMT/COM308

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_AIF_REP_PARSER      EXTRACT_DATA

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_AIF_REP_PARSER      PARSE_INTRODUCE_GOODS

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_AIF_REP_PARSER      PARSE_UNPACKING

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     CONSTRUCTOR

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     DETERMINE_DATA_GTIN

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     DETERMINE_SYST_SUBJ_BY_EVENT

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     GET_SGTIN_AGGREGATED

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     POSTPROCESS_DATA

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     POSTPROCESS_DATA_ADD_AGGR

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     PROCESS_DATA

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     PROCESS_HIERARCHY_OBJ

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     ZFILTER_HRY_BY_GTIN

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_DATA_PRVDR_ISMT     ZGET_SGTIN_AGGREGATED

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_EVT_PROP_LIST_READERGET_CERT_DOCUMENT

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_EVT_PROP_LIST_READERGET_CERT_DOC_DATE

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_EVT_PROP_LIST_READERGET_CERT_DOC_NUMBER

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_ISMT_REPORT         CANCEL

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_ISMT_STATUS         GET_STATUS_TEXT

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_ISMT_UD             CALC_UD_IN_STATUS

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_PROC_MNGR_ISMT      CONSTRUCTOR

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_RULES               GET_RULES_CONFIG

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_UI_HELPER           GET_GTIN_DATA

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_UI_RCP_MON          FIELDCATALOG_HDR

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_UI_RCP_MON          ON_DISPLAY_DOC_HEADER

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_UI_RCP_MON          ON_DOWNLD_DOC_CONTENT

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_UI_RCP_MON          ON_DOWNLD_DOC_HEADER

Method (ABAP Objects)

LIMU

METH

/K3TMT/CL_UI_RCP_MON          REFRESH_HEADER

Report Source Code

LIMU

REPS

/K3TMT/RESPONSE_C01

Report Source Code

LIMU

REPS

/K3TMT/SN_INFO_C01

Report Source Code

LIMU

REPS

/K3TMT/SN_INFO_SSC

Table Definition

LIMU

TABD

/K3TMT/S_ALV_HDR_RCP_MONITOR

Table Definition

LIMU

TABD

/K3TMT/S_FTS_INT

Table Definition

LIMU

TABD

/K3TMT/S_FTS_INT_AIF

Table Definition

LIMU

TABD

/K3TMT/S_FTS_INT_DOC

Table Definition

LIMU

TABD

/K3TMT/S_FTS_INT_DOCS

Table Definition

LIMU

TABD

/K3TMT/S_FTS_INT_MSG

Table Definition

LIMU

TABD

/K3TMT/S_FTS_INT_PRODUCT

Table Definition

LIMU

TABD

/K3TMT/S_INT_G_PRODUCT

Table Definition

LIMU

TABD

/K3TMT/S_ISMT_RCP

Table Type Definition

LIMU

TTYD

/K3TMT/T_FTS_INT_PROD_LIST

Class (ABAP Objects)

R3TR

CLAS

/K3TMT/CL_FTS_INT_MAPPER

Class (ABAP Objects)

R3TR

CLAS

/K3TMT/CL_INT_G_ML_MAPPER

Class (ABAP Objects)

R3TR

CLAS

/K3TMT/CL_RR_RU_PROCESS_ATTR

Class (ABAP Objects)

R3TR

CLAS

/K3TMT/CL_UNPACK_ML_MAPPER

Domain

R3TR

DOMA

/K3TMT/D_AGGR_CHK_TYPE

Data Element

R3TR

DTEL

/K3TMT/E_AGGR_CHK_TYPE

BC Set or Customizing Profile

R3TR

SCP1

/K3TMT/CUST_ISMT_300_2022_01_03

Table

R3TR

TABL

/K3TMT/S_FTS_INT_PRODUCT2

Table

R3TR

TABL

/K3TMT/S_FTS_INT_PRODUCT3

Table

R3TR

TABL

/K3TMT/S_INT_G_PRODUCT2

Table

R3TR

TABL

/K3TMT/S_INT_G_PRODUCT3

Table Type

R3TR

TTYP

/K3TMT/T_FTS_INT_PROD_LIST2

Table Type

R3TR

TTYP

/K3TMT/T_FTS_INT_PROD_LIST3

Table Type

R3TR

TTYP

/K3TMT/T_INT_G_PRODUCT2

Table Type

R3TR

TTYP

/K3TMT/T_INT_G_PRODUCT3

 

Related content

Configuration Guide ISMT
Configuration Guide ISMT
Read with this
ISMT Release 2022_01
ISMT Release 2022_01
More like this
ISMT Note 2021_04_1
ISMT Note 2021_04_1
More like this
ISMT Release 2021_04
ISMT Release 2021_04
More like this
ISMT Note 2022_04_1
ISMT Note 2022_04_1
More like this
ISMT Release 2022_02
ISMT Release 2022_02
More like this