Rule Editor voor Dynamic Forms in Universal Editor

• Voorwaarde → Actie (toen/toen)

  code language-text
  WHEN Gross Salary > 50000 THEN Show "Additional Deduction"

  Dit is het meest geschikt voor voorwaardelijke zichtbaarheid en progressieve openbaarmaking.

• handeling randvoorwaarde (reeks als/slechts als)

  code language-text
  SET Taxable Income = Gross Salary - Deductions IF Deductions are applicable

  Dit is het meest geschikt voor berekeningen en gegevenstransformaties.

• als → toen → anders (Afwisselende actie)

  code language-text
  IF Income > 50000 THEN Show "High Income" fields ELSE Show "Standard Income" fields

  Het beste voor vertakkende logica en wederzijds uitsluitende stromen.

• Voorwaarde: "Het bruto salaris overschrijdt $50.000"
• Primaire actie: toon "Extra Vermindering"
• Afwisselende actie: Verberg "Extra Vermindering"
• Resultaat: De gebruikers zien slechts de gebieden die op hen van toepassing zijn

Essentiële toestemmingen en opstelling:

• AEM as a Cloud Service: De auteurstoegang met vorm het uitgeven toestemmingen
• Universele Redacteur: Geïnstalleerd en gevormd op uw milieu
• de uitbreiding van de Redacteur van de Regel: Toegelaten via Extension Manager
• Vorm het uitgeven toestemmingen: Mogelijkheid om vormcomponenten in Universele Redacteur tot stand te brengen en te wijzigen

stappen van de Verificatie:

1. Bevestig dat u vanuit uw AEM Sites-console toegang hebt tot Universal Editor
2. Controleren of u formuliercomponenten kunt maken en bewerken
3. Controle dat het pictogram van de Redacteur van de Regel wanneer het selecteren van vormcomponenten verschijnt

Vereiste kennis en vaardigheden:

• Universele vaardigheid van de Redacteur: Ervaring creërend vormen met tekstinput, dropdowns, en basisgebiedseigenschappen
• Bedrijfs logisch begrip: Mogelijkheid om voorwaardelijke vereisten en bevestigingsregels voor uw specifiek gebruiksgeval te bepalen
• de componentenvertrouwdheid van de Vorm: Kennis van gebiedstypes (tekst, aantal, drop-down), eigenschappen (vereist, zichtbaar, read-only), en vormstructuur

Facultatief voor geavanceerd gebruik:

• fundamentals van JavaScript: Vereist slechts voor het creëren van douanefuncties (gegevenstypes, functies, basissyntaxis)
• JSON begrip: Nuttig voor complexe gegevensmanipulatie en API integratie

vragen van de Beoordeling:

• Kunt u een basisformulier maken met tekstinvoer en een verzendknop in de Universal Editor?
• Begrijp u wanneer de gebieden in uw bedrijfscontext vereist of facultatief zouden moeten zijn?
• Kunt u aangeven welke formulierelementen voorwaardelijk zichtbaar moeten zijn in uw geval van gebruik?

Belangrijk: De uitbreiding van de Redacteur van de Regel wordt niet toegelaten door gebrek in Universele milieu's van de Redacteur.

de stappen van de Activering:

1. Ga aan Extension Managerin uw milieu van AEM
2. Zoek de extensie "Regel-editor" in de lijst met beschikbare extensies
3. Klik toelaten en bevestig de activering
4. Wacht tot het systeem is vernieuwd (kan 1-2 minuten duren)

Verificatie:

• Na het toelaten, verschijnt het pictogram van de Redacteur van de Regel wanneer u een vormcomponent selecteert:

Figuur: Het pictogram van de Redacteur van de Regel verschijnt wanneer u vormcomponenten selecteert

U opent als volgt de regeleditor:

1. Selecteer een formuliercomponent in de Universal Editor.
2. Klik op het pictogram Regeleditor.
3. De redacteur van de Regel opent in een zijpaneel.

Figuur: De interface van de Redacteur van de regel voor het uitgeven componentenregels

Overzicht van de interface van Rule Editor

Figuur: Volledige interface van de Redacteur van de Regel met genummerde componenten

• de titel van de Component en regeltype: Bevestigt de geselecteerde component en het actieve regeltype.

• de Voorwerpen en het paneel van Functies van de Vorm:

  • Formulierobjecten: hiërarchische weergave van velden en containers voor verwijzing in regels
  • Functies: ingebouwde wiskunde, koord, datum, en bevestigingshelpers

• knevel van het Comité: Toon/verberg de voorwerpen en functies paneel om werkruimte te verhogen

• Visuele regelbouwer: belemmering-en-daling, dropdown-gedreven regelcomponist

• Controles: Gedaan (sparen), annuleer (verwerp). Regels altijd testen voordat ze worden opgeslagen.

Wanneer een component al regels heeft, kunt u:

• Mening: Zie regelsamenvattingen en logica
• geef uit: wijzig voorwaarden en acties
• opnieuw orde: De uitvoeringsorde van de verandering (van boven naar onder)
• toelaten/onbruikbaar maken: De regels van de knevel voor het testen
• Schrapping: Verwijder veilig regels

• wanneer: Primaire regel voor complex voorwaardelijk gedrag (Voorwaarde → Actie ± anders)
• Verbergen/tonen: De zichtbaarheid van controles die op een voorwaarde (progressieve mededeling wordt gebaseerd)
• toelaten/onbruikbaar maken: Controles of een gebied interactief is (bijvoorbeeld, maak Submit onbruikbaar tot de vereiste gebieden geldig zijn)

• Reeks Waarde van: Auto-bevolkt waarden (bijvoorbeeld, data, totalen, exemplaren)
• Duidelijke Waarde van: verwijder gegevens wanneer de voorwaarden veranderen
• Formaat: De vertoning die van de transformatie formatteert (munt, telefoon, datum) zonder opgeslagen waarden te veranderen

• Valideer: De bevestigingslogica van de douane, met inbegrip van dwars-gebiedscontroles en bedrijfsregels

• Wiskundige Uitdrukking: Verwerk waarden in echt - tijd (totalen, belasting, verhoudingen)

• Reeks Focus: Beweeg nadruk aan een specifiek gebied (gebruik spaarzaam)
• Vastgesteld Bezit: Wijzig componenteneigenschappen dynamisch (placeholder, opties, enz.)

• legt Vorm voor: Programmatiatically legt de vorm voor (slechts na bevestigingspas)
• Vorm van het Terugstellen: Duidelijk en teruggesteld aan aanvankelijke staat (bevestig vóór gebruik)
• sparen Vorm: sparen als ontwerp voor later (lange vormen, multi-sessie)

• roept Dienst aan: Externe APIs/de diensten van de vraag (handvat ladend en fouten)
• voeg/verwijder Instantie toe: beheer herhaalbare secties (bijvoorbeeld, gebiedsdelen, adressen)
• navigeer aan: Route aan andere vormen/pagina's (bewaart gegevens vóór navigatie)
• navigeer onder Panelen: De de opstapnavigatie van de tovenaar van de controle en het overslaan
• de Gebeurtenis van de Verzending: De gebeurtenissen van de de douanetrekker voor integratie of analyse

In dit voorbeeld ziet u voorwaardelijke zichtbaarheid en automatische berekeningen.

Afbeelding: Formulier voor belastingberekening met intelligente voorwaardelijke velden

U maakt een formulier dat:

1. Aanpassing aan gebruikersinvoer door relevante velden weer te geven
2. Hiermee worden waarden in real-time berekend
3. Valideert gegevens om de nauwkeurigheid te verbeteren

• Regel 1: Voorwaardelijke vertoning

  code language-text
  WHEN Gross Salary > 50,000 THEN Show "Additional Deduction" ELSE Hide "Additional Deduction"

• Regel 2: De belastbare berekening van het Inkomen

  code language-text
  SET Taxable Income = Gross Salary - Additional Deduction (Only when Additional Deduction applies)

• Regel 3: De belastbare berekening

  code language-text
  SET Tax Payable = Taxable Income × 10% (Simplified flat rate)

Doelstelling: Bouw de basisvorm met alle gebieden en aanvankelijke montages.

1. Open Universele Redacteur:

   • Navigeer aan de console van AEM Sites, selecteer uw pagina, klik uitgeven
   • Verzeker u de Universele Redacteurbehoorlijk gevormd hebt

2. voeg vormcomponenten in deze orde toe:

   • Titel (H2): "Formulier voor de berekening van belastingen"
   • Nummer input: "Bruto salaris" (Vereist: Ja, tijdelijke aanduiding: "Jaarloon invullen")
   • Nummer invoer: "Aanvullende aftrek" (Vereist: Nee, tijdelijke aanduiding: "Aanvullende aftrekkingen invoeren")
   • Invoernummer: "Belastbaar inkomen" (alleen-lezen: Ja)
   • Nummerinvoer: "Belastingplichtig" (alleen-lezen: Ja)
   • Verzenden, knop: BTW berekenen

3. vorm aanvankelijke gebiedseigenschappen:

   • "Extra aftrek" verbergen (instellen op Zichtbaar: Nee in deelvenster Eigenschappen)
   • Stel "Belastbaar inkomen" en "Belastbaar inkomen" in op alleen-lezen: Ja

Afbeelding: Oorspronkelijke formulierstructuur met basiscomponenten geconfigureerd

Controlepunt: U zou een vorm met alle vereiste gebieden moeten hebben waar de "Extra Vermindering"verborgen is en de berekende gebieden read-only zijn.

Doel: toon "Extra Vermindering"gebied slechts wanneer het Bruto Salaris $50.000 overschrijdt.

1. selecteer het Bruto gebied van het Salaris en klik het pictogram van de Redacteur van de Regel

2. creeer een nieuwe regel:

   • Klik creëren
   • Wijzig het regeltype van "Waarde instellen van" in "Wanneer"

3. vorm de voorwaarde:

   • Selecteer "is groter dan" van dropdown
   • Voer 50000 in het nummerveld in

4. plaats toen actie:

   • Kies "tonen" van de Uitgezochte drop-down Actie
   • Sleep of selecteer "Extra Vermindering" gebied van de Voorwerpen van de Vorm

5. voeg de Else actie toe:

   • Klik "voeg anders Sectie toe"
   • Kies "Verbergen" van de Uitgezochte drop-down Actie
   • Selecteer "Extra Vermindering" gebied

6. sparen de regel: Klik Gedaan

Doel: berekent automatisch "Belastbaar Inkomen"en "Belastbaar die"op gebruikersinput wordt verschuldigd.

vorm de Belastbare berekening van het Inkomen:

1. Uitgezochte "Belastbaar Inkomen"gebied en open de Redacteur van de Regel

2. creeer Wiskundige Uitdrukking:

   • Klik creëren → Uitgezochte "Wiskundige uitdrukking"
   • De uitdrukking van de bouw: Bruto Salaris - de Extra Vermindering
   • Sleep "Bruin salaris" naar het eerste veld
   • Selecteer "Min" exploitant
   • Sleep "Aanvullende aftrek" naar tweede veld

3. sparen: Klik Gedaan

vorm de Belastingverschuldigde berekening:

1. Uitgezochte "Belasting Betaalbaar"gebied en open de Redacteur van de Regel

2. creeer Wiskundige Uitdrukking:

   • Klik creëren → Uitgezochte "Wiskundige uitdrukking"
   • Bouw uitdrukking: Belastbaar Inkomen × 10:100
   • Sleep "Belastbaar inkomen" naar het eerste veld
   • Selecteer "Multiplied door" exploitant
   • Voer 10 in als getal
   • Klik "Uitbreiden Uitdrukking"
   • Selecteer "verdeeld door" exploitant
   • Voer 100 in als getal

3. sparen: Klik Gedaan

verifieer uw implementatie door de volledige stroom te testen:

1. Voorproef de vorm: Klik de voorproefwijze in Universele Redacteur

2. Test de voorwaardelijke logica:

   • Voer Brutosalaris in = 30000 → "Aanvullende aftrek" moet verborgen blijven
   • Voer het brutosalaris in = 60000 → "Aanvullende aftrek" moet worden weergegeven

3. berekeningen van de Test:

   • Voer bij Brutosalaris = 60000 de optie Aanvullende aftrek = 5000 in
   • Belastbaar inkomen verifiëren = 55000 (60000 - 5000)
   • Betaalbare belasting verifiëren = 5500 (55000 × 10%)

Afbeelding: Voltooide belastingcalculator met voorwaardelijke velden en automatische berekeningen

criteria van het Succes: De vorm zou velden dynamisch tonen/verbergen en waarden in real time moeten berekenen aangezien de gebruikers typen.

Ideale scenario's voor douanefuncties:

• Complexe berekeningen: De multi-step berekeningen worden niet gemakkelijk uitgedrukt in de Wiskundige regel van de Uitdrukking
• zaken-specifieke bevestigingen: De logica van de bevestiging van de douane specifiek voor uw organisatie of industrie
• de transformaties van Gegevens: De omzettingen van het formaat, koordmanipulaties, of gegevens het ontleden
• Externe integraties: Vraag aan interne APIs of derdediensten (met beperkingen)

Voordelen van douanefuncties:

• Herbruikbaarheid: Schrijf eens, gebruik over veelvoudige vormen en regels
• handhaafbaarheid: Gecentraliseerde logica die gemakkelijker is bij te werken en te zuiveren
• Prestaties: De geoptimaliseerde uitvoering van JavaScript in vergelijking met complexe regelketens
• Flexibiliteit: De randgevallen van de handvat en complexe scenario's die niet door standaardregels worden gericht

plaats van het Dossier: Alle douanefuncties moeten in /blocks/form/functions.js in uw project van Edge Delivery Services worden bepaald.

werkschema van de Ontwikkeling:

1. het ontwerp van de Functie

   • Beschrijvende, actiegerichte functienamen gebruiken
   • Definieer duidelijke parametertypen en retourwaarden
   • Afbeeldingen met randen en ongeldige invoer netjes verwerken

2. Implementatie

   • Schrijf schone JavaScript met goede opmerkingen
   • Inclusief invoervalidatie en foutafhandeling
   • Testfuncties onafhankelijk van elkaar vóór integratie

3. Documentatie

   • Uitgebreide JSDoc-opmerkingen toevoegen
   • Gebruiksvoorbeelden en parameterbeschrijvingen opnemen
   • Alle beperkingen of afhankelijkheden documenteren

4. Plaatsing

   • Exportfuncties met benoemde exportfuncties
   • Distribueren naar de gegevensopslagruimte van uw project
   • Voltooien van build controleren vóór testen

implementatie van het Voorbeeld:

/**
 * Concatenates first and last name with proper formatting
 * @name getFullName
 * @description Combines first and last name, handles edge cases like missing values
 * @param {string} firstName - The person's first name
 * @param {string} lastName - The person's last name
 * @returns {string} Formatted full name or empty string if both inputs are invalid
 */
function getFullName(firstName, lastName) {
  // Handle null, undefined, or empty string inputs
  const first = (firstName || '').toString().trim();
  const last = (lastName || '').toString().trim();

  return `${first} ${last}`.trim();
}

/**
 * Calculates the number of days between two dates
 * @name days
 * @description Computes absolute difference in days, handles various date input formats
 * @param {Date|string} endDate - End date (Date object or ISO string)
 * @param {Date|string} startDate - Start date (Date object or ISO string)
 * @returns {number} Number of days between dates, 0 if inputs are invalid
 */
function days(endDate, startDate) {
  // Convert string inputs to Date objects
  const start = typeof startDate === 'string' ? new Date(startDate) : startDate;
  const end = typeof endDate === 'string' ? new Date(endDate) : endDate;

  // Validate date objects
  if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
    return 0;
  }

  // Calculate absolute difference in milliseconds, then convert to days
  const diffInMs = Math.abs(end.getTime() - start.getTime());
  return Math.floor(diffInMs / (1000 * 60 * 60 * 24));
}

// Export functions for use in Rule Editor
export { getFullName, days };

Afbeelding: aangepaste functies toevoegen aan het bestand functions.js

stappen van de Integratie:

1. voeg functie aan project toe

   • /blocks/form/functions.js maken of bewerken in uw project
   • De functie opnemen in de instructie export

2. opstellen en bouwt

   • Wijzigingen vastleggen in uw opslagplaats
   • Ervoor zorgen dat het constructieproces met succes is voltooid
   • Tijd toestaan voor CDN-cache-updates

3. Toegang in de Redacteur van de Regel

   • Regeleditor openen voor formuliercomponenten
   • Selecteer "Uitvoer van de Functie" in Uitgezochte actie dropdown
   • Kies uw aangepaste functie in de lijst met beschikbare functies
   • Functieparameters configureren met formuliervelden of statische waarden

4. Test grondig

   • Geef een voorbeeld van het formulier weer om het gedrag van de functie te controleren
   • Testen met verschillende invoercombinaties, inclusief randbehuizingen
   • De invloed van prestaties op het laden van formulieren en interactie controleren

Figuur: Het selecteren en het vormen van douanefuncties in de interface van de Redacteur van de Regel

Beste praktijken voor functiegebruik:

• de behandeling van de Fout: Neem altijd fallback gedrag voor functiestoornissen op
• Prestaties: De functies van het profiel met realistische gegevensvolumes
• Veiligheid: Valideer alle input om veiligheidskwetsbaarheid te verhinderen
• het Testen: Creeer testgevallen die normale en randgevallen behandelen

• Minimaliseer regelcomplexiteit; verdeel grote logica in kleine, gerichte regels
• Regels sorteren op frequentie (meest gangbare eerst)
• Regelsets per component handelbaar houden
• Voorkeur voor herbruikbare aangepaste functies in plaats van logica dupliceren

• Duidelijke validatie en inlinefeedback bieden
• Vermijd schokkerige visuele wijzigingen; gebruik tonen/verbergen met het oog
• Testen op apparaten en lay-outs

• Testen met randbehuizingen en bekende waarden
• Verifiëren in verschillende browsers
• Documentintentie achter complexe regels, niet alleen mechanica
• Regelinventarisatie bijhouden voor grote formulieren
• Gebruik consistente naamgeving voor componenten en regels
• Aangepaste versiefuncties en test in niet-productieomgevingen

• Componentnamen en -verwijzingen verifiëren
• Uitvoervolgorde controleren (van boven naar beneden)
• Voorwaarden met bekende waarden valideren
• Browserconsole controleren op blokkeringsfouten

• Operatoren en groepering controleren (AND/OR)
• Expressiefragmenten afzonderlijk testen
• Gegevenstypen bevestigen (getallen versus tekenreeksen)

• Vereenvoudig diep geneste voorwaarden
• Aangepaste functies profiel
• Minimaliseer externe vraag binnen regels
• Specifieke kiezers en verwijzingen gebruiken

• Bestandspad bevestigen: /blocks/form/functions.js
• Ervoor zorgen dat benoemde exportbewerkingen correct zijn
• Bevestig de build met uw wijzigingen
• Browser cache wissen na implementatie
• Parametertypen en foutafhandeling valideren

• Bevestig de uitbreiding van de Redacteur van de Regel wordt toegelaten
• Selecteer een ondersteunde component
• Een ondersteunde browser gebruiken (Chrome, Firefox, Safari)
• Controleer of u de vereiste machtigingen hebt

Belangrijke beperkingen

Samenvatting

De Redacteur van de Regel in Universele Redacteur zet statische vormen in intelligente, ontvankelijke ervaringen om die aan gebruikersinput in real time aanpassen. Door gebruik te maken van voorwaardelijke logica, geautomatiseerde berekeningen en aangepaste bedrijfsregels, kunt u geavanceerde formulierworkflows maken zonder toepassingscode te schrijven.

Zeer belangrijke mogelijkheden u hebt geleerd:

• Voorwaardelijke logica: toon en verberg gebieden die op gebruikersinput worden gebaseerd om geconcentreerde, relevante ervaringen tot stand te brengen
• Dynamische berekeningen: berekent automatisch waarden (belastingen, totalen, tarieven) aangezien de gebruikers met de vorm in wisselwerking staan
• bevestiging van Gegevens: Voer bevestiging in real time met duidelijke, actionable uit terugkoppelt berichten
• de functies van de Douane: Breid mogelijkheden met JavaScript voor complexe bedrijfslogica en integratie uit
• optimalisering van Prestaties: Pas beste praktijken voor handhaafbare, efficiënte regelontwikkeling toe

Geleverde Waarde:

• Verbeterde gebruikerservaring: Verminder cognitieve lading met progressieve onthulling en intelligente vormstromen
• Verminderde fouten: Vermijd ongeldige voorlegging door bevestiging in real time en geleide input
• Verbeterde efficiency: Automatiseer berekeningen en gegevensingang om gebruikersinspanning te minimaliseren
• Handelbare oplossingen: Creeer herbruikbare, goed gedocumenteerde regels die over uw organisatie schrapen

Bedrijfs effect:

Forms wordt een krachtig hulpmiddel voor gegevensverzameling, kwalificatie van leads en betrokkenheid van gebruikers. De redacteur van de Regel laat niet-technische auteurs toe om verfijnde bedrijfslogica uit te voeren, die ontwikkelingskosten vermindert terwijl het verbeteren van vormvoltooiingstarieven en gegevenskwaliteit.