Riferimento a oggetti in calcoli e script

Sebbene sia i calcoli FormCalc che gli script JavaScript abbiano regole per la strutturazione del codice, entrambi si basano sulla stessa sintassi di riferimento quando accedono ai valori e alle proprietà degli oggetti del modulo. Il modello di oggetto modulo XML offre un modo strutturato di accedere ai valori e alle proprietà dell'oggetto attraverso una convenzione di denominazione composta con ogni oggetto, proprietà e metodo separato dal carattere punto (.).

In generale, ogni sintassi di riferimento ha una struttura simile suddivisa nelle seguenti sezioni:

  • I nomi degli oggetti primari nella gerarchia del modulo che viene utilizzata per passare ad un campo o ad un oggetto specifico. È possibile utilizzare la palette Gerarchia e Visualizzazione dati per determinare la posizione di un oggetto rispetto ad altri oggetti nel modulo e in tutti i dati associati.

  • Il nome dell'oggetto a cui fare riferimento.

  • Il nome della proprietà o metodo a cui si desidera accedere. Questa sezione può includere anche oggetti del modello di oggetti modulo XML che precedono la proprietà o il metodo nella struttura ma non vengono visualizzati come oggetti nella palette Gerarchia.

Ad esempio, nell'immagine seguente viene mostrata la sintassi di riferimento per accedere al valore di un campo di testo in una struttura del modulo che utilizza le convenzioni di denominazione oggetti predefinite.

A.
Oggetti gerarchia modulo

B.
Nome oggetto

C.
Nome proprietà o metodo

Nota: Per impostazione predefinita, l'oggetto sottomodulo che rappresenta la prima pagina di un nuovo modulo è senza nome. Nella sintassi di riferimento sopra, il sottomodulo senza nome è rappresentato da #subform.

La struttura di notazione della sintassi di riferimento varia leggermente a seconda della situazione specifica. Ad esempio, una sintassi di riferimento completa funziona in tutte le situazioni; tuttavia, in alcuni casi, è possibile utilizzare una sintassi di riferimento ridotta o una scelta rapida per ridurre le dimensioni della sintassi.