Listrutor för överlappande
En överlappande nedrullningsbar lista är en serie beroende DropDownList-kontroller där en DropDownList-kontroll är beroende av den överordnade eller föregående DropDownList-kontroller. Objekten i DropDownList-kontrollen fylls i baserat på ett objekt som väljs av användaren från en annan DropDownList-kontroll.
Demonstration av användningsfallet
I den här självstudiekursen har jag använt Geonames REST API för att demonstrera den här funktionen.
Det finns ett antal organisationer som erbjuder den här typen av tjänster och så länge de har väldokumenterade REST API:er kan du enkelt integrera med AEM Forms med hjälp av dataintegreringsfunktionen
Följande steg har utförts för att implementera listrutor i listrutan för överlappande i AEM Forms
Skapa utvecklarkonto
Skapa ett utvecklarkonto med geografiska namn. Anteckna användarnamnet. Användarnamnet behövs för att anropa REST API:er för mappen geonames.org.
Skapa Swagger/OpenAPI-fil
OpenAPI-specifikationen (tidigare Swagger-specifikationen) är ett API-beskrivningsformat för REST API:er. Med en OpenAPI-fil kan du beskriva hela ditt API, inklusive:
- Tillgängliga slutpunkter (https://experienceleague.adobe.com/users?lang=sv) och åtgärder för varje slutpunkt (GET /users, POST /users)
- Operationsparametrar Indata och utdata för varje åtgärd
Autentiseringsmetoder - Kontaktinformation, licens, användningsvillkor och annan information.
- API-specifikationer kan skrivas i YAML eller JSON. Formatet är lätt att lära sig och kan läsas av både människor och datorer.
Följ OpenAPI-dokumentationen för att skapa din första swagger/OpenAPI-fil
Använd swagger-redigeraren för att skapa en swagger-fil som beskriver åtgärderna som hämtar alla länder och underordnade element för landet eller staten. Swagger-filen kan skapas i JSON- eller YAML-format.
Skapa datakällor
Om du vill integrera AEM/AEM Forms med program från tredje part måste vi skapa datakälla i konfigurationen för molntjänster. Använd swagger-filerna för att skapa datakällor.
Du måste skapa två datakällor (en för att hämta alla länder och andra för att få underordnade element)
Skapa formulärdatamodell
AEM Forms dataintegrering ger ett intuitivt användargränssnitt för att skapa och arbeta med formulärdatamodeller. Basera formulärdatamodellen på datakällorna som skapades i det tidigare steget. Formulärdatamodell med 2 datakällor
Skapa anpassat formulär
Integrera GET-anropen i formulärdatamodellen med ditt anpassningsbara formulär för att fylla i listrutorna.
Skapa ett anpassningsbart formulär med 2 nedrullningsbara listor. En för att lista länderna och en för att lista staterna/provinserna beroende på vilket land som valts.
Listruta för att fylla i länder
Länklistan fylls i när formuläret initieras för första gången. I följande skärmbild visas regelredigeraren som är konfigurerad att fylla i alternativen i den nedrullningsbara listan med länder. Du måste ange ditt användarnamn med geonames-kontot för att detta ska fungera.
Fyll i listrutan Region
Vi måste fylla i den nedrullningsbara listan Stat/provins baserat på det valda landet. Följande skärmbild visar konfigurationen för regelredigeraren
Utövning
Lägg till två nedrullningsbara listor med namnet fylken och städer i formuläret för att lista fylken och staden baserat på valt land och vald stat/provins.
Exempel på Assets
Du kan ladda ned följande resurser för att få ett försprång i överlappande listruteexempel
De färdiga swagger-filerna kan hämtas från här
Swagger-filerna beskriver följande REST API
Den färdiga formulärdatamodellen kan hämtas här