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
  • Initial Parameters Overview
  • Using another Bloc to filter your form list
  • For the Buttons or Link options, choose fields to send data from and to:
  • For the Links with Latest data, type the field slugs of the data you want to see
  • Choose the Fields of the data you want to filter by

Was this helpful?

  1. Bloc Editor
  2. Fields, Tools and Charts
  3. Sub Blocs, Tools & Components

Bloc List

PreviousCross-Bloc Data ManipulatorNextMail Alert

Last updated 9 months ago

Was this helpful?

The Bloc List component allows you to retrieve lists of Blocs in various ways, some include ways of getting data from these blocs.

This tool is useful for building dynamic navigation around your system. Perhaps you may want to load certain blocs based on a specific criteria like the value of data in those blocs. This tool is also used for other features in the Bloc Settings, for example

Another popular use for this tool is to get a quick overview of data in other blocs based on certain values you may want to check.

Initial Parameters Overview

Parameter

Description

Type Module name

If you want to load a list of Blocs outside of the existing module

Select How the blocs get displayed

Allows you to choose how the blocs get displayed on the screen (More info on each option is below)

A normal input field will appear, however when you begin typing it will search/autocomplete all the blocs available to you for clicking (useful if there are a large number)

A dropdown select field will appear with the available blocs.

Buttons will appear, in a similar style to a list of blocs in any module.

Lists links with the latest values in the bloc (can be filtered based on a look up, see below for information). It also includes the number of entries.

Using another Bloc to filter your form list

It is possible to use another bloc entirely to filter the blocs you see based on values you would like to match. For example, even though a module might have 4 Blocs, let's call them Bloc 1, Bloc 2, Bloc 3, Bloc 4, it is possible that you may only want to see Bloc 1 and Bloc 3 for one reason, and Bloc 2 and 4 for another. Using this feature, you can create those rules using a bloc of your choosing.

This feature was originally built to allow customers to filter Test Types. So for instance, for 1 unit they wanted to load all of the tests for that Unit Type, and then load a series of different tests for a different unit.

Parameter

Description

Type Module Name

Used for deciding what module to look up.

Select the local field to watch

Select a local field whose data is used to compare against the filtering bloc.

Select the bloc to use as the filter

Having chosen the module, you can now select the bloc that will be used.

Select remote field from the bloc to compare with local field data

The filtering bloc will need a field that contains the data you will be comparing against.

Select remote field from the bloc that contains the bloc names.

With this parameter you set the field that will contain the bloc names, these names will be how the filtering is determined.

Caution: This feature relies on Bloc names not changing. The titles are used as the means of joining/filtering what to load. We hope to improve this in the feature to allow for Bloc name changes after the field is created.

For the Buttons or Link options, choose fields to send data from and to:

If your list of blocs are appearing as "buttons" or "links with latest data" it is possible to attach data to that url. This means when you load the url the fields with that data will get populated: https://url....?urlFieldSlugData={"part_number":"PART1"} would populate a field with the field slug part_number with the value PART1.

Parameter

Description

Choose Local Field to get data from

Choose the local field whose data will feed into the URL. For example the local field might "Persons Name", the persons name will then get added to the url

Type Field Slug to Update

You must type the field slug of the field in the other bloc that you intend on populating. Note: The reason for having to manually type the field slug is because it is not possible to choose this field using selections because of the dynamic nature of how the blocs load. We will never know what blocs are loading until the user starts using the front end.

For the Links with Latest data, type the field slugs of the data you want to see

This option allows us to choose the fields that will appear in the list of blocs. In the example below there is just one field chosen: "Test Result". Note: We are forced to type field slugs because it is not possible to know what blocs will be loading on the front end.

To see data for that bloc, the field slug must exist in the bloc, otherwise it will just appear as if there is no data. In the example above for instance, it could be said Bloc 3 either has no data added or has no field called "Test Result".

Choose the Fields of the data you want to filter by

For the "Links with Latest Data" option, this feature allows you to filter data based on values in your bloc. This means it will not necessarily just get the latest value, but it will get the latest data that contain values from fields you are using to look up data.

Caution: For similar reasons as the options above, field slugs must be identical across any blocs you would like to filter data by.

This option becomes particular powerful in combination with the set on the bloc that is being linked to. Using this you could load a list of blocs, click on one and instantly just see the data you are concerned with without seeing anything else.

Data Filtering Field parameter
"Can Assign Users to Other Blocs"