GFFS GUI Help Page

GUI Orientation


The GUI is divided into three panels: the Directory Panel, the Properties Panel, and the Message Panel.

The left column is the Directory Panel. It shows the top of the GFFS file tree (/). You can expand those directories on which you have read permission, and see nested files/directories therein. Double-clicking on a file for which you have read permission will copy it to your local machine and open it with the associated application. In the upper right corner, the tear-off button allows you to duplicate the Directory Panel in a new window.

The right panel, divided into three tabs, is the Properties Panel. The above screenshot shows the Security Tab, which details the permissions of the selected directory or file (provided you have permission to read permissions). For information on the other tabs (Resource Properties and EPR Display) see here .

The lower panel is the Message Panel. Errors and warnings will appear in here. Double-clicking on a message will give you more details (if available).

Where Are My Files Located?

Mapped versus unmapped resources. It is useful to think about the way the GFFS allows the sharing of resources (files and directories) in terms of mapped versus unmapped resources. For example:

A mapped directory corresponds directly to a directory located on a server somewhere that someone has chosen to export into the GFFS. Whatever changes are made through the GFFS affect that same directory, wherever it is. In other words, this data is not stored on the GFFS servers.
An unmapped directory, on the other hand, is a construct used by the GFFS for the purposes of sharing resources that are stored on servers belonging the GFFS. They are "in the cloud".

What is a container? As the GFFS uses a standards-based Web Services model, it executes inside of a program called a Web Services container. Therefore we refer to the location where resources accessible through the GFFS are stored as containers. Both mapped and unmapped resources are stored in containers. The difference is where the container itself is located.

If the resource in question has been shared through the export process, the container is stored in a local file somewhere.
If the resource in question has not been shared through the export process, the container is "in the cloud"; in other words, the container is acting as a storage service.

Location of Files Created on the GFFS. By default, files are created in the current working GFFS directory, and thus is stored in the container where that directory is stored. Where that container is located depends, as described above, on whether the directory is mapped or unmapped.

File Operations

When you have highlighted a file in the Directory Panel, the drop-down File Menu provides the following options:

Preferences. Opens the Preferences Panel. See for more information.

Quit. Quits the GUI.

Edit. Edit downloads a copy of the highlighted file and opens the application associated with the file type (Microsoft Word, AdobePDF, etc.). Updates to the file will be propagated back to the GFFS when you save AND QUIT the application.

View. (The same as double-clicking on a file.) Downloads a copy of the efile and opens the application associated with the file time. IMPORTANT: Unlike edit, updates made in view mode will NOT be propagated back to the GFFS. If you save, changes will only be made to the local copy.

Delete File. Deletes the file from wherever it is stored (assuming you have permission to do so, i.e., write permission).

Directory Operations

When a directory is highlighted, the follow options are available from the drop-down Directory Menu:

Create New File. This options creates an untyped file within the highlighted directory.

Create Directory. This option brings up a window with directory creation options.

First you must decide whether to whether to store the directory in the same place as its parent directory. We recommend that you do, as most of the time this is the right decision. If the directory appears as a gray folder, it is an exported directory as described above), and so you cannot change where child directories are created.

Storing in same directory as parent.If you can and do choose to store the directory in the same place as the parent, the next decision is what to call the new directory. We call this the Target Path. The Target Path input box will have the path of the parent directory. Click in the box and, after the “/”, put in the new directory name.
Not storing in same directory. Alternatively, you may click Browse and select a new path for the new directory. Keep in mind that you must have write permission on the parent directory of your new directory.

If you choose to store the new directory in a different location than the parent, then you must select a Container Path. The Container Path text box will initially say “DEFAULT”. You must type in the path to the container where you want to store your new directory. You may use the Browse button to help you find the container you want. Note that you must have permission to create a new directory on the selected container.

Keep in mind that new files and directories created in your new directory will be stored in the same container.

Create Export. This option brings up the Export Directory Tool, which shows exports that have already been created.

Clicking on the Export Data button brings up a window to select options for a new export.

Copy to Local File System From GFFS. Copies the selected directory to a local file system. The command opens a file browser showing your local file system. Select the local file system directory into which you wish to copy the GFFS file or directory.

Copy From Local File System To GFFS. The command opens a file browser showing your local file system. Select the directory (or file) that you want to copy from the local file system. The file or directory will be copied (recursively in the case of a directory) into the selected directory in the GFFS.

Delete Directory. Deletes the selected directory and all files/subdirectories therein from wherever they are stored (assuming you have permission to do so, i.e., write permission).

Refresh Directory. Redraws the highlighted directory in the Directory Panel.

Create Security Group. This command allows you to create your own group.

The command will ask you for the path name for your new security group. Once the group is created you can add members to the group and use the group is access control lists. Click here for more information.

Right Click Menus

Operations available from the right-click menus vary according to whether a file or a directory is selected in the Directory Panel.

If a file is selected, the following operations are available:

If a directory is selected, the following operations are available:

Other menus

Help Menu

The options on the Help Menu will guide you to the relevant section on this page. (The Security help will take you to the main manual.)

Jobs Menu, Tools Menu

See here