页面构建器
熟悉Page Builder及其组件,使您能够创建操作页面。页面构建器的不同组件和部分将在以下部分中进行描述。您可以根据自己的需求添加和定制额外的字段和按钮。
页面构建器演练
下面的屏幕截图显示了完整的页面构建器,其中显示了部分。描述如下,参考编号部分:
- 顶部栏的左侧有可选择的面包屑。选择页面名称(以粗体显示,右侧有一个打开的菜单图标)可以让您在页面之间快速跳转。在中间,您可以选择标准监视器或移动视图。在右边你有预览选项。预览页面显示您在构建器中查看的此页的视图。预览microapp提供微应用程序操作的模拟工作流,您可以打开所有页面并查看通知及其操作。
左手边是微应用屏幕的快速导航选项。从上到下,您可以跳转到所有列表通知或页面在这个微程序中本地化屏幕,和属性可以修改名称、描述和图标的屏幕。有关更多信息,请参见
组件位于左侧窗格中。选择它们并将它们拖到屏幕中间的构建器画布上。看到页面构建器组件。组件分为输入、显示和布局。
- 构建器画布是中间部分。您可以在这里移动组件以按需要排列它们。选择此处的组件以启用组件属性、操作和其他在右窗格中可见的选项卡。
自定义组件并在右窗格中添加页面详细信息。的页面的细节TAB允许您通过输入名称、设置信息过滤器和向页面组件添加逻辑来配置您正在创建的页面。此外,还可以使用信息调试特性。此选项卡对于页面保持相同,并且此选项卡不依赖于所选组件。其他选项卡根据所选择的组件而有所不同。可用的选项卡包括:
有关可用组件属性字段、开关和可选元素的完整列表和说明,请参见组件属性。
页面模板
创建页面时,可以根据需要的信息从以下基本页面布局中进行选择。每个模板的目的只是为了加快您的活动,以产生您想要的页面。
- 细节-提供静态详细信息的页面模板,并连接到缓存中的特定记录。
- 形式-创建一个提供静态详细信息的页面,除了能够将用户数据输入到页面中。
- 表格-根据从目标应用程序集成加载的数据表创建一个列出多条记录的页面。
- 静态内容-设置页面组件,提供静态,不可操作的信息,如标题,错误消息,提醒。
- 嵌入-创建一个页面,渲染iframe嵌入自定义网页在你的微应用程序。
页面构建器组件
Page Builder允许您从各种页面组件中进行选择,这些组件允许您自定义和配置微应用程序的输出、信息和显示。根据您的期望和需求,使用下面描述的这些组件来构建页面微应用程序。例如,如果您想要显示一个用户列表,您可以使用Table组件来构建它。默认情况下,不同的模板页面有不同的组件特性可用。下面的列表涵盖了所有可用的选项。
输入组件
输入部分提供了在页面上创建可操作部分的组件,包括按钮、文本输入、单选按钮等。
按钮
在带有操作和逻辑的页面上添加一个可单击的组件。按钮大小和样式可以调整。有运行服务操作、转到URL和运行通知触发器等操作选项。例如,使用动作按钮可以将用户引导到另一个页面或提交一个条目。有关按钮动作的更多信息,请参见行动。
文本输入
通过指定用户在页面上看到的数据表、列和值来定义显示数据的文本源。组件可以标记为可选。字段宽度可以修改。可以根据最小或最大长度或文本模式配置验证规则,以标识用户输入。有关此组件的使用示例,请参见创建一个创建页面和创建一个列表页面。
文本区域
通过指定用户在页面上看到的数据表、列和值来定义显示数据的文本来源。组件可以标记为可选。可以根据最小或最大长度或文本模式配置验证规则,以标识用户输入。
Num.输入
通过指定用户在页面上看到的数据表和列来定义显示数据的来源。您可以定义格式,如时间、日期等。组件可以标记为可选,字段宽度可以修改。可以根据最小或最大长度或文本模式配置验证规则,以标识用户输入。精度定义总位数。规模定义小数点右边的位数。
选择
允许用户从一组值列表中进行选择(限制为100个值)。由来自源系统的数据填充,或者您可以手动输入值列表。组件可以标记为可选,字段宽度可以修改。您可以定义格式,如时间、日期等。有关使用该组件的示例,请参见创建一个创建页面。
查找
允许用户搜索大量的值,并允许用户通过搜索其他值来选择一个值。您必须指定从何处汇集数据。组件可以标记为可选。有关此组件的使用示例,请参见创建一个创建页面。
请注意
使用“Contains”策略配置Lookup组件可能会导致搜索词的加载时间变长。我们建议您使用大量数据样本进行测试,以检查是否会对性能和用户体验产生影响。或者,您可以使用' Starts with '策略来提高性能,但只返回以搜索词开头的记录。
多选查找
多选查找的工作原理与查找组件,并允许用户通过搜索替代值来搜索和选择大量值。
例如,用户可以在安排会议时搜索和添加多个用户或用户邮件,或者在创建Jira票据时添加多个标签。要指定将数据汇集在何处供多选择查找组件使用,必须配置数组HTTP集成中服务操作配置期间的数据类型。
多选择的例子用例:
- 网讯—选择多个用户发送会议邀请。
- 内容—选择多个用户共享工作表。
- Jira-选择多个标签分配给一个单一的Jira票。
- Office 365日历—调度事件时,选择多个与会者。
- Office 365电子邮件—选择多个收件人。
配置
配置类似于查找,但有两个配置选项:“最大项目计数”和“可以创建新项目”。除了标准页面构建器配置选项外,还定义以下内容来配置多选查找:
映射到记录值-定义预选值的数据源,仅在详细页面上可用(需要记录id)。与Select不同,Multiselect查找不限于单个值。
选项的数据源-定义下拉列表选项的数据源。
搜索词匹配策略-选择搜索词是否匹配数据库值的开头或数据库值中的任何位置。
最大项目数-设置查询时选择的最大项数。
可以创建新项目-允许用户创建查找选项中尚未可用的项(例如,向Jira票据添加新标签)。
完整性检查
完整性检查的工作原理与查找相同,但所选项目的最大数量必须是非负的。数据源表必须存在,用于值、显示值和附加数据的表列必须正确映射到具有外键的数据表。
有关将数组配置为返回多个条目的详细信息,请参见数据类型。
复选框
通过定义源(数据表和列)和默认值(选中或禁用),在页面上添加可选择组件。组件可以标记为可选。
广播
添加一组选项,其中只能选择一个。由来自源系统的数据填充,或者您可以手动输入值列表。组件可以标记为可选。
日期/时间
定义在微应用程序中显示的日期、时间或日期和时间,以及加载到页面的默认时间(选择之前显示的时间)。组件可以标记为可选,字段宽度可以修改。
文件上传组件
允许在提交或更新操作期间将原始文件上传到SoR。要启用此操作,需要创建一个支持文件上传的特殊服务操作。
该组件允许用户工作流将文件作为现有记录的附件上传到SoR,并在创建记录时作为附件上传到SoR。例如:
- Jira:上传日志文件和截图,并将其附加到问题单上。
- Salesforce上传发现协议文件,并将其附加到帐户或机会。
- SAP一致管理费用报表时附上收据。
- ServiceNow:上传附件作为提交工作流的一部分。
创建服务操作
要启用文件上传,必须使用脚本来配置服务操作。有一个文件参数类型以支持此功能。有关总体概述,请参见HTTP集成脚本。
开始之前
- 准备好要通过Microapp管理界面导入的脚本。
- 脚本必须用javascript语言编写,在您首选的文本编辑器/开发工具中编辑。
- 准备好后,通过Microapps管理界面中的集成选项卡导入脚本,或者您也可以直接将脚本输入到脚本功能提供的文本编辑器中。
- 导入后,测试脚本。
下面是一次将多个文件上传到JIRA的服务操作示例。有关更多脚本,请参阅此脚本库。
javascript函数addAttachmentsSingleRequest({client, actionParameters}) {console.log('附加文件(s)发出${actionParameters. issuekey} ');const formData = new formData ();const url = ' /rest/api/2/issue/${actionParameters.issueKey}/attachments ';actionParameters.attachments。forEach(文件=> {formData。追加(“文件”,文件);});Const response = client。fetchSync(url, {method: 'POST', headers: {"Content-Type": "multipart/form-data", "X-Atlassian-Token": "nocheck"}, body: formData});if (response.ok) {console.log('附件已张贴');} else {const errorMessage = '请求失败(${响应。{{response.statusText})` console.error(errorMessage) throw new Error(errorMessage)}} “”
导入脚本
要导入准备好的脚本,请遵循以下步骤:
- 从集成的集成配置屏幕中,选择脚本从左边导航栏开始。
- 选择上传脚本。或者,您可以通过选择将脚本直接输入到文本区域编辑。
- 将脚本拖到导入弹出窗口中。
- 对脚本进行解析和验证。
- 选择进口。
- 导入脚本。
关于脚本的更多信息
- 要开始开发脚本,请参见Citrix开发人员门户。
- 有关使用脚本设置自定义集成的端到端过程,请参见开始使用Microapps脚本。
- 有关Microapps脚本的示例,请参见Microapps脚本SDK。
配置文件上传组件
现在返回到微应用程序中的页面,查看您想要创建的用于上传文件的集成。在放下文件上传组件中,完成文件上传属性。
- 修改的值标签如果需要。默认情况下,这是文件上传。不需要标签。这个值出现在Citrix工作区的下拉框上方。
- 修改的值最大文件数如果有必要的话)。默认情况下,这是1。此值显示在文件上传限制在Citrix工作区的下拉框下。当选择多个文件时,每个文件的元数据上传和内容上传将独立进行。这种能力受到SoR的限制。
- 修改的值最大文件大小如果有必要的话)。默认情况下,这是5。此值显示在总尺寸限制在Citrix工作区的下拉框下。文件大小受SoR的限制。我们建议将最大文件大小配置为实际需要的大小,以防止资源浪费。
- 为文件扩展名(例如。jpeg,。png,。pdf)。不需要值。此值显示在可接受的文件格式在Citrix工作区的下拉框下。此字段不区分大小写,不接受特殊字符。
- 启用要求如果提交此页需要添加文件,请切换。一个这个字段是必需的。标签显示在Citrix工作区的下拉框上方。
- 禁用启用如果您希望拖放框架在Citrix工作区中显示为暗的并且不可用,请切换。
- 禁用可见如果您想在Citrix工作区中隐藏下拉框,请切换。
注意事项
用户在上传内容时应考虑以下限制:
- 文件名必须以允许的后缀之一结尾。除了空字节之外,所有字符都是允许的
\ 0
。 - 微应用服务不提供文件存储。文件直接上传到SoR。在上传过程中,Microapps服务首先将文件从用户的计算机传输到安全的临时存储,然后立即将文件流式传输到SoR。临时存储上处理过的文件从那时起,任何人都不能出于任何目的访问,并在短时间后删除。
- 用户可以在确认上传之前删除他们之前选择并预上传的文件。
- 浏览器根据文件的扩展名检测文件类型(mime类型)。Microapps服务不使用文件类型进行任何检查。
显示组件
显示部分提供了向微应用的最终用户传递信息的组件,包括表、静态文本和图像等。在构建操作页面时,只要可以选择用户电子邮件作为提取数据的变量,就可以使用Active Directory用户主体名称(UPN)属性。这包括页面和组件过滤器、约束和服务动作参数。
表格
添加一个表,通过定义表源、过滤器和定义列来显示记录列表。可以添加页面链接操作,将用户引导到另一个页面。可以修改对齐方式。
一个列选项卡在选择此组件后在右窗格中启用。使用这些设置添加尽可能多的列:列标题,数据类型,数据表,数据列,格式,有条件格式。看到组件属性这些领域的解释。
必须设置个性化查询以限制数据暴露。没有个性化查询的表将公开与表过滤器匹配的所有记录,而不管与订阅者的数据关系如何。你的潜在敏感数据可能会暴露给所有微应用用户,除非你限制数据暴露。控件控制页面的数据访问数据过滤特性。在组件构建器窗格中选择表。选择表属性然后数据过滤。选择+添加条件并根据需要添加约束。有关此组件的使用示例,请参见构建详细信息页面。
列表/网格
在Citrix工作区中向用户显示数据列表。从预先配置的布局中进行选择,以最适合您的数据的方式显示正确的信息。您可以手动定义列表中的项,也可以从缓存中提取它们。
下属性列表选项卡,选择:
- 数据表从缓存中提取数据。的列表数据源,列表项数据源,布局和样式选项卡可用。属性说明列表数据源和列表项数据源都可以在组件属性。
- 手工指定来定义列表中的项。列表项和布局和样式选项卡可用。为列表项,定义你想要在清单中列出的项目。属性说明可在组件属性。
的布局和样式TAB可用于两种类型的列表属性。的布局菜单提供了预配置布局的选择。从以下选项中选择最适合您需求的布局:
- 列表-手风琴:显示可扩展的文本内容单元。
- 列表-基本:只显示文本列表。
- 列表-项目符号:仅显示无序的项目符号文本列表。
- 列表-有序:显示有序的、编号的文本列表。
- 列表-缩略图:显示带有缩略图和样式的列表。
- 网格-英雄图像卡方:显示卡片的侧面有一个大的图像。
- 网格-英雄图像卡顶:显示卡片,上面有一个大的图像。
- 网格-图像:显示多列图像单元。
- 网格-缩略图边:显示带有缩略图的多列列表。
- 网格-缩略图顶部:显示居中对齐的内容单元。
纯文本布局允许您切换显示标题和显示描述。您可以禁用其中一个选项,但不能禁用两个选项。缩略图布局打开一个显示图像图像的切换和其他格式化选项。其他属性说明可在组件属性。
文本
从表格和格式中定义要加载到页面的文本源。数据源、表、列都被选中以填充文本。可以给出时间、日期等文本格式,也可以根据参数给出条件格式。您可以添加转到页面、URL、发送电子邮件或呼叫电话的操作。有关此组件的使用示例,请参见构建详细信息页面。
Text组件被设计为显示单个数据库值。如果页面依赖于记录ID,则运行完整性检查并向用户发出警报。对于设置为操作页面的详细信息或表单类型页面,需要页面数据筛选器来调用唯一记录。我们显示此消息是为了提醒您注意此问题。你的微应用可能会正常工作,但如果唯一记录没有传递到页面,组件可能会显示错误的数据。
静态文本
定义要在页面上显示的静态文本。可以添加动作。可以修改对齐方式。如果文本是标题,则可以进行区分。字体样式有粗体和斜体两种。字体大小可以从正常,轻,小,小轻更改。您可以添加转到页面、URL、发送电子邮件或呼叫电话的操作。有关此组件的使用示例,请参见创建一个创建页面和构建详细信息页面。
静态图像
显示从预定义的静态URL源引用的静态图像。可以指定图像大小和对齐方式。不能添加任何操作。
图像
使用存储在缓存(数据表和列)中的URL显示图像,并对其进行格式化,以便在页面上显示。如果图像无法加载,则添加文本显示。可以配置图像格式,如对齐、大小和形状。
行分频器
使用分隔符将不相关的信息分开,将相关的信息分组。不能修改任何属性。
后退按钮
允许用户返回到上一页。可以指定一个变量;即数据表、数据列和格式。有关此组件的使用示例,请参见构建详细信息页面。
权力BI
在工作区中显示BI报告。定义源和格式。当用户在Citrix Workspace中查看这个Power BI组件时,首先会提示他们登录Power BI。
一个Power BI组件属性选项卡在选择此组件后在右窗格中启用。当首次添加此组件时,没有选择任何服务操作,并且无法编辑该组件。您必须为用户授权设置服务操作。设置服务操作后,在组件中设置授权。有关完整步骤,请参见配置Power BI组件业务动作。
同意收据查看器
显示收据图像。用数据表和数据列定义源,并定义格式。Concur收据查看器组件仅在Concur集成模板中可见。
表
显示Tableau报表。用数据表和列定义源。
HTML内容
显示来自提取源(例如RSS提要)的HTML内容,以便正确显示HTML。用数据表和列定义源。支持基本文本元素。允许的元素有:
- " p "、" div " h1, h2、h3,“h4”,“h5”、“编辑”、“ul”、“ol”、“李”、“引用”、“b”,“我”、“字体”、“s”、“u”,“o”,“一口”、“子”、“ins”、“▽”、“强”、“罢工”,“tt”、“代码”、“大”、“小”、“品牌”、“跨越”,“新兴市场”。
- " a "元素只具有" target "和" href "属性。
- " img "元素只具有" height ", " width ", " src "属性。
- 此外,任何元素都允许使用“style”属性。
附件
列出数据源中的附件,并允许最终用户下载附件。图像和pdf文件可以直接预览。通过指定数据表、为URL指定数据列和为名称指定数据列来定义源。
- 如果未配置数据mime类型(媒体类型),则附件预览图标显示为?。
- 如果未配置文件大小,则显示附件预览0 b作为尺寸。
选择附件URL安全选择:
- 继承了附件必须位于集成访问的同一域中。否则,附件不会显示,也无法下载。例如,这是谷歌集成的一个已知问题。
- 公共:其他域的公共附件,如果不需要认证方式,可以显示。
嵌入
允许网页嵌入到你的微应用中,然后显示在Citrix工作区中。支持的内容包括:公共YouTube视频,谷歌地图,Podio/谷歌/Microsoft表单,大多数公共响应式网页,以及由其提供商设计的嵌入到网站中并显示在iframe中的任何内容。
一些外部内容在设计时没有考虑嵌入或者是严格禁止的。例如
- 明确禁止嵌入的网页
X-Frame-Options“SAMEORIGIN”;
头。一个显著的例子是https://google.com
。 - 重定向到不同于页面构建器中组件配置中指定的域的网页。
- 需要身份验证的网页在嵌入时可能会遇到问题。管理员必须仔细测试。
- 包含cookie同意(例如,GDPR要求)的网页不会将其选择缓存到嵌入组件中。如果用户再次访问嵌入的网站,他们必须每次重新确认cookie同意,除非该网站使用
SameSite:没有;安全= true
饼干的属性。
配置嵌入组件
在放下嵌入组件中,完成嵌入属性。
请注意
要成功嵌入某些网站的内容,您必须使用直接从网站生成的嵌入代码(而不是直接URL或共享链接)。在谷歌Maps上生成嵌入链接时分享选项中生成的链接嵌入地图而不是发送链接。
- 进入URL您想要嵌入的内容。
选择其中一个高度模式选项,用于选择如何确定嵌入内容的大小。
- 宽度乘数:启用乘数(百分比)字段。输入与嵌入内容宽度相关的百分比值。例如,输入50时,显示的内容高度为其宽度的一半。
- 固定:启用绝对高度(像素)字段。输入像素数以确定嵌入内容的高度。
构建器中不可使用嵌入的内容预览。选择预览microapp以查看嵌入内容的外观。
注意事项
在嵌入内容时,请考虑以下几点:
- 尽可能使用可嵌入版本的网页。这些页面已经由内容提供者进行了嵌入优化。例如,一个YouTube视频id
XXX
可在https://www.youtube.com/watch?v=XXX
和https://www.youtube.com/embed/XXX
。第一个URL指向完整的网站,第二个指向可嵌入的视频。 - 在指定URL时,可以使用模板变量将参数传递给远程URL。对于相同的YouTube示例,假设您有一个名为
video_id
包含视频标识的,输入https://www.youtube.com/embed/ {video_id}
到URL
字段。的字符串{video_id}
将被表中的行值所替换。 - 嵌入的页面显示在一个具有以下属性的沙盒iframe中:
允许-脚本允许-同源允许-弹出允许-弹出-逃避-沙箱允许-表单允许-指针锁定允许-下载
。这些标志确保了第三方内容与Citrix Workspace的完全隔离,但可能导致远程页面上的某些功能被破坏。 - Embed组件不能显示需要自定义浏览器插件的文档。由于这个原因,pdf不能在Embed组件中显示。
布局组件
Layout节提供用于设置页面布局的网格组件。
灵活的网格-使您能够更好地控制组件在页面上的位置,从而更容易地“管理”组件。当您设计用于较大屏幕设备的页面时,此选项非常有用。
一个柔性网格属性选项卡在选择此组件后在右窗格中打开。设置网格中的列数和行数,并自定义对齐方式。有关此组件的使用示例,请参见创建一个创建页面和构建详细信息页面。
页面的细节
通过输入名称、设置信息过滤器和向页面组件添加逻辑来配置您正在创建的页面。此外,使用信息调试功能:
- 页面名称—设置页面名称。
- 数据过滤—用于对动作数据设置约束。
- 显示SQL-使用它来显示用于调试目的的SQL。
- 逻辑—用于添加和显示组件逻辑。详情请参阅添加逻辑在下面的部分中。
添加逻辑
选择添加逻辑按钮下的页面的细节选项卡打开逻辑配置。这使您能够为特定的页面组件配置逻辑。指定此页上组件的行为或外观。根据组件的预期行为,使用标准逻辑参数创建条件以实现各种结果。您可以向任何单个按钮添加多个堆叠动作,以通过单击创建多个动作效果。当每个服务操作成功运行时,系统将遍历操作链,直到所有操作都完成。可用的操作包括:
- 评估条件-通过逻辑参数设置和编辑条件。
- 设置组件值—设置提交动作按钮的组件值。
- 显示组件—配置显示组件的条件。
- 隐藏组件—配置隐藏组件的条件。
- 使组件—配置启用组件的条件。
- 禁用组件—配置禁用组件的条件。
- 将组件设置为required—配置需要该组件的条件。
- 将component设置为not required—配置排除组件的条件。
组件属性
每个页面构建器组件都有自己特定的属性菜单,其中有各种选项可供选择,具体取决于组件,包括:
- 标签—自定义按钮标签、文本、图像等。
- 占位符文本—向用户解释该组件的使用方法。例如,列出用户可以搜索的属性。
- 内容—输入静态文本显示最终用户。
- 对齐-设置显示文本或图像的对齐方式。
- 文本类型—设置显示文本的大小。
- 字体样式—设置显示文字的字体样式。
- 字体大小—设置显示文字的字体大小。
- 字段宽度-设置组件的显示宽度。
- 格式-定义数据显示给用户时的格式。例如,日期、时间、小数、百分比等等。
- 默认值-用于输入组件手动或使用变量设置默认值。
- 风格-用于按钮组件在不同的预定义颜色和格式之间切换。
- 使用与页面相关的记录-用于表组件过滤该条记录在页面中显示的相关记录。例如,您有一个页面显示关于某个帐户的数据,并且您希望显示包含与该特定帐户相关的联系人列表的表。
- 映射到记录值选项的缓存中显示特定记录的数据输入组件。例如,在创建Edit类型页面时启用此开关,因为您希望在更改这些值之前向最终用户显示实际数据。另一方面,如果您正在创建一个Create Record类型的页面,不要启用Map来记录值,因为这个页面没有绑定到任何现有的记录。因此,映射您的输入组件对任何记录。
选择类型-选择选项的来源选择组件和无线电组件。
- 如果手动输入值被选中,那么价值和标签必须完成。Value然后在服务操作中使用,而Label是最终用户在Citrix Workspace中看到的。
- 如果从数据库中选择,则必须填写以下字段:选项的数据源,选项数据表,选项标签的数据列,选项值的数据列。然后在服务操作中使用选项值的数据列,而选项标签的数据列是最终用户在Citrix Workspace中看到的。
- 的组合选择类型和映射到记录值可以用于不同的用例。例如,从数据库中选择并启用映射记录值通常用于编辑类型页面。在此场景中,数据表和数据列用于显示当前数据,数据源用于显示选项,数据表用于显示选项标签,数据列用于显示选项值,数据列用于显示缓存中的所有其他可用选项,最终用户在编辑记录时可以使用这些选项。
数据源—选择显示元素的数据源。
- 使用列值如果要显示缓存中的特定列。
- 使用模板如果要显示缓存中的各种属性的字符串。例如,帐户地址在缓存中被分成3列,但是您希望在一个组件中一起显示它们。
- 数据表—选择显示元素对应的数据表。
- 数据列—选择显示元素对应的数据列。
- 有条件格式—为元素配置条件格式。
- 插入变量—在页面元素中添加变量,自动显示应用集成数据。
- 数据过滤—设置显示数据的约束。选择设置过滤器,然后添加,并根据需要添加条件约束。
- 数据订单/订单—设置显示数据的顺序。选择设置顺序,然后添加规则,以及所需的规则约束。
- 显示附加数据列toggle -用于切换查找组件定义在执行搜索时显示给用户的额外列。
搜索词匹配策略-用于查找组件定义搜索策略。
- 开始于—这种搜索方法是最快的,因为它不会使缓存过载。它在定义的缓存属性中搜索值的第一个字符。这种搜索方法对于大多数用例来说是令人满意的。
- 包含-根据数据收集的大小,这种搜索方法可能会非常慢。它搜索定义的缓存属性中值的所有字符。
- 字段宽度-用于输入组件来定义输入字段的宽度。
- 要求toggle -用于输入组件以便在配置服务操作的按钮可操作之前提示最终用户输入数据。
- 启用toggle -用于输入组件显示不希望最终用户能够更改的特定记录的数据。
- 可见toggle——用于需要额外的Page逻辑数据、Go To Page等,但不希望将这些信息显示给最终用户的情况。
- 将其隐藏为空-用于某些显示组件如果没有可用的数据,则不希望向最终用户显示此组件。
- Alt. text/Alt属性-用于图像组件。输入显示图像显示是否有问题的文本。
- URL前缀-用于图像组件为URL配置静态前缀,而URL的其余部分则取自数据表和数据列字段。
- 图像大小—选择显示图像的大小。例如,缩略图或全宽。
- 图像的形状—选择图像的形状。例如,圆或圆角。
- 布局—从预先配置的布局中选择列表组件。
输入验证规则
为某些输入组件添加规则,以限制用户可以输入的数据格式。每个组件都有自己特定的验证规则可用。总有一个最小和最大的选项可以设置。
此选项卡可用于以下组件:文本输入,日期/时间,文本区域,Num.输入。有关详细信息,请参阅每个组件的描述。
行动
操作菜单可用于按钮组件允许微应用的接收者(工作区用户)使用可操作的输入进行响应。不同的组件有不同的操作。
启用页面操作按钮
启用页面动作按钮在Citrix工作区的页页页脚中显示按钮组件。基于此切换,Button组件可以使用不同的操作子集。考虑以下几点:
- 如果该按钮出现在刀片的页脚上,则用户在Citrix Workspace中选择页脚按钮后,刀片将自动关闭。
- 如果您想要添加诸如Go to Page或Go to URL之类的操作,您不希望在页脚中显示按钮,以便Citrix Workspace可以将最终用户导航到下一个屏幕。如果启用此切换,则无法使用此类操作。
添加操作
定义按钮从您在集成中配置的已配置服务操作中运行的操作。行为包括:
- 运行服务动作-定义按钮从集成中设置的已配置服务操作中运行的操作。看到配置Service动作参数举个例子。
- 发送电子邮件—根据预先设置的属性发送邮件。看到添加发送电子邮件操作举个例子。
- 添加G Suite事件—根据预配置的属性创建谷歌日历事件。
- 回来—将用户导航到上一页。
- 转到页面—将用户导航到预配置的微应用页面。看到添加Go to Page操作举个例子。
- 转到URL—将用户导航到预先配置的URL。看到添加Go to URL操作举个例子。
- 运行通知触发器—运行预先配置的通知事件。看到添加运行通知触发器操作举个例子。
添加Go to Page操作
定义一个动作,将用户发送到预配置的微应用页面。
- 在添加了按钮组件添加到构建器,并在按钮属性选项卡,选择行动选项卡。
- 禁用页面动作按钮切换。在添加操作字段中,选择转到页面。
- 选择转到页面下行动。行动的标签领域,应用程序选择器,页面选择器打开。
- 下应用程序,选择要从中选择页面的微应用程序。
- 下页面,选择您希望按钮打开的页面。
- (可选)目标页记录选择设置的条件如果要过滤已配置页面中的数据。例如,用户正在查看包含帐户数据的页面。用户选择一个标有机会并且,根据目标页面记录条件,导航到具有期望值高于某一特定值的所有相关机会列表的页面。
- (可选)填充目标页面选择编辑字段如果要在目标页面中预填充字段。例如,用户正在查看Jira票据,并希望在同一项目中创建一个新的票据。用户选择一个标有新并导航到一个页面,在这个页面中,Project字段是用上一页的值预先填充的,但所有其他属性都必须手动输入。
添加运行通知触发器操作
定义一个操作来触发通知,以运行通知事件的评估,并向目标受众发送通知消息。此操作可以显示在页面主体或页脚中。
- 在添加了按钮组件添加到构建器,并在按钮属性选项卡,选择行动选项卡。
- 离开页面动作按钮启用在页脚显示按钮的开关。禁用在页面主体中显示按钮的开关。
- 在添加操作字段中,选择运行通知触发器。
- 选择运行通知触发器下行动。
- 下事件时,选择要运行的事件触发器。您可以为此按钮选择多个事件。
使用组件值作为参数
中使用组件值作为参数发送电子邮件和转到URL行动。此功能允许:
- (发送电子邮件)工作区用户可以在工作区字段中输入给定操作的电子邮件收件人。
- (转到URL)用户在工作区表单中的输入可以作为工作区中打开的URL模板的一部分。
根据您的用例遵循以下步骤。
添加发送电子邮件操作
- 在添加了按钮组件,并将其命名为按钮属性,选择行动选项卡。
- 禁用页面动作按钮切换。在添加操作字段中,选择发送电子邮件。
下来中,选择插入变量。
- 在插入变量屏幕,来自类型菜单选择组件值。
- 下组件,选择用户在其Workspace表单上输入的所需输入组件。的来字段用组件ID填充。
- 添加一个主题和身体为所需的消息。在Workspace中,用户可以在该组件启用的字段中输入电子邮件地址。当他们提交电子邮件地址时,他们的电子邮件将打开一个预先填充的消息,如果需要可以修改并发送。
添加Go to URL操作
- 在添加了按钮组件,并将其命名为按钮属性,选择行动选项卡。
- 离开页面动作按钮启用切换。在添加操作字段中,选择转到URL。
- 在URL模板字段,输入要打开的目标站点的URL。
- 下URL模板字段中,选择插入变量。
- 在插入变量屏幕,来自类型菜单选择组件值。
- 下组件,选择所需的组件。的URL模板字段填充添加到您输入的URL的组件ID。在Workspace中,用户可以在该组件启用的字段中输入一个值。当他们提交查询时,所选择的组件值被用作浏览器中打开的URL中的变量。
注意:
选择模板字段旁边的info图标,可以查看所使用组件的详细注释。
配置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。
在登录用户可以查看仪表板、报告或tile之前,需要使用Power BI组件设置对其进行授权。要设置此设置,您需要配置一个服务操作来为用户生成令牌。为仪表板、报表和磁贴配置此功能。授权作为常规服务操作工作。例如,如果您为Service Actions设置了单独的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和dashboardId、reporttid和tileId参数。以下面的模型为例:
下行动的执行选择身体选项卡。选择JSON从内容类型列表。
{" accessLevel ": " View "}
现在,使用这个新配置的服务操作在组件中设置授权。遵循下面的一般示例:
- 在微应用程序中,例如,在您为仪表板提取数据的微应用程序中,选择具有Power BI组件的任何页面。
- 选择权力BI组件,然后是电源BI授权右边是TAB。
选择编辑参数,并填写如下所示的字段:
- 选择保存完成。