====== Proto ======

A Proto defines some type of [[protogrid:card|Card]] in your Application. A Proto can be seen as a template for Cards. Every proto has a name and a plural name for the [[protogrid:proto#Overview Proto|Overview Proto]]. The Proto defines the [[protogrid:field|fields]] and [[protogrid:widget|widgets]] on the card. In addition, one can specify [[protogrid:access_rights|access rights]] for all Cards based on this Proto and which [[protogrid:script_library#Server_ScriptLibrary|Server ScriptLibrary]] belongs to this Proto.

===== Comparison with relational databases =====
In relational databases, the data model is represented by the table schema. A table for "books" may define the attributes "ID", "name", "author", such that each data entry has to define a value for each of these attributes. In Protogrid, a Proto takes the role of the table in such a way that it defines the data schema for all cards which are based on this Proto.

===== Find the Proto Key =====
To get the Protokey of a Card, first open the relative Proto by clicking onto "This Card -> Open Proto" in the bottom left corner:

{{:protogrid:open_proto.png?nolink|}}

On the Proto Card you choose "This Card -> Show Properties":

{{:protogrid:show_properties.png?nolink|}}

In the opening Box, you find the Protokey labeled as "Card Key" (since it is also the key of the Card defining the Proto Definition):

{{:protogrid:protokey.png?nolink|}}

==== Overview Proto ====
An Overview Proto is automatically created on the creation of a new Proto. The Overview Proto only contains a [[protogrid:tableview|Tableview]], containing all the Cards of the created Proto.

==== Data Proto ====
Every Proto containing more than a TableView is called a Data Proto, since it also contains some information stored in the Card and not only an overview of all the Cards.