Clarion Community Help

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
| **Navigation:**  [[abc library reference.htm|ABC Library Reference]] > ProcessClass > ProcessClass Methods >====== TakeRecord (process each record read){{c6h0009.jpg|C6H0009.jpg}} ====== | [[takelocate a virtual to process each filter .htm|{{btn_prev_n.gif|Previous page}}]][[abc library reference.htm|{{btn_home_n.gif|Return to chapter overview}}]][[queryclass.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**TakeRecord, VIRTUAL, PROC**

{{blk2blue.jpg|blk2blue.jpg}}

The **TakeRecord **method is a virtual placeholder to process each record in the result set. It returns a value indicating whether processing should continue or should stop. TakeRecord returns //Level:Benign// to indicate processing should continue normally; it returns //Level:Notify// to indicate processing is completed and should stop. The user can also force the method to return //Level:Fatal//, which will stop the process and close the active window.

**Member of: [[processclass methods.htm|ProcessClass]]**

**Implementation:**

The ProcessClass.TakeRecord method is called to process each record. For a report procedure, the TakeRecord method typically implements any DETAIL specific filters and PRINTs the unfiltered DETAILs for the ReportManager. For a process procedure, the TakeRecord method typically implements any needed record action for the Process.

The difference between using the ProcessClass.TakeRecord method in a report procedure compared with a process procedure is that the report has a PRINT call in the method.

Any activity related to records processed needs to be done using this method.

**Return Data Type:     **BYTE

**Examples:**

**!In a Report Procedure:**

**ThisReport.TakeRecord PROCEDURE**

**ReturnValue          BYTE,AUTO**

**SkipDetails BYTE**

**  CODE**

**  ! Activity for each processed record (PRINT)**

**  ! Parent Call**

**  ReturnValue = PARENT.TakeRecord()**

**  PRINT(RPT:detail)**

**  RETURN ReturnValue**

**!In a Process Procedure:**

**ThisProcess.TakeRecord PROCEDURE**

**ReturnValue          BYTE,AUTO**

**  CODE**

**  ! Activity for each processed record**

**  ! Parent Call**

**  ReturnValue = PARENT.TakeRecord()**

**  !Execute any record work needed**

**  RETURN ReturnValue**

**See Also:     ** [[multiple customizable levels of error treatment.htm|Multiple Customizable Levels of Error Treatment]]