Tabellenzeile auswählen

Diese Aktion ermöglicht es Ihnen, festzulegen, welche Zeile eines Datenbanktabellen-Maskenobjekts ausgewählt wird. Sie fungiert als Gegenstück zur Aktion Ausgewählte Tabellenzeile abrufen .

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, in welchem Modus die Zeile der jeweiligen Tabelle ausgewählt werden soll.

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

• Auswahlmodus: definiert den Auswahlmodus für Datenbank-Datensätze.

  • Erste Zeile: wählt die erste Zeile im Dankbanktabellen-Objekt aus.

  • Letzte Zeile: wählt die letzte Zeile im Dankbanktabellen-Objekt aus.

  • Zeilennummer: ermöglicht eine benutzerdefinierte Auswahl von Datenbanktabellenzeilen. Geben Sie die Zeilennummern ein oder definieren Sie sie anhand einer Datenquelle dynamisch. Um mehrere Zeilen auszuwählen, geben Sie ihre Nummern durch Kommas getrennt ein.

  • Feldwert: wählt alle Datensätze in der Datenbanktabelle aus, die einen entsprechenden Datenwert haben.

    • Tabellenfeld: Datenbankfeld mit Wert(en), die im Fall eines Treffers ausgewählt werden.

    • Feldwert: Wert, der die Zeile (Datensatz) im Fall eines Treffers auswählt.

  Hinweis

  Die Optionen Zeilennummer und Feldwert wählen die Tabellenzeile ohne Beachtung der aktuellen Sortierreihenfolge von Tabellenzeilen aus. Beispielsweise bleibt „Zeilennummer 3“ selbst dann ausgewählt, wenn die Tabellensortierung die „Zeilennummer 3“ in eine andere Zeile verschiebt.

  • Alle Zeilen auswählen: wählt alle Zeilen in der Tabelle aus.

  • Auswahl für alle Zeilen aufheben: habt die Auswahl für alle Zeilen in der Tabelle auf.

  Hinweis

  Mehrere Zeilen werden ausgewählt, wenn die Tabelle dies unterstützt. Falls nicht, wird nur die erste Zeile ausgewählt.

Bei der Auswahl einer Tabellenzeile kann die Zeilennummer in einer Variablen gespeichert werden. Aktivieren Sie diese Option anhand der Option Ausgewählte Zeilennummer in Variable speichern in den Datenbanktabellen-Eigenschaften.

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.