用途:设计可恢复的 BambooHR 员工数据读取管道,优先使用 dataset v2 契约做批量数据工作,在源头最小化字段,并把缺失字段视为可能的权限决策而非数据丢失。
主要能力:员工端点含 list、get、create、update;POST /api/v2/datasets/{datasetName}/data 接受 fields、OData 风格 filter、orderBy、page、pageSize,返回 data、links、meta,pageSize 上限 1000。dataset v1 数据调用已弃用,数据集与字段发现使用 v1.2 端点;旧版自定义报表端点带弃用提示,不应据旧示例新建管道。
使用方式:先定义业务目的、法律依据、租户、目标、数据所有者、刷新目标与确切字段;从当前端点发现数据集与字段定义,将字段 ID 与语义映射保存为经审阅配置;以确定性排序查询 dataset v2,排序字段须包含在 fields 中,pageSize 不超过上限;按返回的分页元数据或链接推进,仅在目标事务提交后持久化检查点;以租户范围内稳定员工标识做 upsert,区分缺失、null、脱敏、未来日期与非活跃值;核对源、接收、接受、拒绝与目标计数,隔离模式或权限漂移而非删除;加密保留的 HR 数据,在批准保留期后删除原始分页内容。
认证:按文档要求使用 OAuth scope report,或使用仅能访问选定字段的专用 API 密钥用户;凭据、检查点与目标命名空间绑定到单一租户。
工具纪律与边界:用 Read、Glob、Grep 检查映射、模式与检查点;Write/Edit 仅用于经批准的管道代码、配置与测试;不得用本技能获取生产员工数据或变更下游系统。字段集、非活跃/未来员工纳入、生产租户、目标、保留策略及任何员工创建或更新操作均需批准;读取不授权写入。
错误处理:403 重新检查字段级权限与所请求数据集,未经业务所有者不得扩大访问;413 减小 pageSize 或字段集,不得静默丢弃记录;422 拒绝无效 filter/order 契约并保留检查点;200 但字段缺失时对比请求与返回模式,因部分报表路径会省略不可访问字段而不报错。
限制:资料未提供具体价格、平台支持范围或实际效果数据;未提供完整代码示例与安装命令。