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

StoreRegistration

Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker.

Component Version macOS Windows Linux Server iOS SDK
Plugin 3.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "StoreRegistration"; Licensee Name; component; License Type; Expire Month; Serial number )   More

Parameters

Parameter Description Example
Licensee Name This is the name of the person or organization that holds the license for the plug-in Your Name
component The component that was licensed. For example "Complete"
License Type Seats purchased. For example, "1 seat", "10 seats", "Developer" 1 Seat
Expire Month This is the month in which the serial will expire for new versions of the plug-in in YYYYMM format. Plug-in released before the end of that month will continue to work forever. New Releases after that date will require a renewal 200708
Serial number The license number your serial number

Result

Returns OK on success.

Description

Stores registration on Mac in preferences file of FileMaker so the plugin can auto register itself on startup of FileMaker.
This is very useful for trainings where you want to preinstall license on FileMaker installations.
Added Windows support in plugin version 4.4.

You can clear the license with ClearRegistration function.
Added Linux support for 7.5.

Saves in preferences file on Mac and Linux, saves to registry on Windows.

To store the registration on a FileMaker Server permanently, it is sufficient to call the StoreRegistration function only once by opening a file (e.g. the Registration.fmp12 file) with a OnFirstWindowOpen-Script and a single line of code like this: Set Variable [ $r; Value: MBS( "StoreRegistration"; $name; "Complete"; "5 seat"; $date; $code) ].
After opening it once and thus writing the registration file to the preference file, it can be closed and removed from the server.

Currently on Windows the key is written encrypted to the registry into the HKEY_CURRENT_USER\Software\FileMaker\RegistrationMBS entry. On macOS and iOS, we write a RegistrationMBS entry into the com.filemaker.client.pro12.plist file or for Claris Pro into the com.claris.pro.plist file. For Linux the license is saved to /opt/FileMaker/FileMaker Server/MBS.license file.

If you use this in a vertical solution, please make sure you update the license key before updating the plugin to avoid the user seeing an error dialog about an old license. Also make sure that every major update you make calls StoreRegistration with a new key to replace the old key stored in preferences. And consider getting a multi year update from us, so you only change license key every few years.

Examples

Stores registration:

$r = MBS( "StoreRegistration"; $name; "Complete"; "5 seat"; $date; $code)

See also

Blog Entries

This function is free to use.

Created 18th August 2014, last changed 15th May 2024


StoreKit.Transactions - SyntaxColoring.AddContextMenuCommand