Variable Definitions

Each option you expose to a user should be further configured. The configurations give the end-user a lot of help in getting the correct kind of values into each option. 

As you create an option, the Variable Definitions button will be tagged with an indicator of how many variables you need to finish setting up.

When you open up the Variable Definitions window, you see the variables you've already created as well as any new ones. The new ones are highlighted for your attention.

Here is where you complete the setup of each variable.

Variable Setup

In the variable setup window, you have many columns to fill out. Each gives clues to a widget user as to the intention of the variable during the customization process.

Data

This checkbox signifies that the value of this variable, while set here for testing, will be generated via script or Let Variable declaration when this widget is deployed. 

Use this checkbox for data that should come from FileMaker such as a list of appointments or an object of sales data.

Label

The label is the text that will appear in the widget-customization screen. The label will also be used as a variable inside a FileMaker script ( scripted rendering or scripted export) or in the Let Declaration of the embedded web viewer

Labels are required and have to be unique.

Input Type

There are many input types available. These formats make it easy to enter a correct type of value for each option. For example, a popup type limits the data entry to specific values you provide.

Value

The default value. It is always good to enter a default value for the integration. The Color Input type will auto-fill with a gray value, but the rest should have something.

For variables that contain data, you can simply copy and paste the data, be it an object or an array, into this field. Though it is only one line here, you will be able to see and edit the full object.

Help Text

This column isn't required, but it is a space for you to provide info to users about the specific variable.

Possible Values

If you're using a popup or dropdown, a little + will appear and you'll be able to fill in a return-delimited list of the accepted values.

Unit

For number fields, you can type in a unit, such as 1 or 10 or .1 and the user will be able to increment by this amount in the customization space.

By Popular Request

Additionally, two more optional columns can be exposed by clicking the arrows button. These are for organization of the customization options.

Category

It is useful to categorize the variables into groups for widgets with many options. These categories will become the grouping of options in the widget customization area.

Sort

Within each category, you can specify a sort order. This again is useful for laying out options in a logical manner.

Read more about these columns in the General Variable tips.