ContentsPrerequisites: ...................................................................................................................................... 1

Preparation: ........................................................................................................................................ 1

Deploy: ................................................................................................................................................ 5

Prerequisites:Roles required for downloading and deploying the value mapping artifact on HCI tenant:AuthGroup.IntegrationDeveloper

JDK recommendation: 1.6.0_45 or higher.

Download the CfCValueMappingUpdate.jar from the SAP note and save it to a folder on your localmachine.

Preparation:1. Open the HCI Space (web UI based Catalogue) using a browser and navigate to the integration package

in the Design tab. From the package content download the value mapping project as shown below. Thisdownloads the file in a zip format.

Alternatively, using Eclipse IDE open to the Integration Designer Perspective

From the node explorer open the HCI tenant and navigate to Deployed Artifacts.

Filter for value mapping project and download the artifact and save the jar file to your local machine.

2. Open the zip/jar file downloaded in the previous step using a zip utility and extract the filevalue_mapping.xml to a folder on your local machine (you can use the same folder where theCfCValueMappingUpdate.jar is saved)

3. Inside the folder where the value_mapping.xml is stored create an empty subfolder with any name(example: out as shown below)

4. Now in the command prompt navigate to the folder where the CfCValueMappingUpdate.jar is storedand Run the command as shown below

java -jar CfCValueMappingUpdate.jar <input filename> <output directory>\<output filename>

Where:

<input filename>: is the file that would be converted

<output directory>\<output filename> : is the output directory path and file name

Note: We recommend setting the output filename as value_mapping.xml so that when we copy it laterto a value mapping project no renaming is required.

A sample output is shown below. This program will read the value mappings from the content of theinput file and in case it finds relevant agency and schema names those need adjustments would listalong with the new entries that were created in the output file.

In the output xml file the new entries are added to the end of the file and can be identified with thecomment “Start of New entries added by the C4CValueMappingMigration helper program” ashighlighted below

Similarly an end comment is added “End of New entries added by the C4CValueMappingMigration helperprogram” to the output file.

5. Next copy and replace the value value_mapping.xml from the output (out) directory into the zip file thatwas downloaded from the HCI Web UI.

6. Now in the HCI catalogue in the design tab upload the modified value mapping project as mentionedbelow

6.1.1 Open the metadata for the value mapping artifcat

6.1.2 Then edit the artifcat

6.1.3 And upload the updated zip file that was prepared earlier.

Deploy:Now deploy the updated value mapping project to the tenant using the Deploy action.

Note: The value mapping migration program does not delete any entries from the original xml. It onlycreates new one for existing agencies and schemas which are relevant for C4C integration whilepreserving all original values. If desired the old values can be deleted, but any value mapping group thatis not changed by this utility should not be deleted. The groups that are relevant for change areprompted in the output of the command window when the executable jar runs.