从 Ivanti Neurons 导入数据

可用计划导入的方式从 Ivanti Neurons 导入设备和用户数据。首先在 Ivanti Neurons 中创建新的应用程序注册，并与 Ivanti Neurons 实例建立数据连接，然后使用“数据导入”连接来计划导入。

创建的 Ivanti Neurons 连接器仅适用于数据导入。无法将其用于其他用途，例如 Service Desk 中的查询和实时查找。

配置此导入是一种高级功能，供熟练运用 Postman、JSON 和 OData 等技术来收集所需连接参数的人员使用。如果希望 Ivanti 专业服务帮助您使用此功能，请联系您的供应商。

有关数据连接的详细信息，请参阅数据连接；有关“数据导入”组件的详细信息，请参阅数据导入。

要与 Ivanti Neurons 建立数据连接：

  1. 在 Ivanti Neurons 平台中，创建新的自定义应用程序注册。这可以提供本过程后面所需的访问令牌 URL、客户端 ID 和客户端密码。

    2. 有关创建新自定义应用程序注册的详细信息，请参阅单独的 Ivanti Neurons 帮助。

  2. 启动数据连接组件，然后在数据连接树中选择 Ivanti Neurons 连接器，并在操作列表中点击新连接。
    新连接随即出现。
  3. 为连接键入名称，然后按 Enter 键。
    此名称成为在配置数据导入源时使用的模块的名称。
  4. 在属性网格中，将 URL 设置为 Ivanti Neurons 租户的 URL；例如 https://example.ivanticloud.com/。
  5. 提供程序已设置为 OAuth2，无法更改。指定访问令牌 URL、客户端 ID 和客户端密码。将范围留空。
  6. 点击 测试图标 测试连接。
    如果连接失败，请检查以上详细信息，然后再次测试连接。
  7. 单击 保存图标 保存新连接。

与 Ivanti Neurons 建立连接后，可以创建连接类型，以访问 Ivanti Neurons 中可用的不同类型数据，例如设备或用户。

在导入配置中，需要为即将导入的项目指定唯一标识符。但是，在某些情况下，可能无法找到对要导入的所有项目都唯一的标识符。例如，如果要导入设备，可以将设备名称用作 Windows 设备的唯一标识符，但无法用作 Apple 设备的唯一标识符，此时可能需要使用其他标识符，例如序列号。在这些情况下，需要使用筛选器只选择所需的项目，为不同类型的设备创建不同的数据导入。

无法在 Service Desk 中为 Neurons 数据创建筛选器，但是在创建下述连接类型时，可以在端点 URL 中使用 OData 查询来筛选 Neurons 数据。例如，不用指定类似于 api/discovery/v1/device 的端点 URL，而可以指定 api/discovery/v1/device?$filter=manufacturer eq 'Apple'。

要创建新的连接类型：

  1. 在数据连接树中，点击在前面创建的连接，然后在操作列表中点击新连接类型。
    新连接类型随即出现。
  2. 为连接类型键入名称，然后按 Enter 键。
  3. 在属性网格中，填写以下连接类型属性。
    端点 URL：要连接的端点的路径，例如 api/discovery/v1/device 或 api/discovery/v1/user。如果不想导入所有可用数据，则需要在 URL 中包括 OData 筛选器，因为之后无法在数据导入配置中添加筛选器。
    TPS 类名称：输入对象的名称。
    TPS 类描述：可选。
  4. 点击属性映射旁边的 省略号图标。
    “管理映射”对话框随即出现，可用于在 Ivanti Neurons 中存储要在 Service Desk 连接器的属性中检索的 OData 实体的映射。然后，可以使用“数据导入”组件将这些 OData 实体导入 Service Desk。

    5. 如果要使用 Desktop Manager 访问 Ivanti Neurons 中的设备，请记得为 Neurons ID 属性添加映射，以便识别设备。有关详细信息，请参阅连接到 Ivanti Neurons for Desktop Management。

  5. 点击添加映射。
    “定义映射属性”对话框随即出现。
  6. 使用 Postman 等技术从 Ivanti Neurons 中检索合适的设备或用户记录。
  7. 在“定义映射属性”对话框中输入名称和标题，然后输入可选的描述。
  8. 从 Postman 中复制要与此映射一起导入的实体的名称，然后将其粘贴到映射字段中。
  9. 单击确定。
    映射随即添加到对话框中的列表。如果使用了 / 字符来访问树结构中的实体，/ 将变为 .，显示在响应映射列中。查询映射列包含已发送到端点 URL 的值，而响应映射列包含所需数据的路径。
  10. 如果实体对应于一个系列（例如，用户可能有多个电子邮件地址，需要选择其中一个），请在响应映射列中的 . 分隔符前面的 [方括号] 中输入所需项目的索引。

    11. 索引编号从 0 开始，因此，要访问一系列电子邮件地址中的第一个电子邮件地址，请在响应映射列中输入 Emails[0].Email。

  11. 为需要访问的其他属性重复此操作。
  12. 在“管理映射”对话框中，将包含要用作属性名称的唯一值的属性的是名称？设置为 True，然后点击确定。
    “管理映射”对话框随即关闭。
  13. 在连接类型的属性网格中，设置主键。
  14. 在操作列表中，点击测试映射。
    网格随即出现，显示返回的前 10 条记录的映射结果。

    15. 保存连接类型的更改之后，可以添加新映射和删除映射（“是名称”和“主键”除外），但无法编辑现有映射。

  15. 点击 保存图标 保存更改。

现在已经与 Ivanti Neurons 建立连接，可以用它来创建数据导入。数据导入可将在以上连接器类型映射中定义的数据映射到 Service Desk 对象中的相应属性。

要创建导入配置：
  1. 在数据导入组件的导入映射树中，选择计划导入文件夹。
  2. 在操作列表中，点击新计划导入，指定所需的计划，然后点击 保存图标。
  3. 在导入配置树中选择刚才创建的计划，然后在操作列表中点击新导入映射。
    出现“新建导入映射”窗口。
  4. 在源模块列表中，选择在设置数据连接的名称时创建的模块。
  5. 在源业务对象列表中，选择在设置数据连接类型的名称时创建的对象。
  6. 在目标下选择要将 Neurons 数据导入其中的模块和业务对象。
  7. 将要从其中导入数据的源数据拖动到相应的目标属性上。
  8. 在目标属性列表中，选择要用作键的属性，然后在操作列表中点击设置目标键属性。
    出现“目标键值属性”对话框。
  9. 选择要设为键值属性的属性，然后单击确定。有关“目标属性”的详细信息，请参阅设置目标键值属性。
  10. 根据需要设置日志文件路径，然后点击 保存图标。
    数据导入将按计划运行。