When you populate fields for the actions in your flows, generate suggested mappings by
using artificial intelligence (AI) features.
About this task
You can generate mapping suggestions after you add an action to a flow. These suggestions
identify output from previous nodes in the flow that might be suitable as input values for the
fields in the current node. Suggested mappings can be generated by a pre-trained algorithm that
applies fuzzy matching and semantic rules. If social learning is enabled, suggested mappings can
also be generated by the number of times the same mapping is used by the App Connect community. For more information, see Mapping Assist overview.
Procedure
- In App Connect Designer, add an action to your
flow and ensure that you're connected to your account for the application.
If the
action is for a target application where data can be mapped from a previous node in your flow, you
can generate mapping suggestions.
- To generate suggestions, click Generate mapping suggestions.
Mapping Assist discovers potential mappings, which you can preview before you apply any or all of
them. Alternatively, you can click
Cancel to exit from the preview mode
without applying any of the suggested mappings.
- If any of the mappings are inappropriate, you can clear them individually by clicking
Clear suggestion.
If you clear a suggestion, the field becomes
empty, but you can't create a new mapping that field until you've either applied or canceled the
mapping suggestions.
- After you review the suggestions and clear any that are inappropriate, accept the
remaining suggestions by clicking Apply suggestions.
If you
clear any suggestions, or delete any suggested mappings after you apply them, you can still preview
(and then apply) suggestions for those fields. In the following example, two suggested mappings for
the "Name" and "Street address" fields have been deleted, therefore two mapping suggestions are
available to preview.
If you map one of those fields manually with data from a preceding node in your flows, the
number of suggestions decreases. In this example, if you map the "Name" field manually, one mapping
suggestion remains to be previewed for the "Street address" field.
- After you apply the suggested mappings, review any fields that don't contain mappings
and, if necessary, map source data to these fields manually.
To replace a suggested
mapping with a different mapping, you can also use the same steps after you delete the suggested
mapping.
- When you click in an unmapped field, if suggested mappings are available for this
field, the Suggested mappings list is opened.
Alternatively,
click
Insert a mapping

to open the
Suggested mappings
list.
The list might include semantic mappings (which are indicated by the mapping
rating icon

) and community mappings (which are indicated by the
community rating icon

). If you disable social learning, you won't see any
community mappings. For more information, see
Mapping Assist overview.
- Select the appropriate mapping.
You can view the predicted accuracy
percentage of the map by hovering over the rating or community icon.
The following
example shows that a community mapping and a semantic mapping are suggested for the "Name" field.
When you hover over the community icon, you see that the community mapping has a rating of 85%,
which is based on the same source-to-target mappings in the
App Connect user community.
- To choose from a wider range of mappings, click All mappings to
switch to the Available mappings list, which displays all mappings from all
the previous nodes in the flow.
Expand the sections to locate and select your required
mapping.
- If your source and target data formats don't match, click Transform data
format to use the transformation generator to construct JSONata expressions that convert
your source data to the required target format.
- If no mapping suggestions are discovered for an action in your flow, the number
of mapping suggestions to preview is zero.
- If suggested mappings are available, you can use the Suggested mappings
list to select mappings.
- If no suggested mappings are found, click Insert a mapping
to choose a mapping from the Available
mappings list.