worked on review comments iteration1

Author: SurabhiSaraf

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

@@ -24,9 +24,7 @@ This how-to teaches you how to do the following:
 * Connect your Mendix App with an external Database.
 * Create and execute different SQL Queries.
 
-Let's try to build below use case using External Database Connector in  Mendix App:
-
-Connect to an external database(MySQL) and retrieve list of Requested Products from database, also as a user you can Request for a Product using Mendix App.
+Let's use External Database Connector in  Mendix App, to connect, retreive and insert data.
 
 ## 2 Prerequisites
 
@@ -41,9 +39,9 @@ if additional connection properties are required to connect, you can alternative
 
 ## Steps to follow:
 
-### 1.Establish connection between External database and Mendix app
+### 1. Establish connection between external database and Mendix app
 
-1. Create new document of type **“External Database document.”**(File -> New Document -> External Database Connection or Rightclick on Module -> Add other -> External Database Connection)
+1. Create new document of type **'External Database document'**(File -> New Document -> External Database Connection or Rightclick on Module -> Add other -> External Database Connection)
 
 2. Select Database and add Connection details to connect to Database
 
@@ -53,24 +51,26 @@ if additional connection properties are required to connect, you can alternative
 
 {{< figure src="/attachments/howto/integration/use-the-external-database-connector/2.png" >}}
 
-Hurray Connection between your External Database and Mendix app is established successfully.
+Hurray Connection between your external database and Mendix app is established successfully.
+
+Click on **Save** to save connection details, these details are stored in 3 constants.
 
-Click on “Save” to save connection details in 3 constants 
+- \<Document Name\>_DBSource
+- \<Document Name\>_DBUsername
+- \<Document Name\>_DBPassword
 
-- DBSource
-- DBUsername
-- DBPassword
+For example: *Database*_DBsource. 
 
-### 2 Explore Tables and Views of a connected Database:
+### 2. Explore Tables and Views of a connected Database:
 
-Once connection is successful and saved , you can explore and search different **Tables & Views** of external database in External Database Connection document.
+Once connection is successful and saved, you can explore and search **Tables & Views** of external database in External Database Connection document.
 
 {{< figure src="/attachments/howto/integration/use-the-external-database-connector/3.png" >}}
 
-### 3 Create and Validate SQL Queries with Parameters:
+### 3. Create and Validate SQL Queries with Parameters:
 
-a. Create new query by entering **SQL Query** in query editor box.
-b. Add **Parameters** if you want to use constants or variables in your query during runtime(use curly braces to include parameters in query).
+a. Create new query by entering **SQL Query** in SQL query editor box.
+b. Add **Parameters** if you want to use mendix constants or variables in your query during runtime(use curly braces to include parameters in query).
 c. Testvalue should be assigned to the parameter using **Add Parameter**.
 d. **Run Query** to validate query and see the response.
 
@@ -81,36 +81,35 @@ SQL Query :
 
 {{< figure src="/attachments/howto/integration/use-the-external-database-connector/4.png" >}}
 
-### 4a Save Query & Create Enity:
+### 4a. Save Query & Create Enity:
 
-a.For query which returns resultset for example Select query, use **Use Response** to create mapping.
-b.In **Response Structure** you can see Entity preview which will be created with mapping to the corresponding query response.
-c. Click on **Save Query & Create Enity** to create new Entity in domain model and Save Query with mapping.
+a. For query which returns a resultset, click **Use Response** to create mapping.
+b. In **Response Structure** you can see Entity preview.
+c. Click on **Save Query & Create Enity** to save query and a new Entity is created in the domain model using response structure.
 
 {{< figure src="/attachments/howto/integration/use-the-external-database-connector/5.png" >}}
 
-### 4b Save Query:
+### 4b. Save Query:
 
-a.For queries which doesnot return resultset,
-Number of affected rows will be displayed as a Reponse.
+a. For DML queries, *Number of affected rows* will be displayed as a Reponse.
 For example: 
 `INSERT INTO classicmodels.productlines(productLine, requestedProductRequirement)VALUES({productLine}, {requestedProductRequirement})`
-b.Click **Save Query**
+b. Click **Save Query**
 {{< figure src="/attachments/howto/integration/use-the-external-database-connector/6.png" >}}
 
 **For all DML Queries, changes made to database in Mendix Design phase are automatically rolled back**
 
-### 5 Use “Query External Database” activity:
+### 5. Use “Query External Database” activity:
 
-a.Use "Query External Database" activity from toolbox in the microflow.
-b.Double click on activity and Select created External Database Connection document.
-c.All the queries created for the selected document, will appear in the dropdown, select the required one.
-d.Assign values to the parameters using "Expression editor".
-e.Output for the selected queries will be auto-populated based on the mapping of selected query.
+a. Use `Query External Database` activity from toolbox in the microflow.
+b. Double click on activity and select created External Database Connection document.
+c. All the queries created for the selected document will appear in the dropdown, select the required one.
+d. Assign values to the parameters using `Expression editor`.
+e. Output details for the selected query will be auto-populated.
 
 {{< figure src="/attachments/howto/integration/use-the-external-database-connector/7.png" >}}
 
-With these steps you are ready to use data in your Mendix App.
+With these steps you are ready to use data from external database in your Mendix App.
 
 {{% alert color="warning" %}}
 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.