FM BetterForms
BF Editorfmbetterforms.com
Engineering Reference Docs
Engineering Reference Docs
  • BF Streaming Proxy
  • Updating the Helper File
  • Connection Trouble Shooting Guide
  • Software Testing - Overview
    • Types of Testing
    • UX/UI Checklist
      • Pages
        • Login 🔑
        • Pricing 💵
        • 404 🤷‍♂️
        • Contact Us ☎️
        • Sign Up 👋
        • FAQ ❓
        • Blog Post 🗞
        • Careers 💼
        • Team 👫
        • Cart 🛒
        • Press 📸
        • Search results 🔍
      • Elements
        • Avatar 😁
        • Badge 📛
        • Button 🖲️
        • Card 🃏
        • Table 📏
        • Icon 🌠
        • Text Field ⌨️
        • Toggle 🎛️
        • Loading ⏳
        • Modal 🎉
        • Tooltip 🛠
        • Search 🕵️‍♀️
        • Navigation 🧭
        • Radio 📻
        • Checkbox ☑️
        • Tabs 🗂
        • Toast 🍞
      • Flows
        • Submitting a form 📨
        • Making a payment 💳
        • Contacting support 🆘
        • Deleting account 🗑
        • Tracking progress 📈
        • Resetting password 🤫
        • Showing input error 🚨
        • Entering a promo code 🏷️
        • Saving changes 💾
        • Canceling subscription 🛑
      • Topics
        • Responsiveness 🎚
        • Typography 🔤
        • Dark mode 🌑
        • Accessibility 🚹
        • Colors 🎨
        • UX Writing ✏️
      • Brand
        • Logo 💠
        • Social Media 🔉
        • Typography 🔠
    • FM BetterForms - Quality Assurance
    • JavaScript Libraries
  • Rollbacks and Version Control
  • BF Server Proxy
  • Base code End of Life - 0.8.78-0.8111
  • Setting up Auth0
    • Introduction
    • Getting started
      • Creating a tenant
      • Creating Application
      • Additional customizations
        • Allowed Callback URLs
    • Creating a Database
      • Choosing different login options
        • Social Connections
        • Username and password (Auth0)
        • Creating new BF Users
        • Using Auth0 in an iFrame
        • Configuring FM BetterForms
        • Additional Notes
  • Create an S3 Bucket on AWS
  • ApexCharts - Getting started
  • BF Enterprise Documentation
    • Overview
      • Features
      • Overview Diagram
    • Requirements
    • Env File
    • Setting up the Server
      • Installation
      • Loading image to a local repository
      • Starting server
      • Restarting Policies
      • Scaling up
    • Hardware Recommendations
    • FM Credentials - Helper file
    • How it works
      • Development
      • Downloading environment data
  • BetterForms Error Pages API
    • Introduction
    • Dynamic Error Page
    • Static Error Page
    • Custom error pages
    • Custom error handlers
    • Error Code List
  • BF Streaming API
  • Creating a PWA
    • Introduction
    • Getting Started
      • Making it installable
      • Browser Support
      • Sending Push Notifications
      • Sending a Push Notification from the API Endpoint
      • Adding DOM Header Insertion to be Available for Offline Use
Powered by GitBook
On this page

Was this helpful?

Updating the Helper File

PreviousBF Streaming ProxyNextConnection Trouble Shooting Guide

Last updated 10 months ago

Was this helpful?

Guide to Migrate the Helper File

Below are the steps for migration and configuration of the helper file. Additionally, we recommend familiarizing yourself with the general documentation, which provides answers to many questions.

  1. Download the Helper File using the link below:

  1. Open the Helper File:

Make sure you have the FileMaker installed and open file use below credentials:

User name : admin

Password : admin

A window will appear, prompting you to set a new password.

  1. Change default user and password:

Change the default user and password (admin / admin) to your desired credentials. This password is for file access purposes only and applies solely to this file.

  1. Set Up Your Own Account:

  • Go to File > Manage > Security

  • Click "+New" to create a new account.

  • Type the Account Name, set a Password, and select a Privilege Set.

  • Click OK to save the new account.

  1. Import User Records (If Needed):

  • Open FileMaker Pro.

  • Open the app where you want to import the existing user records.

  • Go to "File" in the menu and select "Import Records."

  • Choose the file format of the existing user records (e.g., Excel, CSV, FileMaker Pro file).

  • Select the file containing the existing user records and click "Open."

NOTE! ( if your old helper file is located on the server, you can specify the path by clicking the "hosts" button when selecting the file. )

  • Map the fields in the import file to the corresponding fields in the app.

Also, make sure that the auto-enter function is turned off.

  • Configure any additional import options as needed.

  • Preview the import to verify the mappings and data.

  • Click the "Import" button to import the existing user records.

At the end, an "Import Summary" window with the results should appear.

  1. Configure Helper File:

  • Ensure the file is hosted on the server.

  • Go to File > Manage > External Data Sources.

  • Click "New" in the "Manage External Data Sources" dialog box.

  • Click "Add File" in the "Edit Data Source" dialog box.

  • Locate and select the new Helper File (click "hosts" if the file is on the server).

  • Choose the FileMaker application and click OK > OK > OK.

  1. Configure Hooks in Script Workspace:

  • Go to Script > Script Workspace.

  • Set up Hooks - “Developer - Transmitter - CONFIGURE HERE”.

  • Type or copy the required items from the previous file and paste them.

  • Click on "Betterforms - App - Receiver and Dispatch" to see them on the Specify Script window.

We can see them on the Specify Script window.

We need to replicate the steps we made in the helper file in the FileMaker application.

  1. Sync App with Frontend:

(If the file is replaced with the same name, there is no change needed in the BF editor. If not, make sure you use the same credentials.)

  • Open the environments list and choose the environment.

  • Click the three dots menu > Edit.

Go to Credentials, select the server, and set up HelperFile Name, Account Name, and Password.

(They should be the same as in your helper file)

  1. Test Connection:

  • Verify if the connection is successful and the records appeared.

  1. Test the functionality of your apps.

Test the connection from frontend to the business file by hitting the API endpoint (e.g., ).

yourapp.com/api
https://docs.fmbetterforms.com/getting-started/integration
https://drive.google.com/file/d/18Ont_4l9Xe1RjtuXZqTtcaLTzBar6kG9/view