28min

Zeroqode Toolbox

Introduction

ÔĽŅ

This free plugin is a list of tools for working with bubbles. It enables you to Run JavaScript code as well as Generate JSON objects with relevant data for doing an easy search inside your DataBase. Imagine you have an app with stores and you'd like to find orders made in them in a radius of 100 km. This plugin helps lightly filter the information you need by keyword and location. Additionally, it helps you to capture errors from the console logs from your app.

ÔĽŅ

INSTRUCTIONS:

The plugin comes with four elements: CustomJS, Search, Error Capture, and Parse XML.

ÔĽŅ

  • Use the¬†Custom JS¬†element and its action "Run js CustomJS"¬†to initialize your custom javascript.¬†
  • Use the second element-¬†Search¬†and its action "Get Data From a Search"¬†for a search for values by a given key from the database and generate a JSON file. With an extended action filter and you can find any information, you need from the database table.¬†
  • Use the third element -¬†Error Capture¬†to capture errors from the console in your app.¬†
  • Use "Parse XML" element to display the XML content into Repeating Group.¬†

ÔĽŅ

ÔĽŅ

How to setup

ÔĽŅ

The plugin comes with four elements: CustomJS, Search, Error Capture, and Parse XML.

Custom JS element.

This element initializes your custom javascript. 

ÔĽŅ

Actions

ÔĽŅ

Document image

ÔĽŅ

Fields

Title

Description

Return a list

If you want to return a list in the states, enable the checkbox

Code js

When you want a state to be returned it is necessary to call the function "zeroQodeExportDateinState function (ValuForState)". 

ÔĽŅ

ÔĽŅ

Events

Event name

Triggered when

Custom JS Completed

This event is triggered when JS has run successfully.

Custom JS Error

This event is triggered when your script returned an error.

ÔĽŅ

Exposed states

State title

State value

Return your value

if you returned a single value, it will be contained here.

Return your list with values 

if you returned a list of values, it will be contained here.

ÔĽŅ

Search element

This element is used for a search for values by a given key from the database on the backend side and generates a JSON file. 

Document image

ÔĽŅ

Fileds:

Title

Description

Type of Content

Set here the data type that belongs to the plugin (Bubble search result).

ÔĽŅ

Actions

Get Data from Search - it is an action that will return data from the database according to the constraints that will be set by you.

Document image

ÔĽŅ

Document image

Title 

Description

Object Type

select the object you want to search

Selected fields

write the name of the fields you want to receive.

Key

This is the name of the field to which the constraint applies. You can also use the reserved key _all for full-text database searches.

Constraint_type 

This is the type of constraint you want to apply. It can be:

  1. equals or not equal use to test strict equality, for all field types. 
  2. is_empty or is_not_empty use to test whether a thing's given field is empty or not, for all field types. 
  3. text contains or not text contains Use to test whether a text field contains a string, for text fields only.
  4. greater than or less than use to compare a thing's field value relative to a string or number, for text, number, and date fields.
  5. in or not in use to test whether a thing's field is in a list or not, for all field types.
  6. contains or not contains Use to test whether a list field contains an entry or not, for list fields only. 
  7. empty or not empty use to test whether a list field is empty or not, for list fields only. 
  8. geographic_search Use to test if the current thing is within a radius from a central address. To use this, the value sent with the constraint must have an address and a range.

ÔĽŅ

Value 

This is the value against which the constraint should be compared. This can be a string, a number, a list, and so on, depending on the type of field defined by the key in the current constraint. If the value type is invalid, Bubble returns a 400, "INVALID_DATA" error. The value must be at least 5 characters.

A particular case of a key of type address and a constraint_type set to geographic_search, the value should be an object with the following keys

Origin_address 

The central address that defines the center of the search, should be a string address.

Range

The range of the radius, is defined in miles or kilometers, depending on the unit. 

Unit 

The unit to use for the search. It can be miles (default) or km.

Constraints with an undefined value are ignored. Do not use '_id' as a key for a constraint. Instead, use the call that retrieves a thing by ID.

You can control how the list is sorted using two parameters: sort_field and descending

Sort field

Specify the field to use for sorting.

Descending

This parameter can either be true or false (default).

Download JSON

enable checkbox if you want to download the JSON file. 

File Name

JSON file name

ÔĽŅ

ÔĽŅ

ÔĽŅ

E—Öposes States

State title 

State value

Result

Contains lists of data grouped by user-defined field names.

For instance, If you set the Selected fields to be Types, description, geographic_search, number then in the Result Bubble Object state, you'll have access to the aforementioned fields in this fashion: field1 to get Types, field2 for description, and so on ... Each of these fields is a list of values from your Bubble object. So, field1 # 1 is the first name item from your Bubble object, field1 # 2 is the second one, and so on ...

ÔĽŅ

ÔĽŅ

ÔĽŅ

Error Catcher

If you think that one of our plugins is throwing an error, all you have to do is place this element on the page where the problematic plugin is located, and the error will be reported to the Zeroqode team, and when contacting our support team, they will have additional information.

Document image

Parse XML

This element will help you to display the XML template in a repeat group.

Actions

Convert Parse XML- this action will help you display an XML in the Repeating Group.

ÔĽŅ

Document image

ÔĽŅ

Fields

ÔĽŅ

Title 

Description

XML Content 

enter the XML content.

Selected fields

select the fields you want to get from XML.

ÔĽŅ

ÔĽŅ

Exposes States

State Title

State Value

Result

Contains lists of data grouped by user-defined field names. 

For instance, If you set the Selected fields to be, then, in the Result Bubble Object state, you'll have access to the aforementioned fields in this fashion: field1 to get name, field2 for price, and so on ... Each of these fields is a list of values from your XML. So, field1 # 1 is the first name item from your XML, field1 # 2 is the second one, and so on ...

ÔĽŅ

Send XML/JSON data to API backend workflows

If you need to save a JSON or XML to the database, create "backend workflows in the API", setting in the action of the URL plug that leads to endpoints created on the backend and the XML / JSON content

Document image
Document image

After the call has been successfully initialized, delete the word initialize.

Changelogs

  • 19.02.2022 - fixed problem with search a big list -¬†Version 1.8.0.

Demo to preview the settings

ÔĽŅ