> For the complete documentation index, see [llms.txt](https://help.auxalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.auxalia.com/plant-tools/de/plantlink/how-to-use/usage/execute-sql-scripts-on-project-load.md).

# SQL-Skripte beim Laden des Projekts ausführen

Dieses Kapitel beschreibt, wie SQL-Skripte beim Öffnen eines Projekts automatisch ausgeführt werden können.

Oft erstellen Kunden zusätzliche Views/Abfragen, die in Kombination mit PlantLink verwendet werden, um eine Art Datenfluss zu erzeugen. Oder um Daten in irgendeiner Form zu extrahieren. Um die manuelle Ausführung eines SQL-Skripts zu vermeiden, müssen Sie lediglich eine SQL-Skriptdatei in das Projekt kopieren, und die Views oder Tabellen werden erstellt.

Das zu Beginn verwendete Projekt ist das aus [Getting Tag from connected objects into instruments](/plant-tools/de/plantlink/how-to-use/use-cases/getting-tag-from-connected-objects-into-instruments.md) und kann über folgenden Link heruntergeladen werden:

[Beispielprojekt herunterladen (Start)](http://documentation.auxalia.com/EN/PL%20Use%20Case%20001.7z)

Ein Link zu dem in diesem Kapitel erstellten Projekt befindet sich am Ende dieses Kapitels.

<details>

<summary>Ausführen des SQL-Skripts beim Laden des Projekts aktivieren</summary>

Zuerst müssen Sie die Funktion für PlantLink in den Einstellungen aktivieren.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-718b1ff34fc1d6afadbe666cce05b3525cf003fa%2FPL-Usage-0046.png?alt=media)

Aktivieren Sie das Kontrollkästchen, damit PlantLink SQL-Skripte finden und ausführen kann.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-0c374b0601be11babefc1f21df5374b635358fa7%2FPL-Usage-0047.png?alt=media)

</details>

<details>

<summary>Ablage und Benennung der SQL-Skripte</summary>

Die SQL-Skripte müssen sich im Ordner \[PP]\ACPlantTools\PlantLink befinden.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-5e3e26fbdf7eabef2cfac74ef351c3e7cab749de%2FPL-Usage-0048.png?alt=media)

Die Namen der SQL-Skriptdateien sind wie folgt vordefiniert:

PT\_SQLITE\_PID.sql SQLite-Skriptdatei für die Kategorie P\&ID

PT\_SQLSERVER\_PID.sql SQL-Server-Skriptdatei für die Kategorie P\&ID

PT\_SQLITE\_3D.sql SQLite-Skriptdatei für die Kategorie 3D

PT\_SQLSERVER\_3D.sql SQL-Server-Skriptdatei für die Kategorie 3D

Sie können alle 4 Dateien in Ihrem Projekt haben. Verwendet das Projekt SQLite, lädt PlantLink die Dateien PT\_SQLITE\_*.sql. Andernfalls die Dateien PT\_SQLSERVER\_*.sql.

</details>

<details>

<summary>SQL-Skript mit SQLite erstellen</summary>

In diesem Beispiel verwenden wir den in ProcessPower.dcf erstellten View aus [Getting Tag from connected objects into instruments](/plant-tools/de/plantlink/how-to-use/use-cases/getting-tag-from-connected-objects-into-instruments.md). Wir können das Design des Views sehen.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-18745258c5f8b0c759a45780ac233e9819bb9d4d%2FPL-Usage-0049.png?alt=media)

Das Menü **Import/Export** ist nur in der SQLite Expert Professional-Version verfügbar, nicht jedoch in der SQLite Export Personal-Version.

Wählen Sie **Data Transfer Wizard**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-3aba36f194315f809f0d81eab90993787e18d8b6%2FPL-Usage-0050.png?alt=media)

Klicken Sie dann auf **Next**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-83843c6d5ff268fa3dbec2725dd2891817e5bdcf%2FPL-Usage-0051.png?alt=media)

Dann **Export**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-0e172c2f2d86e44871c6042ffbd37c13f4865b70%2FPL-Usage-0060.png?alt=media)

**SQL Script**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-8c0616bca388b6edcb077986712711247c46b753%2FPL-Usage-0061.png?alt=media)

Speichern Sie die Datei unter \[PP]\ACPlantTools\PlantLink unter dem Namen **PT\_SQLITE\_PID.sql**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-a4829dad402c7e91b82fdc0db1e151fa6b0b6d55%2FPL-Usage-0062.png?alt=media)

Der Pfad und der Dateiname werden angezeigt. Klicken Sie auf **Next**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-c319dbf53e606f14f035ac510d73bd426891d7d4%2FPL-Usage-0063.png?alt=media)

Verwenden Sie **UTF-8** und klicken Sie auf **Next**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-1af7a41a17abd5a338d7a4da67402404825c5c04%2FPL-Usage-0064.png?alt=media)

Wenn das SQL-Skript beim Laden des Projekts Views erstellen soll, erhalten Sie einen Fehler, wenn der View bereits existiert. Daher sollten Sie entweder prüfen, ob der View bereits existiert (und ihn dann nicht erstellen), oder **DROP VIEW** verwenden, bevor der View erneut erstellt wird.

Deshalb sollten Sie die Option **Drop destination objects first** verwenden.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-aebbdac79c6569312785f6654f422b057c514700%2FPL-Usage-0065.png?alt=media)

Nun wählen Sie **Views** aus.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-9203ce8684664df26933a46b351467fb621ac38b%2FPL-Usage-0066.png?alt=media)

Standardmäßig sind alle Views ausgewählt.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-e074e298768786a5cf95af7e0759f8ac009bd3ac%2FPL-Usage-0067.png?alt=media)

Klicken Sie auf **Unselect all**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-bedac29b8808a9dc9184be6d6455bd796314e01c%2FPL-Usage-0068.png?alt=media)

Nun wählen Sie nur die Views aus, die Sie tatsächlich im SQL-Skript haben möchten. In unserem Fall **PL\_VIEW\_Get\_Tag**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-09f679f43b5003f974892d0628d398ceaff19e9d%2FPL-Usage-0070.png?alt=media)

Abschließend klicken Sie auf **Next**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-be56df3fe44a92619ac7ab6997a37a03827c05d4%2FPL-Usage-0071.png?alt=media)

Dann erneut **Next**, um das SQL-Skript zu exportieren.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-00cdc78e2d878ac486300744cae3775f2d4d85a8%2FPL-Usage-0072.png?alt=media)

Und schließlich eine Erfolgsseite.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-eaa2a81fd5ef4575e4f35c97928ed4b5bd0c3119%2FPL-Usage-0073.png?alt=media)

Wenn Sie die SQL-Skriptdatei öffnen, sehen Sie Folgendes.

Alles in Grün zwischen **/\*** und **\*/** sind Kommentare.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-f7c5e24e5ceb9c81654528c0753f47fe161615a8%2FPL-Usage-0069.png?alt=media)

</details>

<details>

<summary>SQL-Skript mit SQL Server erstellen</summary>

Bei SQL-Server-Datenbanken verwenden Sie **SQL-Server Management Studio**. Dann wählen Sie den View aus und exportieren ihn wie unten gezeigt.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-8a52a51d0aba25c8eef3f7d43b86396643471bbd%2FPL-Usage-0074.png?alt=media)

Diesmal lautet der Dateiname **PT\_SQLSERVER\_PID.sql**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-68f09051369eeae565238452643754c79596e46a%2FPL-Usage-0075.png?alt=media)

**SQL-Server Management Studio** exportiert dann den View.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-f4655d394f5479547820cae2f162ac5925edafe4%2FPL-Usage-0076.png?alt=media)

Wenn Sie die SQL-Datei öffnen, sieht sie so aus:

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-8e82baf1d3708cbbc5c1b1ea8f97bc02b8f20fbf%2FPL-Usage-0077.png?alt=media)

Diese exportierte Datei funktioniert jedoch nicht. Die SQL-Anweisungen müssen mit dem Befehl **EXECUTE('...')** umschlossen werden. Und der GO-Befehl wird ebenfalls nicht benötigt.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-7f5aa88cd7ab692499247ef38ae1cfe7908c2bf5%2FPL-Usage-0078.png?alt=media)

</details>

<details>

<summary>Test mit SQLite</summary>

Löschen Sie den bestehenden View mit SQLite Expert.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-145ffd6f4549341d19b53ec8220ec57b26b3152b%2FPL-Usage-0082.png?alt=media)

Klicken Sie auf **Yes**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-c29b35a455b0cea3246c814ec003b87e7757e9f4%2FPL-Usage-0083.png?alt=media)

Starten Sie nun Plant 3D mit dem Projekt. Starten Sie Plant 3D noch einmal, um sicherzustellen, dass der View ebenfalls gelöscht und dann wieder erstellt wurde.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-a06257a588b279320833e64737ba3d692859dc6b%2FPL-Usage-0084.png?alt=media)

Und schließlich prüfen Sie, ob die Linkkonfiguration **Active** anzeigt.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-e7b4ff0ebe743f1561751e91e09da2f4d1edde52%2FPL-Usage-0085.png?alt=media)

</details>

<details>

<summary>Test mit SQL Server</summary>

Zuerst löschen wir den View, den das SQL-Skript erstellen soll.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-b2884862de8a5a6d9fa2288602874981f64d5fee%2FPL-Usage-0086.png?alt=media)

Der Dialog **Delete Object** öffnet sich, und Sie klicken auf **OK**.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-24b2482e67a0828a8c67d400f3c9402daeb8aa64%2FPL-Usage-0079.png?alt=media)

Wenn Sie Plant 3D mit dem vorhandenen **PT\_SQLSERVER\_PID.sql** starten, erscheint der View erneut. Achten Sie darauf, Plant 3D ein zweites Mal zu starten, da das Skript jetzt den View löschen und danach wieder erstellen soll. Beim ersten Versuch wurde der View bereits von Ihnen gelöscht.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-0a5b63a6465311d1a0f370e84a27f442d648262b%2FPL-Usage-0080.png?alt=media)

Prüfen Sie, ob die Linkkonfiguration **Active** anzeigt. Dann war der Test erfolgreich.

![](https://1597188389-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ftg6rDNE6Mp4JEEHacwjD%2Fuploads%2Fgit-blob-ac267b28452b3c28a3c6160abfb6dc21d462cbfb%2FPL-Usage-0081.png?alt=media)

</details>

[Beispielprojekt herunterladen (Ende)](http://documentation.auxalia.com/EN/PL%20Use%20SQL%20Script.7z)
