Gel Transfer
Version 1.0.3
by Erik Ferlanti
August 4, 1998

Description

Gel Transfer is an AppleScript droplet that allows transfer of files and
folders to a file server. This is accomplished by dragging & dropping the
file(s) on the droplet. If the file server is not mounted, the script will log
on and mount the specified volume. Each "run" of files copied to the file
server will be put in a folder named by the date (i.e. July_7_1998) and put
into the destination folder. If a folder or file name being copied to the file
server already exists for that particular date, it will be renamed with a "_#
of copies" appended to its name (i.e _1, _2, etc.).

Requirements

1) AppleScript 1.1 (included with System 7.5 or later)
2) Finder Scripting Extension (included with System 7.5 or later)
2) Jon's Commands 2.0.4 scripting addition (OSAX)
3) Script Tools 1.3.6 scripting addition (OSAX)
4) MountVolume 1.0 scripting addition (OSAX)
5) ACME Script Widgets 2.5 scripting addition (OSAX)

AppleScript and the Finder Scripting Extension are placed in the Extensions
Folder. Scripting additions are placed in the Scripting Additions folder. This
is located in the Extensions folder on pre-System 8 machines and in the System
Folder on System 8 machines.

Installation

Client 
Just run the included installer and all the relevant files will be installed on
your computer. The required scripting additions will also be installed if they
are not found on the computer at installation. Basically, a Gel Transfer folder
will be created at the root of the hard drive which will contain the Gel
Transfer droplet, this README, and a TransferLog file. An alias of the Gel
Transfer droplet will be placed on the desktop.

Server 
1) Create a new user
    * Go to Control Panels -> Users & Groups
    * Go to File menu -> New User or hit command(apple key)-N
        (System 8.x: click new user button)
    * Give the new user icon a name (Script default: geltransfer)
    * Double-click the new user icon and give the user a password (Script default: geltrans)
    * Close the user window and choose to save the user information

2) Create the main gel folder(volume)
    * At the root of the hard drive, create a new folder
    *Name the folder (Script default: Latest Gels)

3) Setup File Sharing/Gel folder sharing (2 methods):

    Method 1 (sharing the whole hard drive):
    * Go to Control Panels -> Sharing Setup (System 7.x)
                  Control Panels -> File Sharing (System 8.x)
    * Make sure File Sharing is turned on
    * Click once on the hard drive
    * Go to File menu -> Sharing...

    System 7.x
    * Click the box: Share this item and its contents
    * Close the dialog box
    * Click Save to save the access changes

    System 8.x
    * Click the box: Share this item and its contents
    * Close the dialog box

    Method 2 (sharing just this folder):
    * Go to Control Panels -> Sharing Setup (System 7.x)
                   Control Panels -> File Sharing (System 8.x)
    * Make sure File Sharing is turned on
    * Click once on the gel folder that was just created
    * Go to File menu -> Sharing...

    System 7.x
    * Click the following boxes: Share this item and its contents
                                 Can't be moved, renamed or deleted
                                 Make all currently enclosed folders like this one
    * Select the newly created user from the User/Group pull-down menu
    * Make sure all three boxes are checked
    * Uncheck all three boxes next to Everyone

    System 8.x
    * Check the box which says CanŐt move, rename, or delete this item
    * Make sure the box which says Use enclosing folder's privileges is unchecked
    * Select the newly created user from the User/Group pull-down menu
    * Set the user privileges to Read & Write
    * Set the privileges of Everyone to none
    * Click the copy button next to Copy these privileges to all enclosed folders
    * Click copy again in the dialog box

4) Remember the newly created username, password, and gel folder because they will
   be needed in the configuration step

Configuration

There are 9 parameters that can be changed by double-clicking on the Gel
Transfer droplet. The parameters are stored in a file called Gel Transfer Prefs
in the Preferences Folder. For the script to work properly, this must be done
prior to running the script for the first time (it will complain if it finds no
preferences file). A dialog box will pop up showing each parameter and its
current value. To change the value, just enter a new one in the text box and
click the continue button. This will step through all 9 parameters. At the end,
click the save button to save the preferences file. 

Here are the 9 parameters and what they mean:
serverVolume: The name of the volume on the file server
serverName: The name of the file server
serverZone: The name of the AppleTalk zone in which the file server resides
userName: The name of the user created on the file server
passWord: The password of the user
gelFolder: The name of main gel folder created on the file server
useLogFile: [yes/no] Toggles whether or not a log file is used to record each transfer
logFile: The path to the log file on the client computer (i.e. HD name:Gel
Transfer:TransferLog) - not necessary if useLogFile is set to no
unMountServer: [yes/no] Toggles whether or not the file server will be unmounted after a transfer

Revision History

1.0.3  -  Added a parameter that toggles whether the file server is unmounted after transfer [8/4/98]
1.0.2  -  Checks to see whether the gel folder is a volume on the server
             or contained within a shared volume for path info [7/16/98]
             Duplicate files/folders copied to the server are now appended
             with "_#of copies" (i.e. _1, _2)  [7/16/98]
1.0.1  -  Date folders and gel folders on the server are now labeled hot [7/10/98]
1.0     -  First release  [7/7/98]