4.10 告知AdminP 命令

在驱动程序向 Domino AdminP 进程发出请求后,这些请求将被延迟,直到 AdminP 进程处理完它们。 (有关管理处理间隔的信息,请参考 Notes 文档)。

如果需要,可将 <tell-adminp-process> 特性附加到事件中。 如果事件包含需要执行的 AdminP 任务,则会将指定的命令发送到 Domino 服务器控制台。 Section 4.5, Custom Driver ParametersDomino Console Command 中介绍了此特性。

例如,在发送移动用户事件时,可以在该移动事件中包含下面的特性:

tell-adminp-process="tell adminp process new"

使用此示例命令将导致驱动程序请求 AdminP 进程以处理所有新任务,其中包括该事件中请求的移动任务。

使用 tell-adminp-process 命令:

  1. 确保使用的是 Notes 6.0.3 或更高版本。

  2. 向驱动程序参数的订购者选项中添加下面的参数,以确保打开对 AdminP 进程的支持:

    <allow-adminp-support display-name=“Allow Domino AdminP Support”>True</allow-adminp-support>
    

    请参见Section 4.4.2, 订购者选项中的 Allow Domino AdminP Support

  3. 确保使用该驱动程序的 Notes 用户具有向 Domino 服务器控制台发送命令的权限。

  4. 确保事件包含 AdminP 任务。

    仅在需要将 AdminP 任务作为事件的一部分执行时,才发送 tell-adminp-process 命令。

  5. 使用正确的语法。

    Section B.0, 新功能样本中包含使用 tell-adminp-process 命令的样本。

  6. 要确定是否成功完成了 AdminP 请求,请使用 Lotus Notes 工具(如 Domino Administrator)。

    Notes 驱动程序 Shim 完成的有关 AdminP 请求的命令并不意味着已成功完成该命令, 它只意味着 AdminP 已接收请求。

    例如,驱动程序可能向 AdminP 成功发送了一个移动用户的请求。 但是,如果事件中指定的证明者不正确,则在 AdminP 进程尝试处理该请求时,移动会失败。