如何使用Taleo Connect Client将候选人offer letter导出为PDF文件

前置配置要求 #

• 账号权限：所用TCC集成账号需开通Offer模块读取权限、文件导出权限，同时绑定目标业务区的访问许可；若需导出带敏感薪资信息的Offer内容，还需额外开通Offer Letter Confidential Content读取权限，否则拉取到的内容会被自动脱敏。
• 环境匹配：TCC客户端大版本需和对接的Taleo实例版本保持一致，跨大版本调用会出现PDF渲染接口不兼容问题；本地运行环境需安装JRE 8及以上版本，安装TCC时不要跳过内置BI Publisher渲染组件，否则无法完成PDF格式转换。
• 前置信息准备：提前确认目标业务区连接端点、对应Offer Letter的模板ID、导出数据的筛选规则（比如Offer状态范围、生成时间区间、所属部门范围）。

操作流程 #

1. 新建导出工程
   打开TCC客户端，新建Scheduled Export类型的标准导出工程，配置目标业务区的连接参数，测试连通性通过后进入配置页。
2. 配置数据拉取规则

• 选择根导出对象为Offer，关联映射Candidate、OfferLetter两个子对象，勾选需要导出的基础字段（候选人姓名、Offer编号、对应职位、Offer状态），必须勾选OfferLetter.Content、OfferLetter.TemplateId两个核心字段作为PDF生成的数据源。
• 配置筛选条件：建议添加规则过滤掉草稿状态、已作废状态的Offer，比如设置Offer.Status in ("Extended", "Accepted")，再按需添加时间、部门等维度的筛选条件，缩小拉取范围降低任务负载。

3. 配置PDF生成规则

• 在导出流程的后处理（Post-Processing）节点添加内置的Render Document操作，输出格式选择PDF。
• 匹配提前准备好的Offer Letter模板，将拉取到的Offer字段和模板内的占位符一一对应，设置PDF文件命名规则，推荐用[Offer编号]_[候选人姓名]_OfferLetter.pdf格式，避免重名覆盖。
• 指定PDF文件的本地/共享存储路径，若需同步到其他存储系统，可在后处理节点追加SFTP/本地文件移动的操作。

4. 测试与正式运行

• 先选取1-2条测试用Offer数据执行单条导出，核对生成的PDF格式、字段填充、特殊内容（比如电子公章、特殊符号）是否正常，确认无错位、缺字、内容缺失问题。
• 测试通过后保存工程，可按需配置定时调度规则做增量自动导出，也可手动触发全量导出任务。

注意事项 #

• 若拉取Offer Letter内容时返回空值，优先检查集成账号的敏感内容读取权限，多数情况下是未开通保密内容访问权限导致的拦截，不是配置错误。
• 若生成的PDF出现乱码、自定义字体显示异常，将Offer模板用到的自定义字体文件放到TCC安装目录的/lib/fonts路径下，重启客户端后重新执行导出即可。
• 单次导出的Offer数量超过1000份时建议拆分批次，按时间维度做增量导出，单批次控制在500份以内，避免触发Taleo端接口限流导致任务超时中断。
• 导出的PDF包含候选人个人敏感信息，存储路径需配置对应访问权限，任务执行日志按合规要求留存，满足审计需要。
• 如果对应Offer Letter是手动上传的PDF附件而非系统模板生成的内容，不需要走Render Document渲染流程，直接拉取OfferLetter.Attachment字段的二进制流保存为PDF文件即可，走渲染流程反而会损坏原文件格式。

内容的提问来源于stack exchange，提问作者rizwanabegum sayyad