Utöka standardmetamodellen

Senast uppdaterad: 5 maj 2025

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Administratör
  • Utvecklare

Tjänsten Automated forms conversion (AFCS) identifierar och extraherar formulärobjekt från källformulär. Semantisk mappning hjälper tjänsten att bestämma hur de extraherade objekten ska visas i en adaptiv form. Ett källformulär kan t.ex. ha många olika typer av representationer av ett datum. Med semantisk mappning kan du mappa alla representationer av formulärobjekt för datum i källformuläret med datumkomponenten i de adaptiva formulären. Med semantisk mappning kan tjänsten förkonfigurera och tillämpa valideringar, regler, datamönster, hjälptext och hjälpmedelsegenskaper på adaptiva formulärkomponenter under konverteringen.

Metamodellen är ett JSON-schema. Innan du börjar med metamodellen måste du se till att du är väl insatt i JSON. Du måste ha erfarenhet av att skapa, redigera och läsa data som sparats i JSON-format.

Standardmetamodell

Tjänsten Automated forms conversion (AFCS) har en standardmetamodell. Det är ett JSON-schema och finns i Adobe Cloud tillsammans med andra komponenter i tjänsten Automated forms conversion (AFCS). Du kan hitta en kopia av metamodellen på den lokala AEM på: http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json. Du kan också klicka här för att komma åt eller hämta det engelska språkschemat. Metamodellen för franska, tyska spanska, italienska och portugisiska är också tillgänglig för hämtning.

Schemat för metamodellen härleds från schemaentiteter på https://schema.org/docs/schemas.html. Den har Person, PostalAddress, LocalBusiness och fler entiteter enligt definitionen på https://schema.org. Alla entiteter i metamodellen följer JSON-schemaobjekttypen. Följande kod representerar en exempelmetamodellstruktur:

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

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

Hämta standardmetamodellen

Följ de här stegen för att hämta standardmetamodellen till det lokala filsystemet:

  1. Logga in på din AEM Forms-instans.
  2. Navigera till mappen Forms > Forms & Documents > Meta Model.
  3. Markera filen global.schema.json och tryck på Download. En dialogruta för hämtning visas. Välj alternativet Download asset(s) as binary files. Tryck på Download. Ett arkiv laddas ned.

Metamodellen

En metamodell refererar till en JSON-schemafil som innehåller entiteter. Alla entiteter i JSON-schemafilen innehåller ett namn och ett ID. Varje entitet kan innehålla flera egenskaper. Enheterna och dess egenskaper kan variera beroende på domän. Du kan utöka en schemafil med nyckelord och fältkonfigurationer för att mappa schemaegenskaper till adaptiva formulärkomponenter.

"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."
            }
          }
        }
      ]
    }

I det här exemplet representerar Event namnet på en entitet med ett värde för id som EventID. Händelseentiteten innehåller flera egenskaper:

  • startDate
  • endDate
  • plats

Konstruktorn allOf i metamodellen möjliggör arv mellan entiteter.

Varje egenskap kan dessutom innehålla:

Metamodellegenskaper

Baserat på nyckelorden som refereras med aem:affKeyword, utför konverteringstjänsten en sökåtgärd på källformulärfälten. Konverteringstjänsten använder JSON-schemaegenskaperna och ytterligare egenskaper för de fält som uppfyller sökvillkoren.

I det här exemplet söker konverteringstjänsten efter nyckelorden telefon, telefon, mobiltelefon, arbetstelefon, hemtelefon, telefonnummer, telefonnummer och telefonnummer i källformuläret. Baserat på de fält som innehåller dessa nyckelord använder konverteringstjänsten typ, mönster och aem:afProperties på de adaptiva formulärfälten efter konverteringen.