Elenchi a discesa a cascata
Un elenco a discesa a cascata è una serie di controlli DropDownList dipendenti in cui un controllo DropDownList dipende dai controlli DropDownList padre o precedente. Gli elementi del controllo DropDownList vengono compilati in base a un elemento selezionato dall'utente da un altro controllo DropDownList.
Dimostrazione del caso d’uso
Ai fini di questa esercitazione, ho utilizzato API REST Geonames per dimostrare questa funzionalità.
Esistono diverse organizzazioni che forniscono questo tipo di servizio e, purché dispongano di API REST ben documentate, puoi facilmente integrarle con AEM Forms utilizzando la funzionalità di integrazione dei dati
Sono stati seguiti i seguenti passaggi per implementare gli elenchi a discesa a cascata in AEM Forms
Crea account sviluppatore
Crea un account sviluppatore con Geonames. Prendi nota del nome utente. Questo nome utente è necessario per richiamare le API REST di geonames.org.
Crea file Swagger/OpenAPI
OpenAPI Specification (precedentemente Swagger Specification) è un formato di descrizione API per le API REST. Un file OpenAPI ti consente di descrivere l’intera API, tra cui:
- Endpoint disponibili (https://experienceleague.adobe.com/users?lang=it) e operazioni su ciascun endpoint (GET /users, POST /users)
- Parametri di funzionamento Input e output per ogni operazione
Metodi di autenticazione - Informazioni di contatto, licenza, condizioni d’uso e altre informazioni.
- Le specifiche API possono essere scritte in YAML o JSON. Il formato è facile da imparare e leggibile sia per gli esseri umani che per le macchine.
Per creare il primo file swagger/OpenAPI, segui la documentazione OpenAPI
Utilizza l'editor Swagger per creare il file Swagger e descrivere le operazioni di recupero di tutti i paesi e degli elementi figlio del paese o dello stato. Il file swagger può essere creato in formato JSON o YAML.
Creare origini dati
Per integrare AEM/AEM Forms con applicazioni di terze parti, è necessario creare l'origine dati nella configurazione dei servizi cloud. Utilizza i file Swagger per creare le tue origini dati.
Dovrai creare 2 origini dati (una per recuperare tutti i paesi e l’altra per ottenere elementi figlio)
Crea modello dati modulo
L'integrazione dei dati di AEM Forms fornisce un'interfaccia utente intuitiva per la creazione e l'utilizzo di modelli di dati modulo. Basare il modello dati del modulo sulle origini dati create nel passaggio precedente. Modello dati modulo con 2 origini dati
Creare un modulo adattivo
Integra le chiamate GET del modello dati del modulo con il modulo adattivo per compilare gli elenchi a discesa.
Crea un modulo adattivo con 2 elenchi a discesa. Uno per elencare i paesi e uno per elencare gli stati/province a seconda del paese selezionato.
Elenco a discesa Popola paesi
L'elenco dei paesi viene compilato la prima volta che il modulo viene inizializzato. La schermata seguente mostra l’editor di regole configurato per compilare le opzioni dell’elenco a discesa Paese. Affinché ciò funzioni, devi fornire al tuo nome utente l’account dei nomi geografici.
Popolare l’elenco a discesa Stato/Provincia
È necessario compilare l’elenco a discesa Stato/Provincia in base al paese selezionato. La schermata seguente mostra la configurazione dell’editor di regole
Esercizio
Aggiungi 2 elenchi a discesa denominati contee e città nel modulo per elencare le contee e le città in base al paese e allo stato/provincia selezionati.
Assets di esempio
Scarica le seguenti risorse per iniziare subito a creare l’esempio dell’elenco a discesa a cascata
I file Swagger completati possono essere scaricati da qui
I file swagger descrivono la seguente API REST
Il modello dati modulo completato può essere scaricato da qui