Monkeybread Software - MBS FileMaker Plugin: Change Column Names

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

MBS FileMaker Plugin Example Databases

Change Column Names

All examples are included with download of MBS FileMaker Plugin.

Change Column Names.fmp12

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

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	Off
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
Excel test	7 fields defined, 1 record		Excel test

Fields

Table Name: Excel test - 7 Fields
Field Name	Type	Options	Comments	On Layouts	In Relationships	In Scripts	In Value Lists
Primärschlüssel	Normal, Text	Auto-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
Erstellungszeitstempel	Normal, Timestamp	Auto-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
ErstelltVon	Normal, Text	Auto-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
Änderungszeitstempel	Normal, Timestamp	Auto-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ändertVon	Normal, Text	Auto-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
Input	Normal, Binary	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1		Excel test		Import
Output	Normal, Binary	Auto-Enter: Allow editing Validation: Only during data entry Storage: Repetitions: 1		Excel test		Import

Layout Objects: Excel test

Regular Fields

Field Name: Excel test::Input

Layout Name:

Excel test

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

Field Name: Excel test::Output

Layout Name:

Excel test

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

Type:

Text: Change Column Names

Layout Name:

Excel test

Top: 94 pt
Left: 415 pt
Bottom: 135 pt
Right: 589 pt

Anchoring: Left, Top

Perform Script [ “Import” ]

Scripts:

Import

Script Hierarchy

InitXL

Import

Next Script: [Import]

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	Import
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

Previous Script: [InitXL]

Script Name	Import
Run script with full access privileges	Off
Siri Shortcut Visible	Off
Include In Menu	Yes
Layouts that use this script	Excel test
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 ] #we add 1 as you probbaly have demo version Set Variable [ $row; Value:$row + 1 ] #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 folders:Yes ] Set Variable [ $r; Value:MBS("XL.Book.Release"; $book) ]
Fields used in this script	Excel test::Input Excel test::Output
Scripts used in this script	InitXL
Layouts used in this script
Tables used in this script	Excel test
Table occurrences used by this script	Excel test
Custom Functions used by this script
Custom menu set used by this script

Download example: Change Column Names

Used functions: