Create Business Configuration Maintenance Object

1. Open your ABAP Development Tools, log on to your ABAP system, right-click ZLOCAL (or $TMP) and choose New > ABAP Package.

   

2. Create a new package:

   • Name: Z_ERROR_CODES_###
   • Description: Error Codes ###
   • Super package: ZLOCAL
   • Select Add to favorite packages

   

   Click Next >. Confirm the basic package properties by clicking Next > again.

3. If change recording is not enabled, you cannot enter a new transport request. Instead, simply click Finish.

1. Right-click Z_ERROR_CODES_### and choose New > Other ABAP Repository Object.

   

2. Search for Data Element, select it, and click Next >.

   

3. Create a data element. You use data elements instead of predefined ABAP types because the field labels on the user interface are derived from the data element definition. In addition, a data element is required to define a foreign key relationship between two tables. Note: For character-like key fields, you must associate the data element with a domain. This ensures that case-sensitivity is applied correctly, thus avoiding problems when transporting the content.

   • Name: Z_ERROR_CODE_###
   • Description: Error Code

   

   Click Next >.

4. Click Finish.

5. Select Predefined Type as Category, NUMC as Data type, 3 as Length and enter Error Code as Field Labels:

   

6. Save and activate.

7. Repeat steps 2.1. - 2.5 to create a second Data Element:

   • Name: Z_CODE_DESCRIPTION_###
   • Description: Error Code Description
   • Category: Predefined Type
   • Data Type: CHAR
   • Length: 120
   • Short Field Label: Text
   • Other Field Labels: Description

   

8. Save and activate.

1. Right-click Type Group Dictionary in package Z_ERROR_CODES_### and choose New > Database Table.

   

2. Create the error code database table:

   • Name: ZERRCODE_###
   • Description: Error Code ###

   

   Click Next >.

3. Click Finish.

4. Replace your code as follows. The timestamp fields are used for optimistic concurrency control for draft processing and OData consumer. If you add the field CONFIGDEPRECATIONCODE of type CONFIG_DEPRECATION_CODE to the database table, the ABAP generator that you use in step 5 can extend the generated RAP BO to manage the validity of the configuration entries.

```ABAP
@EndUserText.label : 'Error Code ###'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #C
@AbapCatalog.dataMaintenance : #ALLOWED
@AbapCatalog.primaryKey.invertedIndividualIndex : true
define table zerrcode_### {
  key client            : abap.clnt not null;
  key error_code        : z_error_code_### not null;
  last_changed_at       : abp_lastchange_tstmpl;
  local_last_changed_at : abp_locinst_lastchange_tstmpl;
}
```

5. Save and activate.

6. Repeat the steps 3.1.- 3.4 and create the database table for the error code description. An additional database table is considered as a text table by the ABAP generator that you use in step 5 if the annotation @AbapCatalog.foreignKey.keyType : #TEXT_KEY is used.

   • Name: ZERRCODET_###
   • Description: Error Code Description ###

```ABAP
@EndUserText.label : 'Error Code Description ###'
@AbapCatalog.enhancement.category : #NOT_EXTENSIBLE
@AbapCatalog.tableCategory : #TRANSPARENT
@AbapCatalog.deliveryClass : #C
@AbapCatalog.dataMaintenance : #ALLOWED
@AbapCatalog.primaryKey.invertedIndividualIndex : true
define table zerrcodet_### {
  key client            : abap.clnt not null;
  @AbapCatalog.textLanguage
  key langu             : abap.lang not null;
  @AbapCatalog.foreignKey.keyType : #TEXT_KEY
  @AbapCatalog.foreignKey.screenCheck : false
  key error_code        : z_error_code_### not null
    with foreign key [0..*,1] zerrcode_###
      where client = zerrcodet_###.client
        and error_code = zerrcodet_###.error_code;
  description           : z_code_description_###;
  local_last_changed_at : abp_locinst_lastchange_tstmpl;
}
```

7. Save and activate.

A Business Configuration Maintenance Object declares a Service Binding as relevant for business configuration. They are listed in the Custom Business Configurations app. Selecting an entry in the app renders an SAP Fiori elements-based UI to maintain the business configuration.

ABAP Repository Generator allows you to create the required repository objects, including RAP business object, service binding, and business configuration maintenance object.

Hint: For more information, see ABAP Repository Generator documentation.

1. Right-click the ZERRCODE_### table and choose Generate ABAP Repository Objects….

   

2. Select Maintenance Object and click Next >.

   

3. Enter the target package and click Next >.

   

4. The system generates a proposal for all input fields based on the description of the table by following these naming conventions. If you receive an error message stating that a specific object already exists, change the corresponding name in the wizard. Select Manual with preselection for Transport Selection and check the box for Enable Transport Selection Strip. Note that for configurations to be adjusted in every client you would select No transport for Transport Selection. If you have an SAP BTP trial account, change the option Transport selection to No transport as you cannot create any customizing transport requests.

   Click Next >.

   

5. The list of repository objects that are generated is displayed. Click Next >.

6. Click Finish.

7. When the generation is complete, the new business configuration maintenance object is displayed. You can find the documentation for the object attributes here. In the next tutorial, you will create the necessary authorization objects for using the business configuration maintenance object in the CUBCO app. You can adapt the generated RAP BO to your needs, see also CDS Annotations for Metadata-Driven UIs. For example, you can adjust the visibility, positioning, and labels of the fields. See also this collection of blog posts about advanced functionality you can implement like collaborative draft, sorting and associations.

8. If you have a license for SAP BTP, ABAP environment or you are working in an SAP S/4HANA Cloud, public edition system, you can now set this step to Done and continue with the next step Test yourself. Only if you have an SAP BTP trial account, you need to make the following adjustments because you cannot create business user roles. You can then also skip the following tutorial Provide authorization control for a Business Configuration Maintenance Object and continue with tutorial Use Custom Business Configurations app. In SAP S/4HANA Private Cloud Edition, IAM apps are not available. You can read this blog to learn how to create the required PFCG Role in SAP S/4HANA Private Cloud Edition.

   • Edit class ZBP_I_ERRORCODE###_S, section Local Types. Delete the content of the following methods. Then save and activate the class.

     • LHC_ZI_ERRORCODE###_S→GET_GLOBAL_AUTHORIZATIONS

   • Set the annotation @AccessControl.authorizationCheck in all generated CDS views to #NOT_ALLOWED. Save and activate.

   • Publish the Local Service Endpoint of the ZUI_ERRORCODE###_O4 service binding