View source for Repository pane

[[File:User_interface.png|thumb|[[BioUML web edition]] interface. Repository pane is marked as (A).]]
[[File:Workbench_user_interface.png|thumb|[[BioUML workbench]] interface. Repository pane is marked as (A).]]

'''Repository pane''' (or '''navigation pane''', or simply '''tree''') is the user interface element which is present both in [[BioUML workbench]] and [[BioUML web edition]] in the top left part of the window. It represents the hierarchical structure of the BioUML [[repository]]. Depending on BioUML installation and the current [[perspective]] it can include several tabs, each of them containing a tree of collections and elements. Typically, predefined [[databases]], user data, analysis methods and user lists for shared projects can be found under the tabs of the repository pane. When you select an element by a single mouse click, information about this element is displayed in the [[information box]] and the [[repository pane toolbar]] is updated reflecting the context actions available for the given element. The same context actions are available from the context menu upon a right mouse click. When you double-click on a tree element, the default action will be executed like opening the document.

==Navigating within the repository pane==
[[File:Expand_item.png|thumb|A part of the file tree showing an item (folder 'results') collapsed and expanded]]

Menu items containing one or more data elements (data collections) can be expanded/collapsed to show/hide their sublevels. Any such item, like a database, a folder, a track or a matrix library, has a white horizontal arrowhead to the left of its icon and name in the repository pane.

To expand an item
*click on the white arrowhead (the arrowhead will become black and downward),or
*click on the item name and then on the '''Expand/collapse''' icon in the [[repository pane toolbar]] above, or
*right-click on the item and select the '''Expand/collapse''' option from the context menu.

To collapse an item
*click on the black downward arrowhead next to the icon and name of the expanded item, or
*click on the item name and then on the '''Expand/collapse''' icon in the repository pane toolbar above, or
*right-click on the item and select the '''Expand/collapse''' option from the context menu
 
If the menu expands beyond the current visible area, use the horizontal and vertical scrollbars.

==Handling data elements==
When the mouse pointer hovers over a data element, the element name will gain a faint-bluish background. 

Upon a single click on the element name, its background will turn into a persistent light blue, and '''information about this file''' will be displayed in the property inspector tab of the [[information box]]. 

Double-clicking on the element name will '''open''' it under a new tab in the [[document pane]], and the its name will be emphasized in bold as long as the corresponding tab is in the document pane’s foreground. Only data elements with an icon attached can be opened this way.

Data elements can also be opened by:
*clicking on the item's name and pressing the '''Open...''' icon ([[File:WebAction-tree-open_web-icon.png]]) in the [[repository pane toolbar]], or 
*right-clicking on the name and selecting the '''Open...''' option ([[File:WebAction-tree-open_web-icon.png]]) from the context menu. 

Similarly, you can '''delete''' chosen elements by clicking on the '''Remove''' option ([[File:WebAction-tree-remove_element-icon.png]]) in the [[repository pane toolbar]] or the context menu.

{|
|style="width:70%; background-color: LightPink;" align="center"|
'''Attention! Deleted data elements and collections cannot be restored in BioUML! Please, be careful to avoid data loss'''
|}

Most files can be '''exported'''. When the function is activated, a selection of different formats is provided for the export file to be generated. It is also available through the icon [[File:WebAction-tree-export_element-icon.png]] in the [[repository pane toolbar]]
 
While the Open, Remove and Export options are present and work for nearly any file, the rest of the available operations is different among distinct file types.

==Selecting input files==
All analysis tools, and likewise all prepared workflows, require input data from a file in the [[repository pane]]. The respective file can be loaded into an analysis tool
*by simple drag-and-drop of the file from the repository area into the corresponding field in the document pane, or 
*by clicking into this field and making the selection from the directory which opens.

Multiple selections can be done only in the second way.

== See also ==
* [[BioUML user interface]]
* [[Element type]]
* [[:Category:Document types|Document type]]

[[Category:User interface]]