Supporto XFA nei moduli adattivi basati su XDP

Ultimo aggiornamento: 2023-12-21

Introduzione

L’Adobe consiglia di utilizzare l’acquisizione dati moderna ed estensibile Componenti core per creazione di un nuovo Forms adattivo o aggiunta di Forms adattivo alle pagine AEM Sites. Questi componenti rappresentano un progresso significativo nella creazione di Forms adattivi, garantendo esperienze utente straordinarie. Questo articolo descrive un approccio precedente all’authoring di Forms adattivi utilizzando i componenti di base.

I moduli adattivi supportano vari eventi, proprietà, script e convalide XFA definiti in un file XDP, tra cui:

  • Esecuzione degli script definiti sugli eventi nel file XDP.
  • Acquisizione dei valori predefiniti e delle proprietà comportamentali per i campi del file XDP.
  • Esecuzione degli script di convalida definiti nel file XDP.

Quando un modulo adattivo viene creato in base a un file XDP, le proprietà, gli eventi e le convalide vengono compilati automaticamente nell’interfaccia utente per l’authoring dei moduli. Tuttavia, gli autori di moduli possono ignorare alcuni di questi elementi per creare un’esperienza alternativa.

Questo articolo elenca gli eventi, le proprietà e le convalide XFA supportati e rispettati nei moduli adattivi e spiega come sostituirli nei moduli adattivi.

Elementi XFA supportati e loro mappatura nei moduli adattivi

Campi

Quando un modulo adattivo viene creato utilizzando un file XDP, puoi trascinare un campo XFA sul modulo adattivo. Nella tabella seguente è riportato il mapping dei campi XFA ai campi di un modulo adattivo.

Campo o contenitore XFA

Componente modulo adattivo corrispondente

Pulsante

Pulsante

Casella di controllo

Casella di controllo

Casella di riepilogo

Elenco a discesa

Campo data/ora

Selettore data

Disegno a mano

Firma a mano

Campo numerico

Casella numerica

Campo decimale

Casella numerica

Campo testo

Casella di testo

Campo password

Casella password

Immagine

Immagine

Testo

Testo

Sottomodulo

Pannello

Area (gruppo)

Pannello

Set di sottomoduli

Pannello

Proprietà

La tabella seguente acquisisce il comportamento nei moduli adattivi dei vari script XFA definiti nei file XDP.

Proprietà del componente XFA

Comportamento corrispondente nei moduli adattivi

somExpression

Mappato alla proprietà Bind reference (bindRef) in un modulo adattivo.

presenza

Mappato alla proprietà visibile nel modulo adattivo. È possibile sostituirlo utilizzando l'espressione Visibilità.

accesso

Mappato alla proprietà abilitata in un modulo adattivo. È possibile sostituirlo utilizzando l'espressione di Access.

Accessibilità: ruolo

Mappato alla proprietà del ruolo nel modulo adattivo.

Accessibilità: talkPriority

Mappato alla proprietà talkPriority nel modulo adattivo.

Accessibilità: talkText

Mappato al testo personalizzato per l’accessibilità nel modulo adattivo.

Accessibilità: toolTip

Mappato alla proprietà di descrizione breve nel modulo adattivo.

didascalia (tutti i tipi di campo)

Mappato alla proprietà Title nel modulo adattivo.

displayFormat (tutti i tipi di campo)

Mappato al Pattern di visualizzazione in formato adattivo.

rawValue (tutti i tipi di campo)

Mappato alla proprietà value in adaptive Form.

elementi (Casella di riepilogo, Casella di controllo)

Mappata alla proprietà options nel modulo adattivo. È possibile sostituirlo utilizzando l'espressione Opzioni.

maxChar (Campo di testo)

Mappato alla proprietà Numero massimo di caratteri consentiti nel modulo adattivo.

multiriga (Campo di testo)

Mappato alla proprietà Allow multiple lines (Consenti più righe) nel modulo adattivo.

fracDigit (Campo Numerico, Campo Decimale)

Mappato alla proprietà Frac digits nel modulo adattivo.

leadDigit (Campo Numerico, Campo Decimale)

Mappato alla proprietà Cifre lead nel modulo adattivo.

multiSelect (Casella di riepilogo)

Mappato su Consente la selezione di più proprietà in un modulo adattivo.

Script

La tabella seguente acquisisce il comportamento nei moduli adattivi dei vari script XFA definiti nel file XDP.

Eventi script XFA

Comportamento corrispondente nei moduli adattivi

inizializzare

Questo script viene eseguito in fase di runtime e non può essere sostituito in un modulo adattivo.

calcola

Mappato all’espressione Calculate nel modulo adattivo.

convalida

Mappato all’espressione Validation in un modulo adattivo.

validationState

Questo script viene eseguito in fase di runtime e non può essere sostituito in un modulo adattivo.

uscire

Questo script viene eseguito in fase di runtime e non può essere sostituito in un modulo adattivo.

clic (campi pulsante)

Mappato all'espressione Click del pulsante.

Supporto per script lato server

Questo script viene eseguito in fase di runtime e non può essere sostituito in un modulo adattivo.

Supporto per i servizi web

Questo script viene eseguito in fase di runtime e non può essere sostituito in un modulo adattivo.

Modifica (campo scarabocchio, pulsante di scelta, casella di controllo)

Questo script viene eseguito in fase di runtime e non può essere sostituito in un modulo adattivo.

Convalide

La tabella seguente acquisisce il modo in cui le convalide XFA si associano alle convalide nei moduli adattivi.

Convalida XFA

Convalida corrispondente nel modulo adattivo

Pattern di convalida (formatTest)

validatePictureClause

Messaggio modello di convalida (formatTestMessage)

validatePictureMessage

Obbligatorio (nullTest )

obbligatorio

Messaggio vuoto (nullTestMessage)

mandatoryMessage

Convalida script (scriptTest)

validateExp

Messaggio script di convalida (scriptTestMessage)

validateMessage

NOTA

Non è possibile ignorare la proprietà obbligatoria per i pulsanti di scelta e i gruppi di caselle di controllo dei moduli adattivi associati ai pulsanti di controllo XFA.

In questa pagina