Il servizio di automated forms conversion identifica ed estrae gli oggetti modulo 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.
Il servizio di automated forms conversion 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. Puoi trovare una copia del metamodello sul tuo server AEM locale all’indirizzo: http://<server>:<port>/aem/forms.html/content/dam/formsanddocuments/metamodel/global.schema.json
. È inoltre possibile fai clic qui per accedere o scaricare lo schema in lingua inglese. Il metamodello per Francese, Tedesco Spagnolo, Italiano, e Portoghese sono disponibili per il download anche le lingue.
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"
}
}
}
Per scaricare il metamodello predefinito nel file system locale, effettua le seguenti operazioni:
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, Evento rappresenta il nome di un’entità con un valore per id as Eventid. L’entità Event include più proprietà:
Il allOf costrutto nel metamodello consente 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.
Il metamodello supporta le seguenti proprietà comuni dello schema JSON per i campi del modulo adattivo generati utilizzando il servizio di Automated forms conversion:
Nome proprietà | Descrizione |
---|---|
titolo |
Il testo menzionato all’interno della proprietà title in un metamodello funge da parola chiave di ricerca per eseguire azioni sui campi del modulo adattivo generato. Ad esempio, modificando l’etichetta di un campo modulo adattivo. Per ulteriori informazioni, consulta Modificare l’etichetta di un campo modulo in Esempi di metamodello personalizzati. |
descrizione |
La proprietà description imposta il testo della Guida per il campo modulo adattivo generato. Per ulteriori informazioni, consulta Aggiungere testo della Guida a un campo modulo in Esempi di metamodello personalizzati. |
tipo |
La proprietà type definisce il tipo di dati per il campo modulo adattivo generato. I valori possibili per la proprietà title includono:
Per ulteriori informazioni sull’utilizzo della proprietà type in un metamodello, consulta Modificare il tipo di un campo modulo in Esempi di metamodello personalizzati. |
pattern |
La proprietà pattern limita il valore del campo modulo adattivo generato basato su un’espressione regolare. Ad esempio, il seguente codice nel metamodello limita a dieci cifre il valore per il campo del modulo adattivo generato: |
formato |
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:
|
enum ed enumNames |
Le proprietà enum e enumNames limitano i valori dei campi elenco 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. |
Il servizio di automated forms conversion 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.
Le parole chiave sono referenziate utilizzando aem:affKeyword proprietà.
{
"numberfields": {
"type": "number",
"aem:affKeyword": ["Bank account number"]
}
}
In questo esempio, il servizio di conversione utilizza il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Numero conto bancario nel modulo, il servizio di conversione converte il campo in un numero digita utilizzando tipo proprietà.
È possibile utilizzare aem:afProperties proprietà nel metamodello per definire le seguenti proprietà aggiuntive per i campi dei moduli adattivi generati utilizzando il servizio di Automated forms conversion:
Nome proprietà | Descrizione |
---|---|
multiLine |
La proprietà multiLine converte un campo del modulo di origine in un campo con più righe nel modulo adattivo dopo la conversione. Per ulteriori informazioni, consulta Convertire un campo stringa in un campo a più righe in Esempi di metamodello personalizzati. |
obbligatorio |
La proprietà required imposta come obbligatorio l’input per un campo di un modulo adattivo dopo la conversione. |
jcr:title |
La proprietà jcr:title, con la proprietà schema JSON title, consente di modificare l’etichetta di un campo di un modulo adattivo dopo la conversione. |
sling:resourceType e guideNodeClass |
Le proprietà sling:resourceType e guideNodeClass consentono di mappare un campo modulo a un componente modulo adattivo corrispondente. |
validatePictureClause |
La proprietà validatePictureClause imposta una convalida sul formato consentito nel campo del modulo adattivo dopo la conversione. |
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 consente di creare metamodelli nelle seguenti lingue:
Aggiungi il aem:Lingua tag metatag nella parte superiore di un metamodello per specificarne il linguaggio. Ad esempio:
"metaTags": {
"aem:Language": "fr"
}
Se non viene specificata alcuna lingua, il servizio considera che il metamodello sia in lingua inglese.
Assicurati che il nome di ogni chiave sia in lingua inglese. Ad esempio, emailAddress.
Assicurati che tutti i riferimenti di entità e i valori predefiniti di tutti i tasti ID comprendano solo caratteri ASCII. Ad esempio "id": "ContactPoint" / "$ref": "#ContactPoint".
Assicurati che tutti i valori corrispondenti alle chiavi seguenti siano nel linguaggio del metamodello specificato:
Ad esempio, quando la lingua del metamodello è il francese ("aem:Language": "fr"), accertati che tutte le descrizioni e i messaggi siano in lingua francese.
Assicurati tutto Proprietà schema JSON utilizza solo valori supportati. Ad esempio, la proprietà type può estendersi solo su valori selezionati di String, Number, Integer e Boolean.
L’immagine seguente mostra alcuni esempi di metamodello in lingua inglese e del corrispondente metamodello in lingua francese:
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 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 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.
Per utilizzare un metamodello personalizzato durante la conversione, effettua le seguenti operazioni:
Creare una cartella in Forms > Forms & Documents e carica il file dello schema JSON del metamodello personalizzato nella cartella.
Apri le proprietà del servizio di conversione utilizzando:
Tools > Cloud Services > Automated Forms Conversion Configuration > <properties of="" selected="" configuration="">
In Basic , specifica la posizione del metamodello personalizzato nel Custom Meta-model campo e tocco Save & Close.
Eseguire la conversione per applicare il metamodello personalizzato al processo di conversione.
Alcuni esempi comuni di utilizzo di un metamodello personalizzato per modificare le proprietà dei campi di un modulo adattivo includono:
Esempio: Modifica l’etichetta del numero di conto bancario nel modulo in Numero di conto personalizzato nel modulo adattivo dopo la conversione.
In questo metamodello personalizzato, il servizio di conversione utilizza titolo come parola chiave di ricerca. Dopo aver recuperato Numero conto bancario nel modulo, il servizio di conversione sostituisce il testo con il Numero conto cliente stringa citata con jcr:title proprietà in aem:afProperties sezione.
{
"numberfields": {
"type": "number",
"title": "Bank account number",
"aem:afProperties" : {
"jcr:title" : "Customer account number"
}
}
}
Esempio: modifica il Numero conto bancario campo 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 aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Numero conto bancario testo nel modulo, il servizio di conversione converte il campo in un tipo di numero utilizzando tipo proprietà.
{
"numberfields": {
"type": "number",
"aem:affKeyword": ["Bank account number"]
}
}
Esempio: aggiungi testo della Guida al Numero conto bancario modulo adattivo.
In questo metamodello personalizzato, il servizio di conversione utilizza il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Numero conto bancario nel modulo, il servizio di conversione aggiunge il testo della Guida al campo del modulo adattivo utilizzando il descrizione proprietà.
{
"numberfields": {
"type": "number",
"aem:affKeyword": ["Bank account number"],
"description": "Specify your bank account number."
}
}
Esempio: converti il Paese campo di tipo 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 il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Paese nel modulo, il servizio di conversione converte il campo in caselle di controllo utilizzando il comando enum proprietà:
sling:resourceType e guideNodeClass proprietà mappa 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"
}
}
}
Esempio: modifica il formato della Indirizzo e-mail in un formato e-mail.
In questo metamodello personalizzato, il servizio di conversione utilizza il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Indirizzo e-mail nel modulo, il servizio di conversione converte il campo in un formato e-mail utilizzando formato proprietà.
{
"additionalDetails" : {
"aem:affKeyword": ["E-mail Address"],
"type" : "string",
"format" : "email"
}
}
Esempio 1: Aggiungi una convalida al Codice postale del modulo adattivo.
In questo metamodello personalizzato, il servizio di conversione utilizza il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Codice postale testo nel modulo, il servizio di conversione aggiunge una convalida al campo utilizzando validatePictureClause proprietà definita nella aem:afProperties sezione. In base alla convalida, l’input specificato per il Codice postale nel modulo adattivo dopo la conversione deve contenere sei caratteri.
{
"postalCode" : {
"aem:affKeyword": ["Postal Code"],
"type" : "string",
"aem:afProperties" : {
"validatePictureClause" : "\\d{6}"
}
}
}
Esempio 2: Aggiungi una convalida al Numero conto bancario del modulo adattivo.
In questo metamodello personalizzato, il servizio di conversione utilizza il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Numero conto bancario testo nel modulo, il servizio di conversione aggiunge una convalida al campo utilizzando obbligatorio proprietà definita nella aem:afProperties sezione. In base alla convalida, devi specificare un valore per Numero conto bancario prima di inviare il modulo dopo la conversione.
{
"numberfields": {
"type": "number",
"aem:affKeyword": ["Bank account number"],
"aem:afProperties" : {
"mandatory": "true"
}
}
}
Esempio: converti il Paese campo di tipo 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 il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Paese nel modulo, il servizio di conversione converte il campo nelle seguenti opzioni di elenco a discesa utilizzando enum proprietà:
sling:resourceType e guideNodeClass proprietà mappa 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"
}
}
}
Esempio: Aggiungi Sri Lanka come opzione aggiuntiva a un elenco a discesa esistente che utilizza un metamodello personalizzato.
Per aggiungere un’opzione aggiuntiva, aggiorna il enum con la nuova opzione. In questo esempio, aggiorna il enum proprietà con Sri Lanka come opzione aggiuntiva. Valori elencati in enum 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"
}
}
}
Esempio: Converti il Indirizzo campo di tipo stringa in un campo a più righe nel modulo dopo la conversione.
In questo metamodello personalizzato, il servizio di conversione utilizza il testo aem:affKeyword come parola chiave di ricerca. Dopo aver recuperato Indirizzo testo nel modulo, il servizio converte il campo di testo in un campo su più righe utilizzando multiLine proprietà definita nella aem:afProperties sezione.
{
"multiLine" : {
"aem:affKeyword": [
"Address"
],
"type" : "string",
"aem:afProperties": {
"multiLine": "true"
}
}
}