# Erstellen eines benutzerdefinierten Berichtsskripts

{% hint style="warning" %}
Mit unserem kommenden Release, das für **Q1 2026** geplant ist, werden wir unsere Reporting-Engine von **DevExpress Version 21.1.4 auf 24.2.7** aktualisieren. Dieses Upgrade bringt Verbesserungen mit sich, enthält jedoch auch Änderungen an der Scripting-API, die dazu führen können, dass bestehende benutzerdefinierte Skripte nicht mehr funktionieren, wenn sie nicht aktualisiert werden.

#### 📌 Was Sie tun müssen

Damit Ihre Skripte weiterhin korrekt funktionieren:

* Überprüfen Sie Ihre benutzerdefinierten Report-Skripte.
* Nutzen Sie die DevExpress API Reference, um Eigenschaften und Methoden bei Bedarf entsprechend anzupassen.

**Zum Beispiel:**

* `FieldByName` ist nicht mehr gültig. Verwenden Sie stattdessen `GetFieldByName`, das nun eine Instanz von `PivotGridFieldBase` zurückgibt.
* `XRPivotGridField` heißt jetzt `XRPivotGridFieldBase`.
* Skriptreferenzen wie\
  `PivotTableStatusPriorityCounts.Fields.FieldByName`\
  sollten ersetzt werden durch\
  `PivotTableStatusPriorityCounts.Fields.GetFieldByName`.

#### 🗂 Referenzen:

[DevExpress API – XRPivotGridFieldCollection](https://docs.devexpress.com/XtraReports/DevExpress.XtraReports.UI.PivotGrid.XRPivotGridFieldCollection)

**DevExpress Changelog:**\
<https://supportcenter.devexpress.com/versionhistory?utm_source=chatgpt.com>

***

#### 🆘 Unterstützung benötigt?

Wenn Sie Schwierigkeiten bei der Aktualisierung Ihrer Report-Skripte haben, können Sie ein Support-Ticket einreichen. Das aqua-Team unterstützt Sie gerne bei der Anpassung Ihrer individuellen Skripte.

Wir begleiten Sie während der Umstellung!
{% endhint %}

{% hint style="warning" %}
📅 **Wie geht es weiter?**\
Wir werden Sie im Voraus über alle Änderungen informieren.
{% endhint %}

\
Das Skripting spielt eine Schlüsselrolle bei der Erweiterung der Funktionalität von Aqua-Berichten. Es ermöglicht Ihnen, die Fähigkeiten des Berichts über die Daten in Aqua hinaus zu erweitern. Mit Skripting können Sie den Bericht bereichern, indem Sie Daten aus externen Quellen wie Datenbanken oder Dateien extrahieren. Sie haben auch die Möglichkeit, Kopien des Berichts auf bestimmten Netzwerklaufwerken zu speichern und zu steuern, welche Elemente beim Drucken während jeder Ereignisbanditeration ausgeschlossen werden.

Um ein Skript bei einem bestimmten Ereignis auszuführen, müssen Sie eine Skriptfunktion zum Ereignis des Elements hinzufügen. Sie können dies tun, indem Sie eine Skriptmethode mit der Eigenschaft <mark style="background-color:blue;">Behaviour/Scripts</mark> verknüpfen. Diese Eigenschaft listet alle Ereignisse auf, die das ausgewählte Element auslösen wird. Diese können für verschiedene Elementtypen unterschiedlich sein.\ <br>

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F24xdELaYcnvT80BeTuCW%2Fimage.png?alt=media&#x26;token=0b8e5255-6b7b-4d2a-8b48-86260940ff83" alt=""><figcaption></figcaption></figure>

Um zur Skript-Ansicht zu wechseln, klicken Sie auf ![](https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2FUR5414REaD5ZbXh7j5BQ%2Fimage.png?alt=media\&token=39c6ee96-efd9-4aaf-be8a-be4a6e16b501). Hier können Sie Ihrem Bericht einige Funktionen hinzufügen:&#x20;

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F9RvQlDRc6JA1NltyicLP%2Fimage.png?alt=media&#x26;token=760e7102-6b00-49e2-881b-4db6a1c72924" alt=""><figcaption></figcaption></figure>

### Beispiel: Unterschiedliche Farbe auf Bereiche anwenden

Das Aussehen kann mit dem Ereignis „OnPrintPage“ modifiziert werden.

<figure><img src="https://1531273042-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FG5QhcVbqFZtVzVvlkYfm%2Fuploads%2F3y3Zpo3RDV05izL0fQru%2Fimage.png?alt=media&#x26;token=874aa748-7e0c-4292-adc0-e91b619ad30f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Die Erscheinung muss nicht unbedingt durch das Skript geändert werden. Sie kann auch durch Formatierungsregeln geändert werden.
{% endhint %}

{% hint style="info" %}
Für Benutzer in einer SaaS-Umgebung: Bitte beachten Sie, dass das Berichtsskript nur über den Desktop-Client verwaltet werden kann.&#x20;

Die Informationen zur Aktivierung des Skriptmodus für On-Premise-Kunden finden Sie in diesem <mark style="color:red;">Artikel</mark>.
{% endhint %}