Skip to content

Commit 293a41e

Browse files
authored
Merge pull request mendix#8863 from mendix/qt-proof
Revise Excel docs
2 parents 81e78d2 + c77db4c commit 293a41e

19 files changed

Lines changed: 19 additions & 23 deletions

File tree

content/en/docs/refguide/modeling/integration/use-excel-documents/import-a-large-excel-file.md

Lines changed: 19 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Before starting this how-to, make sure you have completed the following prerequi
2424

2525
The Excel sheet you receive in this scenario contains almost every country in the world, as well as some supporting data. This data has to be imported into your application.
2626

27-
You can find the Excel sheet here: [Countries](/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/Countries.xlsx).
27+
You can find the Excel sheet here: [Countries](/attachments/refguide/modeling/integration/import-a-large-excel-file/Countries.xlsx).
2828

2929
You are going to make an XSD schema from the headers in the Excel sheet so you can import the data into the model.
3030

@@ -33,9 +33,9 @@ To modify your Excel sheet, follow these steps:
3333
1. Select the header row with all the country names.
3434
2. Copy and paste them in a new sheet using the transpose function:
3535

36-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398888.png" class="no-border" >}}
36+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/transpose.png" class="no-border" >}}
3737

38-
Your headers should be listed vertically and your sheet should look like this: [Countries Transposed](/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountriesTransposed.xlsx).
38+
Your headers should be listed vertically and your sheet should look like this: [Countries Transposed](/attachments/refguide/modeling/integration/import-a-large-excel-file/CountriesTransposed.xlsx).
3939

4040
You are now ready to add some tags around the column.
4141

@@ -48,17 +48,17 @@ To modify your Excel sheet, follow these steps:
4848
4949
5. Drag the string all the way down to the last country.
5050
51-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398889.png" class="no-border" >}}
51+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/country-sheet.png" class="no-border" >}}
5252
5353
6. In cell **C1**, enter the following string:
5454
5555
```text
5656
"/>
5757
```
5858
59-
7. Like you did with the previous string, drag it down to the last country. The Excel sheet should now look like this: [Countries with Tags](/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountriesWithTags.xlsx).
59+
7. Like you did with the previous string, drag it down to the last country. The Excel sheet should now look like this: [Countries with Tags](/attachments/refguide/modeling/integration/import-a-large-excel-file/CountriesWithTags.xlsx).
6060
61-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398890.png" class="no-border" >}}
61+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/countries-with-tags.png" class="no-border" >}}
6262
6363
Now, group the three different columns into one column. This is necessary to copy the whole column into an XSD file.
6464
@@ -68,7 +68,7 @@ To modify your Excel sheet, follow these steps:
6868
=(A1&B1&C1)
6969
```
7070
71-
9. Drag the cells down like you’ve done with column **A1** and **C1**. Now, column **D** should have columns **A**, **B**, and **C** combined into one, and your sheet should look like this: [Countries with Tags and Column D](/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountriesWithTagsAndColumnD.xlsx).
71+
9. Drag the cells down like you’ve done with column **A1** and **C1**. Now, column **D** should have columns **A**, **B**, and **C** combined into one, and your sheet should look like this: [Countries with Tags and Column D](/attachments/refguide/modeling/integration/import-a-large-excel-file/CountriesWithTagsAndColumnD.xlsx).
7272
7373
## Preparing Your XSD File
7474
@@ -98,43 +98,39 @@ You have used some of Excel's basic functionalities to create the first part of
9898
</xs:schema>
9999
```
100100
101-
Your file should look like this: [Country Import](/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountryImport.xsd).
101+
Your file should look like this: [Country Import](/attachments/refguide/modeling/integration/import-a-large-excel-file/CountryImport.xsd).
102102
103103
5. Click **Save**.
104104
105105
## Importing into Your Application Project
106106
107107
The XSD file is ready to be imported into your app. To import it, follow these steps:
108108
109-
1. Open your app and create a new XSD schema:
109+
1. Open your app and create a new XSD schema. Do this by right-clicking the module and selecting **Add other** > **XML schema**.
110110
111-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398893.png" class="no-border" >}}
111+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/create-schema.png" class="no-border" width="600" >}}
112112
113-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/create.png" class="no-border" >}}
113+
2. With the new XSD schema, create the XML-to-domain mapping by right-clicking the module > **Add other** > **Import mapping**.
114114
115-
2. With the new XSD schema, create the XML-to-domain mapping. Do this by right-clicking the module > **Add other** > **Import mapping**.
116-
117-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398895.png" class="no-border" >}}
118-
119-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398896.png" class="no-border" >}}
115+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/create-mapping.png" class="no-border" width="600" >}}
120116
121117
3. Check all the attributes listed. After clicking **OK**, you see a mapping entity with all your countries.
122118
123119
4. You will now generate a real entity from it that you can use as an import table for your Excel sheet. Click **Map automatically**:
124120
125-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398897.png" class="no-border" >}}
121+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/map-automatically.png" class="no-border" width="400" >}}
126122
127-
There’s your entity!
123+
Your entity is created:
128124
129-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398898.png" class="no-border" >}}
125+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/new-entity.png" class="no-border" >}}
130126
131-
5. Go to your domain model and set the entity’s **Persistable** property to **Yes**.
127+
5. Open your domain model and set the entity’s **Persistable** property to **Yes**.
132128
133-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398899.png" class="no-border" >}}
129+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/persistable-properties.png" class="no-border" >}}
134130
135131
The data is imported to the page, as seen in the image below:
136132
137-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/large-file.png" class="no-border" >}}
133+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/large-file.png" class="no-border" >}}
138134
139135
To keep your application clean, you can delete the XSD schema and XML-to-domain files from your app.
140136
@@ -160,6 +156,6 @@ To create entity in your domain model using an Excel sheet, follow these steps:
160156
* If the column names do not conform to Mendix naming conventions, they will automatically be corrected.
161157
* The extension identifies correct data types of each column (such as string, boolean, or date).
162158
6. After reviewing the preview, click **Create Entity** and a non-persistable entity (NPE) is created in your domain model.
163-
{{< figure src="/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/create-entity-using-excel-input.png" class="no-border" >}}
159+
{{< figure src="/attachments/refguide/modeling/integration/import-a-large-excel-file/create-entity-using-excel-input.png" class="no-border" >}}
164160
165161
You can change the name of the entity or change its persistence later, if necessary.

static/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/Countries.xlsx renamed to static/attachments/refguide/modeling/integration/import-a-large-excel-file/Countries.xlsx

File renamed without changes.

static/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountriesTransposed.xlsx renamed to static/attachments/refguide/modeling/integration/import-a-large-excel-file/CountriesTransposed.xlsx

File renamed without changes.

static/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountriesWithTags.xlsx renamed to static/attachments/refguide/modeling/integration/import-a-large-excel-file/CountriesWithTags.xlsx

File renamed without changes.

static/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountriesWithTagsAndColumnD.xlsx renamed to static/attachments/refguide/modeling/integration/import-a-large-excel-file/CountriesWithTagsAndColumnD.xlsx

File renamed without changes.

static/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/CountryImport.xsd renamed to static/attachments/refguide/modeling/integration/import-a-large-excel-file/CountryImport.xsd

File renamed without changes.

static/attachments/howto/integration/importing-excel-documents/import-a-large-excel-file/19398890.png renamed to static/attachments/refguide/modeling/integration/import-a-large-excel-file/countries-with-tags.png

File renamed without changes.

0 commit comments

Comments
 (0)