Start HTTP Server (script step reference)

Activator Plug-in for FileMaker Pro

Start HTTP Server

Starts the built-in HTTP Server. This web server will trigger a script when data arrives.

SyntaxScript step badge

Start HTTP Server [ Select ; Result (error) ; File name ; Script name ;
Password ; Port number ]

Options

Select entire contentsreplaces the entire contents of a field with the result. If not checked the result replaces the currently selected portion of the field
Result (error)an error code
File namethe name of the file which contains the script to trigger when a HTTP request arrives
Script namespecifies the name of the script to trigger when a HTTP request arrives
Password(optional) a password which the sender needs to add to the HTTP request
Port number(optional) use the specified portnumber, if you leave this empty the default port number of the Activator is used (TCP port 54242)

Returned Result

Data type returned

Error code

Result

The returned result is an error code. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:

0no error
$$-50paramErrthere was an error with a parameter

Other errors may be returned.

Originated in

Activator Plug-in 4.5

Compatibility

FileMaker Pro 16

Considerations

This functionality is currently only available on Mac OS.

Only HTTP requests which are posted to the right web page will trigger the script. Other requests (for example for the index.html page) are ignored by the plug-in. You can now also send text only to the plug-in.

The plug-in will make the HTTP server known via Bonjour as “Troi Activator Upload Server”, allowing for easy discovery.
See the UploadData.fmp12 example file for more detailed information.

Example

Start HTTP Server [ Select ; Result ; "Upload.fmp12" ; 
				"HTTP_TriggerScript" ; "secret" ]

This command starts the HTTP Server. When (image) data comes in it will trigger the script “HTTP_TriggerScript” in file “Upload.fmp12”. Note that this example is somewhat simplified, normally you should not use a hardcoded filename like in the above example.

Example 2

Add the following script steps:

Set Variable [ $password ; "secret" ) ]
Start HTTP Server [ Select ; Result ; Get ( FileName ) ; 
				"HTTP_TriggerScript" ; $password ; Port number: 12345 ]

This command will start the HTTP Server, with the HTTP Server listening on port 12345. Users can now send images or text data from other computers or for example an iPhone or iPad.

Related script stepScript step badge

Stop HTTP Server

Related functionsFunction badge

Actr_GetEventInfo
Actr_StartHTTPServer

Related topics

Activator Plug-in online help (overview)


Online Help Page for Activator Plug-in for 12 to 16 –> Start HTTP Server (actrp7621) 2017-0831 17:37:44