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
Tables1
Relationships0
Layouts1
Scripts3
Value Lists0
Custom Functions0
Custom Menus33
File Options
Default custom menu set[Standard FileMaker Menus]
When opening file
Minimum allowed version12.0
Login usingAccount Name; Account= Admin
Allow user to save passwordOff
Require iOS passcodeOff
Switch to layoutOff
Hide all toolbarsOff
Script triggers
OnFirstWindowOpenOff
OnLastWindowCloseOff
OnWindowOpenOff
OnWindowCloseOff
OnFileAVPlayerChangeOff
Thumbnail Settings
Generate ThumbnailsOn; Temporary

 

Tables

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

Fields

Table Name: XL - 3 Fields
Field NameTypeOptionsCommentsOn LayoutsIn RelationshipsIn ScriptsIn Value Lists
ExcelFileNormal, BinaryAuto-Enter:
  • Allow editing
Validation:
  • Only during data entry
Storage:
  • Repetitions: 1
      ResultNormal, TextAuto-Enter:
      • Allow editing
      Validation:
      • Only during data entry
      Storage:
      • Repetitions: 1
      • Indexing: None
      • Automatically create indexes as needed
      • Index Language: German
          OutputFileNormal, BinaryAuto-Enter:
          • Allow editing
          Validation:
          • Only during data entry
          Storage:
          • Repetitions: 1

              Layout Objects: XL

              Regular Fields

              Field Name: XL::ExcelFile
              Field PropertiesCoordinatesField FormatField BehaviorQuick 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 PropertiesCoordinatesField FormatField BehaviorQuick 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 PropertiesCoordinatesField FormatField BehaviorQuick 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 PropertiesCoordinatesScript/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 PropertiesCoordinatesScript/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 PropertiesCoordinatesScript/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 NameRun
              Run script with full access privilegesOff
              Include In MenuYes
              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)" ) ]
                • #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 NameTrace
                      Run script with full access privilegesOff
                      Include In MenuYes
                      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 NameInitXL
                                        Run script with full access privilegesOff
                                        Include In MenuYes
                                        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: