For Corticon to correctly process the request message, you must ensure that XML or JSON tag names map to entity and attribute names in the Corticon rule Vocabulary.

By default, Corticon Studio specifies the entity or attribute name as the XML Element Name. If XML or JSON tag names are different from the entity or attribute names, you need to prepare the Vocabulary by manually mapping them.

Our project Vocabulary looks like this:

media/image4.png

Notice that the request message contains two tag names ‘Shipment’ and ‘itemWeight’ that do not appear in our Vocabulary. They correspond to the Cargo entity and the Cargo.weight attribute.

You need to prepare the Vocabulary by manually mapping ‘Shipment’ to Cargo and itemWeight to Cargo.weight.

Open the Vocabulary file Cargo.ecore in the Tutorial-Done folder.

Mapping the Vocabulary for JSON requests

  1. On the Vocabulary menu, choose Add Document Mapping > Add JSON Mapping.
  2. Change the Element Name for the weight attribute in Cargo to itemWeight.
  3. Save the file.

You have now prepared the Vocabulary for JSON requests.

Mapping the Vocabulary for XML requests

  1. On the Vocabulary menu, choose Add Document Mapping > Add XML Mapping.
  2. Click the Cargo entity. In the XML Element Name property, you can see the default name ‘Cargo’ in grey.
    media/image6.png
  3. Change the default name by double-clicking the property value and then entering Shipment.
  4. Similarly, change the XML Element Name for the weight attribute in Cargo to itemWeight.
  5. Save the file.

You have now prepared the Vocabulary for XML requests.

Mapping the Vocabulary for Java Objects

If you prefer to use Java Objects you have prepared, map them into the Vocabulary.

  1. On the Vocabulary menu, choose Add Document Mapping > Add Java Object Mapping.
  2. On the Java Object Mapping tab added to the Vocabulary root, click METADATA Import.
  3. In the Import Java Class Metadata window, select Cargo.jar.
  4. Select cargoLibrary, and then click Finish.
  5. Save the Vocabulary file.