== Entity Directory Interface ==

The web interface leverages the Freemarker template engine and allows users to access the ED main functionalities. 

[[PageOutline(3-4,Table of Contents,inline)]]

=== Index Page ===

From the index page at http://host:port/eoi/, you can select the functionality you want to access from the top menu.

[[Image(wiki:ED:EDIndex.jpg)]]

=== Browse Bindings ===

From this page you can see the list of Bindings that are currently registered in the ED.

[[Image(wiki:ED:EDBrowse.jpg)]]

=== Browse Entities ===

From this page you can see the list of Entities of Interest that are currently registered in the ED.

[[Image(wiki:ED:EDEntities.jpg)]]


=== Register a new Binding ===

From this page you can register a new Binding in the ED. The binding XML Stream has to satisfy the schema specified at [https://ncit-cluster.grid.pub.ro/trac/Sensei-Cookbook/attachment/wiki/ED/binding.xsd], the server returns an error otherwise.

[[Image(wiki:ED:EDRegister.jpg)]]

=== Lookup Bindings === 

From this page you can lookup the entries within the ED. You can do so either by using the form for simple queries or an XML Stream for complex ones.

For a simple query, a validation process takes place on the server side to verify that the following set of rules is satisfied.

The four first fields i.e. ID, ResourceID, Operation, ObservationArea do not have any specific requirements.

When one of the fields EoI, Attribute, EntityType, Value, QoA, QoI, Cost, an IOPEType has to be specified. As a matter of fact this part of the lookup will try to identify tuples of parameters e.g. (EoI, EntityType) when an EoI and an EntityType are specified that belongs to the same type of IOPE, for instance Input. The IOPEType parameter can take a value in the set {Input, Output, PreCondition, PostCondition, any}. The GUI returns a set of bindings matching the request.

For a complex query, the Template has to match the schema specified at [https://ncit-cluster.grid.pub.ro/trac/Sensei-Cookbook/attachment/wiki/ED/binding.xsd], the server returns an error otherwise. 

[[Image(wiki:ED:EDLookup.jpg)]]

=== Subscribe to Bindings ===

From this page you can create a subscription to receive a notification whenever a binding relevant to your subscription has been added or modified. You can do so by using a simple form or an XML Stream. The subscriptions in both cases follow the same validity rules as for the Lookup queries as they rely on the same match making algorithm. In addition, a callback URL is required.

[[Image(wiki:ED:EDSubscribe.jpg)]]

----