Comparing version 7 and version 6

h3. Simple examples

h4. Query all records of a given model



  
    , 
    , 
     

  



h4. Simple search with conditions



  
    
      , 
      , 
       

    
    Number of records returned: 
  



h3. Summary of the tags shown

h4. model tag

Attribute:
* *name*: (required) specify model name here

h4. model:find tag

There are two main operation modes for model:find:

* if *id* attribute was given that it returns the record with the given id
* if no *id* was specified than a group of records will be returned

Either modes support the same tags.

* *limit*, *order*, *conditions* attributes will be passed to Model.find(...)

If *distinct* attribute was given than the following query will run: SELECT DISTINCT(*distinct*) FROM model WHERE *conditions* etc...

Furthermore, there is a special page type called *Filter* that may give further filtering conditions. More on that later. 

h3. Functions that may be called on the returned data

What described above is very basic, but real life may require more complex calculations. To support that model_tags gives you several possibilities:

* You may create class funcions (methods) that may be called using a special tag *function*
* You may create entity functions (methods) that may be called on the result records

This leads to potential secutity issues, that will be addressed in a very basic fashion. Now lets see this in action.

h4. Class functions

First you need to create a class function like this:


class Product < ActiveRecord::Base

  def self.myfunction
    "returned value"
  end

  def self.otherfunction
    ["value1","value2"]
  end

  def self.thirdfunction
    { :key => :value, :key2 => :value2 } 
  end

  def self.fourthfunction
    Product.find(...whatever...)
  end

  def self.function_is_allowed_to?(fun,user)
    ['myfunction','otherfunction','thirdfunction', 'fourthfunction'].include?(fun)
  end

end

Back to Page