Estendere il metamodello predefinito extend-the-default-meta-model

Il servizio di automated forms conversion (AFCS) identifica ed estrae gli oggetti dai moduli di origine. La funzione di mappatura semantica consente al servizio di decidere in che modo gli oggetti estratti vengono rappresentati in un modulo adattivo. Ad esempio, un modulo di origine può avere diversi tipi di rappresentazioni di una data. La mappatura semantica consente di mappare tutte le rappresentazioni degli oggetti modulo data del modulo di origine con il componente data dei moduli adattivi. La funzione di mappatura semantica consente inoltre al servizio di preconfigurare e applicare convalide, regole, pattern di dati, testo della Guida e proprietà di accessibilità ai componenti dei moduli adattivi durante la conversione.

Il metamodello è uno schema JSON. Prima di iniziare con il metamodello, assicurati di avere familiarità con JSON. È necessaria un’esperienza di creazione, modifica e lettura dei dati salvati in formato JSON.

Metamodello predefinito default-meta-model

Il servizio di automated forms conversion (AFCS) dispone di un metamodello predefinito. Si tratta di uno schema JSON che risiede su Adobe Cloud con altri componenti del servizio di Automated forms conversion (AFCS). È possibile trovare una copia del metamodello sul proprio server AEM locale all'indirizzo: http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json. Puoi anche fare clic qui per accedere o scaricare lo schema in lingua inglese. Il metamodello per Francese, Tedesco Spagnolo, Italiano e Portoghese lingue è disponibile per il download.

Lo schema del metamodello deriva dalle entità dello schema in https://schema.org/docs/schemas.html. Dispone di Persona, IndirizzoPostale, LocalBusiness e più entità come definito su https://schema.org. Ogni entità del metamodello aderisce al tipo di oggetto dello schema JSON. Il codice che segue rappresenta una struttura di metamodello di esempio:

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

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

Scarica il metamodello predefinito download-the-default-meta-model

Per scaricare il metamodello predefinito nel file system locale, effettua le seguenti operazioni:

Informazioni sul metamodello understanding-the-meta-model

Un metamodello fa riferimento a un file di schema JSON che contiene entità. Tutte le entità nel file dello schema JSON includono un nome e un ID. Ogni entità può includere più proprietà. Le entità e le relative proprietà possono variare in base al dominio. Puoi migliorare un file di schema con parole chiave e configurazioni di campi per mappare le proprietà dello schema ai componenti del modulo adattivo.

"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 questo esempio, Event rappresenta il nome di un'entità con un valore per id come Eventid. L’entità Event include più proprietà:

Il costrutto allOf nel metamodello abilita l'ereditarietà tra le entità.

Ogni proprietà può inoltre includere:

In base alle parole chiave a cui si fa riferimento utilizzando aem:affKeyword, il servizio di conversione esegue un'operazione di ricerca nei campi del modulo di origine. Il servizio di conversione applica le proprietà dello schema JSON e proprietà aggiuntive ai campi che soddisfano i criteri di ricerca.

In questo esempio, il servizio di conversione cerca le parole chiave relative a telefono, telefono, cellulare, telefono di lavoro, telefono di casa, numero di telefono, numero di telefono e numero di telefono nel modulo di origine. In base ai campi che includono queste parole chiave, il servizio di conversione applica il tipo, il pattern e aem:afProperties ai campi del modulo adattivo dopo la conversione.

Proprietà dello schema JSON per i campi del modulo adattivo generati jsonschemaproperties

Il metamodello supporta le seguenti proprietà comuni dello schema JSON per i campi del modulo adattivo generati utilizzando il servizio di Automated forms conversion (AFCS):

Ricerca basata su parole chiave per applicare proprietà ai campi del modulo adattivo generati keywordsearch

Il servizio di automated forms conversion (AFCS) esegue una ricerca per parola chiave nel modulo di origine durante la conversione. Dopo aver filtrato i campi che soddisfano i criteri di ricerca, il servizio di conversione applica le proprietà definite per tali campi nel metamodello ai campi del modulo adattivo generato.

Viene fatto riferimento alle parole chiave utilizzando la proprietà aem:affKeyword.

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

In questo esempio, il servizio di conversione utilizza il testo contenuto in aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo del numero di conto bancario nel modulo, il servizio di conversione converte il campo in un tipo numero utilizzando la proprietà tipo.

Proprietà aggiuntive per i campi modulo adattivo generati additionalproperties

Puoi utilizzare la proprietà aem:afProperties nel metamodello per definire le seguenti proprietà aggiuntive per i campi dei moduli adattivi generati tramite il servizio di Automated forms conversion (AFCS):

Creare un metamodello personalizzato nella propria lingua language-specific-meta-model

Puoi creare un metamodello specifico per la lingua. Questo metamodello consente di creare regole di mappatura nel linguaggio desiderato. Il servizio di automated forms conversion (AFCS) consente di creare metamodelli nelle seguenti lingue:

Aggiungi il tag metatag aem:Language in alto a un metamodello per specificarne la lingua. Ad esempio:

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

Se non viene specificata alcuna lingua, il servizio considera che il metamodello sia in lingua inglese.

Considerazioni per la creazione di un metamodello specifico per il linguaggio

L’immagine seguente mostra alcuni esempi di metamodello in lingua inglese e del corrispondente metamodello in lingua francese:

Modificare i campi del modulo adattivo utilizzando un metamodello personalizzato modify-adaptive-form-fields-using-custom-meta-model

Nell’organizzazione possono essere presenti modelli e convalide oltre a quelli elencati nel metamodello predefinito. Puoi estendere il metamodello predefinito per aggiungere pattern, convalide ed entità specifiche per la tua organizzazione. Il servizio di automated forms conversion (AFCS) applica il metamodello personalizzato ai campi del modulo durante la conversione. Puoi continuare ad aggiornare il metamodello man mano che vengono rilevati nuovi modelli, convalide ed entità specifiche della tua organizzazione.

Il servizio di automated forms conversion (AFCS) utilizza un metamodello predefinito salvato nella posizione seguente per mappare i campi del modulo di origine ai campi del modulo adattivo durante la conversione:

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

Tuttavia, puoi salvare un metamodello personalizzato in una cartella e modificare le proprietà del servizio di conversione in modo che utilizzi il metamodello personalizzato durante la conversione.

Usa metamodello personalizzato durante la conversione use-custom-meta-model-during-conversion

Per utilizzare un metamodello personalizzato durante la conversione, effettua le seguenti operazioni:

Esempi di metamodello personalizzati custommetamodelexamples

Alcuni esempi comuni di utilizzo di un metamodello personalizzato per modificare le proprietà dei campi di un modulo adattivo includono:

Modificare l’etichetta di un campo modulo modify-the-label-of-a-form-field

Esempio: dopo la conversione, modifica l'etichetta del numero di conto bancario nel modulo in Numero di conto personalizzato nel modulo adattivo.

In questo metamodello personalizzato, il servizio di conversione utilizza la proprietà title come parola chiave di ricerca. Dopo aver recuperato il testo del numero di conto bancario nel modulo, il servizio di conversione sostituisce il testo con la stringa numero di conto cliente indicata con la proprietà jcr:title nella sezione aem:afProperties.

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

Modificare il tipo di un campo modulo modify-the-type-of-a-form-field

Esempio: modifica il campo Numero conto bancario di tipo testo nel modulo prima della conversione in un campo di tipo numero nel modulo adattivo dopo la conversione.

In questo metamodello personalizzato, il servizio di conversione utilizza il testo contenuto in aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo del numero di conto bancario nel modulo, il servizio di conversione converte il campo in un tipo numerico utilizzando la proprietà type.

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

Aggiungere testo della Guida a un campo modulo add-help-text-to-a-form-field

Esempio: aggiungi il testo della Guida al campo Numero conto bancario del modulo adattivo.

In questo metamodello personalizzato, il servizio di conversione utilizza il testo contenuto in aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo del conto bancario nel modulo, il servizio di conversione aggiunge il testo della Guida al campo del modulo adattivo utilizzando la proprietà description.

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

Convertire un campo modulo in caselle di controllo a scelta multipla nel modulo adattivo convert-a-form-field-to-multiple-choice-check-boxes-in-the-adaptive-form

Esempio: converti il campo Paese del tipo di stringa nel modulo prima della conversione in caselle di controllo nel modulo adattivo dopo la conversione.

In questo metamodello personalizzato, il servizio di conversione utilizza come parola chiave di ricerca il testo contenuto in aem:affKeyword. Dopo aver recuperato il testo Country nel modulo, il servizio di conversione converte il campo nelle caselle di controllo seguenti utilizzando la proprietà enum:

Le proprietà sling:resourceType e guideNodeClass associano un campo modulo al componente modulo adattivo della casella di controllo.

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

Modificare il formato di un campo modulo modify-the-format-of-a-form-field

Esempio: modifica il formato del campo Indirizzo e-mail in un formato e-mail.

In questo metamodello personalizzato, il servizio di conversione utilizza come parola chiave di ricerca il testo contenuto in aem:affKeyword. Dopo aver recuperato il testo del Indirizzo e-mail nel modulo, il servizio di conversione converte il campo in un formato e-mail utilizzando la proprietà format.

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

Aggiungere convalide ai campi del modulo adattivo add-validations-to-adaptive-form-fields

Esempio 1: Aggiungi una convalida al campo CAP del modulo adattivo.

In questo metamodello personalizzato, il servizio di conversione utilizza come parola chiave di ricerca il testo contenuto in aem:affKeyword. Dopo aver recuperato il testo del Codice postale nel modulo, il servizio di conversione aggiunge una convalida al campo utilizzando la proprietà validatePictureClause definita nella sezione aem:afProperties. In base alla convalida, l'input specificato per il campo Codice postale nel modulo adattivo dopo la conversione deve includere sei caratteri.

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

Esempio 2: Aggiungi una convalida al campo Numero conto bancario del modulo adattivo.

In questo metamodello personalizzato, il servizio di conversione utilizza come parola chiave di ricerca il testo contenuto in aem:affKeyword. Dopo aver recuperato il testo del numero di conto bancario nel modulo, il servizio di conversione aggiunge una convalida al campo utilizzando la proprietà required definita nella sezione aem:afProperties. In base alla convalida, è necessario specificare un valore per il campo Numero conto bancario prima di inviare il modulo dopo la conversione.

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

Convertire un campo di testo in un elenco a discesa nel modulo adattivo convert-a-text-field-to-drop-down-list-in-the-adaptive-form

Esempio: converti il campo Paese del tipo di stringa nel modulo prima della conversione in opzioni a discesa nel modulo adattivo dopo la conversione.

In questo metamodello personalizzato, il servizio di conversione utilizza come parola chiave di ricerca il testo contenuto in aem:affKeyword. Dopo aver recuperato il testo Country nel modulo, il servizio di conversione converte il campo nelle seguenti opzioni dell'elenco a discesa utilizzando la proprietà enum:

Le proprietà sling:resourceType e guideNodeClass associano un campo modulo al componente modulo adattivo a discesa.

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

Aggiungi opzioni aggiuntive all’elenco a discesa add-additional-options-to-the-drop-down-list

Esempio: Aggiungi Sri Lanka come opzione aggiuntiva a un elenco a discesa esistente utilizzando un metamodello personalizzato.

Per aggiungere un'opzione aggiuntiva, aggiornare la proprietà enum con la nuova opzione. In questo esempio, aggiorna la proprietà enum con Sri Lanka come opzione aggiuntiva. I valori elencati nella proprietà enum vengono visualizzati nell'elenco a discesa.

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

Convertire un campo stringa in un campo a più righe convert-a-string-field-to-a-multi-line-field

Esempio: Converti il campo Indirizzo di tipo stringa in un campo a più righe nel modulo dopo la conversione.

In questo metamodello personalizzato, il servizio di conversione utilizza come parola chiave di ricerca il testo contenuto in aem:affKeyword. Dopo aver recuperato il testo Address nel modulo, il servizio converte il campo di testo in un campo su più righe utilizzando la proprietà multiLine definita nella sezione aem:afProperties.

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