apptive_grid_form 2.5.0

A Flutter Package to display ApptiveGrid Forms inside a Flutter App.

2.5.0

• FEAT: Text and cross reference fields can offer a barcode or QR code scanner. A text field shows a scan button where its FormFieldProperties.enableBarcodeScanner is set – a flag the backend already sent but no Widget acted on. A cross reference field shows one whenever a scanner is available, since that flag is a text field setting and is never set on them; a scan there searches the picker and selects the row right away when exactly one matches, instead of only filtering.
• NOTE: The cross reference picker now reads ApptiveGridOptions while building, to find out whether a scanner is available. A widget test that renders one against a mocked ApptiveGridClient has to answer its options, which a bare mock leaves as null.
• FEAT: Add BarcodeScannerConfiguration. The package ships no scanner of its own – that would force native camera dependencies and a camera usage description on every app using it – so the app passes one through ApptiveGridOptions.formWidgetConfigurations, as it already does for the Places API key. Without it no scan button is shown anywhere, so nothing changes for apps that do not want one.

2.4.1

• FIX: Form Widgets that bring their own layout no longer get a border from the embedding app. CheckBoxFormWidget, AttachmentFormWidget, GeolocationFormWidget, AddressFormWidget, EnumFormWidget, EnumCollectionFormWidget and the date and time fields inside DateTimeFormWidget only set InputDecoration.border, but an InputDecorator picks enabledBorder, disabledBorder, focusedBorder, errorBorder or focusedErrorBorder depending on the field's state and falls back to border only where the matching one is null. Since those are filled from the app's InputDecorationTheme, an app that styles the individual states – a line in the resting state, for example – drew a box around a checkbox or an option list. All five are now set.

2.4.0

• FEAT: ApptiveGridForm and ApptiveGridFormData take a labelPosition. With ApptiveGridLabelPosition.above a field's label is shown as a separate Text above the field instead of as a floating label inside it, which also makes the field's placeholder visible while it is empty. labelStyle styles those labels, defaulting to InputDecorationTheme.labelStyle and then TextTheme.titleMedium. The default stays ApptiveGridLabelPosition.floating, so existing forms are unchanged.
• FEAT: ApptiveGridLabelPosition.above also applies to the sub fields of an address field, so street, post code, city, state and country carry their label above them like every other field instead of mixing both styles within one group.

2.3.1

• FIX: The back button and back gesture work again on the first page of a multi-page form. canPop of the form's PopScope was computed once at build time and never followed the page change, so after visiting a later page – or even on the very first build – leaving the form was silently refused.
• FIX: Depend on cupertino_icons. The attachment source menu (and the new "Record video" button) use CupertinoIcons on Apple platforms, but the icon font was never declared, so apps without their own cupertino_icons dependency rendered question marks instead of icons.

2.3.0

• FEAT: Add AddressFormWidget to support the Address DataType, including a country field and a map/geocoding picker for the address' geolocation.
• FEAT: AddressFormWidget suggests addresses from Google Places while typing the first line and fills all fields from the picked place, restricted to the chosen country like on the web. Custom line1Label / line2Label from the field's FormFieldProperties are honoured.
• FEAT: LocationManager.autocompleteAddress and GoogleMapsPlaces.autocomplete with components and types support.
• REFACTOR: Replace the country name lists with kCountries, carrying ISO alpha-2 codes next to the English and German names.
• FEAT: AttachmentFormWidget honours appendOnlyAttachments (attachments present when the form opens cannot be removed) and typeOverride: videoRecorder (a single "Record video" button instead of the source menu, one clip per field).
• FEAT: Add ResourceFormWidget to select a resource in a DataType.resource field. Options are loaded from the field's resources link and grouped by meta type like on the web.
• FIX: DataType.resource used to be mapped to TextFormWidget, whose cast to StringDataEntity threw at runtime for every form containing a resource field.
• FEAT: AddressFormWidget gets a "use current location" button next to the first line, like the geolocation field: it asks for the location permission, reverse geocodes the device position (preferring a street_address result) and fills every field. The map is opt-in behind a "Show map" / "Hide map" button next to "Determine position".
• FIX: Picking a Places suggestion in AddressFormWidget filled nothing because the details request omitted place_id; it now requests it, reports "Address could not be applied" on failure and leaves the field after applying so the suggestions do not re-open.

2.2.2

• FIX: Load cross reference rows from items with the indexed layout. Cross reference and multi cross reference fields previously failed against real backends with "type 'Null' is not a subtype of type 'List

2.2.1

• CHORE: Bump hand_signature to ^3.1.0 (#146).

2.2.0

• FEAT: Upgrade to Flutter 3.44.0 compatible dependencies (flutter_typeahead ^6.0.0, file_picker ^11.0.0, permission_handler ^12.0.0).
• FIX: Update TypeAheadField API for flutter_typeahead 6.0.0.
• FIX: Update FilePicker API for file_picker 11.0.0.

2.1.2

• FEAT: Resource Type (provisional field implementation)

2.1.1

• FEAT: Rich Text Type.

2.1.0

• FEAT: Flutter 3.16 Support (#132).

2.0.2

• REFACTOR: Use performApptiveLink for Client Functions (#129).
• FIX: Fix Signatures not being submitted in Forms (#131).

2.0.1

• Update a dependency to the latest release.

2.0.0

Note: This release has breaking changes.

• BREAKING REFACTOR: Upgrade to dart 3 (#123).

1.7.2

• FIX: Use easeInOut curve for page transition (#122).

1.7.1

• FIX: Formula type parsing for complex types (#121).

1.7.0

• FEAT: Add support for text blocks in forms (#120).
• FEAT: Add support for paged forms (#119).
• FEAT: Add defaultValue, hidden and disabled property to form fields (#118).
• FEAT: Add formula type (#117).

1.6.1

• FIX: Move translations out of the submit method (#116).

1.6.0

• FEAT: Add option to use a custom button to submit forms (#115).

1.5.0

• FEAT: Add support for ReducedLookUp (SumUp) Type (#112).

1.4.0

• FEAT: Lookup DataType (#111).

1.3.1

• Update a dependency to the latest release.

1.3.0

• FEAT: Upgrade Dependencies for Flutter 3.10 (#108).
• FEAT: Add callback for a newly created entity via form.

1.2.0

• FEAT: Add callback for a newly created entity via form.

1.1.4

• FIX: Enforce country codes for phone numbers in forms (#105).
• FIX: Empty non-required email fields accept empty inputs (#104).

1.1.2

• FIX: Adjust input parsing for the currency form field.

1.1.1

• Update a dependency to the latest release.

1.1.0

• FEAT: Add support for custom additional answer button label through web app.

1.0.0

• Version 1.0.0

0.15.0

• Update apptive_grid_core to 0.15.0
• Add onSavedToPending callback to ApptiveGridForm and ApptiveGridFormData similar to the onSuccess callback to be notified when a Form was submitted and is saved to pending

0.14.4+1

• Fix Bug where ApptiveGridFormData would rebuild when in an "end" state

0.14.4

• Add componentBuilder for building custom form components

0.14.3

• Upgrade apptive_grid_core to 0.14.4
• Fix Lints for Flutter 3.7.0

0.14.2

• Upgrade apptive_grid_core to 0.14.2

0.14.1

• Update apptive_grid_core to 0.14.1
• Keep Time when changing the date in a DateTime Form Field
• Enable Radio/Checkbox Lists for Enum/MultiEnum FormFields

0.14.0

• Upgrade apptive_grid_core to 0.14.0
• Update dependencies

0.13.2

• Add support for DataType.email, DataType.phoneNumber and DataType.signature

0.13.1+1

• Update image_picker

0.13.1

• Add support for new FormDataProperties in forms

0.13.0

• Remove deprecated members
• Adjust File Structure

0.12.4

• Use Border of Theme for Input Textfields for Geolocation and References
• Fix Hint Placement in User and (Multi)CrossReference Widget if no Item is selected

0.12.3

• Thumbnails for Attachments
• Attachments are now using their path when being added

0.12.2

• Use new submitFormWithProgress and display the progress when submitting

0.12.1

• Add support for DataType.currency and DataType.uri

0.12.0

• Query backend when searching for CrossReferences
• Fix Bug where CrossReferences could only be selected if their type was String
• Improve Loading behaviour. Show Loading after validation and disable inputs while form is uploading

Breaking Change

• Remove Fields from HeaderRowWidget
• Remove FilterController and FilterListener

0.11.0

• Updated to apptive_grid_core to 0.11.0
• This includes breaking changes regarding the FormData Model. Most important there is now no dedicated FormComponent per type but one generic one
• Renamed UserReference to CreatedBy
• Add UserFormWidget for DataType.user

0.10.0

• Update apptive_grid_core Package to include breaking Model Changes from Version 0.10.0
• Deprecate FormActions
• Add scrollController, buttonAlignment and buttonLabel to ApptiveGridForm and ApptiveGridFormData
• Add description to forms
• Remove dependency on google_maps_webservice for location search and reverse geocoding
• Deprecate ApptiveLink(GridUri, FormUri, EntityUri, etc) in favor of plain Uri

Breaking Change

• Model changes from apptive_grid_core see here for more details
• Removed spaceUris from User and gridUris from Space
• Remove actions from forms

0.10.0-alpha.6

• Deprecate all ApptiveLink in favor of plain Uri
• Upgraded to dart 2.17
• Remove dependency on google_maps_webservice in favor of a local copy to be able to release stable versions of this package

0.10.0-alpha.5

• Add description to forms
• Upgraded to flutter_lints 2

0.10.0-alpha.4

• Update Core Package to 0.10.0-alpha.4 to include breaking changes to GridField

0.10.0-alpha.3

• Deprecate FormActions
• Add scrollController, buttonAlignment and buttonLabel to ApptiveGridForm and ApptiveGridFormData

Breaking Changes

• Remove actions from forms

0.10.0-alpha.2

• Update Core Package to 0.10.0-alpha.2 to include breaking changes to GridRow

Breaking Change

• Removed spaceUris from User and gridUris from Space

0.10.0-alpha.1

• Update Core Package
• Includes a lot of breaking changes in the Models. Including in FormData

0.9.1

• Use new Attachment System
• Show Error Message in Form Error
• Don't clear data/reload form if the form was loaded

0.9.1-alpha.2

• Show Error Message in Form Error
• Don't clear data/reload form if the form was loaded

0.9.1-alpha.1

• Use new Attachment System

0.9.0

Breaking Changes

• DataType.selectionBox is now DataType.singleSelect
• Due to new external dependencies there is some additional setup required. Please see the README for more details

New Data Types

• DataType.attachment
• DataType.enumCollection
• DataType.multiCrossReference
• DataType.createdBy

New Features

• Rework structure of Uris to be more generic

Bugfixes

• Fixed Multiline Text FormWidgets
• Fix required validation not working for all types if Form has initial data
• Fix stretched submit Loading Indicator

0.9.0-alpha.12

• Add * to label of required fields
• Fix bug where required fields where not validated for long forms
• Reload ApptiveGridForm when FormUri changed

0.9.0-alpha.11

• Use apptive_grid_core: ^0.9.0
• Fix stretched submit Loading Indicator

0.9.0-alpha.10

• Use stable version of apptive_grid_core

0.9.0-alpha.9

• Add Support for DataType.createdBy
• Fix required validation not working for all types if Form has initial data

0.9.0-alpha.8

• Show Loading Indicator while submitting a Form

0.9.0-alpha.7

• Add proper support for DataType.multiCrossReference in Forms

0.9.0-alpha.6

• Add support for DataType.multiCrossReference
• The Form Widget only offers very basic support for now. It only supports selecting single Values from CrossReferenced Grids
• Adjust Attachment Form Widget to offer more options to select attachments from camera, gallery and files

0.9.0-alpha.5

• Fix Multiline Text FormWidgets
• Add Spacing for EnumCollection

0.9.0-alpha.4

• Add support for Geolocation Form Widgets

0.9.0-alpha.3

• BREAKING CHANGE DataType.selectionBox is now DataType.singleSelect
• Add support for DataType.enumCollection

0.9.0-alpha.2

• Fix Required Form Field not updating if required

0.9.0-alpha.1

• Preview support for attachments

0.8.0

• BREAKING CHANGE Requires minSdkVersion for Android to be at least 18

0.7.3+1

• Use Locale for DateTime Formats in DateFormWidget and DateTimeFormWidget

0.7.3

• Add missing translations
  • Hints for DateTimeFormWidget
• Adjust CheckboxForm Widget
  • Remove Error Border
  • Adjust alignment of checkbox and label

0.7.2

• Adding translations to Forms. Right now English and German are supported

0.7.1

• Adding a way to get currentData of a FormWidget

0.7.0

• BREAKING CHANGE Added FormData to onActionSuccess callback to receive the data that was successfully send

0.6.0

• Upgrade to Provider 6.0.1

0.5.0

• BREAKING CHANGE Supporting new Format for RedirectFormUris. RedirectFormUris now take a list of component

0.4.3

• Update Lints

0.4.2

• Adding support for Decimal Data

0.4.1

• Make [FormData.name] optional
• Fix Multiline TextFields

0.4.0

• BREAKING CHANGE FormData and Grid now take named constructor arguments to avoid confusion. Before the order of arguments did not have schema at the same part
• Add name to FormData

0.3.1

• Add support for Authenticating with an API Key

0.3.0+1

• Fix Overflow behavior for Selected Single Select, Selected CrossReference, Grid Cells in CrossReference Previews

0.3.0

• AUTHENTICATION CHANGES
  • In order to fully support Google OAuth you need to add a custom redirect Scheme to ApptiveGridAuthenticationOptions. Also make sure your App can be opened via a deeplink with that scheme

0.2.7+1

• Show null values as empty cells in CrossReferenceFormWidget

0.2.7

• Support CrossReferences in Forms. This still requires Authentication however it is already a first look at how this will look and work

0.2.6

• Update apptive_grid_core to support cached Action
• Expose ApptiveGridFormData Widget to allow building Forms with custom DataSet

0.2.5

• Fix Parsing of Enum Entries

0.2.3

• Fix Refresh Authentication

0.2.1+2

• Make CheckboxFormWidget have no background

0.2.1+1

• Display up to 100 Lines of Field Description
• Fix Overflow in CheckBoxFormWidget
• Fix Display Problems when using Filled InputDecorations for DateTime Components

0.2.1

• Updated ApptiveGridCore to 0.2.1 to use new FormUris

0.2.0

• It's ApptiveGrid now
• Load Forms using FormUri
• Supports accessing Forms with a direct Uri representation

0.1.0

• Initial Release