The following macros are not currently supported in the header:
  • style

将自定义字段同步到域

作为服务提供商,有时需要额外的信息来解决特定类型的故障单。 对于此类故障单,您可以根据您的组织的要求配置额外的字段。 此类字段在 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. 要验证还原,请单击“使用域设计器编辑”,然后单击“检查设计”。

© 2017 ServiceAide 1-650-206-8988 http://www.serviceaide.com info@serviceaide.com