Scoping with Namespaces

​

Overview

Namespaces allow you to narrow down the scope of Spaces, Workbooks, and Sheets. When you’re monitoring for specific events, you can set your system to only respond if the event matches the assigned namespaces.

Namespaces enable you to have:

1. Global Listeners: These are listeners set up to monitor activities across all your Spaces.

2. Specific Listeners: These listeners are restricted to monitor and respond only within a certain subset of your spaces defined by the assigned namespace.

​

Usage

// Create a global listener
listener.on("**", event => { ... });

// Create a filter scoped for a specific namespace
listener.namespace(['space:green'], (green) => { ... });

​

Space-level

Space-level Namespaces are straightforward strings that are established or modified when you create or update an App. This adds an additional layer of control and specificity to your Space.

​

Usage

This listener is established for the ‘red’ namespace within a ‘space’. When a job titled space:configure (clicking create new space button in UI) in the ‘red’ namespace (type red as namespace in the form) is ready, it triggers the subsequent block of code.

This code will color your Space red to see that it worked.

​

Workbook/Sheet-level

Workbook & Sheet-level Namespaces are straightforward strings that can be established or modified when you create or update the Workbook. This adds an additional layer of control and specificity to your Workbook.

​

Usage

This code dynamically generates a configuration for a ‘Contacts’ workbook based on the provided namespace parameter. Depending on the input namespace to the ChildWorkbook function, additional fields may be added. If the namespace is ‘orange’, fields for ‘Phone’ and ‘Meal Choice’ are added. If it’s ‘yellow’, fields for ‘Shirt Size’ and ‘Car Choice’ are added.