1. 资产门户说明
资产门户用于数据消费者使用数据资产,在资产门户上可检索、查看数据资产,并申请、使用相应服务。
下图就是一个资产门户,整个页面分为三个区域,【资产目录树】、【筛选区】和【资产列表】。下面我们依次对这3个区域展开介绍。
资产目录树
在此区域可以直观的看到当前资产目录的资产数量、已开放服务的资产数量(数据资源门户)、API数量(数据产品门户)以及目录结构。
目录树上方的搜索框用于搜索定位目录。点击目录树中某个分类,右侧资产列表则显示该分类下的数据资产,且支持同时选中多个不同维度的分类进行联合筛选。
由于资产属性“数据资产提供方”的选项来源是系统组织机构树,门户左侧的“数据资产提供方”也按机构层级进行展示,方便进行统计和筛选。
筛选区:
除了使用目录树筛选资产,资源门户可以在筛选区的搜索框中输入资产标题、资产代码、信息项中文名、信息项英文名、挂接库表名进行模糊匹配搜索,产品门户可以在筛选区的搜索框中输入资产标题、资产代码进行模糊匹配搜索。
同时也可以通过点击标签、评价等级、有无服务等进行筛选;以及按资产名称或修改时间升序或降序,以达到自定义筛选的目的。
资产列表
(1)切换显示模式
资产列表有两种显示模式,可自由切换。
(2)查看资产详情
点击资产名称可以进入到资产详情页面。
数据资源的详情页面包含基本信息、信息项信息、服务信息和API服务信息;
在服务信息处可查看示例数据。
数据产品的详情页面包含产品介绍、资源内容、规格参数、服务详情和用户评价;
在资源内容处可查看示例。
(3)申请/使用服务
使用服务前需要先申请服务。
如果申请是自动通过,无需审批,则刷新页面后即可使用该服务;如果有审批流程,则审批通过后才能使用该服务。
可在【我的服务】中查看申请的服务的审批状态。
也可在【我的服务】中操作服务。
不同的数据资产提供的服务不同,具体可以参考《数据资源提供的服务》和《数据产品提供的服务》章节。
(4)收藏/分享服务
支持收藏数据资产,如下图,点亮小红心后可在【我的收藏】中查看使用收藏的资产。
另外还可以将数据资产分享给平台其他人,如下图,分享之后可以在【我的分享】中查看我分享过的资产,在【分享给我的】中查看其他人分享给我的资产。
(5)评价资产
在资产详情页面,可以给该资产打分和评价,并且可以看到其他人的评价信息。
数据产品评价页面:
数据资源评价页面:
2. 创建资产门户
平台中可创建的资产门户分为三种:数据资源门户、数据产品门户和接口服务门户。
2.1. 数据资源门户/数据产品门户
数据资源门户和数据产品门户操作方法类似,下面我们以数据产品门户为例介绍创建过程。
【操作步骤】
在【数据资产】-【服务门户】-【门户管理】中,点击【新建】选择【数据产品门户】。
在弹出的对话框中,完成“目录标题”、“产品门户标题”、“数据资产属性”、“属性展开方式”等设置,如下图所示。
其中,
1. 目录标题:选择需要创建资产门户的数据产品目录,这里只能选择已开放状态的资产目录。
2. 产品门户标题:填写当前创建的门户名称。
3. 数据资产属性:设置资产门户中资源树的分类维度。比如勾选了“类目”、“数据资产格式”和“数据资产提供方”,这样该资产门户的资源树会按这3个维度进行展示,如下图所示。
4. 属性展开方式:可设置不展开、展开一级、逐级展开。
设置为“不展开”,门户的左侧属性默认只能看到根级节点,下级节点需要手动展开。
设置为“展开一级”,门户的左侧属性默认只能看到根级节点及其下第一级节点,第二级及其下级节点需要手动展开。
设置为“逐级展开”,门户的左侧属性默认每一级节点都是展开状态。
三种展开方式的具体效果,如下图所示:
5. 资产显示条件:可填写表达式,控制该资产门户中只显示满足条件的数据资产。比如,需要资产门户中只显示数据资产格式分类为“数据库”的数据资产,可设置资产显示条件为TYPE='database'。表达式写法具体见资产显示条件表达式章节。
6. 是否需要登录:默认不需要,这样游客访问资产门户(通过url访问)不需要进行登录,可查看资产,申请服务等操作才需要登录;如果设置为需要,则游客访问资产门户(通过url访问)需要先进行登录。
7. 是否列表展现:默认是列表展现,如若不勾选会直接大图展现。
门户基础信息配置好后,可点击对话框左下角【预览】按钮查看效果,或者也可以直接【确定】完成资产门户创建。
2.2. 接口服务门户
在数据资产管理的服务门户中,接口服务门户支持两种 API 申请方式:“申请服务”与“申请自定义服务”。若资产未挂接库表,则不显示【申请自定义服务】按钮,若资产未绑定API,则不显示【申请服务】按钮。具体操作请参见【从接口服务门户申请API服务】章节
申请服务
API:选择已绑定的API接口数据库表
调用方式:调用方式有“按调用次数”
ip地址:在申请框中可配置IP地址,用于控制接口的调用来源
申请数据:根据调用方式,申请API调用的次数\行数\月数。
申请自定义服务
2.3. 资产显示条件表达式
TYPE(数据资产格式分类)
目录类型 | TYPE属性值 | 注释 |
资源目录 | database | 数据库 |
doc | 电子文件 | |
image | 图形图像 | |
media | 流媒体 | |
other | 其他 | |
sheet | 电子表格 | |
产品目录 | product | 数据产品 |
例如,数据资源门户上设置资产显示条件TYPE='database' ,表示门户上只显示数据资产格式分类为数据库的资产。
FORMAT(数据资产格式)
目录类型 | 数据资产格式分类 | FORMAT属性值 | 注释 |
资源目录 | database (数据库) | Oracle | Oracle |
Mysql | Mysql | ||
Aliyun ADS | Aliyun ADS | ||
Sybase | Sybase | ||
SybaseIQ | SybaseIQ | ||
DB2 | DB2 | ||
Mssql | Mssql | ||
Oscar | Oscar | ||
XCluster | XCluster | ||
TimesTen | TimesTen | ||
KingbaseES | KingbaseES | ||
Kingbase Analytics DB | Kingbase Analytics DB | ||
DM DBMS | DM DBMS | ||
Essbase | Essbase | ||
GBase | GBase | ||
Netezza | Netezza | ||
GreenPlum | GreenPlum | ||
Teradata | Teradata | ||
Vertica | Vertica | ||
PetaBase | PetaBase | ||
PetaBase 3 | PetaBase 3 | ||
GBase8T | GBase8T | ||
Informix | Informix | ||
ArteryBase | ArteryBase | ||
Hive | Hive | ||
Impala | Impala | ||
Transwarp | Transwarp | ||
HBase | HBase | ||
PostgreSQL | PostgreSQL | ||
FusionInsight(ELK) | FusionInsight(ELK) | ||
FusionInsight(SparkSQL) | FusionInsight(SparkSQL) | ||
FusionInsight(Gauss100) | FusionInsight(Gauss100) | ||
FusionInsight(Gauss200) | FusionInsight(Gauss200) | ||
HANA | HANA | ||
TiDB | TiDB | ||
Ti Spark | Ti Spark | ||
Spark SQL | Spark SQL | ||
XCloud | XCloud | ||
K-DB | K-DB | ||
Kylin | Kylin | ||
EsgynDB | EsgynDB | ||
h2 | h2 | ||
ClickHouse | ClickHouse | ||
Druid | Druid | ||
MaxCompute/ODPS | MaxCompute/ODPS | ||
Hetu | Hetu | ||
PolarDB | PolarDB | ||
Other | 其它 | ||
产品目录 | product(数据产品) | ANA | 数据分析产品 |
PORTAL | 门户产品 | ||
SUBJECT | 数据主题产品 | ||
FILESET | 文件主题产品 | ||
API | API产品 |
例如,数据产品门户设置资产显示条件FORMAT='ANA',表示该门户只显示。数据分析产品,其他类型产品资产不显示。
PROVIDER(数据资产提供方)
对应的值为固定前缀“EACL$1$”+组织机构代码,例如在用户权限功能模块中,某组织机构代码为:product1,机构名称为:产品一部,那么对应的值为:EACL$1$product1
则PROVIDER='EACL$1$product1' 表示门户上只显示数据资产提供方是产品一部的资产。
支持根据登录用户所在机构动态赋值,表达式:PROVIDER='login.orgid_'。设置不同机构下的用户仅支持查看本机构作为资产提供方的数据资产
SHARETYPE(共享类型)
表达式写法为:SHARETYPE=属性对应维表项的代码值
可以在【数据开发】-【数据集】-【公共维表】-【资产目录】中找到关联的维表查看对应的维项代码,例如SHARETYPE='0'表示共享类型为无条件共享。
其它有关联维表的属性
可以在数据资产目录的属性设置界面中查看属性代码,以及关联的维表。
比如上图中“来源系统”属性关联了维表,故该属性也可以用在资产显示条件表达式中,表达式写法为:LYXT=属性对应维表项的代码值 。
可以在【系统设置】-【公共维表】中找到关联的维表查看对应的维项代码。
则LYXT='01'表示门户中只显示来源系统为运营系统的数据资产。
支持函数和操作符
资产显示条件表达式中支持使用系统内置函数和操作符。
例如,资产显示条件为left(LYXT,1) =0 | TYPE='database' 表示门户中只显示来源系统第1位为0的,或者数据资产格式分类为数据库的数据资产。
2.4. 资产编码对资产进行排序
在资源目录门户中,对资产进行排序时需要点击对数据资源编码进行排序。如下图。
2.5. 资产门户分页大小
在资产门户中,对资产进行查看数据时,如下图中,页面太多需要滑动时,我们可通过资产属性配置的分页大小进行分页。
具体操作:在【目录管理】-【资产目录】【属性库管理】中添加自定义属性。注意属性的属性代码code一定要是【PAGESIZE】
接着在【资产目录】属性中,添加已经配置好的分页大小属性。
属性添加完成后,在【资产编目】国编辑资产,设置对应的值即可。
效果图
3. 编辑资产门户
已经保存的门户可以在门户管理页面中查看到,点击对应门户的编辑按钮,即可对门户属性进行修改。
设置资产显示字段
点击【资产字段】即可对当前门户上对应资产的描述字段进行调整。
配置服务申请信息项
在门户管理页面,可配置门户上服务的申请信息项,自定义申请服务时用户需要填写的信息字段。
Tips: API服务/API产品申请调用,与普通服务申请不同,API申请信息项暂不支持配置,服务申请信息项配置不会影响API申请信息。 |
点击【配置申请信息】,打开新标签页,显示当前门户配置的申请信息项,可对申请信息项进行增、删、改、上移、下移等操作。
新建申请信息项,支持的数据类型有8种:字符型、整型、浮点型、日期型、大字段、文件、用户、机构。所有数据类型均支持配置默认值和是否允许为空。
Tips: 配置申请信息项的默认值,无论数据类型是字符型、用户还是机构,都不需要带单引号或双引号。 |
新建申请信息项,字段类型为字符型时,支持关联维表,设置维表后,支持设置是否“支持多选”和“仅选择叶子节点”。若勾选“仅选择叶子节点”,只能选择维表数据中的叶子节点。
配置申请信息项完成后,在门户中申请服务时,用户需要根据设置的申请信息项进行填写。
配置申请信息中选择“机构/用户”。即在门户中申请服务时,也可以选择机构/用户。机构/用户类型的信息项的下拉选项是系统机构/用户资源树。用户需要有用户权限-机构用户的查看权限,机构/用户信息项下拉框才会显示有权限的机构/用户。
配置申请信息中选择“文件”。在门户中申请服务时,文件类型的信息项能上传1个文件,支持下载。
申请提交后,当服务申请绑定工作流,审批人员在资产服务审批页面,办理工作流或查看申请详情,都能查看到申请人填写的信息,从而进行审批。
4. 内置门户使用说明
除了资产门户,平台还提供了另一种门户页面“内置门户”。以“数据资源内置门户”为例,在内置门户中资产使用者能够总览“已发布共享库表数”、“已发布共享文件数”、“已发布共享接口数”等关键信息;可以关注到最新的资产动态、热门资产等时效性信息;以及含资产导航(跳转到资产门户)、目录管理、服务审批等功能入口。
数据动态/热门资产等:
【数据动态】这里实时展示最新修改的资产,点击按钮进入资产详情页面。
点击查看更多,打开资产门户查看全部资产数据,资产默认根据修改时间降序排列展示。
页面最下方分别有【最新发布资产】、【推荐服务接口】和【热门资产】。点击资产名称可查看资产详情,点击接口名称可查看接口详情。
资产导航
这里显示的是不同维度的资产分类。点击某个资产分类,打开到具体的资产列表。
在打开的资产列表页面(资产门户)可查看资产详情,并申请、使用资产服务。此页面的具体使用见资产门户说明章节。
服务指引
这里给出了进行资产管理的快捷入口。
(1)目录管理:
用户如果需要管理资产,比如编目资产、挂接资源、上下架资产等,则可以点击内置门户中的【目录管理】,这时会进入到资产管理页面,在相应模块完成相应操作即可。
(2)交换管理:
如果需要为特殊数据处理要求的数据交换绑定交换任务等,则可以点击【交换管理】,这时会进入到绑定任务界面,进行办理。
(3)共享开放审核:
如果需要进行审批工作,比如预编目审批、资产发布审批、资产下架审批,以及对数据消费者的服务申请进行审批,则可以点击【共享开放审核】,这时会进入到审批管理界面,在相应模块进行审批即可。
(4)数据源管理:
点击【数据源管理】可进入到数据源维护界面,在这里可以对库表数据源、FTP服务器、HDFS数据源等进行维护管理,方便后续挂接资源等。
搜索
支持输入资产名称、资产代码进行模糊匹配检索数据资产。
5. 激活内置门户
“数据资源内置门户”和“数据产品内置门户”这两个门户需要激活才能使用。他们的激活方法是一样的,下面以激活数据资源内置门户为例讲解如何激活。
【操作步骤】
配置内置门户信息
在【系统管理】-【系统设置】-【资源管理器】中,找到路径/root/products/edataasset/nzmh/assetPortal.properties文件
点击文件名称,进入该文件的编辑界面。
接着我们来配置数据资源内置门户,具体配置如下:
#内置资源门户版本标题——设置内置门户要展示的资产目录, resource.name=数据资源1(针对业务人员)(注意这里必须要与资产目录的标题一致,否则会匹配不成功) #内置资源门户门户标题——设置内置门户关联的资产门户,注① resource.portalname=运营系统 #内置资源门户预览标题——自行定义,注② resource.previewname=数据资源1(针对业务人员) #资源门户是否展示类目——true/false,注③ resource.type=true #展示维表——设置内置门户中要展示的分类,注④ resource.dimtable1=共享类型 resource.dimtable2= resource.dimtable3= resource.dimtable4= resource.dimtable5= |
注:①resource.portalname 用于设置内置门户跳转到的资产门户。设置后点击内置门户中资产分类可跳转到该资产门户:
②resource.previewname用于控制内置门户查看时,浏览器标签页上显示的文字:
③resource.type设置为false时,“类目”分类不显示,反之则显示:
④resource.dimtable 这里配置的是关联了维表的目录属性名称,添加后内置门户中会增加该属性的分类。例如,配置resource.dimtable1=共享类型,效果如下图:
执行门户更新脚本
内置门户配置完成后还需要执行一段脚本,用于更新内置门户的内容。重新配置内置门户后或者涉及的资产目录有变化时都需要执行这段脚本以更新内置门户内容。故需要创建一个计划任务定时执行该脚本。
在【系统管理】-【系统设置】-【计划任务】中添加“执行脚本”类型的计划任务
要执行的脚本为:
import com.esen.edataasset.api.service.assetportal.AssetDefaultPortalApiService; import com.esen.eutil.spring.SpringContextHolder; AssetDefaultPortalApiService service =SpringContextHolder.getBean(AssetDefaultPortalApiService.class); service.queryData(); |
计划任务中可配置脚本执行周期,下图中设置的是每半个小时执行一次。
计划任务创建完成后,点击【立即运行】手动执行下,这样,数据资源内置门户就被激活了,预览该门户就能看到相关资产信息了。
请先登录