Show Menu
ARGOMENTI×

Estensione del metamodello predefinito

Il servizio di conversione automatizzata dei moduli identifica ed estrae gli oggetti dei moduli dai moduli di origine. Mapper semantico 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. Il mappatore semantico consente di mappare tutte le rappresentazioni degli oggetti modulo data del modulo di origine con il componente data dei moduli adattivi. Mappatore semantico 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 meta-modello, assicurati di avere una buona esperienza con JSON. Devi avere esperienza nella creazione, modifica e lettura dei dati salvati in formato JSON.

meta-modello predefinito

Il servizio di conversione moduli automatizzati dispone di un meta-modello predefinito. Si tratta di uno schema JSON e risiede in Adobe Cloud con altri componenti del servizio di conversione dei moduli automatizzata. Puoi trovare una copia del meta-modello sul server AEM locale all’indirizzo: http://<server>:<porta>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json. È inoltre possibile fare clic qui per accedere o scaricare lo schema predefinito.
Lo schema del meta-modello è derivato dalle entità dello schema all'indirizzo https://schema.org/docs/schemas.html. Dispone di Persona, IndirizzoPostale, AffariLocali e più entità, come definito in https://schema.org. Ogni entità del meta-modello aderisce al tipo di oggetto schema JSON. Il codice seguente rappresenta una struttura di metadati di esempio:
   "Entity": {
      "id": "Entity",
      "properties": {
        "name": {
          "type": "string"
        },

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

Download del metamodello predefinito

Per scaricare il meta-modello predefinito nel file system locale, procedere come segue:
  1. Accedi alla tua istanza di AEM Forms.
  2. Passate alla cartella Forms > Forms & Documents > Meta Model .
  3. Selezionate il global.schema.json file e toccate Download . Viene visualizzata una finestra di dialogo per il download. Selezionate l’ Download asset(s) as binary files opzione. Toccare Download . Viene scaricato un archivio.

Comprendere il meta-modello

Un meta-modello fa riferimento a un file di schema JSON che contiene entità. Tutte le entità nel file di schema JSON includono un nome e un ID. Ciascuna entità può includere più proprietà. Le entità e le relative proprietà possono variare a seconda del dominio. È possibile aggiungere un file di schema con parole chiave e configurazioni di campi per mappare le proprietà dello schema ai componenti dei moduli adattivi.
"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 id come Eventid . L'entità Evento include più proprietà:
  • startDate
  • endDate
  • location
Il costrutto allOf nel meta-modello consente l'ereditarietà tra le entità.
Ogni proprietà può 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 le proprietà aggiuntive ai campi che soddisfano i criteri di ricerca.
In questo esempio, il servizio di conversione cerca il telefono, il telefono, il telefono cellulare, il telefono di lavoro, il telefono di casa, il numero di telefono, il numero di telefono e le parole chiave del numero di telefono nel modulo di origine. In base ai campi che includono queste parole chiave, il servizio di conversione applica i campi tipo, pattern e aem:afProperties ai campi modulo adattivi dopo la conversione.

Proprietà dello schema JSON per i campi modulo adattivo generati

Il meta-modello supporta le seguenti proprietà comuni dello schema JSON per i campi modulo adattivi generati utilizzando il servizio di conversione dei moduli automatizzati:
Nome proprietà Descrizione
titolo
Il testo menzionato nella proprietà title di un metacomodello funge da parola chiave di ricerca per eseguire azioni sui campi modulo adattivo generati. Ad esempio, modificare l'etichetta di un campo modulo adattivo. Per ulteriori informazioni, vedere Modificare l'etichetta di un campo modulo negli esempi di metadati personalizzati.
descrizione
La proprietà description imposta il testo della Guida relativo al campo modulo adattivo generato. Per ulteriori informazioni, vedere Aggiungere il testo della Guida a un campo modulo in esempi di metadati personalizzati.
tipo
La proprietà type definisce il tipo di dati per il campo modulo adattivo generato. I valori possibili per la proprietà title includono:
  • stringa: Genera un campo modulo adattivo di tipo dati di testo.
  • numero: Genera un campo modulo adattivo di tipo numerico.
  • integer: Genera un campo modulo adattivo di tipo numerico con sottotipo impostato su numero intero.
  • booleano: Genera un componente per modulo adattivo switch.
Per ulteriori informazioni sull'utilizzo della proprietà type in un meta-modello, vedere Modificare il tipo di un campo modulo negli esempi di meta-modelli personalizzati.
pattern
La proprietà pattern limita il valore del campo modulo adattivo generato in base a un'espressione regolare. Ad esempio, il seguente codice nel meta-modello limita il valore del campo modulo adattivo generato a dieci cifre: "pattern": "/\\d{10}/" Allo stesso modo, il seguente codice nel meta-modello limita il valore di un campo a un formato data specifico. "pattern": "date{DD MMMM, YYYY}",
format
La proprietà format limita il valore del campo modulo adattivo generato in base a un pattern denominato anziché a un'espressione regolare. I valori possibili per la proprietà format includono:
  • email: Genera un componente per modulo adattivo per e-mail.
  • hostname: Genera un componente modulo adattivo per la casella di testo.
Per ulteriori informazioni sull'utilizzo della proprietà format in un metamodello, vedere Modificare il formato di un campo modulo negli esempi di meta-modelli personalizzati.
enum e enumNames
Le proprietà enum e enumNames limitano i valori dei campi a discesa, casella di controllo o pulsante di scelta a un set fisso. I valori elencati in enumNames vengono visualizzati nell’interfaccia utente. I valori elencati utilizzando la proprietà enum vengono utilizzati per il calcolo. Per ulteriori informazioni, vedere Conversione di un campo modulo in caselle di controllo a scelta multipla nel modulo adattivo, Conversione di un campo di testo in un elenco a discesa nel modulo adattivo e Aggiunta di opzioni aggiuntive all'elenco a discesa negli esempi di metadati personalizzati.

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

Durante la conversione, il servizio di conversione automatica dei moduli esegue una ricerca per parole chiave nel modulo di origine. Dopo aver filtrato i campi che soddisfano i criteri di ricerca, il servizio di conversione applica le proprietà definite per tali campi nel meta-modello ai campi modulo adattivo generati.
Alle parole chiave viene fatto riferimento tramite la proprietà aem:affKeyword .
{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

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

Proprietà aggiuntive per i campi modulo adattivo generati

È possibile utilizzare la proprietà aem:afProperties nel meta-modello per definire le seguenti proprietà aggiuntive per i campi modulo adattivo generati utilizzando il servizio di conversione moduli automatizzati:
Nome proprietà Descrizione
multiLine
La proprietà multiLine converte un campo modulo di origine in un campo multiriga del modulo adattivo dopo la conversione. Per ulteriori informazioni, vedere Convertire un campo stringa in un campo multiriga negli esempi di metadati personalizzati.
mandatory
La proprietà mandatory imposta come obbligatorio l'input per un campo modulo adattivo dopo la conversione. Per ulteriori informazioni, vedere Aggiunta di convalide ai campi dei moduli adattivi negli esempi di modelli meta-modelli personalizzati.
jcr:title
La proprietà jcr:title, con la proprietà dello schema JSON title, consente di modificare l'etichetta di un campo modulo adattivo dopo la conversione. Per ulteriori informazioni, vedere Modificare l'etichetta di un campo modulo negli esempi di metadati personalizzati. Per informazioni su ulteriori proprietà da applicare ai campi modulo adattivi mediante lo schema JSON, vedere Creazione di moduli adattivi con schemaJSON.
sling:resourceType e guideNodeClass
le proprietà sling:resourceType e guideNodeClass consentono di mappare un campo modulo a un componente modulo adattivo corrispondente. Per ulteriori informazioni, vedere Conversione di un campo modulo in caselle di controllo a scelta multipla nel modulo adattivo e Conversione di un campo di testo in un elenco a discesa nel modulo adattivo negli esempi di metadati personalizzati.
validatePictureClause
La proprietà validatePictureClause imposta una convalida sul formato consentito nel campo modulo adattivo dopo la conversione. Per ulteriori informazioni, vedere Aggiunta di convalide ai campi dei moduli adattivi negli esempi di modelli meta-modelli personalizzati.
#custommetamodelexamples

Modificare i campi modulo adattivi utilizzando il metamodello personalizzato

L'organizzazione può disporre di pattern e convalide oltre a quelli elencati nel meta-modello predefinito. È possibile estendere il meta-modello predefinito per aggiungere pattern, convalide ed entità specifici dell'organizzazione. Il servizio di conversione automatizzata dei moduli applica il meta-modello personalizzato ai campi del modulo durante la conversione. È possibile continuare ad aggiornare il meta-modello mano a mano che vengono scoperti nuovi pattern, convalide ed entità specifici della propria organizzazione.
Il servizio di conversione automatizzata dei moduli utilizza un meta-modello predefinito salvato nella posizione seguente per mappare i campi del modulo sorgente ai campi del modulo adattivo durante la conversione:
http://<server>:<porta>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json
Tuttavia, è possibile salvare un meta-modello personalizzato in una cartella e modificare le proprietà del servizio di conversione per utilizzare il meta-modello personalizzato durante la conversione.

Utilizzare un metamodello personalizzato durante la conversione

Per utilizzare un meta-modello personalizzato durante la conversione, eseguire i seguenti passaggi:
  1. Create una cartella in Forms > Forms & Documents e caricate il file di schema JSON del meta-modello personalizzato nella cartella.
  2. Apri le proprietà del servizio di conversione utilizzando:
    Tools > Cloud Services > Automated Forms Conversion Configuration > < Proprietà della configurazione selezionata>
  3. Nella Basic scheda, specificate la posizione del meta-modello personalizzato nel Custom Meta-model campo e toccate Save & Close .
  4. Eseguire la conversione per applicare il meta-modello personalizzato al processo di conversione.

Esempi di meta-modelli personalizzati

Alcuni esempi comuni dell'utilizzo di un meta-modello personalizzato per modificare le proprietà dei campi modulo adattivi sono:
  • Modificare l'etichetta di un campo modulo
  • Modifica del tipo di campo modulo
  • Aggiunta di testo della Guida a un campo modulo
  • Conversione di un campo modulo in pulsanti di scelta a scelta multipla nel modulo adattivo
  • Modificare il formato di un campo modulo
  • Aggiunta di convalide ai campi modulo adattivi
  • Conversione di un campo modulo in opzioni di elenco a discesa nel modulo adattivo
  • Aggiungere ulteriori opzioni all'elenco a discesa
  • Conversione di un campo stringa in un campo multiriga

Modificare l'etichetta di un campo modulo

Esempio: Modificare l'etichetta del numero di conto bancario nel modulo su Numero di conto personalizzato nel modulo adattivo dopo la conversione.
In questo meta-modello 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 menzionata con la proprietà jcr:title nella sezione aem:afProperties .
{
  "numberfields": {
      "type": "number",
   "title": "Bank account number",
   "aem:afProperties" : {
    "jcr:title" : "Customer account number"
   }
   }
}

Modifica del tipo di campo modulo

Esempio : Modificare il campo Numero conto bancario del tipo di testo nel modulo prima della conversione in un campo tipo di numero nel modulo adattivo dopo la conversione.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo del numero del conto bancario nel modulo, il servizio di conversione converte il campo in un tipo di numero utilizzando la proprietà type .
{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"]
 }
}

Aggiunta di testo della Guida a un campo modulo

Esempio : Aggiungere il testo della Guida al campo Numero conto bancario del modulo adattivo.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo relativo al numero di conto bancario nel modulo, il servizio di conversione aggiunge il testo della Guida al campo modulo adattivo utilizzando la proprietà description .
{
  "numberfields": {
      "type": "number",
      "aem:affKeyword": ["Bank account number"],
   "description": "Specify your bank account number."
 }
}

Conversione di un campo modulo in caselle di controllo a scelta multipla nel modulo adattivo

Esempio : Convertire il campo Paese di tipo stringa nel modulo prima della conversione in caselle di controllo nel modulo adattivo dopo la conversione.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo Paese nel modulo, il servizio di conversione converte il campo nelle seguenti caselle di controllo utilizzando la proprietà enum :
  • India
  • Inghilterra
  • Australia
  • Nuova Zelanda
le proprietà sling:resourceType e guideNodeClass mappano 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

Esempio : Modificate il formato del campo Indirizzo ​e-mail in un formato e-mail.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo 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"
  } 
}

Aggiunta di convalide ai campi modulo adattivi

Esempio 1: Aggiungere una convalida al campo Codice ​postale del modulo adattivo.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. 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: Aggiungere una convalida al campo Numero conto bancario del modulo adattivo.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo relativo al numero di conto bancario nel modulo, il servizio di conversione aggiunge una convalida al campo utilizzando la proprietà mandatory 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"
      }   
   }
}

Conversione di un campo di testo in un elenco a discesa nel modulo adattivo

Esempio : Convertire il campo Paese di tipo stringa nel modulo prima della conversione in opzioni a discesa nel modulo adattivo dopo la conversione.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo Paese nel modulo, il servizio di conversione converte il campo nelle seguenti opzioni dell'elenco a discesa utilizzando la proprietà enum :
  • India
  • Inghilterra
  • Australia
  • Nuova Zelanda
le proprietà sling:resourceType e guideNodeClass mappano 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"
    }
  }
}

Aggiungere ulteriori opzioni all'elenco a discesa

Esempio: Aggiungi Sri Lanka come opzione aggiuntiva a un elenco a discesa esistente utilizzando un meta-modello personalizzato.
Per aggiungere un'opzione aggiuntiva, aggiornate la proprietà enum con la nuova opzione. In questo esempio, aggiornate 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"
    }
  }
}

Conversione di un campo stringa in un campo multiriga

Esempio: Dopo la conversione, convertire il campo Indirizzo di tipo stringa in un campo multiriga del modulo.
In questo meta-modello personalizzato, il servizio di conversione utilizza il testo all'interno di aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato il testo Address nel modulo, il servizio converte il campo di testo in un campo multi-riga utilizzando la proprietà multiLine definita nella sezione aem:afProperties .
{
 "multiLine" : {
   "aem:affKeyword": [
      "Address"
    ],
    "type" : "string",
    "aem:afProperties": {
      "multiLine": "true"
    }
  }
}