CurrentRecordIsUpdated (System function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
(Automatically generated page update)
 
(22 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>


This shared function returns a Boolean value that
===Syntax terms===
indicates whether the current record in the current
<table class="syntaxTable">
record-oriented loop has been updated in the current
<tr><th>%boolean</th><td>A <var>[[Boolean enumeration]]</var> value indicating whether the current record has been updated.</td></tr>
transaction.


The CurrentRecordIsUpdated method is available in ''Sirius Mods'' 7.7 and later.
<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>
===Syntax===
</table>
  %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==
===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===


The following request fragment sketches a record updating loop that reports to
==Example==
the audit trail if this is an initial update for each record in the transaction:
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:
<pre style="xmp">
<p class="code">%recs is object recordset in file myfile
    %recs is object recordset in file myfile
%rec is object record 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
</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>


    fd to %recs
{{Template:System:CurrentRecordIsUpdated footer}}
    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
</pre>

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.