diff --git a/content/en/docs/refguide/modeling/integration/mapping-documents/export-mappings.md b/content/en/docs/refguide/modeling/integration/mapping-documents/export-mappings.md index 7e67ee8203d..ca29f49195d 100644 --- a/content/en/docs/refguide/modeling/integration/mapping-documents/export-mappings.md +++ b/content/en/docs/refguide/modeling/integration/mapping-documents/export-mappings.md @@ -12,7 +12,7 @@ For an introduction to export mappings, refer to [Mapping Documents](/refguide/m Figure 1 shows an example of an Export Mapping document in which two elements from a schema have been selected using the [Select Elements](/refguide/select--elements/) dialog. The entity Cheesecake (on the left) was dragged into the mapping to map to the Cheesecake element (on the right). The entity Topping was mapped to the Topping element. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843939.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/example-mapping-document.png" class="no-border" >}} **Figure 1** @@ -28,7 +28,7 @@ When the top element in the mapping is [optional](#optional), you can specify a For child objects, it is possible to get the objects via an association with the parent object, as shown in Figure 1. In the example, the **Topping** objects that need to be exported will be fetched at runtime using the **Topping_Cheesecake** association. It is possible to edit the mapping element by double-clicking the **Topping** entity (left) or the **Topping** schema element (right). This window will be shown: -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843938.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/topping-object.png" class="no-border" >}} **Figure 2** @@ -36,13 +36,13 @@ For child objects, it is possible to get the objects via an association with the In this window, you can choose to either get the object by association with the parent (Figure 3) or by microflow (for details, see [Mapping Attributes in Export Mappings](#mapping-attributes)). If you choose to get the object by microflow, you can pass any of the parent objects to that microflow as arguments to help determine what object you should return. This is the window in which this is configured: -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843937.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/object-by-microflow.png" class="no-border" >}} **Figure 3** When you choose to get an object by microflow, this is shown in the Export Mapping document: -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843936.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/object-by-microflow-example.png" class="no-border" >}} **Figure 4** @@ -52,7 +52,7 @@ The user can also define what should be done when the chosen method to get the M For each value element that the complex schema element encompasses, an attribute needs to be mapped from the entity. These properties are not applicable for choice or inheritance elements because they do not contain value elements. Configuring how to map the attributes is done in the window depicted in Figure 5, which is shown after double-clicking a specific mapping element. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843935.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/mapping-attributes.png" class="no-border" >}} **Figure 5** @@ -77,7 +77,7 @@ For some selected schemas, elements defining an entity is optional. This is the An example of this is shown in Figure 6. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843934.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/export-mappings/optional-mapping.png" class="no-border" >}} **Figure 6** diff --git a/content/en/docs/refguide/modeling/integration/mapping-documents/import-mappings.md b/content/en/docs/refguide/modeling/integration/mapping-documents/import-mappings.md index e9286beb670..ec88ca8b4bb 100644 --- a/content/en/docs/refguide/modeling/integration/mapping-documents/import-mappings.md +++ b/content/en/docs/refguide/modeling/integration/mapping-documents/import-mappings.md @@ -10,7 +10,7 @@ Please refer to [Mapping Documents](/refguide/mapping-documents/) for an introdu Figure 1 depicts an example of an Import Mapping document in which two elements from an XML Schema have been selected using the **Select elements...** dialog. Then, the ReceivedPartners and ReceivedClient entities were added and mapped to the Result and Client schema elements. Each time the Import Mapping is invoked, a new ReceivedPartners object is obtained. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843942.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/im-example.png" class="no-border" >}} **Figure 1** @@ -18,7 +18,7 @@ Figure 1 depicts an example of an Import Mapping document in which two elements For each XML or JSON object, a Mendix object needs to be obtained. You can create one or find an existing object in the database. Alternatively, you can use a custom microflow that returns an object. You can define how a Mendix object is obtained in the window depicted in Figure 2, which is shown after double-clicking a specific mapping element. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843943.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/mapping-entity.png" class="no-border" >}} **Figure 2** @@ -66,13 +66,9 @@ Be aware that lists are not stored ordered in the Mendix database. The XML schem Each schema value in a selected XML or JSON schema object needs to be mapped to an attribute of an entity to be used in your app. If you don't want to map certain values, uncheck them in the **Select elements...** dialog box. Configuring how to map the attributes is done in the screen depicted in Figure 3, which is shown after double-clicking a specific mapping element. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843943.png" class="no-border" >}} - -**Figure 3** - Having defined the mappings for the attributes, these mappings are also shown in the mapping document. When a specific attribute is selected, the schema element is also selected. This works the other way around too. An example of this is shown in Figure 4, where the **dati** attribute is selected in both the entity and the schema element (in this case, dati is mapped to dati). -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843944.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/import-mappings/schema-example.png" class="no-border" >}} **Figure 4** diff --git a/content/en/docs/refguide/modeling/integration/mapping-documents/map-automatically.md b/content/en/docs/refguide/modeling/integration/mapping-documents/map-automatically.md index 1a8d0c74493..d784adcd353 100644 --- a/content/en/docs/refguide/modeling/integration/mapping-documents/map-automatically.md +++ b/content/en/docs/refguide/modeling/integration/mapping-documents/map-automatically.md @@ -7,11 +7,11 @@ url: /refguide/map-automatically/ After you have selected a schema source for the mapping document, you need to connect it to entities, associations, and attributes. When you do not yet have suitable entities available in your domain model, creating new ones by hand can be difficult, especially in large mappings. The **Map automatically** button does the majority of the work for you. Based on the selected schema elements, it creates domain model entities and uses them in the mapping. -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579457.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/domain-model-mapping.png" class="no-border" >}} In the above picture, no entities are connected to the schema elements and the domain model in the module is empty. After clicking **Map automatically**, the situation is as follows: -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579459.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/auto-map-example.png" class="no-border" >}} The following actions will be applied: @@ -21,13 +21,13 @@ The following actions will be applied: A dialog is shown with the changes that have been applied to the domain model and mapping document (click **Details**"** to expand the dialog). -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579458.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/change-dialog.png" class="no-border" >}} ## Using Existing Entities, Attributes and Associations If the domain model already contains entities that map to schema elements, they are reused in the mapping. By default, an entity with the same name of the schema type is used. New attributes may be added, or a generalization may be set if the entity did not already have one. New associations may be created as well if they do not yet exist. The result dialog reports if it reuses existing domain model elements: -{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579460.png" class="no-border" >}} +{{< figure src="/attachments/refguide/modeling/integration/mapping-documents/map-automatically/change-dialog-reuse.png" class="no-border" >}} ## Limitations diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843939.png b/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/example-mapping-document.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843939.png rename to static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/example-mapping-document.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843935.png b/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/mapping-attributes.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843935.png rename to static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/mapping-attributes.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843936.png b/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/object-by-microflow-example.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843936.png rename to static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/object-by-microflow-example.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843937.png b/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/object-by-microflow.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843937.png rename to static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/object-by-microflow.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843934.png b/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/optional-mapping.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843934.png rename to static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/optional-mapping.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843938.png b/static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/topping-object.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/16843938.png rename to static/attachments/refguide/modeling/integration/mapping-documents/export-mappings/topping-object.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843942.png b/static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/im-example.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843942.png rename to static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/im-example.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843943.png b/static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/mapping-entity.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843943.png rename to static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/mapping-entity.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843944.png b/static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/schema-example.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/16843944.png rename to static/attachments/refguide/modeling/integration/mapping-documents/import-mappings/schema-example.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579459.png b/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/auto-map-example.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579459.png rename to static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/auto-map-example.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579460.png b/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/change-dialog-reuse.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579460.png rename to static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/change-dialog-reuse.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579458.png b/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/change-dialog.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579458.png rename to static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/change-dialog.png diff --git a/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579457.png b/static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/domain-model-mapping.png similarity index 100% rename from static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/18579457.png rename to static/attachments/refguide/modeling/integration/mapping-documents/map-automatically/domain-model-mapping.png