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 Field Parameters
  • Optional Field Parameters
  • Example of View Icon Url

Was this helpful?

  1. Bloc Editor
  2. Fields, Tools and Charts
  3. Charts, Results & Data Feeds

Results Box

PreviousAdvanced Chart Set 1NextSub Blocs, Tools & Components

Last updated 4 months ago

Was this helpful?

A Results Box is a neat way of display data from another bloc and have it appear within the bloc you are working on.

Note: To determine what fields are shown or hidden in the results, this is controlled in the field parameters of the source data. All fields show by default but by using the Field Hidden option setting it wont appear in any Results Box fields. We are working to improve this, so that the fields that are shown or hidden in the results box can be controlled when building the Results box field itself, as opposed to changing parameters on the source field. This will you more freedom to build varying types of Results Boxes from the same bloc.

Note: This field can be used with .docx file tables to generate lists of data in our . More information .

Initial Field Parameters

Parameter
Description

Select Bloc

This is used to find the bloc you are going to load the data from.

Only get data matching local fields

Local Field to check: This is the field on the bloc you are working on, the value of this field will be used to search the bloc you are looking up.

Field to look up: This is the field that will be searched, so basically the value of the local field must equal the value of this remote field. The data shown will only have these matching values.

You can build as many searches as you want using the add button.

Optional Field Parameters

Parameter
Description

View Icon Url

If you enter a Url of the bloc in which the results box is loading data from, into this parameter, it shows an icon in the results box. When this icon is clicked, it will open the Url and you will have access to the matching record inside the Url. There you will be able to update the record and this will pass the new edited record back into your results box.

View Data Popup

If enabled, it will override the 'View Icon Url' option above, and instead, when you click the icon it will show the record in a popup. This will be a view mode only.

Example of View Icon Url

Parameter
Description

Select Remote field to sort by

You can also sort the results by a certain field for a neater display of data.

Tick this box to reverse the order of the results

Used to reverse the order of the results in the Results Box.

Show Delete Icon

Allows you to delete a record from the results box. It will show a delete button .

Allow Editing

When enabled, this shows a little edit icon which allows you to edit records within the results box.

Open Bloc popup to edit the record: When enabled, this opens the record in a new bloc pop up and allows you to edit the data.

Open record to edit in new tab: Allows you to edit the record directly in the bloc where the record is stored by opening a new tab.

Open record in new tab "show more": Allows you to view the record in a new tab where the record is stored.

Only Show the following fields

In this dropdown, you can pick which fields you want to show in the results box. You can show multiple fields using the add button.

Only Refresh the following fields after editing/deleting (Results Boxes or Dropdown/List Fields Only)

This option lets you load selected fields again after you delete or edit a record in another results box.

For example, you may have multiple results boxes in a bloc and when you edit or delete a record in a results box, it may effect the results in another results box. With this option enabled, the results box will update to reflect the changes in its records.

Set Values to Colours

This allows you to have a colour for selected values in your results box.

Record Duplication

Enabled this option if you wish to duplicate records in a results box. For example, if you have invoice 001 in a results box, there will be a duplicate button to press. Once pressed it will create a new record for invoice 002. It will duplicate the invoice and all line items.

To enable this option you must firstly, switch to edit mode and scroll down to 'Record Duplication Settings' and enable 'Show Duplicate Button in Form'. Secondly, you must go back to your results box and enable the 'Record Duplication' Parameter. To access the duplicate button, you will then select the record you wish to duplicate, select show more and in the 'Click to Edit' tab you should see the Duplicate Button.

Apply Bloc Initialisation Actions: See the following documentation for reference:

https://manual.blocworx.com/blocworx-documentation/bloc/the-blocworx-process-flow#stage-1-bloc-initialisation
Template Builder
here
Hide in Data Results Box
A random test of a a Results Box field where the value being looked up is "Hi"
Parameter with Url of bloc in which results box is loading data from
Click the view icon on the left of the record you wish to edit
The view icon opens the url of the record to edit