Fetch records

Fetch records

Note:

  • This task is applicable only to Zoho Creator.

Overview

The fetch record deluge task retrieves records from a specified form, when a given criteria is met.

The criteria is mandatory.

See this page to learn about fetching all values of a field in a collection.

See this page to learn about fetching a specified field's value from the first record in the collection.

Note:

  • The fetched records may appear to be sorted based on "added time" (oldest first) system field. However, there is no guarantee to this order and there is no guarantee that the order will remain constant over time. If you are particular about the sequence of the records, it is advisable to use the sort param.

Return

This task returns a collection of records.

Syntax

To fetch records which meet a criteria

<variable> = <form_link_name>[<criteria>];

To fetch records which meet a criteria, and sort them in ascending order based on a field

<variable> = <form_link_name>[<criteria>] sort by <field_link_name>;

To fetch records which meet a criteria, and sort them in descending order based on a field

<variable> = <form_link_name>[<criteria>] sort by <field_link_name> desc;

To fetch records within a specified range, which meet a criteria

<variable> = <form_link_name>[<criteria>] range from <start_index> to <end_index>;  

To fetch records within a specified range, which meet a criteria, and sort them in ascending order based on a field

<variable> = <form_link_name>[<criteria>] sort by <field_link_name> range from <start_index> to <end_index>;

To fetch records within a specified range, which meet a criteria, and sort them in descending order based on a field

<variable> = <form_link_name>[<criteria>] sort by <field_link_name> desc range from <start_index> to <end_index>;

ParameterDescription
<variable>

Collection variable holding the collection of records.

<form_link_name>

Link name of the form from which the records will be fetched.

<criteria>

Criteria based on which records will be fetched. 

sort by <field_link_name>

Link name of the field based on which records will be sorted.

range from <start_index> to <end_index>

Records falling in the specified index range will be fetched.

<start_index>

Start index of the range of records to be fetched. 

Both, 0 and 1 are considered as the first index number when used in <start_index> param.

<end_index>

Last index of the range of records to be fetched.

Negative index values will return an error during runtime.

Things to keep in mind

  • If you wish to fetch all records of the specified form, use the following script as criteria:
    [ID != 0]

    It is advisable to fetch all records only when absolutely needed. Fetching all records generates a load resulting in performance issues.
  • If you wish to use the "sort" and "range" parameters together, the "sort" parameter should be followed by the "range" parameter.

This task can be used in the following events

When a record is Created
On LoadYes
On ValidateYes
On SuccessYes
On User inputYes
Subform on add rowYes
Subform on delete rowYes
When a record is Created or Edited
On LoadYes
On ValidateYes
On SuccessYes
On User inputYes
Subform on add rowYes
Subform on delete rowYes
When a record is Edited
On LoadYes
On ValidateYes
On SuccessYes
On User inputYes
Subform on add rowYes
Subform on delete rowYes
When a record is Deleted
On ValidateYes
On SuccessYes
Other workflow events
On a scheduled dateYes
During approval processYes
During payment processYes
In a Custom FunctionYes
In an Action item in reportYes

Examples

1) The following script fetches all records which have the "age" field value as "25", from the Employees form.

EmployeeDetails = Employees [ age == "25" ];

2) The following script fetches all records which have the "name" field value as "Edward Thomas" or "Robert Frost", from the Poets_Form form.

poets = {"Edward Thomas", "Robert Frost"};
Poet_Details = Poets_Form [ name in poets ];

3)The following script fetches all records which have the "name" field value as "Jon Berryman". The name value is then updated to "John Berryman".

EmployeeDetails = Employee[name == "Jon Berryman"];
for each employee in EmployeeDetails
{
employee.name = "John Berryman" ;  
}

4) The following script fetches all records(because no record will have ID as 0) and sorts them by their Names. The Range is specified as 0 to 2, hence only the first 3 records will be fetched.

EmployeeDetails = Employee[ID != 0] sort by name range from 0 to 2;

Share this post : FacebookTwitter

Still can't find what you're looking for?

Write to us: support@zohodeluge.com