Het standaard metamodel uitbreiden extend-the-default-meta-model

Met de service automatede form conversion kunt u formulierobjecten herkennen en uitnemen van bronformulieren. Met Semantic-mapper kan de service bepalen hoe de geëxtraheerde objecten in een adaptieve vorm worden weergegeven. Een bronformulier kan bijvoorbeeld vele verschillende soorten representaties van een datum hebben. Met de semantische mapfunctie kunt u alle weergaven van datumformulierobjecten van het bronformulier toewijzen aan datumcomponent van de adaptieve formulieren. Met Semantic mapper kan de service ook validaties, regels, gegevenspatronen, Help-tekst en toegankelijkheidseigenschappen vooraf configureren en toepassen op adaptieve formuliercomponenten tijdens conversie.

Meta-model is een JSON-schema. Voordat u begint met meta-model, moet u controleren of u goed bent omgedraaid met JSON. U moet ervaring hebben met het maken, bewerken en lezen van gegevens die zijn opgeslagen in de JSON-indeling.

Standaardmetamodel default-meta-model

De dienst van de automatede form conversion heeft een standaard meta-model. Het is een JSON-schema en bevindt zich op Adobe Cloud met andere onderdelen van de service Automatede form conversion. U kunt een exemplaar van het metamodel op uw lokale AEM server vinden bij: http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json. U kunt ook klik hier om tot het Engelse taalschema toegang te hebben of te downloaden. Het metamodel voor Frans, Duits Spaans, Italiaans, en Portugees talen kunnen ook worden gedownload .

Het schema van meta-model wordt afgeleid uit schemaentiteiten in https://schema.org/docs/schemas.html. Het heeft Persoon, PostalAddress, LocalBusiness, en meer entiteiten zoals die op https://schema.org worden bepaald. Elke entiteit van het metamodel volgt het JSON-schemaobjecttype. De volgende code vertegenwoordigt een structuur van een metamodel van het steekproef:

   "Entity": {
      "id": "Entity",
      "properties": {
        "name": {
          "type": "string"
        },

        "description": {
          "type": "string",
          "description": "Description of the item"
        }
      }
    }

Het standaardmetamodel downloaden download-the-default-meta-model

Voer de volgende stappen uit om het standaard meta-model aan het lokale dossiersysteem te downloaden:

Het metamodel begrijpen understanding-the-meta-model

Een metamodel verwijst naar een JSON-schemabestand dat entiteiten bevat. Alle entiteiten in het JSON-schemabestand bevatten een naam en een id. Elke entiteit kan meerdere eigenschappen bevatten. De entiteiten en de eigenschappen kunnen variëren op basis van het domein. U kunt een schemabestand met trefwoorden en veldconfiguraties uitbreiden om schema-eigenschappen toe te wijzen aan adaptieve formuliercomponenten.

"Event": {
      "id": "Eventid",
      "allOf": [
        {
          "$ref": "#Entity"
        },
        {
          "properties": {
            "startDate": {
              "type": "string",
              "format": "date",
              "description": "Specify the start date and time of the event in ISO 8601 date format."
            },
            "endDate": {
              "type": "string",
              "format": "date",
              "description": "Specify the end date and time of the event in ISO 8601 date format."
            },
            "location": {
              "$ref": "#PostalAddress",
              "description": "Specify the location of the event."
            }
          }
        }
      ]
    }

In dit voorbeeld: Gebeurtenis staat voor de naam van een entiteit met een waarde voor id als Eventid. De gebeurtenisentiteit bevat meerdere eigenschappen:

De allOf in het metamodel maakt overerving tussen entiteiten mogelijk.

Elke eigenschap kan verder het volgende bevatten:

Gebaseerd op de trefwoorden waarnaar wordt verwezen met aem:affKeyword, voert de conversieservice een zoekbewerking uit op de bronformuliervelden. De conversieservice past de eigenschappen van het JSON-schema en aanvullende eigenschappen toe op de velden die aan de zoekcriteria voldoen.

In dit voorbeeld zoekt de conversieservice naar de telefoon, de telefoon, de mobiele telefoon, de werktelefoon, de thuistelefoon, het telefoonnummer, het telefoonnummer en het telefoonnummer van de trefwoorden in het bronformulier. Op basis van de velden die deze trefwoorden bevatten, past de conversieservice het type, het patroon en de naam:afProperties toe op de adaptieve formuliervelden na de conversie.

JSON-schemaeigenschappen voor gegenereerde adaptieve formuliervelden jsonschemaproperties

Het metamodel ondersteunt de volgende gemeenschappelijke eigenschappen van het JSON-schema voor adaptieve formuliervelden die worden gegenereerd met behulp van de service Automatede form conversion:

Op trefwoorden gebaseerde zoekopdracht om eigenschappen toe te passen op gegenereerde adaptieve formuliervelden keywordsearch

De dienst van de automatede form conversion voert een sleutelwoordonderzoek op de bronvorm tijdens omzetting uit. Nadat de velden die aan de zoekcriteria voldoen, zijn gefilterd, past de conversieservice de eigenschappen die voor die velden in het metamodel zijn gedefinieerd toe op de gegenereerde adaptieve formuliervelden.

Er wordt naar trefwoorden verwezen met de aem:affKeyword eigenschap.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

In dit voorbeeld gebruikt de conversiedienst de tekst binnen aem:affKeyword als zoekwoord. Na het ophalen van de Bankrekeningnummer tekst in het formulier converteert de conversieservice het veld naar een getal tekst met de type eigenschap.

Aanvullende eigenschappen voor gegenereerde adaptieve formuliervelden additionalproperties

U kunt de aem:afProperties eigenschap in het metamodel om de volgende aanvullende eigenschappen te definiëren voor adaptieve formuliervelden die worden gegenereerd met behulp van de Automatede form conversion-service:

Een aangepast model in uw eigen taal maken language-specific-meta-model

U kunt een taalspecifiek metamodel maken. Een dergelijk metamodel helpt u toewijzingsregels te maken in de taal van uw keuze. Met de service automatede form conversion kunt u metamodellen maken in de volgende talen:

Voeg de aem:Language metatag markering aan de bovenkant een meta-model om zijn taal te specificeren. Bijvoorbeeld,

"metaTags": {
        "aem:Language": "fr"
    }

Wanneer geen taal wordt gespecificeerd, is de dienst van mening dat meta-model in het Engels taal is.

Overwegingen bij het maken van een taalspecifiek metamodel

In de volgende afbeelding ziet u voorbeelden van het metamodel voor de Engelse taal en het overeenkomstige metamodel voor de Franse taal:

Aangepaste formuliervelden wijzigen met behulp van een aangepast metamodel modify-adaptive-form-fields-using-custom-meta-model

Uw organisatie kan patronen en bevestigingen naast die hebben die in het standaard meta-model worden vermeld. U kunt het standaardmetamodel uitbreiden om een patroon, validaties en entiteiten toe te voegen die specifiek zijn voor uw organisatie. Tijdens de conversie past de service automatede form conversion het aangepaste metamodel toe op de formuliervelden. U kunt het metamodel blijven bijwerken aangezien de nieuwe patronen, de bevestigingen, en de entiteiten specifiek voor uw organisatie worden ontdekt.

De service automatede form conversion gebruikt een standaardmetamodel dat op de volgende locatie is opgeslagen om bronformuliervelden tijdens de conversie toe te wijzen aan de aangepaste formuliervelden:

http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json

U kunt echter een aangepast metamodel opslaan in een map en de eigenschappen van de conversieservice wijzigen om tijdens de conversie het aangepaste metamodel te gebruiken.

Aangepast metamodel gebruiken tijdens conversie use-custom-meta-model-during-conversion

Voer de volgende stappen uit om een aangepast meta-model tijdens omzetting te gebruiken:

Voorbeelden van aangepaste metamodel custommetamodelexamples

Enkele voorbeelden die vaak worden gebruikt om aangepaste eigenschappen voor formuliervelden te wijzigen, zijn:

Het label van een formulierveld wijzigen modify-the-label-of-a-form-field

Voorbeeld: Wijzig het bankrekeningnummer in het formulier in het aangepaste formulier na de conversie.

In dit aangepaste metamodel gebruikt de conversieservice het titel eigenschap als een zoekwoord. Na het ophalen van de Bankrekeningnummer tekst in het formulier vervangt de conversieservice de tekst door de Klantrekeningnummer tekenreeks die wordt vermeld met de jcr:titel eigenschap in de aem:afProperties sectie.

{
  "numberfields": {
      "type": "number",
   "title": "Bank account number",
   "aem:afProperties" : {
    "jcr:title" : "Customer account number"
   }
   }
}

Het type van een formulierveld wijzigen modify-the-type-of-a-form-field

Voorbeeld: De Bankrekeningnummer tekstveld in het formulier vóór conversie naar een nummertypeveld in het adaptieve formulier na conversie.

In dit aangepaste metamodel gebruikt de conversieservice de tekst binnen aem:affKeyword als zoekwoord. Na het ophalen van de Bankrekeningnummer tekst in het formulier converteert de conversieservice het veld naar een getaltype met behulp van de type eigenschap.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

Help-tekst toevoegen aan een formulierveld add-help-text-to-a-form-field

Voorbeeld: Voeg Help-tekst toe aan het dialoogvenster Bankrekeningnummer veld van het adaptieve formulier.

In dit aangepaste metamodel gebruikt de conversieservice de tekst binnen aem:affKeyword als zoekwoord. Na het ophalen van de Bankrekeningnummer tekst in het formulier voegt de conversieservice de Help-tekst toe aan het aangepaste formulierveld met behulp van de beschrijving eigenschap.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "description": "Specify your bank account number."
 }
}

Een formulierveld converteren naar meerkeuzevakken in het adaptieve formulier convert-a-form-field-to-multiple-choice-check-boxes-in-the-adaptive-form

Voorbeeld: Zet de Land veld van het type tekenreeks in het formulier vóór conversie naar selectievakjes in het adaptieve formulier na conversie.

In dit aangepaste metamodel gebruikt de conversieservice tekst binnen aem:affKeyword als zoekwoord. Na het ophalen van de Land tekst in het formulier converteert de conversieservice het veld naar de volgende selectievakjes met behulp van de enum eigenschap:

sling:resourceType en guideNodeClass eigenschappen wijzen een formulierveld toe aan de adaptieve formuliercomponent van het selectievakje.

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidecheckbox",
      "guideNodeClass": "guidecheckbox"
    }
  }
}

De indeling van een formulierveld wijzigen modify-the-format-of-a-form-field

Voorbeeld: De opmaak van de E-mailadres naar een e-mailindeling.

In dit aangepaste metamodel gebruikt de conversieservice tekst binnen aem:affKeyword als zoekwoord. Na het ophalen van de E-mailadres tekst in het formulier converteert de conversieservice het veld naar een e-mailindeling in de vorm van format eigenschap.

{
   "additionalDetails" : {
      "aem:affKeyword": ["E-mail Address"],
       "type" : "string",
       "format" : "email"
  }
}

Validaties toevoegen aan adaptieve formuliervelden add-validations-to-adaptive-form-fields

Voorbeeld 1: Een validatie toevoegen aan de Postcode van het adaptieve formulier.

In dit aangepaste metamodel gebruikt de conversieservice tekst binnen aem:affKeyword als het zoekwoord. Na het ophalen van de Postcode tekst in het formulier voegt de conversieservice een validatie toe aan het veld met behulp van de validatePictureClause eigenschap gedefinieerd in het dialoogvenster aem:afProperties sectie. De invoer die u opgeeft voor de Postcode in het adaptieve formulier na conversie moeten zes tekens worden opgenomen.

{
   "postalCode" : {
      "aem:affKeyword": ["Postal Code"],
      "type" : "string",
      "aem:afProperties" : {
        "validatePictureClause" : "\\d{6}"
      }
   }
}

Voorbeeld 2: Een validatie toevoegen aan de Bankrekeningnummer van het adaptieve formulier.

In dit aangepaste metamodel gebruikt de conversieservice tekst binnen aem:affKeyword als het zoekwoord. Na het ophalen van de Bankrekeningnummer tekst in het formulier voegt de conversieservice een validatie toe aan het veld met behulp van de verplicht eigenschap gedefinieerd in het dialoogvenster aem:afProperties sectie. Op basis van de validatie moet u een waarde opgeven voor het dialoogvenster Bankrekeningnummer veld voordat het formulier wordt verzonden na conversie.

{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "aem:afProperties" : {
        "mandatory": "true"
      }
   }
}

Een tekstveld omzetten in een vervolgkeuzelijst in het aangepaste formulier convert-a-text-field-to-drop-down-list-in-the-adaptive-form

Voorbeeld: Zet de Land veld van het type tekenreeks in het formulier vóór conversie naar vervolgkeuzemogelijkheden in het adaptieve formulier na conversie.

In dit aangepaste metamodel gebruikt de conversieservice tekst binnen aem:affKeyword als het zoekwoord. Na het ophalen van de Land tekst in het formulier converteert de conversieservice het veld naar de volgende vervolgkeuzelijsten met behulp van de enum eigenschap:

sling:resourceType en guideNodeClass eigenschappen wijzen een formulierveld toe aan de vervolgkeuzelijst van de adaptieve formuliercomponent.

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidedropdownlist",
      "guideNodeClass": "guideDropDownlist"
    }
  }
}

Aanvullende opties toevoegen aan de vervolgkeuzelijst add-additional-options-to-the-drop-down-list

Voorbeeld: Toevoegen Sri Lanka als een extra optie aan een bestaande drop-down lijst gebruikend een douane meta-model.

Als u een extra optie wilt toevoegen, werkt u de enum met de nieuwe optie. In dit voorbeeld werkt u de enum eigenschap met Sri Lanka als een extra optie. Waarden vermeld in enum weergegeven in de vervolgkeuzelijst.

{
"title": {
    "aem:affKeyword": [
      "country"
    ],
    "type" : "string",
    "enum": [
      "India",
      "England",
      "Australia",
      "New Zealand",
   "Sri Lanka"
    ],
    "aem:afProperties": {
      "sling:resourceType": "fd/af/components/guidecheckbox",
      "guideNodeClass": "guidecheckbox"
    }
  }
}

Een tekenreeksveld omzetten in een veld met meerdere regels convert-a-string-field-to-a-multi-line-field

Voorbeeld: Zet de Adres veld van het type tekenreeks naar een veld met meerdere regels in het formulier na conversie.

In dit aangepaste metamodel gebruikt de conversieservice tekst binnen aem:affKeyword als het zoekwoord. Na het ophalen van de Adres tekst in het formulier converteert de service het tekstveld naar een veld met meerdere regels met behulp van de multiLine eigenschap gedefinieerd in het dialoogvenster aem:afProperties sectie.

{
 "multiLine" : {
   "aem:affKeyword": [
      "Address"
    ],
    "type" : "string",
    "aem:afProperties": {
      "multiLine": "true"
    }
  }
}