跳转到内容
PynPyn

ADP Workforce Now

ADP Workforce Now 集成通过 ADP 的 Workers API 读取员工,并让 Directory 保持最新:姓名、工作邮箱和个人邮箱、雇用日期和资历日期、部门、业务单元、职类、地点、经理和离职日期。Pyn 只读取;不会向 ADP 写回任何内容。

  • 你是 Pyn 中的管理员或所有者,并且你的工作区启用了 ADP;只有这样,磁贴才会出现在 Available 下。
  • ADP 管理员可以在 ADP API Central 中创建一个项目,并添加权限范围 /hr/workerInformationManagement/workerManagement/workerProfileManagement/worker.read。没有它,连接可以通过认证,但不会返回任何员工。
  • 你有该项目的 Client ID 和 Client Secret,以及项目的 SSL 证书和私钥。Pyn 团队会和你一起生成证书对,由你把证书上传到 ADP 项目;联系 support@pynhq.com 开始这一步。
  • 出生日期在 ADP 中默认被遮盖。要同步生日,ADP 管理员需要在数据连接器的应用配置文件上显示该字段。
The Connect to ADP dialog with its four credential fields.
Connect to ADP asks for the Client ID, Client Secret, SSL Certificate and Private Key.
  1. 在 Pyn 中,打开左侧导航中的 Settings,然后打开 Integrations 下的 Available。

  2. 选择 ADP 磁贴。Connect to ADP 对话框打开。

  3. 输入来自 API Central 的 Client ID 和 Client Secret。

  4. 粘贴 SSL Certificate 和 Private Key。

  5. 选择 Connect。Pyn 通过 ADP 测试这些凭据时,对话框显示 “Validating those credentials…”,这可能需要一点时间。在 ADP 接受这些凭据之前,不会保存任何内容。

  6. 成功后,通知显示 “Your ADP Workforce Now integration has successfully been added to Pyn. It will take a minute or two for the employee data to be pulled from ADP.”。

如果对话框报告错误,按原因对照:“Could not verify the credentials. The Client ID or Client Secret appear to be invalid.” / “The SSL certificate appears to be invalid. Please check the certificate and try again.” / “ADP is returning an error. Please try again later.” / “An unexpected error occurred. Please check the details and try again. If the error persists, contact support.”。对话框保留你输入的内容,所以更正后再次选择 Connect。

Pyn 大约每小时从 ADP 刷新一次,并在 History 下记录每次运行。逐字段如下:

Pyn 属性 来自 ADP
显示名称、常用名、法定姓名 设置了常用名时为常用名,否则为法定姓名
工作邮箱、个人邮箱 商务和个人电子邮件地址
入职日期 原始雇用日期
司龄起算日期 资历日期
离职日期 离职日期
状态 员工状态代码:A 在职、L 休假、T 已离职
部门、业务单元、职类、职位、地点 主要工作分配
经理 该分配的汇报对象员工
生日、时区 未遮盖时为出生日期;时区来自法定(家庭)地址的国家和邮政编码,回退到工作地点的国家
外部 id Worker ID 和 associate OID

既没有商务邮箱也没有个人邮箱的员工在有邮箱之前不会出现在 Directory 中。工作者类型默认不映射;Pyn 支持可以把它从主要工作分配映射为自定义字段。完整矩阵见 HRIS 字段,员工如何匹配见同步频率与匹配。

打开 Installed 下的 ADP 磁贴,打开 … 菜单并选择 Test Connection。“Successfully tested the connection to ADP Workforce Now.” 表示成功。“An error occurred connecting to ADP Workforce Now. Please check your credentials or contact support if the issue persists.” 表示凭据已不再有效;重新连接。然后打开员工,检查姓名、雇用日期和汇报关系。

  • Reconnect(… 菜单)打开 Reconnect to ADP,有同样的四个字段;输入新凭据并选择 Connect。“Your ADP Workforce Now integration has successfully been updated.” 表示成功。Pyn 会先通过 ADP 测试新凭据;如果对话框报告错误,集成保留原有的凭据。
  • Deactivate 停止同步但不删除凭据;Activate 恢复同步。
你看到的 含义
磁贴位于 Needs Attention 🚨 下,History 中有一条 “Error: Authentication failed, please reconnect” ADP 拒绝了凭据,通常发生在轮换之后。用新值重新连接。
History 中有一条带警告圆点的 “ADP appears to have a temporary outage” ADP 返回了服务器错误或无法访问(连接超时或中断)。集成保持活跃,下一次计划刷新会重试,所以除非反复出现,否则无需处理。
连接正常但没有员工出现 API 项目缺少 worker.read 权限范围。在 API Central 中添加它并刷新。
缺少生日 该字段在 ADP 中被遮盖。在应用配置文件上显示它。
缺少某些人 既没有商务邮箱也没有个人邮箱的员工不会出现在 Directory 中。