Revision as of 21:07, 9 May 2017

360Works RemoteScripter User Guide

RemoteScripter allows you to remotely trigger FileMaker scripts on another computer. It can be triggered either by RemoteScripter running on a different computer, or by an HTTP URL. This plugin can safely be triggered from within the Web Publishing Engine, which makes it an ideal way to trigger non-web-safe scripts on a separate script processing computer. For example, let's say that your WebDirect or IWP application needs to be able to generate downloadable PDF's. You would define a script called "Generate PDF" which is designed to be run on a computer running regular FileMaker Pro at IP address 10.0.0.25. It might looking something like this:</p>

Enter find mode
Set field Customer::customer ID to Get(ScriptParameter)
Perform find
Save as PDF
RemoteScripterSetResult("Success")

Now pick a random port number to run RemoteScripter on. We'll pick 4546, but it can be anything that does not conflict with another service running on the same port. You would have a startup script which calls:</p>

RemoteScripterStart(4546, Get(FileName), "Generate PDF")

This tells RemoteScripter to trigger the Generate PDF script if it receives any requests on port 4546.</p> On the computer running WebDirect, you would have a button that the user clicks on to see the PDF. This button triggers a script which would look something like this:</p>

if( RemoteScripterTrigger("10.0.0.25", 4645, Customer::customer ID) = "Success" )
	Go to Layout (Download PDF)
else
	Go to Layout (Show PDF generation error)
end if

You could also trigger the PDF generation script directly from a user's browser, without going through the web server. Just have a URL that looks like this:</p>

<a href="10.0.0.25:4645?35">View customer record 35</a>

This will trigger RemoteScripter to run the script and return whatever is set with RemoteScripterSetResult().</p>

You can use RemoteScripter to trigger scripts on your clients machines when they click links in a web viewer in your filemaker database. This allows you to design an interface in HTML, Java, Flash, or any language which can be displayed in your web viewer and then still trigger filemaker scripting. You can accomplish this by installing the Remote Scripter plugin on each of your client machines. You can then call the RemoteScripterStart function like in the example above (a startup script is a good place for this) and trigger the script using a link in your HTML to http://localhost:4645. The "localhost" url always points to the machine accessing it, so your users will trigger your script on their own machines when they click the link!</p>

360Works Plugin Setup Guides

See Plugins_101 for Error reporting, installation, registration, and more.

Function Summary

Function Detail

RemoteScripterBringFilemakerToFront ( )

You may optionally call this function to bring Filemaker to the front and give it focus.

RemoteScripterGetVersion ( )

Returns the version number of the RemoteScripter plugin.

RemoteScripterLastError ( )

Returns detailed information about the last error generated by this plugin. If another plugin function returns the text "ERROR", call this function to get a user-presentable description of what went wrong.

RemoteScripterLicenseInfo ( )

RemoteScripterRegister ( licenseKey; companyName )

Registers the plugin.

RemoteScripterSetErrorCapture ( errorCapture )

Toggles error dialogs on or off. When something unexpected happens, the plug-in will pop up a dialog displaying the error message. This makes it easy to see what went wrong. However, in some cases, you (the developer) may prefer to show your own message to the user, or possibly not show a message at all. In that case, you can call RemoteScripterSetErrorCapture with a parameter of true. That will suppress the error dialog from appearing to the user.

RemoteScripterSetResult ( resultText )

You may optionally call this function with text to return as the result of triggered script. If you do not call it, it will return nothing. This is usually called near the end of the triggered script.

RemoteScripterStop ( portNumber )

Stops listening on this port.

RemoteScripterTrigger ( remoteAddress; portNumber {; parameterText ; timeout } )

Triggers a script on the remote computer running the RemoteScripter plugin. This waits until the remote computer finishes the script, and returns the result.