De verwijzingssyntaxis wordt ingekort vanwege de relatieve positie van de berekening of het script met de verwijzingssyntaxis en de objectsyntaxisverwijzingen, ofwel omdat er verkorte procedures worden gebruikt. In het algemeen geldt dat een verkorte verwijzingssyntaxis sneller kan worden gemaakt. Het nadeel is echter dat een verkorte verwijzingssyntaxis alleen werkt zolang de objecten zich op dezelfde posities ten opzichte van elkaar bevinden.In het volgende voorbeeld ziet u de hiërarchie van een voorbeeldformulier voor inkooporders.
In dit voorbeeld ziet u een volledige verwijzingssyntaxis, voor zowel FormCalc als JavaScript, waarmee u toegang hebt tot de waarde van het veld txtCondition. U kunt deze verwijzingssyntaxis ook gebruiken in een berekening of script voor een willekeurig object op het formulier.
- A.
- Basisknooppunt
- B.
- Model
- C.
- Basisknooppunt formulierontwerp
- D.
- Paginaobject
- E.
- Subformuliernaam
- F.
- Objectnaam
- G.
- Naam eigenschap of methode
Opmerking: Hoewel de verwijzingssyntaxis wordt gebruikt in zowel FormCalc als JavaScript, moet u wel de conventies van de specifieke scripttaal in acht nemen. Zo komt de verwijzingssyntaxis in het vorige voorbeeld uit FormCalc. In JavaScript moet u de regel echter met een puntkomma (;) afsluiten.
Als twee objecten zich in dezelfde container bevinden, zoals een subformulier, hebben ze voor verwijzingen dezelfde context. Als objecten zich in dezelfde context bevinden, kunt u een verkorte verwijzingssyntaxis gebruiken met alleen de naam van het object gevolgd door de eigenschap of methode waartoe u toegang wilt. Zo hebt u in het bovenstaande voorbeeld met de volgende verkorte verwijzingssyntaxis toegang tot de waarde van het veld txtCondition vanuit elk veld in het subformulier total:
txtCondition.rawValue
Als twee objecten zich in verschillende containers bevinden, delen deze niet dezelfde context. In dit geval kunt u een verkorte verwijzingssyntaxis gebruiken. De syntaxis moet echter beginnen met de naam van het containerobject op het hoogste niveau dat niet door de twee objecten wordt gedeeld. Zo hebt u in de bovenstaande hiërarchie met de volgende verkorte verwijzingssyntaxis toegang tot de waarde van het veld address vanuit het veld txtCondition:
header.address.rawValue
Vanwege de structuur van het XML-formulierobjectmodel komen er enkele objecteigenschappen en -methoden voor op onderliggende objecten van de objecten op het formulier. Deze onderliggende objecten bestaan alleen als onderdeel van het XML-formulierobjectmodel en worden niet in de paletten Hiërarchie en Gegevens weergegeven. Als u toegang wilt tot deze eigenschappen en methoden, moet u de onderliggende objecten in de verwijzingssyntaxis opnemen. In de volgende verwijzingssyntaxis wordt bijvoorbeeld de knopinfotekst ingesteld voor het veld txtCondition:
txtCondition.assist.toolTip.value = "Conditions of purchase." // FormCalc
txtCondition.assist.toolTip.value = "Conditions of purchase."; // JavaScript
Zie Scriptreferentie voor meer informatie over de objecten in het XML-formulierobjectmodel en hun structuur.
