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

MBS FileMaker Plugin Example Databases

Edit Sheet

All examples are included with download of MBS FileMaker Plugin.

Edit Sheet.fmp12

Overview
Tables 1
Relationships 0
Layouts 1
Scripts 3
Value Lists 0
Custom Functions 0
Custom Menus 33
File Options
Default custom menu set [Standard FileMaker Menus]
Default theme Apex Blue
When opening file
Minimum allowed version 12.0
Login using Account Name; Account= Admin
Allow user to save password On
Require iOS passcode Off
Show Sign-in fields Off
Switch to layout Off
Hide all toolbars Off
Script triggers
OnFirstWindowOpen Off
OnLastWindowClose Off
OnWindowOpen Off
OnWindowClose Off
OnFileAVPlayerChange Off
OnWindowTransaction Off
Thumbnail Settings
Generate Thumbnails On; Temporary

 

Tables

Table Name
Statistics
Comments
Occurrences in Relationship Graph
XL
3 fields defined, 1 record
XL

Fields

Table Name: XL - 3 Fields
Field Name Type Options Comments On Layouts In Relationships In Scripts In Value Lists
ExcelFile Normal, Binary Auto-Enter:
  • Allow editing
Validation:
  • Only during data entry
Storage:
  • Repetitions: 1
      Result Normal, Text Auto-Enter:
      • Allow editing
      Validation:
      • Only during data entry
      Storage:
      • Repetitions: 1
      • Indexing: None
      • Automatically create indexes as needed
      • Index Language: German
          OutputFile Normal, Binary Auto-Enter:
          • Allow editing
          Validation:
          • Only during data entry
          Storage:
          • Repetitions: 1

              Layout Objects: XL

              Regular Fields

              Field Name: XL::ExcelFile
              Field Properties Coordinates Field Format Field Behavior Quick Find
              • Top: 24 pt
              • Left: 138 pt
              • Bottom: 149 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: System Default
              • Go to next field using: Tab key
              No

              Field Name: XL::Result
              Field Properties Coordinates Field Format Field Behavior Quick Find
              • Top: 156 pt
              • Left: 138 pt
              • Bottom: 170 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: System Default
              • Go to next field using: Tab key
              Yes

              Field Name: XL::OutputFile
              Field Properties Coordinates Field Format Field Behavior Quick Find
              • Top: 174 pt
              • Left: 138 pt
              • Bottom: 299 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: System Default
              • Go to next field using: Tab key
              No

              Group Buttons

              Button Properties Coordinates Script/Script Step
                Type:
              • Text: Run Script
                Additional Properties:
              • Change to hand cursor over button
              • Rectangular
              • Top: 144 pt
              • Left: 420 pt
              • Bottom: 175 pt
              • Right: 547 pt
              • Anchoring: Left, Top
              Perform Script [ “Run” ]

              Scripts:


              Buttons

              Button Properties Coordinates Script/Script Step
                Type:
              • Text: MBS Plugin Website
              • Top: 314 pt
              • Left: 10 pt
              • Bottom: 340 pt
              • Right: 163 pt
              • Anchoring: Left, Top
              Open URL [ "http://monkeybreadsoftware.de/filemaker/" ] [ No dialog ]

              Button Properties Coordinates Script/Script Step
                Type:
              • Text: Order LibXL License
              • Top: 314 pt
              • Left: 171 pt
              • Bottom: 340 pt
              • Right: 324 pt
              • Anchoring: Left, Top
              Open URL [ "http://monkeybreadsoftware.de/filemaker/xl.shtml" ] [ No dialog ]

              Script Hierarchy

              Run
              Trace
              InitXL

              Next Script: [Trace]
              Script Name Run
              Run script with full access privileges Off
              Siri Shortcut Visible Off
              Include In Menu Yes
              Layouts that use this script
              Scripts that use this script
                Script Definition
                Script Steps
                • #Find libXL and load it
                • If [ MBS("XL.IsInitialized") ≠ 1 ]
                • Perform Script [ “InitXL” ]
                • End If
                • #Load template excel file
                • Set Variable [ $bookRef; Value:MBS( "XL.LoadBook"; XL::ExcelFile) ]
                • Set Field [ XL::Result; $bookRef ]
                • If [ MBS("IsError") ]
                • Show Custom Dialog [ Title: "Error"; Message: $bookRef; Default Button: “OK”, Commit: “Yes”; Button 2: “Cancel”, Commit: “No” ]
                • Exit Script [ ]
                • End If
                • Set Variable [ $sheet; Value:0 ]
                • #First row
                • Set Variable [ $row; Value:4 ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteNumber"; $BookRef; $sheet; $row; 0; 1 ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $BookRef; $sheet; $row; 1; "Cherries" ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteNumber"; $BookRef; $sheet; $row; 2; 5 ) ]
                • #Second row
                • Set Variable [ $row; Value:5 ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteNumber"; $BookRef; $sheet; $row; 0; 2 ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $BookRef; $sheet; $row; 1; "Banana" ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteNumber"; $BookRef; $sheet; $row; 2; 3,5 ) ]
                • #Third row
                • Set Variable [ $row; Value:6 ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteNumber"; $BookRef; $sheet; $row; 0; 3 ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $BookRef; $sheet; $row; 1; "Oranges" ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteNumber"; $BookRef; $sheet; $row; 2; 6,25 ) ]
                • #Last row
                • Set Variable [ $row; Value:13 ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteFormula"; $BookRef; $sheet; $row; 2; "SUM(C5:C13)" ) ]
                • #add link, only for XLSX
                • Set Variable [ $row; Value:15 ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $BookRef; $sheet; 7; 1; "monkeybreadsoftware.com" ) ]
                • Set Variable [ $r; Value:MBS( "XL.Sheet.AddHyperlink"; $bookRef; $sheet; "http://www.monkeybreadsoftware.com/"; 7; 7; 1; 1) ]
                • #Save to container and cleanup
                • Set Field [ XL::OutputFile; MBS("XL.Save"; $bookRef; "test.xls") ]
                • Set Variable [ $r; Value:MBS( "XL.Book.Release"; $bookRef) ]
                • Set Field [ XL::Result; $r ]
                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: [Run] Next Script: [InitXL]
                      Script Name Trace
                      Run script with full access privileges Off
                      Siri Shortcut Visible Off
                      Include In Menu Yes
                      Layouts that use this script
                        Scripts that use this script
                          Script Definition
                          Script Steps
                          • Set Variable [ $Trace; Value:MBS("Trace") ]
                          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: [Trace]
                                        Script Name InitXL
                                        Run script with full access privileges Off
                                        Siri Shortcut Visible Off
                                        Include In Menu Yes
                                        Layouts that use this script
                                          Scripts that use this script
                                          Script Definition
                                          Script Steps
                                          • #Find libXL and load it
                                          • #you can have libraries in container and export at runtime to folder of your choice.
                                          • #Or install library somewhere and pass path.
                                          • #If library is in same folder as plugin, you can only pass only file name.
                                          • If [ MBS("IsServer") ]
                                          • #Put the path you use for your server here:
                                          • If [ Get(SystemPlatform) = -2 ]
                                          • #Server on Windows
                                          • Set Variable [ $path; Value:"C:\Programs\FileMaker Server\libxl.dll" ]
                                          • Else If [ MBS("IsLinux") ]
                                          • #Server on Linux for FileMaker Cloud
                                          • Set Variable [ $path; Value:"/opt/FileMaker/FileMaker Server/libxl.so" ]
                                          • Else [ ]
                                          • #Server on Mac
                                          • Set Variable [ $path; Value: "/Library/FileMaker Server/libxl.dylib" ]
                                          • End If
                                          • Else [ ]
                                          • #For desktop and our examples we look in same folder as database:
                                          • Set Variable [ $databasePath; Value:Get(FilePath) ]
                                          • Set Variable [ $databasePath; Value:MBS("Path.FilemakerPathToNativePath"; $databasePath) ]
                                          • Set Variable [ $databasePath; Value:Substitute ( $databasePath ; ".fp7" ; ".fmp12") ]
                                          • Set Variable [ $databaseName; Value:Get(FileName) & ".fmp12" ]
                                          • If [ Get(SystemPlatform) = -2 ]
                                          • Set Variable [ $path; Value:Substitute ( $databasePath ; $databaseName ; "libxl.dll" ) ]
                                          • #plugin will look for libxl.dll and if not found also for libxl64.dll (64-bit) and libxl32.dll (32-bit).
                                          • Else [ ]
                                          • Set Variable [ $path; Value:Substitute ( $databasePath ; $databaseName ; "libxl.dylib" ) ]
                                          • #Mac dylib is usually 32 and 64 bit together.
                                          • End If
                                          • End If
                                          • #You can test for free.
                                          • #If you like to get a LibXL license, please follow links on our pricing page:
                                          • #https://www.monkeybreadsoftware.de/filemaker/pricing.shtml
                                          • Set Variable [ $LicenseeName; Value:"your name" ]
                                          • Set Variable [ $LicenseKey; Value:"your LibXL license key" ]
                                          • Set Variable [ $r; Value:MBS( "XL.Initialize"; $path; $LicenseeName; $LicenseKey) ]
                                          • If [ $r ≠ "OK" ]
                                          • Show Custom Dialog [ Title: "Error"; Message: $r; Default Button: “OK”, Commit: “No”; Button 2: “Cancel”, Commit: “No” ]
                                          • Halt Script
                                          • End If
                                          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

                                                        Download example: Edit Sheet

                                                        Used functions: