Console FAQ
This document answers common questions about using the console.
Project authorization
Feature definitions
- How do I delete a private brand app in the IoT Platform?
- If a device property is defined as a JSON object, can I report data using a JSON array?
- The weekly repetition parameter is not available in the local scheduling properties on the console.
- What is the difference between 'synchronous' and 'asynchronous' for services in feature definitions?
Device debugging
- The 'Script relationship does not exist' error is prompted when you use the device debugging feature
- In the console's device debugging message analysis, why do I receive a 'message content not found' error when clicking a blue MessageID?
- After editing and debugging a script, why do I receive an 'impersonated input does not conform to Alink protocol format' error when the impersonated input device receives data?
Human-computer interaction
- When using a public app, why can't I change the device sharing method?
- Why is there no corresponding component in the console interface for a newly created custom property?
- For a floating-point read/write property's scroll widget, why does the panel show a different step size than the one set in the feature definition?
Product publishing
- Do I need to perform listing tests or send samples to Alibaba when publishing a product?
- If I revoke a product's publication after mass production, will it affect products that have already been sold?
- After a product is published and shipped, if I modify the value range of a read-only property, is a device-side OTA upgrade required?
- Can I use test devices that are added after a product is published?
Operations Hub
- During a batch upgrade, why can't I find the devices to upgrade under the corresponding firmware version?
- After creating an account, why can't I see the registered account information in the user list of the management console?
Why do I get an 'Access Denied' error when adding a sub-member in project management?
This error occurs because the account is a sub-member and does not have permission to add new members.
How do I delete a private brand app in the IoT Platform?
Private brand apps cannot be deleted after they are created. You can create a new project instead.
If a device property is defined as a JSON object, can I report data using a JSON array?
Yes, you can. Define the property as a JSON object. If you use a JSON array, you must nest the array within the value of the JSON object.
Why can't I find the 'repeat by week' parameter for local timed properties in the console?
This is because the timer uses the cron format, which includes information for weekly repetition.
What is the difference between 'synchronous' and 'asynchronous' for services in feature definitions?
- Synchronous interaction: When you send a request, you must wait for a response before you can send the next request. This creates a waiting period.
- Asynchronous interaction: When you send a request, you do not need to wait for a response. You can send another request at any time.
'Script relationship does not exist' message when using the device debugging feature
For more information, see the device debugging document. If the product uses the pass-through protocol, you must first submit a script in the background.
After editing and debugging a script, why do I get an 'impersonated input does not conform to Alink protocol format' error when the impersonated input device receives data?
This error can occur on the Device Debugging page under Data Parsing for the following reasons:
- The script is incorrect. Adjust it based on the Thing Specification Language model. For more information, see Pass-through/Edit script.
- Check whether the data format meets Alibaba Cloud requirements based on the data uplink and downlink conditions.
- The device can report data but cannot receive data sent from the cloud.
Check whether the running result conforms to the Alink JSON data format. This includes checking whether the identifier's data format is correct and whether the value ranges for properties and events match the feature definitions.
- The cloud can send data, but the device cannot report data.
Check whether the impersonated input conforms to the Alink JSON data format. This includes checking whether the identifier's data format is correct and whether the value ranges for properties and services match the feature definitions. For more information about the Alink JSON format, see Device properties, events, and services.
- The device can report data but cannot receive data sent from the cloud.
- Check whether the impersonated input properties include any read-only properties. The device can only receive data for read/write properties.
In the console's device debugging message analysis, why do I get a 'message content not found' error when clicking a blue MessageID?
The message type Quality of Service (QoS) for the IoT Platform is 0. Queries for QoS 0 messages are valid for only one day. After one day, queries for these messages will fail.
When using a public app, why can't I change the device sharing method?
For security reasons, devices that use a public app must use the 'authorization' sharing mode. Only an administrator can grant sharing authorization.
A newly created custom property has no corresponding component in the console
In the IoT Platform console, the feature and information components for custom properties do not support the string data type. Only the integer, float, enumeration, Boolean, time, and structure (JSON) data types are supported.
For a floating-point read/write property's scroll widget, why does the panel show a different step size than the one set in the feature definition?
The step size of the feature component must be greater than or equal to a calculated minimum. This minimum is the feature's minimum value divided by 100, rounded up. If the step size set in the feature definition is less than this calculated value, the component uses the calculated value. Otherwise, the component uses the defined step size.
The minimum value is limited for the following reasons.
- To ensure interface performance.
- If the value range is large, a small step size makes scrolling difficult.
Do I need to perform listing tests or send samples to Alibaba when publishing a product?
No, you do not. Products on this platform are published directly without review.
If I revoke a product's publication after mass production, will it affect products that have already been sold?
- If you use a public app, the product will no longer appear in the device list after you revoke its publication.
- If you use a private app, publishing or not publishing a product only affects the API for retrieving the list of devices pending network configuration. If you revoke the publication, the API will not return the revoked device. Activated devices can still function normally. However, adding or deleting device properties will affect devices that were activated before the revocation.
Therefore, you must evaluate the potential impact on existing devices and determine whether the app requires a synchronous update.
After a product is published and shipped, if I modify the value range of a read-only property, is a device-side OTA upgrade required?
- First, determine whether the modified field has any other uses on the device, module, or client, besides being reported to the cloud for display in the app. If it does, an OTA upgrade is required.
- Second, determine whether the module has logic to handle out-of-range data. If it does, an OTA upgrade is required.
- If the modified field is only used for display in the app and the module does not have logic to handle out-of-range data (meaning out-of-range data can still be reported to the cloud), you only need to modify the field's value range in the console. A device-side OTA upgrade is not required.
Can I use test devices that are added after a product is published?
Yes, you can.
During a batch upgrade, why can't I find the devices to upgrade under the corresponding firmware version?
Test devices cannot be upgraded in a batch. However, you can use them to authenticate firmware.
After creating an account, why can't I see the registered account information in the user list of the management console?
Only data for users registered with a private app (using an online AppKey) is displayed in the section of the IoT Platform console.