Skip to main content
Skip table of contents

3.4.4. Actions

Hier werden Actions angelegt, die dann in der Datenerfassung je nach Einstellung der Verfügbarkeit auf allen Ebenen verfügbar sind. Mit Actions kann man Werte sowie Übersichten anzeigen, Werte einfügen oder Vorgänge ausführen lassen.

Verschiedene Anwendungsbeispiele für Actions in der Datenerfassung finden Sie hier: 3.3.9. Actions in der Datenerfassung

Anpassungen für die Actions können in den Einstellungen in den jeweiligen Anpassungen der Ebenen und Bereiche (siehe: 3.4.10. Einstellungen) vorgenommen werden.

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

image-20250325-080636.png

Startansicht “Actions”

3.4.4.1. Menüleiste (A)

Die Menüleiste mit ihren Funktionen ist für den gesamten Bereich “Actions” anwendbar. Actions können neu hinzugefügt, bearbeitet, gespeichert, importiert, exportiert, kopiert und gelöscht werden.

image-20250324-140957.png

Icon image-20241007-114928.png “Action hinzufügen”

  • Über dieses Icon kann eine neue Action hinzugefügt werden. Es öffnet sich dazu ein neuer Dialog, in welchem der neuen Action ein Name vergeben werden muss.

image-20250318-111235.png

Icon image-20241007-114822.png “Action speichern”

  • Alle Änderungen werden gespeichert.

Icon image-20241009-083328.png “Action importieren”

  • Bei Auswahl dieses Icons öffnet sich ein neuer Dialog, in welchem eine JSON-Datei von einem lokalen Speicherort importiert werden kann.

  • Die importierte Action wird automatisch mit der nächsten verfügbaren Action-ID der Übersicht hinzugefügt.

  • Es können mehrere Actions auf einmal importiert werden, wenn diese zusammen exportiert wurden.

Icon image-20250130-092729.png “Action exportieren”

  • Bei Auswahl dieses Icons öffnet sich ein neuer Dialog, in welchem eine oder mehrere zu exportierende Actions ausgewählt werden müssen.

  • Der Export kann als JSON-Datei oder als SQL-Datei erfolgen.

  • Der Export wird nach Auswahl des Buttons “Anwenden” automatisch gestartet und die ausgewählten Actions auf einen lokalen Speicherort exportiert.

image-20250226-103122.png

  • Die Action wird mit folgender Namenskonvention exportiert: “OCT_actions_<timestamp>”, z.B. “OCT_actions_2024_12_17-13_34”. Der Zeitstempel gibt das Jahr, den Monat, den Tag sowie die Uhrzeit des Exports an.

  • Die Beschreibung zur Bedienung der Tabelle und ihren Funktionen finden Sie hier: 4.1. Tabellen - allgemeine Features | 4.1.1.-Tabellentyp-1

Icon image-20250325-081246.png “Action kopieren”

  • Um eine Action zu kopieren, muss zuerst die zu kopierende Action aus der Übersicht ausgewählt werden.

  • Bei Auswahl des Icons wird die ausgewählte Action mit all ihren Details kopiert und direkt der Übersicht mit der nächsten verfügbaren Action-ID hinzugefügt.

Icon image-20250325-081308.png “Actions löschen”

  • Bei Auswahl dieses Icons öffnet sich ein neuer Dialog, in welchem eine oder mehrere Actions gelöscht werden können.

  • Die Action, welche vor der Auswahl des Icons ausgewählt war, ist im Dialog bereits markiert.

image-20250325-081201.png
image-20250325-081811.png

Icon image-20250324-141059.png “Ausführungsprotokoll der Action”

  • Bei Auswahl des Icons öffnet sich ein Dialog mit dem Ausführungsprotoll der Actions.

image-20250327-160621.png

  • Es werden in der Tabelle folgende Details angezeigt:

    • Ausführender Benutzer = Benutzername des Benutzers, der die Action ausgeführt hat.

    • Action-ID = individuelle ID der ausgeführten Action

    • Startort = Stelle in der Datenerfassung, von wo aus die Action gestartet bzw. ausgeführt wurde. Schwebt man mit dem Cursor über dem Startort in einer Zeile, werden alle verfügbaren Informationen zum Objekt bzw. Ort im JSON Format angezeigt.

    • Ausführungszeit = Datum und Uhrzeit, wann die Action gestartet wurde.

    • Ausführungsart = ACTION (Ausführung eines Action-SQLs) oder LIST (Ausführung eines Listen-SQLs)

    • Ausführungs-SQL = SQL-Skript der Action, welches ausgeführt wurde.

  • Die Ausführung eines Listen-SQL für eine Vorschau über den Button “Vorschau” wird im Ausführungsprotokoll nicht angezeigt.

  • Die Beschreibung zur Bedienung der Tabelle und ihren Funktionen finden Sie hier: 4.1. Tabellen - allgemeine Features | 4.1.1.2.-Tabellentyp-1---Beispiel-2

3.4.4.2. Action hinzufügen

Beim Hinzufügen einer neuen Action müssen die dazugehörigen Details und Daten eingetragen werden. Die Detailübersicht ist in drei Bereiche unterteilt: “Allgemein”, “Action” und “Speichern & neu laden”.

Als Action-ID wird automatisch die nächste verfügbare ID vergeben.

image-20250325-083247.png

3.4.4.2.1. Allgemein (a)

Hier werden allgemeine Daten für die Action festgelegt.

image-20250325-083742.png

Checkbox image-20250130-094823.png “Aktiv”

  • Über diese Checkbox kann die Action (de-)aktiviert werden.

  • Deaktivierte Actions werden in der Actionübersicht in hellgrauer Schriftfarbe angezeigt.

  • Aktive Actions werden in der Actionübersicht in schwarzer Schriftfarbe angezeigt.

Name

  • Der Action sollte ein möglichst beschreibender Name gegeben werden.

Beschreibung

  • Dies ist ein Eingabefeld für eine optionale Beschreibung.

  • Die Beschreibung wird nach dem Speichern als Tooltip neben dem Actionnamen in der Actionübersicht angezeigt, wenn man mit der Maus über dem Tooltip-Icon image-20250221-091433.png schwebt.

image-20250325-083846.png

  • Die Beschreibung wird auch in der Datenerfassung neben dem Actionnamen angezeigt.

3.4.4.2.2. Action (b)

In diesem Bereich wird definiert, welche Action an welcher Stelle für Benutzer mit bestimmten Benutzerrechten verfügbar ist. Des Weiteren werden hier Listen-SQL und Action-SQL geschrieben, um mithilfe der Action Übersichten zu erstellen, Werte zu übernehmen oder Vorgänge auszuführen.

image-20250325-084515.png

Checkbox image-20250130-094823.png “Erfordert Schreibrechte auf Werkebene”

  • Hier wird definiert, welche Benutzerrechte in der Datenerfassung eingestellt sein müssen.

  • Standardmäßig ist die Checkbox aktiviert.

  • Bei aktivierter Checkbox, muss der Benutzer Schreibrechte (Write) auf Werkebene in der Datenerfassung besitzen, um diese Action zu sehen und auszuführen.

  • Bei deaktivierter Checkbox benötigt der Benutzer keine Schreibrechte (Write) auf Werkebene und kann die Action abhängig von den anderen Verfügbarkeits-Einstellungen sehen und ausführen.

  • Besitzt der Benutzer z.B. nur Leserechte (Read) auf Werkebene in der Datenerfassung, sind für ihn bei Auswahl der Option “Actions” über den Navigationsbaum oder ein Kontextmenü usw. keine Actions sichtbar.

Checkbox image-20250130-094823.png “Erfordert Schreibrechte auf Objekt”

  • Hier wird definiert, welche Benutzerrechte in der Datenerfassung eingestellt sein müssen.

  • Standardmäßig ist die Checkbox aktiviert.

  • Bei aktivierter Checkbox, muss der Benutzer Schreibrechte (Write) auf das Objekt in der Datenerfassung haben, in dem die Action ausgeführt wird.

  • Bei deaktivierter Checkbox kann der Benutzer eingeschränkte Rechte haben und trotzdem die Action sehen sowie ausführen.

Einschränkung der Verfügbarkeit

Listen-SQL

  • Über “Listen-SQL” kann man sich bestimmte Daten in einem Dialog anzeigen lassen. Dafür muss man den entsprechenden Befehl in den SQL-Editor schreiben.

  • Eine detaillierte Beschreibung dazu finden Sie hier: 3.4.4. Actions | 3.4.4.2.4.-Listen-SQL

Icon image-20250114-131412.png “SQL-Editor öffnen”

  • Über das Icon kann ein separater Dialog mit einem vergrößerten SQL-Editor geöffnet werden.

image-20250221-093418.png

Tooltip image-20250221-091433.png

  • Schwebt man mit der Maus über dem Tooltip-Icon, erhält man zusätzliche Informationen zum Verfassen des Listen-SQLs.

Button “Layout-Optionen”

Button “Vorschau”

  • Bei Auswahl dieses Buttons öffnet sich ein Dialog, der die Vorschau des Dialogs “Action ausführen” in der Datenerfassung ist.

  • Die Vorschau zeigt, welche Daten bei der Ausführung der des Listen-SQL Befehls zurückgegeben werden.

  • Eine detaillierte Beschreibung dazu finden Sie hier: 3.4.4. Actions | 3.4.4.2.6.-Button-“Vorschau”-Listen-SQL

Checkbox image-20250130-094823.png “Zellwert als Filter für Liste anwenden”

  • Bei aktivierter Checkbox kann die Anzeige der Inhalte im Dialog “Action ausführen” (Tabelle im Dialog) direkt nach einem bestimmten Inhalt/Wert gefiltert werden. Dafür muss die Action direkt aus einer Zelle in einer Produktdatentabelle heraus gestartet werden.

  • Beispiel: Der Zellwert einer Produktdatentabelle ist ”30.00”. Von dieser Zelle aus wird die Action gestartet.

image-20250317-095718.png

  • Die Tabelle im Dialog “Action ausführen” wird direkt nach diesem Zellwert gefiltert.

image-20250317-095840.png

  • Optional kann die Tabelle in diesem Dialog auch über das Suchfeld gefiltert werden.

image-20250224-103250.png

Liste bei Filteränderung neu laden

  • Standardmäßig ist diese Checkbox aktiviert.

  • Bei aktivierter Checkbox werden, wenn der neue Filter im Suchfeld des Dialogs “Action ausführen” geändert wird, die Daten im Listen-SQL Dialog neu geladen.

Action-SQL

  • Über “Action-SQL” kann man beliebige SQL Befehle ausführen lassen. Dafür muss man den entsprechenden Befehl in den SQL-Editor schreiben.

  • Eine detaillierte Beschreibung dazu finden Sie hier: 3.4.4. Actions | 3.4.4.2.7.-Action-SQL

Icon image-20250114-131412.png “SQL-Editor öffnen”

  • Über das Icon kann ein separater Dialog mit einem vergrößerten SQL-Editor geöffnet werden.

Tooltip image-20250221-091433.png

  • Schwebt man mit der Maus über dem Tooltip-Icon, erhält man zusätzliche Informationen zum Verfassen des Listen-SQLs.

Ausgewählten Feldwert übernehmen

  • Über diese Option kann ein aus dem Listen-SQL stammendes Feld in einem Drop-down-Menü ausgewählt werden.

  • Der Wert der ausgewählten Zeile und des hier gesetzten Felds wird in die Zelle übernommen, von der aus die Action gestartet wurde.

  • Eine detaillierte Beschreibung dazu finden Sie hier: 3.4.4. Actions | 3.4.4.2.8.-Ausgewählten-Feldwert-übernehmen

3.4.4.2.3. Einschränkung der Verfügbarkeit

In diesem Bereich können Bedingungen zusammengestellt werden, an welchem Ort in der Datenerfassung die Action verfügbar sein soll. Dafür muss die Verfügbarkeit der Action über das Eingabefeld für die Filterkomponenten eingeschränkt werden.

Die Option “Action” wird zwar in den Kontextmenüs oder Menüleisten des jeweiligen Ortes angezeigt, aber die beim Aufklappen der Option “Action” angezeigten Actions können mittels Bedingungen eingeschränkt werden.

  • Standardmäßig wird im Eingabefeld für die Filterkomponenten das Feld “Und” hinzugefügt. Es kann zwischen den Optionen “Und”, “Oder”, “Nicht Und”, “Nicht Oder” gewählt werden.

  • Man kann Bedingungen hinzufügen, indem man auf das “Plus-Zeichen” image-20250220-122003.png neben “Und” klickt. Es öffnet sich ein Kontextmenü mit zwei Optionen: “Bedingung hinzufügen” und “Gruppe hinzufügen”.

image-20250325-084856.png

3.4.4.2.3.1. Bedingung hinzufügen

  • Wählt man “Bedingung hinzufügen” wird im Eingabefeld standardmäßig eine Zeile mit den Feldern “Ebene”, “Ist gleich” und “<Wert eingeben> hinzugefügt.

image-20250220-124419.png

  • Mit einem Linksklick auf das erste Feld (gelbes Feld) öffnet sich ein Drop-down-Menü mit einer Auswahl an weiteren fest definierten Feldern, anhand deren eine Bedingung erstellt werden kann:

image-20250325-085144.png

Beispiel für “Ebene”

Ebene

  • Dieses Feld bezieht sich auf die verschiedenen Ebenen in der Datenerfassung: Werkebene, Fabrikebene, Produktlinienebene, Produktebene

Bereich

  • Dieses Feld bezieht sich auf den Bereich, in welchem die Action angezeigt bzw. ausgeführt werden soll: in Kontextmenüs im Navigationsbaum (Baum), in der Menüleiste für das Anzeigefeld des Systemtabs in den verschiedenen Ebenen der Datenerfassung (Symbolleiste) sowie in Zellen (Zelle) der Tabelle des Anzeigefelds des Systemtabs und in Zellen (Zelle) der Produktdatentabelle.

Benutzername

  • Dieses Feld bezieht sich auf den aktuell eingeloggten Benutzer, der die Action ausführen soll.

  • Damit kann die Verfügbarkeit der Action für bestimmte Benutzer eingeschränkt werden.

Fabrik-ID, Produktlinien-ID, Produkt-ID

  • Diese Felder beziehen sich auf die ID der verschiedenen Ebenen in der Datenerfassung.

Fabrikname, Produktlinienname, Produktname

  • Diese Felder beziehen sich auf den Namen der verschiedenen Ebenen in der Datenerfassung.

Vorlage

  • Dieses Feld bezieht sich auf den Namen der Vorlage, die dem Produkt zugeordnet ist.

Wertreihen-ID, Wertreihenname, Time-ID, Wert

  • Diese Felder beziehen auf verschiedene Elemente der Produktdatentabelle.

Wert

  • Dieses Feld bezieht sich auf den Wert einer Zelle der Produktdatentabelle oder auf Produktlinienebene auf den Wert einer Zelle der Tabelle im Anzeigefeld des ProductLine-Tabs.

Globalattribute 1 bis …

  • Diese Felder beziehen sich auf die Globalattribute.

  • Mit einem Linksklick auf das zweite Feld (grünes Feld) öffnet sich ein Drop-down-Menü mit einer Auswahl an Operatoren.

  • Beispiel für das Feld “Ebene”:

image-20250325-085318.png

Beispiel für “Ebene”

  • Für die Felder “Ebene” und “Bereich” kann zwischen folgenden Optionen gewählt werden:

Ist gleich

Ist nicht gleich

Ist null

Ist nicht null

  • Beispiel für das Feld “Fabrik-ID”:

image-20250325-085501.png

Beispiel für “Fabrik-ID”

  • Für die Felder “Benutzername”, “Fabrik-ID”, “Fabrikname”, “Produktlinien-ID”, “Produktlinienname”, “Produkt-ID”, “Produktname”, “Vorlage”, “Wertreihen-ID”, “Wertreihenname”, “Time-ID”, “Wert”, “Suchstring”, Globalattribut 1”, “Globalattribut 2” usw. kann zwischen folgenden Optionen gewählt werden:

Ist gleich

Ist nicht gleich

Enthält

Enthält nicht

Beginnt mit

Endet mit

Ist null

Ist nicht null

  • Mit einem Linksklick auf das dritte Feld (graues Feld) öffnet sich ein Drop-down-Menü mit einer Auswahl an weiteren. Optionen

  • Da das erste Feld “Ebene” ist, kann im Drop-down-Menü zwischen der Werkebene (Werk), der Fabrikebene (Fabrik), der Produktlinienebene (Produktlinie) oder der Produktebene (Produkt) gewählt werden.

image-20250325-090524.png

Beispiel für “Ebene”

Werk

  • Werkebene in der Datenerfassung

Fabrik

  • Fabrikebene in der Datenerfassung

Produktlinie

  • Produktlinienebene in der Datenerfassung

Produkt

  • Produktebene in der Datenerfassung

  • Da das erste Feld “Bereich” ist, kann im Drop-down-Menü der Bereich “Baum”, “Symbolleiste” oder “Zelle” ausgewählt werden. Diese Felder bestimmen, in welchem Bereich die Action in der Datenerfassung angezeigt werden soll.

image-20250325-091206.png

Baum

  • Bereich “Navigationsbaum” in der Datenerfassung

Symbolleiste

  • Bereich “Menüleiste”, welche über dem Anzeigefeld eines Systemtabs oder in einem Produkt über der Produktdatentabelle angezeigt wird.

Zelle

  • Bereich “Zelle” …

    • in einer Zelle der Tabelle im Anzeigefeld des ProductLine-Tabs mit den Globalattributen der zugehörenden Produkten.

    • in einer Zelle der Produktdatentabelle

  • Da das erste Feld “Fabrik-ID” ist, ist für das Eingabefeld kein Wert vorgegeben. Dieser Wert kann individuell bestimmt werden. Das gleiche gilt für die weiteren Felder “Benutzername”, “Fabrikname”, “Produktlinien-ID”, “Produktlinienname”, “Produkt-ID”, “Produkt”, “Vorlage”, “Wertreihen-ID”, “Wertreihenname”, “Time-ID”, “Wert”, “Suchstring”, “Globalattribut 1”, “Globalattribut 2” usw.

image-20250325-092240.png

3.4.4.2.3.2. Gruppe hinzufügen

  • Wählt man “Gruppe hinzufügen” wird im Eingabefeld für die Filterkomponenten standardmäßig den bestehenden Bedingungen eine Zeile mit “Und” hinzugefügt, um eine Gruppe innerhalb einer Bedingung zu bilden.

image-20250327-203529.png

  • Mit den oben definierten Bedingungen in einer hinzugefügten Gruppe, ist die Action nur in Fabriken verfügbar (1. Bedingung) und die Fabrik-ID muss 1 oder 2 (2. Bedingung) sein.

  • Die Gruppe unterliegt den gleichen Zusammensetzungsmöglichkeiten wie die Option “Bedingung hinzufügen” bzw. die wählbaren Bedingungen sind die gleichen und deshalb nur einmal beschrieben (siehe: 3.4.4. Actions | 3.4.4.2.3.1.-Bedingung-hinzufügen).

Es müssen mindestens zwei Bedingungen in einer Gruppe hinzugefügt werden, damit diese als Gruppe erkannt werden. Beim Hinzufügen nur einer Bedingung wird diese nicht als Gruppe erkannt und der übergeordneten Gruppe als weitere Bedingung hinzugefügt.

3.4.4.2.3.3. Verfügbarkeit der Actions

Es kann individuell bestimmt werden, an welchem Ort der Datenerfassung die Actions verfügbar sein sollen.

Auf allen Ebenen (Werk, Fabrik, Produktlinie, Produkt) können Actions im Navigationsbaum (Bereich “Baum”) und in der Menüleiste (Bereich “Symbolleiste”) verwendet werden.

Zusätzlich können Actions auf der Ebene “Produktlinie” (Bereich “Zelle” = Eingabefeld in der Anzeigetafel für Globalattribute) sowie auf der Ebene “Produkt” (Bereich “Zelle” = Zelle in der Produktdatentabelle) in Zellen verwendet werden.

Beispiel 1

  • Man kann bestimmen, auf welcher Ebene die Action verfügbar ist, indem die Felder “Ebene”, “Ist gleich” und z.B. “Fabrik” ausgewählt werden. Dies hat zur Folge, dass die Action nur auf Fabrikebene verfügbar ist.

image-20250325-092824.png

  • Die Action kann nun auf Fabrikebene im Navigationsbaum und in der Menüleiste des Anzeigefelds ausgewählt werden. Wenn man mit der Maus über der Action schwebt, wird die Beschreibung der Action als Tooltip rechts daneben angezeigt.

image-20250325-093122.png

Beispiel “Action im Baum”

image-20250325-093535.png

Beispiel “Action in der Menüleiste des Anzeigefelds (Symbolleiste)”

  • Die Action ist mit der Einstellung dieser Bedingung auf anderen Ebenen, z.B. im Werk, nicht sichtbar. Wenn man mit der Maus über dem Menüpunkt “Actions” schwebt, wird die Meldung “Keine passenden Actions gefunden” angezeigt.

image-20250220-132203.png

Beispiel “Keine Action auf Werkebene gefunden”

Beispiel 2

  • Man kann bestimmen, in welchem Bereich die Action verfügbar ist. Das heißt, man kann man festlegen, ob die Action im Navigationsbaum (Baum), in der Menüleiste des Anzeigefelds (Symbolleiste) oder auf Produktlinienebene in Eingabefeldern (Zelle) des Anzeigefeld für die Globalattribute der Produkte oder in Zellen (Zelle) der Produktdatentabelle angezeigt wird.

  • Indem z.B. in der ersten Bedingung die Felder “Ebene”, “Ist gleich” und “Produkt” sowie in der zweiten Bedingung die Felder “Bereich”, “Ist gleich” und “Zelle” ausgewählt werden, kann man festlegen, dass die Action nur in der Ebene “Produkt” im Bereich “Zelle” angezeigt wird.

image-20250326-090044.png

Beispiel “Nur in Zelle anzeigen”

  • Obwohl man sich in der Produktebene befindet, wird im Navigationsbaum keine Action angezeigt, da diese nur in Zellen angezeigt werden soll.

image-20250326-090332.png

Beispiel “Ansicht im Navigationsbaum (Baum)”

  • Obwohl man sich in der Produktebene befindet, wird in der Menüleiste keine Action angezeigt, da diese nur in Zellen angezeigt werden soll.

image-20250326-090506.png

Beispiel “Ansicht in der Menüleiste (Symbolleiste)”

  • Wenn man die Action im Produkt über eine Zelle in der Produktdatentabelle öffnet, wird die Action angezeigt.

image-20250326-090721.png

Beispiel “Ansicht in der Zelle einer PDT (Zelle)”

Beispiel 3

  • Man kann bestimmen, in welchem Bereich die Action verfügbar ist. Das heißt, man kann man festlegen, ob die Action im Navigationsbaum (Baum), in der Menüleiste des Anzeigefelds (Symbolleiste) oder auf Produktlinienebene in Eingabefeldern (Zelle) des Anzeigefeld für die Globalattribute der Produkte oder in Zellen (Zelle) der Produktdatentabelle angezeigt wird.

  • Indem z.B. in der ersten Bedingung die Felder “Ebene”, “Ist gleich” und “Produktlinie” sowie in der zweiten Bedingung die Felder “Bereich”, “Ist gleich” und “Zelle” ausgewählt werden, kann man festlegen, dass die Action nur in der Ebene “Produktlinie” im Bereich “Zelle” angezeigt wird.

image-20250326-093743.png

  • Obwohl man sich in der Produktlinienebene befindet, wird im Navigationsbaum keine Action angezeigt, da diese nur in Zellen angezeigt werden soll.

image-20250326-093844.png

Beispiel “Ansicht im Navigationsbaum (Baum)”

  • Obwohl man sich in der Produktlinienebene befindet, wird in der Menüleiste keine Action angezeigt, da diese nur in Zellen angezeigt werden soll.

image-20250326-094225.png

Beispiel “Ansicht in der Menüleiste (Symbolleiste)”

  • Wenn man die Action im Anzeigefeld des ProductLine-Tabs über eine Zelle in der Tabelle der Globalattribute der Produkte öffnet, wird die Action angezeigt.

image-20250326-094502.png

Beispiel “Ansicht in der Zelle der Tabelle des System-Tabs ProductLine (Zelle)”

Beispiel 4

  • Man kann bestimmen, für welche Fabrik/Produktlinie oder welches Produkt die Action verfügbar ist.

  • Indem z.B. die Felder “Produkt-ID”, “Ist gleich” und “1” ausgewählt werden, kann man festlegen, dass die Action nur für Produkte mit der Produkt-ID “1” angezeigt wird.

image-20250325-101308.png

  • Die Action ist für alle Produkte mit der Produkt-ID “1” in jedem Bereich (Baum, Symbolleiste, Zelle) verfügbar.

image-20250220-140155.png

Beispiel: Produkt mit Produkt-ID “1”

  • Die Action ist jedoch nicht für Produkte mit einer anderen Produkt-ID, z.B. mit der Produkt-ID “3”, verfügbar.

image-20250220-140302.png

Beispiel: Produkt mit Produkt-ID “3”

Beispiel 5

  • Man kann bestimmen, für welche Fabrik/Produktlinie oder welches Produkt die Action verfügbar ist.

  • Indem z.B. die Felder “Fabrik-ID”, “Ist nicht gleich” und “2” ausgewählt werden, kann man festlegen, dass die Action für alle Produkte mit der Produkt-ID “1” angezeigt wird, außer in der Fabrik mit Fabrik-ID “2”.

image-20250325-101520.png

  • Die Action ist für alle Produkte mit der Produkt-ID “1” in jedem Bereich (Baum, Symbolleiste, Zelle) verfügbar.

image-20250221-085116.png

  • Die Action ist jedoch nicht für das Produkt mit der Produkt-ID “1” in der Fabrik mit Fabrik-ID “2” verfügbar.

image-20250221-085305.png

3.4.4.2.4. Listen-SQL

Mittels des Listen-SQLs kann das Ergebnis einer SQL Abfrage in einem Dialog angezeigt werden.

Ein Listen-SQL erfordert Wissen im Schreiben von SQL-Abfragen.

  • Das Listen-SQL kann direkt im Eingabefeld geschrieben werden oder man öffnet über das Icon image-20250225-080620.png einen vergrößerten SQL-Editor, zum übersichtlicherem Schreiben der Abfrage.

  • Sie können in das Eingabefeld auch Kommentare schreiben ( z.B. - - SELECT) und diese werden beim Ausführen des Listen-SQLs nicht angezeigt.

  • Im Listen-SQL können beliebig viele SQL-Befehle und Kommentare hinterlegt werden. Im Listen-Dialog wird nur das Ergebnis des letzten SELECT-Befehls angezeigt.

  • Sie können mit “{}” folgende definierte Variablen/Platzhalter verwenden: “

    • Username

    • Searchstring

    • FactoryID

    • ProductLineID

    • ProductID

    • ValueSeriesID

    • TimeID

    • Value

    • Template

    • GlobalAttribute1-25

  • Die Variablen werden beim Ausführen der Action automatisch anhand des Ortes befüllt, an dem die Action gestartet wurde.

  • Beispiel, Listen-SQL mit Variablen:

CODE 
SELECT NameShort
FROM planning.tdProducts
WHERE
    FactoryID = ‘{FactoryID}’
    AND ProductLineID = ‘{ProductLineID}’

  • Beispiel, wenn die Action in der Fabrik mit der Fabrik-ID “1” und in der Produktlinie mit der Produktlinien-ID “3” gestartet wird:

CODE 
SELECT NameShort
FROM planning.tdProducts
WHERE
    FactoryID = ‘1’
    AND ProductLineID = ‘3’

  • Beispiel, wenn die Action auf Fabrikebene in der Fabrik mit der Fabrik-ID “1” gestartet wird:

CODE 
SELECT NameShort
FROM planning.tdProducts
WHERE
    FactoryID = ‘1’
    AND ProductLineID = ‘’

  • Es sollte beim Schreiben der SQL-Abfragen beachtet werden, dass je nach Startort der Action manche Variablen nicht befüllt sind.

Achten Sie beim Schreiben des SQL-Skripts darauf, dass die einfachen Anführungszeichen bei Variablen korrekt gesetzt werden: z.B. ‘{FactoryID}’ und nicht {FactoryID}.

3.4.4.2.5. Button “Layout-Optionen”

Hier kann das Layout des Dialogs “Action ausführen” bearbeitet werden, welcher anhand des Listen-SQLs erstellt wird.

  • Bei Auswahl des Buttons öffnet sich ein Dialog, in welchem neue Optionen für das Layout des Action Dialogs “Action ausführen” hinzugefügt werden können.

image-20250326-102240.png

  • Sind bereits Layout-Optionen festgelegt, wird die Anzahl der Optionen direkt auf dem Button rechts neben dem Buttonnamen in Klammern image-20250224-082359.png angezeigt.

3.4.4.2.5.1. Menüleiste (a)

Icon image-20250221-095538.png “Zeile hinzufügen”

  • Standardmäßig wird eine neue Zeile mit dem Feldnamen “Neues Feld”, mit dem Datentyp “Text”, mit der Ausrichtung “Links” und der Standardbreite 100% hinzugefügt.

  • Die einzelnen Spalten können individuell bearbeitet werden.

Bei einem Feld mit dem Datentyp “Text” kann das Eingabefeld für das Format der Daten nicht bearbeitet werden.

Icon image-20250221-095617.png “Felder aus dem Listen-SQL abrufen”

  • Bei Auswahl dieses Icons werden automatisch die Felder abgerufen, die im SQL-Editor “Listen-SQL” bestimmt wurden, und der Tabelle hinzugefügt.

  • Beispiel:

image-20250326-104527.png

Beispiel Listen-SQL

image-20250326-104704.png

Beispiel Felder aus dem Listen-SQL

image-20250227-132608.png

Beispiel Dialog “Action ausführen” mit den Feldern

3.4.4.2.5.2. Tabelle der Layout-Optionen für das Listen-SQL (a)

Hier kann die Anzeige der Felder im Dialog bearbeitet werden.

Feldname

  • Eingabefeld für einen sprechenden Feldnamen

  • Bei Auswahl von “Felder aus dem Listen-SQL abrufen” werden die Feldnamen automatisch eingetragen.

Datentyp

  • Mit einem Linksklick in das Feld öffnet sich ein Drop-down-Menü, in welchem einer von drei Datentypen ausgewählt werden kann: “Text”, “Zahl” oder “Datum”.

  • Der Datentyp wird durch den Feldtyp bedingt, d.h. dass z.B. ein Feld mit einem Geldbetrag für die Kaltmiete den Datentyp “Zahl” benötigt.

Format der Daten

  • Die Auswahl an möglichen Formaten für die Daten können Sie unter “3.4.3. Formate | 3.4.3.2.-Tabelle-mit-Übersicht-aller-Formate-(B)“ unter “Format” einsehen.

  • Das ist ein Eingabefeld für ein selbst definiertes Zahlenformat. Dies ist z. B. nötig, wenn Zahlen führende Nullen erhalten sollen:

    • “0” nach einem Punkt = Dezimalstelle wird auf jeden Fall angezeigt - wenn sie leer ist, wird eine 0 eingefügt.

    • “0” vor einem Punkt = Stelle vor dem Komma wird auch dann als Null angezeigt, wenn sie leer ist. Das ermöglicht führende Nullen.

    • “#” nach einem Punkt = Dezimalstelle wird angezeigt, wenn sie vorhanden ist.

    • “#” vor einem Punkt = Werden nur verwendet um Tausendertrennzeichen zu definieren und um die Position der führenden Null konkret festzulegen.

    • “.” (Punkt) = Zeichen zur Abtrennung von Nachkommastellen

    • “#,#” (Komma) = Tausendertrennzeichen

    • #### = Ganzzahl ohne Kommastellen

    • dd/mm/yyyy = Datumeingabe (siehe Datumsformate: https://learn.microsoft.com/de-de/dotnet/standard/base-types/custom-date-and-time-format-strings)

    • @ = nur Texteingabe

Ausrichtung

  • Mit einem Linksklick in das Eingabefeld öffnet sich ein Drop-down-Menü, in welchem eine Ausrichtung der Beschriftung für die Spaltenüberschriften sowie die Inhalte der kompletten Spalte ausgewählt werden kann: Links (linksbündig), Mitte (mittig), Rechts (rechtsbündig).

Breite

  • Die standardmäßige Einstellung für alle Spalten ist 100%, d.h. dass alle Spalten gleich breit angezeigt werden.

  • Die Breite muss verhältnismäßig eingestellt werden.

Icon image-20250224-083728.png “Feld löschen”

  • Bei Auswahl dieses Icons wird die ausgewählte Zeile bzw. das ausgewählte Feld gelöscht.

3.4.4.2.6. Button “Vorschau” Listen-SQL

Die Vorschau gibt die Daten zurück, die im SQL-Editor-Eingabefeld im Listen-SQL bestimmt werden.

Enthält das Listen-SQL Variablen, kann keine Vorschau angezeigt werden.

  • Um Daten anzeigen zu lassen, darf das Eingabefeld im Listen-SQL nicht leer sein.

image-20250224-091928.png

  • Bei Auswahl des Buttons öffnet sich ein Dialog, in welchem Daten angezeigt, gesucht und exportiert werden können.

image-20250326-105302.png

Dialog des Buttons “Vorschau”

Icon image-20250224-084845.png “Exportieren”

  • Bei Auswahl dieses Icons öffnet sich ein Drop-down-Menü mit zwei Optionen: “Alle Daten nach Excel exportieren” und “Ausgewählte Zeilen nach Excel exportieren”.

  • Bei Auswahl von “Alle Daten nach Excel exportieren” öffnet sich ein Dialog, in welchem ein lokaler Speicherort ausgewählt werden muss. Die Daten werden im xlsx-Format exportiert.

  • Bei Auswahl von “Ausgewählte Zeilen nach Excel exportieren” müssen zuerst in der Tabelle Zeilen ausgewählt werden und danach öffnet sich ein Dialog, in welchem ein lokaler Speicherort ausgewählt werden muss. Die Daten werden im xlsx-Format exportiert.

  • Um mehrere Zeilen auszuwählen, muss man die Taste “Strg” gedrückt halten und kann dann mit der Maus (Linksklick) mehr als eine Zeile auswählen. Man kann auch eine Zeile anklicken, die Taste “Shift” gedrückt halten und eine andere Zeile anklicken, um alle Zeilen von der ersten bis zur gerade angeklickten Zeile zu markieren.

Tabelle allgemein

Die Anzeige der Felder in der Tabelle im Dialog kann in den Layout-Optionen (siehe: 3.4.4. Actions | 3.4.4.2.5.2.-Tabelle-der-Layout-Optionen-für-das-Listen-SQL-(a)) angepasst werden.

3.4.4.2.7. Action-SQL

Mittels des Action-SQLs können beliebige SQL-Befehle ausgeführt werden. Wenn kein Listen-SQL angegeben ist, wird das Action-SQL-Skript sofort ausgeführt. In Kombination mit einem Listen-SQL kann in einem Dialog eine Übersicht mit Inhalten angezeigt und bei Auswahl eines Datensatzes ein davor individuell konfiguriertes SQL Skript ausgeführt werden.

Ein Action-SQL erfordert Wissen im Schreiben von SQL-Abfragen.

  • Das Action-SQL kann direkt im Eingabefeld geschrieben werden oder man öffnet über das Icon image-20250225-080620.png einen vergrößerten SQL-Editor, zum übersichtlicherem Schreiben der Abfrage.

  • Sie können mit “{}” folgende definierte Variablen/Platzhalter verwenden: “

    • Username

    • Searchstring

    • FactoryID

    • ProductLineID

    • ProductID

    • ValueSeriesID

    • TimeID

    • Value

    • Template

    • GlobalAttribute1-25

  • Die Variablen werden beim Ausführen der Action automatisch anhand des Ortes befüllt, an dem die Action gestartet wurde.

  • Werte aus der ausgewählten Zeile im Listen-SQL sind mit dem Präfix “LIST_” verfügbar, z.B. {LIST_ProductID} ist der Wert der ProductID aus dem ausgewählten Datensatz des Listen-SQLs.

Achten Sie beim Schreiben des SQL-Skripts darauf, dass die einfachen Anführungszeichen bei Variablen korrekt gesetzt werden: z.B. ‘{FactoryID}’ und nicht {FactoryID}.

3.4.4.2.8. Ausgewählten Feldwert übernehmen

Die verfügbaren Feldwerte werden aus dem Listen-SQL übernommen. Das erste Feld ist ein leeres Feld, welches ausgewählt werden kann, um eine vorherige Auswahl zu löschen.

  • Mit einem Linksklick in das Eingabefeld öffnet sich ein Drop-down-Menü, mit Feldwerten, die durch das Listen-SQL bedingt werden. Das bedeutet, die Auswahl der Feldwerte kann in jeder Action unterschiedlich sein.

image-20250227-103206.png

Beispiel Listen-SQL

image-20250227-103527.png

Beispiel “Durch Listen-SQL bedingtes Drop-down-Menü”

  • Ist im Drop-down-Menü ein Feldwert, z.B. Betrag, ausgewählt, kann nach Auswahl der entsprechenden Action im Dialog “Action ausführen” ein Wert, z.B. der Betrag, ausgewählt und in die Zelle übernommen werden, von der aus die Action gestartet wurde.

image-20250227-104219.png

  • Damit der Feldwert korrekt übernommen wird, müssen die Eigenschaften der Wertreihe, in welche der Feldwert übernommen werden soll, beachtet werden. Es kann in einer numerischen Wertreihe z.B. nur ein numerischer Feldwert und kein Textwert übernommen werden.

Der gewünschte Wert kann mit Auswahl des Buttons “Wert übernehmen oder direkt mit einem Doppel-Linksklick auf den Wert übernommen werden.

3.4.4.2.4. Speichern & neu laden (c)

Hier kann ein automatisches “Speichern” und automatisches “Neu laden” vor oder nach der Ausführung einer Action in der Datenerfassung aktiviert werden.

image-20250130-094541.png

Checkbox image-20250130-094823.png “Speichern vor Action”

  • Bei aktivierter Checkbox soll automatisch der aktuelle Stand vor Ausführung der Action gespeichert werden.

  • Bei deaktivierter Checkbox muss manuell über das Icon image-20250224-110202.png “Speichern” in der Menüleiste gespeichert werden.

Checkbox image-20250130-094823.png “Speichern nach Action”

  • Bei aktivierter Checkbox soll automatisch der aktuelle Stand nach Ausführung der Action gespeichert werden.

  • Bei deaktivierter Checkbox muss manuell über das Icon image-20250224-110202.png “Speichern” in der Menüleiste gespeichert werden.

Checkbox image-20250130-094823.png “Baum nach Action neu laden”

  • Bei aktivierter Checkbox soll automatisch der Navigationsbaum in der Datenerfassung nach Ausführung der Action neu geladen werden werden.

  • Bei deaktivierter Checkbox muss der Navigationsbaum manuell neu geladen werden, um die durch die Action verursachten Veränderungen anzeigen zu lassen.

Checkbox image-20250130-094823.png “Details nach Action neu laden”

  • Bei aktivierter Checkbox soll automatisch das Anzeigefeld des jeweiligen Systemtabs oder der Inhalt des Produkts in der Datenerfassung nach Ausführung der Action neu geladen werden werden.

  • Bei deaktivierter Checkbox muss das Anzeigefeld des jeweiligen Systemtabs oder der Inhalt des Produkts in der Datenerfassung manuell über das Icon image-20250224-110052.png “Neu laden” in der Menüleiste neu geladen werden, um die durch die Action verursachten Veränderungen anzeigen zu lassen.

3.4.4.2. Tabelle mit Übersicht aller Actions (B)

Auf der linken Seite der Übersicht wird eine Liste der vorhandenen Actions angezeigt.

Auf der rechten Seite der Übersicht werden die Details der ausgewählten Action angezeigt.

  • Beim Betreten des Menüpunkts “Actions” wird eine Übersicht aller Actions angezeigt.

  • Standardmäßig wird die erste Action in der Übersicht vorausgewählt und rechts die Details zur ausgewählten Action angezeigt.

image-20250326-110732.png

Actionübersicht - Icons

Icon image-20250115-110333.png

  • Mit einem Klick auf die Actionzeile kann diese ausgewählt werden. Die Auswahl wird anhand eines Kreises image-20250115-110333.png links vom Actionnamen (Action-ID + Actionname) sichtbar gemacht.

Tooltip image-20250221-091433.png

  • Wenn man mit der Maus über dem Tooltip-Icon image-20250221-091433.png schwebt, wird die in “Allgemein” hinzugefügte Beschreibung des Actionnamen angezeigt.

Icon image-20240910-095304.png

  • Wenn bei einer Action Details oder Daten fehlen, wird dies durch eine Warnung an der rechten Seite der Zeile angezeigt. Schwebt man mit der Maus über dem Icon, wird ein Tooltip angezeigt.

Icon image-20240910-095402.png “Drag & Drop”

  • Die Actions können über Drag&Drop in der Liste nach oben oder unten verschoben werden. Dadurch ändert sich nicht die Action-ID.

  • Änderungen an der Reihenfolge werden sofort gespeichert und erfordern kein explizites Klicken des “Speichern” Icons.

Die detaillierte Beschreibung aller Details einer Action finden Sie hier: 3.4.4. Actions | 3.4.4.2.-Action-hinzufügen

3.4.4.3. Action: Beispiele

Beispiele mit angewandten Actions finden Sie hier: 3.3.9. Actions in der Datenerfassung

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close