CurrentRecordIsUpdated (System function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
(Automatically generated page update)
 
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<span style="font-size:120%; color:black"><b><section begin=dpl_desc/>Has record been updated?<section end=dpl_desc/></b></span>
{{Template:System:CurrentRecordIsUpdated subtitle}}
[[Category:System methods|CurrentRecordIsUpdated function]]
The <var>CurrentRecordIsUpdated</var> is shared function which returns a Boolean value that indicates whether the current record in the current record-oriented loop has been updated in the current transaction.
[[Category:System/Subsystem methods]]
 
<!--DPL?? Category:System methods|CurrentRecordIsUpdated function: Has record been updated?-->
==Syntax==
<p>
{{Template:System:CurrentRecordIsUpdated syntax}}
CurrentRecordIsUpdated is a member of the [[System class]].
 
</p>
===Syntax terms===
<table class="syntaxTable">
This shared function returns a Boolean value that
<tr><th>%boolean</th><td>A <var>[[Boolean enumeration]]</var> value indicating whether the current record has been updated.</td></tr>
indicates whether the current record in the current
 
record-oriented loop has been updated in the current
<tr><th><var class="nobr">%(System)</var></th><td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods|shared]] method.</td></tr>
transaction.
</table>
 
The CurrentRecordIsUpdated method is available in ''Sirius Mods'' 7.7 and later.
==Usage Notes==
===Syntax===
  %bool = %(system):CurrentRecordIsUpdated
====Syntax Terms====
<dl>
<dt><i><b>%bool</b></i>
<dd>The Boolean enumeration value indicating whether the current record
has been updated.
For more information about these enumerations, see [[Using Boolean enumerations]].
<dt>%(system)
<dd>The class name in parentheses denotes a shared method.
</dl>
===Usage Notes===
<ul>
<ul>
<li>[[RecordIsUpdated (System function)|RecordIsUpdated]] reports whether a record
<li><var>CurrentRecordIsUpdated</var> is available in <var class="product">[[Sirius Mods|Sirius Mods]]</var> Version 7.7 and later.
you identify by filename and record number
has been updated within the current transaction.
</ul>
</ul>
===Example===
 
==Example==
The following request fragment sketches a record updating loop that reports to
The following request fragment sketches a record updating loop that reports to the audit trail if this is an initial update for each record in the transaction:
the audit trail if this is an initial update for each record in the transaction:
<p class="code">%recs is object recordset in file myfile
<p class="code"><nowiki>%recs is object recordset in file myfile
%rec is object record in file myfile
%rec is object record in file myfile
   
   
Line 41: Line 25:
end find
end find
for each record in %recs
for each record in %recs
  %rec = CurrentRecord
  %rec = CurrentRecord
  if %(system):currentRecordIsUpdated ne true then
  if %(system):currentRecordIsUpdated ne true then
    Audit 'First update of Record num: ' %rec:RecordNumber
      audit 'First update of Record num: ' %rec:RecordNumber
  end if
  end if
  ...
  ...
end for
end for
</nowiki></p>
</p>
 
==See also==
<ul>
<li><var>[[RecordIsUpdated (System function)|RecordIsUpdated]]</var> reports whether a record you identify by filename and record number has been updated within the current transaction.
 
<li><var>[[IsUpdated (Record function)|IsUpdated]]</var> reports whether a record referenced by a <var>[[Record class|Record]]</var> object has been updated within the current transaction.
</ul>
 
{{Template:System:CurrentRecordIsUpdated footer}}

Latest revision as of 00:26, 16 February 2014

Is the current record updated? (System class)

[Introduced in Sirius Mods 7.7]

The CurrentRecordIsUpdated is shared function which returns a Boolean value that indicates whether the current record in the current record-oriented loop has been updated in the current transaction.

Syntax

%boolean = %(System):CurrentRecordIsUpdated

Syntax terms

%booleanA Boolean enumeration value indicating whether the current record has been updated.
%(System)The class name in parentheses denotes a shared method.

Usage Notes

  • CurrentRecordIsUpdated is available in Sirius Mods Version 7.7 and later.

Example

The following request fragment sketches a record updating loop that reports to the audit trail if this is an initial update for each record in the transaction:

%recs is object recordset in file myfile %rec is object record in file myfile fd to %recs end find for each record in %recs %rec = CurrentRecord if %(system):currentRecordIsUpdated ne true then audit 'First update of Record num: ' %rec:RecordNumber end if ... end for

See also

  • RecordIsUpdated reports whether a record you identify by filename and record number has been updated within the current transaction.
  • IsUpdated reports whether a record referenced by a Record object has been updated within the current transaction.