| Tag Link | [Column] | Category | Database |
|---|---|---|---|
| Type | Substitution | Source Available | No |
| Support | Synonym | Version | 3.0 |
| Change | Unchanged | Data Source | Any |
| Output Type | String, Decimal, or Integer | Security | None |
| Implementation | LCAPI | Sets | Lasso 8.5, Lasso 8.0, Lasso 7.0, Lasso 6.0, Lasso 5.0, Lasso 3.x |
[Column] returns the value for a field from the current database search. This tag can be used within [Inline] ... [/Inline] tags that return a database found set or on the response page for a Classic Lasso database action that returns a found set.
The name of the field specified in the [Column] tag must be defined in the current found set. If it is not then a syntax error will be reported.
Normally, the [Column] tag is used within [Records] ... [/Records] tags to return the field value from each record in the found set in turn. It can also be used outside of [Records] ... [/Records] tags to return the field value from the first record in the found set (useful if there is only one record in the found set).
The
For FileMaker Pro databases, related field values can be returned by specifying the name of the relation followed by two colons and the name of the field, e.g. relation::fieldname. The related field value must be included in the current layout.
By using the [Portal] ... [/Portal] tags each row in a portal on the current layout can be returned in turn. The
[Column: 'Field_Name']
[Records]
[Column: 'Field_Name']
[/Records]
[Records:
[Column: 'Field_Name']
[/Records]
[Column: 'Field_Name',
[Column: 'Relation_Name::Field_Name']
[Portal: 'Relation Name']
[Column: 'Relation_Name::Field_Name']
[/Portal]
[Column: 'Relation_Name::Field_Name',
| Required Parameters | |
|---|---|
| Field_Name | The name of the field whose value should be returned. |
| Optional Parameters | |
| -RecordIndex | If specified, the value for the field from the specified record from the current found set is returned. |
| -PortalIndex | Can be used for fields which are included in a portal in the current layout in a FileMaker Pro database. The value for the specified field from this row of the portal is returned. |
| Encoding Keyword | Specifies the encoding for the tag's return value. Tags are encoded using |
To return field values from a search:
Use a [Column] tag for each field within [Records] ... [/Records] tag. The following example finds all records in the People table of the Contacts database and returns the First_Name and Last_Name fields for each record in the found set.
[Inline:
[Records]
<br>[Column: 'First_Name'] [Column: 'Last_Name']
[/Records]
[/Inline]
<br>John Doe
<br>Jane Doe
<br>John Surname
<br>Betty Lastname