Formuliergegevensmodel gebruiken use-form-data-model

Versie
Artikelkoppeling
AEM 6,5
Klik hier
AEM as a Cloud Service
Dit artikel

gegevensintegratie

Experience Manager Forms Met gegevensintegratie kunt u verschillende bronnen van backendgegevens gebruiken om een formuliergegevensmodel te maken dat u als schema kunt gebruiken in verschillende adaptieve Forms workflows. Het vereist het vormen van gegevensbronnen en het creëren van het Model van de Gegevens van de Vorm dat op de voorwerpen en de diensten van het gegevensmodel beschikbaar in gegevensbronnen wordt gebaseerd. Raadpleeg de volgende secties voor meer informatie:

Een formuliergegevensmodel is een uitbreiding van het JSON-schema waarmee u:

Adaptieve Forms en fragmenten maken create-af

U kunt Adaptieve Forms en Adaptieve formulierfragmenten op basis van een formuliergegevensmodel. Ga als volgt te werk om een formuliergegevensmodel te gebruiken bij het maken van een adaptief formulier of een adaptief formulierfragment:

  1. Selecteer op het tabblad Formuliermodel in het scherm Eigenschappen toevoegen de optie Form Data Model in de Select From vervolgkeuzelijst.

    create-af-1-1

  2. Selecteren om uit te breiden Select Form Data Model. Alle beschikbare formuliergegevensmodellen worden weergegeven.

    Selecteer een gegevensmodel.

    create-af-2-1

  3. (Alleen adaptieve formulierfragmenten) U kunt een adaptief formulierfragment maken op basis van slechts één gegevensmodelobject in een formuliergegevensmodel. Uitbreiden Form Data Model Definitions vervolgkeuzelijst. Hiermee worden alle gegevensmodelobjecten in het opgegeven formuliergegevensmodel weergegeven. Selecteer een gegevensmodelobject in de lijst.

    create-af-3

    Nadat het adaptieve formulier- of adaptief formulierfragment op basis van een formuliergegevensmodel is gemaakt, worden formuliergegevensmodelobjecten weergegeven in het dialoogvenster Data Sources van de inhoudbrowser in de Adaptieve formuliereditor.

    note note
    NOTE
    Bij een adaptief formulierfragment worden alleen het gegevensmodelobject dat is geselecteerd op het moment van ontwerpen en de bijbehorende gegevensmodelobjecten weergegeven op het tabblad Gegevensbronnen.

    data-model-objects-tab

    U kunt gegevensmodelobjecten naar het adaptieve formulier of fragment slepen om formuliervelden toe te voegen. De toegevoegde formuliervelden behouden de eigenschappen van de metagegevens en de binding met de eigenschappen van gegevensmodelobjecten. De binding zorgt ervoor dat de veldwaarden bij het verzenden van het formulier worden bijgewerkt in de bijbehorende gegevensbronnen en dat deze worden voorgevuld wanneer het formulier wordt gegenereerd.

Voorvertonen met voorbeeldgegevens preview-ic

Met de formuliergegevensmodeleditor kunt u voorbeeldgegevens voor gegevensmodelobjecten genereren en bewerken in het formuliergegevensmodel. U kunt deze gegevens gebruiken om een voorvertoning weer te geven en te testen Adaptieve Forms. U moet de voorbeeldgegevens genereren voordat u een voorvertoning weergeeft zoals beschreven in Werken met formuliergegevensmodel.

Als u een voorbeeld van een adaptief formulier wilt bekijken met voorbeeldgegevens, opent u het adaptieve formulier in de modus Ontwerpen en selecteert u Preview.

Vooraf invullen met service Formuliergegevensmodel prefill

Experience Manager Forms biedt de vooraf ingevulde service voor het out-of-the-box formuliergegevensmodel die u kunt inschakelen voor Adaptive Forms op basis van het formuliergegevensmodel. De prefill dienst vraagt gegevensbronnen voor gegevensmodelvoorwerpen in de Aangepaste Vorm en voegt daarom gegevens vooraf in tijdens het genereren van het formulier of de communicatie.

Open de eigenschappen van de container van de Adaptief formulier en selecteer Form Data Model Prefill service van de Prefill Service in de Basis accordeon. Sla vervolgens de eigenschappen op.

Prefill-service

Verzonden adaptieve formuliergegevens naar gegevensbronnen schrijven write-af

Wanneer een gebruiker een formulier verzendt dat is gebaseerd op een formuliergegevensmodel, kunt u het formulier zo configureren dat de verzonden gegevens voor een gegevensmodelobject naar de bijbehorende gegevensbronnen worden geschreven. Om dit te bereiken, Experience Manager Forms verstrekken Formuliergegevensmodel Handeling verzenden, alleen beschikbaar buiten de verpakking voor Adaptive Forms op basis van een formuliergegevensmodel. Het schrijft voorgelegde gegevens voor een voorwerp van het gegevensmodel in zijn gegevensbron.

De handeling Verzenden van het formuliergegevensmodel configureren:

  1. Open de Inhoudsbrowser en selecteer de Guide Container van uw adaptieve formulier.

  2. Klik op de eigenschappen van de container van de hulplijn Eigenschappen van hulplijnen pictogram. Het dialoogvenster Aangepaste formuliercontainer wordt geopend.

  3. Klik op de knop Submission tab.

  4. Selecteer in de vervolgkeuzelijst Submit Action de optie Submit using Form Data Model.

    Actieconfiguratie

  5. Geef de Data model to submit.

  6. Klikken Done

Bij het verzenden van formulieren worden gegevens voor het geconfigureerde gegevensmodelobject naar de desbetreffende gegevensbron geschreven. Daarnaast kunt u een formulierbijlage verzenden met behulp van een formuliergegevensmodel en een Document of Record (DoR) naar de gegevensbron. Zie voor informatie over het formuliergegevensmodel AEM Forms Gegevensintegratie.

NOTE
AEM as a Cloud Service biedt verschillende mogelijkheden in het vak om acties in te dienen voor de verwerking van formulierverzendingen. Meer informatie over deze opties vindt u in het gedeelte Handeling Adaptief verzenden van formulier artikel.

U kunt ook formulierbijlagen verzenden naar een gegevensbron met binaire objecteigenschappen van gegevensmodellen. Ga als volgt te werk om bijlagen naar een JDBC-gegevensbron te verzenden:

  1. Voeg een gegevensmodelobject dat een binaire eigenschap bevat toe aan het formuliergegevensmodel.

  2. Sleep de knop File Attachment van de browser Components naar het adaptieve formulier.

  3. Selecteer de toegevoegde component en selecteer settings_icon om de browser van Eigenschappen voor de component te openen.

  4. Selecteer in het veld Bindverwijzing de optie mapSearch_18 en navigeer om de binaire eigenschap te selecteren die u in het formuliergegevensmodel hebt toegevoegd. Configureer desgewenst andere eigenschappen.

    Selecteren knop controleren om de eigenschappen op te slaan. Het bijslagveld is nu gebonden aan de binaire eigenschap van het formuliergegevensmodel.

  5. Schakel in het gedeelte Verzending van de eigenschappen van de container van adaptieve formulieren de optie Submit Form Attachments. De bijlage in het binaire-eigenschapveld wordt naar de gegevensbron verzonden bij het verzenden van het formulier.

Services aanroepen in Adaptive Forms met behulp van regels invoke-services

In een adaptief formulier op basis van een formuliergegevensmodel kunt u regels maken om de diensten aan te halen die in het model van vormgegevens worden gevormd. De Invoke Services bewerking in een regel bevat een lijst met alle beschikbare services in het formuliergegevensmodel en u kunt invoer- en uitvoervelden voor de service selecteren. U kunt ook de opdracht Set Value regeltype om de service Form Data Model aan te roepen en de waarde van een veld in te stellen op de uitvoer die door de service wordt geretourneerd.

Bijvoorbeeld, haalt de volgende regel de dienst aan die Werknemeridentiteitskaart als input neemt en de teruggekeerde waarden in overeenkomstige Afhankelijke identiteitskaart, Familienaam, Voornaam, en Gendergebieden in de vorm worden bevolkt.

oproepdienst

Daarnaast kunt u de opdracht guidelib.dataIntegrationUtils.executeOperation API om een JavaScript in de coderedacteur voor de regelredacteur te schrijven.

Een formuliergegevensmodel aanroepen met behulp van aangepaste functies invoke-form-data-model-using-custom-functions

U kunt een formuliergegevensmodel aanroepen vanuit een regeleditor met behulp van aangepaste functies. Als u het gegevensmodel van het formulier wilt aanroepen, voegt u een formuliergegevensmodel toe aan de lijst van gewenste personen. Een formuliergegevensmodel toevoegen aan een toegestane lijst:

  1. Ga naar Experience Manager webconsole op https://server:host/system/console/configMgr.
  2. Zoeken Adaptive Form-Level Whitelisting of Form Data Model for Service Invocation - Configuration Factory.
  3. Klikken pluspictogram pictogram om de configuratie toe te voegen.
  4. Toevoegen Content path pattern om de locatie van uw Adaptieve Forms op te geven. De standaardwaarde is /content/forms/af/(.*) die alle adaptieve Forms omvat. U kunt ook het pad opgeven voor een specifiek adaptief formulier.
  5. Toevoegen Form Data Model path pattern om de locatie van het formuliergegevensmodel op te geven. De standaardwaarde is /content/dams/formsanddocuments-fdm/(.*) Dit omvat het gegevensmodel van het formulier. U kunt ook het pad opgeven voor een specifiek formuliergegevensmodel.
  6. Sla de instellingen op.

De toegevoegde configuratie wordt opgeslagen onder de Adaptive Form-Level Whitelisting of Form Data Model for Service Invocation - Configuration Factory -optie.

NOTE
Om een model van vormgegevens van de regelredacteur aan te halen gebruikend douanefuncties door een AEM archetype project:
  1. Een configuratiebestand maken.
  2. Stel eigenschappen van getContentPathPattern en getFormDataModelPathPattern in.
  3. Implementeer het project.

Verwante artikelen

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