Documentatie AEM as a Cloud Service Handboek

Een aangepaste verzendactie maken voor Adaptive Forms (Core Components)

Last update: Mon Nov 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

tussenpersoon
Gebruiker
Ontwikkelaar

Met een verzendactie kunnen gebruikers de bestemming selecteren voor de gegevens die in een formulier zijn vastgelegd en aanvullende functionaliteit definiëren die bij het verzenden van het formulier moet worden uitgevoerd. AEM vorm steunt veelvoudige voorlegt acties uit-van-de-doos (OOTB), zoals het verzenden van een e-mail of het opslaan van gegevens naar SharePoint of OneDrive.

U kunt een douane ook creëren voorlegt actie om functionaliteit toe te voegen niet inbegrepen in uit-van-de-doos opties. U kunt bijvoorbeeld de formuliergegevens integreren met een toepassing van een derde of een gepersonaliseerde SMS-melding activeren op basis van de gebruikersinvoer.

Voorwaarden

Voordat u begint met het maken van uw eerste aangepaste verzendactie voor Adaptive Forms, moet u het volgende doen:

Onbewerkte Redacteur van de Tekst (winde): Terwijl om het even welke duidelijke tekstredacteur kan werken, biedt een Geïntegreerde Milieu van de Ontwikkeling (winde) zoals de Code van Microsoft Visual Studio geavanceerde eigenschappen voor het gemakkelijkere uitgeven aan.
Git: Dit systeem van de versiecontrole wordt vereist voor het beheren van codeveranderingen. Als u deze niet hebt geïnstalleerd, kunt u deze downloaden van https://git-scm.com.

Uw eerste aangepaste verzendactie voor een formulier maken

In het onderstaande diagram worden de stappen beschreven voor het maken van een aangepaste verzendactie voor een adaptieve vorm:

Aangepast voorlegt actiewerkschema {width=50%, hoogte-50%)

Clone AEM as a Cloud Service Git-gegevensopslagruimte.

Open de opdrachtregel en kies een map waarin u de AEM as a Cloud Service-opslagplaats wilt opslaan, bijvoorbeeld /cloud-service-repository/ .

Voer de onderstaande opdracht uit om de gegevensopslagruimte te klonen:

code language-none
`git clone https://git.cloudmanager.adobe.com/<organization-name>/<app-id>/`

waar om deze informatie te vinden?

Voor geleidelijke instructies bij het bepalen van de plaats van deze details, verwijs naar het artikel van Adobe Experience League " tot Toegang hebbend Git".

Uw project is klaar!

Wanneer de opdracht met succes is voltooid, ziet u een nieuwe map die in uw lokale map is gemaakt. Deze map krijgt de naam van uw toepassing (bijvoorbeeld app-id). Deze map bevat alle bestanden en code die u hebt gedownload van uw AEM as a Cloud Service Git-opslagplaats. U kunt <appid> voor uw AEM Project in het archetype.properties dossier vinden.

archetype Eigenschappen

In deze handleiding wordt deze map de [AEMaaCS project directory] genoemd.

Nieuwe verzendactie toevoegen

Open de opslagplaats map in een editor.

Navigeer naar de volgende map in de [AEMaaCS project directory] :

code language-none
`/ui.apps/src/main/content/jcr_root/apps/<app-id>/`

Belangrijk: Vervang <app-id> met uw daadwerkelijke toepassingsidentiteitskaart

Maak een nieuwe map voor uw aangepaste verzendactie en geef deze een door u gewenste naam. Geef de map bijvoorbeeld de naam customsubmitaction .
Navigeer naar de toegevoegde aangepaste verzendactiemap.

Navigeer binnen uw [AEMaaCS project directory] naar het volgende pad:

/ui.apps/src/main/content/jcr_root/apps/<app-id>/customsubmitaction/

Important: vervangen <app-id> met uw werkelijke toepassings-id.
Nieuw configuratiebestand maken.
Maak in de map customsubmitaction een nieuw bestand met de naam .content.xml .

Open dit bestand en plak de volgende inhoud, waarbij u [customsubmitaction] vervangt door de naam van de verzendactie

code language-none

code language-none
`<?xml version="1.0" encoding="UTF-8"?> <jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0" jcr:description="[customsubmitaction]" jcr:primaryType="sling:Folder" guideComponentType="fd/af/components/guidesubmittype" guideDataModel="basic,xfa,xsd" submitService="[customsubmitaction]"/>`

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:sling="http://sling.apache.org/jcr/sling/1.0"
jcr:description="[customsubmitaction]"
jcr:primaryType="sling:Folder"

guideComponentType="fd/af/components/guidesubmittype"
guideDataModel="basic,xfa,xsd"
submitService="[customsubmitaction]"/>

Vervang bijvoorbeeld [customsubmitaction] door de aangepaste naam van de verzendactie als Custom Submit Action .

creeer douane voorlegt dossier van de actieconfiguratie

note note
NOTE
Herinner de naam van de [ aangepaste voorlegging ], aangezien de zelfde naam in de `Submit action` drop-down lijst terwijl het ontwerpen van een vorm verschijnt.

Neem de nieuwe map op infilter.xml

Navigeer aan het /ui.apps/src/main/content/META-INF/vault/filter.xml dossier in uw [ AEMaaCS projectfolder ].

Open het bestand en voeg de volgende regel aan het einde toe:

code language-none
`<filter root="/apps/<app-id>/[customsubmitaction-folder]"/>`

Voeg bijvoorbeeld de volgende coderegel toe om de map customsubmitaction toe te voegen in het filter.xml -bestand:

code language-none
`<filter root="/apps/wknd/customsubmitaction"/>`

voeg de gecreeerde omslagen in filter.xml toe

Sla de wijzigingen op.

Voer de dienst voor de toegevoegde voorlegt actie uit.

Navigeer naar de volgende map in de [AEMaaCS project directory] :
/core/src/main/java/com/<app-id>/core/service/
Important: vervangen <app-id> met uw werkelijke toepassings-id.
Maak een nieuw Java-bestand om de service voor de toegevoegde verzendactie te implementeren. Voeg bijvoorbeeld het nieuwe Java-bestand toe als CustomSubmitService.java .

voor

Open dit bestand en voeg de code toe voor de aangepaste verzendactie-implementatie.

De onderstaande Java-code is bijvoorbeeld een OSGi-service die de formulierverzending afhandelt door de verzonden gegevens te registreren en een status OK te retourneren. Voeg de volgende code toe aan het CustomSubmitService.java -bestand:

code language-none

code language-none
package com.wknd.core.service; import com.adobe.aemds.guide.model.FormSubmitInfo; import com.adobe.aemds.guide.service.FormSubmitActionService; import java.util.HashMap; import java.util.Map; import org.osgi.service.component.annotations.Component; import org.slf4j.Logger; import org.slf4j.LoggerFactory; @Component( service = FormSubmitActionService.class, immediate = true ) public class CustomSubmitService implements FormSubmitActionService { private static final String serviceName = "Custom Submit Action"; private static Logger log = LoggerFactory.getLogger(CustomSubmitService.class); @Override public String getServiceName() { return serviceName; } @Override public Map<String, Object> submit(FormSubmitInfo formSubmitInfo) { String data = formSubmitInfo.getData(); log.info("Using custom submit action service, [data] --> " + data); Map<String, Object> result = new HashMap<>(); result.put("status", "OK"); return result; } }

package com.wknd.core.service;

import com.adobe.aemds.guide.model.FormSubmitInfo;
import com.adobe.aemds.guide.service.FormSubmitActionService;
import java.util.HashMap;
import java.util.Map;
import org.osgi.service.component.annotations.Component;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

    @Component(
    service = FormSubmitActionService.class,
    immediate = true
        )
    public class CustomSubmitService implements FormSubmitActionService {

    private static final String serviceName = "Custom Submit Action";

    private static Logger log = LoggerFactory.getLogger(CustomSubmitService.class);

    @Override
    public String getServiceName() {
    return serviceName;
    }

    @Override
    public Map<String, Object> submit(FormSubmitInfo formSubmitInfo) {
    String data = formSubmitInfo.getData();
    log.info("Using custom submit action service, [data] --> " + data);
    Map<String, Object> result = new HashMap<>();
    result.put("status", "OK");
    return result;
     }
    }

de Douane legt de Dienst van de Actie voor

Sla de wijzigingen op.

Implementeer de code.

stel code voor lokaal ontwikkelmilieu op

Implementeer de AEM as a Cloud Service [AEMaaCS project directory] in uw lokale ontwikkelomgeving om de nieuwe verzendactie op uw lokale computer uit te voeren. Distribueren naar uw lokale ontwikkelomgeving:

Zorg ervoor dat uw lokale ontwikkelomgeving actief is. Als u niet reeds opstelling een lokale ontwikkelomgeving hebt, verwijs naar de gids op Opstelling een lokale ontwikkelomgeving voor AEM Forms.
Open het eindvenster of de bevelherinnering.
Navigeer naar de map [AEMaaCS project directory] .

Voer de volgende opdracht uit:

code language-none
`mvn -PautoInstallPackage clean install`

Lokale Plaatsing

stel de code voor het milieu van de Cloud Service op

Implementeer de AEM as a Cloud Service, [AEMaaCS project directory] , in uw Cloud Service-omgeving. Implementeren in uw Cloud Service-omgeving:
1. Uw wijzigingen vastleggen:
  
  Nadat u de nieuwe aangepaste configuratie voor het verzenden van handelingen hebt toegevoegd, past u uw wijzigingen toe met een duidelijk Git-bericht. (Bijvoorbeeld "Nieuwe aangepaste verzendactie toegevoegd").
2. De bijgewerkte code implementeren:
  
  Trigger een plaatsing van uw code door de bestaande volledig-stapelpijpleiding. Het bouwt en stelt automatisch de bijgewerkte code met de nieuwe douane op om actiessteun voor te leggen.
  
  Als u niet reeds opstelling een pijpleiding hebt, verwijs naar de gids op hoe te opstelling een pijpleiding voor AEM Forms as a Cloud Service.
  
  hoe te om de installatie te bevestigen?
  
  Zodra het project is voltooid, wordt de aangepaste verzendactie weergegeven in de vervolgkeuzelijst Submit action tijdens het ontwerpen van een formulier.
Uw omgeving is nu gereed om de aangepaste verzendactie te gebruiken wanneer u een formulier ontwerpt.

Een voorbeeld bekijken van een adaptief formulier met de verzendactie die u zojuist hebt toegevoegd

Meld u aan bij uw AEM Forms as a Cloud Service-exemplaar.
Ga naar Forms > Forms en Documenten.
Selecteer een AanpassingsVorm en klik uitgeven. Het formulier wordt geopend in de bewerkingsmodus.

uit
Open de browser Inhoud en selecteer de component Guide Container van het adaptieve formulier.
Klik de eigenschappen van de Container van de Gids pictogram. Het dialoogvenster Aangepaste formuliercontainer wordt geopend.
Klik op de tab Submission .
Selecteer de verzendactie in de vervolgkeuzelijst Submit Action . Selecteer bijvoorbeeld de verzendactie als Custom Submit Action .

voor
Vul het formulier in en verzend het.

voor

Zodra de vorm met succes wordt voorgelegd, kunt u de Configuratie van de Console van het Web van Adobe Experience Manager controleren om de actie van douane te verifiëren voorlegt actie in het lokale ontwikkelmilieu.
Ga naar http://<host>:<port>/system/console/configMgr .
Navigeer aan de Steun van het Logboek van de Console van het Web van Adobe Experience Manager bij http://<host>:<port>/system/console/slinglog.
Klik op de optie logs/error.log .