Het standaardmetamodel uitbreiden extend-the-default-meta-model

Met AFCS (automatede form conversion Service) 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 (AFCS) heeft een standaardmetamodel. Het is een JSON-schema en bevindt zich op de Adobe Cloud met andere onderdelen van de AFCS (Automatede form conversion Service). U kunt een exemplaar van het meta-model op uw lokale AEM server bij vinden: http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json. U kunt ook hierklikken om tot het Engelse taalschema toegang te hebben of te downloaden. Het meta-model voor Frans, DuitsSpaans, Italiaans, en Portugesetalen zijn ook beschikbaar voor download.

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, vertegenwoordigt de Gebeurtenis de naam van een entiteit met een waarde voor identiteitskaart als Uitgezochte. De gebeurtenisentiteit bevat meerdere eigenschappen:

allOf aannemer in meta-model laat overerving onder entiteiten toe.

Elke eigenschap kan verder het volgende bevatten:

Gebaseerd op de sleutelwoorden van verwijzingen voorzien gebruikend naam:affKeyword, voert de omzettingsdienst een onderzoeksverrichting op de bronvormgebieden uit. 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 zijn gegenereerd met de Automatede form conversion-service (AFCS):

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

De dienst van de automatede form conversion (AFCS) voert een sleutelwoordonderzoek op het 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.

De sleutelwoorden worden van verwijzingen voorzien gebruikend het naam:affKeyword bezit.

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

In dit voorbeeld, gebruikt de omzettingsdienst de tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het de rekeningsaantal van de Bank in de vorm, zet de omzettingsdienst het gebied in a aantal type gebruikend het type bezit om.

Aanvullende eigenschappen voor gegenereerde adaptieve formuliervelden additionalproperties

U kunt het gebruiken aem:afProperties bezit in meta-model om volgende extra eigenschappen voor adaptieve vormgebieden te bepalen die gebruikend de dienst van de Automatede form conversion (AFCS) worden geproduceerd:

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 AFCS (automatede form conversion Service) kunt u metamodellen maken in de volgende talen:

Voeg naam toe:Taal metatag markering aan 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. AFCS (automatede form conversion Service) past tijdens de conversie 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 (AFCS) gebruikt een standaardmetamodel dat op de volgende locatie is opgeslagen om bronformuliervelden tijdens de conversie toe te wijzen aan de adaptieve 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 etiket van het de rekeningsaantal van de Bank in de vorm aan het Aantal van de Rekening van de Douane in de adaptieve vorm na omzetting.

In dit douane meta-model, gebruikt de omzettingsdienst het titel bezit als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het de rekeningsaantal van de Bank in de vorm, vervangt de omzettingsdienst de tekst met het 3} koord van het de rekeningsaantal van de Klant dat met jcr wordt vermeld:titel bezit in 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: Wijzig het 3} gebied van het de rekeningsaantal van de Bank {van teksttype in de vorm vóór omzetting in een aantaltypegebied in de adaptieve vorm na omzetting.

In dit douane meta-model, gebruikt de omzettingsdienst de tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het de rekeningsaantal van de Bank in de vorm, zet de omzettingsdienst het gebied in een aantaltype gebruikend het type bezit om.

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

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

Voorbeeld: Voeg de tekst van de Hulp aan het 3} gebied van het de rekeningsaantal van de Bank {van adaptieve vorm toe.

In dit douane meta-model, gebruikt de omzettingsdienst de tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het de rekeningsaantal van de Bank in de vorm, voegt de omzettingsdienst de tekst van de Hulp aan het adaptieve vormgebied toe gebruikend het beschrijvings bezit.

{
  "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 het 3} gebied van het Land {van koordtype in de vorm vóór omzetting in controledozen in de adaptieve vorm na omzetting om.

In dit douane meta-model, gebruikt de omzettingsdienst tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het Land in de vorm, zet de omzettingsdienst het gebied in volgende controledozen gebruikend het enum bezit om:

sling:resourceType en guideNodeClass eigenschappen kaart een vormgebied aan de component van de controledoos adaptieve vorm.

{
"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: Wijzig het formaat van het E-mailadres gebied aan een e-mailformaat.

In dit douane meta-model, gebruikt de omzettingsdienst tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de Tekst van het E-mailAdres in de vorm, zet de omzettingsdienst het gebied in een e-mailformaat gebruikend het formaat bezit om.

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

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

Voorbeeld 1: voeg een bevestiging aan het 3} gebied van de Code van de Postal van de adaptieve vorm toe.

In dit douane meta-model, gebruikt de omzettingsdienst tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van de Postcode in de vorm, voegt de omzettingsdienst een bevestiging aan het gebied toe gebruikend het validatePictureClause bezit dat in wordt bepaald:afProperties sectie. Gebaseerd op de bevestiging, moet de input die u voor het gebied van de Code van de Postal in de adaptieve vorm na omzetting specificeert zes karakters omvatten.

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

Voorbeeld 2: voeg een bevestiging aan het 3} gebied van het de rekeningsaantal van de Bank {van de adaptieve vorm toe.

In dit douane meta-model, gebruikt de omzettingsdienst tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het de rekeningsaantal van de Bank in de vorm, voegt de omzettingsdienst een bevestiging aan het gebied toe gebruikend het verplichte bezit dat in wordt bepaald:afProperties sectie. Gebaseerd op de bevestiging, moet u een waarde voor het gebied van het de rekeningsaantal van de 1} Bank specificeren alvorens de vorm na omzetting voor te leggen.

{
  "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 het 3} gebied van het Land {van koordtype in de vorm vóór omzetting in drop-down opties in de adaptieve vorm na omzetting om.

In dit douane meta-model, gebruikt de omzettingsdienst tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het Land in de vorm, zet de omzettingsdienst het gebied in volgende drop-down lijstopties gebruikend het enum bezit om:

sling:resourceType en guideNodeClass eigenschappen kaart een vormgebied aan de drop-down adaptieve vormcomponent.

{
"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: voeg Sri Lanka als extra optie aan een bestaande drop-down lijst toe gebruikend een douane meta-model.

Om een extra optie toe te voegen, werk het enum bezit met de nieuwe optie bij. In dit voorbeeld, werk het enum bezit met Sri Lanka als extra optie bij. Waarden die in worden vermeld enum bezitsvertoning in de drop-down lijst.

{
"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 het 3} gebied van het Adres {van koordtype in een multi-line gebied in de vorm na omzetting om.

In dit douane meta-model, gebruikt de omzettingsdienst tekst binnen naam:affKeyword als onderzoekssleutelwoord. Na het terugwinnen van de tekst van het Adres in de vorm, zet de dienst het tekstgebied in een multi-line gebied gebruikend het multiLine bezit dat in wordt bepaald:afProperties sectie.

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