Tree editor

From AMTech WikiDocs
Jump to: navigation, search

DAP Resources

  • The three editor allows to maintain the DAP resources and their relationships
IoT DAP Resources

Edition

  • The navigation through resources properties and their relations is done with the "tree editor" allowing users to move from branches and edit, create or delete resource's properties or relations
Tree Editor
  • The tree editor has a cohesive experience to edit, filter and navigate the resources.
  • Edit options

Once in a collection of resources, for instance, a specific collection of things instances, resource can be selected, and options for create/update/delete will be shown according to the access control of the user

  • Create or Clone Ue-create.png, Delete Ue-delete.png, Update Ue-save.png

Delete and Clone require the resource to be selected in the collection

Access Control

  • CRUD operations are controlled by access control policies, green padlock full access, red padlock read only
Access control
  • This criterion can be used to filter the resources (See Filter)

Pagination

Allows to display a limit number of resources and divide large collection of resources on multiples pages.

Pagination
  • << first page
  • < previous page
  • > next page
  • amount of resources to show per page (maximun 100)
  • amount of resources showed

Navigation

  • Goto Goto-branch.png, and back Ue-bc.png
  • Activity graphical browser Btn-activityGraphicalBrowser.png allows to navigate activity tree faster
Activity graphical browser

Filter

It is possible to filter the resource shown in the editor by defining some basic criteria according their types. Those search options are organized in three groups: resource fields, ownership and location in the current view of the map.

All the filter options explained here will be merged to make the requests. Also, they are kept in memory so they are reused for the same urls until they are deactivated or removed using the floating menu buttons.

Use observers for more advanced resource filtering functionalities, including geo-spatial, proximity and resource's semantics.

Resource field search options

The button SimpleSearch.png opens a dialog where the user can set the criteria he wants to use.

Filter dialog

The shown options will depend on the type of the resources and include

  • Name and description
  • Subject and body
  • Observation types
  • Resource status
  • Observation and notification date

Once the desired options are set, clicking on SimpleSearch.png on top of the dialog will launch the search and update the editor. Click on CloseDialog.png to close the dialog and nothing will be changed.

After running the search, this filters will be kept each time user navigates on that url. You can change the options by opening the dialog again and make the modifications, but if you want to remove all those filters you need to click on ActiveFilter.png in the floating menu in the bottom of the screen (see UE).

Ownership filter

It is possible to retrieve only the owned resources. The button OwnedFiltered.png at the right of the search button (see above) means that only the owned resources will be shown while OwnedUnfiltered.png will show all the accessible resources. Check or uncheck the box to toggle the filter. This filter will appear while navigating on things and observations instances and notifications. Users with Creator rights will also be able to use this filter on observation and thing types, and while navigating the list of root Topics.

Note: Do not forget to refresh RefreshButton.png so this selection is taken into account

Map viewbox filter

When navigating things, it is possible to constrain the search to those that are inside the region selected in the map.

  1. Click on ViewboxMapFilter off.png to activate selection (right side of the map).
  2. Pane and zoom your map until it shows the desired region.
  3. Deactivate selection clicking on ViewboxMapFilter on.png (right side of the map) to ensure that the chosen region will not change because of an undesired pane or zoom on the map.
  4. refresh the editor RefreshButton.png

As result, only the things with a location intercepting the area chosen above will be shown. Also, the button ActiveMapFilter.png will appear in the floating menu. Use this button to remove this spatial constraint.

Jsonld

  • View Jsonld,Ue-view-jsonld.png
Jsonls viewer
  • Links to related resources, T3-showlinks.png
Show links
  • Download Jsonld file, Te-dowloadjsonld.png

Resources status

When a thing instance does not meet the requirements imposed by the semantic of the type a red broken chain appears at the far right of the the resource row, if one is clicked detailed description of the state of the resource appears in a floating window. (See IoT Semantics)

Resource status
This criteria can be use to filter the resources (See Filter).

Operation results

When an operation is successfully executed a blue box appears in the upper right corner, the box disappears automatically after a few seconds

Ok

Errors

When an operation fails a red curtain on the top edge of the page appears with a detailed description of the problem. The information will remain until the user closes the curtain using the button on the upper corner.

Error information
Some operations fail partially, in these cases the Tree does not refresh the list of resources.