..	*******************************************************************************
	* MetaFactory.io R2
	* Technical Documentation
	* 
	* File name   : ModRef_attribute.rst
	* Created by  : Marnix Bochove (original text)
	* Last update : 23-03-2021
	* Updated by  : Niels de Nies
	*
	* MetaFactory BV Amsterdam 
	*******************************************************************************

.. include:: /inline-images.txt
.. include:: /metadata_include.txt

Attribute
=========

<attribute> is a sub element of :ref:`<object> <Reference/ModelReference/ModRef_Object:Object>`.
<attribute> defines the attributes belonging to the scope of the parent object in the model.

Inside this object scope the name of the attribute has to be unique.
An object can contain any number of attributes.
If the object for which the attributes are defined has properties then the attributes have to be placed after the properties.


.. code-block:: xml
	:caption: <attribute/> example
	:name: MR-attribute
	:linenos:
	:emphasize-lines: 9

	<model>
		...

		<package name="yourModelPackage">
			...
			<object name="yourObjectName01">
				...
				
				0 or more <attribute name="yourAttribute01" type="string" notnull="false"></attribute>
			</object>
			...
		</package>
		
		...
	</model>


.. rubric:: Syntax

.. code-block:: xml

	<attribute name=”” type=”” length=”” notnull=””> </attribute>


.. rubric:: Attributes

..	list-table:: **attributes of <attribute>** you like the name?
	:widths: 15 70 15
	:header-rows: 1
	:class: tight-table

	*	-	Name
		-	Details
		-	Required
	*	-	name
		-	The attribute name has to be unique within the scope of the object.
		-	mandatory
	*	-	type
		-	Data type of this attribute: [String, integer, Integer, boolean, Boolean, void, Date, DateTime, long, Long, double, 
			Double, blob, clob, short, Short, float, Float, big_decimal, character, byte, Byte, yes_no, time, timestamp, calendar, calendar_date, binary, text]
		-	mandatory
	*	-	length
		-	|Question S|
		-	optional
	*	-	notnull
		-	This flag attribute tells whether its attribute property is allowed to be undefined (notnull=’FALSE”) or not (notnull=”TRUE”).
			This attribute defaults to notnull=”FALSE”
		-	optional

.. rubric:: Sub elements

..	list-table:: **sub elements of <attribute>**
	:widths: 15 70 15
	:header-rows: 1
	:class: tight-table

	*	-	Name
		-	Details
		-	Number
	*	-	:ref:`metadata <Reference/ModelReference/ModRef_Metadata:Metadata>`
		-	With metadata the code instruction logic can make decisions. The logic can also add metadata itself.
		-	0 .. n