With the schema designer, the term "entity" is used to define a related set or table of data.
Having created fields, you now need to group them onto entities. To do this, use the New button in the definition library to create a new entity.
Like fields, entities can have names, references and descriptions. The entity reference will be used to build the target table name.
In the Field section, use the Field drop-down to select fields for your entity. Use Apply after selecting each one, to create a space for another field.
In the column marked Reference (# = key), put a # next to the fields that make up the unique key of the entity (the field or combination of fields that would uniquely identify the entity).
You can give fields a different reference, by entering the alternative reference in the Reference (# = key) column. If you want to change the name of a key fields, put the hash at the end of the reference, e.g. my_renamed_key#. These references, rather than the field references, will then be used for the fields in target data structures.
The entity contains other tabs and fields that are explained in later sections.
A version of the entity definition encoded as JavaScript Object Notation (JSON) is created as you maintain the entity. You can view this in the advanced tab, in the Node options field. This is the same as the entity mapping JSON in the Source definition JSON, except that it does not have the fields that start with "source". This can be useful for checking complicated entity definitions. You can also manually enter Node options - values you enter manually will override those derived from the entity definition.