Administrator Guide Kazakhstan CEDM Connector
- Pavel Kanskov
- Denis Zolotarev
Document History
Version | Changes | Effective Date |
1.0 | First approved version | 01-Feb-2024 |
2.0 | Release RN_2024_02 | 01-May-2024 |
3.0 | Release RN_2024_03 | 01-Aug-2024 |
4.0 | Release RN_2024_04 | 01-Nov-2024 |
- 1 About This Guide
- 2 Installation
- 3 Maintenance and release strategy
- 4 Upgrade
- 5 Security Information
- 6 Uninstalling
- 7 Enhancements of the Solution
About This Guide
This guide is the central starting point for the implementation of the 3Keys Kazakhstan CEDM Add-On. It explains how to install, uninstall and implement the 3Keys Kazakhstan CEDM Add-On and provides security and operations information. Use the Administrator guide to get an overview of 3Keys Kazakhstan CEDM Add-On, its software units, and its scenarios from a technical perspective.
Installation
This section provides information about how to prepare for installation and what to do before and after the installation of 3Keys Kazakhstan CEDM Add-On.
ATTP 3.0 (STTP300)
Software Component Matrix
Software Unit | Installation Package |
SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) | SAPK-300AGINSTTP |
3Keys Kazakhstan Add-On 3.0 | SAPK-300COINK3TKZ |
3Keys Kazakhstan CEDM Add-On 3.0 | SAPK-300COINK3TKZ3 |
Overall Implementation Sequence
The following table describes the overall installation sequence for the 3Keys Kazakhstan CEDM Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes
Step | Action | Remarks |
|---|---|---|
1 | Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 | See SAP Note 2203586 |
2 | Installation of 3Keys Kazakhstan Add-On 3.0 | Import component SAPK-300COINK3TKZ with transaction SAINT in client 000 |
3 | Import workbench transports using transaction STMS:
| Workbench transports contains DDIC changes for additional fields in the table /K3TKZ/OMS_EVT |
4 | Installation of 3Keys Kazakhstan CEDM Add-On 3.0 | Import component SAPK-300COINK3TKZ3 with transaction SAINT in client 000 |
5 | Import workbench transports using transaction STMS:
| Workbench transport contains Release 2024_02 + Note 2024_03_1 + Note 2024_03_2 |
6 | Installation all available releases and notes for 3Keys Kazakhstan CEDM Add-On 3.0 starting from Note 2024_03_03 https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1850015778/Kazakhstan+EDO+Releases | Installation Notes only required if the release is not completed in between two releases |
7 | Activate BC sets offered for 3Keys Kazakhstan Add-On CEDM in target client:
| In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this. |
ATTP 3.1 (STTP300 with support package 01)
Software Component Matrix
Software Unit | Installation Package |
SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 01 | SAPK-300AGINSTTP SAPK-30001INSTTP |
3Keys Kazakhstan Add-On 3.1 | SAPK-301COINK3TKZ |
3Keys Kazakhstan CEDM Add-On 3.1 | SAPK-301COINK3TKZ3 |
Overall Implementation Sequence
The following table describes the overall installation sequence for the 3Keys Kazakhstan CEDM Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes
Step | Action | Remarks |
|---|---|---|
1 | Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 01 | See SAP Note 2203586 |
2 | Installation of 3Keys Kazakhstan Add-On 3.1 | Import component SAPK-301COINK3TKZ with transaction SAINT in client 000 |
3 | Import workbench transports using transaction STMS:
| Workbench transports contains DDIC changes for additional fields in the table /K3TKZ/OMS_EVT |
4 | Installation of 3Keys Kazakhstan CEDM Add-On 3.1 | Import component SAPK-301COINK3TKZ3 with transaction SAINT in client 000 |
5 | Import workbench transports using transaction STMS:
| Workbench transport contains Release 2024_02 + Note 2024_03_1 + Note 2024_03_2 |
6 | Installation all available releases and notes for 3Keys Kazakhstan CEDM Add-On 3.1 starting from from Note 2024_03_03 https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1850015778/Kazakhstan+EDO+Releases | Installation Notes only required if the release is not completed in between two releases |
7 | Activate BC sets offered for 3Keys Kazakhstan Add-On CEDM in target client:
| In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this. |
ATTP 3.2 (STTP300 with support package 02)
Software Component Matrix
Software Unit | Installation Package |
SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 02 | SAPK-300AGINSTTP SAPK-30001INSTTP SAPK-30002INSTTP |
3Keys Kazakhstan Add-On 3.2 | SAPK-302COINK3TKZ |
3Keys Kazakhstan CEDM Add-On 3.2 | SAPK-302COINK3TKZ3 |
Overall Implementation Sequence
The following table describes the overall installation sequence for the 3Keys Kazakhstan CEDM Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes
Step | Action | Remarks |
|---|---|---|
1 | Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 02 | See SAP Note 2203586 |
2 | Installation of 3Keys Kazakhstan Add-On 3.2 | Import component SAPK-302COINK3TKZ with transaction SAINT in client 000 |
3 | Import workbench transports using transaction STMS:
| Workbench transports contains DDIC changes for additional fields in the table /K3TKZ/OMS_EVT |
4 | Installation of 3Keys Kazakhstan CEDM Add-On 3.2 | Import component SAPK-302COINK3TKZ3 with transaction SAINT in client 000 |
5 | Import workbench transports using transaction STMS:
| Workbench transport contains Release 2024_02 + Note 2024_03_1 + Note 2024_03_2 |
6 | Installation all available releases and notes for 3Keys Kazakhstan CEDM Add-On 3.2 starting from Note 2024_03_03 https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1850015778/Kazakhstan+EDO+Releases | Installation Notes only required if the release is not completed in between two releases |
7 | Activate BC sets offered for 3Keys Kazakhstan Add-On CEDM in target client:
| In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this. |
ATTP 3.3 (STTP300 with support package 03)
Software Component Matrix
Software Unit | Installation Package |
SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 03 | SAPK-300AGINSTTP SAPK-30001INSTTP SAPK-30002INSTTP SAPK-30003INSTTP |
3Keys Kazakhstan Add-On 3.3 | SAPK-303COINK3TKZ |
3Keys Kazakhstan CEDM Add-On 3.3 | SAPK-303COINK3TKZ3 |
Overall Implementation Sequence
The following table describes the overall installation sequence for the 3Keys Kazakhstan CEDM Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes
Step | Action | Remarks |
|---|---|---|
1 | Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 03 | See SAP Note 2203586 |
2 | Installation of 3Keys Kazakhstan Add-On 3.3 | Import component SAPK-303COINK3TKZ with transaction SAINT in client 000 |
3 | Import workbench transports using transaction STMS:
| Workbench transports contains DDIC changes for additional fields in the table /K3TKZ/OMS_EVT |
4 | Installation of 3Keys Kazakhstan CEDM Add-On 3.3 | Import component SAPK-303COINK3TKZ3 with transaction SAINT in client 000 |
5 | Import workbench transports using transaction STMS:
| Workbench transport contains Release 2024_02 + Note 2024_03_1 + Note 2024_03_2 |
6 | Installation all available releases and notes for 3Keys Kazakhstan CEDM Add-On 3.3 starting from Note 2024_03_03 https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1850015778/Kazakhstan+EDO+Releases | Installation Notes only required if the release is not completed in between two releases |
7 | Activate BC sets offered for 3Keys Kazakhstan Add-On CEDM in target client:
| In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this. |
ATTP 3.4 (STTP300 with support package 04)
Software Component Matrix
Software Unit | Installation Package |
SAP Advanced Track and Trace for Pharmaceuticals 3.0 (STTP300) with support package 04 | SAPK-300AGINSTTP SAPK-30001INSTTP SAPK-30002INSTTP SAPK-30003INSTTP SAPK-30004INSTTP |
3Keys Kazakhstan Add-On 3.4 | SAPK-304COINK3TKZ |
3Keys Kazakhstan CEDM Add-On 3.4 | SAPK-304COINK3TKZ3 |
Overall Implementation Sequence
The following table describes the overall installation sequence for the 3Keys Kazakhstan CEDM Add-On. This table contains all available software units. However, to implement a specific scenario, you only need a subset of available software units. Some are only required for special processes
Step | Action | Remarks |
|---|---|---|
1 | Installation of SAP Advanced Track and Trace for Pharmaceuticals 3.0 with support package 04 | See SAP Note 2203586 |
2 | Installation of 3Keys Kazakhstan Add-On 3.4 | Import component SAPK-304COINK3TKZ with transaction SAINT in client 000 |
3 | Installation of 3Keys Kazakhstan CEDM Add-On 3.4 | Import component SAPK-304COINK3TKZ3 with transaction SAINT in client 000 |
4 | Installation all available support packages and notes for 3Keys Kazakhstan CEDM Add-On 3.4 starting from Release 2024_04 https://3keys.atlassian.net/wiki/spaces/kazconnector/pages/1850015778/Kazakhstan+EDO+Releases | Installation Notes only required if the release is not completed in between two releases |
5 | Activate BC sets offered for 3Keys Kazakhstan Add-On CEDM in target client:
| In case you encounter issues with activation of a BC set please try to activate the BC set multiple times. In most cases the issue will be solved with this. |
Maintenance and release strategy
The 3Keys Kazakhstan CEDM Add-On follows the release strategy of SAP ATTP. The updates of the 3Keys Kazakhstan CEDM Add-On are provided as a zip file that includes a workbench transport and a PDF file, similar to SAP Notes. A cumulated workbench transport is provided four times per year (on February 1st, May 1st, August 1st, and November 1st) and includes all changes for the last three months (Release for Kazakhstan CEDM Add-On).
Upgrade
This section provides information about how to prepare for upgrade and what to do before and after the upgrade of 3Keys Kazakhstan CEDM Add-On.
The 3Keys Kazakhstan CEDM Add-On must be upgraded with each new ATTP release. Each software component version of the 3Keys Kazakhstan CEDM Add-On includes all changes required to be compatible with a particular ATTP version and service pack. The 3Keys Kazakhstan CEDM Add-On installation package has an overwrite flag active and will overwrite all 3Keys Kazakhstan CEDM Add-On objects that currently exist in the ATTP system. The BC-Set contains all required customizing settings and will overwrite customizing that currently exist in the ATTP system.
Security Information
This section deals with security topics relevant for the 3Keys Kazakhstan CEDM Add-On. The solution is built on an SAP NetWeaver 750 and the SAP Advanced Track and Trace for Pharmaceuticals 3.0 system. Therefore, the corresponding security settings also apply to 3Keys Kazakhstan CEDM Add-On.
Other Required Documents for Security
Resource | Where to Find It |
SAP NetWeaver Security Guide | Go to the SAP Help Portal at loading... | SAP Help Portal and select the appropriate release. The security guide is in the section Security on the product page. |
SAP Advanced Track and Trace for Pharmaceuticals Security Guide | Go to the SAP Help Portal at loading... | SAP Help Portal The security guide is in the section Security in the Administrator’s guide |
Authorization Concept
This section describes the authorizations available in the 3Keys Kazakhstan CEDM Add-On.
The 3Keys Kazakhstan CEDM Add-On allows you to make specific authorization settings for all business entities of the solution. The following sections provide information about the authorization concept and the authorization objects used.
In general, authorization checks are executed when searching, displaying, or updating data within the repository system.
Authorization objects for CEDM
Authorization objects for CEDM Document monitor /K3TKZ/EDO
This authorization object is used to control all CEDM report transaction relevant data based on field action
Authorization Field | Authorization Object Settings |
/K3TKZ/EAC - Document action | Assign * if role should be able to perform all actions or assign specific actions 01 Display 02 Cancel button 03 Approval 04 Sequence check 05 Get Response 06 Send document 07 Reserved 08 Repeat message sending 09 Reset processing status 10 Maintain missing data 11 Reset no response 12 Get response now 13 Change log 14 Navigate to Cockpit object 15 Change CEDM status 21 Display document summary JSON 22 Download document summary JSON 23 Display document details JSON 24 Download document details JSON 31 Display AIF report JSON 32 Download AIF report JSON 33 Message AIF 34 Display processing log 35 Display AIF response JSON 36 Download AIF response JSON 37 Software Version 41 Display AIF XML 42 Download AIF XML 43 Display AIF XML 44 Download AIF XML 45 Update CEDM Status 46 Reject CEDM Document 48 Accept CEDM Document 49 Manual correction 51 Receive inbound 52 Create OMS report 53 Display Certificate 54 Upload Participant/Certificate 55 Upload Configuration 56 Call CEDM API 57 Health Check 58 Display API Audit Log 59 Cost information 60 Reset Event Extensions 61 Change Run Date 62 Delete Draft |
/K3TKZ/ETP - CEDM Document Type | Assign * if role should be able to display all CEDM document types or assign specific CEDM document types, for example: 0001 Act of acceptance Single Distributor 0002 Introduce from EAEU 0003 Import from 3rd country 0004 Withdrawal Notification 0005 Return into circulation Notification 0006 Act internal transfer 0007 Act internal transfer Single distributor 0010 Act of acceptance 0011 Codes transfer from non-resident 0091 OMS Report 0092 Aggregation Edit 6000 New aggregation out of production |
Report / Transaction Authorizations
Authorization checks are run for all transactions or reports with configuration character as follows:
Report | Authorization Object | Authorization Field | Authorization Object Settings |
/K3TKZ/EDO_DISPATCHER | /K3TKZ/EDO | /K3TKZ/EAC | 06 Send document |
/K3TKZ/EDO_RESPONSE | /K3TKZ/EDO | /K3TKZ/EAC | 05 Response |
/K3TKZ/EDO_SN_INFO | /K3TKZ/EDO | /K3TKZ/EAC | 15 Change CEDM status |
/K3TKZ/EDO_MONITOR | /K3TKZ/EDO | /K3TKZ/EAC | 01 Display 02 Cancel button 03 Approval 04 Sequence check 05 Get response 06 Send document 08 Repeat message sending 09 Reset processing status 10 Maintain missing data 11 Reset no response 12 Get response now 13 Change log 14 Navigate to Cockpit object 21 Display document summary JSON 22 Download document summary JSON 23 Display document details JSON 24 Download document details JSON 31 Display AIF report JSON 32 Download AIF report JSON 33 Message AIF 34 Display processing log 35 Display AIF response JSON 36 Download AIF response JSON 37 Software version 43 Display CEDM XML 44 Download CEDM XML 45 Update CEDM status 46 Reject CEDM Document 48 Accept CEDM Document 51 Inbound processing 59 Cost information 60 Reset Event Extensions 62 Delete Draft |
/K3TKZ/EDO_CHANGE | /K3TKZ/EDO | /K3TKZ/EAC | 49 Manual correction 62 Delete Draft |
/K3TKZ/EDO_OMS_REP | /K3TKZ/EDO | /K3TKZ/EAC | 52 Create OMS report |
/K3TKZ/EDO_API_SAAS | /K3TKZ/EDO | /K3TKZ/EAC | 53 Display certificate 54 Upload certificate 55 Upload configuration |
/K3TKZ/EDO_API_TEST | /K3TKZ/EDO | /K3TKZ/EAC | 53 Display certificate 56 Call CEDM API 57 Health check |
/K3TKZ/EDO_API_LOG | /K3TKZ/EDO | /K3TKZ/EAC | 58 Display API Log |
/K3TKZ/EDO_DOC_IN | /K3TKZ/EDO | /K3TKZ/EAC | 51 Inbound processing |
/K3TKZ/EDO_CHANGE_RUN | /K3TKZ/EDO | /K3TKZ/EAC | 61 Change Run Date |
Authorization Object for Interface Processing /AIF/PROC
This authorization object is used to check the user’s authorization for processing a data message to CEDM system. For each CEDM message a corresponding AIF interface is defined
Authorization Field | Authorization Object Settings |
ACTVT - Activity | 60 Import |
/AIF/NS - Namespace | /STTC3 |
/AIF/IF - Interface Name | Assign * if role should be able to process all interfaces or assign specific interface for example ZKZEDO_011 (KZ CEDM Report codes transfer from non-resident) |
/AIF/IFVER - Interface Version | Assign * if role should be able to process all interface versions |
Further authorizations
Authorizations for Maintenance Views
In addition to the authorization object, an authorization group has been assigned to each maintenance view / underlying views of view clusters according to the delivery class:
Delivery class = E / C: Authorization Group = ATTC
Delivery class = A: Authorization Group = ATTO
Delivery class = S: No Authorization Group.
Uninstalling
You can use the SAP Add-On Installation Tool to uninstall add-ons. However, the uninstallation is possible only if the following prerequisites are met for individual add-on components:
You have imported the latest SAINT update (at least SPAM Version 75).
Procedure:
Call the SAP Add-On Installation Tool with the transaction code SAINT in client 000.
Choose the "Uninstallable Components" tab and select the add-on component version K3TKZ3 from the list
To start the uninstallation process, choose "Start".
A confirmation prompt alerts you to possible dangers of the uninstallation and refers to this add-on-specific SAP Note with important information. Be sure to read this SAP Note and follow its instructions.
Define the start options.
Once you have read this SAP Note and followed its instructions, choose "Continue" to start the uninstallation with the chosen start options. To cancel the uninstallation, choose "Cancel".
After you start the uninstall process, the Add-On Installation Tool runs a predefined sequence of phases. Should an error occur in any of these phases, the uninstall process is stopped and the error is described to the extent possible. Once you have corrected the problem, you can choose "Continue" to continue the uninstallation.
At first, the Add-On Installation Tool performs preparation steps and check steps. If errors cannot be corrected in these phases, you can choose "Back" to stop and reset the uninstallation. In later phases, if changes and deletions have already been made in the system, a reset is no longer possible, and the system displays a relevant error message. In this case, the errors must be rectified, and the uninstallation must be completed.
Following the successful uninstallation of the add-on, you can choose "Logs" to display the implementation logs.
To complete the uninstallation, choose "Exit".
Repeat the steps above for component version K3TKZ.
Enhancements of the Solution
Following list of added enhancements:
Enhancement | Description |
/K3TKZ/EH_EDO_COCKPIT_DRLDWN | Simulate object selection |
/K3TKZ/EH_EDO_RULE_PROCESSING | Rule processing for CEDM Notification |