Monkeybread Software - MBS FileMaker Plugin: Shell

Components	All	New	MacOS		Windows		Linux		iOS
Examples	Mac & Win		Server	Client	Guides	Statistic	FMM	Blog	Deprecated	Old

MBS FileMaker Plugin Example Databases

Shell

All examples are included with download of MBS FileMaker Plugin.

Shell.fmp12

Overview
Tables	1
Relationships	0
Layouts	1
Scripts	4
Value Lists	0
Custom Functions	0
Custom Menus	24

File Options
Default custom menu set	[Standard FileMaker Menus]
When opening file
Minimum allowed version	12.0
Login using	Account Name; Account= Admin
Allow user to save password	Off
Require iOS passcode	Off
Switch to layout	Off
Hide all toolbars	Off
Script triggers
OnFirstWindowOpen	Off
OnLastWindowClose	Off
OnWindowOpen	Off
OnWindowClose	Off
OnFileAVPlayerChange	Off
Thumbnail Settings
Generate Thumbnails	On; Temporary

Tables

Table Name	Statistics	Occurrences in Relationship Graph
Shell	6 fields defined, 13 records	Shell

Fields

Table Name: Shell - 6 Fields
Field Name	Type	Options	Comments	On Layouts	In Relationships	In Scripts	In Value Lists
Executable	Normal, Text	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1 Indexing: None Automatically create indexes as needed Index Language: German		Shell		Run Run Async
Arguments List	Normal, Text	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1 Indexing: None Automatically create indexes as needed Index Language: German		Shell		Run Run Async
Output	Normal, Text	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1 Indexing: None Automatically create indexes as needed Index Language: German		Shell		Run Run Async Run Done
Error	Normal, Text	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1 Indexing: None Automatically create indexes as needed Index Language: German		Shell		Run Run Async Run Done
Input	Normal, Text	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1 Indexing: None Automatically create indexes as needed Index Language: German		Shell		Run
Description	Normal, Text	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1 Indexing: None Automatically create indexes as needed Index Language: German		Shell

Layout Objects: Shell

Regular Fields

Field Name: Shell::Executable

Layout Name:

Shell

Top: 52 pt
Left: 138 pt
Bottom: 73 pt
Right: 391 pt

Anchoring: Left, Top

Field Format:

Edit Box

Field Behavior:

Allow field to be entered: In Find mode, In Browse mode
Touch keyboard type: Default for Data Type
Go to next field using: Tab key

Yes

Field Name: Shell::Arguments List

Layout Name:

Shell

Top: 75 pt
Left: 138 pt
Bottom: 181 pt
Right: 391 pt

Anchoring: Left, Top

Field Format:

Edit Box

Field Behavior:

Allow field to be entered: In Find mode, In Browse mode
Touch keyboard type: Default for Data Type
Go to next field using: Tab key

Yes

Field Name: Shell::Output

Layout Name:

Shell

Top: 54 pt
Left: 570 pt
Bottom: 258 pt
Right: 1018 pt

Anchoring: Left, Top

Field Format:

Edit Box

Field Behavior:

Allow field to be entered: In Find mode, In Browse mode
Touch keyboard type: Default for Data Type
Go to next field using: Tab key

Yes

Field Name: Shell::Error

Layout Name:

Shell

Top: 263 pt
Left: 568 pt
Bottom: 467 pt
Right: 1017 pt

Anchoring: Left, Top

Field Format:

Edit Box

Field Behavior:

Allow field to be entered: In Find mode, In Browse mode
Touch keyboard type: Default for Data Type
Go to next field using: Tab key

Yes

Field Name: Shell::Input

Layout Name:

Shell

Top: 187 pt
Left: 138 pt
Bottom: 287 pt
Right: 391 pt

Anchoring: Left, Top

Field Format:

Edit Box

Field Behavior:

Allow field to be entered: In Find mode, In Browse mode
Touch keyboard type: Default for Data Type
Go to next field using: Tab key

Yes

Field Name: Shell::Description

Layout Name:

Shell

Top: 294 pt
Left: 138 pt
Bottom: 467 pt
Right: 391 pt

Anchoring: Left, Top

Field Format:

Edit Box

Field Behavior:

Allow field to be entered: In Find mode, In Browse mode
Touch keyboard type: Default for Data Type
Go to next field using: Tab key

Type:

Text: Execute

Layout Name:

Shell

Top: 74 pt
Left: 410 pt
Bottom: 106 pt
Right: 542 pt

Anchoring: Left, Top

Perform Script [ “Run” ]

Scripts:

Next Script: [Clear all results]

Script Name	Run
Run script with full access privileges	Off
Include In Menu	Yes
Layouts that use this script	Shell
Scripts that use this script
Script Definition
Script Steps	Set Variable [ $shell; Value:MBS( "Shell.New" ) ] Set Field [ Shell::Output; "" ] Set Field [ Shell::Error; "" ] Commit Records/Requests [ No dialog ] Set Variable [ $s; Value:MBS( "Shell.SetArgumentsList"; $shell; Shell::Arguments List ) ] Set Variable [ $s; Value:MBS( "Shell.Execute"; $shell; Shell::Executable) ] Set Variable [ $error; Value:"" ] Set Variable [ $result; Value:"" ] If [ MBS("IsError") ] Show Custom Dialog [ Title: "Failed to run"; Message: $s; Default Button: “OK”, Commit: “Yes”; Button 2: “Abbrechen”, Commit: “No” ] Else If [ Length(Shell::Input) > 0 ] Set Variable [ $s; Value:MBS( "Shell.WriteInputText"; $shell; Shell::Input; "UTF-8") ] End If #Loop while app runs and collect messages Loop Set Variable [ $s; Value:MBS( "Shell.Wait"; $shell; 1) ] Set Variable [ $error; Value:$error & MBS( "Shell.ReadErrorText"; $shell; "UTF-8") ] Set Variable [ $result; Value:$result & MBS( "Shell.ReadOutputText"; $shell; "UTF-8") ] Set Field [ Shell::Error; MBS( "Text.ReplaceNewline"; $error; 1) ] Set Field [ Shell::Output; MBS( "Text.ReplaceNewline"; $result; 1) ] Exit Loop If [ MBS( "Shell.IsRunning"; $shell) ≠ 1 ] End Loop Commit Records/Requests [ No dialog ] End If Set Variable [ $r; Value:MBS("Shell.Release"; $shell) ]
Fields used in this script	Shell::Output Shell::Error Shell::Arguments List Shell::Executable Shell::Input
Scripts used in this script
Layouts used in this script
Tables used in this script	Shell
Table occurrences used by this script	Shell
Custom Functions used by this script
Custom menu set used by this script

Previous Script: [Run]

Next Script: [Run Async]

Script Name	Clear all results
Run script with full access privileges	Off
Include In Menu	Yes
Layouts that use this script
Scripts that use this script
Script Definition
Script Steps	#Clear all Error and Output fields in all records Set Variable [ $r; Value:MBS("FM.ExecuteFileSQL"; Get(FileName); "UPDATE \"Shell\" SET \"Error\" = '', \"Output\"=''") ]
Fields used in this script
Scripts used in this script
Layouts used in this script
Tables used in this script
Table occurrences used by this script
Custom Functions used by this script
Custom menu set used by this script

Previous Script: [Clear all results]

Next Script: [Run Done]

Script Name	Run Async
Run script with full access privileges	Off
Include In Menu	Yes
Layouts that use this script
Scripts that use this script
Script Definition
Script Steps	Set Variable [ $shell; Value:MBS( "Shell.New" ) ] Set Field [ Shell::Output; "" ] Set Field [ Shell::Error; "" ] Commit Records/Requests [ No dialog ] Set Variable [ $s; Value:MBS( "Shell.SetScript"; $shell; Get(FileName); "Run Done") ] Set Variable [ $s; Value:MBS( "Shell.SetArgumentsList"; $shell; Shell::Arguments List ) ] Set Variable [ $s; Value:MBS( "Shell.Execute"; $shell; Shell::Executable) ]
Fields used in this script	Shell::Output Shell::Error Shell::Arguments List Shell::Executable
Scripts used in this script
Layouts used in this script
Tables used in this script	Shell
Table occurrences used by this script	Shell
Custom Functions used by this script
Custom menu set used by this script

Previous Script: [Run Async]

Script Name	Run Done
Run script with full access privileges	Off
Include In Menu	Yes
Layouts that use this script
Scripts that use this script
Script Definition
Script Steps	Set Variable [ $shell; Value:Get(ScriptParameter) ] Set Variable [ $error; Value:MBS( "Shell.ReadErrorText"; $shell; "UTF-8") ] Set Variable [ $result; Value:MBS( "Shell.ReadOutputText"; $shell; "UTF-8") ] Set Field [ Shell::Error; MBS( "Text.ReplaceNewline"; $error; 1) ] Set Field [ Shell::Output; MBS( "Text.ReplaceNewline"; $result; 1) ] Commit Records/Requests [ No dialog ] Set Variable [ $r; Value:MBS("Shell.Release"; $shell) ]
Fields used in this script	Shell::Error Shell::Output
Scripts used in this script
Layouts used in this script
Tables used in this script	Shell
Table occurrences used by this script	Shell
Custom Functions used by this script
Custom menu set used by this script

Download example: Shell

Used functions: