- style
将自定义字段同步到域
作为服务提供商,有时需要额外的信息来解决特定类型的故障单。 对于此类故障单,您可以根据您的组织的要求配置额外的字段。 此类字段在 ServiceAide Cloud Service Management 中称为自定义字段。
可以将自定义字段添加到应用程序中的数据集域。 随后,便可在创建特别视图和报告时使用此类字段。 要将自定义字段添加到域,将与自定义字段数据同步域。
与“已共享”域同步自定义字段的过程不同于针对“Cloud SM”域的过程。
前提条件
- 确认已创建自定义字段。 有关详细信息,请参阅“创建和管理自定义字段模板”。
- 确认您拥有域设计器权限。
请执行以下步骤:
登录到 ServiceAide Cloud Service Management,然后依次导航到“报告”、“服务台”、“高级报告”。
要在高级报告中使用自定义字段,请依次单击“操作”、“同步自定义字段”。
可用自定义字段的列表随即显示于新选项卡中。 如果已将自定义字段添加到域中,该列表则会将相关字段显示为已选中。注意:为提高性能,请同步报告中所需的自定义字段。 同步可配置自定义字段的最大限制为 50。
“高级报告”中不支持名为“Join”的自定义属性。 但是,如果名称“Join”有前缀或后缀,则会受到支持。 例如,支持自定义属性名称 attributJoin 或 joinAttribute。选择要添加的自定义字段,然后清除要删除的字段。 单击“同步”。
此时将显示一则确认消息,并从域中添加或删除自定义字段。- 如果您正在使用 Cloud SM 域,则请执行步骤 5。 如果您正在使用 Shared 域,请执行步骤 6 – 12。
确认自定义字段已添加到域中:
单击“主页”选项卡,然后依次单击“操作”、“创建特别视图”。
选择“Cloud SM”域,然后单击“选择数据”。
在“源”面板中,转到“故障单”或“配置项”等数据集。 确认自定义字段已添加到其各自数据集下的“自定义属性”文件夹。
- 如果您正在使用 Shared 域,则请单击“主页”选项卡,然后依次单击“操作”、“编辑域”。 “编辑域”页面在新窗口中打开。
- 从“域设计”,单击“使用域设计器编辑”。 “域设计器”窗口打开。
在“计算字段”选项卡中,将非字符串数据类型的自定义字段转换为其相应的数据类型。
数据类型为整型、双精度型和布尔型的自定义字段将作为字符串数据类型进行存储。 将数据类型转换为原始数据类型,以便在报告中正确显示。
- 已创建的自定义字段可在相应类型的 _PIVOT 表中进行使用。 例如,如果您创建类型为“服务请求”的自定义字段,则会在以下表中提供该字段:
dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT 表。 双击要更改其数据类型的自定义字段。
输入字段名称、数据类型和表达式以便进行转换。 用于转换数据类型的表达式的列表如下:
数据类型
表达式
说明 整数
str2int(自定义字段) 转换为整数。
例如,要转换 dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT 表中的“Ticket_Id”字段,请输入以下值:
字段名称:Ticket_Id_trasnform
类型:整型
表达式:str2int(dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.Ticket_Id)
双精度型
str2double(自定义字段) 转换为双精度型。
例如,要转换 dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT 表中的“TotalCost”字段,请输入以下值:
字段名称:TotalCost_transform
类型:双精度型
表达式:str2int(dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.TotalCost)
日期
EPOCH_TO_UTC_DATETIME (str2int(自定义字段)) 转换为日期格式。
例如,要转换 dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT 表中的“start_date”字段,请输入以下值:
字段名称:start_date_trasnform
类型:时间戳
表达式:EPOCH_TO_UTC_DATETIME str2int(dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT.start_date))
字符串 - 串联
concat(自定义字段 1, ’,’,自定义字段 2) 将两个字符串合并为一个。
例如,要转换 dbo_VAPP_ITEM 表中的“contact_person”字段,请输入以下值:
字段名称:contact_person
类型:字符串
表达式:concat(dbo_VAPP_ITEM.person_last_name,',', dbo_VAPP_ITEM.person_first_name)
- 已创建的自定义字段可在相应类型的 _PIVOT 表中进行使用。 例如,如果您创建类型为“服务请求”的自定义字段,则会在以下表中提供该字段:
在“显示”选项卡中,将自定义字段从“资源”面板添加到“集和项”面板,然后单击“确定”。
选择所需的自定义字段和构建或筛选报告时有用的属性。 可以修改显示属性,如标签、表的说明以及每个选定字段的集和项。 在“显示”选项卡中执行以下任务:在“资源”面板中,找到自定义字段和要从联接树添加的属性。 所有自定义字段和属性均可在数据透视表中进行使用。 根据要添加属性的模板的“已关联表单”字段来列出这些属性。
要从“资源”面板中移动自定义属性:
例如,您已创建属性 ITEM_ID 并将其添加到与变更请求相关的模板。 您将在联接树内的 dbo_VAPP_CHANGE_ATTRIBUTES_PIVOT 表中找到 ITEM_ID 属性。- 使用“添加到集”图标以添加到“集和项”面板中的某一集下。
- 要作为新集移到“集和项”面板下,请使用“添加到所选集”图标
注意:请确认字段 ID 对每个自定义字段均唯一。(可选)启用自定义字段翻译成所需语言:
从“集和项”面板选择自定义属性,然后在“属性”面板中单击“编辑”。
输入“标签键”和“说明键”,然后单击“保存”。
标签键的格式为 数据集_故障单类型_自定义字段_标签
说明键的格式为 数据集_故障单类型_自定义字段_说明
在“编辑域”页面,从“区域设置包”下载所需的区域设置文件。 例如,法语的区域设置文件后缀为 _fr_FR 和巴西都会带有 _pr_BR 后缀。
在编辑器中打开区域设置文件,然后添加属性信息。
例如,对于以标签键为 Ticket_ID 及以说明键为 Ticket_ID_Desc 而添加的故障单 ID,在法语区域设置文件中:
Ticket_ID=Identification de billets
Ticket_ID_Desc=Ticket numéro d'identification保存并退出该文件。
从“编辑域”页面,单击“更改”以更改为相应的区域设置文件。 浏览区域设置文件,然后单击“选择”。 区域设置文件即被自定义属性信息更新。
- 单击“确定”。 此时将打开“编辑域”页面。
单击“提交”。 随即将自定义字段添加到域。 此时,便可使用这些自定义字段来创建特别视图和报告。
如果“高级报告”在更新域后工作异常,请将域还原为最近保存的文件。 有关详细信息,请参阅“还原域文件”。
资产的自定义字段支持
对应每个 OOTB 资产模板,应用程序开放了十个自定义属性(属性 1-属性 10)。 这些自定义属性可以映射到您添加的自定义属性。 例如,将自定义属性名称“工位编号”添加到“硬件资产”模板。 域中硬件资产集的“属性 1”映射到此新添加的属性。 想将属性的标签显示在报告中时,可以更改它们。
备份域文件
将自定义字段添加到域之前,请执行域文件备份。 备份过程包括将安全文件和域设计文件保存到本地计算机。 如果域已损坏,则可使用这些文件将“高级报告”设置还原为最近保存的文件。
请执行以下步骤:
- 登录到 ServiceAide Cloud Service Management,然后依次导航到“报告”、“高级报告”、“操作”、“编辑域”。
- 安全文件:在“编辑域”页面中,找到位于右上角的 custom_cloud_sm_security.xml。 单击“custom_cloud_security.xml”,将其保存到本地计算机中的所选位置。
- 域设计文件:单击“使用域设计器编辑”、“导出设计”,然后将 schema.xml 文件保存到本地计算机中的所选位置。
还原域文件
如果更新域之后,“高级报告”功能未能正常工作,请使用已保存的安全文件和域设计文件来还原功能。 还原操作的对象为最近保存的文件。
请执行以下步骤:
- 导航到“报告”、“服务台”、“高级报告”、“操作”,然后单击“编辑域”。
- 安全文件:
- 在“可选信息”部分中找到 custom_cloud_sm_security.xml。 单击“删除”从应用程序中删除现有的安全文件。
- 单击“可选信息”部分中的“添加安全文件”。 从您保存域文件备份的位置上传安全文件,然后单击“选择”。
安全文件即已还原。
- 域设计文件:
- 选择“域”选项,然后单击“浏览”。
- 从您保存备份的位置上传域设计文件,然后打开一条确认消息。 单击“确定”。
域即已还原。 - 要验证还原,请单击“使用域设计器编辑”,然后单击“检查设计”。
© 2017 ServiceAide 1-650-206-8988 http://www.serviceaide.com info@serviceaide.com