产品文档

微应用

查看 PDF

页面生成器

December 1, 2021

投稿者:

熟悉页面生成器及其组件，以便创建操作页面。以下各节将介绍页面构建器的不同组件和部分。您可以根据自己的要求添加和自定义额外的字段和按钮。

页面构建器演练

下面的屏幕截图显示了完整的页面构建器，其中包含标注的下面的说明引用了编号的部分：

上面有标注匹配行的页面构建器的完整视图

顶部栏的左侧有可选的面包屑。选择页面名称（以粗体显示，右侧有一个打开的菜单图标）允许您在页面之间快速跳转。在中间，您可以选择标准显示器或移动视图。在右侧你有预览选项。预览页面 显示您正在构建器中查看的此页面的视图。预览微应用 提供了微应用操作的模拟工作流程，您可以在其中打开所有页面并查看通知及其操作。
左侧有微应用中屏幕的快速导航选项。从上到下，您可以跳转到此微应用中所有通知或页面的列表、“ 本地化 ” 屏幕和 “ 属性 ” 屏幕，您可以在其中修改名称、说明和图标。有关更多信息，请参阅
组件位于左窗格中。选择它们并将其拖动到屏幕中间部分的构建器画布中。请参阅页面生成器组件。组件分为输入、显示和布局。
- 输入组件在页面上创建可操作的部分，包括按钮、文本输入和单选按钮。
- 显示组件向微应用的最终用户提供信息，包括表格、静态文本和图像。
- 布局组件提供用于设置页面布局的网格组件。
构建器画布是中间部分。您可以在此处移动组件以根据需要进行排列。在此处选择组件以启用右窗格中可见的组件属性、操作和其他选项卡。
自定义组件并在右窗格中添加页面详细信息。使用 “ 页面详细信息” 选项卡，可以通过输入名称、设置信息过滤器以及向页面组件添加逻辑来配置要创建的页面。另外，请使用信息调试功能。此选项卡对于页面保持不变，此选项卡不依赖于所选组件。其他选项卡根据所选组件的不同而有所不同。可用的选项卡包括：
- 属性：每个页面构建器组件都有自己的特定属性菜单，根据组件的不同，有各种选项可供选择。
- 输入验证规则：某些组件启用自己的特定验证规则。
- 操作：根据组件的不同，可以使用不同的操作。操作允许微应用接收者（Workspace 用户）以可操作的输入进行响应。
对于一个组件而言，其他唯一选项卡将在下面的 “ 显示组件” 和 “布局” 组件部分中详细描述相关组件。

有关可用组件属性字段、切换开关和可选元素的完整列表和说明，请参阅组件属性。

页面模板

创建页面时，您可以根据需要的信息从以下基本页面布局中进行选择。每个模板只是为了加快你的活动速度以生成你想要的页面。

详细信息-提供静态详细信息并从缓存连接到特定记录的页面模板。
表单 -创建一个页面，该页面除了能够将用户数据输入页面之外，还提供静态详细信息。
表 -根据从目标应用程序集成中加载的数据表创建一个列出多条记录的页面。
静态内容 -设置提供静态、不可操作的信息的页面组件，例如标题、错误消息、提醒。
嵌入-创建一个呈现 iframe 的页面，以便在微应用中嵌入自定义网页。

页面生成器组件

通过 Page Builder，您可以从各种页面组件中进行选择，这些组件可让您自定义和配置微应用输出、信息和显示。使用下面介绍的这些组件根据你的期望和需求构建页面微应用。例如，如果要显示用户列表，则可以使用表组件来构建它。默认情况下，不同的模板页面具有不同的组件功能。以下列表涵盖了所有可用的选项。

输入组件

输入部分提供了在页面上创建可操作部分的组件，包括按钮、文本输入、单选按钮等。

输入组件的详细信息视图

按钮

在页面上添加包含操作和逻辑的可点击组件。按钮的大小和样式可以调整。运行维修操作、转到 URL 和运行通知触发器都有操作作为选项。例如，使用操作按钮可以将用户引导到另一个页面或提交条目。有关按钮操作的更多信息，请参阅操作。

文字输入

通过指定用户在页面上看到的数据表、列和值来定义所显示数据的文本源。组件可以标记为可选。字段宽度可以修改。可以根据最小或最大长度或文本模式来配置验证规则，以识别用户输入。有关正在使用的此组件的示例，请参阅构建创建页面和构建列表页面。

文字区

通过指定用户在页面上看到的数据表、列和值来定义所显示数据的文本源。组件可以标记为可选。可以根据最小或最大长度或文本模式来配置验证规则，以识别用户输入。

Num。输入

通过指定用户在页面上看到的数据表和列来定义显示的数据的来源。您可以定义时间、日期等格式，组件可以标记为可选，并且可以修改字段宽度。可以根据最小或最大长度或文本模式来配置验证规则，以识别用户输入。精度定义了总位数。S@@cale 定义小数点右侧的位数。

选择

允许用户从一组值列表中进行选择（限制为 100 个值）。由来自源系统的数据填充，也可以手动输入值列表。组件可以标记为可选，字段宽度可以修改。您可以定义时间、日期等格式。有关正在使用的此组件的示例，请参阅构建创建页面。

查找

允许用户搜索大量值，并允许用户通过搜索其他值来选择值。您必须指定数据池的来源。组件可以标记为可选。有关正在使用的此组件的示例，请参阅构建创建页面。

注意

使用 “包含” 策略配置 Lookup 组件可能会导致搜索词的加载时间较长。我们建议您使用大量数据样本进行测试，以检查是否会对性能和用户体验产生影响。或者，您可以使用 “开始于” 策略来提高性能，但只返回以搜索词开头的记录。

多选查找

多选查找 的工作方式与 Lookup 组件类似，允许用户通过搜索替代值来搜索和选择大量值。

例如，用户可以在安排会议时搜索并添加多个用户或用户电子邮件，或者在创建 Jira 票证时添加多个标签。要指定将数据集中在何处以供多选查找组件使用，您必须在 HTTP 集成中配置维修操作期间配置阵列数据类型。

多选的示例用例：

Webex -选择多个用户发送会议邀请。
Smartsheet -选择多个用户共享一张工作表。
Jira -选择多个标签以分配给单个 Jira 票证。
Office 365 日历 -在安排活动时选择多个与会者。
Office 365 电子邮件 -选择多个电子邮件收件人

配置

配置类似于 Lookup，但还有两个配置选项：“最大物品计数” 和 “可以创建新项目”。除了标准的页面构建器配置选项之外，请定义以下内容以配置多选查找：

映射到记录值 -定义预选值的数据源，仅在详情页面上可用（需要记录编号）。与选择不同，多选查找不限于单个值。

选项的数据源 -定义下拉列表中选项的数据源。

搜索词匹配策略 -选择搜索词是与数据库值的开头还是与数据库值内的任意位置匹配。

最大项目计数 -设置搜索期间所选项目的最大数量。

可以创建新项目 - 允许用户创建查找选择中尚不可用的项目（例如，向 Jira 票证添加新标签）。

完整性检查

完整性检查的工作方式与查找相同，但所选项目的最大数量必须为非负数。数据源表必须存在，值、显示值和附加数据的表列必须正确映射到带有外键的数据表。

有关配置阵列以返回多个条目的更多信息，请参阅数据类型。

复选框

通过定义源（数据表和列）和默认值（选中或禁用）在页面上添加可选组件。组件可以标记为可选。

收音机

添加一组只能选择一个的选项。由来自源系统的数据填充，也可以手动输入值列表。组件可以标记为可选。

日期/时间

定义要在微应用中显示的日期、时间或日期和时间，以及加载到页面的默认时间（选择前显示的时间）。组件可以标记为可选，字段宽度可以修改。

文件上传组件

允许在提交或更新操作期间将原始文件上传到 SoR。要启用此操作，请创建支持文件上传的特殊服务操作。

此组件允许用户在创建记录时将文件作为现有记录的附件和附件上传到 SoR 的工作流。例如：

Jira：上传日志文件和屏幕截图，然后将它们附加到问题单。
Salesforce：上传发现协议文档，然后将其附加到客户或机会。
SAP Concur：在管理支出报表时附上收据。
ServiceNow：上传附件作为提交工作流程的一部分。

创建维修操作

要启用文件上传，必须使用脚本来配置维修操作。有一个 FI LES 参数类型支持此功能。有关一般概述，请参阅 HTTP 集成脚本。

开始之前的准备工作

准备好要通过微应用管理界面导入的脚本。
脚本必须使用在首选文本编辑器/开发工具中编辑的 javascript 语言编写。
准备就绪后，通过微应用管理界面中的集成选项卡导入脚本，或者可以选择将脚本直接输入脚本功能中提供的文本编辑器。
导入后，测试脚本。

以下是一次将多个文件上传到 JIRA 的服务操作示例。有关更多脚本，请参阅此脚本存储库。

```javascript
function addAttachmentsSingleRequest({client, actionParameters}) {
    console.log(`attaching file(s) to issue ${actionParameters.issueKey}`);
    const formData = new FormData();
    const url = `/rest/api/2/issue/${actionParameters.issueKey}/attachments`;
    actionParameters.attachments.forEach(file => {
        formData.append("file", file);
    });
    const response = client.fetchSync(url, {
        method: 'POST',
        headers: {
            "Content-Type": "multipart/form-data",
            "X-Atlassian-Token": "nocheck"
        },
        body: formData
    });
    if (response.ok) {
        console.log('Attachment(s) posted');
    } else {
        const errorMessage = `Request failed(${response.status}: ${response.statusText})`
        console.error(errorMessage)
        throw new Error(errorMessage)
    }
}
<!--NeedCopy--> ```

导入脚本

要导入准备好的脚本，请按照下列步骤操作：

在集成的集成配置屏幕中，从左侧导航栏中选择脚本。
选择 上传脚本。或者，您可以通过选择 “ 编辑” 将脚本直接输入到文本区域。
将脚本拖到导入弹出窗口上。
脚本经过解析和验证。
选择 “ 导入”。
您的脚本已导入。

有关脚本的更多信息

配置文件上传组件

现在返回微应用中要为上传文件创建的此集成的页面。在构建器中放置 文件上传 组件后，完成文 件上传属性。

如果需要，可以修改 Label 的值。默认情况下，这是 文件上传。不需要标签。此值显示在 Citrix Workspace 中的放置框架上方。
如有必要，请修改 最大文件计数 的值。默认情况下，这是 1。此值显示在 Citrix Workspace 中丢弃帧下的 文件上传限制 旁边。选择多个文件时，每个文件的元数据上传和内容上传将分别进行。此功能受 SoR 的限制。
如有必要，请修改 最大文件大小 MB 的值。默认情况下，这是 5。此值显示在 Citrix Workspace 中放置框架下的 总大小限制 旁边。文件大小受 SoR 的限制。我们建议将最大文件大小配置为实际需要的大小，以防止浪费资源。
输入 文件扩展名的值（例如 .jpeg、.png、.pdf）。不需要任何值。此值显示在 Citrix Workspace 中放置框架下的 “ 接受的文件格式 ” 旁边。此字段不区分大小写，也不接受特殊字符。
如果提交此页面需要添加文件，请启用必需开关。A 此字段为必填 字段标签显示在 Citrix Workspace 中的放置框架上方。
如果希望拖放框在 Citrix Workspace 中显示为灰色且不可用，请禁用 “ 已启用” 开关。
如果要在 Citrix Workspace 中隐藏放置框架，请禁用可见开关。

注意事项

用户在上传内容时应考虑以下限制：

文件名必须以允许的后缀之一结尾。允许使用空字节以外的所有字符 \0。
微应用服务不提供文件存储。文件直接上传到 SoR。在上传过程中，Microapps 服务首先将文件从用户计算机传输到安全的临时存储，然后立即将文件流式传输到 SoR。从那时起，任何人都无法出于任何目的访问临时存储中的已处理文件，并且在短时间后将被删除。
用户可以在确认上传之前删除他们之前选择并预先上传的文件。
浏览器根据文件的扩展名检测文件类型（mime 类型）。微应用服务不使用文件类型进行任何检查。

显示组件

“显示” 部分提供了向微应用的最终用户提供信息的组件，包括表格、静态文本和图像等。在构建操作页面时，只要您可以选择用户电子邮件作为变量来提取数据，就可以使用 Active Directory 用户主体名称 (UPN) 属性。这包括页面和组件筛选器、约束条件和维修操作参数。

显示组件的详细信息视图

表

通过定义表源、筛选器和定义列，添加表以显示记录列表。可以添加页面链接操作，将用户定向到另一个页面。可以修改对齐方式。

选择此组件后，将在右窗格中启用 “ 列 ” 选项卡。使用以下设置添加任意数量的列： 列标题、 数据类型、 数据表、 数据列、格式和 条件格式。有关这些字段的说明，请参阅组件属性。

必须设置个性化查询以限制数据泄露。无论与订阅者的数据关系如何，没有个性化查询的表都会公开与表筛选器匹配的所有记录。除非您限制数据泄露，否则您的潜在敏感数据可能会暴露给所有微应用用户。使用数据 筛选器功能控制页面的数据 访问权限。在组件构建器窗格中选择表。选择 表属性 ，然后选择 数据筛选器。选择 + 添加条件 并根据需要添加约束。有关正在使用的此组件的示例，请参阅构建详情页面。

列表/网格

在 Citrix Workspace 中向用户显示数据列表。从预配置的布局中进行选择，以最适合您的数据的方式显示正确的信息。您可以手动定义列表中的项目，也可以从缓存中提取它们。

在 列表属性 选项卡下，选择以下任一项：

用于从缓存中提取数据的数据表。可以使用 “ 列表” 数据源、“ 列表项目” 数据源和 “ 布局和样式 ” 选项卡。组件属性中提供了 列表数据源和列表项数据源 的属性描述。
手动指 定以定义列表中的项目。列表项 和 “ 布局和样式 ” 选项卡可用。对于 列表项目，定义要在列表中显示的项目。属性描述可在组件属性中找到。

“ 布局和样式 ” 选项卡可用于两种类型的列表属性。“ 布局 ” 菜单提供了一系列预配置的布局。从以下选项中选择最适合您需求的布局：

列表-手风琴：显示可展开的纯文本内容单元。
列表-基本：显示纯文本列表。
列表-项目符号：显示无序、仅带项目符号的文本列表。
列表-有序：显示有序、编号的纯文本列表。
列表-缩略图：显示包含缩略图和样式的列表。
Grid-英雄形象卡片侧面：显示侧面有大图像的卡片。
Grid-英雄形象卡片顶部：在顶部显示带有大图像的卡片。
Grid-image：显示多列图像单位。
网格-缩略图侧：显示带有缩略图的多列列表。
网格-缩略图顶部：显示居中对齐的内容单位。

纯文本布局允许您切换 显示标题 和 显示描述。您可以禁用其中一个选项，但不能同时禁用两个选项。缩略图布局为图 像打开显示 图像切换和其他格式选项。组件属性中提供了其他属性描述。

文本

从表格和格式中定义文本源以加载到页面。要填充的文本都选择了 “数据源”、“表” 和 “列”。可以给出时间、日期等文本格式，也可以根据参数给出有条件的格式。您可以添加操作以转到 “页面”、“URL”、“发送电子邮件” 或 “呼叫电话”。有关正在使用的此组件的示例，请参阅构建详情页面。

Text 组件旨在显示单个数据库值。如果页面依赖于记录 ID，则会运行完整性检查并向用户发出警报。对于设置为操作页面的详细信息或表单类型页面，需要使用页面数据筛选器来调用唯一记录。我们显示此消息是为了提醒您此问题。你的微应用可能会按原样工作，但是如果唯一记录没有传递到页面，组件可能会显示错误的数据。

静态文本

定义要显示在页面上的静态文本。可以添加操作。可以修改对齐方式。如果文本是标题，则可以进行区分。提供粗体和斜体的字体样式。字体大小可以从 “普通”、“浅”、“小” 和 “小浅” 更改。您可以添加操作以转到 “页面”、“URL”、“发送电子邮件” 或 “呼叫电话”。有关正在使用的此组件的示例，请参阅构建创建页面和构建详情页面。

静态图像

显示从预定义的静态 URL 源引用的静态图像。可以指定图像大小和对齐方式。不能添加任何操作。

图片

使用存储在缓存中的 URL（数据表和列）以及要在页面上显示的格式来显示图像。如果图像无法加载，请添加文本以显示。可以配置图像格式，例如对齐方式、大小和形状。

线分隔符

使用分隔线将不相关的信息和分组相关的信息分开。不能修改任何属性。

返回按钮

允许用户返回上一页。可以指定变量；即数据表、数据列和格式。有关正在使用的此组件的示例，请参阅构建详情页面。

Power BI

在工作区中显示 BI 报告。定义源和格式。当用户在 Citrix Workspace 中查看此 Power BI 组件时，系统会首先提示他们使用 Power BI 登录名。

选择此 组件后，将在右窗格中启用 Power BI 组件属性 选项卡。首次添加此组件时，不会选择任何服务操作，也无法编辑该组件。必须为用户授权设置服务操作。设置维修操作后，在组件中设置授权。有关完整步骤，请参阅配置 Power BI 组件服务操作。

同意收据查看器

显示收据图像。使用数据表和数据列以及格式来定义源。Concur 收据查看器组件仅在 Concur 集成模板中可见。

Tableau

显示一个 Tableau 报告。使用数据表和列定义源。

HTML 内容

显示来自拉取来源（例如 RSS 订阅源）的 HTML 内容以正确显示 HTML。使用数据表和列定义源。支持基本文本元素。允许的元素是：

“p”，“div”，“h1”，“h2”，“h3”，“h4”，“h5”，“h6”，“ul”，“ol”，“li”，“块引用”，“b”，“i”，“字体”，“s”，“u”，“o”，“sup”，“sub”，“ins”，“del”，“强””、“罢工”、“tt”、“代码”、“大”、“小”、“br”、“跨度” 和 “em”。
“a” 元素仅具有 “目标” 和 “href” 属性。
“img” 元素仅具有 “高度”、“宽度”、“src” 属性。
此外，任何元素都允许使用 “style” 属性。

附件

列出数据源中的附件，并允许最终用户下载附件。可以直接预览图像和 PDF。通过指定数据表、URL 的数据列和作为名称的数据列来定义源。

如果未配置数据 MIME 类型（媒体类型），则附件预览图标显示为？。
如果未配置文件大小，则附件预览将显示 0B 作为大小。

选择 附件 URL 安全 选项：

继承：附件必须存放在集成访问的同一域中。否则，附件不会显示且无法下载。例如，这是 Google 集成的一个已知问题。
公共：如果其他域不需要身份验证方法，则可以显示来自其他域的公共附件。

嵌入

允许使用构建器将网页嵌入微应用中，然后在 Citrix Workspace 中显示。支持的内容包括：YouTube 公开视频、谷歌地图、Podio/Google/Microsoft 表单、大多数公开响应式网页，以及由其提供商设计的嵌入网站并显示在 iframe 中的任何内容。

某些外部内容在设计时没有考虑到嵌入，或者严格禁止使用。例如

通过发送 X-Frame-Options "SAMEORIGIN"; 标题明确禁止嵌入的网页。一个值得注意的例子是 https://google.com。
重定向到与页面构建器中组件配置中指定的域不同的网页。
嵌入需要身份验证的网页可能会遇到问题。管理员必须仔细测试。
包含 Cookie 同意（例如，GDPR 要求）的网页不会将其选择缓存在嵌入组件中。如果用户再次访问嵌入式网站，除非网站使用 cookie 属性，否则他们每次都必须再次确认 SameSite: none; secure=true cookie 同意。

配置 Embed 组件

在构建器中放置 Embed 组件后，完成 嵌入属性。

注意

要成功嵌入某些网站的内容，您必须使用直接从网站生成的嵌入代码（而不是直接 URL 或共享链接）。例如，通过共享选项在 Google 地图上生成嵌入链接时，请使用嵌入 地图生成的链接，而不 是发送链接。

输入要嵌入的内容的 URL 。
选择 “ 高度” 模式 选项之一，以选择如何确定嵌入内容的大小。
- 宽度乘数：启用 乘数（以百分比为单位） 字段。输入相对于嵌入内容宽度的百分比值。例如，如果输入 50，则显示的内容是其宽度的一半高度。
- 已修复：启用 绝对高度（以像素为单位） 字段。输入像素计数以确定嵌入内容的高度。

构建器中不提供嵌入式内容预览。选择 “ 预览微应用 ” 以查看嵌入式内容的外观。

嵌入组件

注意事项

嵌入内容时请考虑以下事项：

尽可能使用可嵌入版本的网页。这些页面已针对内容提供商的嵌入进行了优化。例如， XXX 可以在 https://www.youtube.com/watch?v=XXX 和访问带有 ID 的 YouTube 视频 https://www.youtube.com/embed/XXX。第一个 URL 指向整个网站，第二个 URL 指向可嵌入的视频。
指定 URL 时，可以使用模板变量将参数传递给远程 URL。对于同一 YouTube 示例，假设你有一个名为 video_id 包含视频 ID 的数据表，请在 URL 字段中输 https://www.youtube.com/embed/{video_id} 入。该字符串 {video_id} 将由表中的行值替换。
嵌入的页面显示在沙盒化 iframe 中，具有以下属性: allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox allow-forms allow-pointer-lock allow-downloads. 这些标志可确保第三方内容与 Citrix Workspace 完全隔离，但可能会导致远程页面上的某些功能中断。
Embed 组件无法显示需要自定义浏览器插件的文档。因此，无法在 Embed 组件中显示 PDF。

布局组件

布局部分提供了用于设置页面布局的网格组件。

布局组件的详细信息视图

灵活的网格 -让你可以更好地控制组件在页面上的位置，从而可以更轻松地 “插入” 组件。当您设计用于屏幕较大的设备的页面时，此选项很有用。

选择此组件后， 弹性网格属性 选项卡将在右窗格中打开。设置网格中所需的列数和行数并自定义对齐方式。有关正在使用的此组件的示例，请参阅构建创建页面和构建详情页面。

页面详情

通过输入名称、设置信息过滤器以及向页面组件添加逻辑来配置要创建的页面。另外，请使用信息调试功能：

页面名称 -设置页面的名称。
数据筛选器 -用于设置操作数据的约束。
显示 SQL -使用它可以显示 SQL 以进行调试。
逻辑 -使用它来添加和显示组件逻辑。在以下部分中查找 添加逻辑 的详细信息。

添加逻辑

选择 页面详细信息 选项卡下的 添加逻 辑按钮以打开逻辑配置。这使您能够为特定页面组件配置逻辑。在此页面上指定组件的行为或外观。根据组件的预期行为，使用标准逻辑参数创建条件以实现各种结果。您可以向任何单个按钮添加多个堆叠动作，只需单击一下即可创建多个动作效果。每个维修操作成功运行后，系统会在操作链中移动，直到所有操作都完成。可用操作包括：

评估条件 -通过逻辑参数设置和编辑条件。
设置组件值 -设置用于提交操作的按钮的组件值。
显示组 件-配置条件以显示组件。
隐藏组 件-配置隐藏组件的条件。
启用组 件-配置启用组件的条件。
禁用组 件-配置条件以禁用组件。
将组件设置为必需 -配置需要组件的条件。
将组件设置为不需要 -配置条件以排除组件。

组件属性

每个页面构建器组件都有自己的特定属性菜单，根据组件的不同，有各种选项可供选择，包括：

标签 -自定义按钮、文本、图像等的标签。
占位符文本 — 向用户说明如何使用此组件。例如，列出用户可以使用的搜索属性。
内容 — 输入静态文本以显示最终用户。
对齐方式 — 设置显示文本或图像的对齐方式。
文本类型 — 设置显示文本的文本大小。
字体样式 — 设置显示文本的字体样式。
字体大小 — 设置显示文本的字体大小。
字段宽度 — 设置组件的显示宽度。
格式 — 定义向用户显示数据时如何设置数据的格式。例如，日期、时间、小数点、百分比等。
默认值 — 用于 输入组件 手动或通过使用变量设置默认值。
样式 -用于 B utton 组件 在不同的预定义颜色和格式之间切换。
使用与页面相关的记录 — 用于 表组件 以筛选与页面上显示的记录相关的记录。例如，您有一个页面显示有关帐户的数据，并且您想要显示包含与此特定帐户相关的联系人列表的表格。
映射到记录值 — 切换以显示 输入组件缓存中特定记录的数据。例如，在创建 “编辑类型” 页面时启用此切换，因为您希望在更改这些值之前向最终用户显示实际数据。另一方面，如果要创建 “创建记录” 类型页面，请不要启用 “映射到记录值”，因为此页面未绑定到任何现有记录。因此，将 In put 组件 映射到任何记录都没有意义。
选择类型 — 选择选择 组件和单选组件 的选项来源。
- 如果选择了 手动输入值，则必须完成 “值和标签 ”。然后在维修操作中使用值，标签是最终用户在 Citrix Workspace 中看到的内容。
- 如果选 择了从数据库中选择，则必须填写以下字段：选 **项的数据源、选项的数据表、选项标签的**数据列和选项值的数据列。然后在维修操作中使用选项值的数据列，选项标签的数据列是最终用户在 Citrix Workspace 中看到的内容。
- 选择类型 和 映射到记录值 的组合可用于不同的用例。例如，“从数据库中选择” 和启用的 “映射到记录值” 通常用于编辑类型页面。在这种情况下，数据表和数据列用于显示当前数据、选项的数据源、选项的数据表、选项标签的数据列和选项值的数据列用于显示缓存中最终用户可以在编辑记录时使用的所有其他可用选项。
数据源 -为显示的元素选择数据源。
- 如果要显示缓存 中的一个特定列，请使用 Column 值 。
- 如果要显示缓存中各种属性的字符串，请使用模板。例如，帐户地址在缓存中被拆分为 3 列，但是您希望将它们全部显示在一个组件中。
数据表 -为显示的元素选择数据表。
数据列 -为显示的元素选择数据列。
条件格式 -为元素配置条件格式。
插入变量 -向页面元素添加变量以自动显示应用程序集成数据。
数据筛选器 -设置显示数据的约束。选择 设置筛选器，然后选择添加，然后根据需要添加条件约束。
数@@据顺序/顺序 — 设置显示数据的顺序。依次选择 设置顺序、 添加规则和规则约束（根据需要）。
显示其他数据列 切换 — 用于 Lookup 组件 ，用于定义在执行搜索时向用户显示的额外列。
搜索词匹配策略 — 用于 Lookup 组件 以定义搜索策略。
- 开始于-此搜索方法速度最快，因为它不会使缓存过载。它在定义的缓存属性中搜索值的第一个字符。对于大多数用例，此搜索方法都令人满意。
- 包含 — 根据数据收集的大小，此搜索方法可能会非常慢。它会在定义的缓存属性中搜索值的所有字符。
字段宽度 -用于 输入组件 以定义输入字段的宽度。
必需切换-用于 输入组件 ，以便在具有已配置维修操作的按钮可操作之前，系统会提示最终用户输入数据。
启用切换-用于 输入组件 显示您不希望最终用户能够更改的特定记录的数据。
可见开关-在您需要额外的数据用于页面逻辑、转到页面等，但不希望向最终用户显示此信息时使用。
如果为空则隐藏 — 用于某些 Display 组 件，如果没有可用数据，则根本不想向最终用户显 示此组件。
Alt. text/Alt 属性 — 用于图像组件。输入显示图像是否存在问题的文本。
URL 前缀 — 用于图像组件为 URL 配置静态前缀，而 URL 的其余部分取自 数据表 和 数据列 字段。
图像大小 — 选择显示的图像的大小。例如， 缩略图 或全宽。
图像形状 — 选择图像的形状。例如，“ 圆形” 或 “ 圆角”。
布局 -从 列表组件的预配置布局中进行选择。

输入验证规则

为某些输入组件添加规则，以限制用户可以输入的数据格式。每个组件都有自己的特定验证规则。始终有一个最小值和最大值选项可供设置。

此选项卡可用于以下组件： 文本输入、 日期/时间、 文本区域和 数字输入。有关详细信息，请参阅每个组件说明

操作

操作菜单可用于 B utton 组件，以允许微应用接收者（Workspace 用户）以可操作的输入进行响应。对于不同的组件，存在不同的操作。

启用页面操作按钮

启用 页面操作按钮 切换以在 Citrix Workspace 的页面刀片的页脚中显示按钮组件。基于此切换开关，Button 组件可以使用不同的操作子集。请注意以下事项：

如果该按钮显示在刀片式服务器页脚中，则用户在 Citrix Workspace 中选择页脚按钮后，刀片式服务器将自动关闭。
如果要添加诸如 “转到页面” 或 “转到 URL” 之类的操作，则不希望在刀片式服务器页脚中显示按钮，以便 Citrix Workspace 可以将最终用户导航到下一个屏幕。如果启用此切换开关，则此类操作不可用。

添加操作

定义按钮从您在集成中配置的已配置的服务操作中运行的操作。行动包括：

运行服务操 作-定义按钮从集成中设置的已配置的服务操作中运行的操作。有关示例，请参阅配置服务操作参数。
发送电子邮件 -根据预先配置的属性发送电子邮件。有关示例，请参阅添加发送电子邮件操作。
添加 G Suite 活动 - 根据预先配置的属性创建 Google 日历活动。
返回 -将用户导航到上一页。
转到页面 -将用户导航到预配置的微应用页面。有关示例，请参阅添加转到页面操作。
转到 URL -将用户导航到预配置的 URL。有关示例，请参阅添加转到 URL 操作。
运行通知触发器 -运行预配置的通知事件。有关示例，请参阅添加运行通知触发器操作。

添加 “转到页面” 操作

定义将用户发送到预配置的微应用页面的操作。

将 B utton 组件添加到构建器并在 “按 钮属性 ” 选项卡下为其命名后，选择 “ 操作” 选项卡。
禁用 页面操作按钮 切换。在 “ 添加操作 ” 字段中，选择 “ 转到页面”。
在 “ 操作 ” 下选择 “ 转到页面”。操作标签 字段、 应用程序 选择器和页面选择器打开。
在 应用程序下，选择要从中选择页面的微应用。
在 “ 页面” 下，选择要按钮打开的页面。
（可选）如果要筛选已配置 页面中的数据，请在 “目标页面记录 ” 下选择 “ 设置条件 ”。例如，用户正在查看包含帐户数据的页面。用户选择一个标记为 “ 商机 ” 的按钮，然后根据目标页面记录条件导航到该页面，其中包含预期值大于特定值的所有相关商机的列表。
（可选）如果要在 目标页面中预填充字段，请在填充目标页面下选择编辑 字段。例如，用户正在查看 Jira 票证，并希望在同一项目中创建一个新票证。用户选择一个标记为 “ 新建 ” 的按钮，然后导航到页面，在该页面中，“项目” 字段已使用上一页中的值预填充，但必须手动输入所有其他属性。

添加运行通知触发器操作

定义一个操作以触发通知以运行通知事件评估并向目标受众发送通知消息。此操作可以显示在页面正文中或刀片式服务器页脚中。

将 B utton 组件添加到构建器并在 “按 钮属性 ” 选项卡下为其命名后，选择 “ 操作” 选项卡。
保持 “ 页面操作” 按钮 切换为启用状态，以在页面的页脚中显示该按钮。禁用切换以在页面正文中显示按钮。
在 添加操作 字段中，选择 运行通知触发器。
在操作下选择 运行通知触发器。
在事件下，选择要运行的事件触发器。您可以为此按钮选择多个事件。

使用组件值作为参数

您可以在 “ 发送电子邮 件” 和 “转到 URL ” 操作中使用组件值作为参数。此功能允许：

(发送电子邮件) Workspace 用户可以在工作区字段中输入给定操作的电子邮件收件人。
(转到 URL) 用户从工作区表单中输入的内容可用作在工作区中打开的 URL 模板的一部分。

根据你的用例，请按照以下步骤操作。

添加发送电子邮件操作

将 B utton 组件添加到构建器并在 “ 按钮属性” 下命名后，选择 “ 操作” 选项卡。
禁用 页面操作按钮 切换。在 添加操作 字段中，选择 发送电子邮件。
在 “ 至” 下，选择 “ 插入变量”。
在 “ 插入变量 ” 屏幕上，从 “ 类型 ” 菜单中选择 “ 组件值”。
在组件下，选择用户在其工作区窗体上输入的所需输入组件。“ 至 ” 字段填充组件 ID。
根据需要为邮件添加主题和正文。 在 Workspace 中，用户可以在此组件启用的字段中输入电子邮件地址。当他们提交电子邮件地址时，他们的电子邮件将打开一封预填充的邮件，必要时可以修改该邮件并发送。

添加 “转到 URL” 操作

将 B utton 组件添加到构建器并在 “ 按钮属性” 下命名后，选择 “ 操作” 选项卡。
保持 页面操作按钮 切换为启用状态。在 “ 添加操作 ” 字段中，选择 “ 转到 URL”。
在 URL 模板 字段中，输入要打开的目标网站的 URL。
在 URL 模板 字段下，选择 插入变量。
在 “ 插入变量 ” 屏幕上，从 “ 类型 ” 菜单中选择 “ 组件值”。
在 “ 组件” 下，选择所需的组件。 URL 模板 字段将填充添加到您输入的 URL 的组件 ID。在 Workspace 中，用户可以在此组件启用的字段中输入值。当他们提交查询时，选定的组件值将用作在浏览器中打开的 URL 中的变量。

注意：

选择模板字段旁边的信息图标可查看有关已使用组件的详细注释。

配置 Power BI 组件服务操作

Power BI 模板随附的开箱即用的微应用程序根据需要配置了组件。如果要进行更改或添加其他微应用，请按照以下步骤作为模型进行操作。重要注意事项包括：

要首次显示报告，用户必须登录 Power BI。
Power BI 主帐户可以生成的嵌入令牌数量有限制。您可以购买更多容量。有关详细信息，请参阅 https://docs.microsoft.com/en-us/power-bi/developer/embedded/embedded-faq#technical。
AS Azure 或 AS onPrem 实时连接报告在重新绑定后可能会出现延迟。有关详细信息，请参阅https://docs.microsoft.com/en-us/rest/api/power-bi/reports/RebindReport。

需要 Power BI 组件设置来授权登录的用户，然后他们才能查看仪表板、报表或磁贴。要进行设置，您需要配置服务操作以为用户生成令牌。对仪表板、报表和磁贴进行配置。授权作为常规的维修操作起作用。例如，如果你有单独的 OAuth 2.0 身份验证方法用于服务操作设置，系统会要求用户登录 Power BI，然后组件才会显示所需的内容。

在集成的 “ 编辑 ” 屏幕中，或从菜单中，从左侧导航栏中选择 “ 服务操作 ”。
使用以下 Power BI 端点根据需要配置这些新的服务操作：
- 仪表板 https://docs.microsoft.com/en-us/rest/api/power-bi/embedtoken/dashboards_generatetokeningroup
- 报告 https://docs.microsoft.com/en-us/rest/api/power-bi/embedtoken/reports_generatetokeningroup
- 瓷砖 https://docs.microsoft.com/en-us/rest/api/power-bi/embedtoken/tiles_generatetokeningroup
选择 添加维修操作。此操作需要 GroupID 和仪表板 ID、ReportId 和 tileID 参数。以下面的模型为例：
在 操作执行 下，选择 BOD 体选项卡。从 内容类型 列表中选择 JSON 。

{ “accesslevel”: “查看” }

现在，使用此新配置的服务操作在组件中设置授权。遵循下面的一般示例：
在微应用中，例如，要在其中为仪表板提取数据的微应用中，选择您安装了 Power BI 组件的任何页面。
选择 P ower BI 组件，然后选择右侧的 Power BI 授权 选项卡。
选择 编辑参数，然后按如下所示填写字段：
选择保存以完成操作。

本内容的正式版本为英文版。部分 Citrix 文档内容采用了机器翻译，仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。

这是否有帮助？

页面生成器

December 1, 2021

投稿者:

December 1, 2021

投稿者:

这是否有帮助？