How to set up Filters in AIFAEM

[AlexPfeil]

Introduction

In SAP Advanced Event Mesh, there is the possibility to apply filters from consumer side based on the Topic. For example:

Topic: sap/aif/businesspartner/change/<BusinessPartnerGroup>

One Consumer could be only interested in one Group and would subscribe to

sap/aif/businesspartner/change/0001

Other consumers might want to consume everything and subscribe to 

sap/aif/businesspartner/change/>

In some cases, the SAP Event Source might want to filter on Sender Side in order to only send a Subset of the Data in the System. This is possible in AIFAEM and I will show you one way to do it.

Target Message Structure

In my first blog on this topic I have created a simple Business Partner Data Event. Now let´s assume we want to filter based on the Business Partner Group. Since I didn´t have this field in my structure, I simply added it into my Structure:

@EndUserText.label : 'ABUSINESSPARTNER but with less fields'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
define structure zaifaem_abusinesspartner {

  businesspartner         : abap.string(0);
  businesspartnergrouping : abap.string(0);
  firstname               : abap.string(0);
  lastname                : abap.string(0);

}

I also added it into my Structure Mapping Function Module

Also, I want to add another Field to the Target Structure. This filed will control, if an event is sent out or not.

if IGNORE = "X", we want to ignore this Event and not send it to AEM.

Value Mapping Definition

This Value Mapping is intended with a Whitelisting Approach. Unless I maintain something else in the Value Mapping Table, It will map the Default Value "X". For Group 0001 I have maintained an entry with "" (empty), so IGNORE will be empty.

TCode: /N/AIF/VMAP

If you want to do a Blacklisting Appraoch, you just need to remove the Default Value. Then the Value Mapping will map "" as default. Then you can Add Entries with "X" in the right Column and will set IGNORE = "X" for those.

The Value Mapping of Course has to be implemented in the Structure Mapping. Since I want to use a Field from the Target Structure, which will be available after the Structure Mapping 20 (DATA), I added a Structure Mapping 30 to ZAIF_AEM_BUPA_EVENT_MESSAGE

Then I add the Field Mapping for "IGNORE"

 

Check Definition

In the Action I want the AIF to check if the Field "IGNORE" is empty. If yes, it should send the Event to AEM. If not, it should not send it. Therefore I defined a Check in /N/AIF/CUST -> Define Check

For the Warning message just define a message in any message class in SE91

 

Action 

In /N/AIF/CUST -> Define Actions you will need to add the Target Message Type as Main Component Type

For the Standard Action /AIF/AIF_ACTION_CALL_AEM we add this Check

 

Test

Now let´s Test. 

1) Business Partner which should be sent --> 104

2) Business Partner which shouldn´t be sent --> 103

The Info Message we only see with Trace Level 2. You can enable it here:

--> Mass Maintain

3) Other Interfaces

Since we are using the Action for all Interfaces, we have to make sure that other Interfaces without Filter still work. For instance I have another Event for SalesOrders without the "IGNORE" Field:

Expecation is, that AIF will not find the Field and therefore the Check is skipped and the Event is sent out. Let´s try: Changing Sales Order in VA02

AIF: