diff --git a/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/activities/integration-activities/query-external-database.md b/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/activities/integration-activities/query-external-database.md index f9d659bf930..3e81f837eb9 100644 --- a/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/activities/integration-activities/query-external-database.md +++ b/content/en/docs/refguide/modeling/application-logic/microflows-and-nanoflows/activities/integration-activities/query-external-database.md @@ -19,31 +19,43 @@ To learn how to use this activity in a microflow and configure other aspects of ## Properties +{{% alert color="info" %}} +Prior to Mendix 11.3.0, some of these properties were grouped in different sections. +{{% /alert %}} + Double-click the **Query External Database** activity to view its properties. -The **Query** section contains the following properties: +The **General** section contains the following properties, which are used to provide dynamic connection parameter values: * **Database** – the name of the database you want to query -* **Query** – the saved SQL query from your configuration of the Database connector -* **Parameters** – the saved parameters from your configuration of the Database connector -The **Connection** section contains the following properties, which are used to provide dynamic connection parameter values: +* **Connection Parameters** + * **DBSource** – Enter the JDBC URL you want to use for connection during runtime + * **DBUsername** – Enter the username you want to use for connection during runtime + * **DBPassword** – Enter the password you want to use for connection during runtime + + If you are using SSL based authentication for Postgres, provide the value for -* **DBSource** – Enter the JDBC URL you want to use for connection during runtime -* **DBUsername** – Enter the username you want to use for connection during runtime -* **DBPassword** – Enter the password you want to use for connection during runtime + * **ClientCertificateIdentifier** -If you are using SSL based authentication for Postgres, provide the value for + If you are using key-pair authentication for Snowflake, provide the value for: -* **ClientCertificateIdentifier** + * **PrivateKey** + * **Passphrase** -If you are using key-pair authentication for Snowflake, provide the value for: +The **Query** section contains the following properties: -* **PrivateKey** -* **Passphrase** +* **Query** – the saved SQL query from your configuration of the Database connector +* **Dynamic** – Choose **Yes** to update the query—*this option is available in Mendix 11.3.0 and above* + * **SQL** – When **Yes** is selected, the SQL field appears prepopulated with the selected query; you can then modify this query, using variables and parameters if required +* **Parameters** – the saved parameters from your configuration of the Database connector -In the **Output** section are the following properties: +The **Output** section contains the following properties: * **Return type** – the return type once the microflow is completed * **Use return value** – select **Yes** or **No** * **List name** – if **Use return value** is set to **Yes**, this is the name of the returned list + +{{% alert color="warning" %}} +It is your responsibility to apply the proper security, as this action can allow for SQL injection into your application. Do not use user-supplied or environment-supplied variables in your SQL statement; if possible, you should prefer them to be static. +{{% /alert %}} diff --git a/static/attachments/refguide/modeling/integration/use-platform-supported-content/use-the-external-database-connector/8.png b/static/attachments/refguide/modeling/integration/use-platform-supported-content/use-the-external-database-connector/8.png index e25722a9bb1..de0c744701e 100644 Binary files a/static/attachments/refguide/modeling/integration/use-platform-supported-content/use-the-external-database-connector/8.png and b/static/attachments/refguide/modeling/integration/use-platform-supported-content/use-the-external-database-connector/8.png differ