Manage Service Mapping

Add attributes that contain your data, add attributes to the service, and add attributes to the source.

Assume you must add an attribute to a predefined service mapping so Pricing can map freight details for an order line.

This topic uses example values. You might need different values, depending on your business requirements.

Summary of the Set Up

Manage a service mapping.

1. Add the attribute that will contain your data.

2. Add your attribute to the service.

3. Add your attribute to the source.

Add the Attribute That Will Contain Your Data

1. Create a sand box. For details, see Create a Sandbox So You Can Edit Service Mappings.

2. On the Overview page, click Tasks > Manage Service Mappings.

3. On the Manage Service Mappings page, click Sales.

   Pricing comes predefined with the Sales service mapping that prices sales orders and order lines.

4. On the Edit Service Mappings page, click Entities.

   You use the Entities tab to define the entity that receives the output of the service mapping.

5. Click the row that includes Line in the Entity column.

   The order line contains the freight on board attribute, so you add it to the Line entity.

6. In the Line Details area, click Actions > Add Row, set the values, then click Save.

   Attribute	Value
   Attribute	FreightOnBoardCode_Custom You must include the _Custom suffix for any attribute or entity you create. Don't include spaces.
   Type	String Make sure you use a type that's compatible with the attribute you plan to use. For example: Use String to represent the order type. Use Integer to represent the order number.
   Allow Null	Contains a check mark

Add Your Attribute to the Service

Add the attribute to the service that will process the request so the service can reference the attribute when it maps the input service data object (SDO) to the output SDO.

1. Click Services, then click the row that includes PriceRequestLine in the Service column.

   Each of the services that come predefined with Pricing performs a finite service. For example, PriceRequestLine processes a request to price an order line, CalculateSalesOrderTotals processes a request to calculate the total price for a sales order, and so on.

2. In the PriceRequestLine Details area, in the Entities tab, click the row that includes Line in the Entity column.

3. In the Line Entities area, click Actions > Add Row, set the values, then click Save.

   Attribute	Value
   Attribute	FreightOnBoardCode_Custom You might need to scroll to the bottom of the list to locate this attribute.
   Read	Contains a check mark
   Write	Doesn't contain a check mark

Add Your Attribute to the Source

The service mapping uses the source to structure the input SDO. In this example, the calling application, Oracle Order Management, will send a code for freight on board, so you set up the source so it can accommodate the code.

1. Click Sources, then click the row that includes OrderLine in the Source column.

   Each source that comes predefined with Pricing provides a unique model that the service mapping can use to structure the input SDO. Consider these example sources.

   • OrderLine. References entities on the order line, such as the Line entity. These entities reference attributes on the order line, such as quantity, the date that the customer requested the order line, and so on.

   • OrderHeader. References entities on the order header, such as the Header entity. These entities reference attributes on the order header, such as the customer identification, the selling business unit, pricing strategy, and so on.

2. In the OrderLine Details area, in the Entities tab, click the row that includes Line in the Entity column.

3. In the Line Details area, in the Attribute Mappings tab, click Actions > Add Row, set the values, then click Save.

   Attribute	Value
   Attribute	FreightOnBoardCode_Custom
   View Object Attribute	FreightTermCode

If you encounter a problem, see the Service Mappings subtopic. For details, see Troubleshoot Your Pricing Setups.