Composite Input Controls differ from Basic Input Controls by the means of handling the data. A Composite Input control has more than one component to accept data. For example, currencies are always noted by the value and its unit, say $100 or 100 USD where 100 is the value and $ or USD is the unit. Hence Currency is termed as a composite input control.
Like basic input controls, a composite control will accept single unit of data along with its unit. Studio uniquely identifies these units basis the components it has. For example, in the above image, since Currency has two components, they can be uniquely identified across the app using currency.Value & currency.Unit and correspondingly will be stored in the sheets as well.
Following are the Composite Input Controls available in Studio -
- Name - This is a special control which consists of three components - Titles or Prefix, First Name & Last Name. These components are used to accept full name in three different components and to access these components uniquely, you need to use the following format - <control_name>.prefix
where control_name is the unique name of the control (based on the label). Refer the below image to see the format of Name control.
You can also customize the Name control by hiding Prefix & Last Name part of the control. This can be done by changing the toggle values of Hide Prefix & Hide Last Name respectively under the Properties section.
In sheets, the data from a Name control is stored in the corresponding columns for Prefix, First Name & Last Name as shown in the below image.
- Address - An Address control has the following components -
Address Line 1 & Line 2 - these two components are used to capture Address
City - this component is used to capture City
State - this component is used to capture State
Country (drop down) - this component is used to capture County
Zip - this component is used to capture Zip code
Location - this will fetch the address based on the current location of the device (You need enable GPS/Location permission for this feature to enable)
- Currency - As mentioned earlier, Currency control has two components - Value & Unit where value accepts Currency value in decimals and Unit is selection list to select the currency unit i.e. USD, GBP, INR, etc. In order to access the Value & Unit components of the Currency control, you need to use unique name as currency.Value & currency.Unit respectively.
You can customize the Currency control by selecting a default option for Currency Unit and disabling the list selection by turning off the Allow Selection property.
To fetch data from a Currency type column from a sheet, you need to use the following format -
<Sheetname>.<columnname>.Value to fetch the value and <Sheetname>.<columnname>.Unit to fetch the corresponding unit. For example, a sheet "StudioDocumentation" has a column named "currency"; it will store data in Value & Unit sub columns as shown in the below image.