Metadata mapping

This help page explains how to use the "Mapping" method for metadata extraction.

metadata

Content of this topic

• Mapping
  • Configure metadata mapping
  • Configure mapped metadata
  • Map metadata values
• Direct mapping
• Mapping fallback
  • Create configuration object
  • Activate Configuration object

Mapping

Metadata mapping is a method in plusmeta for metadata extraction.

Mappings are defined in a knowledge graph with dependencies between the metadata. This knowledge graph can be evaluated based on rules and used for metadata assignment: If a certain value “A” has been assigned as metadata, then the dependent value “B” will also be assigned.

One example is the dependency between the metadata “Document type” and “VDI 2770 document category”. If a value of the metadata “Document type” such as “Operating instructions” is found in the text, the corresponding value of the VDI 2770 document category “Operation” is also assigned as a metadata value. Another example would be the assignement of product attributes based on extracted product variants.

Configure metadata mapping

The following sections illustrate the configuration of a mapping using a specific example. The metadata from which the mapping is based is referred to below as “mapping”. The metadata that is filled by the mapping is referred to below as “mapped”.
Example: If the mapping metadata “Document type” is assigned, the mapped metadata “VDI 2770 document category” should also be assigned.

1. Switch to the Properties view .
2. Select the mapping metadata Document type and click on the button to open the Edit properties dialogue.
   The Edit properties dialogue opens.
3. Open the Relations tab .
4. Click on the Add button to add a relation.
5. Add the relation has associated relation types and select has document type as the relation target.

Configuring an associated relation type for the mapping metadata.

Configure mapped metadata

1. Select the mapped metadata VDI-2770 document category and click on the button to open the Edit properties dialogue.
   The Edit properties dialogue opens.
2. Open the Relations tab .
3. Click on the Add button to add a relation.
4. Add the relation has role and select Mappable property as the relation target The relation dependent on property and dependent on relation mapping are also added.
5. In the dependent on property field, select the assigned relation type of the mapping metadata from the drop-down list, in the example has document type.
6. In the dependent on relation mapping field, select is equivalent to from the drop-down list. The respective metadata values are linked by this relation.

Configuring roles and dependencies on the mapped metadata.

Map metadata values

1. Open the list values of the mapping metadata Document type in the Properties view .
2. Click on the button to open the Edit properties dialogue.
   The Edit properties dialogue opens.
3. Open the Relations tab .
4. Click on the Add button to add a relation.
5. Add the relation is equivalent to and select the corresponding list value of the mapped metadata as the target, e.g. “Operation” of the VDI-2770 document category.

Associated list value of the mapped metadata connected to the list value of the mapping metadata.

Direct mapping

Direct mappings can be used to “redirect” input relations.

Example: The HTML file to be read contains a different relation than the relation with which the metadata is to be written to an iiRDS package.

1. Open the Properties view.
2. Select the metadata to be mapped.
3. Click on the button to open the Edit properties dialogue.
   The Edit properties dialogue opens.
4. Open the Relations tab .
5. Click on the Add button to add a relation.
6. Select the has role relation from the drop-down list.
7. In the has roles field, select Mappable property from the drop-down list The dependent on relation mapping field appears.
8. Enter the input relationship in the dependent on relation mapping field.
9. Click on the Add button to add a relation.
10. Select the relation has associated relation types from the drop-down list.
11. In the Relation target field, select the relation from the drop-down list with which the values are to be assigned in plusmeta.
12. In the attributes tab , activate the auto assignment attribute.
13. Click CLOSE.
    All your changes will be saved automatically.

Mapping fallback

If no suitable values are found for a configured metadata mapping, the rule-based assignment can be set as a fallback mechanism. This function must be activated via a configuration object.

Create configuration object

1. Open the objects view .
2. Click on the Add button to create a new object.
3. Select Configuration object as the object type.
4. Enter an Object label.

   Note: The drop-down list suggests titles according to the object type and template selected.

5. Open the lower tab of the Create object dialogue.
6. Select the Mapping template.

   Note: If no template is selected during creation, it cannot be added later.

7. In the JSON EDITOR, set mappingFallbackRB to true.
8. Click on CREATE OBJECT.

Activate Configuration object

1. Open the Properties view .
2. Select the metadata to which you want to assign the configuration object.
3. Click on the button to open the Edit properties dialogue.
   The Edit properties dialogue opens.
4. Open the Relations tab .
5. Click on the Add button to add a relation.
6. Select the relation uses configuration from the drop-down list.
7. In the uses configuration field, select the configuration object from the drop-down list.
8. Click CLOSE.
   All your changes will be saved automatically.

---

Related Docs

• Extractors
• Combined Prediction
• LLM metadata extraction
• Assign metadata to multiple objects
• Edit and approve extracted metadata
• Extract metadata