XML File Dataset

Version

Functions

XML dataset refers to XML files as the data source.

With these files as data sources, admins can use FineBI to present data and perform data analysis.

You can customize the text encoding type and key nodes in the XML file.

Supported text encoding types include: GBK, BIG5, ISO-8859-1, UTF-8, UTF-16, EUC_JP, EUC_KR, and CP850. The default is UTF-8.

The prepared XML file is shown as below, with the encoding format as UTF-8 and multiple key nodes. This document takes the frtest node as an example.

<?xml version="1.0" encoding="UTF-8"?>
<frtest>
	<Customers>
		<Name>ALFKI</Name>
		<Type>ALfreds Futterkiste</Type>
		<Value>90</Value>
	</Customers>
	<Customers>
		<Name>ANATR</Name>
		<Type>Ana Trujillo Emparedadosy Helados</Type>
		<Value>90</Value>
	</Customers>
</frtest>

Super admins can add server datasets in the decision-making platform. While for ordinary users, they need to be assigned permissions by super admins.

Log in to FineBI as the super admin, choose System Management > Permission Management > Global Setting, enable Hierarchical Authorization and Data Connection Control, and click Save.

Log in to FineBI as the super admin, choose System Management > Permission Management > Common Permission Configuration, select the specific permission carrier from Dept./Role/User List, select the System Management tab, and enable the Use permission of Data Connection.

The server dataset supports three methods for calling XML files, and you can select as needed.

1. Server file: XML files that are stored under the path %BI_HOME%\webroot\WEB-INF\reportlets of the FineBI project

2. Local file: XML files that are stored on your computer, which will be automatically saved under the path %BI_HOME%\webroot\WEB-INF\reportlets\xml of the FineBI project after being called

3. Remote URL file: XML files that are stored on a server, which can be called through the URL

Server File

Store the prepared XML file under the path %BI_HOME%\webroot\WEB-INF\reportlets of the FineBI project.

Log in to FineBI as a user with permissions, choose System Management > Data Connection > Server Dataset, hover your cursor on Create Dataset, and click File Dataset.

1. Set the dataset name, which cannot be empty and cannot be the same as that of the existing dataset.

2. Select XML as the file type.

3. Select Server File as the file source and choose the XML file under the reportlets directory.

Local File

Before uploading the local file, you need to disable File Upload Verification under System Management > Security Management > Security, otherwise the upload button is grayed out.

Log in to FineBI as a user with permissions, choose System Management > Data Connection > Server Dataset, hover your cursor on Create Dataset, and click File Dataset.

1. Set the dataset name, which cannot be empty and cannot be the same as that of the existing dataset.

2. Select XML as the file type.

3. Select Local File as the file source and choose the prepared XML file on your local computer. After successful upload, a prompt box pops up saying "Upload XML successfully".

The uploaded file is automatically saved under the path %BI_HOME%\webapps\webroot\WEB-INF\reportlets\xml of the FineBI project.

Note:

If there is a file with the same name in the excel folder, the upload would fail.

Remote URL File

Store the XML file on a server and obtain the URL for the file.

Note:

Ensure that the FineBI project can successfully access this file, otherwise the call fails.

Log in to FineBI as a user with permissions, choose System Management > Data Connection > Server Dataset, hover your cursor on Create Dataset, and click File Dataset.

1. Set the dataset name, which cannot be empty and cannot be the same as that of the existing dataset.

2. Select XML as the file type.

3. Select URL as the file source, enter the URL address, and click Test Connection. After successful connection, a prompt box pops up saying "Connection succeeded".

Note:

If the URL address contains Chinese characters, it should be encoded first. Enter the encoded address in the platform to enable normal access.

1. You can customize the dataset function.

2. You can select the encoding type for the XML file content.

3. You can select the key node for the XML file content. If no key nodes are selected, dataset preview is empty.

Click Save to save the server dataset.

Failed Upload of Local File

The local file upload fails and it prompts “TEST.xml already exists”, but the file is not used under Server Dataset > File Dataset in the system.

You have called a file with the same name by using the method of local file.

After a local file is called, it is automatically stored in the FineBI project. When the file dataset is deleted under System Management > Server Dataset, the file in the FineBI project is not deleted.

Therefore, upload failure may occur due to the existence of a file with the same name.

Go to the path %BI_HOME%\webroot\WEB-INF\reportlets\xml of the FineBI project, find the file with the same name, delete/rename the file, and then re-upload the file.