Help
Managing Files with FTP

Course materials can be authored in professional web-authoring tools like DreamWeaver. These courses may contain hundreds or thousands of files. Individually uploading each file to your online course would be painful at best. And updating changed files would be equally difficult. These professional authoring tools typically include a File Transfer Protocol (FTP) feature that enables the tool to automatically upload its files to a destination FTP server. And whenever you edit files in your authoring tool, it can automatically publish only the edited files to the FTP server.

BrainHoney acts like an FTP server so you can easily use an FTP client or any of the professional web-authoring tools to automatically upload changed files from your local computer to BrainHoney.

Configuring an FTP Client

To connect an FTP client to a BrainHoney course, you configure the FTP client with a destination address (URL) and user credentials, which you obtain by following these steps:

  1. Open the course Syllabus
  2. In the Resources panel, click the [Add] button to open the Upload File screen
  3. Click the Multiple Files tab
The Multiple Files tab displays the FTP address and username credentials. Enter them in your FTP client, along with your BrainHoney password, and you can begin using your FTP client to manage course files.

Using FTP Options

The BrainHoney FTP server allows you to manage course files as described above, but if you have administrative rights in your domain, it also allows you to manage files for any entity (course, section, enrollment, user, etc.) that you have rights to. In its simplest form, the FTP URL follows this format:

ftp://servername/entityID

For example, to access the course resources with ID 20836, the URL is ftp://gls.agilix.com/20836. To access the files for the enrollment with ID 103256, the URL is ftp://gls.agilix.com/103256.

To see additional files or file information, you can append additional parameters to the URL with an underscore (_), followed by one or more options as follows:

ftp://servername/entityID[_A|V|fileclass]
OptionMeaning
A When entityID refers to a course or section, shows all files, including those normally hidden from view. Without "A", only files beneath the "Assets" folder are shown. By specifying "A", all sibling folders to "Assets" are displayed along with the "Assets" folder.
VShows all versions of the file, with a version number appended to the file name. When omitted, only the most recent version is shown with no name mangling. For example, if 3 versions of the file "sample.doc" exist, _V shows sample_1.doc, sample_2.doc, and sample_3.doc, whereas omitting _V shows sample.doc
fileclass Shows only files that are of class fileclass. Possible values for fileclass are:
  • (DOC!) - User-submittable files such as assignment submissions or teacher-grading files
  • (MSG!) - Discussion forum messages files
You must specify fileclass when entityid refers to an enrollment.
Sample FTP Commands

This sample displays course asset files in the course with ID 307524:

ftp://gls.agilix.com/307524
		
BrainHoney Logo.png
BrainHoney-Bee.png
Sample.doc

This sample displays all versions of course asset files in the course with ID 307524:

ftp://gls.agilix.com/307524_V

BrainHoney Logo_1.png
BrainHoney Logo_2.png
BrainHoney Logo_3.png
BrainHoney-Bee_1.png
Sample_1.doc

This sample displays all files (course assets and internally managed files) in the course with ID 307524:

ftp://gls.agilix.com/307524_A
		
Assets
  BrainHoney Logo.png
  BrainHoney-Bee.png
    Sample.doc
Templates
  Data
    1X15T
      index.html
    Y0Y4H
      index.html

This sample displays all versions of all files in the course with ID 307524:

ftp://gls.agilix.com/307524_AV

Assets
  BrainHoney Logo_1.png
  BrainHoney Logo_2.png
  BrainHoney Logo_3.png
  BrainHoney-Bee_1.png
  Sample_1.doc
Templates
  Data
    1X15T
      index_1.html
    Y0Y4H
      index_1.html

This sample displays document files for the enrollment with ID 337574:

ftp://gls.agilix.com/337574_(DOC!)

1X15T
  assign.zip
  response.zip
Y0Y4H
  assign.zip

This sample displays all versions of document files for the enrollment with ID 337574:

ftp://gls.agilix.com/337574_V(DOC!)

1X15T
  assign_1.zip
  assign_2.zip
  response_1.zip
  response_2.zip
  response_3.zip
Y0Y4H
  assign_1.zip