Aan de slag met Edge Delivery Services for AEM Forms met Universal Editor (WYSIWYG)
Deze functie is beschikbaar via het programma voor vroege toegang. Om toegang te verzoeken, verzend een e-mail van uw officieel adres naar aem-forms-ea@adobe.commet uw GitHub organisatienaam en bewaarplaatsnaam. Bijvoorbeeld, als de bewaarplaats URL https://github.com/adobe/abc is, is de organisatienaam adobe en de bewaarplaatsnaam abc.
In het huidige digitale tijdperk zijn gebruikersvriendelijke formulieren essentieel voor alle organisaties. Edge Delivery Services Forms wordt gemaakt met de Universal Editor, die WYSIWYG-mogelijkheden (what-you-see-is-what-you-get) biedt. Het biedt een moderne, intuïtieve interface voor efficiënt ontwerpen van formulieren.
AEM Forms biedt een blok, het Adaptive Forms Block, waarmee u eenvoudig Edge Delivery Services Forms kunt maken om gegevens vast te leggen en op te slaan. U kunt een nieuw Project van AEM tot stand brengen dat met het AanpassingsBlok van Formswordt gevormd of het Aangepaste Blok van Forms aan een bestaand Project van AEMtoevoegt.
Deze zelfstudie begeleidt u bij het maken, voorvertonen en publiceren van uw eigen formulier met een nieuw of bestaand Adobe Experience Manager Site-project met behulp van de WYSIWYG-authoring van Universal Editor.
Vereisten
- U hebt een rekening GitHub, en begrijpt de grondbeginselen van het Git.
- U begrijpt de basisbeginselen van HTML, CSS en JavaScript.
- Node/npm is geïnstalleerd voor lokale ontwikkeling.
Een nieuw AEM-project maken dat vooraf is geconfigureerd met Adaptive Forms Block
Met de AEM Forms Boilerplate-sjabloon kunt u snel aan de slag met een AEM-project dat vooraf is geconfigureerd met het Adaptive Forms Block. Dit is de snelste en eenvoudigste manier om de beste praktijken van AEM te volgen en meteen uw formulieren samen te stellen.
Aan de slag met de AEM Forms boilerplate-opslagsjabloon
-
Creeer een bewaarplaats GitHub voor uw Project van AEM. Opslagplaats maken:
-
Ga naar https://github.com/adobe-rnd/aem-boilerplate-forms.
-
Klik het Gebruik deze malplaatje optie en selecteer creeer een nieuwe bewaarplaats optie.
creeer een nieuwe bewaarplaats scherm opent.
-
Op creeer een nieuwe bewaarplaats scherm, selecteer de eigenaar, en specificeer Naam van de Bewaarplaats. Adobe adviseert om de bewaarplaats aan Openbaar te plaatsen. Zo, selecteer de openbare optie, en klik creeer Bewaarplaats.
-
-
Installeer de AEM Code Sync GitHub App in uw repository. Installeren:
- Ga naar https://github.com/apps/aem-code-sync/installations/new.
- Op installeer het scherm van de Synchronisatie van de Code van AEM, selecteer slechts de optie van Bewaarplaatsen en selecteer uw pas gecreëerde bewaarplaats. Klik sparen.
-
Koppel nu de GitHub-opslagplaats die u met AEM Forms Boilerplate hebt gemaakt aan uw AEM Project-ontwerpomgeving. Verbinding maken:
-
Ga naar de bewaarplaats GitHub die u eerder gebruikend AEM Forms Boilerplate creeerde.
-
Open het {dossier 0} fstab.yaml voor het uitgeven.
-
Bewerk het {dossier 0} fstab.yaml om het koppelingspunt van uw project bij te werken. Vervang de URL door de URL van de AEM as a Cloud Service-ontwerpinstantie.
https://<aem-author>/bin/franklin.delivery/<owner>/<repository>/main
-
Leg het bijgewerkte {dossier 0} fstab.yaml vast, zodra u de verwijzing hebt bijgewerkt en alles ziet er goed uit.
Als u om het even welke bouwstijlkwesties ontmoet, zie het oplossen van problemen GitHub bouwt kwesties.
-
Een nieuw AEM-project maken
Nu u een project GitHub hebt, kunt u te werk gaan om een nieuw Project van AEM bij de het auteursinstantie van AEM as a Cloud Service tot stand te brengen en te publiceren.
-
Een nieuw AEM-project maken:
-
Login aan de auteursinstantie van AEM as a Cloud Service en selecteert Plaatsen.
-
Klik creëren > Plaats van malplaatje.
-
Selecteer het malplaatje van de Plaats van Edge Delivery Services en klik daarna.
note note NOTE - Als de Edge Delivery Services Site-sjabloon niet beschikbaar is in uw ontwerpexemplaar, klikt u op de knop Importeren om de sjabloon te uploaden.
- U kunt de malplaatjes van de Plaats van Edge Delivery Services van GitHubdownloaden.
-
Voer de volgende gegevens in om een nieuw AEM-project te maken:
- titel van de Plaats - voeg een beschrijvende titel voor de plaats toe.
- titel van de Plaats - gebruik
site-name
dat u in de vorige stap bepaalde. - GitHub URL - gebruik URL van het project GitHub u in de vorige stap creeerde.
-
creeer de dialoog van de Plaats verschijnt, klik Oke.
Binnen een paar minuten wordt je nieuwe AEM Project gemaakt.
-
Navigeer aan uw onlangs-gecreeerd project van AEM in de console van Plaatsen en klik uitgeven.
In dit geval wordt de paginaindex.html
gebruikt ter illustratie.Het AEM-project wordt op een nieuw tabblad in de Universal Editor geopend, zodat u WYSIWYG kunt ontwerpen. U kunt nu uw AEM-project bewerken.
-
-
Uw gemaakte AEM-project publiceren
Publiceer het AEM-project als u klaar bent met het bewerken. Publiceren:
-
Voor de console van Plaatsen, selecteer alle pagina's van het Project van AEM en klik Snel publiceren.
-
Het Snelle publiceer bevestigingsdialoog verschijnt, publiceert om het het publiceren proces te beginnen.
U kunt uw AEM-projectpagina's ook rechtstreeks vanuit de gebruikersinterface van de Universal Editor publiceren.
Gefeliciteerd! Er wordt een nieuwe website uitgevoerd op
https://<branch>--<repo>--<owner>.aem.page/content/<site-name>/
.<branch>
verwijst naar de vertakking van uw bewaarplaats GitHub.<repository>
geeft uw GitHub-opslagplaats aan.<owner>
verwijst naar gebruikersbenaming van uw rekening GitHub die gastheren uw bewaarplaats GitHub.<site-name>
verwijst naar de naam van de door u gemaakte site.
Als de naam van de vertakking bijvoorbeeld
main
is, de opslagplaatsedsforms
is, de eigenaarwkndforms
is ensite-name
iseds-forms
, wordt de website uitgevoerd ophttps://main--edsforms--wkndforms.aem.page/content/eds-forms/
note note NOTE - Als u de pagina
index.html
van het AEM-project wilt weergeven, gebruikt u de URL:https://<branch>--<repo>--<owner>.aem.page/content/<site-name>/
- Als u andere pagina's dan de
index page
van het AEM-project wilt weergeven, gebruikt u de URL:https://<branch>--<repo>--<owner>.aem.page/content/<site-name>/<site-page-name>
-
Nu, kunt u beginnen creërend en toevoegend vormen aan uw Project van AEM.
Aangepast Forms-blok toevoegen aan uw bestaande AEM-project
Als u een bestaand AEM-project hebt, kunt u het Adaptive Forms Block integreren in uw huidige project om aan de slag te gaan met het maken van formulieren.
Integreren:
-
voegt vereiste dossiers en omslagen toe
-
Kopieer en kleef de volgende omslagen en de dossiers van AEM Forms Boilerplatein uw Project van AEM:
- van het vormblokomslag
- vorm-gemeenschappelijkeomslag
- vorm-componentenomslag
- vorm-redacteur-support.jsdossier
- vorm-redacteur-support.cssdossier
-
-
de componentendefinities en modeldossiers van de Update
-
Navigeer naar het
../models/_component-definition.json
dossier in uw Project van AEM en werk het met de veranderingen van het _component-definition.json- dossier in de Boilerplate van AEM Formsbij. -
Navigeer naar het
../models/_component-models.json
dossier in uw Project van AEM en werk het met de veranderingen van het _component-models.json dossier in de Boilerplate van AEM Forms bij
-
-
voeg de Redacteur van de Vorm in redacteursmanuscript toe
- Navigeer aan het
../scripts/editor-support.js
dossier in uw Project van AEM en werk het met de veranderingen van het { redacteur-support.js- dossier in AEM Forms Boilerplatebij
- Navigeer aan het
-
update ESLint configuratiedossier
-
Navigeer naar het
../.eslintignore
-bestand in uw AEM-project en voeg de volgende coderegel toe om fouten met betrekking tot de regelengine voor formulierblokken te voorkomen:code language-none blocks/form/rules/formula/* blocks/form/rules/model/*
-
-
Leg deze wijzigingen vast en duw deze naar uw AEM Project-opslagplaats op GitHub.
Dat is het! Het Adaptive Forms Block maakt nu deel uit van uw AEM-project. U kunt beginnen tot stand te brengen en vormen toe te voegen aan uw Project van AEM.
Forms autoriseren met WYSIWYG
U kunt uw AEM-project openen in de Universal Editor voor WYSIWYG-ontwerpen. Hierin kunt u het project bewerken en de sectie Adaptief formulier toevoegen om Edge Delivery Services-formulieren op AEM Project-pagina's toe te voegen.
-
Voeg de sectie Adaptief formulier toe aan uw AEM-projectpagina. Toevoegen:
- Navigeer aan uw project van AEM in de console van Plaatsen, selecteer de plaatspagina u wilt uitgeven, en klik uitgeven. De AEM-projectpagina wordt geopend in de Universal Editor en kan worden bewerkt.
In dit geval wordt de paginaindex.html
gebruikt ter illustratie. - Open de Inhoudsstructuur en navigeer naar een sectie waar u de sectie Aangepast formulier wilt toevoegen.
- Klik op het pictogram Add en selecteer de component Adaptive Form in de lijst met componenten.
De sectie Adaptief formulier wordt toegevoegd. U kunt nu formuliercomponenten toevoegen aan de AEM-projectpagina.
- Navigeer aan uw project van AEM in de console van Plaatsen, selecteer de plaatspagina u wilt uitgeven, en klik uitgeven. De AEM-projectpagina wordt geopend in de Universal Editor en kan worden bewerkt.
-
Voeg formuliercomponenten toe aan de toegevoegde sectie Adaptief formulier. Formuliercomponenten toevoegen:
-
Navigeer naar de toegevoegde sectie Adaptief formulier in de Inhoudsstructuur.
-
Klik het Add pictogram en voeg de gewenste componenten van de Adaptieve lijst van Componenten van de Vorm toe.
U kunt ook de vereiste Adaptieve Forms-componenten slepen en neerzetten, aangezien de Universal Editor een intuïtieve functie voor slepen en neerzetten biedt.
-
Selecteer de toegevoegde component Adaptief formulier om de eigenschappen van de component bij te werken met Properties .
-
Bekijk een voorbeeld van het formulier.
In de onderstaande schermafbeelding wordt het formulier weergegeven dat in het AEM Project is gemaakt en dat gebruikmaakt van WYSIWYG-authoring:Als de gebruiker tevreden is met de voorvertoning, kan hij doorgaan met het publiceren van de pagina.
note note NOTE Het is belangrijk dat u de AEM Project-pagina opnieuw publiceert nadat u wijzigingen hebt aangebracht. Als dit niet het geval is, zijn de updates niet zichtbaar in de browser.
-
-
Publiceer de AEM-projectpagina opnieuw.
-
Klik publiceren om de pagina van het Project van AEM na het toevoegen van de vorm opnieuw te publiceren.
-
De publiceer bevestigingsdialoog verschijnt op het scherm, publiceert om te beginnen publiceren.
Zodra u klikt publiceer knoop, verschijnt het
Publish started successfully
bericht.
U kunt nu de AEM-projectpagina met het toegevoegde Edge Delivery Services-formulier bekijken op de volgende URL:
https://<branch>--<repo>--<owner>.aem.page/content/<site-name>/
.Als de naam van de vertakking bijvoorbeeld
main
is, de opslagplaatsedsforms
is, de eigenaarwkndforms
is en de naam van de siteeds-forms
is, is de URL:https://main--edsforms--wkndforms.aem.page/content/eds-forms/
-
U kunt Edge Delivery Services Forms opmaken door de .css
en .js
dossiers in het AanpassingsBlok van Forms en vestiging een lokale ontwikkelomgeving van AEMuit te geven om de veranderingen in uw browser onmiddellijk te bekijken.
Lokale AEM-ontwikkelomgeving instellen
U kunt een lokale AEM-ontwikkelomgeving instellen voor het lokaal ontwikkelen van aangepaste stijlen en componenten. Aan de slag met een lokale AEM-ontwikkelomgeving:
-
installeer CLI van AEM: AEM CLI vereenvoudigt ontwikkelingstaken. Laten we het wereldwijd installeren met npm:
code language-bash npm install -g @adobe/aem-cli
-
Kloon uw project GitHub: Kloon uw plaats van het Project van AEM van GitHub gebruikend het volgende bevel, die vervangt <owner> met de eigenaar van de opslagplaats en <repo> met de naam van de opslagplaats:
code language-none git clone https://github.com/<owner>/<repo>
-
Begin Uw Lokaal Milieu: Navigeer aan uw projectfolder en begin uw lokale instantie van AEM met één enkel bevel:
code language-none cd <repo> aem up
U kunt lokale wijzigingen aanbrengen in de map Adaptive Forms Block blocks/form
voor de opmaak en codering van uw formulieren. Bewerk de .css
- of .js
-bestanden in deze map en u ziet dat de wijzigingen direct in uw browser worden doorgevoerd.
Nadat u de wijzigingen hebt aangebracht, gebruikt u de opdrachten van Git om deze vast te leggen en door te drukken. Hiermee werkt u de voorvertoning- en productieomgevingen bij, die toegankelijk zijn via de volgende URL's (vervang plaatsaanduidingen door uw projectdetails):
Voorvertoning: https://<branch>--<repo>--<owner>.aem.page/content/<site-name>
Productie: https://<branch>--<repo>--<owner>.aem.live/content/<site-name>
Het oplossen van problemen GitHub bouwt kwesties
Verzeker een vlotte GitHub bouwt proces door potentiële kwesties te richten:
-
handvat het Leiden Fouten:
Als u tegenkomt met regelfouten, kunt u deze omzeilen. Open het ] /package.json dossier van het Project van 0} EDS {en wijzig het "plusteken"manuscript van"lint": "npm run lint:js && npm run lint:css"
aan"lint": "echo 'skipping linting for now'"
. [ Sparen het dossier en begaat de veranderingen in uw project GitHub. -
los de Fout van de Weg van de Module op:
Als u de fout "Onbekwaam ontmoet om weg aan module ""…/…/scripts/lib-franklin.js"op te lossen, navigeer aan het [ EDS Project ] /blocks/forms/form.js- dossier. Werk de importinstructie bij door het bestand lib-franklin.js te vervangen door het bestand aem.js.
Zie ook
- Uw eerste formulier maken met Universal Editor
- Dynamisch gedrag toevoegen aan Forms
- Handelingen voor het verzenden van formulieren configureren en aanpassen
- Forms publiceren en implementeren
- Mooie Forms: handleiding voor stijlen en thema's
- Aangepaste formuliercomponenten maken
- Bescherm uw Forms tegen spam: reCAPTCHA-beveiliging toevoegen