ODB Page: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
mNo edit summary
(The midas documentation has moved to https://midas.triumf.ca/docs/)
Tag: Replaced
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Pagelinks}}
The midas documentation has moved. See [https://midas.triumf.ca/docs/develop/reference/reference/web_pages/#odb-page ODB page] in Built-in web pages and [https://midas.triumf.ca/docs/develop/features/core_system/odb/#web-interface Web interface] in ODB: overview for the new documentation about the ODB web page.
 
= Links =
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* [[Mhttpd|mhttpd MIDAS web server]]
* [[Status Page]]
* [[Message Page]]
* [[ODB Page]]
* [[Programs Page]]
* [[Alarms Page]]
* [[MSCB Page]]
* [[History Page]]
* [[Custom Page]]
* [[Sequencer Page]]
* [[odbedit]]
</div>
 
= Purpose =
The purpose of the [[mhttpd]] ODB page is to allow the user to browse, search and edit the ODB of an experiment.
This gives a graphical alternative to using the ODB editor [[odbedit]].
 
= Access the ODB page =
Click image(s) to enlarge
<br>
[[File:odb_page.png|thumb|left|Figure 1: ODB Page example]]
The ODB Page is accessed from the [[Status Page]] (or one of the other Pages) by clicking on the
menu-button{{Button|name=ODB}}.
 
The top level ODB trees will be visible as key-links (i.e.links to a key) ([[#Example ODB Page|Figure 1]]).
 
;Note
:If "ODB" button is not present on the Status Page, it may have been [[Status Page#page-switch-buttons|suppressed]].
 
 
<div style="clear: both"></div>
 
= Browse the ODB =
<div id="Figure 2"></div>
[[File:odb_page_list.png|thumb|left|Figure 2: ODB Page Listing]]
By clicking on the key-links on the ODB page ([[#Example ODB Page|Figure 1]]), the user can browse the various subtrees. By clicking on the "+" link adjacent to the "Value" heading ([[#Figure 2|Figure 2]]) , the type and size of the keys are shown. This is equivalent to the [[odbedit]] commands <span style="color:saddlebrown; ">ls</span> and <span style="color:saddlebrown;">ls -l</span>.
 
 
<br clear=all>
 
By clicking on a key, the user can change the value (unless password-protected or the key is write-protected - see [[Security]]). If web access is restricted, the user will be asked for a password the first time he/she attempts to edit a value.
 
= Create a key =
<div id="Figure 3"></div>
[[File:odb_page_create.png|thumb|left|Figure 3: ODB page Create a key]]
 
The user can create a new key in a tree or subtree by clicking the
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em;
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Create</span> button. The '''Type''' of key to be created is selected from the drop-down list ([[#Figure 3|Figure 3]]). The choices are:
{|  style="text-align: left; width: 25%; background-color: rgb(grey); font-size:75%" border="1" cellpadding="1" cellspacing="1"
|-
| colspan="2" rowspan="1" style="vertical-align: top; background-color: lightgrey; font-weight: bold;" | Key Types
|-
| Integer(32-bit)
| Float (4 bytes)
|-
| String
| Multi-line String
|-
| Subdirectory
| Byte
|-
| Signed byte
| Character (8-bit)
|-
| Word (16-bit)
| Short integer(16-bit)
|-
| Double Word (32-bit)
| Boolean
|-
| Double float(8 Bytes)
| Symbolic link
|}
<br clear=all>
= Delete a key =
 
<div id="Figure 4"></div>
[[File:odb_page_delete.png|thumb|left|Figure 4: ODB page Delete a key]]
The user can delete a key in a tree or subtree by clicking the
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em;
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Delete</span> button. The user selects which to delete from a list of the keys in the subtree (e.g. Figure 4).
 
 
<br clear=all>
= Search the ODB for a key =
[[File:odb_page_find.png|thumb|left|Figure 5: ODB Page Find pop-up]]
Click on the
<span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em;
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Find</span>
button. A pop-up (Figure 5) appears in which the user types the relevant information.
 
 
 
<br clear=all>
 
= Create Elog entry =
[[File:odb_page_elog.png|thumb|left|Figure 6: ODB Page Elog pop-up]]
An elog entry can be created easily from the ODB page by clicking the  <span style="color: #444444; background-color: #CCCCCC; font-style:italic; font-size: 90; padding:0.25em;
padding-left: 0.5em;padding-right: 0.5em;border:1px solid #808080;border-radius: 5px;margin-bottom:1px;">Create Elog from this page</span> button. A pop-up will appear for the user to fill in (Figure 6).
 
<br clear=all>
 
= Limitations =
The ODB Page editor supports a subset of the functionality of [[odbedit]]. For example, the ODB Page editor does not support re-ordering or renaming ODB keys. For full editing capabilities  [[odbedit]] must be used. 
 
[[Category:mhttpd]]
[[Category:ODB]]

Latest revision as of 22:01, 30 October 2026

The midas documentation has moved. See ODB page in Built-in web pages and Web interface in ODB: overview for the new documentation about the ODB web page.