Reference > Script steps reference > Control script steps > Perform Script On Server
 
Perform Script On Server
Purpose 
Performs a script on the server that is hosting the current file.
See also 
Format 
Perform Script on Server [Wait for completion: On/Off ; "<script name>" ; Parameter: <parameter>]
Options 
<script name> specifies the script you want to perform. See Specify Script dialog box.
Optional script parameter specifies a script parameter for the specified script.
Wait for completion pauses the script on the client until the sub-script called by Perform Script On Server is completed on the host. Wait for completion must be selected to pass a script result or error code from the host to the client. Use the Get(ScriptResult) function to capture a result or the Get(LastError) function to capture an error code.
Compatibility 
 
Where the script step runs 
Supported 
FileMaker Pro 
Yes 
FileMaker Server 
No 
FileMaker Go 
Yes 
Custom Web Publishing 
Yes 
FileMaker WebDirect 
Yes 
Runtime solution 
No 
Originated in 
FileMaker Pro 13.0
Description 
The current file must be hosted on FileMaker Server. Otherwise, Perform Script On Server returns an error. See About running scripts on FileMaker Server.
Example 1 
Runs a script on the server and sends the current layout name, customer ID, and customer email address as the script parameter. The server navigates to the layout and record specified in the parameter, saves a snapshot link of the current record, emails the snapshot link to the email address specified in the parameter, and returns a result. The client fetches the script result from the server and displays it in a custom dialog box.
Main script: Email snapshot link (Client)
Perform Script on Server [Wait for completion: On ; "Email snapshot link (Server)" ; Parameter: List ( Get ( LayoutName ) ; Customers::ID ; Customers::Email )]
Show Custom Dialog [Get ( ScriptResult )]
Sub-script: Email snapshot link (Server)
Go to Layout [GetValue ( Get ( ScriptParameter ) ; 1 )]
Enter Find Mode [Pause: Off]
Set Field [Customers::ID; GetValue ( Get ( ScriptParameter ) ; 2 )]
Perform Find [ ]
Set Variable [$PATH; Value:Get ( TemporaryPath ) & "Snapshot.fmpsl"]
Save Records as Snapshot Link ["$PATH"; Current record]
Send Mail [Send via SMTP Server; With dialog: Off; To: GetValue ( Get ( ScriptParameter ) ; 3 ); "$PATH"]
Exit Script [Text Result: "Snapshot link sent."]
Related topics 
Perform Script script step
Perform Script and script parameter examples
Script steps reference (alphabetical list)
Script steps reference (category list)