Create mapping

On this page

  1. Choose mapping type
  2. Configure mapping details
    1. Manual mapping
    2. Auto mapping
    3. Existing mapping
    4. AI mapping
  3. Mapping preview
  4. Reset mapping

Mapping is a semantic layer that allows CluedIn to understand the nature of data and process it to produce golden records.

Mapping encompasses complex tasks, and CluedIn is committed to consistently enhancing the user experience associated with it. Nevertheless, it is crucial to grasp certain mapping concepts to leverage its full potential.

The process of creating a mapping consists of two parts:

  1. Choosing the mapping type

  2. Configuring the mapping details

Choose mapping type

Mapping type defines how you want to configure the mapping of original fields from the data set to the vocabulary keys in CluedIn. You can choose from the following mapping types:

  • Auto Mapping – CluedIn automatically creates mapping for your data. This option provides a reliable mapping configuration. You can check the results of auto mapping and make changes if needed.

  • Manual Mapping – CluedIn creates empty mapping configuration that you can modify as you want. This option is challenging and time-consuming because you have to create the configuration from scratch.

  • Existing Mapping – CluedIn uses the existing mapping configuration. This option is useful if you want to create mapping for the data set that has the exact same structure as the existing data sets.

  • AI Mapping – CluedIn uses AI capabilities to interpret your data and create mapping. You can check the results of AI mapping and make changes if needed.

The AI mapping feature is is not available by default. To use it, you need to fulfill several prerequisites:

  1. Go to Administration > Feature Flags and enable the AI Mapping feature.

    openai-1.png

  2. Go to Administration > Settings. Scroll down to the Open AI section and complete the following fields:

    • API Key – check the following link to learn where to find your API Key.

    • Base Url – you can find this value in your Azure OpenAI resource, in Resource Management > Keys and Endpoint, in the Endpoint field.

    • Resource Key – you can find this value in your Azure OpenAI resource, in Resource Management > Keys and Endpoint. You can use either KEY 1 or KEY 2.

    • Deployment Name – you can find this value in your Azure OpenAI resource, in Resource Management > Model deployments.

      openai-2.png

      For more information about the required variables, see Microsoft documentation.

To choose the mapping type

  1. On the navigation pane, go to Integrations > Data Sources. Then, find and open the data set for which you need to create mapping.

  2. Go to the Map tab, and then select Map Data.

    The Create Mapping pane opens, where you can choose the mapping type and configure the mapping details.

  3. On the Mapping Type tab, choose the mapping type. Then, in the lower-right corner, select Next.

    The Configure tab opens, where you can provide other mapping details following the instructions from the next section.

Configure mapping details

Depending on the selected mapping type, the actions required from you on the Configure tab may differ. To find relevant instructions for your chosen mapping type, refer to the needed section:

Manual mapping

Manual mapping gives you full control over how each field for your data set will generate records.

To configure manual mapping

  1. Choose the existing entity type or create a new one. If you create a new entity type, select an icon to visually represent the entity type.

  2. Choose the existing vocabulary or create a new one.

    With manual mapping, the mapping preview is not available.

    create-mapping-1.png

  3. Select Create Mapping.

    An empty mapping configuration is created. Next, map the original fields to the vocabulary keys. You can map all fields at once or map fields one by one.

To map all fields at once

  1. On the Map tab, select Map All Fields.

  2. In the pane that opens, review the suggested mapping. You can edit the vocabulary key names if needed. Also, if you change the vocabulary key name, you can edit its data type.

  3. In the lower-right corner, select Add Property to Annotation.

    The mapping is created. Next, review the mapping details.

To map fields one by one

  1. On the Map tab, select Edit Mapping.

  2. In the Maps to vocabulary key column, expand the dropdown list, and then select Add mapping. In the pane that opens, do the following:

    1. Expand the dropdown list and select the vocabulary key to which the original field should be mapped.

    2. If you want to use the field as a primary unique identifier for the record, turn on the Use as entity code toggle.

    3. If you want to use the field as an alias for the records, turn on the Use as alias toggle.

      create-mapping-2.png

    4. In the lower-right corner, select Add Property to Annotation.

  3. Repeat step 2 for each field.

    The mapping is created. Next, review the mapping details.

Auto mapping

Auto mapping tries to detect unique codes and map original columns to the most appropriate vocabulary keys.

To configure auto mapping

  1. Choose the existing entity type or create a new one. If you create a new entity type, select an icon to visually represent the entity type.

  2. Choose the existing vocabulary or create a new one.

  3. In the Mapping Preview section, review how the original fields will be mapped to the vocabulary keys in CluedIn.

  4. In the lower-right corner, select Create Mapping.

    The mapping is created. Next, review the mapping details.

Existing mapping

If you’ve already created a mapping for a data set and you have another data set with the same structure, you can save time by reusing the existing mapping.

To configure existing mapping

  1. Select the existing mapping that you want to reuse. The name of the mapping consists of two parts: the mapping type and the data set for which the mapping was generated.

  2. Select the existing data set that contains the same fields as in the current data set.

  3. In the lower-right corner, select Create Mapping.

    The mapping is created. Next, review the mapping details.

AI mapping

AI mapping analyzes your data set and suggests the following details for your mapping:

  • Entity type and vocabulary.

  • Origin – field used to produce the primary unique identifier.

  • Codes – fields used to produce additional unique identifiers.

  • Mapping of original fields to the vocabulary keys. For more details, see Mapping preview.

You need to review AI suggestions and make changes if needed.

Mapping preview

The Mapping Preview section is available when creating mapping with the following types: auto mapping and AI mapping. This section contains a table showing how the original fields will be mapped to the vocabulary keys in CluedIn. The table consists of the following columns:

  • The checkboxes column that represents the fields that will be sent to CluedIn during processing. If you do not want to send a specific field, clear the checkbox. The status of such field will be changed to Ignored.

  • Original Field – contains the names of the columns from the data set.

  • Will Map To – contains the vocabulary keys to which the original fields will be mapped. If needed, you can edit the names of both new and existing vocabulary keys directly in the table. If you edited the name of the existing vocabulary key, its status becomes New.

  • Data Type – contains the data type of each vocabulary key for strong typing. If needed, you can change the data type of both new and existing vocabulary keys directly in the table. If you edited the data type of the existing vocabulary key, its status becomes New.

  • Status – contains the status of each vocabulary key (New, Existing, or Ignored).

  • Preview – allows you to view the values in the column.

Reset mapping

If you’ve created mapping and have concerns about the accuracy or correctness of your mapping configuration, you can reset the mapping and starting over from scratch.

To reset the mapping

  • On the Map tab, select Reset, and then confirm that you want to reset the mapping configuration.

    Now, you can create the mapping from scratch.