O modelo de dados ou Model representa a estrutura de dados. É através do Model que você faz consultas, alterações, inserções e exclusões de registros no banco de dados.
O Zeanwork auxilia você com essas tarefas sem que você precise escrever uma única linha de código SQL. Todos os dados e condições a serem enviados ao banco são montados através de arrays simples ou métodos do Zeanwork, sem que você precise de grandes conhecimentos de SQL.



Como você deve ter visto na estrutura do Zeanwork, temos um diretório somente para armazenar os arquivos dos models, é localizado em App/Models/. Você também deve ter visto os padrões do Zeanwork, o nome do arquivo deve ser no padrão lowerCamelCase, seguindo com a extensão .php. Por exemplo: nomeDoModel.php.

Todo model deve ser uma classe, portando o nome da classe deve corresponder o nome do arquivo criado. Por exemplo: Você criou um arquivo chamado nomeDoModel.php, o nome da classe deve ser NomeDoModel, seguindo o padrão CamelCase.
Todos os models devem ser estendidos da classe AppModel, pois o seu model deve herdar os métodos do Zeanwork. Se você desejar criar métodos que serão utilizados em alguns dos seus models, você deve recriar o model AppModel no mesmo local dos models comuns, este model deverá ser estentido da classe Model.

Veja exemplo de um model comun:

class Posts extends AppModel {
}

Veja exemplo do AppModel:

class AppModel extends Model {
}

Como uma das funcionalidades dos models é executar operações em um banco de dados, nós devemos definir a perspectiva tabela que pertence este model e sua chave primária. Para esta tarefa nós devemos utilizar as seguintes variáveis da classe Model: Model::$table e Model:$primaryKey.

Veja exemplo:

class Posts extends AppModel {
   public $table = 'posts';
   public $primaryKey = 'idPosts';
}

Estes parâmetros servem para configurar suas querys nas consultas, inserções, alterações e exclusões de dados, você deve avaliar o que irá solucionar o seu problema e assim utilizalas.

Veja quais parâmetros estão disponíveis.

Nome do parâmetro:	Informações:
conditions	array Serve para criar uma condição (where). Veja mais em: Models >> Condições
fields	array | string Define quais campos retornará de uma consulta.
data	array Define valores para uma inserções ou alteração.
join	array Define um join.
innerJoin	array Define um inner join.
leftJoin	array Define um left join.
rightJoin	array Define um right join.
orderBy	string Define uma ordem.
groupBy	array | string Define campos para serem agrupados.
limit	string Define um limite.
keyResult	string Define a chave da array do resultado, deve ser o nome de um campo da tabela.

Veja exemplo:

$this->posts->read(array(
		  'fields' => array('name', 'users.name as nameUser')
		, 'join' => array('users' => array('users.idUsers' => 'posts.idPosts'))
		, 'conditions' => array('users.created <' => now())
		, 'groupBy' => 'name'
		, 'limit' => 20
		)
      );

Query montada pelo Zeanwork:

SELECT name, users.name as nameUser FROM posts JOIN users ON users.idUsers = posts.idPosts WHERE users.created < '2010-07-13 17:21:30' GROUP BY name LIMIT 20

Temos várias maneiras de buscar registros de um banco de dados, você pode utilizar a que for mais adequada para você ou para solucionar o seu problema da melhor forma possivel.

Veja os métodos disponiveis:



Veja os métodos disponíveis para inserir registros no banco de dados.



Veja os métodos disponíveis para alterar registros de um banco de dados.



Veja os métodos disponíveis para deletar registros de um banco de dados.



O Zeanwork possui um método automático que salva dados em uma tabela, tanto para uma alteração quanto para uma inserção.

Os dados são resgatados automáticamente do form pelo método post, o Zeanwork identifica os campos que existem em sua tabela e os que existem no form, com isso ele sabe quais dados serão alterados ou inseridos.
Para que o Zeanwork idendifique qual campo do seu form corresponde ao campo da tabela, você deve criar as tags do form com o name igual ao nome do campo correspondente da tabela.
Para o Zeanwork saber se será uma alteração ou uma inserção, ele verifica se foi informado um valor para a chave primária da tabela e se existir o registro na tabela, o Zeanwork fará uma alteração neste registro, caso contrário fará uma inserção.
O Zeanwork também verifica se existe os campos created e modified, estes campos servirão para salvar a data da alteração ou inserção do registro, estes campos devem ser do tipo datetime ou date.
O Zeanwork também executa a validação automáticamente antes de salvar os dados, em caso de erro ele não salvará.




O Zeanwork possui um método que facilita a contagem de registros de um banco de dados.



Em certos casos precisamos verificar se existe um determinado registro em uma tabela, por isso temos esse método.



Em aplicações mais complexas, é comum haver querys que o Zeanwork não venha atender ou o tempo de execução é muito alto, então você tem essa opção de executar manualmente as instruções SQL’s.




Existe uma opção de configurar parâmetros padrões para as instruções realizadas apartir dos métodos do model.