How To Create Sample Order Transformation Manager (OTM) Cartridge

Question

Hi All,
I've been trying quite unsuccessfully to create a sample OTM cartridge.
I created a sample orchestration cartridge and it has 2 functions viz. Provisioning and FulfillBilling with a dependency from Provisioning to FulfillBilling inside a Fulfillment Pattern Service.Voice.
I created a sample model project with the design pattern and it created some default entities like actions and other stuff.
To begin with I created a Domain FixedLine in conceptual model. Then added a Product 'Voice_PS'. I create a CFS called 'Voice_CFS' under 'Voice_PS' with a primary relationship. I added coceptual fulfillment pattern 'Voice_FP' to product 'Voice_PS'.
After this I created MappingRule in which I kept everything as default as I did not create any Voice_PS parameters.
Then I create Order Item Parameter Bindings and that also I kept default as I didn't want to pick any parameters from order line Specification Group.
Then I invoked design pattern for Create Service Order. This gave me Transformation Sequence and in first stage I added simple Context Type for OLI parameter ProductSpec = 'Service.Voice'.
I am using the same Order Item Specification for both source and target transformation. For this I checked the "Support Distributed Order Template" checkbox.
I created the Transformation Manager and Mapped the domain and Transformation Sequence to it.
After this I marked the "Invoke Transformation Manager" in Orchestration process as checked and gave the provider function as Calculate Service Order.
I fired an order after configuring all this and I am getting following line in DEBUG log.
<22-Jan-2015 7:56:26,289 IST PM> <DEBUG> <transformation.OrderTransformationManager> <ExecuteThread: '14' for queue: 'oms.ws.http'> <OTM transform invoked with cartridgeId: 353, provider function: {OracleComms_Model_Base_Cartridge/1.0.0.0.0}Calculate_Service_Order, 3 order items>
However if I open the order I do not see the Transformed Order Items below Order Items in the left panel.
What am I doing wrong or missing here?
Also in "Property References" tab of Order Item Specification there is a field "Order Item Recognition Property" which I mapped to a property returning my original PSR entity which was Product entity "Voice_PS".
However I'm constantly getting this error for it.
<23-Jan-2015 10:12:35,832 IST AM> <WARN> <generation.XQueryEntityResolver> <ExecuteThread: '14' for queue: 'oms.ws.http'> <Can't find entity identified by namespace=COM_SalesOrderFulfillment; name=Voice_PS; type=T=OrderItemParameterSpecificationType@http://xmlns.oracle.com/communications/ordermanagement/model>
I am getting a feeling that OSM requires a non conceptual entity at this place but what that should be is what I'm not getting.
Any small help will be welcome as I'm really struggling for last 3 days.

Answer 1

Hi All,
After almost a month researching on how OTM is configured I was able to successfully create a cartridge with OTM.
The thing is Oracle has tried multiple things to make sure that you do not work on OTM without taking a training from Oracle University. However working for an Indian IT consulting company, training cost is something that all IT managers don't approve of. So now let me enlist 4 things that I was missing and which are very important for OTM configuration:-
1.     One thing that was missing the entire time was productSpecMapping.xml with conceptual entities. This was achieved after making dependency of conceptual cartridge to fulfillment pattern cartridge and configuring realization and then building the entire workspace. Fulfillment pattern was derived from this mapping.
2.     Even though DS is built such that all entities in workspace are available for configuration, however, when you are selecting realization inside OSM entities the conceptual entities are not visible. Only if you make a cartridge dependency of model conceptual cartridge to the OSM cartridge where you are configuring realization then only the conceptual entities start appearing.
So in my cartridge I was missing 2 realizations. One was the realization from conceptual fulmillment pattern entity to OSM fulfillment pattern entity. Second was realization from conceptual funcational area entity to OSM order entity.
3.     The next thing that I configured and which was essential was "Common Model Entity Container". This tab appears on all catridge files of all projects. Basically this allows you to select the model project contributing to this project. As soon as I configured it OSM started detecting OrderItemParameterSpecificationType entities.
4.     The wierdest configuration I found was this one. After trying the previous point I found that even though the entities are now getting created but still I was getting OrderItemSpecificationType entity not found. So I cheked in the cartridgeBuild folder to check what is created in backend before deployment. I found that for some reason it was not Voice_PS but Voice_PSSpec. So I started concatinating "Spec" to all product entities in the incoming order in OrderItemSpecification Order Item Recognition Property. Please note that my order item recognition property was not "Voice_PSSpec" but rather the "qualifiedName" value derived from the productSpecMapping.xml for the node with the attribute name value as "Voice_PS". For more information look at this post from me some time back. OSM 7.2.4 Cartridge
Lo and behold, my cartridge started recognizing OTM. However I had made some wrong configuration in Order Template for Transformed Order Items inside functions so I quickly corrected them and fired another order. This time I could see the order items and transformed order items. Phew! finally its working.
Now that I have spent sufficient time in this I would be happy to help those who are having trouble configuring OTM.
Regards,
Pranshu