报表开发工具Stimulsoft Report新增“用户参数”新功能，来看如何使用？

Stimulsoft Reports 是一款报告编写器，主要用于在桌面和Web上从头开始创建任何复杂的报告。可以在大多数平台上轻松实现部署，如ASP.NET, WinForms, .NET Core, JavaScript, WPF, Angular, Blazor, PHP, Java等，在你的应用程序中嵌入报告设计器或在线创建报告，支持从云端快速分享你的报告。

Stimulsoft Dashboards.JS是一个功能齐全的仪表盘工具，用于为JavaScript平台创建仪表板。

Stimulsoft Reports官方正版下载（qun：740060302）https://www.evget.com/product/2398/download  

今天，我们将探索Stimulsoft BI Server产品最新版本2023.2.1中令人兴奋的新增功能：用户参数。与名称相反，这个强大的功能超越了个人用户，涵盖了用户角色甚至工作区内的所有用户。在深入细节之前，让我们先了解用户参数的概念。

背景资料

Stimulsoft BI Server 涉及与报告和仪表板的团队合作。例如，一组用户可以查看和编辑同一个模板。让我们想象一个场景，需要根据某些用户或用户组的特定条件过滤数据。换句话说，管理员会看到一组数据，而经理会看到另一组数据。为每个用户或组创建单独的模板是一种选择，其中可以使用数据源在模板中过滤数据。但是，随着用户数量的增加，模板的数量也会增长。我们在文章中详细讨论了使用链接的方法, 不适合这种情况。链接引用原始模板，无法过滤特定链接的数据。如果我们考虑为每个用户使用多个模板，情况就变得很关键，因为每个模板都需要为每个用户或用户组配置。因此，随着用户数量的增长，管理将变得越来越具有挑战性。

用户参数

为特定用户过滤数据的问题可以通过将参数传递给报表并在查询中使用它来选择相关数据进行过滤来解决。这样，当用户查看报表时，他们只会看到必要的数据。这种方法可以在单个模板中实现。稍后，我们将深入研究有关数据过滤的示例的综合说明。但现在，让我们解决主要问题。

什么是用户参数？

本质上，这涉及一个本地用户变量，当特定用户使用它时，该变量作为报告变量合并到模板中。当另一个用户与模板交互时，前一个用户的变量被清除，当前用户的参数被添加到模板中。

用户参数可以接受各种类型的值，包括字符串、数字、布尔值、日期、图像和表达式。此外，可以通过用户参数表达式传递用户数据，例如名字、姓氏、用户名、角色、父文件夹名称和工作区名称。您应该知道用户参数的用途超出了数据过滤；过滤只是一个特例。例如，您还可以显示当前正在处理报告的用户的姓名。

如何创建用户参数？

参数是使用导航器中用户选项卡上的添加用户参数命令创建的。根据所选上下文（工作区、角色或用户），将为工作区的所有用户、特定角色的所有用户或特定用户添加该选项。在创建新参数的菜单中，您必须指定参数的名称、类型和值。然后，单击此菜单中的“确定”按钮。之后，该参数将被添加并显示在用户层次结构中。顺便说一句，可以使用更改和删除命令在此选项卡上更改或删除已创建的任何用户参数。

在报表中使用用户参数

如前所述，用户参数将作为报表变量添加到模板中，并显示在数据字典元素列表中。编辑报表时，用户参数可以用作报表变量。例如，它们可用于过滤数据源、在报告中显示信息等。

有一点需要注意，即用户参数和报告变量之间的细微差别。报表变量是与模板关联的变量，而用户参数是属于特定用户的变量。从当前版本开始，使用用户选项时无法覆盖报表变量。该过程涉及在将报表加载到设计器或查看器之前清除先前用户的参数列表，然后添加特定于当前用户的参数。

用例

让我们重新审视我们的过滤示例，但首先，让我们总结一下，让我们稍微休息一下。您可以为特定用户添加参数。此参数将作为报告变量包含在模板中。因此，您可以像使用报表变量一样使用用户参数，包括在查询中使用它来过滤数据。但是，当模板加载到设计器或查看器中时，先前用户的参数列表将被清除，并添加当前用户的参数。

现在，问题来了：如何过滤不同用户的同一个请求？很简单——您需要为具有相同名称但不同值的用户添加参数。在模板本身中，在对数据源的查询中，需要添加一个带有表达式的参数类型。然后，将用户参数的名称指定为表达式。因此，在查看报告时，自定义值将传递给查询以进行数据过滤。数据将被相应地过滤，并且只有必要的信息才会显示在报告中。