Editing EPrints 3 Organisation Hierarchy (section)

== The Subjects File explained ==

Imagine your organisation looks like this:

* Acme Research Corporation
** Rocket Group
*** Solid Fuel Rockets Department
*** Liquid Fuel Rockets Department
** Spring Group
*** Large Spring Department
*** Huge Spring Department

You need to create a machine-readable representation of this.

Each hierarchy starts with a root:
 acme_division:Acme Research Corporation:ROOT:0
This tells EPrints that the top (or root) of the hierarchy (or tree) has a system name of acme_division, a human readable name of "Acme Research Corporation", is the root, and is not selectable.

Now we can add the groups:
 rockets:Rocket Group:acme_division:0
 springs:Spring Group:acme_division:0
This defines our two groups, and also defines the parent of them.  We've also chosen not to make these selectable, but you could if you wanted to.

Finally, we add the departments
 solid_fuel_rockets:Solid Fuel Rockets Department:rockets:1
 liquid_fuel_rockets:Liquid Fuel Rockets Department:rockets:1
 large_springs:Large Spring Department:springs:1
 huge_springs:Huge Sprint Department:springs:1

Generically, each line in the file is defined like this:
 <system name>:<human readable name>:<parent's system name>:<selectable (0 or 1)>
<strong>Important</strong>: it's essential that every system name in the subjects file is unique across the whole file, otherwise nodes will appear in the wrong trees.