Relationship Fields

History

PDF

Last Modified: Oct 10, 2023 10:28:55PM

Single Relationship Field Form 1

Multiple Relationship Field Form 1, Form 2

Single Relationship Values

Item	Sample Code	Output
val()	`relationshipFieldsForm.fields.singleRelationshipField.val()`	[Form 1]
selected()	`relationshipFieldsForm.fields.singleRelationshipField.selected()`	[Form 1]
mergeTag()	`relationshipFieldsForm.fields.singleRelationshipField.mergeTag()`	Form 1
mergeTag()	`relationshipFieldsForm.fields.singleRelationshipField.mergeTag("L")`	Single Relationship Field
mergeTag()	`relationshipFieldsForm.fields.singleRelationshipField.mergeTag("H")`
mergeTag()	`relationshipFieldsForm.fields.singleRelationshipField.mergeTag("FI")` Note: Generates an editable field and validation image only when the field isn't already somewhere else on the page.	Form 1

Multiple Relationship Values

Item	Sample Code	Output
val()	`relationshipFieldsForm.fields.multipleRelationshipField.val()`	[Form 2, Form 1]
selected()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()`	[Form 2, Form 1]
mergeTag()	`relationshipFieldsForm.fields.multipleRelationshipField.mergeTag()`	Form 1, Form 2
mergeTag()	`relationshipFieldsForm.fields.multipleRelationshipField.mergeTag("L")`	Multiple Relationship Field
mergeTag()	`relationshipFieldsForm.fields.multipleRelationshipField.mergeTag("H")`
mergeTag()	`relationshipFieldsForm.fields.multipleRelationshipField.mergeTag("FI")` Note: Generates an editable field and validation image only when the field isn't already somewhere else on the page.	Form 1, Form 2

Relationship Form Entry

Using the Relationship selected() method.

Item	Sample Code	Output
displayName()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].displayName()`	Multiple Entry Form: 09/19/2020
entry()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].entry()`	Multiple Entry Form: 09/19/2020
entry()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].entry().formEntry().fields.textField.val()`	Form 2
formRecord()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].formRecord()`	bluestep.js
isChangedEntry()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].isChangedEntry()`	false
isDeletedEntry()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].isDeletedEntry()`	false
isSelected()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].isSelected()`	true
isValid()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].isValid()`	true
label()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].label()`	Form 2
mergeReports()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].mergeReports()`	[]
name()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].name()`	Form 2
relationshipField()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].relationshipField()`	Form 1, Form 2
typeName()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].typeName()`	Bluestep.Relate.RelationshipFormEntry
wasSelected()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()[0].wasSelected()`	true

Relationship Methods

Item	Sample Code	Output
changed()	`relationshipFieldsForm.fields.multipleRelationshipField.changed()`	[]
isSelected()	`const singleRelId = relationshipFieldsForm.fields.singleRelationshipField.selected()[0].id() relationshipFieldsForm.fields.multipleRelationshipField.isSelected(singleRelId)` Note: This example checks to see if the item selected in the Single Relationship Field is also selected in the Multiple Relationship Field.	true
isValid()	`relationshipFieldsForm.fields.multipleRelationshipField.isValid()`	true
options()	`relationshipFieldsForm.fields.multipleRelationshipField.options()`	[Form 1, Form 2, Form 3, Form 4]
original()	`relationshipFieldsForm.fields.multipleRelationshipField.original()`	[Form 2, Form 1]
selected()	`relationshipFieldsForm.fields.multipleRelationshipField.selected()`	[Form 2, Form 1]
typeName()	`relationshipFieldsForm.fields.multipleRelationshipField.typeName()`	Bluestep.Relate.RelationshipField