Mapping your data by applying smart suggestions

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

  1. 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.
    Screenshot showing the Generate mapping suggestions button for an action in an event-driven flow
  2. 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.
    Screenshot shows that 17 mapping suggestions are generated. For example, the Street address field of the source application is mapped to the Street address field of the target application.
  3. 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.
    Screenshot that shows how you can clear a single mapping suggestion by clicking Clear suggestion
  4. 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.
    Screenshot that shows that after clearing two suggested mappings, the Mapping Assist button says Preview 2 mapping suggestions
    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.
  5. 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.
    1. 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 Insert a mapping icon to open the Suggested mappings list.
      The list might include semantic mappings (which are indicated by the mapping rating icon Rating icon) and community mappings (which are indicated by the community rating icon Community suggestion icon). If you disable social learning, you won't see any community mappings. For more information, see Mapping Assist overview.
    2. 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.
      Screenshot that shows when you hover over the confidence rating for a community suggestion, the confidence percentage is 85%
    3. 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.
    4. 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.
  6. If no mapping suggestions are discovered for an action in your flow, the number of mapping suggestions to preview is zero.
    Scrreenshot that shows the message Preview 0 mapping suggestions
    • 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 Insert a mapping icon to choose a mapping from the Available mappings list.