Blocworx Documentation
  • Welcome to Blocworx
  • The structure of Blocworx
    • What is a project?
  • Getting Started
  • How To's
    • How To's
      • Get Started: Build a Simple Module
      • Build a simple invoicing system
  • Page
    • Page Overview
      • Page Sections
      • Modules in Pages
      • Sub Pages
      • URL Links
    • Edit a Page
    • Manage Pages
  • Module
    • Module Overview
      • Module Sections
      • Blocs in Modules
      • Automated Reports
    • Module Editor
      • Add, remove and move Sections and Blocs
      • Edit Module Location & Icon
      • Edit Module Details
      • Import from another Module
      • Delete a Module
      • Make this module available to child instances
    • Manage Modules
  • Bloc
    • Bloc Overview
    • Bloc Front End Overview
      • Data Display
      • Advanced Reports
    • Bloc Editor Overview
    • Pdf & Doc File Template Builder
    • The Blocworx Process Flow
    • Edit Templates
  • Bloc Editor
    • Bloc Form Builder Preview
    • Fields, Tools and Charts
      • Standard Input Fields
        • QR Code
        • Text
        • Large Text Field
        • Checkbox
        • Multi Button
        • Dropdown from List
        • Date/Time Selector
        • Bluetooth (Beta)
        • Button
      • File & Image Fields
        • File Field
        • Multi File Field
        • Image URL Field
      • Linked Data Selection Fields
        • Dropdown from Bloc
        • Autocomplete
        • Radio Buttons From Bloc
        • Checkboxes From Bloc
        • Link Data Field
      • Content Editing Components
        • HTML Field
        • Separator Field
        • Content Editor For User (WYSIWYG)
        • Content Editor (WYSIWYG)
      • User Based Components
        • Create User Pop Up
        • Logged in Users Information
        • User Select Field
        • Signature & Authentication
      • Dynamic Output & Variable Components
        • Time/Date Difference
        • Auto Generate Field
        • Plain Data Field
        • Maths Field
        • Field Merge Builder
        • Label Field
        • Barcode Generator
      • Third Party Integration Components
        • Blocworx Gateway
        • Bartender Integration
        • File Builder
        • Mindee API
      • Charts, Results & Data Feeds
        • Local Data Doughnut Chart
        • Advanced Chart Set 1
        • Results Box
      • Sub Blocs, Tools & Components
        • Submit Button
        • Sub Bloc
        • Cross-Bloc Data Manipulator
        • Bloc List
        • Mail Alert
        • Calendar & Resource Planning
    • Field Create, Edit, Parameters, Rules and Actions
      • Creating a Field
      • Editing a Field
      • Field Parameters
        • Choose hidden options for this field
        • Mobile Configurations
        • Rule and Actions Based Parameters
        • Main Field Parameters
        • Conditional Value
        • Set Character View Limit
        • Conditional Visibility
        • Dynamic Data Update (Update Value Based On Another Date Field)
        • Field Names in Different Languages
        • Manage Field Actions
        • Load Data from Another Bloc
      • Field Rules and Actions
        • Can not be empty
        • Must Be Equal To
        • Cannot Be Equal To
        • Must be Between Two Values
        • Must be at least X number of characters
        • Must be exactly X number of characters
        • Item must have been entered elsewhere
        • Item must not have been entered elsewhere
        • A specific value is required elsewhere
        • A specific value cannot be present elsewhere
        • Populate another local field with data from elsewhere
        • Populate another local field with total from elsewhere
        • Max Allowed Duplicates
        • Can only be numbers/integers
        • Keep Data for Next Entry
        • Must be Certain Format
        • Cannot be Equal Another Local Field
        • Must be equal to another local field
        • Populate another local field with part of this field
        • Populate local field with data from another local field
        • Must have matching equivalent data in another form
    • Bloc Settings
      • Main Bloc Settings
      • Functional Behaviour Settings
      • Bloc Layout and Visibility Settings
      • Data Display Settings
      • User Restricted Data Settings
      • Manage and Build Templates
      • Bloc, User and Role Access
      • List of available Field Slugs
      • Manage Bloc Scheduler
  • Manage Data
    • Manage Data Overview
    • Raw Data and Counting Reports
    • Look Up/Edit Data
    • Find and Replace Data
  • Administration
    • Admin & Development Overview
    • Manage Users
      • Profile Filter
    • Roles & Permissions
      • Roles
      • Permissions
    • Manage Mail Alerts
  • App Settings
    • Sign In With Google
    • Timeout Setting
  • No Code Development
    • Manage Blocworx Instances
      • Parent and Child Instances
    • Edit Theme
    • Manage Modules
    • Manage Pages
    • Extra and Beta Features
Powered by GitBook
On this page
  • Data Filtering Field
  • Trigger Filtering if loaded from Url
  • Don't set value in the form if loaded from Url
  • Data Filtering for Sub Blocs only
  • Apply Profile Filter
  • Submit Data using this field
  • Focus on this field after form submission
  • Focus on this field on initialisation (Text Field Only)
  • This field triggers Local Data Chart Updates
  • Gets Value from Last Entry
  • Prevent Data from being saved
  • Show this field as a counter at the top of the Bloc
  • Exclude this field from being populated when the "Populate Latest Data" or "Use Automotic Saving" options are on.
  • Make this a primary calendar field (beta)
  • Make this field read-only
  • Hide the label for this field
  • Autocomplete field
  • Make this a numeric field
  • Strip Special Characters From Field
  • Hide from data filtering search List
  • Make this a Data Editable Field
  • Is an email address for template exporting
  • Performance Setting: Only Load Dropdown data (and similar) once
  • Force Result Box Refresh

Was this helpful?

  1. Bloc Editor
  2. Field Create, Edit, Parameters, Rules and Actions
  3. Field Parameters

Main Field Parameters

PreviousRule and Actions Based ParametersNextConditional Value

Last updated 1 month ago

Was this helpful?

Below contains the documentation for the main field parameters available as on/off settings for a field.

Data Filtering Field

Currently, there is no way to reset the filtering back to the default state using this feature. We are working towards this in an upcoming release.

Trigger Filtering if loaded from Url

This Parameter enables automatic filtering actions to be triggered when the form is opened via a URL that includes preloaded parameters.

Don't set value in the form if loaded from Url

This Parameter prevents Blocworx from auto-filling this field when values are passed via a URL parameter.

Data Filtering for Sub Blocs only

Apply Profile Filter

This is a very useful parameter if you are building a module where you do not want your seperate clients to access each others data.

Submit Data using this field

Note: If the last field in the bloc is a Text field and the Rules/Actions are being triggered, it will also submit the form.

Focus on this field after form submission

Used for deciding which default field to focus on after a form is submitted. This is useful for scanning where the individual may be entering lots of data and does not want to interact with the screen.

Focus on this field on initialisation (Text Field Only)

This parameter automatically places the cursor inside the specified text field as soon as the form loads or appears on the screen.

This field triggers Local Data Chart Updates

This is currently not available for "Advanced Charts Set 1". For those fields you must click "Build Chart" for each field. We are working on this.

Gets Value from Last Entry

When you load the bloc, or having submitted data on a bloc, this field will always be populated with value of the most recent entry. This is useful for holding onto and looking up data.

Prevent Data from being saved

This parameter prevents data from being saved anywhere in the database.

For the Content Creator Field (WYSIWYG) and Seperator Field this is already default behaviour

Useful for using a field to trigger actions or rules, also useful just displaying data that we have saved elsewhere.

Show this field as a counter at the top of the Bloc

This parameter makes the value of the field appear prominently at the top header area of the bloc, like a live counter or summary.

Exclude this field from being populated when the "Populate Latest Data" or "Use Automotic Saving" options are on.

If you only want a minority of the fields to populate when loading the bloc, then we recommend not using those bloc settings and instead use the "Gets Value from Last Entry" parameter above and apply that parameter to each field you want to populate.

Make this a primary calendar field (beta)

Make this field read-only

With this parameter on you cannot focus on the field and start manually changing the value.

This parameter is only being used for mouse clicks and manual attempts to get to the field. It is currently still possible to affect the value of the field using other rules even with this parameter on. Future releases will contain more advanced options for read-only.

Hide the label for this field

Removes the label from the field on the screen.

Autocomplete field

We will be depreciating this parameter and it will be used for legacy use only once we create an option in the Autocomplete field to allow for it to get data from itself.

Make this a numeric field

This parameter makes the field numeric and creates a more reliable way for other mathematical fields and data to work with it. It defaults the value to two decimal places or rounds it up if there is a trailing 0. E.g. 4.60 would result in 4.6 While there are no rules set in stone for the individual to prevent the user putting in text, they are given a nudge by being shown a red background if they try to add text. As the default number of decimal places is 2 it also rounds a correct number to 2 decimal places, e.g. 4.593 will result in 4.59. You can use the Set the maximum decimal places for the numeric field option that appears underneath to change the number of decimal places.

Please note, we are currently working on an improvement to allow a setting to keep the trailing zeros on a number if desired. E.g. 4.3 with two decimal places would show as 4.30

Strip Special Characters From Field

This parameter automatically removes any special characters from the input entered into that field.

Hide from data filtering search List

This Parameter prevents this field from appearing in the list when someone is using the search/filter function in a results bloc or data view.

Make this a Data Editable Field

Currently this feature only works for the Checkbox field, we are working on applying to as many fields as possible in future releases.

Note: Changing values in the Data Display currently does not trigger rules for data in this record.

Is an email address for template exporting

Performance Setting: Only Load Dropdown data (and similar) once

This Parameter is designed to optimize performance, especially in forms with large datasets or many dropdowns.

Force Result Box Refresh

This Parameter ensures that a Result Box is automatically reloaded/refreshed when this field is updated.

When a value is set on this field the results of a bloc will only show results filtered by the value of this field.

This can used in conjunction with the Bloc Setting to stop any data from being loaded initially. Without that bloc setting turned on, the initial results will not be filtered until this field has a value.

This is the same parameter as the "Data Filtering Field" above but it does not apply unless the bloc is appearing inside another bloc (i.e. unless it is a ).

This parameter forces filtering on the data for the bloc based on the value of this field and it being compared to the value of the users . For instance, if a user has a Profile Filter which is the company they are working for, e.g. "Quality Solutions", with this parameter turned on, the only data that will appear for this user will be the data where the value of this field is equal to "Quality Solutions".

Note: This is just one way to have data filtered. Check out the to see more options.

This parameter submits the form when the for this field are triggered. This is useful for scanners or other inputs where you want to prevent the user needing to clicking the Submit button every time they want to submit the form.

This parameter is interlinked with the chart fields. It used to to go active and pull data. A tab or enter key is required.

and are two bloc settings that both cause the bloc to be populated with the latest data when the bloc loads. However we do not necessarily want this functionality for every single field. For this reason we have this parameter, where you can make an exception to these settings.

Used in conjunction with the data display setting. If selected, this field will be used as the date representing the piece of data that is submitted for the calendar, instead of the default date/time when the data was submitted. For example, if we have a bloc with a date field for making appointments, and we create 10 appointments for the following week. Without this parameter on the calendar will consider the date of the appointments the date they were created (which would be all 10 being on day). If the Date field has this parameter set, the appointments will correctly use the field value to determine where the appointments go.

This field transforms the field into an . With this turned on, as you begin to type, suggested data will appear based on previous entries.

This option allows you to edit data in the . This is useful for quick changes to data.

If using our feature, you can have email addresses prepared in fields in the bloc, so if you decide to send the pdf or docx to someone via email you do not have to manually type the email address. For example, this might useful if you are generating an invoice for a customer and the bloc data has the email address of the customer.

Data Display
Prevent Regular Data from being loaded
Sub Bloc
Profile Filter
User Restricted Data Settings
rules/actions
trigger charts
Autocomplete field
Data Display
Template Builder
Before
After
In this example, Test 1, Test 2 and Test 3 are existing pieces of data
Populate Latest Data
Use Automatic Saving
calendar display