Estensione del metamodello predefinito

Il servizio automated forms conversion identifica ed estrae gli oggetti modulo 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 automated forms conversion ha un meta-modello predefinito. Si tratta di uno schema JSON e risiede in Adobe Cloud con altri componenti del servizio Automated forms conversion. È possibile 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:

Effettuate l'accesso all'istanza di AEM Forms .
Andate alla cartella Forms > Forms & Documents Meta Model.
Selezionare il file global.schema.json e toccare Download. Viene visualizzata una finestra di dialogo per il download. Selezionare l'opzione Download asset(s) as binary files. Toccare Download. Viene scaricato un archivio.

Nozioni di base sul 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 per 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:

Proprietà dello schema JSON
Ricerca basata su parole chiave per applicare proprietà ai campi modulo adattivo generati
Ulteriori proprietà

Proprietà dei metadati

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 Automated forms conversion:

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 meta-modelli personalizzati.
descrizione	La proprietà description imposta il testo della Guida relativo al campo modulo adattivo generato. Per ulteriori informazioni, vedere Aggiungere testo della Guida a un campo modulo in Esempi di meta-modelli 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 in 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 metacomodello limita il valore del campo modulo adattivo generato a dieci cifre: "pattern": "///d%7B10%7D/?lang=it" 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 meta-modello, 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 meta-modelli personalizzati.

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

Il servizio automated forms conversion esegue una ricerca di parole 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 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 Numero conto bancario nel modulo, il servizio di conversione converte il campo in un tipo number 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 dei moduli adattivi generati utilizzando il servizio Automated forms conversion:

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 in Esempi di meta-modelli 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 modulo adattivi negli esempi di 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 meta-modelli personalizzati. Per informazioni su ulteriori proprietà da applicare ai campi modulo adattivi mediante lo schema JSON, vedere Creazione di moduli adattivi con lo schema JSON.
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 negli esempi di formati adattivi nei modelli metapersonalizzati.
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 modulo adattivi negli esempi di meta-modelli personalizzati.

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 automated forms conversion 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 automated forms conversion utilizza un metacomodello predefinito salvato nel percorso 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.

Utilizza meta-modello personalizzato durante la conversione

Per utilizzare un meta-modello personalizzato durante la conversione, eseguire i seguenti passaggi:

Create una cartella in Forms > Forms & Documents e caricate il file di schema JSON del metamodello personalizzato nella cartella.
Apri le proprietà del servizio di conversione utilizzando:

Tools > Cloud Services > Automated Forms Conversion Configuration> <>Proprietà della configurazione selezionata>
Nella scheda Basic, specificare la posizione del meta-modello personalizzato nel campo Custom Meta-model e toccare Save & Close.
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 Numero conto bancario nel modulo, il servizio di conversione sostituisce il testo con la stringa Numero account 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 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 Numero 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"]
 }
}

Aggiungere il 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 Numero 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 Country nel modulo, il servizio di conversione converte il campo nelle seguenti caselle di controllo utilizzando la proprietà enum:

India
Inghilterra
Australia
Nuova Zelanda

sling: resourceType e guideNodeClassproperties 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

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 adattivo

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 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 del numero del 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 Numero 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 Campagna 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 Country 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

sling: resourceType e guideNodeClassproperties 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"
    }
  }
}

Aggiungere ulteriori opzioni all'elenco a discesa

Esempio: aggiungete Sri Lankaas 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, aggiornare 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: Convertire il campo Indirizzo di tipo stringa in un campo multiriga del modulo 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 Address nel modulo, il servizio converte il campo di testo in un campo multiriga utilizzando la proprietà multiLine definita nella sezione aem:afProperties.

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

Risorse su adobe.com

Multichannel Communication Auto Text Summarization Style System Personalized Communications Dynamic Media Content Management System

In questa pagina

Visualizza successivo:

Privacy (AGGIORNATO)

Condizioni d’uso