FVS Resource Reuse

This document applies to users who have installed the FineVis Data Visualization plugin to learn plugin functions.

Version

Application Scenario

You may wonder how to beautify a template and save time on style configurations. In this case, you may need to fix the commonly used component styles or functions to quickly create templates.

FineReport provides the FVS resource reuse function for you to easily solve the above problems. You can reuse templates, components (covering most component types), images, and videos.

You can manage all local resources through an independent FVS resource center, in which you can save component resources. Using the FVS resource reuse function, you can improve template production efficiency, enrich template effects, and enhance template aesthetics.

Use Instruction

• FVS Resource Center is a space used to uniformly manage all resources in the current project. Templates, components, images, and videos are included in FVS Resource Center. You can add resources from the built-in resource repository and the local computer.

• You can use the FVS resource reuse function in four types of scenarios. For details, see section "Resource Reuse."

• You can select resources (namely resources stored in FVS Resource Center) in My Resource after using the FVS resource reuse function.

• Resources (that have been added to the canvas) are no longer affected by FVS Resource Center. That is, if you delete resources in FVS Resource Center, you can still normally use resources already added from the center.

Creating a Dashboard from the Template

Choose File > New FineVis Visualization Dashboard, click Create from Template, select a template from My Resource, and click Create Dashboard in the right corner to create a visualization dashboard.

Note:

You can double-click the needed template to create a dashboard with the FineVis Data Visualization plugin 2.1.0 and later versions.

Click Add Manually. The FVS Resource Center page pops up, allowing you to add templates from the local computer.

Close the resource center page and return to the dashboard creation page to use resources after adding. If My Resource is not updated in time, you can click Refresh Resource in the lower right corner to obtain added resources.

Note:

The functions of  and  are the same in each resource reuse scenario. The following sections do not elaborate on these two functions.

Component Resource Reuse

Go to the FVS dashboard canvas page, click the Resource icon in the component area, and click or drag a component to add it to the canvas.

Note:

Only component-type resources are supported in the component resource repository. You cannot directly reuse uploaded images and videos from the component resource repository unless these images and videos are encapsulated as components.

Image Resource Reuse

Images in My Resource can be used in settings (where image resources are supported) such as Background (in Page), Border and Background (in Component), and Picture Type (in Content). The Selected tag exists by default based on different functions.

Take Border and Background in Component as an example, as shown in the following figure.

Video Resource Reuse

Videos in My Resource can be used in Local Video, as shown in the following figure.

FVS Resource Center is mainly used to manage all resources (namely resources in My Resource) saved on the current server. You can add, delete, and group resources in FVS Resource Center.

Note:

1. Login is needed if you want to access the resource center. The account should be consistent with that of the remote design. If the remote design is connected to the report directory of the server, you can access the resource center with the account and password of the remote design, rather than perform login again. You cannot switch or log out of the account.

2. Resources in the resource center should not be simultaneously operated by multiple people, as resource editing abnormalities (such as the current resource access failure) may occur.

3. If you access the resource center from the local designer, the platform username is uniformly displayed as Unknown user.

Function Entrance

Based on the above sections, you can open FVS Resource Center in each resource reuse scenario by clicking Add Manually.

Alternatively, you can open FVS Resource Center through an independent entry (Server > FVS Resource Center), as shown in the following figure.

Resource Type and Storage Location

FVS Resource Center includes four types of resources: Template, Component, Image, and Video. All resources are stored in the path %FR_HOME%\webapps\webroot\WEB-INF\assets\reuse, as shown in the following figure.

Since both resources and their creation information are stored in the reuse folder, the resource format is uniformly processed, as shown in the following table.

Adding Resources

You can add templates, components, images, and videos from the local computer.

You can select multiple files from the local computer for upload. A prompt will pop up if the sizes of the to-be-uploaded files exceed the limit. The following table describes the supported format types and file size limits.

Resource Management

Although the management of resources with different types is independent, the management setting items are consistent. The following sections introduce each setting item separately.

Grouping

Note:

Default Group, which cannot be renamed or deleted, exists in all resources. Embedded Resource, which can be renamed and deleted, exists in image and video resources by default.

Click the + icon on the right of All Groups to add groups. The default name of the added group is Unnamed Group, which can be renamed by double-clicking.

Hover the cursor over the group name and click the xxx icon to rename or delete the group, as shown in the following figure. If you delete a group, all resources in this group will be deleted. The deletion operation cannot be undone. The resources are unrecoverable.

Resource Renaming, Move, and Deletion and Resource Cover Modification

1. Hover the cursor over a resource to perform Edit, Move, or Delete operations.

• Edit: allows you to rename resources. The names of resources in the same group must be different, while the names of resources in different groups can be the same. You can modify component types for component resources and image usage for image resources after clicking Edit.

• Move: allows you to move the current resource to another group.

• Delete: allows you to delete the current resource.

• Modify Cover: allows you to re-upload the resource cover. Set NinePatch is supported in image resources.

2. Select a group in All Groups. Move and Delete buttons appear above the resource list, allowing you to perform batch move or deletion operations on resources in the current group.

Note:

If you rename or move resources, duplicate name verifications will be performed. If resources with the same name exist, a prompt displaying "A file with the same name already exists. Do you want to replace it?" will pop up.

Resource Search, Sort, and Filtering

• You can search for resource names.

• You can sort resources by creation time (default sort setting) or by name.

• You can filter component and image resources through tags.

Resource Refresh

Refresh Resource is used to refresh entire resources in the resource center. If you add or delete resources in the storage path %FR_HOME%\webapps\webroot\WEB-INF\assets\reuse, you need to synchronize the update through the Refresh Resource function.

Note:

When adding resources to the storage path, ensure that resources (with uniformly processed formats) are correctly added to the corresponding folder.

You can save components or component combinations created by yourself to My Resource in the resource center.

Select a component or component combination, right-click the mouse button, click Save to FVS Resource Center, and wait a few seconds for the entering page of the component resource information to pop up.

The entering page of the component resource information includes Component Name, Cover, Type, Group, Version, and Creator.

• Component Name (mandatory): allows you to enter a component name. The default name is the component name. When you save the setting, the duplicate name verification will be performed. If the component name is the same as that of another resource, a prompt displaying "A file with the same name already exists. Do you want to replace it?" will pop up.

     Component description (optional): allows you to enter a description for this resource. This setting option is empty by default.

• Cover (mandatory): allows you to upload images. The default cover is the component screenshot. If the component screenshot cannot be obtained, you need to manually upload a cover.

• Type: allows you to select a component type from all selectable types in the drop-down list. The default type is consistent with the component type. The default type for a component combination is Other.

    Component composition (unmodifiable): includes the single and combination components and is automatically determined based on whether a combination exists.

• Group (mandatory): allows you to switch and create groups. The default setting is Default Group.

Version (unmodifiable): records the version information of the currently used plugin.

• Creator (unmodifiable): records the name of the user who creates the component resources. The name of the user who logs in to the remote design or the local designer is Unknown user. This setting item is automatically obtained.

After saving successfully, you can view the result in FVS Resource Center. When reusing the saved resource in the component area, you need to manually click Refresh Resource in the lower right corner to obtain the resource.

Note:

If the component/component combination resource exceeds the maximum size limit (100 MB), you cannot save the setting.

In FVS Resource Center, the Embedded Resource group exists in image and video resources by default. Resources in Embedded Resource can be updated through the FVS Resource Update function in Server (on the designer menu bar).

After the update, click Refresh Resource in FVS Resource Center to obtain resources.

If you (as an intranet user) cannot update resources, you can download Built-in Resources.zip. Decompress the file, place the corresponding resources into the image and video folders in the path %FR_HOME%\webapps\webroot\WEB-INF\assets\reuse, and click Refresh Resource in FVS Resource Center to obtain the resources.