Ubidots offers a special environment, different than your main account that allows you to perform tests for pre and post-deployment tasks of devices, as well as a way of testing new features. In this test environment you can use the following modules:
Requirements
Active Ubidots Enterprise account or above.
1. Available Entities
Below is the list of the available entities in the test environment.
Entity | Availability |
Devices and variables | ✓ |
Device types | ✓ |
Device groups | ✓ |
UbiFunctions | ✓ |
Plugins | ✓ |
Dashboards and widgets | ✓ |
Events | ✓ |
Analytics | ✓ |
Users | ✓ |
Roles | ✓ |
Organizations | ✓ |
Apps | ✓ |
My Profile → Usage | ✓ |
My Profile → My account | ✓ |
My Profile → API credentials | ✓ |
My Profile → Plans and Billing | ✗ |
My Profile → Email configuration | ✗ |
Admin users | ✗ |
Note that each entity is independent of the main account so the changes made while in this environment are only visible there.
2. Enable the test environment
Step 1: Go to My Profile in your account and, while in "My Account", scroll down until you reach the "preferences" section.
Step 2: Turn the "test environment" button on.
Step 3: Go to the profile drop-down menu and click on "Go to test account".
Step 4: A dialog will appear with the warning that your main session will be closed, click yes to continue. Once the testing environment is opened, you will be logged in as a new user with the username testing-<username>
. A red banner with the “TEST ENVIRONMENT” message will be displayed to remind you that you’re under the test environment account.
Once you have entered the test environment, you can create and test all the features without affecting your main account. There, you can also interact with all entities, meaning you can perform create, read/view, update, and delete actions, as well as sending data through the HTTP API using either Device Tokens, Organizational Tokens, or Account Tokens. Tokens from the test environment start with the prefix TSFF
, unlike the main account where they start with BBFF
.
IMPORTANT NOTE: When the test environment is active, all Admin users, including the account owner, will access directly to this environment until this functionality is deactivated.
3. Deactivate the test environment
Step 1: Go to My Profile in your account and, while in "My Account", scroll down until you reach the "preferences" section.
Step 2: Turn the "test environment" button off. Changes you make in the test environment are saved so you can resume your testing in the future.
You can deactivate the test environment at any time, just bear in mind that all active sessions will be terminated.