Classification Setup and Management Guide

Once you run the Kernseife Check in your system, you might notice the "Missing Classification" (NOC) Findings. As we try to limit the build-in, hardcoded logic in our check class, we have no default classification behavior, which handles objects that we have not yet in the classification. The Standard Check reports those as "Internal APIs", but our approach is to report them as "Missing Classification" and then the person resonsible to maintain the Kernseife needs to classify them and update the classification. Once you then rerun the check, those findings should disappear and be replaced with proper ones.

This allows the user of Kernseife also to keep track on all SAP Objects used inside their custom code.

On the other side, it requires some additional work and sometimes delays transport releases, as those "Missing Classifications" are Priority 1 and need to be addressed (if you have setup a proper governance).

Important

Please make sure you execute the Intial BTP Setup steps described here.

Setup the initial Classification (Optional)

If you don't want to start with an empty system, we recommend you upload the default classification.

1. Download the Default Classification
2. Logon to your System
3. Run Report ZKNSF_CLASSIFICATION_MANAGR
4. Click on "Upload API File" in the ALV Toolbar
5. Confirm that you want to overwrite the existing classification
6. Select the .json file you downloaded in step 1
7. Run a full system ATC Check

Note

We might provide a Guide on how to run full system ATC Checks in the future. But as this is not something specific to Kernseife it is not currently a priority.

Exporting the Missing Classifications

To extract all the Unclassified objects, we have provided the CDS View ZKNSF_I_MISSING. The easiest way to export it is by using SE16N and the build export function via csv. This will provide you with the proper column names required for the import into the BTP app.

1. Logon to your system
2. Open transaction SE16N
3. Enter ZKNSF_I_MISSING as "Table"
4. Increase the "Max. Number of Hits" to prevent limiting your results
5. Execute (F8)
6. Use the toolbar button "Export" => "Spreadsheet".
7. Make sure "Comma seperated File (.csv)" is selected as format
8. Click "Export To"
9. Store file on your PC

Important

Make sure the correct column names (see below) are present and you are using commas as seperators (not tabs or semi-colons). "objectType","objectName","applicationComponent","subType","softwareComponent","tadirObjectType","tadirObjectName"

Of course you can also use ADT, but keep in mind the data export there is limited to 200k rows (last time I checked).

Note

In the future we plan to provide an export functionality directly build-in to the Classification Management Report or a potential RAP App. The Question: "Why don't we use oData Services which are directly connected to the BTP app" is a valid one and the answer is pretty simple: For all the scenarios we are using Kernseife in, the file export is the most robust and simplest solution. This doesn't mean we won't provide such a feature in the future. Feel free to build it and open a PR <3!

Importing the Missing Classifications

1. Open the "Jobs" App in Kernseife BTP
2. Click on "Import" Function
3. Select "Missing Classification Import" as Type in the Popup

Note

We recomment to leave the other fields empty. This will apply our default rating logic to all objects, which are not yet classified.
If you select a Default Rating, all new objects will be using this rating. Same with the Comment Field.

4. Select the csv file you exported in the previous step
5. Click OK

🚀 Congratulations you have now updated your Classification

Update the Classification Manually

To now apply the updated classification in your system, do the following:

Download/Export Classification File for System Upload

For Kernseife BTP version < 1.4.X

1. Open the "Manage Classifications" App in Kernseife BTP
2. Click "Download JSON" and wait for the .zip file do be downloaded.

For Kernseife BTP version >= 1.4.X

1. Open the "Jobs" App in Kernseife BTP
2. Click "Export" and select "Classification (System Upload Format)
3. Click "Ok"
4. Once the Job has finished, open the Details and download the zip files in "Export Files".

Upload Classification to System

1. Logon to your System
2. Run Report ZKNSF_CLASSIFICATION_MANAGR
3. Click on "Upload API File" in the ALV Toolbar
4. Confirm that you want to overwrite the existing classification
5. Select the .zip file you downloaded in the previous step
6. Rerun the ATC Check to apply the new classification

Update the Classification via BTP Connector

1. Open the "Settings App
2. Select the System you want to update and has all prerequisits installed
3. Click "Sync Classification"

Important

Updating the Classification will not automatically change/update previous ATC Run Results.