SAP Knowledge Base Article - Public

2649335 - Error Message: “Form of address key is not defined“ While Uploading Contacts Using Data Workbench


Your requirement is to upload the Contacts in the system using Data Workbench, but you are unable to proceed due to the processing error:

Form of address key 1 is not defined


Form of address key 2 is not defined


SAP Hybris Cloud for Customer

Reproducing the Issue

  1. Login to the HTML5 client
  2. Go to Data Workbench workcenter
  3. Go to the Import tab
  4. Select the radio button Individual Objects
  5. Go to Import tab
  6. Select the object Contact
  7. Select Next and Browse for the file
  8. Select Upload
  9. Choose Next
  10. Select Import
  11. In the Monitor tab, check for the respective Task ID
  12. The records in the file have the Processing Error


The upload is failing due to the incorrect Title Code specified in the field TitleCode of the upload file.


The relevant Title Code can be verified in Business Configuration as below:

  1. Go to Business Configuration work center
  2. Select Implementation Projects view or Overview
  3. Search and Open the activity Code List Mapping for Integration with External Applications and Solutions
  4. Select Maintain Code List Mapping
  5. In the Code List Mapping Definition table, find the Local Data Type Name which is FormOfAddressCode having Description as Form Of Address Code
  6. Select the Mapping Rule
  7. See the Code List Mapping
  8. External Code for Ms. is 0001
  9. External Code for Mr. is 0002

Correct the Title Code in the Data Workbench upload file or in the Code List Mapping activity, whichever is more appropriate for your business requirement and proceed with the data upload.


Title Code, TitleCode, Local Data Type Name, FormOfAddressCode, Form Of Address Code, Code List Mapping for Integration with External Applications and Solutions, Code List Mapping , KBA , code list mapping , title code , local data type name , titlecode , formofaddresscode , form of address code , code list mapping for integration , LOD-CRM-INT-API , OData API (C4C Only) , Problem


SAP Cloud for Customer add-ins all versions ; SAP Cloud for Customer core applications all versions