# Datenbank

Um einen Datenbank-Agenten mit aqua zu verbinden, müssen Sie die folgenden Schritte durchführen. Zuerst entpacken Sie die Datenbank-Agent-ZIP-Datei und öffnen die **aquaAgentDatabaseGui.exe.config**. \
\
Hier geben Sie den agentCode und die aquaServiceUrl ein. 

{% code overflow="wrap" %}

```xml
<add key="agentCode" value="yd7zhzc5bd2fiydkyu9j"/>
          <add key="aquaServiceUrl" value="http://IhraquaServer/aquaAPI/aquaagentwebservice.asmx"/>
```

{% endcode %}

&#x20;Der Rest der config-Datei ist nicht notwendig, um den Agenten mit aqua zu verbinden. Der Agent-Code wird in aqua generiert und dem Agenten zugewiesen. Als nächstes klicken Sie auf Verbindungen in der Agent-Server-Konfiguration, um die Datenbank zu definieren. &#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_datenbank_rich_client_custom.png" alt=""><figcaption></figcaption></figure>

Um neue Verbindungen zu erstellen und diese Datenbanken hinzuzufügen, klicken Sie auf den Hinzufügen-Button ![](http://aquawiki.andagon.com/de/pictures/drex_datenbank_rich_client_custom_2.png) und fügen eine neue Datenbank ein. &#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_datenbank_rich_client_custom_3.png" alt=""><figcaption></figcaption></figure>

Innerhalb des Testfalls können Sie ein Datenbanktestskript einfügen. Die Verbindung muss in der Dropdown-Box definiert werden, die Anfrage muss eingegeben werden und es gibt eine Option für die Überprüfung eines Wertes. Um Variablen im DB-Agenten zu nutzen, setzen Sie diese zwischen '&'-Zeichen. Eine Variable mit der Bezeichnung 'User' beispielsweise kann in einer Abfrage oder im erwarteten Ergebnis als '\&User&' verwendet werden.  &#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_datenbank_rich_client_custom_4.png" alt=""><figcaption></figcaption></figure>

### Beispiel MySQL

* [ ] Laden Sie den MySQL Connector für .NET herunter und installieren Sie diesen vollständig auf dem Computer, auf dem der DB Agent läuft (<https://dev.mysql.com/downloads/connector/net/>)
* [ ] Starten Sie den DB-Agenten neu (falls er derzeit läuft)
* [ ] Öffnen Sie aqua, klicken Sie auf Datei --> Projektkonfiguration --> Automatisierung --> Verbindungen
* [ ] Erstellen Sie eine Neue Verbindung, wählen Sie dafür den Verbindungstyp "Gerenic"
* [ ] Tragen Sie als Datenlieferant den folgenden ein:        MySql.Data.MySqlClient
* [ ] Passen Sie den Connection String passen zu Ihrem MySQL Setup an&#x20;

<figure><img src="http://aquawiki.andagon.com/de/pictures/drex_beispiel_mysql_custom.png" alt=""><figcaption></figcaption></figure>