3.3.9. Actions in der Datenerfassung

Mit “Actions” können flexible kontextabhängige Aktionen ausgeführt werden.

Diese müssen zuerst in der Administration unter “3.4.4. Actions“ angelegt werden, damit sie in der Datenerfassung verfügbar sind.

Actions können je nach Einstellung in verschiedenen Ebenen (Werk, Fabrik, Produktlinie, Produkt) und Bereichen (im Navigationsbaum, in der Menüleiste des Anzeigefelds oder in Tabellen im Anzeigefeld) verfügbar sein.

Um Actions korrekt anzulegen, bedarf es Wissen im Schreiben von SQL-Abfragen!

3.3.9.1. Action: Listen-SQL

In diesem Beispiel soll eine Liste für Mietzahlungen des aktuellen Monats erstellt werden.

3.3.9.1.1. Action anlegen (Administration)

Zuerst muss eine neue Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.-Action-hinzufügen) angelegt werden.

Da die Action eine aktuelle Übersicht von Mietzahlungen darstellen soll, sollte ein möglichst sprechender Name wie z.B. “Aktuelle Mietzahlungen” eingegeben werden. Es kann eine Beschreibung hinzugefügt oder bei einem selbsterklärenden Actionnamen das Feld für die Beschreibung leer gelassen werden.
Darüber hinaus ist zu berücksichtigen, welcher Zugriff auf die Action gewährt wird, indem die Rechte der Benutzer sowie die Verfügbarkeit der Action festgelegt werden.
Wenn die Action nur in Produktlinien in der Fabrik mit der Fabrik-ID “1” verfügbar sein soll, müssen folgende Bedingungen festgelegt werden:
- Ebene + ist gleich + Produktlinie
- Fabrik-ID + ist gleich + 1
Anschließend muss ein Listen-SQL geschrieben werden. Das kann direkt im Eingabefeld erfolgen oder man öffnet über das Icon einen vergrößerten SQL-Editor.

Listen-SQL: Kopierbares Skript

CODE

SELECT
    ProductName AS Mietvertrag,
    CAST(KM AS money) / 100 AS Kaltmiete,
    CAST(NK AS money) / 100 AS Nebenkosten,
    CAST(KAU AS money) / 100 AS Kaution,
    CAST(GKM AS money) / 100 AS Garagenmiete,
    CAST(GNK AS money) / 100 AS Garagennebenkosten,
    CAST(SK AS money) / 100 AS Sonstiges
FROM (
    SELECT
        v.FactoryID,
        v.ProductLineID,
        v.ProductID,
        p.NameShort AS ProductName,
        TimeID,
        ValueSeriesID,
        ValueInt
    FROM planning.tfValues AS v
    JOIN planning.tdProducts AS p
    ON p.ProductKey = v.ProductKey
    WHERE
        TimeID = FORMAT(GETDATE(), 'yyyyMM') + '15'
        AND v.FactoryID = '{FactoryID}'
        AND v.ProductLineID = '{ProductLineID}'
) AS SourceTable
PIVOT (
    MAX(ValueInt) 
    FOR ValueSeriesID IN (KM, NK, KAU, GKM, GNK, SK)  
) AS PivotTable

Über den Button “Layout-Optionen” können die Felder aus dem Listen-SQL abgerufen und das Layout des Dialogs “Action ausführen” - dieser erscheint, wenn eine Action mit Listen-SQL ausgewählt wird - angepasst werden. Wenn man im Dialog eine rechtsbündige Anzeige von Beträgen in Euro mit zwei Nachkommastellen möchte, kann folgende Einstellung vorgenommen werden:

Nachdem die Action über das Icon gespeichert wurde, kann die neue Action in der Datenerfassung ausgeführt werden.

Da das SQL-Skript Variablen enthält, ist keine Vorschau verfügbar.

3.3.9.1.2. Action ausführen (Datenerfassung)

Die Action “A1 - Aktuelle Mietzahlungen” ist nun ausschließlich in der Fabrik “Leipzig” mit der Fabrik-ID “1” in allen Produktlinien sowie in allen Bereichen (Navigationsbaum /Menüleiste / Anzeigefeld) verfügbar.

Bei Auswahl der Action öffnet sich ein Dialog, in welchem die Mietzahlungen des aktuellen Monats für die Produktlinien dieser Fabrik angezeigt werden.

Möchte man das Layout dieses Dialogs (Spaltenbreite, Ausrichtung der Inhalte der Spalten, usw.) bearbeiten, kann dies in der Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.5.-Button-“Layout-Optionen”) erfolgen.

3.3.9.2. Action: Listen-SQL mit Wert übernehmen

In diesem Beispiel soll eine Liste mit Beträgen angezeigt sowie ein bestimmter Wert bzw. Betrag aus dieser Liste übernommen und in eine Produktdatentabelle eingefügt werden.

3.3.9.2.1. Action anlegen (Administration)

Zuerst muss eine neue Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.-Action-hinzufügen) angelegt werden.

Da mithilfe der Action ein Zellwert übernommen und eingefügt werden soll, sollte ein möglichst sprechender Name wie z.B. “Betrag aus Vormonat übernehmen” eingegeben werden. Es kann eine Beschreibung hinzugefügt oder bei einem selbsterklärenden Actionnamen das Feld für die Beschreibung leer gelassen werden.
Darüber hinaus ist zu berücksichtigen, welcher Zugriff auf die Action gewährt wird, indem die Rechte der Benutzer sowie die Verfügbarkeit der Action festgelegt werden.
Wenn die Action nur in Produkten in der Fabrik mit Fabrik-ID “1” im Bereich der Menüleiste und der Produktdatentabelle in Wertreihen mit einem Wert verfügbar sein soll, müssen folgende Bedingungen festgelegt werden:
- Ebene + ist gleich + Produkt
- Fabrik-ID + ist gleich + 1
- Wertreihen-ID+ ist nicht null
- Bereich + ist gleich + Zelle
Anschließend muss ein Listen-SQL geschrieben werden. Das kann direkt im Eingabefeld erfolgen oder man öffnet über das Icon einen vergrößerten SQL-Editor.

Listen-SQL: Kopierbares Skript

CODE

SELECT
    FORMAT(CONVERT(DATE, CAST(TimeID AS CHAR(8)), 112), 'MMMM yyyy', 'de-DE') AS Monat,
    CAST(ValueInt AS money) / 100 AS Betrag
FROM planning.tfValues AS v
JOIN planning.tdProducts AS p
ON p.ProductKey = v.ProductKey
WHERE
    v.FactoryID = '{FactoryID}'
    AND v.ProductLineID = '{ProductLineID}'
    AND v.ProductID = '{ProductID}'
    AND v.ValueSeriesID = '{ValueSeriesID}'
ORDER BY TimeID DESC

Über den Button “Layout-Optionen” können die Felder aus dem Listen-SQL abgerufen und das Layout des Dialogs “Action ausführen” - dieser erscheint, wenn eine Action mit Listen-SQL ausgewählt wird - angepasst werden. Wenn man im Dialog eine rechtsbündige Anzeige der Monate sowie eine linksbündige Anzeige von Beträgen in Euro mit zwei Nachkommastellen möchte, kann folgende Einstellung vorgenommen werden:

Damit ein Feldwert übernommen werden kann, muss bei “Ausgewählten Feldwert übernehmen” der gewünschte Feldwert (Betrag) in einem Drop-down-Menü ausgewählt werden.
Nachdem die Action über das Icon gespeichert wurde, kann die neue Action in der Datenerfassung ausgeführt werden.

Da das SQL-Skript Variablen enthält, ist keine Vorschau verfügbar.

3.3.9.2.2. Action ausführen (Datenerfassung)

Die Action “A2 - Betrag aus Vormonat übernehmen” ist nun ausschließlich in der Fabrik “Leipzig” mit der Fabrik-ID “1” in allen Produkten ausschließlich in einer Zelle in der Produktdatentabelle in Wertreihen mit einem Wert verfügbar.

Bei Auswahl der Action öffnet sich ein Dialog, in welchem die Monate sowie das Jahr mit den entsprechenden Beträgen angezeigt werden. Da die Action für das Beispiel in einer Wertreihenzelle mit der Time-ID 202503 (März 2025) geöffnet wurde, kann man den Betrag aus dem Vormonat Februar 2025 übernehmen.
Möchte man das Layout dieses Dialogs (Spaltenbreite, Ausrichtung der Inhalte der Spalten, usw.) bearbeiten, kann dies in der Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.5.-Button-“Layout-Optionen”) erfolgen.

Nachdem die entsprechende Zeile in der Tabelle ausgewählt wurde, kann der Wert mit Auswahl des Buttons “Wert übernehmen” oder mit einem Doppel-Linksklick auf die entsprechende Zeile direkt in die Produktdatentabelle übernommen werden.
Der ausgewählte Wert wurde übernommen:

3.3.9.3. Action: Kombination von Listen-SQL und Action-SQL

In diesem Beispiel soll eine Liste mit Verträgen erstellt, daraus ein Vertrag ausgewählt und dieser in einer separaten Produktlinie archiviert werden.

3.3.9.3.1. Action anlegen (Administration)

Zuerst muss eine neue Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.-Action-hinzufügen) angelegt werden.

Da mithilfe der Action ein Vertrag in einer Liste ausgewählt und danach archiviert werden soll, sollte ein möglichst sprechender Name wie z.B. “Vertrag archivieren” eingegeben werden. Es kann eine Beschreibung hinzugefügt oder bei einem selbsterklärenden Actionnamen das Feld für die Beschreibung leer gelassen werden.
Darüber hinaus ist zu berücksichtigen, welcher Zugriff auf die Action gewährt wird, indem die Rechte der Benutzer sowie die Verfügbarkeit der Action festgelegt werden.
Wenn die Action nur in Produktlinien in der Fabrik mit Fabrik-ID “1” im Navigationsbaum verfügbar sein soll, müssen folgende Bedingungen festgelegt werden:
- Ebene + ist gleich + Produktlinie
- Fabrik-ID + ist gleich + 1
- Bereich + ist gleich + Baum
Anschließend muss ein Listen-SQL geschrieben werden, um eine Übersicht der für das Archivieren verfügbaren Verträge zu erhalten. Das kann direkt im Eingabefeld erfolgen oder man öffnet über das Icon einen vergrößerten SQL-Editor.

Listen-SQL: Kopierbares SQL-Skript

CODE

SELECT
    ProductID,
    NameShort AS Mietvertrag
FROM planning.tdProducts
WHERE
    FactoryID = '{FactoryID}'
    AND ProductLineID = '{ProductLineID}'

Über den Button “Layout-Optionen” können die Felder aus dem Listen-SQL abgerufen und das Layout des Dialogs “Action ausführen” - dieser erscheint, wenn eine Action mit Listen-SQL ausgewählt wird - angepasst werden.

Damit ein Vorgang ausgeführt bzw. ein Vertrag aus einer Liste ausgewählt und in einer anderen Produktlinie archiviert werden kann, muss ein Action-SQL geschrieben werden. Das kann direkt im Eingabefeld erfolgen oder man öffnet über das Icon einen vergrößerten SQL-Editor.

Action-SQL: Kopierbares SQL-Skript

CODE

EXEC dbo.sx_pf_MOVE_Product
    @Username = 'SQL',
    @SourceFactoryID = '{FactoryID}',
    @SourceProductLineID = '{ProductLineID}',
    @SourceProductID = '{LIST_ProductID}',
    @TargetFactoryID = '{FactoryID}',
    @TargetProductLineID = '999',
    @TargetProductID = '{ProductID}'

Da der Vorgang der Archivierung im Navigationsbaum stattfindet und dieser standardmäßig manuell neu geladen werden muss, empfiehlt es sich, die Checkbox “Baum nach Action neu laden” zu aktivieren.
Nachdem die Action über das Icon gespeichert wurde, kann die neue Action in der Datenerfassung ausgeführt werden.

Da das SQL-Skript Variablen enthält, ist keine Vorschau verfügbar.

3.3.9.3.2. Action ausführen (Datenerfassung)

Die Action “A3 - Vertrag archivieren” ist nun ausschließlich in der Fabrik “Leipzig” mit der Fabrik-ID “1” in allen Produktlinien ausschließlich im Navigationsbaum verfügbar.

Bei Auswahl der Action öffnet sich ein Dialog, in welchem die Produkte bzw. die verschiedenen Mietverträge angezeigt werden.
Möchte man das Layout dieses Dialogs (Spaltenbreite, Ausrichtung der Inhalte der Spalten, usw.) bearbeiten, kann dies in der Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.5.-Button-“Layout-Optionen”) erfolgen.

Nachdem die entsprechende Zeile in der Liste bzw. Tabelle ausgewählt wurde, kann die Action “Vertrag archivieren” ausgeführt werden.
Der Navigationsbaum wird automatisch aufgrund der aktivierten Checkbox “Baum nach Action neu laden” aktualisiert und der Vertrag in die Produktlinie “Archiv Leipzig” mit der Produktlinien-ID “999” verschoben bzw. dort archiviert.

3.3.9.4. Action: Action-SQL ohne Listen-SQL

In diesem Beispiel soll eine Action direkt ohne die Anzeige einer Liste ausgeführt werden, indem ein Vertrag ausgewählt und direkt verschoben bzw. archiviert wird.

3.3.9.4.1. Action anlegen (Administration)

Zuerst muss eine neue Action in der Administration (siehe: 3.4.4. Actions | 3.4.4.2.-Action-hinzufügen) angelegt werden.

Da mithilfe der Action ein Vertrag direkt archiviert werden soll, sollte ein möglichst sprechender Name wie z.B. “Diesen Vertrag archivieren” eingegeben werden. Es kann eine Beschreibung hinzugefügt oder bei einem selbsterklärenden Actionnamen das Feld für die Beschreibung leer gelassen werden.
Darüber hinaus ist zu berücksichtigen, welcher Zugriff auf die Action gewährt wird, indem die Rechte der Benutzer sowie die Verfügbarkeit der Action festgelegt werden.
Wenn die Action nur in Produkten in der Fabrik mit Fabrik-ID “1” im Navigationsbaum verfügbar sein soll, müssen folgende Bedingungen festgelegt werden:
- Ebene + ist gleich + Produkt
- Fabrik-ID + ist gleich + 1
- Bereich + ist gleich + Baum
Anschließend muss ein Action-SQL geschrieben werden, um direkt eine Action ohne eine vorherige Listenübersicht auszuführen. Das kann direkt im Eingabefeld erfolgen oder man öffnet über das Icon einen vergrößerten SQL-Editor.

Action-SQL: Kopierbares SQL-Skript

CODE

EXEC dbo.sx_pf_MOVE_Product
    @Username = 'SQL',
    @SourceFactoryID = '{FactoryID}',
    @SourceProductLineID = '{ProductLineID}',
    @SourceProductID = '{ProductID}',
    @TargetFactoryID = '{FactoryID}',
    @TargetProductLineID = '999',
    @TargetProductID = '{ProductID}'

Da der Vorgang der Archivierung im Navigationsbaum stattfindet und dieser standardmäßig manuell neu geladen werden muss, empfiehlt es sich, die Checkbox “Baum nach Action neu laden” zu aktivieren.
Nachdem die Action über das Icon gespeichert wurde, kann die neue Action in der Datenerfassung ausgeführt werden.

Für das Action-SQL kann kein Layout erstellt werden und es ist keine Vorschau verfügbar.

3.3.9.4.2. Action ausführen (Datenerfassung)

Die Action “A4 - Diesen Vertrag archivieren” ist nun ausschließlich in der Fabrik “Leipzig” mit der Fabrik-ID “1” für alle Produkte ausschließlich im Navigationsbaum verfügbar.

Bei Auswahl der Action öffnet sich kein Dialog. Das Produkt bzw. der Mietvertrag wird direkt verschoben bzw. archiviert.
Der Navigationsbaum wird automatisch aufgrund der aktivierten Checkbox “Baum nach Action neu laden” aktualisiert und der Vertrag in die Produktlinie “Archiv Leipzig” mit der Produktlinien-ID “999” verschoben bzw. dort archiviert.