[{"id":"425f2be4-b65d-4cdf-b543-fb4397f51672","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"a1041c29-1f9f-497e-b577-3e673e487c51","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"c1e3b2a0-7159-4980-a5e1-4fbb04c7fcc1","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"128acbbc-5c49-416b-9c1f-91f679362b23","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"3bc7a653-1dd3-4a33-b35c-41b0ddc2f446","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"cecedb46-bf12-401c-a04c-5282e11b8274","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"2f1768df-3e8b-41c2-826e-93f1a82273d1","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"d9528848-3bae-42c1-8f6d-410a78341cef","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"2683b3de-5c23-429d-9a88-4917616d20ad","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"b96827a0-6bd4-4184-86a4-6fe503d0e4b4","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"96d2140c-5bb6-49b6-a4c7-4af4b7de2e52","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"11f27d32-9547-4a8c-9e88-5dd2bffffeda","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"d186bc7e-cbae-4d23-9cd9-a54880be8e4d","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"26754bf1-707e-4815-b6d3-dcdc87a59188","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"e4c0a89e-cceb-4863-a30a-dff94f1d8d08","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"c4f826a6-5d16-4399-8f1a-7b8449594941","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"ff2b9815-2596-47f7-8793-3585c9ee24a2","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"46851ce2-51a2-4af4-969d-9fe989997135","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"e3e87330-5250-4923-9cdf-e7e8afd353ab","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"a04db983-f77b-4ec6-857c-1c01afaed85a","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"434eed34-9059-46e4-88f9-15e47d09622c","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"30988f2a-ebd5-4a8c-b20e-54a11a528d30","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"a59719c8-0df2-44e1-b89c-9d8fa0312857","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"4be1ecee-287b-43a2-ba99-cfa89de88187","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"ea04cced-7866-48e5-a5fe-1e9f11004d59","tags":[{"product":null,"links":null,"id":"fe610228-9cf6-417f-813a-dcbfd25406c3","name":"upd","color":"#7e678a","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]},{"id":"ab17d080-0112-4ba4-8dae-ef367bec7b78","tags":[{"product":null,"links":null,"id":"4d7b6a40-ab32-4c71-a381-58f3ffd2653e","name":"new","color":"#ed7422","productId":"d699a6af-e150-4da3-ab30-25fd97934601"}]}]
        
(Showing Draft Content)

Report Parts

Introduction

Report Parts is an innovative feature of ActiveReportsJS that helps developers and report authors design and organize pre-defined and re-usable Report Items into Report Part Libraries. These libraries make it easy for users without technical skills to incorporate these items into their reports and customize them within the constraints set by developers. This guide will explain how developers and report authors can build these libraries, and will provide instructions for end users on how to adapt the report parts to fit their specific reporting needs.

Initializing a Report Part Library

A Report Part Library is essentially a report that contains declarations of report parts. To initialize a new Report Part Library, begin by selecting the appropriate report type for your needs. The options include Continuous Page Layout, Fixed Page Layout, or Pageless Layout. The properties of Report Items will vary slightly based on the chosen report type, which can affect how they are utilized within your reports. Detailed guidance on each layout type's specifications and advantages can be found on the Layout Type documentation page.

Initializing a Report Part

Creating a new report part involves several key steps to both lock certain properties and allow customization of others by end-users. Here’s how to create a Logo report part that displays a company logo and permits end-users to modify the border style. Using similar steps, you can configure report parts based on any report items.

  1. Add a Report Item: Drag and drop the Image report item from the toolbox into your report layout.

  2. Configure Fixed Properties: In the Properties panel, expand the editor for the Image property. Set the Source to External, the Value to the logo URL https://cdn.mescius.io/umb/media/pujnxfci/mescuis-logo-horiz.svg, the MIME Type to image/svg+xml, and Image Sizing to Fit Proportional.

    image

  3. Declare the Report Part: Navigate to the Report Parts tab on the application bar and click the Create Report Part button.

  4. Set Properties for Customization:

    • In the Properties panel, switch to the Report Part tab with the Image item selected.

    • Set the Display Name to Company Logo and the Description to Displays the company logo.

    • Add a new property by clicking the + icon beside the Properties editor. Name this property BorderStyle.

    • Click the Edit icon next to the newly added property and configure it with the following settings: Display Name = Border Style, Description = Allows customization of the logo's border style, Category = Style, Type = Border Style, Default Value = Solid.

      image

  5. Enable End-User Customization:

    • Go back to the properties panel and select the Image tab.

    • Expand the Border/Style editor and set the Default value for the border style to {PartProperties!BorderStyle.Value}. This setup ensures that end-users can customize the border style, while the border width and color remain predefined and unchangeable.

  6. Saving report library: save the report library to any suitable location on your machine.

This method of setting up report parts ensures flexibility and control for developers and report authors. By following the outlined steps, you can configure any properties intended to be editable by end-users similarly. This capability allows you to tailor the interaction and customization options available in your report parts, making them adaptable to various reporting needs and user preferences.

Using a Report Library in the Standalone Designer

Follow these steps to use a report library in the Standalone Designer application:

  1. Create or Open a Report: Launch the Standalone Designer and either create a new report or open an existing one.

  2. Add Library: Navigate to the File menu and select Add Library.... In the Open File Dialog, locate and select the report library file that you saved on the step 6 in the previous section.

  3. Access the Library: In the Toolbox, expand the Libraries node to see the available report parts.

  4. Insert Report Parts: Drag and drop the Company Logo item from the library into your report layout.

  5. Customize Properties: In the property grid, locate the Style section and set the Border Style to your preferred value.

    image

  6. Preview the Report: Preview the report to ensure that the Company Logo is displayed as expected and that the border style correctly reflects the set value.

    image

Using a Report Library with the Report Designer Component

You can find the detailed information on how to load a report parts library into your application at the Using Report Parts page.