DokumentationAEM as a Cloud ServiceAnvändarhandbok

Konfigurera ett anpassat formulär för REST-slutpunktsåtgärd

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Användare
  • Utvecklare

Använd åtgärden Submit to REST Endpoint för att skicka skickade data till en REST-URL. URL:en kan vara en intern (servern som formuläret återges på) eller en extern server.

AEM as a Cloud Service erbjuder olika inskickningsåtgärder för att hantera inskickade formulär. Du kan läsa mer om de här alternativen i artikeln Åtgärd för att skicka anpassade formulär.

Fördelar

Några av fördelarna med att konfigurera Submit to REST endpoint-sändningsåtgärden för Adaptiv Forms är:

  • Det möjliggör smidig integrering av formulärdata med externa system och tjänster via RESTful API:er.
  • Det ger flexibilitet vid hantering av data som skickas från Adaptive Forms, vilket ger stöd för dynamiska och komplexa datastrukturer.
  • Det har stöd för dynamisk mappning av formulärfält till parametrar i REST-slutpunkts-URL, vilket möjliggör anpassningsbara och anpassningsbara dataöverföringar.

Konfigurera åtgärden Skicka till REST-slutpunkt steps-to-configure-submit-to-restendpoint-submit-action

Så här konfigurerar du åtgärden skicka:

  1. Öppna innehållsläsaren och markera komponenten Guide Container i det adaptiva formuläret.

  2. Klicka på ikonen för egenskaper för stödlinjebehållaren Egenskaper för stödlinje . Dialogrutan Adaptiv formulärbehållare öppnas.

  3. Klicka på fliken Submission.

  4. I listrutan Submit Action väljer du Submit to Rest endpoint.
    Åtgärdskonfiguration för slutpunkten Skicka till vila

    Om du vill skicka data till en intern server anger du sökvägen till resursen. Data bokförs som resurssökväg. Exempel: /content/restEndPoint. För sådana efterfrågningar används autentiseringsinformationen i förfrågan.

    Ange en URL om du vill skicka data till en extern server. URL-formatet är https://host:port/path_to_rest_end_point. Se till att du konfigurerar sökvägen så att den hanterar POSTENS begäran anonymt.

    Mappning för fältvärden skickas som parametrar för Tack-sidan

    I exemplet ovan hämtas användarinformationen i textbox med parametern param1. Syntaxen för att bokföra data som har hämtats med param1 är:

    String data=request.getParameter("param1");

    På samma sätt är parametrar som du använder för att skicka XML-data och bifogade filer dataXml och attachments.

    Du kan till exempel använda de här två parametrarna i skriptet för att tolka data till en slutpunkt. Du använder följande syntax för att lagra och analysera data:

    String data=request.getParameter("dataXml");
    String att=request.getParameter("attachments");

    I det här exemplet lagrar data XML-data och att lagrar data för bifogade filer.

    Åtgärden Submit to REST endpoint Skicka skickar data som är ifyllda i formuläret till en konfigurerad bekräftelsesida som en del av HTTP GET-begäran. Du kan lägga till namnet på fältet som ska begäras. Begäran har följande format:

    {fieldName}={request parameter name}

    Som visas i bilden nedan skickas param1 och param2 som parametrar med värden som kopierats från fälten texbox och numerbox för nästa åtgärd.

    Konfigurerar åtgärden Skicka för resterande slutpunkt

    Du kan också Enable POST request och ange en URL för att skicka begäran. Om du vill skicka data till den AEM servern som är värd för formuläret använder du en relativ sökväg som motsvarar rotsökvägen för AEM. Exempel: /content/forms/af/SampleForm.html. Om du vill skicka data till en annan server använder du den absoluta sökvägen.

  5. Klicka på Done.

Bästa praxis

  • När du skickar data till en extern server måste du se till att URL:en är säker och konfigurera sökvägen så att den hanterar POSTENS förfrågan anonymt för att skydda känslig information.
  • Om du vill skicka fälten som parametrar i en REST-URL måste alla fält ha olika elementnamn, även om fälten placeras på olika paneler.

Relaterade artiklar

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab