Migration from SAMO Browse

Deprecated Properties

The following properties are deprecated and must not be used in new configurations. They continue to be accepted at runtime for backward compatibility but will not receive bug fixes.

Deprecated property	Replace with	Notes
id	views.id	Only needed when views.enabled: true.
listViewsEnabled	views.enabled: true	Also set views.id.
listDisplayType	list.activeView	Values "auto" and "list" no longer exist.
listDisplayOptions	list.views	Same value mapping.
allEntities: true	entitiesGroup: "_all"	Direct replacement.
defaultView	(removed)	No direct equivalent. In "default" layout mode, panel visibility is controlled by the user via the layout picker.
canChangeView: false	list.views: ["table"]	Single-item array locks the view.
hiddenIntents (top-level)	list.hiddenIntents	Moved under list.
filter.default	advancedFilter.defaultQuery	Only when advanced filter is enabled.
filter.context	(removed)	No equivalent; context is auto-derived.
disableExport: true	list.export.enabled: false	Logic is inverted.
canEdit	permittedOperations.edit	Boolean value maps directly.
multiSelectDisabled: true	list.multiSelectEnabled: false	Logic is inverted.
detailOnly	(removed)	Use layout configuration instead.
title	(removed)	Was used for map print title only.

Migration Tool

Paste your existing samo-browse JSON configuration below to get the equivalent samo-viewer configuration. Any properties that require your attention will be listed as warnings below the output.

samo-browse configuration (JSON){ "type": "component:entity-modules/browse/samo-browse", "entitiesGroup": "assets", "security": { "loggedIn": true }, "defaultView": "table", "search": { "default": "", "context": "search" }, "filter": { "default": "status:active" }, "allowAdvancedFilter": true, "additionalFilterProperties": [ "at_type", "at_state" ], "canEdit": true, "canChangeView": true, "allowLoadAll": true, "loadByPage": true, "itemsPerPage": 25, "detailContext": "detail", "editDetailContext": "edit", "listDisplayType": "table", "listDisplayOptions": [ "auto", "table", "tiles" ], "disableColoring": false, "listExport": { "enabled": true }, "columnAggregations": { "columns": [ "count" ], "hideByDefault": false }, "insertEntities": [ { "entity": "Asset", "title": "Create Asset", "detailContext": "create" } ], "permittedOperations": { "create": true, "edit": true, "delete": false }, "defaultSort": [ { "property": "name.sort", "order": "asc" } ], "map": { "extends": "default", "context": "common" } }

samo-viewer configuration (JSON)

{ "type": "component:entity-modules/viewer/samo-viewer", "entitiesGroup": "assets", "security": { "loggedIn": true }, "allowLoadAll": true, "permittedOperations": { "create": true, "edit": true, "delete": false }, "map": { "extends": "default", "context": "common" }, "list": { "activeView": "table", "views": [ "table", "tiles" ], "coloringEnabled": true, "pagination": { "enabled": true, "itemsPerPage": 25, "itemsPerPageOptions": [ 25 ] }, "export": { "enabled": true }, "aggregations": { "enabled": true, "columns": [ "count" ], "visible": true } }, "detail": { "detailContext": "detail", "editContext": "edit" }, "filter": { "defaultQuery": "", "additionalProperties": [ "at_type", "at_state" ] }, "advancedFilter": { "defaultQuery": "status:active", "enabled": true }, "insert": { "entities": [ { "entity": "Asset", "title": "Create Asset", "detailContext": "create" } ] }, "dataSource": { "sort": [ { "property": "name.sort", "order": "asc" } ] } }

4 warnings

Unsupported property 'defaultView' was dropped during migration to samo-viewer. defaultView has no equivalent in samo-viewer. The layout is saved in localStorage and restored when the page is revisited or refreshed. To force the map view (e.g. when sharing a link), add the url param map=true.

'search.context' has no equivalent in samo-viewer and was dropped. Remove it from your config.

Deprecated property 'canEdit' was ignored because 'permittedOperations' is already set. Remove 'canEdit' from your config.

Unsupported property 'canChangeView' was dropped during migration to samo-viewer. canChangeView has no equivalent in samo-viewer. To prevent view switching, provide only a single entry in list.views.