做Notes邮件支持这几年我遇到最高频的问题不是服务器宕机而是用户跑过来说“我明明记得那个人的邮箱怎么在收件人框里打了半天字联想列表就是不出来” 这个“联想”功能在Notes里叫TypeAhead中文界面常译作“提前键入”它的逻辑很简单你输入收件人前几个字符Notes在本地通讯录和服务器目录里帮你匹配出完整的地址。功能本身不复杂但很多人被它折磨根子往往只有一个——Notes根本没有“预先输入所有用户地址”也就是说客户端本地通讯录里没有覆盖全员的地址数据每次按键都得临时跑到服务器目录里去现查一旦查询范围配置不对、目录没启用、或者网络有一点抖动联想列表就罢工。这篇文章就从TypeAhead的查询机制开始把个人用户“预填地址”和管理员“批量下发地址池”两条路线都走一遍最后再聊聊我踩过的坑。普通用户和管理员都可以照单抓药。1. 谁在为TypeAhead“供数”先搞清楚查询机制1.1 每敲一个字符Notes到底在做什么很多人以为TypeAhead是“输入法”一样的东西打多了就自动记住。这其实是个误区。Notes的TypeAhead本质上是一个即时索引查询每当你往收件人字段里敲下一个字符Notes就会去本地names.nsf个人通讯录的Contacts视图里拿已经输入的前缀去做一次匹配然后把结果以下拉列表的形式弹出来。这个匹配是按前缀进行的不是模糊包含所以输入“zhang”能匹配“Zhang San”但输入“zhangsan”反而匹配不到“Zhang”。如果本地通讯录里没有命中Notes是否继续往服务器上查取决于邮件偏好里的TypeAhead范围设置。默认情况下很多客户端只查本地通讯录这就导致了一个非常常见的结果你联系人列表里没存过这个人TypeAhead永远不会有反应只有点右边的“地址选择器”进入完整搜索才能找到人。换句话说TypeAhead的“弹药库”有多大完全看你给了它多少地址数据。这也是“预先输入所有用户地址”这句话的真正意义——让TypeAhead在按下第一个字符时就能命中最可能的目标而不是每次现查。提示TypeAhead目前做的是“前缀匹配”不是“全文模糊搜索”。所以想让联想命中率高录入联系人时姓名的拼写、顺序必须和实际一致。1.2 三种查找模式决定了预填工作的重点在Notes客户端的“文件 首选项 邮件”里有一组和TypeAhead直接相关的选项不同版本界面文字略有差异但逻辑上就三档模式查询范围特点适合场景仅本地通讯录只查本地names.nsf最快纯离线可用不覆盖未录入的人个人PC联系人少本地主通讯录本地先查再查服务器主目录命中率高一点但每次都要网络往返小型团队单台Domino本地所有目录本地DA配置的全部目录命中率最高但最慢容易超时大型企业多域/多目录这里值得展开的是第二档和第三档里“主通讯录”和“所有目录”到底指什么。主通讯录就是你在Notes客户端里通过“位置文档”指定的那个服务器目录通常是Domino目录names.nsf。所有目录则指的是服务器端通过目录协助Directory Assistance配置进来的全部数据源包括多本Domino目录、从LDAP目录同步过来的账户、甚至第三方外部目录。把这三档列在一起你就明白了如果公司里用户有两千人而你只选了“仅本地通讯录”那TypeAhead永远只能命中你手动存过的那几十个联系人联想不出来是正常的不是Notes坏了。反过来如果你选了“本地所有目录”但服务器上根本没配置任何目录协助那第二段查找依然会扑空。也就是说TypeAhead的效果是“客户端设置”和“服务端目录基建”共同决定的两者必须同时到位。1.3 为什么“预先输入所有用户地址”能治本把全公司用户地址都“预输入”到每位客户端的可达范围内本质上是解决三个问题。第一是速度本地通讯录命中是毫秒级网络查目录即使再快也有一个RTT的延迟而且目录数据量大时服务端还要做一次索引查询。第二是稳定性本地命中不依赖网络服务器临时维护、网络断联都不会影响你把邮件写给最常用的同事。第三是使用体验TypeAhead的价值在于“输入前几个字符就能选人”如果列表每次都只有零星几个熟人用户很快就会放弃这个功能转而去手动复制邮箱地址效率大幅下降。所以这篇文章后两章一条路线是给个人用户如何在本地通讯录里把地址提前收集、导入、沉淀成一份自己的联系人池另一条路线是给管理员如何通过目录编目、目录协助和策略让全公司每一台Notes客户端默认就拥有完整的地址数据源。两条路线不冲突甚至可以叠加使用。2. 个人用户怎么把地址“提前装进”本地通讯录2.1 自动沉淀让Notes替你保存联系人先推荐最简单、最省力的做法让Notes在收发邮件时自动把收件人写进个人通讯录。在“文件 首选项 邮件”里勾选类似“自动将收件人添加到个人通讯录”的选项之后每次你成功发送邮件给某人Notes就会把对方的名字和邮件地址自动保存为一条联系人记录。这个功能对日常维护本地联系人池非常有效你不需要手动录入只要保持正常的收发件习惯几周后本地通讯录自然就会沉淀出你真正高频联系的一批人而这些人在TypeAhead里的命中率几乎100%。不过这个自动沉淀方案有两个限制。第一它只会记录“成功发送的收件人”和部分回复对象不会把公司所有同事都塞进来毕竟你不可能给全公司每个人都发过邮件。第二有些版本默认不开启这个选项需要手动去偏好设置里打开。如果你发现TypeAhead里老是只有收件箱里的人而没有新同事先看看这个开关是不是开了。2.2 CSV批量导入适合一次性把通讯录灌进去如果你手里有现成的通讯录文件——比如HR给的全员名单CSV、或者从旧系统导出的联系人表——那最快的方式就是一次性批量导入本地names.nsf。具体操作是在Notes客户端里打开个人通讯录数据库本地names.nsf选择“文件 导入”文件类型选CSV然后按照向导把CSV里的字段一一映射到联系人字段上。常用的映射关系是FirstName名、LastName姓、FullName全名、EmailAddress电子邮件、CompanyName公司以及电话号码等最终存储为联系人文档。这里提醒几个实际导入时容易踩的细节。一是中文姓名很多HR表格里“姓名”是一个整字段导入前最好拆成姓和名两个字段或者至少映射到FullName一个字段里否则Notes的排序和前缀匹配会不准确。二是重复联系人批量导入最容易引入重复导入完成后可以到“通讯录 联系人”视图下按“全名”排序肉眼扫一遍重复项再用工具清理。三是Internet地址格式Notes联系人文档里的“电子邮件”字段填的必须是标准SMTP地址不要带Notes的格式否则TypeAhead匹配出的地址发不出去。CSV导入确实是一次性把“所有用户地址都预输入到本地”的最直接做法。但我不建议在几十人以上的团队里长期靠这个办法维护因为人员入职离职很快导入的地址会过期。它更适合作为“开局一把梭”的初始化手段之后靠自动沉淀和定期更新来维持。2.3 从企业目录“另存为”常用联系人第三种个人做法更精准在写邮件时点开收件人右边的地址选择器从企业目录里搜到目标用户然后把这条目录记录“另存为”到个人通讯录。在搜索结果里选中一个人右键菜单里通常有“添加到个人通讯录”或“复制到联系人”之类的选项选中后会弹出一个联系人编辑界面直接保存即可。你可以多选几个常用同事一次性操作这样TypeAhead立刻覆盖到他们。这个做法的好处是地址绝对准确因为数据直接来自Domino目录不需要你手工拼写。我的习惯是按项目团队批量保存每个项目开工前我把团队成员从公司目录里搜出来一次加入个人通讯录这个项目的邮件往来阶段TypeAhead就特别顺手。缺点是它本质还是手动操作没办法覆盖全公司。所以它更适合作为补充而不是主方案。3. 管理员视角让全员默认拥有完整地址池如果说普通用户只能靠“自扫门前雪”的方式攒本地联系人那么作为Domino管理员你完全可以做到让每一台Notes客户端从第一天起就有全公司的地址数据可供TypeAhead查询。这一章就是管理员的重点。3.1 目录编目Directory Catalog把整个公司地址压缩给客户端大型企业最推荐的做法是部署“目录编目”Directory Catalog。它的原理其实很好理解把服务器端的一本或多本Domino目录names.nsf压缩成一本精简的、只读的目录编目数据库一般叫dircat.nsf里面只保留身份识别和地址信息相关的核心字段——全名、姓、名、邮件地址、组织信息等把所有ACL、授权设置、策略文档等不相关的数据全部丢弃。压缩之后的dircat.nsf体积通常只有原目录的几分之一甚至更低非常适合分发到客户端或作为TypeAhead的查询源。创建目录编目并不复杂。在Domino服务器控制台上运行load dircat任务首次运行时它会根据配置创建dircat.nsf并开始构建编目数据之后该任务会定期运行以更新地址变更。如果你有多个目录需要合并编目还可以在dircat配置里指定目录范围让编目任务把多本names.nsf统一编成一本。构建完成后把dircat.nsf加入客户端可访问的范围或者让它作为目录协助里的一个查询源TypeAhead就能拿到全公司地址了。这里要强调一个常见误区目录编目不是实时查询它是一个按周期重建的静态数据快照。所以采用dircat方案时一定要配套一个合理的重建周期——比如每天凌晨业务低峰期跑一次dircat任务——保证第二天用户在公司里找到新入职同事的地址。如果dircat半年不更新那TypeAhead能查到的永远是半年前的通讯录。3.2 目录协助DA控制客户端到底查哪些目录有了dircat.nsf之后还需要告诉Notes客户端“你应该去哪些地方查地址”这一步靠的是目录协助Directory Assistance简称DA。DA是Domino服务器上一个独立的配置数据库da.nsf里面定义了服务器进行目录查找时按照什么顺序查询哪些目录数据库。本质上它就是一个“地址查找路由表”。作为管理员你需要做的是在命名服务里创建一个DA数据库或使用已有的da.nsf在其中添加规则让系统把dircat.nsf和主names.nsf按顺序排列。通常的顺序是先查dircat.nsf体积小、查得快→ 再查主names.nsf数据全→ 如果还配置了LDAP外部目录可以把LDAP放在最后。客户端TypeAhead在“本地所有目录”模式下会遵循服务器端DA配置的顺序执行查找。这里有一个我从实际维护里学到的优化点把dircat.nsf放在DA列表的最前面明显能降低TypeAhead在网络查询上的等待时间。因为dircat体积小索引命中快服务器处理开销低而完整names.nsf动辄几百MB每次TypeAhead查询都要全库扫索引人多时CPU会飙升。此外DA里还可以按组织级别设置规则比如“只允许某OU的用户查询某本目录”在多部门隔离的部署里很有用但也别设得太死否则普通员工TypeAhead又查不到全公司地址了。3.3 桌面策略统一下发TypeAhead设置最后一步是让所有客户端都使用正确的TypeAhead范围统一进入“本地所有目录”模式。手动让用户去改首选项是不现实的——且不说用户不懂就算懂也可能改错。正确的做法是通过Domino的桌面策略Desktop Settings统一下发。在Domino Administrator里找到“策略”相关的配置选择“桌面设置”在“邮件”选项卡里可以找到TypeAhead相关的选项。策略创建后把它关联到组织、组织单元或特定用户组。下发后客户端的TypeAhead行为会被自动设置为指定模式而且你还可以选择“锁定”策略防止用户在客户端本地自行更改。这样无论新电脑还是老电脑只要用户登录域策略一刷新TypeAhead就统一进入正确的查询模式。这里我建议策略配置时直接选择“本地通讯录所有通讯录”这一档同时把服务器端DA配好。这样无论是本地预存联系人、还是从dircat查询TypeAhead都能自动把最新地址呈现在用户面前理论上就是标题里所期望的“预先输入所有用户地址”的最佳实践落地。当然多目录查询的代价是每次按键的额外RTT所以在内网延迟正常低于50ms的情况下完全可接受。3.4 顺便说个不建议的方案别把完整names.nsf复制到客户端有些管理员为了方便会把服务器上的names.nsf直接复制到用户本地当成一个额外的个人通讯录让TypeAhead去查这个副本。我不建议这么做原因有三第一完整names.nsf体积太大一个上万人的公司目录动辄几百MB放到每个客户端既占磁盘又拖慢查询第二names.nsf里面包含了ACL、服务器配置、策略文档等管理性数据分发给普通用户存在信息安全风险第三完整的本地复本需要维护复本关系一旦复制冲突或不同步用户查到的地址可能比dircat的定期快照还旧。所以更稳妥的做法就是上一节说的dircatDA方案把静态快照在服务器端统一生成按周期更新比让每个客户端自己同步可靠得多。4. TypeAhead常见故障与优化实录4.1 联想列表完全不出现这是最常见的求助。首先确认偏好设置里的TypeAhead选项没有关掉或只选了“仅本地通讯录”而你要找的人恰好不在本地联系人里——这种情况不是故障是配置必然结果。排除配置后再看本地names.nsf是否健康有时候names.nsf因为异常断电或磁盘问题损坏第一步就去查本地目录本地目录一坏TypeAhead就直接哑火。可以尝试在Notes客户端里打开names.nsf查看是否能正常展开“联系人”视图如果视图打开报错说明数据库确实有问题可以用“文件 应用程序 压缩”来做一次压缩修复严重时需要从备份恢复或新建一个names.nsf重新关联。如果本地目录正常但选择了“本地所有目录”依然没有任何联想结果就要检查服务器端了。在服务器控制台用show tasks看看目录服务相关任务是否在运行再检查da.nsf里的规则状态确认客户端请求的目录是否在DA列表中且被启用了“给客户端使用”的权限。这里最讨厌的是DA配置不报错但顺序错误导致查询超时现象就是TypeAhead等半天不弹出结果。遇到这种情况把dircat.nsf放到最前面再测试一次。4.2 输入时卡顿、查询特别慢TypeAhead慢九成是查询范围过宽或者目录索引不给力。第一种情况是本地通讯录塞了太多数据且没有合理整理比如有人把几万条历史联系人都灌进去了每次前缀匹配要扫的文档太多自然会卡。本地通讯录不是数据库仓库保持几千条以内的常用联系人才是健康状态。第二种情况是选择了“本地所有目录”但服务器端DA列表里的目录又多又大还排了多个LDAP源TypeAhead的每一次按键都会同步等待整个查找链跑完不快就有鬼了。第三种情况是dircat.nsf没有压缩过长期积累后索引膨胀查询性能直线下降此时在服务器端跑一次load compact dircat.nsf或者按第3.1节规划定期重建dircat能显著改善。另外如果你的网络是跨地域访问Domino比如总部在上海、海外员工查华盛顿服务器这个RTT本身就很难压缩更应该在本地联系人池做文章让海外用户把高频联系人预先存本地同时为海外站点单独部署dircat或目录服务别让所有TypeAhead查询都走长链路。4.3 联想结果缺失或地址过期类型提示有结果但结果里没有新入职的同事或者显示的是离职员工的旧地址。这种情况通常是dircat或主目录的数据没有及时更新。先看dircat任务最后一次构建时间如果是很久以前就在服务器上重新触发一次构建任务让新地址进快照。再看联系人文档的Internet地址字段是否正确很多人从老系统导入的数据邮件地址字段是空的或是一个旧邮箱TypeAhead匹配到这个人也发不出去所以在导入或同步时必须确认InternetAddress和MailFile等信息正确。还有一个小细节Notes的TypeAhead对“全名”字段的依赖性很强。如果联系人文档里只有姓和名没有拼合好的FullName字段前缀匹配可能失败。批量导入后建议检查一下联系人视图的分组情况凡是“未分类”的联系人多半是全名格式不对。4.4 故障速查与优化建议表症状可能原因处理建议TypeAhead完全不弹出TypeAhead被关闭/只查本地但本地无数据检查首选项开启“本地所有目录”只弹本地熟人公司同事查不到未开启服务器目录查询改为“本地所有目录”检查DA输入很卡本地联系人过多/DA目录过大/跨地域精简本地联系人dircat前置优化目录索引新同事查不到dircat快照过期重建dircat调整策略关联查得到但发送失败Internet地址缺失或错误检查联系人文档InternetAddress字段names.nsf报错本地数据库损坏压缩修复names.nsf或重建这张表基本覆盖了我在群里被问到过的绝大多数问题。TypeAhead这东西配置对了是顺滑到让你忘记它的存在配置错了天天有人在后头追着你问“怎么搜不到人”。最后再说点我的个人体会。做Notes运维这么多年我越来越觉得“预先输入所有用户地址”这件事本质上不是一项一次性操作而是一套持续运行的机制客户端靠自动沉淀和导入积累本地联系人服务器端靠dircat和DA提供全量地址策略负责把正确的设置推给所有人三者缺一不可。如果你只是个小团队让成员互发几封邮件把联系人自动沉淀起来就够了如果你们是几千人的企业那dircatDA策略这条路一次走通以后TypeAhead基本不用人操心。别把这项工作当成绝活它其实是每个Notes管理员都该铺好的“水电煤”。 
长河君 · 2026/9/7 21:19:50 · 阅读 1.2k Notes邮件联想失效怎么办？从TypeAhead到全员地址池的优化指南
做Notes邮件支持这几年我遇到最高频的问题不是服务器宕机而是用户跑过来说“我明明记得那个人的邮箱怎么在收件人框里打了半天字联想列表就是不出来” 这个“联想”功能在Notes里叫TypeAhead中文界面常译作“提前键入”它的逻辑很简单你输入收件人前几个字符Notes在本地通讯录和服务器目录里帮你匹配出完整的地址。功能本身不复杂但很多人被它折磨根子往往只有一个——Notes根本没有“预先输入所有用户地址”也就是说客户端本地通讯录里没有覆盖全员的地址数据每次按键都得临时跑到服务器目录里去现查一旦查询范围配置不对、目录没启用、或者网络有一点抖动联想列表就罢工。这篇文章就从TypeAhead的查询机制开始把个人用户“预填地址”和管理员“批量下发地址池”两条路线都走一遍最后再聊聊我踩过的坑。普通用户和管理员都可以照单抓药。1. 谁在为TypeAhead“供数”先搞清楚查询机制1.1 每敲一个字符Notes到底在做什么很多人以为TypeAhead是“输入法”一样的东西打多了就自动记住。这其实是个误区。Notes的TypeAhead本质上是一个即时索引查询每当你往收件人字段里敲下一个字符Notes就会去本地names.nsf个人通讯录的Contacts视图里拿已经输入的前缀去做一次匹配然后把结果以下拉列表的形式弹出来。这个匹配是按前缀进行的不是模糊包含所以输入“zhang”能匹配“Zhang San”但输入“zhangsan”反而匹配不到“Zhang”。如果本地通讯录里没有命中Notes是否继续往服务器上查取决于邮件偏好里的TypeAhead范围设置。默认情况下很多客户端只查本地通讯录这就导致了一个非常常见的结果你联系人列表里没存过这个人TypeAhead永远不会有反应只有点右边的“地址选择器”进入完整搜索才能找到人。换句话说TypeAhead的“弹药库”有多大完全看你给了它多少地址数据。这也是“预先输入所有用户地址”这句话的真正意义——让TypeAhead在按下第一个字符时就能命中最可能的目标而不是每次现查。提示TypeAhead目前做的是“前缀匹配”不是“全文模糊搜索”。所以想让联想命中率高录入联系人时姓名的拼写、顺序必须和实际一致。1.2 三种查找模式决定了预填工作的重点在Notes客户端的“文件 首选项 邮件”里有一组和TypeAhead直接相关的选项不同版本界面文字略有差异但逻辑上就三档模式查询范围特点适合场景仅本地通讯录只查本地names.nsf最快纯离线可用不覆盖未录入的人个人PC联系人少本地主通讯录本地先查再查服务器主目录命中率高一点但每次都要网络往返小型团队单台Domino本地所有目录本地DA配置的全部目录命中率最高但最慢容易超时大型企业多域/多目录这里值得展开的是第二档和第三档里“主通讯录”和“所有目录”到底指什么。主通讯录就是你在Notes客户端里通过“位置文档”指定的那个服务器目录通常是Domino目录names.nsf。所有目录则指的是服务器端通过目录协助Directory Assistance配置进来的全部数据源包括多本Domino目录、从LDAP目录同步过来的账户、甚至第三方外部目录。把这三档列在一起你就明白了如果公司里用户有两千人而你只选了“仅本地通讯录”那TypeAhead永远只能命中你手动存过的那几十个联系人联想不出来是正常的不是Notes坏了。反过来如果你选了“本地所有目录”但服务器上根本没配置任何目录协助那第二段查找依然会扑空。也就是说TypeAhead的效果是“客户端设置”和“服务端目录基建”共同决定的两者必须同时到位。1.3 为什么“预先输入所有用户地址”能治本把全公司用户地址都“预输入”到每位客户端的可达范围内本质上是解决三个问题。第一是速度本地通讯录命中是毫秒级网络查目录即使再快也有一个RTT的延迟而且目录数据量大时服务端还要做一次索引查询。第二是稳定性本地命中不依赖网络服务器临时维护、网络断联都不会影响你把邮件写给最常用的同事。第三是使用体验TypeAhead的价值在于“输入前几个字符就能选人”如果列表每次都只有零星几个熟人用户很快就会放弃这个功能转而去手动复制邮箱地址效率大幅下降。所以这篇文章后两章一条路线是给个人用户如何在本地通讯录里把地址提前收集、导入、沉淀成一份自己的联系人池另一条路线是给管理员如何通过目录编目、目录协助和策略让全公司每一台Notes客户端默认就拥有完整的地址数据源。两条路线不冲突甚至可以叠加使用。2. 个人用户怎么把地址“提前装进”本地通讯录2.1 自动沉淀让Notes替你保存联系人先推荐最简单、最省力的做法让Notes在收发邮件时自动把收件人写进个人通讯录。在“文件 首选项 邮件”里勾选类似“自动将收件人添加到个人通讯录”的选项之后每次你成功发送邮件给某人Notes就会把对方的名字和邮件地址自动保存为一条联系人记录。这个功能对日常维护本地联系人池非常有效你不需要手动录入只要保持正常的收发件习惯几周后本地通讯录自然就会沉淀出你真正高频联系的一批人而这些人在TypeAhead里的命中率几乎100%。不过这个自动沉淀方案有两个限制。第一它只会记录“成功发送的收件人”和部分回复对象不会把公司所有同事都塞进来毕竟你不可能给全公司每个人都发过邮件。第二有些版本默认不开启这个选项需要手动去偏好设置里打开。如果你发现TypeAhead里老是只有收件箱里的人而没有新同事先看看这个开关是不是开了。2.2 CSV批量导入适合一次性把通讯录灌进去如果你手里有现成的通讯录文件——比如HR给的全员名单CSV、或者从旧系统导出的联系人表——那最快的方式就是一次性批量导入本地names.nsf。具体操作是在Notes客户端里打开个人通讯录数据库本地names.nsf选择“文件 导入”文件类型选CSV然后按照向导把CSV里的字段一一映射到联系人字段上。常用的映射关系是FirstName名、LastName姓、FullName全名、EmailAddress电子邮件、CompanyName公司以及电话号码等最终存储为联系人文档。这里提醒几个实际导入时容易踩的细节。一是中文姓名很多HR表格里“姓名”是一个整字段导入前最好拆成姓和名两个字段或者至少映射到FullName一个字段里否则Notes的排序和前缀匹配会不准确。二是重复联系人批量导入最容易引入重复导入完成后可以到“通讯录 联系人”视图下按“全名”排序肉眼扫一遍重复项再用工具清理。三是Internet地址格式Notes联系人文档里的“电子邮件”字段填的必须是标准SMTP地址不要带Notes的格式否则TypeAhead匹配出的地址发不出去。CSV导入确实是一次性把“所有用户地址都预输入到本地”的最直接做法。但我不建议在几十人以上的团队里长期靠这个办法维护因为人员入职离职很快导入的地址会过期。它更适合作为“开局一把梭”的初始化手段之后靠自动沉淀和定期更新来维持。2.3 从企业目录“另存为”常用联系人第三种个人做法更精准在写邮件时点开收件人右边的地址选择器从企业目录里搜到目标用户然后把这条目录记录“另存为”到个人通讯录。在搜索结果里选中一个人右键菜单里通常有“添加到个人通讯录”或“复制到联系人”之类的选项选中后会弹出一个联系人编辑界面直接保存即可。你可以多选几个常用同事一次性操作这样TypeAhead立刻覆盖到他们。这个做法的好处是地址绝对准确因为数据直接来自Domino目录不需要你手工拼写。我的习惯是按项目团队批量保存每个项目开工前我把团队成员从公司目录里搜出来一次加入个人通讯录这个项目的邮件往来阶段TypeAhead就特别顺手。缺点是它本质还是手动操作没办法覆盖全公司。所以它更适合作为补充而不是主方案。3. 管理员视角让全员默认拥有完整地址池如果说普通用户只能靠“自扫门前雪”的方式攒本地联系人那么作为Domino管理员你完全可以做到让每一台Notes客户端从第一天起就有全公司的地址数据可供TypeAhead查询。这一章就是管理员的重点。3.1 目录编目Directory Catalog把整个公司地址压缩给客户端大型企业最推荐的做法是部署“目录编目”Directory Catalog。它的原理其实很好理解把服务器端的一本或多本Domino目录names.nsf压缩成一本精简的、只读的目录编目数据库一般叫dircat.nsf里面只保留身份识别和地址信息相关的核心字段——全名、姓、名、邮件地址、组织信息等把所有ACL、授权设置、策略文档等不相关的数据全部丢弃。压缩之后的dircat.nsf体积通常只有原目录的几分之一甚至更低非常适合分发到客户端或作为TypeAhead的查询源。创建目录编目并不复杂。在Domino服务器控制台上运行load dircat任务首次运行时它会根据配置创建dircat.nsf并开始构建编目数据之后该任务会定期运行以更新地址变更。如果你有多个目录需要合并编目还可以在dircat配置里指定目录范围让编目任务把多本names.nsf统一编成一本。构建完成后把dircat.nsf加入客户端可访问的范围或者让它作为目录协助里的一个查询源TypeAhead就能拿到全公司地址了。这里要强调一个常见误区目录编目不是实时查询它是一个按周期重建的静态数据快照。所以采用dircat方案时一定要配套一个合理的重建周期——比如每天凌晨业务低峰期跑一次dircat任务——保证第二天用户在公司里找到新入职同事的地址。如果dircat半年不更新那TypeAhead能查到的永远是半年前的通讯录。3.2 目录协助DA控制客户端到底查哪些目录有了dircat.nsf之后还需要告诉Notes客户端“你应该去哪些地方查地址”这一步靠的是目录协助Directory Assistance简称DA。DA是Domino服务器上一个独立的配置数据库da.nsf里面定义了服务器进行目录查找时按照什么顺序查询哪些目录数据库。本质上它就是一个“地址查找路由表”。作为管理员你需要做的是在命名服务里创建一个DA数据库或使用已有的da.nsf在其中添加规则让系统把dircat.nsf和主names.nsf按顺序排列。通常的顺序是先查dircat.nsf体积小、查得快→ 再查主names.nsf数据全→ 如果还配置了LDAP外部目录可以把LDAP放在最后。客户端TypeAhead在“本地所有目录”模式下会遵循服务器端DA配置的顺序执行查找。这里有一个我从实际维护里学到的优化点把dircat.nsf放在DA列表的最前面明显能降低TypeAhead在网络查询上的等待时间。因为dircat体积小索引命中快服务器处理开销低而完整names.nsf动辄几百MB每次TypeAhead查询都要全库扫索引人多时CPU会飙升。此外DA里还可以按组织级别设置规则比如“只允许某OU的用户查询某本目录”在多部门隔离的部署里很有用但也别设得太死否则普通员工TypeAhead又查不到全公司地址了。3.3 桌面策略统一下发TypeAhead设置最后一步是让所有客户端都使用正确的TypeAhead范围统一进入“本地所有目录”模式。手动让用户去改首选项是不现实的——且不说用户不懂就算懂也可能改错。正确的做法是通过Domino的桌面策略Desktop Settings统一下发。在Domino Administrator里找到“策略”相关的配置选择“桌面设置”在“邮件”选项卡里可以找到TypeAhead相关的选项。策略创建后把它关联到组织、组织单元或特定用户组。下发后客户端的TypeAhead行为会被自动设置为指定模式而且你还可以选择“锁定”策略防止用户在客户端本地自行更改。这样无论新电脑还是老电脑只要用户登录域策略一刷新TypeAhead就统一进入正确的查询模式。这里我建议策略配置时直接选择“本地通讯录所有通讯录”这一档同时把服务器端DA配好。这样无论是本地预存联系人、还是从dircat查询TypeAhead都能自动把最新地址呈现在用户面前理论上就是标题里所期望的“预先输入所有用户地址”的最佳实践落地。当然多目录查询的代价是每次按键的额外RTT所以在内网延迟正常低于50ms的情况下完全可接受。3.4 顺便说个不建议的方案别把完整names.nsf复制到客户端有些管理员为了方便会把服务器上的names.nsf直接复制到用户本地当成一个额外的个人通讯录让TypeAhead去查这个副本。我不建议这么做原因有三第一完整names.nsf体积太大一个上万人的公司目录动辄几百MB放到每个客户端既占磁盘又拖慢查询第二names.nsf里面包含了ACL、服务器配置、策略文档等管理性数据分发给普通用户存在信息安全风险第三完整的本地复本需要维护复本关系一旦复制冲突或不同步用户查到的地址可能比dircat的定期快照还旧。所以更稳妥的做法就是上一节说的dircatDA方案把静态快照在服务器端统一生成按周期更新比让每个客户端自己同步可靠得多。4. TypeAhead常见故障与优化实录4.1 联想列表完全不出现这是最常见的求助。首先确认偏好设置里的TypeAhead选项没有关掉或只选了“仅本地通讯录”而你要找的人恰好不在本地联系人里——这种情况不是故障是配置必然结果。排除配置后再看本地names.nsf是否健康有时候names.nsf因为异常断电或磁盘问题损坏第一步就去查本地目录本地目录一坏TypeAhead就直接哑火。可以尝试在Notes客户端里打开names.nsf查看是否能正常展开“联系人”视图如果视图打开报错说明数据库确实有问题可以用“文件 应用程序 压缩”来做一次压缩修复严重时需要从备份恢复或新建一个names.nsf重新关联。如果本地目录正常但选择了“本地所有目录”依然没有任何联想结果就要检查服务器端了。在服务器控制台用show tasks看看目录服务相关任务是否在运行再检查da.nsf里的规则状态确认客户端请求的目录是否在DA列表中且被启用了“给客户端使用”的权限。这里最讨厌的是DA配置不报错但顺序错误导致查询超时现象就是TypeAhead等半天不弹出结果。遇到这种情况把dircat.nsf放到最前面再测试一次。4.2 输入时卡顿、查询特别慢TypeAhead慢九成是查询范围过宽或者目录索引不给力。第一种情况是本地通讯录塞了太多数据且没有合理整理比如有人把几万条历史联系人都灌进去了每次前缀匹配要扫的文档太多自然会卡。本地通讯录不是数据库仓库保持几千条以内的常用联系人才是健康状态。第二种情况是选择了“本地所有目录”但服务器端DA列表里的目录又多又大还排了多个LDAP源TypeAhead的每一次按键都会同步等待整个查找链跑完不快就有鬼了。第三种情况是dircat.nsf没有压缩过长期积累后索引膨胀查询性能直线下降此时在服务器端跑一次load compact dircat.nsf或者按第3.1节规划定期重建dircat能显著改善。另外如果你的网络是跨地域访问Domino比如总部在上海、海外员工查华盛顿服务器这个RTT本身就很难压缩更应该在本地联系人池做文章让海外用户把高频联系人预先存本地同时为海外站点单独部署dircat或目录服务别让所有TypeAhead查询都走长链路。4.3 联想结果缺失或地址过期类型提示有结果但结果里没有新入职的同事或者显示的是离职员工的旧地址。这种情况通常是dircat或主目录的数据没有及时更新。先看dircat任务最后一次构建时间如果是很久以前就在服务器上重新触发一次构建任务让新地址进快照。再看联系人文档的Internet地址字段是否正确很多人从老系统导入的数据邮件地址字段是空的或是一个旧邮箱TypeAhead匹配到这个人也发不出去所以在导入或同步时必须确认InternetAddress和MailFile等信息正确。还有一个小细节Notes的TypeAhead对“全名”字段的依赖性很强。如果联系人文档里只有姓和名没有拼合好的FullName字段前缀匹配可能失败。批量导入后建议检查一下联系人视图的分组情况凡是“未分类”的联系人多半是全名格式不对。4.4 故障速查与优化建议表症状可能原因处理建议TypeAhead完全不弹出TypeAhead被关闭/只查本地但本地无数据检查首选项开启“本地所有目录”只弹本地熟人公司同事查不到未开启服务器目录查询改为“本地所有目录”检查DA输入很卡本地联系人过多/DA目录过大/跨地域精简本地联系人dircat前置优化目录索引新同事查不到dircat快照过期重建dircat调整策略关联查得到但发送失败Internet地址缺失或错误检查联系人文档InternetAddress字段names.nsf报错本地数据库损坏压缩修复names.nsf或重建这张表基本覆盖了我在群里被问到过的绝大多数问题。TypeAhead这东西配置对了是顺滑到让你忘记它的存在配置错了天天有人在后头追着你问“怎么搜不到人”。最后再说点我的个人体会。做Notes运维这么多年我越来越觉得“预先输入所有用户地址”这件事本质上不是一项一次性操作而是一套持续运行的机制客户端靠自动沉淀和导入积累本地联系人服务器端靠dircat和DA提供全量地址策略负责把正确的设置推给所有人三者缺一不可。如果你只是个小团队让成员互发几封邮件把联系人自动沉淀起来就够了如果你们是几千人的企业那dircatDA策略这条路一次走通以后TypeAhead基本不用人操心。别把这项工作当成绝活它其实是每个Notes管理员都该铺好的“水电煤”。