..	*******************************************************************************
	* MetaFactory.io R2
	* Technical Documentation
	* 
	* File name   : ModRef_Object.rst
	* Created by  : Marnix Bochove (original text)
	*
	* MetaFactory BV Amsterdam 
	*******************************************************************************

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

Object
======

The element <object> defines a data entity in the data model and lives within the scope its parent package.
The model can potentially contain a multitude of packages, each with their set of child objects.
The objects can be equipped with attributes that refer to standard Java types such as String, Boolean, LocalDate etc., 
while references point to other objects that are defined in the same model package.
Like its parent package and children attributes/references, an object can contain metadata that patterns can use in their logic.

An example is shown below.


.. code-block:: xml
	:caption: <Object> example
	:name: MR-Object
	:linenos:

	<model>
		...
		<package name="yourModelPackage">
			...
			<object name="yourObjectName01">
				0 or more <properties></properties>
				0 or more <reference name="yourReferenceName" type="typeOfYourReference" multiplicity="0..n"></reference>
				0 or more <attribute name="yourAttribute01"></attribute>
				...
			</object>
			...
		</package>
		...
	</model>

.. rubric:: Object Attributes

..	list-table:: **attributes of <Object/>**
	:widths: 15 70 15
	:header-rows: 1
	:class: tight-table

	*	-	Name
		-	Details
		-	Required
	*	-	name
		-	Name of the object in the package “yourModelPackage” of the MetaFactory model (model.xml).
			This name “yourObjectName01” has to be unique.
		-	Mandatory

.. rubric:: Object Sub elements


..	list-table:: <Object/> sub elements
	:widths: 15 70 15
	:header-rows: 1
	:class: tight-table

	*	-	Name
		-	Details
		-	Number
	*	-	:ref:`metadata <Reference/ModelReference/ModRef_Metadata:Metadata>`
		-	With the metadata of an object the code instruction logic can make decisions or it can itself add metadata to the object.
		-	0 .. n
	*	-	:ref:`reference <Reference/ModelReference/ModRef_Reference:Reference>`
		-	The reference points to another object and specifies the type of relationship with that object (e.g. notnull and multiplicity)
		-	0 .. n
	*	-	:ref:`attribute <Reference/ModelReference/ModRef_Attribute:Attribute>`
		-	Attributes refer to standard object types, e.g. String, Boolean, LocalDate etc.
		-	0 .. n