Sap Information Container 2
Sap Information Container 2
Sap Information Container 2
Contents
1
Overview ........................................................................................................................ 2
1.1
Usage .................................................................................................................... 2
1.2
Software component .............................................................................................. 2
1.3
Availability .............................................................................................................. 2
1.4
Example of Business Process ................................................................................ 2
Functionality of Information Container ............................................................................. 3
2.1
Framework for categories ....................................................................................... 3
2.2
Creation of entries .................................................................................................. 3
2.3
Sending out entries ................................................................................................ 4
2.4
Displaying Information Container entries ................................................................ 5
2.5
Set back send status .............................................................................................. 5
2.6
Events.................................................................................................................... 5
2.6.1 Add data to store (3701) ..................................................................................... 5
2.6.2 Add data to send (3702) ..................................................................................... 6
2.6.3 Send via RFC (3703).......................................................................................... 6
2.6.4 Send via File (3704) ........................................................................................... 7
2.7
Archiving ................................................................................................................ 8
2.7.1 Archiving Object ................................................................................................. 8
2.7.2 Reports .............................................................................................................. 8
Customizing ................................................................................................................... 9
3.1
Definition of Information Container Categories........................................................ 9
3.2
Customizing of Information Container Categories ................................................... 9
Definition of structures .................................................................................................. 10
4.1
Data of process .................................................................................................... 10
4.2
Data to store ........................................................................................................ 10
4.3
Data to send ........................................................................................................ 10
Implementation of Interface .......................................................................................... 11
5.1
Method IF_FKK_INFCO_TYPE~CHECK_REQUIREMENTS ................................ 11
5.2
Method IF_FKK_INFCO_TYPE~GET_DATA_STORE .......................................... 11
5.3
Method IF_FKK_INFCO_TYPE~GET_DATA_SEND ............................................ 12
5.4
Method IF_FKK_INFCO_TYPE~SEND_VIA_XI .................................................... 13
5.5
Method IF_FKK_INFCO_TYPE~SEND_VIA_WSRM (from EhP5 on) ................... 14
Creation of entries ........................................................................................................ 15
6.1
Method Constructor.............................................................................................. 15
6.2
Method STORE_SINGLE ..................................................................................... 15
6.3
Method SAVE_ALL .............................................................................................. 16
6.4
Method CLEAR_ALL ............................................................................................ 16
Test scenario................................................................................................................ 17
7.1
Test scenario XI ................................................................................................... 17
7.1.1 Inbound XI message ........................................................................................ 17
7.1.2 Proxy implementation of Inbound XI Message .................................................. 17
7.2
Test scenario RFC ............................................................................................... 17
7.3
Test scenario File................................................................................................. 17
Appendix ...................................................................................................................... 18
8.1
Transactions ........................................................................................................ 18
8.2
Tables.................................................................................................................. 18
8.3
Packages ............................................................................................................. 18
Page 1 of 18
1 Overview
1.1 Usage
The Information Container is designed for outgoing messages to external systems.
In the case of XI messages the Information Container should be used for bulk notifications.
1.3 Availability
The framework of the FI-CA Information Container is available with ERP 6.0, EhP2.
An external system sends a collection or disbursement process to the FI-CA system. FI-CA
posts a document. After the posting, the FI-CA processes are doing their work and maybe the
former systems want to know about one of these.
For example, the former system wants to know if after the payment a bank return occurs.
In this case the so called information container category for the bank return 0001 should be
activated. If a bank return then occurs, an entry in the information container will be written
with the relevant return data.
After that, a mass activity sends the bank return data back to the former system.
Page 2 of 18
A short description of the picture (you dont have to understand this at this point of time):
The process is your application. Within this application you want to create an entry in the
Information Container.
Page 3 of 18
Page 4 of 18
2.6 Events
2.6.1 Add data to store (3701)
Interface:
FUNCTION FKK_SAMPLE_3701.
*"-----------------------------------------------------------------*"*"Lokale Schnittstelle:
*" IMPORTING
*"
REFERENCE(IS_DATA_ALL) TYPE ANY
*"
REFERENCE(IV_INFCOTYPE) TYPE INFCOTYPE_KK
*" EXPORTING
*"
REFERENCE(ET_RECEIVERS) TYPE FKKINFCO_RECEIVER_T
*"
REFERENCE(EX_DO_NOT_STORE) TYPE XFELD
*" CHANGING
*"
REFERENCE(CS_DATA_STORE) TYPE ANY
*"
REFERENCE(CV_EXPIRY_DAYS) TYPE INFCOSENDEXPIRYDAYS_KK OPTIONAL
*"-----------------------------------------------------------------IS_DATA_ALL: Structure with data of process
IV_INFCOTYPE: Information container category
Page 5 of 18
ET_RECEIVERS: Table of receivers of the data. With this parameter, you can define
the recipient to whom the data of the information container entries is sent. If several
recipients are specified, the same data is sent to the different recipients. The package
creation within the mass activity considers the recipient and creates different send
packages for each recipient
EX_DO_NOT_STORE: With this flag you can return that no new information
container entry should be created.
CS_DATA_STORE: Here the customer can fill the data, which he wants to store, in
the CI-Include. The industries can also fill the SI includes.
CV_EXPIRY_DAYS: With this parameter you can change the number of days after
which data is no longer sent by the mass activity. In the standard, the value is set to
100 days.
This exit is called after the framework has filled the data to store. The customer can enhance
the data to store CS_DATA_STORE with his data.
The exit is marked so that additional functions are allowed. Therefore the industries can fill
their data to store in the SI includes and the customers can fill their CI include.
With this exit the receivers can also be set. If the customer wants to send out the data to
several receivers, then he can fill the table ET_RECEIVERS at that point in time.
If the customer (or the industry) wants to create an information container entry depending on
other data, then he can set the flag EX_DO_NOT_STORE, if no entry should be created for
the current data.
If the data is not sent out via the mass activity FPINFCO1, the customer can set a date after
which the data should not be sent out anymore. In the standard this is set to 100 days.
Page 6 of 18
*"
REFERENCE(IT_DATA_SEND) TYPE STANDARD TABLE
*"
REFERENCE(IV_INFCOTYPE) TYPE INFCOTYPE_KK
*"
REFERENCE(IV_RECEIVER) TYPE INFCOREC_KK
*"
REFERENCE(IX_SIMU) TYPE XFELD
*" EXPORTING
*"
REFERENCE(EX_SEND_ERROR) TYPE XFELD
*"
REFERENCE(ET_MESSAGES) TYPE FKK_BAL_MSG_T
*"-----------------------------------------------------------------IT_DATA_SEND: Table of data to send
IV_INFCOTYPE: Information container category
IV_RECEIVER: Receiver of the data
IX_SIMU: Flag if the run is started in simulation mode
EX_SEND_ERROR: Flag, if an error occurred
ET_MESSAGES: Table for messages
This exit is called by the mass activity FPINFCO1, if the data should be sent out via RFC. In
this case we dont know the destination and the customer has to call his RFC in his
destination.
Page 7 of 18
2.7 Archiving
2.7.1 Archiving Object
FI_MKKINF
2.7.2 Reports
RFKKINFAR01
RFKKINFAR02
RFKKINFAR03
Archiving
Deleting
Reloading
Page 8 of 18
3 Customizing
3.1 Definition of Information Container Categories
The definitions of the Information Container Categories have to be made by SAP.
Nevertheless the customer can also create his own categories (beginning with Z).
Therefore follow the IMG path: Integration -> Information Container -> Define Information
Container Categories (view V_TFKINFCOT).
The following has to be set:
Category: The category has to begin with the application (e.g. V for Insurance). For
FI-CA this does not have to be done.
Description
Implementing class: The implementing class which implements the interface
IF_FKK_INFCO_TYPE.
Storage type: X (XML string) or D (data container)
Structure of the data of process
Structure of the data to store
Structure of the data to send
Storage type:
We recommend using the XML string.
Only if you have a really large data volume (for example, the structure has some tables within
it), then you should use the data container.
Keep in mind that performance is much better when using the XML string
Page 9 of 18
4 Definition of structures
4.1 Data of process
This structure includes all data that the process wants to provide to the information container.
The structure should include at least the data which should be stored.
But the data can be more than the data to store, because maybe the customer wants to add
his own data from the process data.
Naming convention (if possible):
[Application]INFCO_[Info Container Category]_ALL
For example, for application FS-CD, category V001: FSCDINFCO_V001_ALL
For example, for application FI-CA, category 0001: FKKINFCO_0001_ALL
Page 10 of 18
5 Implementation of Interface
Every category has to implement the interface IF_FKK_INFCO_TYPE.
Therefore create your own class which implements the interface.
Naming convention:
CL_[Application]_INFCO_TYPE_[Info Container Category]
For example, for application FS-CD, category V001: CL_FSCD_INFCO_TYPE_V001
For example, for application FI-CA, category 0001: CL_FKK_INFCO_TYPE_0001
Page 11 of 18
Page 12 of 18
The number of the given database entries (IT_DFKKINFCO) has to be the same as the sum
of the number of data to send (ET_DATA_SEND) and number of obsolete entries
(ET_DFKKINFCO_OBSOLETE).
The method is called during the mass activity for sending out the data (transaction
FPINFCO1).
The number of entries given into the method with IT_DFKKINFCO depends on the type of
sending:
In case of XI or WS-RM:
1 to the XI limit of the mass activity run
In case of RFC:
1 to 50
In case of File:
1 to the database limit of the mass activity run
There are 2 fields for the receiver (IV_RECEIVER and IV RECEIVER_LONG), because with
ERP 6.0, Enhancement Package 4, the receiver field was extended from 3 characters to 60
characters. To be compatible with versions before EhP4, the interface will not be touched. But
the interface got a new field IV_RECEIVER_LONG with 60 characters.
Note: If the receiver is used in the implementation, then always use IV_RECEIVER_LONG
(not IV_RECEIVER)!
The receiver is defined in Customizing (by the customer) and is defined within event 3701.
Page 13 of 18
Page 14 of 18
6 Creation of entries
For the creation of entries the framework offers the class CL_FKK_INFCO_STORE.
This class has 4 methods which are public and you can use.
The recommendation is to create a new function module or method, which calls these 4
methods. The function module/method can then be called from your application to store the
information container entries.
Naming convention for function modules (if possible):
[Application]INFCO_TYPE_[Info Container Category]_STORE
For
example,
for
application
FS-CD,
category
V001:
FSCDINFCO_TYPE_V001_STORE
For example, for application FI-CA, category 0001: FKKINFCO_TYPE_0001_STORE
For your function module you can use the following function groups:
FI-CA: FKKINFCO_TYPE
FS-CD: FSCDINFCO_TYPE
The following 4 methods of class CL_FKK_INFCO_STORE from the framework can be used
for the creation of entries.
Page 15 of 18
Page 16 of 18
7 Test scenario
After sending out the data we should check if the send has worked, that means, that the data
has reached the external system.
In the case of sending out the data via RFC and XI, the default test scenario is that for the
sent data an entry is created in table DFKKINFCOT in the receiving system.
In the case of sending out the data via file, the default test scenario is that the sending data is
transformed to XML data and this data is saved in a file.
In our test scenarios at SAP the sending system and the receiving system are the same.
Page 17 of 18
8 Appendix
8.1 Transactions
FPINFCO1
FPINFCO2
FPINFCO3
8.2 Tables
DFKKINFCO
DFKKINFCOS
DFKKINFCOR
DFKKINFCOT
8.3 Packages
FI-CA Framework: FKKTOOLS
Category 0001: FKKTOOLS
Category 0002: FKKTOOLS
Category V001: VINTEG
Category V002: VINTEG
Category V003: VINTEG
Category V004: VINTEG
Page 18 of 18