Skip to content

Commit 557a38e

Browse files
authored
Merge branch 'main' into marketplace-libraries-submission
2 parents 09bda75 + 0621325 commit 557a38e

File tree

2 files changed

+76
-19
lines changed

2 files changed

+76
-19
lines changed

docs/ff-integrations/database/cloud-firestore/firestore-actions.md

Lines changed: 29 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -261,26 +261,37 @@ com/embed/238400b5445b444db712f492584b0d6e?sid=7b496882-0280-4920-924c-640fddeff
261261

262262
To do so:
263263

264-
1. Ensure you have **Query Collection** or **Document from Reference** added on a widget with **Single Time Query** disabled.
265-
2. Now select the widget, head over to **Actions**, and click **+ Add Action**.
266-
3. Select the **On Data Change** tab. That means actions added under this will be called whenever the data changes.
267-
4. Now, you can
268-
[add any Action](../../../resources/control-flow/functions/action-flow-editor.md#adding-an-action-example)
269-
here.
264+
1. Ensure you have added a **Query Collection** or **Document from Reference** on a widget with **Single Time Query** disabled.
265+
2. Now, on the widget with **Query Collection** or **Document from Reference**, open the **Action Flow Editor** and set **On Data Change** as the [Action Trigger](../../../resources/control-flow/functions/action-triggers.md). This ensures that any actions you add will be triggered whenever the data is updated, added, or deleted.
266+
3. You can now [add any action](../../../resources/control-flow/functions/action-flow-editor.md#adding-an-action-example) you want to perform, such as showing a notification, refreshing the UI, or fetching related data.
270267

271268
:::info
272-
* Actions will be triggered whenever the data is added, updated, or deleted.
273-
* If you are adding this on ListView, ensure you disable the infinite scroll.
269+
If you are using this trigger on a ListView, make sure to **disable** the **Infinite Scroll**.
274270
:::
275271

276-
Here is an example showing the
277-
[**Snackbar**](../../../resources/ui/pages/page-elements.md#show-snackbar-action)
278-
message when the data
279-
changes in a collection.
280-
281-
<figure>
282-
![img_27.png](img_27.png)
283-
<figcaption class="centered-caption">Trigger snackbar action on data change</figcaption>
284-
</figure>
285-
272+
<div style={{
273+
position: 'relative',
274+
paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
275+
height: 0,
276+
width: '100%'}}>
277+
<iframe
278+
src="https://demo.arcade.software/ghFiQWGsQuJu5reUyXnl?embed&show_copy_link=true"
279+
title=""
280+
style={{
281+
position: 'absolute',
282+
top: 0,
283+
left: 0,
284+
width: '100%',
285+
height: '100%',
286+
colorScheme: 'light'
287+
}}
288+
frameborder="0"
289+
loading="lazy"
290+
webkitAllowFullScreen
291+
mozAllowFullScreen
292+
allowFullScreen
293+
allow="clipboard-write">
294+
</iframe>
295+
</div>
296+
<p></p>
286297

docs/ff-integrations/database/supabase/database-actions.md

Lines changed: 47 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,17 @@ Let's see how to filter the Supabase table to display only desired items:
174174
- Find the **Value** property and set it to an appropriate value and click Confirm.
175175

176176
:::tip
177-
You could choose a Filter relation based on your requirements. For example, to show only completed assignments, set the Field Name to the column that holds completed status, e.g., is_done, set the Relation to Equal To, and set the Value to True. Here's another example. For showing only users older than 30, create a column called Age, set the Relation to Greater Than, and set the Value to 30.
177+
You could choose a filter relation based on your requirements. For example:
178+
179+
- **Equal To**: To show only completed assignments, set the **Field Name** to the column that holds the completion status (e.g., **is_done**), set the **Relation** to **Equal To**, and set the **Value** to **True**.
180+
- **Greater Than**: To show only users older than 30, set the **Field Name** to the **age** column, set the **Relation** to **Greater Than**, and set the **Value** to 30.
181+
- **Like**: For filtering addresses with zip codes starting with '35,' set the **Field Name** to the **zip_code** column, set the **Relation** to **LIKE**, and set the **Value** to **35%**. In the value field, you use the following wildcards to perform flexible pattern matching to filter your data effectively.
182+
- **Percent (`%`) Wildcard**: Represents zero, one, or multiple characters.
183+
- Example: `'A%'` matches any string starting with `'A'` (e.g., `'Apple'`, `'Apex'`).
184+
- Example: `'%A%'` matches any string containing `'A'` (e.g., `'Canada'`, `'Australia'`).
185+
- **Underscore (`_`) Wildcard**: Represents a single character.
186+
- Example: `'A_'` matches any two-character string starting with `'A'` (e.g., `'An'`, `'At'`).
187+
- Example: `'A__'` matches any three-character string starting with `'A'` (e.g., `'Ant'`, `'Art'`).
178188
:::
179189

180190
<div class="video-container"><iframe src="https://www.loom.
@@ -204,6 +214,42 @@ com/embed/244eea2a4f694120b08524b7b8cf67de?sid=13d47ef5-5d48-4986-88da-d335ce23b
204214
Additional Note: Currently, you can only add "and" conditions to Supabase query filters. If you want to add an "or" filter like "status == 5 or status == 8", you can consider logic to apply "status in (5,8)" or any other logic. Fully customizable using API calls or custom actions.
205215
:::
206216

217+
## Trigger Action On Data Change
207218

219+
Sometimes, you may want to trigger an action whenever data changes in a Supabase table. For instance, in an ecommerce app, you might want to notify users on the orders page when the status of their order is updated.
208220

221+
To respond to data changes in a Supabase table:
209222

223+
1. Ensure you have added a **Supabase Query** to a widget (e.g., a ListView) with **Single Time Query** disabled to enable real-time updates.
224+
2. On the widget with the **Supabase Query**, open the **Action Flow Editor** and set **On Data Change** as the [Action Trigger](../../../resources/control-flow/functions/action-triggers.md). This ensures that any actions you add will be triggered whenever the data is updated, added, or deleted.
225+
3. You can now [add any action](../../../resources/control-flow/functions/action-flow-editor.md#adding-an-action-example) you want to perform, such as showing a notification, refreshing the UI, or fetching related data.
226+
227+
:::info
228+
If you are using this trigger on a ListView, make sure to **disable** the **Infinite Scroll**.
229+
:::
230+
231+
<div style={{
232+
position: 'relative',
233+
paddingBottom: 'calc(56.67989417989418% + 41px)', // Keeps the aspect ratio and additional padding
234+
height: 0,
235+
width: '100%'}}>
236+
<iframe
237+
src="https://demo.arcade.software/ghFiQWGsQuJu5reUyXnl?embed&show_copy_link=true"
238+
title=""
239+
style={{
240+
position: 'absolute',
241+
top: 0,
242+
left: 0,
243+
width: '100%',
244+
height: '100%',
245+
colorScheme: 'light'
246+
}}
247+
frameborder="0"
248+
loading="lazy"
249+
webkitAllowFullScreen
250+
mozAllowFullScreen
251+
allowFullScreen
252+
allow="clipboard-write">
253+
</iframe>
254+
</div>
255+
<p></p>

0 commit comments

Comments
 (0)