跳至主要内容
Administrator Guide
上次更新时间 :2025-03-14
概念:导入打卡事件

概念:导入打卡事件

您可以使用“Put Time Clock Events”
或“Import Time Clock Events”
Web 服务将第三方考勤系统中的数据导入到 Workday Time Tracking 中。这些 Web 服务会将原始时钟数据导入为打卡事件,然后 Workday 对这些数据执行匹配操作,以创建时间块并运行计算。员工在提交时间块之前可以对其进行编辑。

导入大批打卡事件

如果您使用“Put Time Clock Events”
导入超过 1,000 个打卡事务,该集成可能需要花费大量时间才能完成,并且可能会耽搁其他 Workday 流程。在这种情况下,请使用“Import Time Clock Event”
Web 服务。
当您需要不太频繁地大批导入 1,000 个或更多打卡事件时,请使用“Import Time Clock Events”
Web 服务。示例:在与第三方系统集成失败后,导入打卡事件以进行实施测试,或加载单个很大的批次。“Import Time Clock Events”
作为后台流程运行,因此它不会耽搁同时运行的其他 Workday 任务。
“导入”Web 服务模式允许您使用 Workday 企业接口生成器 (EIB)。要在使用“Import Time Clock Events”
后检索处理错误,您可以使用:
  • “Get Import Process Messages”
    Web 服务
  • “未处理的打卡事件”
    报告

导入小批打卡事件

当您需要近乎实时地从第三方系统导入打卡事件时,请使用“Put Time Clock Events”
公共 Web 服务操作。第三方系统应当将打卡事件分批排队,并发起对“Put Time Clock Events”
的调用。如果 Workday 无法接收某个批次,第三方系统必须继续将打卡事件排队,直到 Workday 可用。
使用“Put Time Clock Events”
Web 服务时,我们建议您:
  • 以原始形式发送打卡事件(不与时间块匹配或以任何其他方式进行处理)。
  • 按 2-5 分钟的时间间隔发送批次。
  • 按发生顺序发送打卡事件,以确保 Workday 尽可能准确地将其匹配到时间块中。
  • 不要发送包含的打卡事务超过 150 个的批次。如果您有超过 150 个打卡事务要发送,请将它们拆分为更小的批次。

必填字段

导入到 Workday 的打卡事件必须包含以下详细信息:
字段
注释
打卡事件日期时间
打卡事件的日期和时间。如果您未指定时区偏移量,Workday 将假定 UTC 时差偏移量为零。
打卡事件类型参考
Workday 接受 4 种打卡事件类型:“签入”
“签出”
“休息”
“就餐”
员工编号
职位编号
如果员工有多重职务并且打卡事件类型为“签入”
,则此字段为必填字段。
打卡事件编号
对于编辑和删除事务为必填字段,Workday 需要使用此字段来识别要编辑或删除的打卡事件。
删除打卡事件
标记此字段后,会将事务识别为一个删除事务。
如果您要导入删除事务,则只有以下字段为必填字段:
  • 打卡事件编号
  • 删除打卡事件
所有其他字段均为可选字段。

错误和验证

该 Web 服务操作接受的数据在考勤中可能依然无效。在数据通过该 Web 服务操作后,Workday 会对数据运行一组单独的验证,并将无效的打卡事务标记出来。Workday 不会将无效的打卡事务匹配到时间块,而是会将其标记为出错,直至您更正事务。可以使用“维护无效打卡事件”
任务来查看、修复或忽略出错的事务。
以下字段中的值无效或缺失会导致打卡事件出错,直至错误被更正:
  • 员工编号
  • 职位编号
  • 打卡事件日期时间
  • 打卡事件类型参考
以下字段可选,但如果发送,则它们必须是在 Workday 中有效的值。在更正之前,无效值会导致打卡事务出错。这些字段仅适用于“签入”
打卡事件类型。如果时间代码为空,则 Workday 会应用员工时间输入模板中的默认时间代码。
  • 时间代码
  • 项目编号
  • 任务编号
  • 重设单位薪资
  • 业务单位
  • 成本中心
  • 自定义组织 01 - 自定义组织 10
  • 自定义工作标记 01 - 自定义工作标记 15
  • 资金
  • 授予
  • 职务概要
  • 地点
  • 方案
  • 区域

编辑和删除打卡事件数据

您可以使用“Put Time Clock Events”
Web 服务编辑或删除打卡事件。使用该 Web 服务导入编辑事务时,请在文件中包括打卡事件编号。当您导入编辑事务时,Workday 会将打卡事件的现有详细信息替换为新事务的详细信息。除了编辑的字段外,还需包括您希望保留的所有详细信息。导入删除事务时,请将
“Delete Time Clock Event”
字段设置为
“Y”
(表示“是”)。
除了导入编辑和删除内容外,您还可以直接在 Workday 中管理打卡事件。
报告或任务
需考虑的事项
“维护员工的无效打卡事件”任务
经理和管理员可以编辑或忽略经理的直接下属的无效打卡事件。
打卡历史记录
报告
您可以编辑和删除任何类型的打卡事件。