Ausgewählte Tabellenzeile abrufen

Diese Aktion ermöglicht Ihnen den Abruf der Anzahl ausgewählter Zeilen oder ausgewählter Felder im Maskenobjekt „Datenbanktabelle“. Die Werte werden in einer vorhandenen oder neu erstellten Variablen gespeichert. Die Aktion Ausgewählte Tabellenzeile abrufen fungiert als Gegenstück zur Aktion Tabellenzeile auswählen .

Die Über-Gruppe gibt die ausgewählte Aktion an.

  • Name: ermöglicht es Ihnen, einen benutzerdefinierten Namen anzugeben. So können Sie Aktionen in der Liste der Aktionen in der Lösung leichter erkennen. Standardmäßig werden Aktionsnamen vom Typ der jeweiligen Aktion abgeleitet.
  • Beschreibung: benutzerdefinierte Informationen über die Aktion. Geben Sie eine Beschreibung ein, um den Zweck und die Rolle einer Aktion in einer Lösung zu erklären.
  • Aktionstyp: Nur-Lesen-Informationen über den ausgewählten Aktionstyp.

Die Gruppe Formulartabelle ermöglicht es Ihnen, das Datenbanktabellen-Objekt auf der Maske zu wählen und auszuwählen, welche Werte in einer Variable gespeichert werden sollen.

  • Tabelle: legt fest, welches Datenbanktabellen-Objekt auf der Maske mit dieser Aktion verwendet wird.

    • Ausgewählte Zeilennummern: speichert die Nummern der ausgewählten Tabellenzeilen in der Variablen für ausgewählte Zeilen.

    • Tabellenfeld-Inhalt für ausgewählte Zeilen: speichert den feldbezogenen Wert der ausgewählten Tabellenzeilen.

      • Tabellenfeld: definiert das Tabellenfeld, aus dem die Werte übernommen und in der Variablen für ausgewählte Zeilen gespeichert werden.

    Hinweis

    Wenn mehrere Zeilen ausgewählt sind, werden die gespeicherten Werte (Zeilennummern oder Feldwerte) durch Kommas getrennt. Um die Auswahl mehrerer Zeilen zu aktivieren, öffnen Sie Datenbank-Tabellenobjekt-Eigenschaften > Einstellungen und aktivieren Sie Zeilen-Mehrfachauswahl aktivieren.

    Hinweis

    Wenn die gespeicherten Werte (Zeilennummern oder Feldwerte) Kommas enthalten, werden sie in Anführungszeichen eingeschlossen.

  • Ausgewählte Zeilenvariable: wählt eine Variable aus (oder erstellt eine Variable), die den Wert für Tabellenfeld oder Ausgewählte Zeilennummern speichert.

Tipp

Verwenden Sie diese Variable als Datenquelle, um die ausgewählten Werte in einem Maskenobjekt anzuzeigen.

Tipp

Um die Datensatzauswahl direkt nach Ausführung der Maske anzuzeigen, verwenden Sie das Ereignis Beim Laden des Formulars. Gehen Sie zu Maskeneigenschaften > Ereignisse > Beim Laden des Formulars und klicken Sie auf Aktionen.... Fügen Sie die Aktion Tabellenzeile auswählen hinzu und definieren Sie die Zeilen so, wie in diesem Abschnitt beschrieben.

Aktionsausführung und Fehlerhandhabung

Jede Aktion kann als bedingungsabhängige Aktion festgelegt werden. Bedingungsabhängige Aktionen werden nur ausgeführt, wenn die festgelegten Bedingungen erfüllt sind. Um diese Bedingungen zu definieren, klicken Sie auf Optionen für Ausführung und Fehlerhandhabung anzeigen.

Die Ausführungsoptionen sind:

  • Aktiviert: gibt an, ob die Aktion aktiviert oder deaktiviert ist. Nur aktivierte Aktionen werden ausgeführt. Diese Funktion kann beim Testen einer Druckmaske verwendet werden.
  • Bedingung: definiert einen einzeiligen Programmierausdruck, welcher einen booleschen Wert bereitstellen muss (wahr oder falsch). Ist das Ergebnis des Ausdrucks wahr, wird die Aktion ausgeführt. Bedingungen sorgen dafür, dass Aktionen nicht jedes Mal ausgeführt werden müssen.

Die Fehlerhandhabung-Optionen sind:

  • Fehler ignorieren : gibt an, ob ein Fehler ignoriert werden soll. Wenn aktiviert, wird die Ausführung von Aktionen selbst dann fortgesetzt, wenn die aktuelle Aktion fehlschlägt.

    Hinweis

    Geschachtelte Aktionen, die von der aktuellen Aktion abhängig sind, werden im Fall eines Fehlers nicht ausgeführt. Die Aktionsausführung wird bei der nächsten Aktion fortgesetzt, die sich auf derselben Ebene wie die aktuelle Aktion befindet. Der Fehler wird protokolliert, führt aber nicht zu einer Unterbrechung der Ausführung von Aktionen.

    • Beispiel

    Am Ende des Druckvorgangs möchten Sie eventuell mittels der Aktion HTTP-Anfrage einen Statusbericht an eine externe Anwendung senden. Wenn die Druckaktion fehlschlägt, wird die Aktionsverarbeitung angehalten. Um die Berichterstellung trotz fehlgeschlagener Druckaktion auszuführen, muss für die Aktion Etikett drucken die Option Fehler ignorieren aktiviert sein.

  • Fehler in Variable speichern : ermöglicht Ihnen, eine Variable auszuwählen oder zu erstellen, in der der Fehler gespeichert werden soll. Dieselbe Fehlerbeschreibung wird zudem in den internen Variablen ActionLastErrorId und ActionLastErrorDesc gespeichert.