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

MBS FileMaker Plugin Example Databases

Converter

All examples are included with download of MBS FileMaker Plugin.

Converter.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 Klassisch
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
Converter
4 fields defined, 1 record
 Converter

Fields

Table Name: Converter - 4 Fields
Field Name Type Options Comments On Layouts In Relationships In Scripts In Value Lists
InputXLS Normal, Binary Auto-Enter:
  • Allow editing
Validation:
  • Only during data entry
Storage:
  • Repetitions: 1
      InputXLSX Normal, Binary Auto-Enter:
      • Allow editing
      Validation:
      • Only during data entry
      Storage:
      • Repetitions: 1
          OutputXLS Normal, Binary Auto-Enter:
          • Allow editing
          Validation:
          • Only during data entry
          Storage:
          • Repetitions: 1
              OutputXLSX Normal, Binary Auto-Enter:
              • Allow editing
              Validation:
              • Only during data entry
              Storage:
              • Repetitions: 1

                  Layout Objects: Converter

                  Regular Fields

                  Field Name: Converter::InputXLS
                  Field Properties Coordinates Field Format Field Behavior Quick Find
                  • Top: 53 pt
                  • Left: 156 pt
                  • Bottom: 178 pt
                  • Right: 409 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: Converter::InputXLSX
                  Field Properties Coordinates Field Format Field Behavior Quick Find
                  • Top: 311 pt
                  • Left: 156 pt
                  • Bottom: 436 pt
                  • Right: 409 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: Converter::OutputXLS
                  Field Properties Coordinates Field Format Field Behavior Quick Find
                  • Top: 311 pt
                  • Left: 696 pt
                  • Bottom: 436 pt
                  • Right: 949 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: Converter::OutputXLSX
                  Field Properties Coordinates Field Format Field Behavior Quick Find
                  • Top: 53 pt
                  • Left: 696 pt
                  • Bottom: 178 pt
                  • Right: 949 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: Convert to new format
                    Additional Properties:
                  • Change to hand cursor over button
                  • Rectangular
                  • Top: 109 pt
                  • Left: 492 pt
                  • Bottom: 140 pt
                  • Right: 631 pt
                  • Anchoring: Left, Top
                  		 Perform Script [ “Convert from old to new”; Parameter: "BX" ]

                  Scripts:

                  Button Properties Coordinates Script/Script Step
                    Type:
                  • Text: Convert to old format
                    Additional Properties:
                  • Change to hand cursor over button
                  • Rectangular
                  • Top: 367 pt
                  • Left: 492 pt
                  • Bottom: 398 pt
                  • Right: 631 pt
                  • Anchoring: Left, Top
                  		 Perform Script [ “Convert from new to old”; Parameter: "XB" ]

                  Scripts:

                  Button Properties Coordinates Script/Script Step
                    Type:
                  • Text: Copy to input
                    Additional Properties:
                  • Change to hand cursor over button
                  • Rectangular
                  • Top: 187 pt
                  • Left: 738 pt
                  • Bottom: 218 pt
                  • Right: 877 pt
                  • Anchoring: Left, Top
                  		 Set Field [ Converter::InputXLSX; Converter::OutputXLSX ]

                  Fields:

                  Button Properties Coordinates Script/Script Step
                    Type:
                  • Text: Copy to input
                    Additional Properties:
                  • Change to hand cursor over button
                  • Rectangular
                  • Top: 445 pt
                  • Left: 738 pt
                  • Bottom: 476 pt
                  • Right: 877 pt
                  • Anchoring: Left, Top
                  		 Set Field [ Converter::InputXLS; Converter::OutputXLS ]

                  Fields:

                  Button Properties Coordinates Script/Script Step
                    Type:
                  • Text: Clear
                    Additional Properties:
                  • Change to hand cursor over button
                  • Rectangular
                  • Top: 187 pt
                  • Left: 906 pt
                  • Bottom: 218 pt
                  • Right: 967 pt
                  • Anchoring: Left, Top
                  		 Set Field [ Converter::OutputXLSX; "" ]

                  Fields:

                  Button Properties Coordinates Script/Script Step
                    Type:
                  • Text: Clear
                    Additional Properties:
                  • Change to hand cursor over button
                  • Rectangular
                  • Top: 445 pt
                  • Left: 906 pt
                  • Bottom: 476 pt
                  • Right: 967 pt
                  • Anchoring: Left, Top
                  		 Set Field [ Converter::OutputXLS; "" ]

                  Fields:

                  Buttons

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

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

                  Script Hierarchy

                  Convert from old to new
                  Convert from new to old
                  InitXL

                  Next Script: [Convert from new to old]
                  Script Name Convert from old to new
                  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 file
                    • Set Variable [ $book1; Value:MBS("XL.LoadBook"; Converter::InputXLS) ]
                    • If [ MBS("iserror") ]
                    • Show Custom Dialog [ Title: "Failed to load Excel file"; Message: $book1; Default Button: “OK”, Commit: “Yes”; Button 2: “Cancel”, Commit: “No” ]
                    • Exit Script [ ]
                    • End If
                    • # New XML book
                    • Set Variable [ $book2; Value:MBS("XL.NewBook"; 1) ]
                    • # Copy content
                    • Set Variable [ $r; Value:MBS("XL.CopyContent"; $book1; $book2) ]
                    • # Save new book
                    • Set Variable [ $data; Value:MBS( "XL.Book.Save"; $book2; "converted.xlsx" ) ]
                    • If [ MBS("iserror") ]
                    • Show Custom Dialog [ Title: "Save failed"; Message: $data; Default Button: “OK”, Commit: “Yes”; Button 2: “Cancel”, Commit: “No” ]
                    • Else [ ]
                    • Set Field [ Converter::OutputXLSX; $data ]
                    • End If
                    • # Free memory
                    • Set Variable [ $r; Value:MBS( "XL.Book.Release"; $book1 ) ]
                    • Set Variable [ $r; Value:MBS( "XL.Book.Release"; $book2 ) ]
                    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: [Convert from old to new] Next Script: [InitXL]
                          Script Name Convert from new to old
                          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 file
                            • Set Variable [ $book1; Value:MBS("XL.LoadBook"; Converter::InputXLSX) ]
                            • If [ MBS("iserror") ]
                            • Show Custom Dialog [ Title: "Failed to load Excel file"; Message: $book1; Default Button: “OK”, Commit: “No”; Button 2: “Cancel”, Commit: “No” ]
                            • Exit Script [ ]
                            • End If
                            • # New XML book
                            • Set Variable [ $book2; Value:MBS("XL.NewBook"; 0) ]
                            • # Copy content
                            • Set Variable [ $r; Value:MBS("XL.CopyContent"; $book1; $book2) ]
                            • # Save new book
                            • Set Variable [ $data; Value:MBS( "XL.Book.Save"; $book2; "converted.xls" ) ]
                            • If [ MBS("iserror") ]
                            • Show Custom Dialog [ Title: "Save failed"; Message: $data; Default Button: “OK”, Commit: “No”; Button 2: “Cancel”, Commit: “No” ]
                            • Else [ ]
                            • Set Field [ Converter::OutputXLS; $data ]
                            • End If
                            • # Free memory
                            • Set Variable [ $r; Value:MBS( "XL.Book.Release"; $book1 ) ]
                            • Set Variable [ $r; Value:MBS( "XL.Book.Release"; $book2 ) ]
                            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: [Convert from new to old]
                                  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" ]
                                    • #try again with automatic mode (empty path), which looks into the plugin/extension folder for the library.
                                    • Set Variable [ $path; Value:"" ]
                                    • Set Variable [ $r; Value:MBS( "XL.Initialize"; $path; $LicenseeName; $LicenseKey) ]
                                    • End If
                                    • 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: Converter

                                                  Used functions: