Monkeybread Software - MBS FileMaker Plugin: Shell.AddArgument

Topics All Mac OS X (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Guides Examples
New in version: 7.2 7.3 7.4 7.5 8.0 8.1 8.2 8.3 8.4 8.5 Statistic

Shell.AddArgument

Adds an argument.

Component	Version	macOS	Windows	Server	FileMaker Cloud	FileMaker iOS SDK
Shell	7.5	Yes	Yes	Yes	Yes	No

MBS( "Shell.AddArgument"; ShellRef; Argument { ; More Arguments } )

Parameters

Parameter Description Example value

ShellRef The reference number from the shell. $shell

Argument The new argument. "-l"

More Arguments Optional
Available in MBS FileMaker Plugin 8.3 or newer.
Add more parameters to add more arguments.

Parameter	Description	Example value
ShellRef	The reference number from the shell.	$shell
Argument	The new argument.	"-l"
More Arguments	Optional Available in MBS FileMaker Plugin 8.3 or newer. Add more parameters to add more arguments.

Result

Returns OK or error.

Description

Adds an argument.
This argument is added to the list of arguments passed first on each call to Shell.Execute.
With version 8.3, you can add several arguments here.

Examples

Adds an argument:

MBS( "Shell.AddArgument"; $shell; "-v" )

Send email via Outlook.exe with options via command line:

Set Variable [ $app ; Value: "C:\Program Files (x86)\Microsoft Office\Office15\OUTLOOK.EXE" ]
Set Variable [ $attachment ; Value: "C:\Users\Administrator\Desktop\test.jpg" ]
Set Variable [ $to ; Value: "to@test.com" ]
Set Variable [ $subject ; Value: "Test Email" ]
Set Variable [ $cc ; Value: "copy@test.com" ]
Set Variable [ $body ; Value: "Hello World" ]
Set Variable [ $shell ; Value: MBS( "Shell.New" ) ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "/c" ) ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "ipm.note" ) ]
If [ not IsEmpty ( $attachment ) ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "/a" ) ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; $attachment ) ]
End If
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; "/m" ) ]
Set Variable [ $a1 ; Value: MBS( "Text.EncodeURLComponent"; $to; "UTF-8" ) ]
Set Variable [ $a2 ; Value: "?subject=" & MBS( "Text.EncodeURLComponent"; $subject; "UTF-8" ) ]
Set Variable [ $a3 ; Value: If ( Length ( $cc ) > 0 ; "&cc=" & MBS( "Text.EncodeURLComponent"; $cc; "UTF-8" ); "" ) ]
Set Variable [ $a4 ; Value: If ( Length ( $body) > 0 ; "&body=" & MBS( "Text.EncodeURLComponent"; $body ; "UTF-8" ) ; "") ]
Set Variable [ $s ; Value: MBS( "Shell.AddArgument"; $shell; $a1 & $a2 & $a3 & $a4) ]
Set Variable [ $s ; Value: MBS( "Shell.Execute"; $shell; $app) ]
Set Variable [ $r ; Value: MBS("Shell.Release"; $shell) ]

Adds three arguments:

MBS( "Shell.AddArgument"; $shell; "-v"; "-r"; "-e" )

Example Databases

Shell/Shell Ping

Created 11st November 2017, last changed 16th September 2018

SetSystemUIMode - Shell.AddEnvironment