Prowatch XPressEntry 同步文档
  1. 宗旨
  2. 设置Prowatch与XPressEntry同步
  3. Prowatch API用户帐户
  4. 设置Prowatch读取器和清除级别
  5. 在XPressEntry中启用数据管理器同步
  6. 初始数据同步和设置XPressEntry数据
  7. 将Prowatch区域设置为XPressEntry区域
  8. 设置XPressEntry手持式阅读器和门
  9. 故障排除

1.宗旨 #

本文档旨在指导系统管理员如何将XPressEntry系统与Honeywell Prowatch系统同步。

先决条件

假设您已将Honeywell Prowatch和XPressEntry安装在网络上可以互相通信的位置（或在同一盒子上）

Prowatch应该获得使用Web API的许可

您应该是Prowatch系统的管理员或超级用户。

2.设置Prowatch与XPressEntry同步 #

API 仅支持 Honeywell Prowatch v4.5 SP2 及更高版本。 我们假设已安装并准备好进行集成。

要集成到其他版本的Prowatch中，请联系Telaeris以确认兼容性。

Prowatch要求您安装其Prowatch API。 请与您的霍尼韦尔代表联系，以获取有关Prowatch API许可和安装的更多信息。

 

API版本5.0支持Prowatch 5.0.0.510。 确保已安装.NET Framework 4.8，然后检查“疑难解答”部分，以确保这些行不在.config文件中。

 

安装Pro-Watch API服务

（此部分是从Pro-Watch_DTU_Service.pdf文件中免费复制的）

1. 创建Pro-Watch API zip文件并将其复制到Pro-Watch安装目录下的文件夹中

2. 如果要从以前的版本升级，请以管理员身份运行Uninstall_PW_DTU_Service.bat文件，以从Windows服务中删除Pro-Watch DTU服务。 删除旧版本。

3. 在Pro-Watch安装目录下的DTU服务目录中，将所有文件解压缩到当前目录。

4. 编辑文件PW-DTU-Service.exe.config并设置端点和绑定部分。 默认情况下，DTU服务使用不具有安全性的HTTP基本绑定。

5. 以管理员身份运行Install_PW_DTU_Service.bat文件。 这将添加一个称为ProWatch DTU服务的Windows服务。

6. 在Windows服务中，右键单击Pro-Watch DTU服务，然后选择“属性”。

7. 选择“登录”选项卡，然后向有权访问Pro-Watch服务器和Pro-Watch数据库的服务中添加用户帐户。

注意：DTU服务帐户必须有权访问SQL Server中的Pro-Watch数据库，必须是Pro-Watch中的有效用户，并且具有对该工作站/服务器的Pro-Watch访问权限。 可以建议将用于Pro-Watch的同一帐户用于Pro-Watch DTU服务。 使用服务帐户时，请运行以下命令来保留URL（在API配置文件中指定）。

示例：Netsh http add urlacl url = http：//计算机名：8734 / pwapi user = DOMAIN帐户名

8. 在Windows服务中，启动Pro-Watch DTU服务。

配置Prowatch API

为了使API同步正常工作，我们需要在Prowatch中设置两个API。

SOAP和SignalR API。

需要在PW-DTU-WinService.exe.config文件中设置以下4个键

请注意，如果将XPressEntry安装在与API不同的计算机上，则需要在这些键中将“ localhost”更改为“您的计算机名称”。

3.Prowatch API用户帐户 #

（此部分也从Pro-Watch_DTU_Service.pdf文件免费复制）

启用Pro-Watch用户

  1. 在Pro-Watch中，选择“数据库配置”
  2. 选择用户或类别
  3. 编辑或创建将连接到Pro-Watch DTU服务的用户。
  4. 选择程序选项卡
  5. 展开数据库配置
  6. 选择“用户定义”
  7. 点击“添加功能”按钮
  8. 添加“启用网络密码”
  9. 保存用户或类记录。 现在，应该为用户启用“ Web密码”。
  10. 输入“ Web密码”并保存用户记录。

用户权限

在Prowatch中，API用户级别需要以下最低权限：

管理->数据传输实用程序->发行事件 仅在我们向Prowatch发送活动时才需要

管理->数据传输实用程序->订阅事件 仅当我们使用SignalR API时才需要

还要确保API用户具有添加了'dtuservice'Prowatch Workstation的路由组。 这是SignalR工作所必需的。

这些是必需的，因为XPressEntry通过API进行了以下调用：

  • 问题读者事件
  • 获取AreaOccupants
  • 获取公司
  • 获取徽章类型
  • 获取区域
  • GetLogDevsByHWClass或GetLogicalDevicesAll
  • 获取清关代码
  • 获取清关代码LD
  • 查询徽章分页
  • GetBadgeBlob或GetBadgePhoto

4.设置Prowatch读取器和清除级别 #

如果要将事件发送到Prowatch，则需要将Channel / Panel / Reader设置为占位符，以从XPressEntry接收事件。

对于每个物理手持设备，我们应该设置两个逻辑设备读取器 Prowatch中的（输入/输出）。

如果我们只是在进行汇总，则每台掌上电脑只需要一个逻辑设备。

你可以这样做：

硬件配置->添加频道

选择PW-5000 / PW6000

给它起一个名字，然后单击“下一步”，“下一步”，然后单击“完成”（这些选项无关紧要，因为我们只是使用此通道和面板作为读取器事件的占位符）。

仅在最初检查“已安装”。 现在选择时区。


接下来，我们将面板添加到Prowatch系统。

在硬件配置下，右键单击面板，然后选择新建->面板

选择站点和频道。

选择PW-5000或PW-6000控制器类型。

点击下一步，为每个手持设备进行入/出操作添加一个PW5000 2R。

然后点击完成。

现在我们需要将逻辑设备读取器添加到面板中。

在硬件配置下，右键单击读取器，然后选择新建->逻辑设备

选择我们刚刚创建的正确面板

将硬件模板设置为DoorTypical ACR（门禁读卡器）或Entry / Exit阅读器门。

然后单击下一步，然后为阅读器选择端口。 如果您正在使用进入/退出阅读器门，这将自动将两个逻辑设备配对为进入/退出。

如果不存在，请返回面板并添加阅读器端口。

然后点击完成

完成后，取消选中“面板”下的“已安装”复选框。

清关代码

如果我们正在执行进入/退出操作，请将读者添加到适当的通关代码中

为此，请转到数据库配置->清除代码。

选择适当的许可以添加读者或添加新的阅读器

请注意，如果我们仅进行汇总，则不需要这样做。

将逻辑设备添加到区域

接下来，您需要确保将当前的Prowatch阅读器和XPressEntry阅读器正确映射到Prowatch中的Areas。

这是通过数据库配置->区域完成的

添加或选择您希望读者进入/离开的区域。 单击左侧的逻辑设备，然后单击中间的阅读器。 然后使用向右箭头移动设备。 单击“输入/输出X”以设置设备是否将用户输入/输出

5.在XPressEntry中启用数据管理器同步 #

接下来将设置XPressEntry以同步来自Prowatch的数据。 全部在XPressEntry服务器应用程序中的“工具”->“设置”->“数据管理器”下进行管理

在顶部，检查“启用数据管理器”，然后将“类型”设置为Prowatch DTU

确定要与Prowatch一起使用的Data Manager功能

  1. 发送活动
  2. 接受活动
  3. 占用
  4. 包括数据管理器的特定功能

以下是这些选项的作用：

将数据管理器活动拉入XPressEntry：

启用S​​ignalR后，这会将Prowatch中的事件作为徽章活动添加到XPressEntry中。

将XPressEntry活动推送到Data Manager：

这将使用上面的频道/面板/阅读器将活动发送到Prowatch。

拉数据管理器的占用率

这将使Prowatch中的Area Occupants与XPressEntry同步。

通过软件事件查看表

这将启用SignalR事件片段

默认角色

从Prowatch同步用户时分配给徽章（用户）的默认角色。

没有同步同步

用于确保在任何给定时间仅运行一个同步（完整，部分，占用，活动）。 该集成不是必需的。

活动同步现在

运行活动同步过程。 对于Prowatch，这将占用空间并将活动立即发送到数据管理器。 这不是必需的，但已在Prowatch Data Manager的早期版本中使用。

立即占用同步

将区域居民从Prowatch同步到XPressEntry。 集合需要。

建议将其设置为每5分钟一次。 如果任何一项服务在相当长的一段时间内处于脱机状态，这将“弥补”错过的任何活动。

立即部分同步

这将同步所有非用户数据。 这包括面板/阅读器/证书/公司等。

立即完全同步

这将运行部分同步并同步用户数据

Prowatch特定数据管理器选项

接下来，您应该点击右上角的大“ Setup Data Manager”按钮。

这将带您进入Prowatch特定数据管理器选项。

需要以下内容：

服务器IP（和端口，如果您更改了它），用户名和密码

如果您正在进行召集或占用跟踪，请选中“将Prowatch区域/ LogDevs用作占用门”。

如果您不执行进入/退出操作，请选中“无组数据”复选框。

如果要使用SignalR，请设置事件用户（可能与API用户相同）和事件工作站（这是Prowatch中XPressEntry服务的工作站）。

您可以将Prowatch徽章中的字段映射到XPressEntry用户，左侧的“源/目标”列（不要忘记点击绿色的加号按钮）

您可以在右下角选择我们实际上要跟踪占用的Prowatch Areas。 请注意，只有在完成部分同步后，这些内容才会填充。 实际上，这意味着您需要进入这里，设置所有内容，然后出去并按Partial Sync Now，然后回到这里以设置占用区域。

其余选项是不言自明的，但如有疑问，可以将所有选项保留为空白/未选中。

“测试连接”将告诉您是否已连接API（但未连接SignalR）

完成后单击确定，然后在“数据管理器”页面上按“保存”。

如果SignalR工作正常，您应该看到类似以下内容：

详细信息：StartWatchingTables时ProwatchDataManager中没有错误

INFO：SignalR事件订阅已开始

6.初始数据同步和设置XPressEntry数据 #

建议先运行部分同步，以使所有读取器/间隙/区域同步并进行设置。

在XPressEntry中设置该数据之后，请运行“完全同步”。

7.将Prowatch区域设置为XPressEntry区域 #

在执行此操作之前，请确保已完成与Prowatch系统的部分同步

Prowatch区域将映射到XPressEntry Zones表。

对于要跟踪占用率的每个区域，您都需要执行以下操作。

  1. 确保未选中“区域在外部”和“区域是集合点”
  2. 确保选中“区域是危险区域”

对于集合点，它们应该相反。

解决占用问题

如果没有在XPressEntry的“区域”中显示人员，则需要检查一些事情。

  1. 检查您在Prowatch中使用的频道是否已添加到用户的“路由组”中
  2. 确保已将逻辑设备分配给Prowatch中的区域
  3. 在XPressEntry中，确保如上所述设置和选择区域。 如果选中所有3个复选框，则该区域将不会跟踪占用情况！
  4. 确保选中“拉动数据管理器占用”和“通过软件事件监视表”的数据管理器选项。
  5. 确保XPressEntry中的门设置正确。 （尤其是如果您未选中“ Prowatch数据管理器设置”表单中的“将Prowatch区域/ LogDevs用作占用门”）。

8.设置XPressEntry手持式阅读器和门 #

在执行此操作之前，请确保已完成与Prowatch系统的部分同步

门

门是从Prowatch中的逻辑设备和区域直接映射的。 仅当将设备分配到Prowatch中的区域时，才会自动创建这些文件。 否则，您可以创建本地门并自行映射。

如果我们正确地完成了所有操作，则这里无需做太多事情。 只需确认我们拥有的门可以将人员正确地移入/移出区域即可。

读取这些内容的方式是：开始区域是您在手持设备上进行Entry扫描的来源，而结束区域是您在Entry扫描中前往的位置。 对于出口扫描，这些相反。

外部进入/退出阅读器字段应与我们在Prowatch中设置的逻辑设备匹配

读者

读取器直接从Prowatch中的逻辑设备映射。

如果设备的时区和服务器的时区不同，则需要进行一些其他设置。

首先，在工具->设置->常规->添加/编辑显示中启用“显示阅读器时区”选项

然后，在不同时区的每个设备的“添加/编辑信息”->“读取器”->“手持设备”部分下设置读取器时区。

最后，如果您正在使用召集设备，并且希望将召集活动发送到Prowatch，请为每个手持设备设置“外部召集器读取器”选项。

此时，您应该能够继续使用标准的XPressEntry Reader Profile选项来设置设备。

9.故障排除 #

如果您看到以下错误：

---Exception Message--------------------------
System.ServiceModel.FaultException`1[System.ServiceModel.ExceptionDetail]
The type initializer for 'HoneywellAccess.ProWatch.PWLogger.Log' threw an exception.
---Exception Stack Trace----------------------

服务器堆栈跟踪：
在System.ServiceModel.Channels.ServiceChannel.ThrowIfFaultUnderstood（消息回复，MessageFault错误，字符串操作，MessageVersion版本，FaultConverter faultConverter）
在System.ServiceModel.Channels.ServiceChannel.HandleReply（ProxyOperationRuntime操作，ProxyRpc＆rpc）
在System.ServiceModel.Channels.ServiceChannel.Call处（字符串操作，布尔单向，ProxyOperationRuntime操作，Object [] ins，Object [] outs，TimeSpan超时）
在System.ServiceModel.Channels.ServiceChannelProxy.InvokeService（IMethodCallMessage methodCall，ProxyOperationRuntime操作）
在System.ServiceModel.Channels.ServiceChannelProxy.Invoke（IMessage消息）

您需要去编辑PW-DTU-WinService.exe文件，并注释掉以下两行：

<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" />

并通过删除它们或将其用XML注释部分包围起来：

<!--<add name="Rolling Flat File Trace Listener" />
<add name="Event Log Trace Listener" /> -->

建议编辑
返回所有文档