

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Datenaktionen erstellen, bearbeiten oder löschen
<a name="data-entities-edit-data-actions"></a>

Datenaktionen werden in Anwendungen verwendet, um Aktionen für die Daten einer Entität auszuführen, z. B. das Abrufen aller Datensätze oder das Abrufen eines Datensatzes anhand der ID. Datenaktionen können verwendet werden, um Daten zu finden und zurückzugeben, die bestimmten Bedingungen entsprechen, sodass sie in Komponenten wie Tabellen oder Detailansichten angezeigt werden können.

**Contents**
+ [Datenaktionen erstellen](#data-entities-data-action-add)
+ [Datenaktionen bearbeiten oder konfigurieren](#data-entities-data-action-edit)
+ [Bedingungsoperatoren für Datenaktionen und Beispiele](#data-entities-data-action-operators)
  + [Unterstützung für Bedingungsoperatoren durch die Datenbank](#data-entities-data-action-operators-support)
  + [Beispiele für Bedingungen für Datenaktionen](#data-entities-data-action-operators-examples)
+ [Datenaktionen löschen](#data-entities-data-action-delete)

## Datenaktionen erstellen
<a name="data-entities-data-action-add"></a>

**Tipp**  
Sie können STRG\$1Z drücken, um die letzte Änderung an Ihrer Entität rückgängig zu machen.

1. Navigieren Sie bei Bedarf zu der Entität, für die Sie Datenaktionen erstellen möchten.

1. Wählen Sie die Registerkarte **Datenaktionen** aus.

1. Es gibt zwei Methoden zum Erstellen von Datenaktionen:
   + (Empfohlen) Wenn Sie KI verwenden möchten, um Datenaktionen auf der Grundlage Ihres Entitätsnamens, Ihrer Felder und der verbundenen Datenquelle für Sie zu generieren, wählen Sie **Datenaktionen generieren** aus. Die folgenden Aktionen werden generiert:

     1. `getAll`: Ruft alle Datensätze von einer Entität ab. Diese Aktion ist nützlich, wenn Sie eine Liste von Datensätzen anzeigen oder Operationen an mehreren Datensätzen gleichzeitig ausführen müssen.

     1. `getByID`: Ruft einen einzelnen Datensatz von einer Entität auf der Grundlage seiner eindeutigen Kennung (ID oder Primärschlüssel) ab. Diese Aktion ist nützlich, wenn Sie einen bestimmten Datensatz anzeigen oder Operationen an einem bestimmten Datensatz ausführen müssen.
   + Um eine einzelne Datenaktion hinzuzufügen, wählen Sie **\$1 Datenaktion hinzufügen**.

1. Informationen zum Anzeigen oder Konfigurieren der neuen Datenaktion finden Sie im folgenden Abschnitt,[Datenaktionen bearbeiten oder konfigurieren](#data-entities-data-action-edit).

## Datenaktionen bearbeiten oder konfigurieren
<a name="data-entities-data-action-edit"></a>

1. Navigieren Sie bei Bedarf zu der Entität, für die Sie Datenaktionen erstellen möchten.

1. Wählen Sie die Registerkarte **Datenaktionen** aus.

1. Konfigurieren Sie unter **Felder** die Felder, die von der Abfrage zurückgegeben werden sollen. Standardmäßig sind alle konfigurierten Felder in der Entität ausgewählt.

   Sie können der Datenaktion auch **Joins** hinzufügen, indem Sie die folgenden Schritte ausführen:

   1. Wählen Sie **\$1 Join hinzufügen**, um ein Dialogfeld zu öffnen.

   1. Wählen Sie unter **Verbundene Entität** die Entität aus, die Sie mit der aktuellen Entität verbinden möchten.

   1. Geben Sie im Feld **Alias** optional einen temporären Aliasnamen für die zugehörige Entität ein.

   1. Wählen **Sie unter Verbindungstyp** den gewünschten Verbindungstyp aus.

   1. Definieren Sie die Join-Klausel, indem Sie die Felder aus jeder Entität auswählen.

   1. Wählen Sie **Hinzufügen**, um die Verknüpfung zu erstellen.

   Nach der Erstellung wird der Join im Bereich **Joins** angezeigt, sodass zusätzliche Felder in der Drop-down-Liste „**Zurückzusetzende Felder**“ verfügbar sind. Sie können mehrere Verknüpfungen hinzufügen, einschließlich verketteter Verknüpfungen zwischen Entitäten. Sie können auch nach Feldern verbundener Entitäten filtern und sortieren.

   Um einen Join zu löschen, klicken Sie auf das Papierkorbsymbol neben dem Join. Dadurch werden alle Felder aus dieser Verknüpfung entfernt und alle abhängigen Verknüpfungen oder Einschränkungen, die diese Felder verwenden, werden aufgehoben.

1. Fügen Sie **unter Bedingungen** Regeln hinzu, bearbeiten oder entfernen Sie sie, die die Ausgabe der Abfrage filtern. Sie können Regeln in Gruppen organisieren und mehrere Regeln mit `OR` Oder-Anweisungen `AND` verketten. Weitere Informationen zu den Operatoren, die Sie verwenden können, finden Sie unter[Bedingungsoperatoren für Datenaktionen und Beispiele](#data-entities-data-action-operators).

1. Konfigurieren Sie unter **Sortierung**, wie die Abfrageergebnisse sortiert werden, indem Sie ein Attribut auswählen und eine auf- oder absteigende Reihenfolge wählen. Sie können die Sortierkonfiguration entfernen, indem Sie auf das Papierkorbsymbol neben der Sortierregel klicken.

1. Unter **Transformationsergebnisse** können Sie benutzerdefinierte Werte eingeben, JavaScript um Ergebnisse zu ändern oder zu formatieren, bevor sie angezeigt oder an Automatisierungen gesendet werden.

1. Sehen Sie sich in der **Ausgabevorschau** eine Vorschautabelle der Abfrageausgabe an, die auf den konfigurierten Feldern, Filtern, Sortierungen und JavaScript basiert.

## Bedingungsoperatoren für Datenaktionen und Beispiele
<a name="data-entities-data-action-operators"></a>

Sie können Bedingungsoperatoren verwenden, um einen konfigurierten Ausdruckswert mit einer Entitätsspalte zu vergleichen, um eine Teilmenge von Datenbankobjekten zurückzugeben. Die Operatoren, die Sie verwenden können, hängen vom Datentyp der Spalte und vom Datenbanktyp ab, mit dem die Entität verbunden ist, z. B. Amazon Redshift, Amazon Aurora oder Amazon DynamoDB.

Die folgenden Bedingungsoperatoren können mit allen Datenbankdiensten verwendet werden:
+ `=`und`!=`: Verfügbar für alle Datentypen (ausgenommen Primärschlüsselspalten).
+ `<=`, `>=``<`, und`>=`: Nur für numerische Spalten verfügbar.
+ `IS NULL`und`IS NOT NULL`: Wird verwendet, um Spalten abzugleichen, die Null- oder Leerwerte enthalten. Nullwerte werden häufig in jeder Datenbank unterschiedlich interpretiert. In App Studio sucht der `NULL` Operator jedoch nach Datensätzen, die Nullwerte in der verbundenen Datenbanktabelle enthalten, und gibt sie zurück.

Die folgenden Bedingungsoperatoren können nur in Entitäten verwendet werden, die mit Datenbankdiensten verbunden sind, die sie unterstützen:
+ `LIKE`und `NOT LIKE` (Redshift, Aurora): Wird für die Durchführung musterbasierter Abfragen in der verbundenen Datenbank verwendet. Der `LIKE` Operator bietet Flexibilität bei der Suchfunktion, da er Datensätze findet und zurückgibt, die den angegebenen Mustern entsprechen. Sie definieren die Muster mithilfe von Platzhalterzeichen, die einem beliebigen Zeichen oder einer beliebigen Zeichenfolge innerhalb des Musters entsprechen. Jedes Datenbankmanagementsystem hat einen eigenen Satz von Platzhalterzeichen, aber die beiden beliebtesten sind `%` die Darstellung einer beliebigen Anzahl von Zeichen (einschließlich 0) und `_` die Darstellung eines einzelnen Zeichens.
+ `Contains`und `Not Contains` (DynamoDB): Wird verwendet, um eine Suche mit Berücksichtigung von Groß- und Kleinschreibung durchzuführen, um festzustellen, ob der angegebene Text in den Spaltenwerten gefunden wird. 
+ `Starts With`und `Not Starts With` (DynamoDB): Wird für eine Suche mit Berücksichtigung von Groß- und Kleinschreibung verwendet, um festzustellen, ob der angegebene Text am Anfang der Spaltenwerte gefunden wird. 

### Unterstützung für Bedingungsoperatoren durch die Datenbank
<a name="data-entities-data-action-operators-support"></a>

Die folgende Tabelle zeigt, welche Bedingungsoperatoren für Datenaktionen von jeder Datenbank unterstützt werden, die eine Verbindung zu App Studio herstellen kann.


|  | =, \$1=, <, >, <=, >= | WIE, NICHT WIE | Enthält, enthält nicht | Beginnt mit, beginnt nicht mit | IST NULL, IST NICHT NULL | 
| --- | --- | --- | --- | --- | --- | 
|  **DynamoDB**  |  Ja  |  Nein  |  Ja  |  Ja  |  Ja  | 
|  **Aurora**  |  Ja  |  Ja  |  Nein  |  Nein  |  Ja  | 
|  **Redshift**  |  Ja  |  Ja  |  Nein  |  Nein  |  Ja  | 

### Beispiele für Bedingungen für Datenaktionen
<a name="data-entities-data-action-operators-examples"></a>

Betrachten Sie die folgende Datenbanktabelle, die mehrere Elemente mit `hireDate` Feldern `name``city`, und enthält.


| Name | city | Einstellungsdatum | 
| --- | --- | --- | 
|  Adam  |  Seattle  |  2025-03-01  | 
|  Adrienne  |  Boston  |  05. März 2025  | 
|  Bob  |  Albuquerque  |  06.03.2025  | 
|  Carlos  |  Chicago  |  2025-03-10  | 
|  Caroline  |  NULL  |  12.03.2025  | 
|  Rita  |  Miami  |  15.03.2025  | 

Erwägen Sie nun, Datenaktionen in App Studio zu erstellen, die das `name` Feld für Elemente zurückgeben, die bestimmten Bedingungen entsprechen. Die folgende Liste enthält Beispiele für Bedingungen und die Werte, die die Tabelle für jede Bedingung zurückgibt. 

**Anmerkung**  
Die Beispiele sind als SQL-Beispiele formatiert. Sie werden möglicherweise nicht wie in App Studio angezeigt, dienen aber dazu, das Verhalten der Operatoren zu veranschaulichen.
+ `WHERE name LIKE 'Adam'`: Gibt zurück`Adam`.
+ `WHERE name LIKE 'A%'`: Kehrt zurück `Adam` und`Adrienne`.
+ `WHERE name NOT LIKE 'B_B'`: Gibt`Adam`, `Adrienne` `Carlos``Caroline`, und zurück`Rita`.
+ `WHERE contains(name, 'ita')`: Kehrt zurück`Rita`.
+ `WHERE begins_with(name, 'Car')`: Kehrt zurück `Carlos` und`Caroline`.
+ `WHERE city IS NULL`: Kehrt zurück`Caroline`.
+ `WHERE hireDate < "2025-03-06"`: Kehrt zurück `Adam` und`Adrienne`.
+ `WHERE hireDate >= DateTime.now().toISODate()`: Hinweis, der das aktuelle Datum `DateTime.now().toISODate()` zurückgibt. In einem Szenario, in dem das aktuelle Datum 2025-03-10 ist, gibt der Ausdruck, und zurück`Carlos`. `Caroline` `Rita`

**Tipp**  
Weitere Informationen zum Vergleichen von Datums- und Uhrzeitangaben in Ausdrücken finden Sie unter. [Datum und Uhrzeit](expressions.md#expressions-date-time)

## Datenaktionen löschen
<a name="data-entities-data-action-delete"></a>

Gehen Sie wie folgt vor, um Datenaktionen aus einer App Studio-Entität zu löschen.

1. Navigieren Sie bei Bedarf zu der Entität, für die Sie Datenaktionen löschen möchten.

1. Wählen Sie die Registerkarte **Datenaktionen** aus.

1. Wählen Sie für jede Datenaktion, die Sie löschen möchten, das Dropdownmenü neben **Bearbeiten** und dann **Löschen** aus.

1. Wählen Sie im Dialogfeld die Option **Bestätigen** aus.