Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Configurazione o modifica di un'entità in un'app App Studio
Utilizza i seguenti argomenti per configurare un'entità in un'applicazione App Studio.
**Topics**
+ [Modifica del nome dell'entità](data-entities-edit-name.md)
+ [Aggiungere, modificare o eliminare i campi dell'entità](data-entities-edit-fields.md)
+ [Azioni di creazione, modifica o eliminazione dei dati](data-entities-edit-data-actions.md)
+ [Aggiungere o eliminare dati di esempio](data-entities-edit-sample-data.md)
+ [Aggiungi o modifica l'origine dati connessa e i campi della mappa](data-entities-edit-connection.md)
# Modifica del nome dell'entità
1. Se necessario, accedi all'entità che desideri modificare.
1. Nella scheda **Configurazione**, in **Nome dell'entità**, aggiorna il nome dell'entità e scegli una posizione esterna alla casella di testo per salvare le modifiche.
# Aggiungere, modificare o eliminare i campi dell'entità
**Suggerimento**
Puoi premere CTRL\$1Z per annullare la modifica più recente all'entità.
1. Se necessario, accedi all'entità che desideri modificare.
1. Nella scheda **Configurazione**, in **Campi**, visualizzi una tabella dei campi della tua entità. I campi di entità hanno le seguenti colonne:
+ **Nome visualizzato:** il nome visualizzato è simile all'intestazione di una tabella o a un campo del modulo ed è visualizzabile dagli utenti dell'applicazione. Può contenere spazi e caratteri speciali ma deve essere univoco all'interno di un'entità.
+ **Nome del sistema:** il nome del sistema è un identificatore univoco utilizzato nel codice per fare riferimento a un campo. Quando si esegue il mapping su una colonna in una tabella Amazon Redshift, questa deve corrispondere al nome della colonna della tabella Amazon Redshift.
+ **Tipo di dati:** il tipo di dati che verranno archiviati in questo campo, ad esempio`Integer`, `Boolean` o. `String`
1. Per aggiungere campi:
1. Per utilizzare l'intelligenza artificiale per generare campi in base al nome dell'entità e all'origine dati connessa, scegli **Genera altri campi**.
1. Per aggiungere un singolo campo, scegli **\$1 Aggiungi campo**.
1. Per modificare un campo:
1. Per modificare il nome visualizzato, immettete il valore desiderato nella casella di testo **Nome visualizzato**. Se il nome di sistema del campo non è stato modificato, verrà aggiornato al nuovo valore del nome visualizzato.
1. Per modificare il nome del sistema, inserite il valore desiderato nella casella di testo **Nome sistema**.
1. Per modificare il tipo di dati, scegli il menu a discesa **Tipo di dati** e seleziona il tipo desiderato dall'elenco.
1. Per modificare le proprietà del campo, scegli l'icona a forma di ingranaggio del campo. L'elenco seguente descrive in dettaglio le proprietà del campo:
+ **Obbligatorio**: abilita questa opzione se il campo è richiesto dalla tua fonte di dati.
+ **Chiave primaria**: abilita questa opzione se il campo è mappato a una chiave primaria nell'origine dati.
+ **Unico**: abilita questa opzione se il valore di questo campo deve essere unico.
+ **Usa l'origine dati predefinita**: abilita questa opzione se il valore del campo è fornito dall'origine dati, ad esempio utilizzando l'incremento automatico o un timestamp dell'evento.
+ **Opzioni relative ai tipi di dati**: i campi di determinati tipi di dati possono essere configurati con opzioni di tipo di dati come valori minimi o massimi.
1. Per eliminare un campo, scegli l'icona del cestino del campo che desideri eliminare.
# Azioni di creazione, modifica o eliminazione dei dati
Le azioni relative ai dati vengono utilizzate nelle applicazioni per eseguire azioni sui dati di un'entità, come il recupero di tutti i record o il recupero di un record per ID. Le azioni sui dati possono essere utilizzate per individuare e restituire dati che corrispondono a condizioni specifiche da visualizzare in componenti come tabelle o viste di dettaglio.
**Contents**
+ [Creazione di azioni relative ai dati](#data-entities-data-action-add)
+ [Modifica o configurazione delle azioni relative ai dati](#data-entities-data-action-edit)
+ [Operatori ed esempi delle condizioni di azione dei dati](#data-entities-data-action-operators)
+ [Supporto agli operatori delle condizioni tramite database](#data-entities-data-action-operators-support)
+ [Esempi di condizioni di azione dei dati](#data-entities-data-action-operators-examples)
+ [Eliminazione delle azioni relative ai dati](#data-entities-data-action-delete)
## Creazione di azioni relative ai dati
**Suggerimento**
Puoi premere CTRL\$1Z per annullare la modifica più recente all'entità.
1. Se necessario, accedi all'entità per la quale desideri creare azioni relative ai dati.
1. Scegli la scheda **Azioni sui dati**.
1. Esistono due metodi per creare azioni relative ai dati:
+ (Consigliato) Per utilizzare l'intelligenza artificiale per generare azioni sui dati per te, in base al nome dell'entità, ai campi e all'origine dati connessa, scegli **Genera azioni sui dati**. Verranno generate le seguenti azioni:
1. `getAll`: recupera tutti i record da un'entità. Questa azione è utile quando è necessario visualizzare un elenco di record o eseguire operazioni su più record contemporaneamente.
1. `getByID`: recupera un singolo record da un'entità in base al suo identificatore univoco (ID o chiave primaria). Questa azione è utile quando è necessario visualizzare o eseguire operazioni su un record specifico.
+ Per aggiungere una singola azione sui dati, scegli **\$1 Aggiungi azione dati**.
1. Per visualizzare o configurare la nuova azione relativa ai dati, consulta la sezione seguente,[Modifica o configurazione delle azioni relative ai dati](#data-entities-data-action-edit).
## Modifica o configurazione delle azioni relative ai dati
1. Se necessario, accedi all'entità per la quale desideri creare azioni relative ai dati.
1. Scegli la scheda **Azioni sui dati**.
1. In **Campi** configura i campi che devono essere restituiti dalla query. Per impostazione predefinita, vengono selezionati tutti i campi configurati nell'entità.
È inoltre possibile aggiungere **join** all'azione relativa ai dati eseguendo le seguenti operazioni:
1. Scegli **\$1 Aggiungi Join** per aprire una finestra di dialogo.
1. In **Entità correlata**, seleziona l'entità che desideri unire all'entità corrente.
1. In **Alias**, inserisci facoltativamente un alias temporaneo per l'entità correlata.
1. In **Tipo di join**, seleziona il tipo di join desiderato.
1. Definite la clausola di join selezionando i campi di ciascuna entità.
1. Scegli **Aggiungi** per creare il join.
Una volta creato, il join verrà visualizzato nella sezione **Join**, rendendo disponibili campi aggiuntivi nel menu a discesa **Campi da restituire**. Puoi aggiungere più join, compresi i join concatenati tra le entità. Puoi anche filtrare e ordinare i campi delle entità unite.
Per eliminare un join, scegli l'icona del cestino accanto ad esso. Ciò rimuoverà tutti i campi da quel join e interromperà eventuali join o vincoli dipendenti che utilizzano tali campi.
1. In **Condizioni**, aggiungi, modifica o rimuovi le regole che filtrano l'output della query. È possibile organizzare le regole in gruppi e concatenare più regole con le `OR` istruzioni `AND` or. Per ulteriori informazioni sugli operatori che è possibile utilizzare, vedere[Operatori ed esempi delle condizioni di azione dei dati](#data-entities-data-action-operators).
1. In **Ordinamento**, configura il modo in cui i risultati della query vengono ordinati scegliendo un attributo e scegliendo l'ordine crescente o decrescente. È possibile rimuovere la configurazione di ordinamento scegliendo l'icona del cestino accanto alla regola di ordinamento.
1. In **Transform results**, puoi inserire risultati personalizzati JavaScript per modificare o formattare prima che vengano visualizzati o inviati alle automazioni.
1. In **Output preview**, visualizza una tabella di anteprima dell'output della query in base ai campi configurati, ai filtri, all'ordinamento e. JavaScript
## Operatori ed esempi delle condizioni di azione dei dati
È possibile utilizzare gli operatori di condizione per confrontare un valore di espressione configurato con una colonna di entità per restituire un sottoinsieme di oggetti del database. Gli operatori che puoi utilizzare dipendono dal tipo di dati della colonna e dal tipo di database a cui l'entità è connessa, come Amazon Redshift, Amazon Aurora o Amazon DynamoDB.
I seguenti operatori di condizioni possono essere utilizzati con tutti i servizi di database:
+ `=`e`!=`: disponibile per tutti i tipi di dati (escluse le colonne chiave primarie).
+ `<=`, `>=``<`, e`>=`: Disponibile solo per le colonne numeriche.
+ `IS NULL`e`IS NOT NULL`: utilizzato per abbinare colonne con valori nulli o vuoti. I valori nulli vengono spesso interpretati in modo diverso in ogni database, tuttavia in App Studio l'`NULL`operatore abbina e restituisce i record con valori nulli nella tabella del database connessa.
I seguenti operatori di condizione possono essere utilizzati solo nelle entità connesse ai servizi di database che li supportano:
+ `LIKE`and `NOT LIKE` (Redshift, Aurora): utilizzato per eseguire query basate su pattern nel database connesso. L'`LIKE`operatore offre flessibilità nella funzionalità di ricerca perché trova e restituisce i record che soddisfano i modelli specificati. I pattern vengono definiti utilizzando caratteri jolly che corrispondono a qualsiasi carattere o sequenza di caratteri all'interno del pattern. Ogni sistema di gestione di database dispone di un set unico di caratteri jolly, ma i due più diffusi sono quelli di `%` rappresentare un numero qualsiasi di caratteri (incluso 0) e di `_` rappresentare un singolo carattere.
+ `Contains`and `Not Contains` (DynamoDB): utilizzato per eseguire una ricerca con distinzione tra maiuscole e minuscole per determinare se il testo specificato viene trovato all'interno dei valori delle colonne.
+ `Starts With`and `Not Starts With` (DynamoDB): utilizzato per eseguire una ricerca con distinzione tra maiuscole e minuscole per determinare se il testo specificato viene trovato all'inizio dei valori delle colonne.
### Supporto agli operatori delle condizioni tramite database
La tabella seguente mostra quali operatori di condizione di azione dei dati sono supportati da ciascun database che può connettersi ad App Studio.
| | =, \$1=, <, >, <=, >= | PIACE, NON PIACE | Contiene, non contiene | Inizia con, non inizia con | È NULLO, NON È NULLO |
| --- | --- | --- | --- | --- | --- |
| **DynamoDB** | Sì | No | Sì | Sì | Sì |
| **Aurora** | Sì | Sì | No | No | Sì |
| **Redshift** | Sì | Sì | No | No | Sì |
### Esempi di condizioni di azione dei dati
Considerate la seguente tabella di database, che include più elementi con `name``city`, e `hireDate` campi.
| nome | città | Data di assunzione |
| --- | --- | --- |
| Adamo | Seattle | 01/03/2025 |
| Adrienne | Boston | 2025-03-05 |
| Bob | Albuquerque | 2025-03-06 |
| Carlos | Chicago | 2025-03-10 |
| Carolina | NULL | 2025-03-12 |
| Rita | Miami | 2025-03-15 |
Ora, considera la possibilità di creare azioni di dati in App Studio che restituiscano il `name` campo per gli elementi che soddisfano le condizioni specificate. L'elenco seguente contiene esempi di condizioni e i valori che la tabella restituisce per ciascuna di esse.
**Nota**
Gli esempi sono formattati come esempi SQL: potrebbero non apparire come in App Studio, ma vengono utilizzati per illustrare il comportamento degli operatori.
+ `WHERE name LIKE 'Adam'`: Restituisce. `Adam`
+ `WHERE name LIKE 'A%'`: Restituisce `Adam` e`Adrienne`.
+ `WHERE name NOT LIKE 'B_B'`: Restituisce `Adam``Adrienne`,`Carlos`,`Caroline`, e`Rita`.
+ `WHERE contains(name, 'ita')`: Restituisce`Rita`.
+ `WHERE begins_with(name, 'Car')`: Restituisce `Carlos` e`Caroline`.
+ `WHERE city IS NULL`: Restituisce`Caroline`.
+ `WHERE hireDate < "2025-03-06"`: Restituisce `Adam` e`Adrienne`.
+ `WHERE hireDate >= DateTime.now().toISODate()`: Nota che `DateTime.now().toISODate()` restituisce la data corrente. In uno scenario in cui la data corrente è 2025-03-10, l'espressione restituisce`Carlos`, `Caroline` e. `Rita`
**Suggerimento**
Per ulteriori informazioni sul confronto di date e ore nelle espressioni, vedere. [Data e ora](expressions.md#expressions-date-time)
## Eliminazione delle azioni relative ai dati
Utilizza la seguente procedura per eliminare le azioni relative ai dati da un'entità di App Studio.
1. Se necessario, vai all'entità per la quale desideri eliminare le azioni relative ai dati.
1. Scegli la scheda **Azioni sui dati**.
1. Per ogni azione relativa ai dati che desideri eliminare, scegli il menu a discesa accanto a **Modifica** e scegli **Elimina**.
1. Scegli **Conferma** nella finestra di dialogo.
# Aggiungere o eliminare dati di esempio
È possibile aggiungere dati di esempio alle entità in un'applicazione App Studio. Poiché le applicazioni non comunicano con i servizi esterni fino a quando non vengono pubblicate, i dati di esempio possono essere utilizzati per testare l'applicazione e l'entità in ambienti di anteprima.
1. Se necessario, accedi all'entità che desideri modificare.
1. Scegli la scheda **Dati di esempio**.
1. Per generare dati di esempio, scegli **Genera altri dati di esempio**.
1. Per eliminare i dati di esempio, seleziona le caselle di controllo dei dati che desideri eliminare e premi il tasto Elimina o Backspace. Scegliete **Salva** per salvare le modifiche.
# Aggiungi o modifica l'origine dati connessa e i campi della mappa
**Suggerimento**
Puoi premere CTRL\$1Z per annullare la modifica più recente all'entità.
1. Se necessario, accedi all'entità che desideri modificare.
1. Scegli la scheda **Connessione** per visualizzare o gestire la connessione tra l'entità e una tabella di origini dati in cui vengono archiviati i dati quando l'applicazione viene pubblicata. Una volta connessa una tabella di origine dati, puoi mappare i campi dell'entità alle colonne della tabella.
1. In **Connector**, scegli il connettore che contiene una connessione alla tabella delle sorgenti dati desiderata. Per ulteriori informazioni sui connettori, vedere[Connetti App Studio ad altri servizi con connettori](connectors.md).
1. In **Tabella**, scegli la tabella che desideri utilizzare come fonte di dati per l'entità.
1. La tabella mostra i campi dell'entità e la colonna dell'origine dati a cui sono mappati. Scegli **Mappa automatica per mappare** automaticamente i campi dell'entità con le colonne delle fonti di dati. Puoi anche mappare i campi manualmente nella tabella scegliendo la colonna dell'origine dati nel menu a discesa per ogni campo di entità.