Zelfstudie: regels toepassen op aangepaste formuliervelden

Laatst bijgewerkt: 14 juli 2024

Van toepassing op:
Experience Manager 6.5

Onderwerpen:
Adaptieve formulieren

Gemaakt voor:

Beheerder
Gebruiker
Ontwikkelaar

06-apply-rules-to-adaptive-form_main

Dit leerprogramma is een stap in creeert Uw Eerste AanpassingsVormreeksen. De Adobe raadt aan de reeks in chronologische volgorde te volgen om de volledige Gebruikssituatie van de zelfstudie te begrijpen, uit te voeren en te demonstreren.

Over de zelfstudie

Met regels kunt u interactiviteit, bedrijfslogica en slimme validaties toevoegen aan een adaptief formulier. Adaptieve formulieren hebben een ingebouwde regeleditor. De regelredacteur verstrekt belemmering-en-dalingsfunctionaliteit, gelijkend op geleide reizen. De methode slepen en neerzetten is de snelste en eenvoudigste methode om regels te maken. De regelredacteur verstrekt ook een codevenster voor gebruikers geinteresseerd in het testen van hun coderingsvaardigheden of het nemen van de regels aan het volgende niveau.

U kunt meer over de regelredacteur bij Aangepaste de regelredacteur van Formsleren.

Aan het einde van de zelfstudie leert u regels maken voor:

Een service van het formuliergegevensmodel aanroepen om gegevens uit de database op te halen
Een service van het formuliergegevensmodel aanroepen om gegevens aan de database toe te voegen
Een validatiecontrole uitvoeren en foutberichten weergeven

Met interactieve afbeeldingen van GIFFEN aan het einde van elke sectie van de zelfstudie leert u de functionaliteit van het formulier dat u maakt en controleert u deze.

Stap 1: Haal een klantenverslag van het gegevensbestand terug

U creeerde een model van vormgegevens door te volgen creeert modelgegevensmodelartikel. Nu, kunt u de regelredacteur gebruiken om de diensten van het Gegevensmodel van Forms aan te halen en informatie aan het gegevensbestand toe te voegen.

Elke klant krijgt een uniek klant-id-nummer toegewezen, waarmee relevante klantgegevens in een database kunnen worden geïdentificeerd. In de onderstaande procedure wordt de klant-id gebruikt om gegevens op te halen uit de database:

Open het aangepaste formulier voor bewerking.

http://localhost:4502/editor.html/content/forms/af/change-billing-shipping-address.html
Selecteer het veld Customer ID en selecteer het pictogram Edit Rules . Het venster van de Redacteur van de Regel opent.
Selecteer het pictogram + Create om een regel toe te voegen. Het opent de Visuele Redacteur.

In de Visuele Editor wordt de instructie WHEN standaard geselecteerd. Bovendien wordt het formulierobject (in dit geval Customer ID ) waaruit u de regeleditor hebt gestart, opgegeven in de instructie WHEN .
Selecteer de vervolgkeuzelijst Select State en selecteer is changed .
Selecteer Invoke Service in de vervolgkeuzelijst Select Action in de instructie THEN .
Selecteer de service Retrieve Shipping Address in de vervolgkeuzelijst Select .
Sleep het veld Customer ID van het tabblad Formulierobjecten naar het veld Drop object or select here in het vak INPUT .
Sleep het veld Customer ID, Name, Shipping Address, State, and Zip Code van het tabblad Formulierobjecten naar het veld Drop object or select here in het vak OUTPUT .

Selecteer Done om de regel op te slaan. Selecteer Close in het regeleditorvenster.
Geef een voorvertoning weer van het adaptieve formulier. Voer een id in het veld Customer ID in. Het formulier kan nu klantgegevens uit de database ophalen.

Stap 2: Voeg het bijgewerkte klantenadres aan het gegevensbestand toe

Nadat de klantgegevens uit de database zijn opgehaald, kunt u het verzendadres, de provincie en de postcode bijwerken. Met de onderstaande procedure wordt een service Formuliergegevensmodel aangeroepen om klantgegevens bij te werken naar de database:

Selecteer het veld Submit en selecteer het pictogram Edit Rules . Het venster van de Redacteur van de Regel opent.
Selecteer de regel Submit - Click en selecteer het pictogram Edit . De opties voor het bewerken van de regel Verzenden worden weergegeven.

In de optie WHEN zijn de opties Submit en is clicked al geselecteerd.
Selecteer de optie + Add Statement in de optie THEN . Selecteer Invoke Service in de vervolgkeuzelijst Select Action .
Selecteer de service Update Shipping Address in de vervolgkeuzelijst Select .
Sleep het veld Shipping Address, State, and Zip Code van de tab Form Objects naar de overeenkomstige eigenschap tableName.property (bijvoorbeeld customerdetails.ShippingAddress) van het veld Drop object or select here in het vak INPUT . Alle velden met een tabelnaam (bijvoorbeeld details van de klant in dit geval) fungeren als invoergegevens voor de updateservice. Alle inhoud die in deze velden wordt geleverd, wordt bijgewerkt in de gegevensbron.

NOTE
Sleep de velden Name en Customer ID niet naar de bijbehorende eigenschap tabName.property (bijvoorbeeld customerdetails.name). Zo voorkomt u per ongeluk dat de naam en id van de klant worden bijgewerkt.
Sleep het veld Customer ID van de tab Form Objects naar het veld ID in het vak INPUT . Velden zonder een vooraf ingestelde tabelnaam (bijvoorbeeld klantgegevens in dit geval) fungeren als zoekparameter voor de updateservice. Het id gebied in dit gebruiksgeval identificeert uniek een verslag in de klantDetails lijst.
Selecteer Done om de regel op te slaan. Selecteer Close in het regeleditorvenster.
Geef een voorvertoning weer van het adaptieve formulier. Haal de gegevens van een klant op, werk het verzendadres bij en verzend het formulier. Wanneer u de details van dezelfde klant opnieuw ophaalt, wordt het bijgewerkte verzendadres weergegeven.

Stap 3: (sectie Bonus) Gebruik de code-editor om validaties uit te voeren en foutberichten weer te geven

Voer de validatie op het formulier uit om te controleren of de gegevens in het formulier correct zijn en of er een foutbericht wordt weergegeven als er onjuiste gegevens zijn. Als bijvoorbeeld een niet-bestaande klant-id in het formulier wordt ingevoerd, moet een foutbericht worden weergegeven.

Aangepaste formulieren bieden verschillende componenten ingebouwde validaties, zoals e-mail en numerieke velden die u kunt gebruiken voor veelvoorkomende gebruiksgevallen. Gebruik de regeleditor voor geavanceerde gebruiksgevallen bijvoorbeeld om een foutbericht weer te geven wanneer de database nul (0) records (geen records) retourneert.

De volgende procedure laat zien hoe u een regel maakt om een foutbericht weer te geven als de klant-id die u in het formulier hebt ingevoerd, niet bestaat in de database. Met de regel wordt ook de focus naar het veld Customer ID gebracht en opnieuw ingesteld. De regel gebruikt dataIntegrationUtils API van de modeldienst van vormgegevensom te controleren of identiteitskaart van de Klant in het gegevensbestand bestaat.

Selecteer het veld Customer ID en selecteer het pictogram Edit Rules . Het venster Rule Editor wordt geopend.
Selecteer het pictogram + Create om een regel toe te voegen. Het opent de Visuele Redacteur.

In de Visuele Editor wordt de instructie WHEN standaard geselecteerd. Bovendien wordt het formulierobject (in dit geval Customer ID ) waaruit u de regeleditor hebt gestart, opgegeven in de instructie WHEN .
Selecteer de vervolgkeuzelijst Select State en selecteer is changed .

Selecteer Invoke Service in de vervolgkeuzelijst Select Action in de instructie THEN .
Schakel van Visual Editor naar Code Editor . De schakelaarcontrole is op de rechterkant van het venster. De Redacteur van de Code opent, tonend code gelijkend op het volgende:
Vervang de sectie met invoervariabelen door de volgende code:
var inputs = { "id" : this };

Vervang de sectie guidelib.dataIntegrationUtils.executeOperation (operationInfo, inputs, outputs) door de volgende code:

guidelib.dataIntegrationUtils.executeOperation(operationInfo, inputs, outputs, function (result) {
  if (result) {
      result = JSON.parse(result);
    customer_Name.value = result.name;
    customer_Shipping_Address = result.shippingAddress;
  } else {
    if(window.confirm("Invalid Customer ID. Provide a valid customer ID")) {
          customer_Name.value = " ";
         guideBridge.setFocus(customer_ID);
    }
  }
});

Geef een voorvertoning weer van het adaptieve formulier. Voer een onjuiste klant-id in. Er verschijnt een foutbericht.

recommendation-more-help