===============
Using Workbench
===============

.. contents::
   :local:
   :depth: 1


Workbench is a file viewer and manager that includes a file editor and file
permissions manager.

You can use Workbench to:

* Upload and download files using the :ref:`File Manager <file-man>`.
* Create new files and folders using the :ref:`File Manager <file-man>`.
* Copy and move files to new locations using the :ref:`File Manager <file-man>`.
* Rename files and/or folders using the :ref:`File Manager <file-man>`.
* Manage the :ref:`access permissions <workbench-access-control>` of team members.
* Grant or revoke :ref:`access to non-team members <access-for-non-team-members>`.

Workbench also includes a simple Terminal application, which is convenient
because the File Manager is always visible, making navigation simple.

When you first open Workbench, the File Manager is displayed in the left pane,
and the Create a New File and Upload a New File buttons are in the right pane:

.. figure:: /img/aen-user-workbench_initialscreen.png
   :width: 50%

   ..

|

When you open a file or Workbench Terminal, it is displayed in the right pane.
To make the Create or Upload a file options re-appear, refresh your browser
window.

Two small icons are displayed in the black navigation bar at the top of the
Workbench page. Hovering over them displays tool tips that describe their use:

* The Toggle icon displays or hides the File Manager.
* The Terminal icon opens a simple terminal window.

Opening Workbench
=================

To open Workbench:

#. Log in to AEN.
#. Select the project you want to work on, or create a new project and open it.
#. On the project home page, click the Workbench icon:

   .. figure:: /img/aen-user-workbench_icon.png
      :width: 50%

      ..

   |

Workbench opens in a new browser window.

.. _file-man:

Using File Manager
==================

The File Manager is an intuitive way to interact with your files and folders.

Using the options drop-down menu
--------------------------------

To perform any of the actions described below:

#. Right-click on any folder to display the options drop-down menu.

#. Select one of the following options:

   * New File---Create and edit a new file.
   * New Folder---Create a new folder.
   * Upload File---Upload a file to the selected folder. You can also drag a file to the folder.
   * Permissions---:doc:`Control access to files and folders <../projects/control-access-to-project>`.
   * Cut---Cut the selected file or folder.
   * Copy---Copy the selected file or folder.
   * Paste---Paste a previously cut or copied file or folder.
   * Delete---Delete the highlighted file or folder.
   * Rename---Rename the highlighted file or folder.

.. figure:: /img/aen-user-workbench_dropdown.png
   :width: 50%

   ..

|


Editing files using the File Editor
-----------------------------------

#. Double-click any text file in the File Manager.

   The File Editor opens in the right pane:

   .. figure:: /img/aen-user-workbench_editor.png
      :width: 50%

      ..

   |

#. When you finish editing the file, click the Save button.

   NOTE: To close the file without saving, click the X at
   the top of the page under the file name.


.. _workbench-term:

Opening the Workbench terminal
==============================

In the navigation bar, click the Open terminal icon:

.. figure:: /img/aen-user-workbench_terminal.png
   :width: 50%

   ..

|

A Terminal---bash shell---is displayed in the right pane.

TIP: You can open additional terminals by clicking the Open terminal icon again,
or by clicking the Plus + icon at the top of an open terminal.

To move between terminal windows, click the **Terminal** tab in the navigation
bar, then select the number of the terminal window you want to work in.
