

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.

# Konfiguration oder Bearbeitung einer Entität in einer App Studio-App
<a name="data-entities-edit"></a>

Verwenden Sie die folgenden Themen, um eine Entität in einer App Studio-Anwendung zu konfigurieren.

**Topics**
+ [Den Namen der Entität bearbeiten](data-entities-edit-name.md)
+ [Entitätsfelder hinzufügen, bearbeiten oder löschen](data-entities-edit-fields.md)
+ [Datenaktionen erstellen, bearbeiten oder löschen](data-entities-edit-data-actions.md)
+ [Beispieldaten hinzufügen oder löschen](data-entities-edit-sample-data.md)
+ [Fügen Sie verbundene Datenquellen hinzu oder bearbeiten Sie sie und ordnen Sie Felder zu](data-entities-edit-connection.md)

# Den Namen der Entität bearbeiten
<a name="data-entities-edit-name"></a>

1. Navigieren Sie bei Bedarf zu der Entität, die Sie bearbeiten möchten.

1. Aktualisieren Sie auf der Registerkarte **Konfiguration** unter **Entitätsname** den Entitätsnamen und wählen Sie außerhalb des Textfeldes, um Ihre Änderungen zu speichern.

# Entitätsfelder hinzufügen, bearbeiten oder löschen
<a name="data-entities-edit-fields"></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, die Sie bearbeiten möchten.

1. Auf der Registerkarte **Konfiguration** sehen Sie sich unter **Felder** eine Tabelle mit den Feldern Ihrer Entität an. Entitätsfelder haben die folgenden Spalten:
   + **Anzeigename:** Der Anzeigename ähnelt einer Tabellenüberschrift oder einem Formularfeld und ist für Anwendungsbenutzer sichtbar. Er kann Leerzeichen und Sonderzeichen enthalten, muss jedoch innerhalb einer Entität eindeutig sein.
   + **Systemname:** Der Systemname ist eine eindeutige Kennung, die im Code verwendet wird, um auf ein Feld zu verweisen. Bei der Zuordnung zu einer Spalte in einer Amazon Redshift Redshift-Tabelle muss diese mit dem Spaltennamen der Amazon Redshift Redshift-Tabelle übereinstimmen.
   + **Datentyp:** Der Datentyp, der in diesem Feld gespeichert wird, z. B. `Integer``Boolean`, oder. `String`

1. Um Felder hinzuzufügen:

   1. Um mithilfe von KI Felder auf der Grundlage des Entitätsnamens und der verbundenen Datenquelle zu generieren, wählen Sie **Weitere Felder generieren aus**.

   1. Um ein einzelnes Feld hinzuzufügen, wählen Sie **\$1 Feld hinzufügen**.

1. Um ein Feld zu bearbeiten:

   1. Um den Anzeigenamen zu bearbeiten, geben Sie den gewünschten Wert in das Textfeld **Anzeigename** ein. Wenn der Systemname des Felds nicht bearbeitet wurde, wird er auf den neuen Wert des Anzeigenamens aktualisiert.

   1. Um den Systemnamen zu bearbeiten, geben Sie den gewünschten Wert in das Textfeld **Systemname** ein.

   1. Um den Datentyp zu bearbeiten, wählen Sie das Dropdownmenü **Datentyp** und wählen Sie den gewünschten Typ aus der Liste aus.

   1. Um die Eigenschaften des Felds zu bearbeiten, wählen Sie das Zahnradsymbol des Felds. In der folgenden Liste werden die Feldeigenschaften detailliert beschrieben:
      + **Erforderlich**: Aktivieren Sie diese Option, wenn das Feld für Ihre Datenquelle erforderlich ist.
      + **Primärschlüssel**: Aktivieren Sie diese Option, wenn das Feld einem Primärschlüssel in Ihrer Datenquelle zugeordnet ist.
      + **Eindeutig**: Aktivieren Sie diese Option, wenn der Wert dieses Felds eindeutig sein muss.
      + **Datenquellenstandard verwenden**: Aktivieren Sie diese Option, wenn der Wert des Felds von der Datenquelle bereitgestellt wird, z. B. mithilfe von Autoinkrement oder einem Ereigniszeitstempel.
      + **Datentypoptionen**: Felder bestimmter Datentypen können mit Datentypoptionen wie Minimal- oder Maximalwerten konfiguriert werden.

1. Um ein Feld zu löschen, wählen Sie das Papierkorbsymbol des Felds, das Sie löschen möchten.

# 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.

# Beispieldaten hinzufügen oder löschen
<a name="data-entities-edit-sample-data"></a>

Sie können Beispieldaten zu Entitäten in einer App Studio-Anwendung hinzufügen. Da Anwendungen erst mit externen Diensten kommunizieren, wenn sie veröffentlicht wurden, können Beispieldaten verwendet werden, um Ihre Anwendung und Entität in Vorschauumgebungen zu testen.

1. Navigieren Sie bei Bedarf zu der Entität, die Sie bearbeiten möchten.

1. Wählen Sie die Registerkarte **Beispieldaten**.

1. Um Beispieldaten zu generieren, wählen Sie **Weitere Beispieldaten generieren** aus.

1. Um Beispieldaten zu löschen, aktivieren Sie die Kontrollkästchen der Daten, die Sie löschen möchten, und drücken Sie die Lösch- oder Rücktaste. Wählen Sie **Speichern**, um die Änderungen zu speichern.

# Fügen Sie verbundene Datenquellen hinzu oder bearbeiten Sie sie und ordnen Sie Felder zu
<a name="data-entities-edit-connection"></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, die Sie bearbeiten möchten.

1. Wählen Sie die Registerkarte **Verbindung**, um die Verbindung zwischen der Entität und einer Datenquellentabelle anzuzeigen oder zu verwalten, in der Daten gespeichert werden, wenn Ihre Anwendung veröffentlicht wird. Sobald eine Datenquellentabelle verbunden ist, können Sie die Entitätsfelder den Spalten der Tabelle zuordnen.

1. Wählen Sie unter **Connector** den Konnektor aus, der eine Verbindung zur gewünschten Datenquellentabelle enthält. Weitere Informationen zu Konnektoren finden Sie unter[Connect App Studio über Konnektoren mit anderen Diensten](connectors.md).

1. Wählen Sie unter **Tabelle** die Tabelle aus, die Sie als Datenquelle für die Entität verwenden möchten.

1. Die Tabelle zeigt die Felder der Entität und die Datenquellenspalte, der sie zugeordnet sind. Wählen Sie **Automatische Zuordnung**, um Ihre Entitätsfelder automatisch Ihren Datenquellenspalten zuzuordnen. Sie können Felder in der Tabelle auch manuell zuordnen, indem Sie die Datenquellenspalte in der Dropdownliste für jedes Entitätsfeld auswählen.