User Guide

http://www.fmwebschool.com 800.353.7950 / 386.453.5843

Grab-it Plug-in is copyright 2006 of FMWebschool Inc.

Thank you for your interest in the Grab-it plug-in for FileMaker versions 7-8.
Grab-it simply enables you to grab files from the web, a local drive or an external drive and automatically insert that file into a container field. Grab-it is extremely fast and works equally well on both the Mac and PC. Grab-it is extremely easy to use! We hope you enjoy testing Grab-it. The team at FMWebschool Note: The demo version of this plug-in will only allow 7 uploads into the container field. To re-set the demo, simply close and re-open FileMaker. To permanently get rid of the demo feature, purchase Grab-it. When the 7 upload limit is reached a Grab-it splash screen will be uploaded into the container field instead of the requested file. Installing the Grab-it Demo for FileMaker 7/8 Windows Version

Note: Please Exit FileMaker before installing the Grab-it plug-in.

The files needed to install the Grab-it plug-in are located inside the GrabWin folder. There are two files, Grab-it.FMX and libcur-3l.dll.

Step 1. Place Grab-It.FMX in the Extensions folder within the FileMaker installation. Usually this location is C:\Program Files\FileMaker\FileMaker Pro 7/8 \Extensions

Step 2.

Place libcur-3l.dll within the location where the FileMaker executable is located. Usually this location is C:\Program Files\FileMaker\FileMaker Pro 7/8

Installing the Grab-it Demo for FileMaker Server 7/8 Web Publishing Engine Windows Version Note: Please restart the publishing engine after installing the plug-in. Note: Due to a small bug in FileMaker Server 7 Advanced, you will need to copy a small file and move it to the directory listed below for Grab-it to work properly with Server Advanced 7. Server Advanced 8 does not have this bug. (FileMaker Server 7 Advanced Only) - Replace FMWrapper.dll in \FileMaker Server\Web Publishing\publishing-engine\wpc with... - FMWrapper.dll from \FileMaker Server The files needed to install the Grab-it plug-in are located inside the Grab_Win folder. There are two files, Grab-it.FMX and libcurl.dll.

Place Grab-It.FMX in the Plugins folder within the FileMaker Server Web Publishing installation. Usually this location is C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishing-engine\wpc\Plugins

Place libcur-3l.dll within the location where the FileMaker executable is located. Usually this location is C:\Program Files\FileMaker\FileMaker Server\Web Publishing\publishingengine\wpc

Installing the Grab-it Demo for FileMaker 7/8 Macintosh Version Note: Please Exit FileMaker before installing the GRAB-IT plug-in. The GRAB-IT plug-in is located inside the GrabMac folder.

When using FileMaker 7 and 8, simply move this plug-in into the FileMaker Extensions folder. Here are the paths to those folders.

Place Grab-It.FMX in the Extensions folder within the FileMaker installation. Usually this location is Applications\FileMaker Pro 7/8 Once you have placed the plug-in in the appropriate folder, you are ready to begin using the Example files. When using the Mac with local path the only syntax supported at this time is the original Unix file name syntax. This syntax assumes / to be the root directory and /Users/ to be the default users directory. The example below uses my name stephen as the User: /Users/stephen/Desktop/1.gif The following syntax is NOT correct: /Stephens HD/Users/stephen/Desktop/1.gif

Grab-it Plug-in Functions Plug-in Functions "GrabIt_About" "GrabIt _Activate (key)" "GrabIt _FileFromPath (filename; filepath)" "GrabIt _Version" _______________________________________ " GrabIt_About " Parameters: NONE Result: Image Use this function to return an image of the Grab-It plug-in version and registration status. This function presents a good way to quickly check if your registration key was accepted. Example: Make a Container field grabit_about Set Field [grabit_about; GrabIt_About] _______________________________________ " GrabIt _Activate (key)" Parameters: Username:Password Result: "REGISTERED", " DEMO, "INVALID" Use this function in a start up script to "unlock" the GRAB-IT plug-in. This function only needs to be called once. Example to use as demo: DEMO:0000 _______ ________________________________

" GrabIt _FileFromPath (filename; filepath)" Parameters: filename; filepath Result: File or Image to be stored in a container field This function is the heart of Grab-It, accomplishing the only purpose of this plug-in: grabbing files. To grab a file enter an arbitrary filename that FileMaker will show for regular files, or suggest when exporting image files. If the filename ends with .jpg or .gif then the file is marked as an image with a preview. File path is the actual path to the file. The path can be a local path such as C:\my_file.txt or a URL that contains http:// such as http://example.com/file.pdf

Example: Make a Container field file_data Create a Set Field script step that sets file_data. Set calculation to: GrabIt_FileFromPath(image.jpg; http://www.example.com/a.jpg)

" GrabIt _Version ( version format ) Parameters: version format ( short,long) Result: string with Grab-It version Use this function to retrieve the textual representation of the Grab-It version number that is currently installed. Use the short argument to get just the version number, and the long argument returns the plug-in name and version.

_______________________________________ The Grab-it plug-in comes with an example file Grab.fp7. This file will help teach you how to automatically insert files into the container fields in FileMaker. Note: If you use Grab-it to insert a file such as a PDF into FileMaker, you can quickly export the contents of the container field by right-clicking windows / command-click Mac, and choose Export Field Contents from the drop-down list. New RSS Web Modules The demo file comes with three Grab-it example modules. Get Weather, Get Time and Date, Get Stocks. If you have an idea as to a module you would like to see implemented, please email and let us know! Below are some examples.

Getting Help
If you have questions about GRAB-It, please email FMWebschool at info@fmwebschool.com You can also ask questions on our forum at: http://fmwebschool.com/frm/index.php If you do have questions, or are experiencing problems with the plug-in, please be as specific as possible.

Grab-it is copyright 2005 - 2006 FMWebschool Inc.