tencent cloud

URL Page Parameter Construction
Last updated: 2025-09-19 15:24:44
URL Page Parameter Construction
Last updated: 2025-09-19 15:24:44
In the sharing or embedding scenarios, when a user opens a page, we may want to apply default filters to the data, for example, displaying only data for a specific department. Business Intelligence (BI) enables data interaction between parameters and page components by adding parameters to the URL.

Prerequisites:
This document only introduces the parameter construction in the URL. To learn about the complete process, refer to the related documents on Sharing and Page Embedding.

In this document, you will learn:
How to construct a single parameter.
How to construct multiple parameters.


Constructing a Single Parameter

1. Obtain the parameter name: Obtain the parameter name through the Page Parameters feature.





As shown in the image above, we obtain the parameter name "type".

2. Assemble the parameter body: Use the following format to assemble the parameters to be passed.
/* Format */
value=${parameter_value}&target=${parameter_name}

/* For example, the following is equivalent to province being Shanghai. */
value=Shanghai&target=province
3. URL transcoding:
In a non-coding environment, you can also handle the parameters easily using the following format.
/* Format */
params[]=value=${parameter_value}%26target%3D${parameter_name}

/* For example, the following is equivalent to province being Shanghai. */
params[]=value=Shanghai%26target%3Dprovince
Most browsers support transcoding Chinese characters. If the automatic transcoding fails, you can search for the online tool "urlEncode" to transcode the Chinese manually.

If generating links in batches with code, you can use the encodeURIComponent method to encode the parameter body.
//encodeURIComponent is the URL format conversion function.

const str1 = `value=Shanghai&target=province`
const paramsStr1 = `params[]=${encodeURIComponent(str1)}`
4. Handling multiple values for a parameter: If a parameter has multiple values, different values can be separated using a comma ",".
/* For example, the following is equivalent to province being Shanghai or Guangdong or Shaanxi. */
params[]=value=Shanghai,Guangdong,Shaanxi%26target%3Dprovince

Constructing Multiple Parameters

When multiple parameters need to be passed, simply construct the parameters based on the single parameter format as shown below.
/* Format */
params[]=value=${parameter_value}%26target%3D${parameter1}¶ms[]=value=${parameter_value}%26target%3D${parameter2}

/* For example, the following is equivalent to province being Shanghai and department being Operations Department. */
params[]=value=Shanghai%26target%3Dprovince¶ms[]=value=operations_department%26target%3Ddepartment



Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback