MBS FileMaker Plugin Example Databases

Change Column Names

All examples are included with download of MBS FileMaker Plugin.

Change Column Names.fmp12

Overview
Tables1
Relationships0
Layouts1
Scripts2
Value Lists0
Custom Functions0
Custom Menus24
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
Excel test
7 fields defined, 1 record
Excel test

Fields

Table Name: Excel test - 7 Fields
Field NameTypeOptionsCommentsOn LayoutsIn RelationshipsIn ScriptsIn Value Lists
PrimärschlüsselNormal, TextAuto-Enter:
  • Context table: Excel test
    Calculation: Get( UUID )
Validation:
  • Only during data entry
  • Not empty
  • Unique
  • Strict validation
Storage:
  • Repetitions: 1
  • Indexing: Minimal
  • Automatically create indexes as needed
  • Index Language: Unicode Raw
Eindeutige ID für jeden Datensatz in dieser Tabelle
          ErstellungszeitstempelNormal, TimestampAuto-Enter:
          • Creation timestamp
          Validation:
          • Only during data entry
          • Strict data type: 4 digit year
          • Not empty
          • Strict validation
          Storage:
          • Repetitions: 1
          • Indexing: None
          • Automatically create indexes as needed
          • Index Language: German
          Datum und Uhrzeit der Erstellung der einzelnen Datensätze
                  ErstelltVonNormal, TextAuto-Enter:
                  • Creation account name
                  Validation:
                  • Only during data entry
                  • Not empty
                  • Strict validation
                  Storage:
                  • Repetitions: 1
                  • Indexing: None
                  • Automatically create indexes as needed
                  • Index Language: German
                  Kontoname des Benutzers, der die einzelnen Datensätze erstellt hat
                          ÄnderungszeitstempelNormal, TimestampAuto-Enter:
                          • Modification timestamp
                          Validation:
                          • Only during data entry
                          • Strict data type: 4 digit year
                          • Not empty
                          • Strict validation
                          Storage:
                          • Repetitions: 1
                          • Indexing: None
                          • Automatically create indexes as needed
                          • Index Language: German
                          Datum und Uhrzeit der letzten Änderung der einzelnen Datensätze
                                  GeändertVonNormal, TextAuto-Enter:
                                  • Modification account name
                                  Validation:
                                  • Only during data entry
                                  • Not empty
                                  • Strict validation
                                  Storage:
                                  • Repetitions: 1
                                  • Indexing: None
                                  • Automatically create indexes as needed
                                  • Index Language: German
                                  Kontoname des Benutzers, der die einzelnen Datensätze zuletzt geändert hat
                                          InputNormal, BinaryAuto-Enter:
                                          • Allow editing
                                          Validation:
                                          • Only during data entry
                                          Storage:
                                          • Repetitions: 1
                                              OutputNormal, BinaryAuto-Enter:
                                              • Allow editing
                                              Validation:
                                              • Only during data entry
                                              Storage:
                                              • Repetitions: 1

                                                  Layout Objects: Excel test

                                                  Regular Fields

                                                  Field Name: Excel test::Input
                                                  Field PropertiesCoordinatesField FormatField BehaviorQuick Find
                                                  • Top: 52 pt
                                                  • Left: 138 pt
                                                  • Bottom: 177 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
                                                  No

                                                  Field Name: Excel test::Output
                                                  Field PropertiesCoordinatesField FormatField BehaviorQuick Find
                                                  • Top: 179 pt
                                                  • Left: 138 pt
                                                  • Bottom: 304 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
                                                  No

                                                  Buttons

                                                  Button PropertiesCoordinatesScript/Script Step
                                                    Type:
                                                  • Text: Change Column Names
                                                  • Top: 94 pt
                                                  • Left: 415 pt
                                                  • Bottom: 135 pt
                                                  • Right: 589 pt
                                                  • Anchoring: Left, Top
                                                  Perform Script [ “Import” ]

                                                  Scripts:


                                                  Script Hierarchy

                                                  InitXL
                                                  Import

                                                  Next Script: [Import]
                                                  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

                                                                  Previous Script: [InitXL]
                                                                  Script NameImport
                                                                  Run script with full access privilegesOff
                                                                  Include In MenuYes
                                                                  Layouts that use this script
                                                                  Scripts that use this script
                                                                    Script Definition
                                                                    Script Steps
                                                                    • If [ MBS("XL.IsInitialized") ≠ 1 ]
                                                                    • Perform Script [ “InitXL” ]
                                                                    • End If
                                                                    • If [ IsEmpty ( Excel test::Input ) ]
                                                                    • Insert File [ Excel test::Input ]
                                                                    • End If
                                                                    • Set Variable [ $book; Value:MBS("XL.LoadBook";Excel test::Input) ]
                                                                    • If [ MBS("iserror") ]
                                                                    • Show Custom Dialog [ Title: "Error loading the Excel document "; Message: $book; Default Button: “OK”, Commit: “Yes”; Button 2: “Cancel”, Commit: “No” ]
                                                                    • Exit Script [ ]
                                                                    • End If
                                                                    • Set Variable [ $sheet; Value:"contacts" ]
                                                                    • Set Variable [ $row; Value:0 ]
                                                                    • If [ 1 ]
                                                                    • #check if we have demo version and can't change row 0. You can remove this block if you purchased a license.
                                                                    • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $book; $sheet; $row; 0; "test") ]
                                                                    • If [ MBS("IsError") ]
                                                                    • Set Variable [ $row; Value:$row + 1 ]
                                                                    • End If
                                                                    • End If
                                                                    • #Change column headers here
                                                                    • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $book; $sheet; $row; 0; "first name") ]
                                                                    • Set Variable [ $r; Value:MBS( "XL.Sheet.CellWriteText"; $book; $sheet; $row; 2; "phone number") ]
                                                                    • #Save book
                                                                    • Set Variable [ $data; Value:MBS("XL.Book.Save"; $book;"newColumnName.xlsx") ]
                                                                    • If [ MBS("iserror") ]
                                                                    • Show Custom Dialog [ Title: "Save failed"; Message: $data; Default Button: “OK”, Commit: “Yes”; Button 2: “Abbrechen”, Commit: “No” ]
                                                                    • Else
                                                                    • Set Field [ Excel test::Output; $data ]
                                                                    • End If
                                                                    • Export Field Contents [ Excel test::Output; Create directories:Yes ]
                                                                    • Set Variable [ $r; Value:MBS("XL.Book.Release"; $book) ]
                                                                    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: Change Column Names

                                                                          Used functions:




                                                                          Links
                                                                          MBS FileMaker tutorial videos