Skip to content

Commit a8911cf

Browse files
authored
Revised doc structure
1 parent 8d7855a commit a8911cf

1 file changed

Lines changed: 12 additions & 14 deletions

File tree

content/en/docs/howto/integration/use-the-external-database-connector.md

Lines changed: 12 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -28,20 +28,18 @@ Let's use External Database Connector in Mendix App, to connect, retreive and i
2828

2929
## 2 Prerequisites
3030

31-
Let's assume that you already have Mendix app.
32-
33-
* Download the [External Database Connector](https://marketplace.mendix.com/link/component/219862) from the Mendix Marketplace into your app.
31+
Download the [External Database Connector](https://marketplace.mendix.com/link/component/219862) into your app. Make sure you have the following details for your external connection:
3432

3533
* **Username** and **Password** for signing into the external database
3634
* Connection details: **Host**, **Port**, **Database name**
3735

38-
if additional connection properties are required to connect, you can alternatively use **JDBC Connection String**.
36+
If additional connection properties are required to connect, you can alternatively use **JDBC Connection String**.
3937

40-
## Steps to follow:
38+
## 3 Establish a connection
4139

42-
### 1. Establish connection between external database and Mendix app
40+
### 3.1 Establish connection between the external database and Mendix app
4341

44-
1. Create new document of type **'External Database document'**(File -> New Document -> External Database Connection or Rightclick on Module -> Add other -> External Database Connection)
42+
1. Create a new document of type **'External Database document'**(File -> New Document -> External Database Connection or Rightclick on Module -> Add other -> External Database Connection)
4543

4644
2. Select Database and add Connection details to connect to Database
4745

@@ -61,13 +59,13 @@ For example: *Database*_DBsource.
6159

6260
Hurray Connection between your external database and Mendix app is established successfully.
6361

64-
### 2. Explore Tables and Views of a connected Database:
62+
### 3.2 Explore Tables and Views of a connected Database:
6563

6664
Once connection is successful and saved, you can explore and search **Tables & Views** of external database in External Database Connection document.
6765

6866
{{< figure src="/attachments/howto/integration/use-the-external-database-connector/3.png" >}}
6967

70-
### 3. Create and Validate SQL Queries with Parameters:
68+
### 3.3 Create and Validate SQL Queries with Parameters:
7169

7270
1. Create new query by entering **SQL Query** in SQL query editor box.
7371

@@ -85,9 +83,9 @@ SQL Query :
8583

8684
{{< figure src="/attachments/howto/integration/use-the-external-database-connector/4.png" >}}
8785

88-
### 4. Save Query:
86+
## 4. Save Quer
8987

90-
#### 4a. Save Query to retrieve data:
88+
### 4.1 Save Query to retrieve data:
9189

9290
1. For query which returns a resultset, click **Use Response** to create mapping.
9391

@@ -97,7 +95,7 @@ SQL Query :
9795

9896
{{< figure src="/attachments/howto/integration/use-the-external-database-connector/5.png" >}}
9997

100-
### 4b. Save DML Query:
98+
### 5 Save DML Query
10199

102100
1. For DML queries, *Number of affected rows* will be displayed as a Reponse.
103101
For example:
@@ -109,7 +107,7 @@ For example:
109107

110108
**For all DML Queries, changes made to database in Mendix Design phase are automatically rolled back**
111109

112-
### 5. Use Query External Database activity:
110+
### 6 Use Query External Database activity:
113111

114112
1. Use `Query External Database` activity from toolbox in the microflow.
115113

@@ -127,4 +125,4 @@ With these steps you are ready to use data from external database in your Mendix
127125

128126
{{% alert color="warning" %}}
129127
It is your responsibility to apply the proper security, as this action can allow for SQL injection into your Mendix application. Among others things, do not use user-supplied or environment-supplied variables in your SQL statement; if possible, you should prefer them to be static.
130-
{{% /alert %}}
128+
{{% /alert %}}

0 commit comments

Comments
 (0)