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à. # Parametri di pagina e automazione I parametri sono una potente funzionalità di AWS App Studio che viene utilizzata per trasferire valori dinamici tra diversi componenti, pagine e automazioni all'interno dell'applicazione. Utilizzando i parametri, puoi creare esperienze flessibili e sensibili al contesto, rendendo le tue applicazioni più reattive e personalizzate. Questo articolo tratta due tipi di parametri: parametri di pagina e parametri di automazione. **Topics** + [Parametri della pagina](parameters-page.md) + [Parametri di automazione](parameters-automation.md) # Parametri della pagina I parametri di pagina sono un modo per inviare informazioni tra le pagine e vengono spesso utilizzati durante la navigazione da una pagina all'altra all'interno di un'app App Studio per mantenere il contesto o trasmettere dati. I parametri della pagina sono in genere costituiti da un nome e un valore. ## Casi d'uso dei parametri di pagina I parametri di pagina vengono utilizzati per lo scambio di dati tra diverse pagine e componenti all'interno delle applicazioni App Studio. Sono particolarmente utili per i seguenti casi d'uso: 1. **Ricerca e filtraggio**: quando gli utenti effettuano ricerche nella home page dell'app, i termini di ricerca possono essere passati come parametri alla pagina dei risultati, consentendole di visualizzare solo gli elementi filtrati pertinenti. Ad esempio, se un utente cerca*noise-cancelling headphones*, il parametro con il valore *noise-cancelling headphones* può essere passato alla pagina di elenco dei prodotti. 1. **Visualizzazione dei dettagli dell'articolo**: se un utente fa clic su un'offerta, ad esempio un prodotto, l'identificatore univoco di tale articolo può essere passato come parametro alla pagina dei dettagli. Ciò consente alla pagina dei dettagli di visualizzare tutte le informazioni sull'articolo specifico. Ad esempio, quando un utente fa clic su un prodotto con cuffie, l'ID univoco del prodotto viene passato come parametro alla pagina dei dettagli del prodotto. 1. **Passaggio del contesto utente nella navigazione della pagina**: mentre gli utenti navigano tra le pagine, i parametri possono trasmettere un contesto importante, come la posizione dell'utente, le categorie di prodotti preferite, il contenuto del carrello degli acquisti e altre impostazioni. Ad esempio, quando un utente naviga tra diverse categorie di prodotti sull'app, la sua posizione e le categorie preferite vengono mantenute come parametri, offrendo un'esperienza personalizzata e coerente. 1. **Link diretti**: utilizza i parametri della pagina per condividere o aggiungere ai segnalibri un link a una pagina specifica all'interno dell'app. 1. **Azioni sui dati**: puoi creare azioni sui dati che accettano i valori dei parametri per filtrare e interrogare le fonti di dati in base ai parametri passati. Ad esempio, nella pagina di elenco dei prodotti, puoi creare un'azione sui dati che accetta `category` i parametri per recuperare i prodotti pertinenti. ## Considerazioni sulla sicurezza dei parametri di pagina Sebbene i parametri di pagina offrano un modo efficace per trasferire dati tra le pagine, è necessario utilizzarli con cautela, poiché possono potenzialmente esporre informazioni riservate se non utilizzati correttamente. Ecco alcune importanti considerazioni sulla sicurezza da tenere a mente: 1. **Evita di esporre dati sensibili in URLs** 1. **Rischio**: URLs, compresi i parametri di azione dei dati, sono spesso visibili nei log del server, nella cronologia del browser e in altri luoghi. Pertanto, è essenziale evitare di esporre dati sensibili, come credenziali utente, informazioni personali identificabili (PII) o altri dati riservati, nei valori dei parametri della pagina. 1. **Attenuazione**: prendi in considerazione l'utilizzo di identificatori che possono essere mappati in modo sicuro sui dati sensibili. Ad esempio, invece di passare il nome o l'indirizzo e-mail di un utente come parametro, è possibile passare un identificatore univoco casuale che può essere utilizzato per recuperare il nome o l'e-mail dell'utente. # Parametri di automazione I parametri di automazione sono una potente funzionalità di App Studio che può essere utilizzata per creare automazioni flessibili e riutilizzabili passando valori dinamici da varie fonti, come l'interfaccia utente, altre automazioni o azioni sui dati. Agiscono come segnaposto che vengono sostituiti con valori effettivi quando viene eseguita l'automazione, consentendoti di utilizzare la stessa automazione con input diversi ogni volta. All'interno di un'automazione, i parametri hanno nomi univoci ed è possibile fare riferimento al valore di un parametro utilizzando la variabile params seguita dal nome del parametro, ad esempio. `{{params.customerId}}` Questo articolo fornisce una comprensione approfondita dei parametri di automazione, inclusi i concetti fondamentali, l'utilizzo e le migliori pratiche. ## Vantaggi dei parametri di automazione I parametri di automazione offrono diversi vantaggi, tra cui il seguente elenco: 1. **Riusabilità**: utilizzando i parametri, è possibile creare automazioni riutilizzabili che possono essere personalizzate con valori di input diversi, che consentono di riutilizzare la stessa logica di automazione con input diversi. 1. **Flessibilità**: invece di codificare i valori in un'automazione, è possibile definire parametri e fornire valori diversi quando necessario, rendendo le automazioni più dinamiche e adattabili. 1. **Separazione delle preoccupazioni**: i parametri aiutano a separare la logica di automazione dai valori specifici utilizzati, promuovendo l'organizzazione e la manutenibilità del codice. 1. **Convalida**: ogni parametro ha un tipo di dati, ad esempio stringa, numero o booleano, che viene convalidato in fase di esecuzione. Ciò garantisce che le richieste con tipi di dati errati vengano rifiutate senza la necessità di un codice di convalida personalizzato. 1. **Parametri opzionali e obbligatori**: è possibile designare i parametri di automazione come facoltativi o obbligatori. I parametri obbligatori devono essere forniti durante l'esecuzione dell'automazione, mentre i parametri opzionali possono avere valori predefiniti o essere omessi. Questa flessibilità consente di creare automazioni più versatili in grado di gestire diversi scenari in base ai parametri forniti. ## Scenari e casi d'uso ### Scenario: recupero dei dettagli del prodotto Immagina di avere un'automazione che recupera i dettagli del prodotto da un database basato su un ID del prodotto. Questa automazione potrebbe avere un parametro chiamato`productId`. Il `productId` parametro funge da segnaposto che è possibile inserire con il valore effettivo dell'ID del prodotto durante l'esecuzione dell'automazione. Invece di codificare un ID prodotto specifico nell'automazione, puoi definire il `productId` parametro e passare valori ID di prodotto diversi ogni volta che esegui l'automazione. Puoi richiamare questa automazione dalla fonte dati di un componente, passando l'ID del prodotto selezionato come `productId` parametro utilizzando la sintassi con doppia parentesi curva:. `{{ui.productsTable.selectedRow.id}}` In questo modo, quando un utente seleziona un prodotto da una tabella (`ui.productsTable`), l'automazione recupererà i dettagli del prodotto selezionato passando l'id della riga selezionata come parametro. `productId` In alternativa, puoi richiamare questa automazione da un'altra automazione che esegue un ciclo su un elenco di prodotti e recupera i dettagli di ciascun prodotto passando l'id del prodotto come parametro. `productId` In questo scenario, il valore del `productId` parametro verrebbe fornito dinamicamente dall'`{{product.id}}`espressione in ogni iterazione del ciclo. Utilizzando il `productId` parametro e la sintassi con doppia parentesi curva, è possibile rendere questa automazione più flessibile e riutilizzabile. Invece di creare automazioni separate per ogni prodotto, puoi disporre di un'unica automazione in grado di recuperare i dettagli di qualsiasi prodotto semplicemente fornendo l'ID del prodotto appropriato come valore del parametro da diverse fonti, come componenti dell'interfaccia utente o altre automazioni. ### Scenario: gestione dei parametri opzionali con valori di fallback Prendiamo in considerazione uno scenario in cui si dispone di un'entità «Task» con una colonna «Owner» obbligatoria, ma si desidera che questo campo sia facoltativo nell'automazione e fornisca un valore di fallback se il proprietario non è selezionato. 1. Crea un'automazione con un parametro denominato `Owner` mappato al `Owner` campo dell'`Task`entità. 1. Poiché il `Owner` campo è obbligatorio nell'entità, il `Owner` parametro si sincronizzerà con l'impostazione richiesta. 1. Per rendere il `Owner` parametro opzionale nell'automazione, disattiva l'`required`impostazione per questo parametro. 1. Nella logica di automazione, puoi usare un'espressione come. `{{params.Owner || currentUser.userId}}` Questa espressione verifica se il `Owner` parametro è fornito. Se non viene fornito, tornerà all'ID dell'utente corrente come proprietario. 1. In questo modo, se l'utente non seleziona un proprietario in un modulo o in un componente, l'automazione assegnerà automaticamente l'utente corrente come proprietario dell'attività. Modificando l'`required`impostazione del `Owner` parametro e utilizzando un'espressione di fallback, è possibile disaccoppiarlo dal requisito del campo di entità, renderlo facoltativo nell'automazione e fornire un valore predefinito quando il parametro non viene fornito. ## Definizione dei tipi di parametri di automazione Utilizzando i tipi di parametri per specificare i tipi di dati e impostare i requisiti, puoi controllare gli input per le tue automazioni. Questo aiuta a garantire che le automazioni funzionino in modo affidabile con gli input previsti. ### Sincronizzazione dei tipi da un'entità La sincronizzazione dinamica dei tipi di parametri e dei requisiti dalle definizioni dei campi di entità semplifica la creazione di automazioni che interagiscono con i dati delle entità, garantendo che il parametro rifletta sempre il tipo e i requisiti più recenti dei campi di entità. La procedura seguente descrive in dettaglio i passaggi generali per la sincronizzazione dei tipi di parametri da un'entità: 1. Crea un'entità con campi digitati (ad esempio Booleano, Numero, ecc.) e contrassegna i campi secondo necessità. 1. Crea una nuova automazione. 1. Aggiungi parametri all'automazione e, quando scegli il **Tipo**, scegli il campo dell'entità con cui desideri sincronizzarti. Il tipo di dati e l'impostazione richiesta verranno sincronizzati automaticamente dal campo dell'entità mappata 1. Se necessario, puoi sovrascrivere l'impostazione «obbligatoria» modificandola per ogni parametro. on/off Ciò significa che lo stato richiesto non verrà mantenuto sincronizzato con il campo dell'entità, ma in caso contrario rimarrà sincronizzato. ### Definizione manuale dei tipi È inoltre possibile definire i tipi di parametri manualmente senza sincronizzarsi da un'entità Definendo tipi di parametri personalizzati, è possibile creare automazioni che accettano tipi di input specifici e gestiscono parametri opzionali o obbligatori in base alle esigenze, senza fare affidamento sulle mappature dei campi delle entità. 1. Crea un'entità con campi digitati (ad esempio Booleano, Numero, ecc.) e contrassegna i campi secondo necessità. 1. Crea una nuova automazione. 1. Aggiungi parametri all'automazione e, quando scegli il **Tipo**, scegli il tipo desiderato. ## Configurazione dei valori dinamici da passare ai parametri di automazione Dopo aver definito i parametri per un'automazione, è possibile passare loro dei valori quando si richiama l'automazione. Puoi passare i valori dei parametri in due modi: 1. **Trigger dei** componenti: se richiami l'automazione da un trigger del componente, ad esempio facendo clic su un pulsante, puoi utilizzare JavaScript le espressioni per passare valori dal contesto del componente. Ad esempio, se hai un campo di immissione di testo denominato`emailInput`, puoi passarne il valore al parametro email con la seguente espressione:. `ui.emailInput.value` 1. **Altre automazioni**: Se stai richiamando l'automazione da un'altra automazione, puoi utilizzare JavaScript le espressioni per passare valori dal contesto di automazione. Ad esempio, puoi passare il valore di un altro parametro o il risultato di un'azione precedente. ## Tipo di sicurezza Definendo parametri con tipi di dati specifici, come String, Number o Boolean, puoi assicurarti che i valori passati all'automazione siano del tipo previsto. **Nota** In App Studio, le date sono date di stringhe ISO e anch'esse verranno convalidate. Questo tipo di sicurezza aiuta a prevenire le discrepanze tra i tipi, che possono portare a errori o comportamenti imprevisti nella logica di automazione. Ad esempio, se definisci un parametro come a`Number`, puoi essere certo che qualsiasi valore passato a quel parametro sarà un numero e non dovrai eseguire ulteriori controlli o conversioni di tipo all'interno dell'automazione. ## Convalida Puoi aggiungere regole di convalida ai parametri, assicurandoti che i valori passati all'automazione soddisfino determinati criteri. Sebbene App Studio non fornisca impostazioni di convalida integrate per i parametri, puoi implementare convalide personalizzate aggiungendo un' JavaScript azione all'automazione che genera un errore in caso di violazione di vincoli specifici. Per i campi di entità, è supportato un sottoinsieme di regole di convalida, come i valori. minimum/maximum Tuttavia, questi non vengono convalidati a livello di automazione, ma solo a livello di dati, quando si eseguono Create/Update/Delete azioni Record. ## Le migliori pratiche per i parametri di automazione Per garantire che i parametri di automazione siano ben progettati, gestibili e facili da usare, segui queste best practice: 1. **Usa nomi descrittivi dei parametri**: scegli nomi di parametro che descrivano chiaramente lo scopo o il contesto del parametro. 1. **Fornisci descrizioni dei parametri**: sfrutta il campo **Descrizione** quando definisci i parametri per spiegarne lo scopo, i vincoli e le aspettative. Queste descrizioni verranno visualizzate nei JSDoc commenti quando si fa riferimento al parametro, nonché in tutte le interfacce utente in cui gli utenti devono fornire valori per i parametri quando richiamano l'automazione. 1. **Utilizza tipi di dati appropriati**: considera attentamente il tipo di dati di ciascun parametro in base ai valori di input previsti, ad esempio: String, Number, Boolean, Object. 1. **Convalida dei valori dei parametri**: implementa i controlli di convalida appropriati all'interno dell'automazione per garantire che i valori dei parametri soddisfino requisiti specifici prima di procedere con ulteriori azioni. 1. **Usa valori di fallback o predefiniti**: Sebbene App Studio attualmente non supporti l'impostazione di valori predefiniti per i parametri, puoi implementare valori di fallback o predefiniti quando utilizzi i parametri nella tua logica di automazione. Ad esempio, puoi usare un'espressione come `{{ params.param1 || "default value" }}` per fornire un valore predefinito se il `param1` parametro non viene fornito o ha un valore falso. 1. **Mantieni la coerenza dei parametri**: se disponi di più automazioni che richiedono parametri simili, prova a mantenere la coerenza nei nomi dei parametri e nei tipi di dati tra tali automazioni. 1. **Documenta l'utilizzo dei parametri**: mantieni una documentazione chiara per le tue automazioni, comprese le descrizioni di ciascun parametro, il suo scopo, i valori previsti ed eventuali esempi o casi limite pertinenti. 1. **Rivedi e rifattorizza frequentemente**: rivedi periodicamente le automazioni e i relativi parametri, rifattorizzando o consolidando i parametri secondo necessità per migliorare la chiarezza, la manutenibilità e la riusabilità. 1. **Limita il numero di parametri: sebbene i parametri** offrano flessibilità, troppi parametri possono rendere un'automazione complessa e difficile da usare. Cerca di trovare un equilibrio tra flessibilità e semplicità limitando il numero di parametri solo a ciò che è necessario. 1. **Prendi in considerazione il raggruppamento dei** parametri: se ti ritrovi a definire più parametri correlati, valuta la possibilità di raggrupparli in un unico parametro. *Object* 1. **Preoccupazioni separate**: evita di utilizzare un singolo parametro per più scopi o di combinare valori non correlati in un unico parametro. Ogni parametro deve rappresentare un problema o un dato distinto. 1. **Usa alias di parametri**: se disponi di parametri con nomi lunghi o complessi, prendi in considerazione l'utilizzo di alias o versioni abbreviate all'interno della logica di automazione per una migliore leggibilità e gestibilità. Seguendo queste best practice, è possibile garantire che i parametri di automazione siano ben progettati, gestibili e facili da usare, migliorando in ultima analisi la qualità e l'efficienza complessive delle automazioni.