From 1061042553353c440ea2c636cc11f57b4aa1c639 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Furkan=20Arabac=C4=B1?= Date: Wed, 8 Apr 2026 17:47:25 +0200 Subject: [PATCH] Document Nanoflow Commons storage limitations for OFF-843 Add comprehensive Limitations section explaining that Get/Set storage item actions use native encrypted async storage (key-value), which is separate from Mendix offline database. Key points documented: - No association support - only entity data is serialized - No entity access rules - bypasses Mendix data layer - Page state dependency - cleared on account switch - Manual association reconstruction required Added warning alert directing users to offline database for relational data needs. Co-Authored-By: Claude Sonnet 4.5 --- .../modules/nanoflow-commons.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/content/en/docs/marketplace/platform-supported-content/modules/nanoflow-commons.md b/content/en/docs/marketplace/platform-supported-content/modules/nanoflow-commons.md index 018039e65a6..df16e6971f3 100644 --- a/content/en/docs/marketplace/platform-supported-content/modules/nanoflow-commons.md +++ b/content/en/docs/marketplace/platform-supported-content/modules/nanoflow-commons.md @@ -48,6 +48,21 @@ The [Nanoflow Commons](https://marketplace.mendix.com/link/component/109515/) mo | | Get platform | | | Wait | +### Limitations of Get/Set Storage Item Actions {#limitations} + +The **Get storage item** and **Set storage item** actions use the device's native encrypted async storage mechanism (key-value storage). This storage is completely separate from the Mendix offline database and does not have any relationship with Mendix's entity model, entity access rules, or association capabilities. + +Key limitations: + +* **No association support** – When you store entities using **Set storage item object** or **Set storage item object list**, only the entity data itself is serialized and stored. Entity associations are not preserved. The storage mechanism has no concept of Mendix associations, referenced entities, or relational data structures. +* **No entity access rules** – Security and entity access rules defined in your domain model do not apply to data stored in device storage. The storage actions bypass the Mendix data layer entirely. +* **Page state dependency** – Mendix internally maintains a "page state" that tracks associated entities when objects are loaded into memory. This page state is session-scoped and is cleared when the user signs out or switches accounts on a native device. Any associations that depend on this page state will be lost when the session ends. +* **Manual association reconstruction required** – If your application needs to work with associated entities after retrieving objects from local storage, you must explicitly retrieve and reconstruct those associations in your nanoflow logic. For example, if Entity A references Entity B, you must separately retrieve Entity B after loading Entity A from storage. + +{{% alert color="warning" %}} +The local storage actions are intended for simple key-value storage use cases such as caching user preferences, temporary state, or serialized data that does not rely on associations. For complex relational data or entities that require association traversal, use Mendix's offline database capabilities instead of the storage item actions. +{{% /alert %}} + ## Read More * [How to Build JavaScript Actions: Part 1 (Basic)](/howto/extensibility/write-javascript-actions/)