Map incoming fields to request schema fields on the Request Mapping tab. The Machine Learning transformation uses the request schema fields to send data to the machine learning model at the REST endpoint.
The request schema fields come from the request schema in the REST API request from the API collection. The working field name is the key that the Machine Learning transformation passes in the REST API request. If the REST API can't process a special character in the field name, the working field name replaces the special character. For example, underscores are replaced with a period character (.).
The names of incoming fields and request schema fields can differ, but the data types and hierarchies must match. All request schema fields must have a mapped field, even if the fields are not mandatory in the REST API.
Note that only parent fields appear in the request mapping. To review child fields, refer to the incoming fields in the Machine Learning transformation and the request schema fields in the API collection.
Mapping hierarchical fields
To map hierarchical fields in the request mapping, the hierarchies of the incoming fields and request schema fields must match.
For example, the following image shows a request schema in an API collection:
The following image shows incoming fields in a Machine Learning transformation with a hierarchy that matches the request schema:
The following image shows the request mapping between the incoming fields and the request schema fields:
If the hierarchies don't match, use a Hierarchy Processor transformation before the Machine Learning transformation to restructure the incoming data according to the request schema fields. For more information, see Hierarchy Processor transformation overview.
Request mapping options
Configure request mapping options to define how incoming fields are mapped to request schema fields.
You can configure the following request mapping options:
Field Map Options
Method to map fields to the target. Use one of the following options:
- Manual. Manually link incoming fields to target fields. Selecting this option removes links for automatically mapped fields. To map fields manually, drag a field from the incoming fields list and position it next to the appropriate field in the target fields list. Or, you can map selected fields, unmap selected fields, or clear all of the mappings using the Actions menu.
- Automatic. Automatically link fields with the same name. Use when all of the fields that you want to link share the same name. You cannot manually link fields with this option.
- Completely Parameterized. Use a parameter to represent the field mapping. In the task, you can configure all field mappings.
- Partially Parameterized. Configure links in the mapping that you want to enforce and use a parameter to allow other fields to be mapped in the mapping task. Or, use a parameter to configure links in the mapping, and allow all fields and links to display in the task for configuration.
To see more information on field mapping parameters, see Mappings.
Parameter
Parameter to use for the field mapping.
New Parameter
Creates a field mapping parameter.
Show Fields
Controls the fields that appear in the Incoming Fields list. Show all fields, unmapped fields, or mapped fields.
Automap
Links fields with matching names. Allows you to link matching fields, and then manually configure other field mappings.
You can map fields in the following ways:
- Exact Field Name. Data Integration matches fields of the same name.
- Smart Map. Data Integration matches fields with similar names. For example, if you have an incoming field Cust_Name and a target field Customer_Name, Data Integration automatically links the Cust_Name field with the Customer_Name field.
You can use both Exact Field Name and Smart Map in the same field mapping. For example, use Exact Field Name to match fields with the same name and then use Smart Map to map fields with similar names.
You can undo all automapped field mappings by clicking Automap > Undo Automap. To unmap a single field, select the field to unmap and click Actions > Unmap.
Data Integration highlights newly mapped fields. For example, when you use Exact Field Name, Data Integration highlights the mapped fields. If you then use Smart Map, Data Integration only highlights the fields mapped using Smart Map.
Action menu
Additional field link options. Provides the following options:
- Map Selected. Links the selected incoming field with the selected target field.
- Unmap Selected. Clears the link for the selected field.
- Clear Mapping. Clears all field mappings.
Show
Determines how field names appear in the target fields list. Use technical field names or labels.
