CurrentRecordId (Record function): Difference between revisions
Jump to navigation
Jump to search
(Automatically generated page update) |
No edit summary |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{Template:Record:CurrentRecordId subtitle}} | {{Template:Record:CurrentRecordId subtitle}} | ||
Get the <var class="product">Imagine Transparency</var> recordId for current (innermost) record <var>For</var> loop. | |||
==Syntax== | ==Syntax== | ||
{{Template:Record:CurrentRecordId syntax}} | {{Template:Record:CurrentRecordId syntax}} | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th>%string</th><td>string</td></tr> | <tr><th>%string</th><td>The recordId of the <var>For</var> loop record on <var class="product">Imagine</var> if the record is in a file that is an <var class="product">Imagine Transparency</var> file, or an empty string, otherwise.</td></tr> | ||
<tr><th nowrap="true"><var>%(Record In </var>filOrGrp name<var>)</var></th> | <tr><th nowrap="true"><var>%(Record In </var>filOrGrp name<var>)</var></th> | ||
<td>The class name in parentheses denotes a shared method. <var>CurrentRecordId</var> can also be invoked via a <var>Record</var> object variable, which may be <var>Null</var>.</td></tr> | <td>The class name in parentheses denotes a shared method. <var>CurrentRecordId</var> can also be invoked via a <var>Record</var> object variable, which may be <var>Null</var>.</td></tr> | ||
</table> | </table> | ||
==Usage notes== | ==Usage notes== | ||
<p> | |||
The recordId for <var class="product">Imagine</var> associated records is an 8-byte binary string value. This can be used to create another <var>Record</var> object with the [[NewFromRecordId (Record function)|NewFromRecordId]] function though there is really no good reason to create another <var>Record</var> object this way, or it could be passed to the <var class="product">Imagine</var> broker, probably after converting it to hex. Note, however, that while recordIds uniquely identify any record in <var class="product">Imagine</var>, <var class="product">Imagine</var> still needs to know the <var class="product">Imagine</var> file that holds the record to locate it. This can be obtained using the [[CurrentImagineFile (Record function)|CurrentImagineFile]] method. | |||
</p> | |||
==Examples== | ==Examples== | ||
==See also== | ==See also== | ||
{{Template:Record:CurrentRecordId footer}} | {{Template:Record:CurrentRecordId footer}} | ||
Latest revision as of 21:35, 28 March 2025
Get recordId from current record in For loop (Record class)
Get the Imagine Transparency recordId for current (innermost) record For loop.
Syntax
%string = %(Record In filOrGrp name):CurrentRecordId
Syntax terms
| %string | The recordId of the For loop record on Imagine if the record is in a file that is an Imagine Transparency file, or an empty string, otherwise. |
|---|---|
| %(Record In filOrGrp name) | The class name in parentheses denotes a shared method. CurrentRecordId can also be invoked via a Record object variable, which may be Null. |
Usage notes
The recordId for Imagine associated records is an 8-byte binary string value. This can be used to create another Record object with the NewFromRecordId function though there is really no good reason to create another Record object this way, or it could be passed to the Imagine broker, probably after converting it to hex. Note, however, that while recordIds uniquely identify any record in Imagine, Imagine still needs to know the Imagine file that holds the record to locate it. This can be obtained using the CurrentImagineFile method.