Skip to content

Commit 06353e9

Browse files
committed
Rename Import XML docs
1 parent 38ef7da commit 06353e9

File tree

17 files changed

+18
-18
lines changed

17 files changed

+18
-18
lines changed

content/en/docs/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -34,13 +34,13 @@ To prepare the data structure and the GUI, follow these steps:
3434

3535
1. Create the following **Customer** entity in your domain model:
3636

37-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581649.png" class="no-border" >}}
37+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/customer-entity.png" class="no-border" >}}
3838

3939
2. Create the overview and detail pages to manage objects of the **Customer** type.
4040
3. Create a menu item to access the customer overview page.
4141
4. Create an entity called *XMLDocument* that inherits all the properties from **System.FileDocument**:
4242

43-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/export-xml-documents/18581650.png" class="no-border" >}}
43+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/export-xml-documents/xmldocument-entity.png" class="no-border" >}}
4444

4545
5. Create the overview and detail pages to manage objects of the **XMLDocument** type.
4646
6. Create a menu item to access the XML document overview page (for more information, see [Setting Up Navigation](/refguide10/setting-up-the-navigation-structure/)).
@@ -54,11 +54,11 @@ To add an XML schema (XSD), follow these steps:
5454
1. Right-click a module in the **App Explorer** and select **Add Other** > **XML schema** from the menu.
5555
2. Enter *CustomersXSD* as the **Name** and click **OK**:
5656

57-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/export-xml-documents/18581696.png" class="no-border" >}}
57+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/export-xml-documents/name-schema.png" class="no-border" >}}
5858

5959
3. In the **XML Schema** editor, click **Select** and select the XSD file that you downloaded earlier:
6060

61-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581657.png" class="no-border" >}}
61+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/select-schema.png" class="no-border" >}}
6262

6363
4. Click **OK** to save the XML schema, which you will be using in the following steps.
6464

@@ -71,78 +71,78 @@ To create the XML-to-domain mapping, follow these steps:
7171
1. Right-click a module in the **App Explorer** and select **Add Other** > **Import mapping**.
7272
2. Enter *ImportCustomersMapping* as the **Name** and click **OK**. The new mapping will open automatically and the elements will be shown.
7373

74-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581689.png" class="no-border" >}}
74+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/name-import-mapping.png" class="no-border" >}}
7575

7676
3. On the **Select schema elements** dialog box, make sure **XML schema** is selected as the **Schema source**, and select **CustomerXSD** as the schema. Then, click **Expand all** to see the tree with elements.
7777
4. Select the following elements: **Customer**, **ID**, **CompanyName**, **Address**, **City**, and **PostalCode**:
7878

79-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581656.png" class="no-border" >}}
79+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/select-elements.png" class="no-border" >}}
8080

8181
5. Click **OK**. The first part of the import mapping should look like this:
8282

83-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581655.png" class="no-border" >}}
83+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/im-example.png" class="no-border" >}}
8484

8585
6. Open the connector (from the lower-right side of Studio Pro or from the **View** menu).
8686
7. Drag the entity **Customer** from the connector into the placeholder in the mapping editor:
8787

88-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581681.png" class="no-border" >}}
88+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/drag-entity.png" class="no-border" >}}
8989

9090
The **Map entity** editor for this element will open automatically:
9191

92-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581654.png" class="no-border" >}}
92+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/map-entity-editor.png" class="no-border" >}}
9393

9494
8. In the **Map entity** editor, do the following:
9595
* Select **Find an object (by key)** for the **Method** (to be able to search for an object, you need to define one or more keys in the value-to-attribute mappings)
9696
* Select **Create** for **If no object was found**
9797
* Select attributes for all five value-to-attribute mappings
9898
* Set **CustomerID** as the **Key**
9999

100-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581653.png" class="no-border" >}}
100+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/editor-filled.png" class="no-border" >}}
101101

102102
9. Click **OK** to save the mapping.
103103

104104
## Creating the Import Logic
105105

106-
In this section, you will create the logic to import the customers stored in an [XML document](/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581651.xml) in your application.
106+
In this section, you will create the logic to import the customers stored in an [XML document](/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/customers-xml.xml) in your application.
107107

108108
To create the import logic, follow these steps:
109109

110110
1. Open the **XMLDocument** overview page. It should look this, using a default layout:
111111

112-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581648.png" class="no-border" >}}
112+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/xml-overview-page.png" class="no-border" >}}
113113

114114
2. Right-click the toolbar of the data grid widget and select **Add button** > **Action** to add a new action button:
115115

116-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581647.png" class="no-border" >}}
116+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/add-action.png" class="no-border" >}}
117117

118118
3. Double-click the new button to open the **Edit Action Button** editor and do the following:<br />
119119
1. Change the caption to *Import XML Document*<br />
120120
2. For the **On click** event, select **Call a microflow**, then click **Select** for the microflow, create a new microflow, and name it *XMLDocument_Import*.<br />
121121
3. Click **OK** to save the properties.<br />
122122

123-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581646.png" class="no-border" >}}
123+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/edit-action-button-editor.png" class="no-border" >}}
124124

125125
4. Right-click the new **Import XML Document** button and select **Go to on click microflow** in the context menu. You should see an empty microflow with **XMLDocument** as the input parameter:
126126

127-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581669.png" class="no-border" >}}
127+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/import-parameter.png" class="no-border" >}}
128128

129129
5. Open the **Toolbox** and drag an **Import with mapping** activity to the line between the start and end event. This inserts a new import XML activity.
130130
6. Double-click the new activity to open the **Import With Mapping** dialog box and do the following:<br />
131131
1. Select the input parameter **XMLDocument** as the **Variable**.<br />
132132
2. Select the previously created XML-to-domain mapping **ImportCustomersMapping** as the mapping.<br />
133133
3. Click **OK** to save the properties.<br />
134134

135-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581668.png" class="no-border" >}}
135+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/im-properties.png" class="no-border" >}}
136136

137137
The microflow should look like this:
138138

139-
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581667.png" class="no-border" >}}
139+
{{< figure src="/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/microflow-example.png" class="no-border" >}}
140140

141141
## Importing an XML File
142142

143143
To import the XML file, follow these steps:
144144

145-
1. Deploy the application, upload [Customers.xml](/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/18581651.xml), and trigger the import microflow.
145+
1. Deploy the application, upload [Customers.xml](/attachments/refguide10/modeling/integration/mapping-documents/xml-documents/importing-xml-documents/sample-xsd.xml), and trigger the import microflow.
146146
2. Open the customer overview page and check if the customer data has been imported into your application.
147147

148148
## Read More

0 commit comments

Comments
 (0)