将自定义字段同步到域

作为服务提供商，有时需要额外的信息来解决特定类型的故障单。 对于此类故障单，您可以根据您的组织的要求配置额外的字段。 此类字段在 ServiceAide Cloud Service Management 中称为自定义字段。

可以将自定义字段添加到应用程序中的数据集域。 随后，便可在创建特别视图和报告时使用此类字段。 要将自定义字段添加到域，将与自定义字段数据同步域。

与“已共享”域同步自定义字段的过程不同于针对“Cloud SM”域的过程。

前提条件

• 确认已创建自定义字段。 有关详细信息，请参阅“创建和管理自定义字段模板”。
• 确认您拥有域设计器权限。

请执行以下步骤：

1. 登录到 ServiceAide Cloud Service Management，然后依次导航到“报告”、“服务台”、“高级报告”。

   添加自定义字段时，域可能会损坏。 因此，在执行新变更前请务必备份现有域。 备份域文件以便在这些文件损坏时回滚到现有设置。 有关详细信息，请参阅“备份域文件”和“还原域文件”。

   如果尚未保存域文件，还原时则会设为默认域。 创建的报告、特别视图和显示板将丢失。

   验证自定义字段名称不包含重音字符。 例如，situação_id162 是包含重音字符的自定义字段。

2. 要在高级报告中使用自定义字段，请依次单击“操作”、“同步自定义字段”。
   可用自定义字段的列表随即显示于新选项卡中。 如果已将自定义字段添加到域中，该列表则会将相关字段显示为已选中。

   注意：为提高性能，请同步报告中所需的自定义字段。 同步可配置自定义字段的最大限制为 50。
   “高级报告”中不支持名为“Join”的自定义属性。 但是，如果名称“Join”有前缀或后缀，则会受到支持。 例如，支持自定义属性名称 attributJoin 或 joinAttribute。

3. 选择要添加的自定义字段，然后清除要删除的字段。 单击“同步”。
   此时将显示一则确认消息，并从域中添加或删除自定义字段。

4. 如果您正在使用 Cloud SM 域，则请执行步骤 5。 如果您正在使用 Shared 域，请执行步骤 6 – 12。

5. 确认自定义字段已添加到域中：

   1. 单击“主页”选项卡，然后依次单击“操作”、“创建特别视图”。

   2. 选择“Cloud SM”域，然后单击“选择数据”。

   3. 在“源”面板中，转到“故障单”或“配置项”等数据集。 确认自定义字段已添加到其各自数据集下的“自定义属性”文件夹。

6. 如果您正在使用 Shared 域，则请单击“主页”选项卡，然后依次单击“操作”、“编辑域”。 “编辑域”页面在新窗口中打开。
7. 从“域设计”，单击“使用域设计器编辑”。 “域设计器”窗口打开。

8. 在“计算字段”选项卡中，将非字符串数据类型的自定义字段转换为其相应的数据类型。

   数据类型为整型、双精度型和布尔型的自定义字段将作为字符串数据类型进行存储。 将数据类型转换为原始数据类型，以便在报告中正确显示。

   1. 已创建的自定义字段可在相应类型的 _PIVOT 表中进行使用。 例如，如果您创建类型为“服务请求”的自定义字段，则会在以下表中提供该字段：
      dbo_VAPP_SERVICE_REQUEST_ATTRIBUTES_PIVOT 表。
      

   2. 双击要更改其数据类型的自定义字段。

   3. 输入字段名称、数据类型和表达式以便进行转换。 用于转换数据类型的表达式的列表如下：

      数据类型	表达式	说明
      整数	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)

9. 在“显示”选项卡中，将自定义字段从“资源”面板添加到“集和项”面板，然后单击“确定”。 

   选择所需的自定义字段和构建或筛选报告时有用的属性。 可以修改显示属性，如标签、表的说明以及每个选定字段的集和项。 在“显示”选项卡中执行以下任务：
   

   在“资源”面板中，找到自定义字段和要从联接树添加的属性。 所有自定义字段和属性均可在数据透视表中进行使用。 根据要添加属性的模板的“已关联表单”字段来列出这些属性。
   例如，您已创建属性 ITEM_ID 并将其添加到与变更请求相关的模板。 您将在联接树内的 dbo_VAPP_CHANGE_ATTRIBUTES_PIVOT 表中找到 ITEM_ID 属性。

   要从“资源”面板中移动自定义属性：
   
   • 使用“添加到集”图标以添加到“集和项”面板中的某一集下。
   • 要作为新集移到“集和项”面板下，请使用“添加到所选集”图标
   要删除集中的某一属性，从“集和项”选择属性，然后单击“删除项”。
   注意：请确认字段 ID 对每个自定义字段均唯一。
   

10. （可选）启用自定义字段翻译成所需语言：

    1. 从“集和项”面板选择自定义属性，然后在“属性”面板中单击“编辑”。

    2. 输入“标签键”和“说明键”，然后单击“保存”。

       • 标签键的格式为 数据集_故障单类型_自定义字段_标签

       • 说明键的格式为 数据集_故障单类型_自定义字段_说明 
         

    3. 在“编辑域”页面，从“区域设置包”下载所需的区域设置文件。 例如，法语的区域设置文件后缀为 _fr_FR 和巴西都会带有 _pr_BR 后缀。

    4. 在编辑器中打开区域设置文件，然后添加属性信息。
       例如，对于以标签键为 Ticket_ID 及以说明键为 Ticket_ID_Desc 而添加的故障单 ID，在法语区域设置文件中：
       Ticket_ID=Identification de billets 
       Ticket_ID_Desc=Ticket numéro d'identification

    5. 保存并退出该文件。

    6. 从“编辑域”页面，单击“更改”以更改为相应的区域设置文件。 浏览区域设置文件，然后单击“选择”。 区域设置文件即被自定义属性信息更新。

11. 单击“确定”。 此时将打开“编辑域”页面。

12. 单击“提交”。 随即将自定义字段添加到域。 此时，便可使用这些自定义字段来创建特别视图和报告。

    如果“高级报告”在更新域后工作异常，请将域还原为最近保存的文件。 有关详细信息，请参阅“还原域文件”。

资产的自定义字段支持

对应每个 OOTB 资产模板，应用程序开放了十个自定义属性（属性 1-属性 10）。 这些自定义属性可以映射到您添加的自定义属性。 例如，将自定义属性名称“工位编号”添加到“硬件资产”模板。 域中硬件资产集的“属性 1”映射到此新添加的属性。 想将属性的标签显示在报告中时，可以更改它们。

备份域文件

将自定义字段添加到域之前，请执行域文件备份。 备份过程包括将安全文件和域设计文件保存到本地计算机。 如果域已损坏，则可使用这些文件将“高级报告”设置还原为最近保存的文件。

请执行以下步骤：

1. 登录到 ServiceAide Cloud Service Management，然后依次导航到“报告”、“高级报告”、“操作”、“编辑域”。
2. 安全文件：在“编辑域”页面中，找到位于右上角的 custom_cloud_sm_security.xml。 单击“custom_cloud_security.xml”，将其保存到本地计算机中的所选位置。
3. 域设计文件：单击“使用域设计器编辑”、“导出设计”，然后将 schema.xml 文件保存到本地计算机中的所选位置。

还原域文件

如果更新域之后，“高级报告”功能未能正常工作，请使用已保存的安全文件和域设计文件来还原功能。 还原操作的对象为最近保存的文件。  

请执行以下步骤：

1. 导航到“报告”、“服务台”、“高级报告”、“操作”，然后单击“编辑域”。
2. 安全文件：
   1. 在“可选信息”部分中找到 custom_cloud_sm_security.xml。 单击“删除”从应用程序中删除现有的安全文件。
   2. 单击“可选信息”部分中的“添加安全文件”。 从您保存域文件备份的位置上传安全文件，然后单击“选择”。
      安全文件即已还原。
3. 域设计文件：
   1. 选择“域”选项，然后单击“浏览”。
   2. 从您保存备份的位置上传域设计文件，然后打开一条确认消息。 单击“确定”。
      域即已还原。 
   3. 要验证还原，请单击“使用域设计器编辑”，然后单击“检查设计”。