La sintassi di riferimento è ridotta a causa della posizione relativa del calcolo o script che comprende la sintassi di riferimento e i riferimenti alla sintassi dell'oggetto o a causa dell'utilizzo di collegamenti. In generale, sebbene una sintassi di riferimento abbreviata sia più veloce, ha lo svantaggio di funzionare solo finché gli oggetti rimangono nelle stesse posizioni in relazione l'uno all'altro.Ad esempio, nell'immagine seguente viene mostrata la gerarchia di un modulo di esempio Ordine di acquisto.
Nell'immagine viene mostrata una sintassi di riferimento completa sia per FormCalc che per JavaScript, per accedere al valore del campo txtCondition. Questa sintassi di riferimento può essere utilizzata come parte di un calcolo o script per qualsiasi oggetto nel modulo.
- A.
- Nodo principale
- B.
- Modello
- C.
- Nodo principale della struttura modulo
- D.
- Oggetto page
- E.
- Nome del sottomodulo
- F.
- Nome oggetto
- G.
- Nome proprietà o metodo
Nota: Nonostante la sintassi di riferimento sia comune a FormCalc e JavaScript, è necessario osservare le convenzioni per ogni linguaggio di script. Ad esempio, la sintassi di riferimento nell'esempio sopra funziona per FormCalc; tuttavia, per JavaScript è necessario includere un punto e virgola finale (;).
Se due oggetti esistono nello stesso contenitore, ad esempio un sottomodulo, si dice che condividono lo stesso contesto. Se due oggetti si trovano nello stesso contesto, è possibile utilizzare una sintassi di riferimento abbreviata che comprende solo il nome dell'oggetto seguito dalla proprietà o metodo a cui si desidera accedere. Ad esempio, utilizzando l'esempio sopra, la seguente sintassi di riferimento abbreviata ha accesso al valore del campo txtCondition da qualsiasi campo del sottomodulo total:
txtCondition.rawValue
Se due oggetti esistono in contenitori diversi, non condividono lo stesso contesto. In questo caso, è possibile utilizzare una sintassi di riferimento abbreviata; tuttavia, la sintassi deve iniziare con il nome dell'oggetto di livello superiore che i due oggetti non hanno in comune. Ad esempio, utilizzando la gerarchia sopra, la seguente sintassi di riferimento abbreviata può accedere al valore del campo address dal campo txtCondition:
header.address.rawValue
A causa della struttura del modello di oggetto modulo XML, alcuni metodi e proprietà dell'oggetto esistono su oggetti secondari degli oggetti nel modulo. Questi oggetti secondari esistono solo come parte del modello di oggetto modulo XML e non vengono visualizzati nelle palette Gerarchia e Visualizzazione dati. Per accedere a tali proprietà e metodi, è necessario includere gli oggetti secondari nella sintassi di riferimento. Ad esempio, la seguente sintassi di riferimento imposta il testo della descrizione comando per il campo txtCondition:
txtCondition.assist.toolTip.value = "Conditions of purchase." // FormCalc
txtCondition.assist.toolTip.value = "Conditions of purchase."; // JavaScript
Per ulteriori informazioni sugli oggetti del modello di oggetto modulo XML e la relativa struttura, vedere Riferimento script.
