Dynamic Field Configurations

Dynamic Field Configurations

Article Type: How-To Audience: Developers, App Admins Module: How To

Dynamic Fields in the Fuuz Screen Designer are essential for optimizing performance and ensuring a smooth user experience. This guide explains how to configure Dynamic Fields effectively.

Key Concepts

Payload Array

The payload array refers to fields coming in as the payload to the transform — any field directly referenced in the transform. Common examples include a table's rowData and a form's filter transform id.

Note: The transform payload can also be referenced by $ (e.g. $.id or $.rowData).

Context Array

The context array refers to fields coming from the transform context — any field from a "variable" starting with $. Common examples include $components, $metadata, and $parent.

Important: When referencing context fields in a transform's Dynamic Fields, use the full path without the $ at the start. For example, if your transform uses $components.Form1.data.id, your Dynamic Fields should look like this:

{
  "payload": [],
  "context": ["components.Form1.data.id"]
}

Best Practices

Do not put $ at the start of components in the Dynamic Fields of a transform. Optimize your arrays: if your transform isn't referencing anything from the payload, set the payload array to []; similarly, if it isn't referencing anything from the context, set the context array to [].

Purpose of Dynamic Fields Arrays

The main purpose of the Dynamic Fields arrays is to enhance performance by preventing unnecessary reruns of your transform. Your transform will only run when a field referenced in either array changes, pulling the same value from the cache if nothing has changed.

By following these guidelines, you can ensure that your transforms are efficient and your user experience remains smooth.

See Also

• Field-Level-Help
• Expressions
• Composition
• Slow-Transform-Performance-JSONata-vs-JavaScript-Optimization-Guide

---

Source: support.fuuz.com