缺席（预览版）
absentify 是专为 Microsoft 365 设计的综合性缺勤管理解决方案。 此连接器可实现无缝集成，使你能够基于员工休假请求自动执行工作流、跟踪审批状态，以及跨业务系统同步缺席数据。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 ： - Azure 政府区域 - Azure 中国区域 - 美国国防部（DoD） |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 ： - 美国政府 （GCC） - 美国政府 （GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD） |
| 联系人 | |
|---|---|
| Name | 缺席支持 |
| URL | https://absentify.com/docs |
| support@absentify.com |
| 连接器元数据 | |
|---|---|
| 发布者 | BrainCore 解决方案 |
| 网站 | https://absentify.com |
| 隐私策略 | https://absentify.com/privacy-policy |
| 类别 | 人力资源;业务管理 |
absentify
absentify 是专为 Microsoft 365 环境设计的免费工具，可有效地管理团队或员工的缺勤。 它全面概述了所有休假时间以及给出的原因，而无需繁琐的 Excel 工作表。 absentify 提供了批准休假请求和假期的最简单方法，与 Microsoft Teams 和 Microsoft 365 完全集成。
发布者：BrainCore 解决方案 GmbH
先决条件
若要使用此连接器，需要工作、学校或个人Microsoft帐户。 还必须通过执行以下步骤之一来接受缺少的权限和许可：
此外，还需要 Essentials 计划或更高版本才能使用此连接器的触发器。
支持的作
连接器支持以下作：
Triggers
When a leave request is created
在公司中创建新请求时，将激活此触发器。
When a leave request status changes
当现有请求的状态发生更改时，将激活此触发器。
API作（需要加计划）
以下作需要缺席 Plus 计划：
Members
-
[Plus] Get all members- 检索具有部门、状态、就业日期等可选筛选器的所有成员。 -
[Plus] Invite a member- 邀请新成员加入工作区。 -
[Plus] Get member by ID- 按其唯一 ID 检索特定成员。 -
[Plus] Update a member- 更新现有成员的信息。 -
[Plus] Delete a member- 永久删除成员。 -
[Plus] Get member by Microsoft ID- 按其Microsoft用户 ID 检索成员。 -
[Plus] Get member by email- 按其电子邮件地址检索成员。 -
[Plus] Get member by custom ID- 按其自定义 ID 检索成员。 -
[Plus] Update member approvers- 更新特定成员的审批者。 -
[Plus] Update member allowance- 更新特定年份的成员津贴。 -
[Plus] Add member schedule- 为成员添加新的工作计划。
部门
-
[Plus] Get all departments- 检索工作区中的所有部门。 -
[Plus] Create a department- 创建新部门。 -
[Plus] Update a department- 更新现有部门。 -
[Plus] Delete a department- 删除部门。
保留类型
-
[Plus] Get all leave types- 检索工作区中配置的所有保留类型。 -
[Plus] Create a leave type- 创建新的离开类型。 -
[Plus] Update a leave type- 更新现有的离开类型。 -
[Plus] Delete a leave type- 删除离开类型。
请求
-
[Plus] Get all requests- 使用可选筛选器检索所有离开请求。 -
[Plus] Create a request- 为成员创建新的休假请求。 -
[Plus] Get request by ID- 按 ID 检索特定休假请求。 -
[Plus] Update a request- 更新休假请求的状态（批准、拒绝或取消）。 -
[Plus] Delete a request- 永久删除休假请求。
公共假日
-
[Plus] Get all public holiday calendars- 检索所有公共假日日历。 -
[Plus] Create a public holiday calendar- 创建新的公共假日日历。 -
[Plus] Get public holiday calendar by ID- 检索具有其所有假日的特定日历。 -
[Plus] Update a public holiday calendar- 更新现有日历。 -
[Plus] Delete a public holiday calendar- 删除日历。
工作空间
-
[Plus] Get workspace settings- 检索工作区设置和配置。
缺席
-
[Plus] Get absences- 检索特定日期范围的缺失。
获取凭据
若要使用此连接器，需要工作、学校或个人Microsoft帐户，可以直接登录。
入门
通过以下方法之一安装缺席：
若要完全配置帐户，请遵循本 快速入门指南。 确保使用的是 Essentials 计划或更高版本的触发器，或者针对 API作的 Plus 计划。
现在可以开始了。
已知问题和限制
- 在 Essentials 计划中，只能创建三个触发器。 在第三个触发器之后，将收到一条错误消息，需要在创建新触发器之前删除现有触发器。
- API作（标有 [Plus]）需要缺少 Plus 计划。 如果尝试在没有 Plus 计划的情况下使用这些作，将收到错误。
部署说明
请按照 以下说明 将此连接器部署为 Microsoft Power Automate 和 Power Apps 中的自定义连接器。
创建连接
连接器支持以下身份验证类型：
| OAuth 连接 | OAuth 连接 | 所有区域 | 不可共享 |
| 默认值 [已弃用] | 此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。 | 所有区域 | 不可共享 |
OAuth 连接
身份验证 ID：未定义
适用：所有区域
OAuth 连接
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
默认值 [已弃用]
适用：所有区域
此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。
这是不可共享的连接。 如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| [加号]创建公共假日日历 |
在工作区中创建新的公共假日日历。 需要缺席 Plus 计划。 |
| [加号]创建离开类型 |
在工作区中创建新的休假类型。 需要缺席 Plus 计划。 |
| [加号]创建请求 |
为成员创建新的休假请求。 需要缺席 Plus 计划。 |
| [加号]创建部门 |
在工作区中创建新部门。 需要缺席 Plus 计划。 |
| [加号]删除公共假日日历 |
从工作区中删除公共假日日历。 需要缺席 Plus 计划。 |
| [加号]删除成员 |
删除成员。 所有数据都将永久删除。 需要缺席 Plus 计划。 |
| [加号]删除离开类型 |
从工作区中删除离开类型。 需要缺席 Plus 计划。 |
| [加号]删除请求 |
永久删除休假请求。 需要缺席 Plus 计划。 |
| [加号]删除部门 |
从工作区中删除部门。 需要缺席 Plus 计划。 |
| [加号]按 ID 获取公共假日日历 |
检索具有其所有假日的特定公共假日日历。 需要缺席 Plus 计划。 |
| [加号]按 ID 获取成员 |
按其唯一 ID 检索特定成员。 需要缺席 Plus 计划。 |
| [加号]按 ID 获取请求 |
按其唯一 ID 检索特定休假请求。 需要缺席 Plus 计划。 |
| [加号]按Microsoft ID 获取成员 |
按其Microsoft用户 ID 检索成员。 需要缺席 Plus 计划。 |
| [加号]按自定义 ID 获取成员 |
按其自定义 ID 检索成员。 需要缺席 Plus 计划。 |
| [加号]更新公共假日日历 |
更新现有的公共假日日历。 需要缺席 Plus 计划。 |
| [加号]更新成员 |
更新现有成员的信息。 需要缺席 Plus 计划。 |
| [加号]更新成员审批者 |
更新特定成员的审批者。 支持Microsoft配置文件经理、部门设置或自定义审批者。 需要缺席 Plus 计划。 |
| [加号]更新成员津贴 |
更新特定津贴类型和年份的成员津贴。 需要缺席 Plus 计划。 |
| [加号]更新离开类型 |
更新现有离开类型。 需要缺席 Plus 计划。 |
| [加号]更新请求 |
更新休假请求的状态（批准、拒绝或取消）。 需要缺席 Plus 计划。 |
| [加号]更新部门 |
更新现有部门。 需要缺席 Plus 计划。 |
| [加号]添加成员计划 |
为成员添加新的工作计划。 需要缺席 Plus 计划。 |
| [加号]获取工作区设置 |
检索工作区设置和配置。 需要缺席 Plus 计划。 |
| [加号]获取所有公共假日日历 |
检索工作区中配置的所有公共假日日历。 需要缺席 Plus 计划。 |
| [加号]获取所有成员 |
获取具有部门、状态、就业日期、管理员状态、审批流程、审批者、津贴类型、名称、生日月份和经理类型的可选筛选器的所有成员。 需要缺席 Plus 计划。 |
| [加号]获取所有离开类型 |
检索工作区中配置的所有保留类型。 需要缺席 Plus 计划。 |
| [加号]获取所有请求 |
使用可选筛选器检索所有离开请求。 需要缺席 Plus 计划。 |
| [加号]获取所有部门 |
检索工作区中的所有部门。 需要缺席 Plus 计划。 |
| [加号]获取缺席 |
检索特定日期范围的缺失。 返回指定时间段内批准的休假请求。 需要缺席 Plus 计划。 |
| [加号]通过电子邮件获取成员 |
按其电子邮件地址检索成员。 需要缺席 Plus 计划。 |
| [加号]邀请成员 |
邀请新成员加入工作区。 需要缺席 Plus 计划。 |
[加号]创建公共假日日历
在工作区中创建新的公共假日日历。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Name
|
name | True | string |
公共假日日历的名称。 |
|
国家
|
country | string |
公共假日的国家/地区代码。 |
返回
已创建的公共假日日历的 ID。
- response
- string
[加号]创建离开类型
在工作区中创建新的休假类型。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Name
|
name | True | string |
离开类型的名称。 |
|
离开单位
|
leave_unit | string |
此离开类型的单位。 |
|
|
颜色
|
color | string |
此离开类型的颜色代码。 |
|
|
图标
|
icon | string |
此离开类型的图标。 |
返回
创建的离开类型的 ID。
- response
- string
[加号]创建请求
为成员创建新的休假请求。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
member_id | True | string |
请求休假的成员的 ID。 |
|
保留类型 ID
|
leave_type_id | True | string |
离开类型的 ID。 |
|
开始日期
|
start | True | string |
休假开始日期（YYYY-MM-DD）。 |
|
开始时间
|
start_at | string |
休假开始的时间。 |
|
|
结束日期
|
end | True | string |
休假结束日期（YYYY-MM-DD）。 |
|
结束时间
|
end_at | string |
休假结束的一天中的时间。 |
|
|
原因
|
reason | string |
休假请求的原因。 |
返回
所创建请求的 ID。
- response
- string
[加号]创建部门
在工作区中创建新部门。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Name
|
name | True | string |
部门的名称。 |
返回
创建的部门的 ID。
- response
- string
[加号]删除公共假日日历
从工作区中删除公共假日日历。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
公共假日日历 ID
|
id | True | string |
公共假日日历的唯一标识符。 |
返回
已删除的公共假日日历的 ID。
- response
- string
[加号]删除成员
删除成员。 所有数据都将永久删除。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
id | True | string |
成员的唯一标识符。 |
返回
已删除成员的 ID。
- response
- string
[加号]删除离开类型
从工作区中删除离开类型。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
保留类型 ID
|
id | True | string |
离开类型的唯一标识符。 |
返回
已删除的保留类型的 ID。
- response
- string
[加号]删除请求
永久删除休假请求。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
请求编号
|
id | True | string |
请求的唯一标识符。 |
返回
已删除请求的 ID。
- response
- string
[加号]删除部门
从工作区中删除部门。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
部门 ID
|
id | True | string |
部门的唯一标识符。 |
返回
已删除部门的 ID。
- response
- string
[加号]按 ID 获取公共假日日历
检索具有其所有假日的特定公共假日日历。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
公共假日日历 ID
|
id | True | string |
公共假日日历的唯一标识符。 |
返回
包含假日的详细公共假日日历。
- 公共假日日历详细信息
- PublicHolidayCalendarDetail
[加号]按 ID 获取成员
按其唯一 ID 检索特定成员。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
id | True | string |
成员的唯一标识符。 |
返回
包括计划在内的详细成员信息。
- 成员详细信息
- MemberDetail
[加号]按 ID 获取请求
[加号]按Microsoft ID 获取成员
按其Microsoft用户 ID 检索成员。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Microsoft用户 ID
|
microsoft_user_id | True | string |
Microsoft用户 ID。 |
返回
包括计划在内的详细成员信息。
- 成员详细信息
- MemberDetail
[加号]按自定义 ID 获取成员
按其自定义 ID 检索成员。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
自定义 ID
|
custom_id | True | string |
成员的自定义 ID。 |
返回
包括计划在内的详细成员信息。
- 成员详细信息
- MemberDetail
[加号]更新公共假日日历
更新现有的公共假日日历。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
公共假日日历 ID
|
id | True | string |
公共假日日历的唯一标识符。 |
|
Name
|
name | string |
公共假日日历的名称。 |
|
|
国家
|
country | string |
公共假日的国家/地区代码。 |
返回
更新的公共假日日历的 ID。
- response
- string
[加号]更新成员
更新现有成员的信息。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
id | True | string |
成员的唯一标识符。 |
|
是管理员
|
is_admin | boolean |
成员是否应是管理员。 |
|
|
部门 ID
|
id | string |
部门 ID。 |
|
|
就业开始日期
|
employment_start_date | string |
就业开始日期。 |
|
|
就业结束日期
|
employment_end_date | string |
就业结束日期。 |
|
|
公共假日日历 ID
|
public_holiday_id | string |
要分配的公共假日日历的 ID。 |
|
|
生日
|
birthday | string |
成员的生日。 |
|
|
自定义 ID
|
custom_id | string |
成员的自定义标识符。 |
|
|
状态
|
status | string |
成员的状态。 |
返回
已更新成员的 ID。
- response
- string
[加号]更新成员审批者
更新特定成员的审批者。 支持Microsoft配置文件经理、部门设置或自定义审批者。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
id | True | string |
成员的唯一标识符。 |
|
审批流程
|
approval_process | True | string |
审批过程的类型。 |
|
成员 ID
|
member_id | string |
审批者成员的 ID。 |
|
|
前置任务管理器 ID
|
predecessor_manager_id | string |
前置管理器的 ID（用于线性审批）。 |
返回
成员的 ID。
- response
- string
[加号]更新成员津贴
更新特定津贴类型和年份的成员津贴。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
id | True | string |
成员的唯一标识符。 |
|
津贴类型 ID
|
allowance_type_id | True | string |
津贴类型的唯一标识符。 |
|
年份
|
year | True | integer |
津贴的年份。 |
|
津贴
|
allowance | True | number |
总津贴金额。 |
|
补偿休假
|
compensatory_time_off | True | number |
要添加的补偿休假时间。 |
|
提出
|
brought_forward | number |
从上一年调来的津贴。 |
|
|
原因
|
reason | string |
津贴更新的原因。 |
|
|
覆盖前移
|
overwrite_brought_forward | boolean |
是否覆盖前移值。 |
|
|
设为默认
|
set_as_default | boolean |
是否将此津贴类型设置为成员的默认值。 |
|
|
Disabled
|
disabled | boolean |
是否为成员禁用此津贴类型。 |
返回
成员的 ID。
- response
- string
[加号]更新离开类型
更新现有离开类型。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
保留类型 ID
|
id | True | string |
离开类型的唯一标识符。 |
|
Name
|
name | string |
离开类型的名称。 |
|
|
离开单位
|
leave_unit | string |
此离开类型的单位。 |
|
|
颜色
|
color | string |
此离开类型的颜色代码。 |
|
|
图标
|
icon | string |
此离开类型的图标。 |
返回
更新后的保留类型的 ID。
- response
- string
[加号]更新请求
更新休假请求的状态（批准、拒绝或取消）。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
请求编号
|
id | True | string |
请求的唯一标识符。 |
|
状态
|
status | True | string |
请求的新状态。 |
|
原因
|
reason | string |
状态更改的原因。 |
返回
已更新请求的 ID。
- response
- string
[加号]更新部门
更新现有部门。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
部门 ID
|
id | True | string |
部门的唯一标识符。 |
|
Name
|
name | string |
部门的名称。 |
返回
更新后的部门的 ID。
- response
- string
[加号]添加成员计划
为成员添加新的工作计划。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
id | True | string |
成员的唯一标识符。 |
|
起始日期
|
from | string |
此计划的开始日期（YYYY-MM-DD）。 |
|
|
已启用星期一 AM
|
monday_am_enabled | boolean |
是否启用星期一早上。 |
|
|
已启用星期一 PM
|
monday_pm_enabled | boolean |
是否启用星期一下午。 |
|
|
已启用星期二 AM
|
tuesday_am_enabled | boolean |
是否启用星期二上午。 |
|
|
启用星期二 PM
|
tuesday_pm_enabled | boolean |
是否启用星期二下午。 |
|
|
已启用星期三 AM
|
wednesday_am_enabled | boolean |
是否启用星期三上午。 |
|
|
已启用星期三 PM
|
wednesday_pm_enabled | boolean |
是否启用星期三下午。 |
|
|
已启用星期四 AM
|
thursday_am_enabled | boolean |
是否启用星期四早上。 |
|
|
已启用星期四 PM
|
thursday_pm_enabled | boolean |
是否启用星期四下午。 |
|
|
已启用星期五 AM
|
friday_am_enabled | boolean |
是否启用星期五早上。 |
|
|
已启用星期五 PM
|
friday_pm_enabled | boolean |
是否启用星期五下午。 |
|
|
已启用星期六 AM
|
saturday_am_enabled | boolean |
是否启用星期六早上。 |
|
|
已启用星期六 PM
|
saturday_pm_enabled | boolean |
是否启用星期六下午。 |
|
|
已启用星期日 AM
|
sunday_am_enabled | boolean |
星期天早上是否已启用。 |
|
|
已启用星期日 PM
|
sunday_pm_enabled | boolean |
星期天下午是否启用。 |
返回
计划的 ID。
- response
- string
[加号]获取工作区设置
[加号]获取所有公共假日日历
[加号]获取所有成员
获取具有部门、状态、就业日期、管理员状态、审批流程、审批者、津贴类型、名称、生日月份和经理类型的可选筛选器的所有成员。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
部门 ID
|
department_ids | array |
按部门 ID 进行筛选。 |
|
|
状态
|
status | string |
按成员状态进行筛选。 |
|
|
从就业开始
|
employment_start_date_from | string |
按就业开始日期（发件人）进行筛选。 |
|
|
就业开始
|
employment_start_date_to | string |
按就业开始日期（到）进行筛选。 |
|
|
就业结束日期
|
employment_end_date_from | string |
按就业结束日期（发件人）进行筛选。 |
|
|
就业结束到
|
employment_end_date_to | string |
按就业结束日期（到）进行筛选。 |
|
|
是管理员
|
is_admin | boolean |
按管理员状态进行筛选。 |
|
|
审批流程
|
approval_process | string |
按审批流程类型进行筛选。 |
|
|
具有审批者
|
has_approvers | boolean |
按成员是否具有审批者进行筛选。 |
|
|
津贴类型 ID
|
allowance_type_id | string |
按津贴类型 ID 进行筛选。 |
|
|
Name
|
name | string |
按成员名称进行筛选。 |
|
|
生日月份
|
birthday_month | integer |
按生日月份（1-12）进行筛选。 |
|
|
管理器类型
|
manager_type | string |
按管理器类型进行筛选。 |
返回
- response
- array of Member
[加号]获取所有离开类型
[加号]获取所有请求
使用可选筛选器检索所有离开请求。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
成员 ID
|
member_id | string |
按成员 ID 进行筛选。 |
|
|
状态
|
status | string |
按请求状态进行筛选。 |
|
|
从
|
start_from | string |
按开始日期（发件人）进行筛选。 |
|
|
开始到
|
start_to | string |
按开始日期（到）进行筛选。 |
|
|
End From
|
end_from | string |
按结束日期（发件人）进行筛选。 |
|
|
端到端
|
end_to | string |
按结束日期（到）进行筛选。 |
|
|
保留类型 ID
|
leave_type_id | string |
按离开类型 ID 进行筛选。 |
|
|
部门 ID
|
department_id | string |
按部门 ID 进行筛选。 |
返回
- response
- array of Request
[加号]获取所有部门
[加号]获取缺席
检索特定日期范围的缺失。 返回指定时间段内批准的休假请求。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
开始日期
|
start | True | date |
缺勤查询的开始日期（YYYY-MM-DD）。 |
|
结束日期
|
end | True | date |
缺勤查询的结束日期（YYYY-MM-DD）。 |
|
成员 ID
|
member_id | string |
按成员 ID 进行筛选。 |
|
|
部门 ID
|
department_id | string |
按部门 ID 进行筛选。 |
返回
- response
- array of Absence
[加号]通过电子邮件获取成员
按其电子邮件地址检索成员。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Email
|
True | string |
成员的电子邮件地址。 |
返回
包括计划在内的详细成员信息。
- 成员详细信息
- MemberDetail
[加号]邀请成员
邀请新成员加入工作区。 需要缺席 Plus 计划。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Name
|
name | True | string |
要邀请的成员的名称。 |
|
Email
|
string |
成员的电子邮件地址。 |
||
|
部门 ID
|
id | string |
部门 ID。 |
|
|
就业开始日期
|
employment_start_date | string |
就业开始日期。 |
|
|
公共假日日历 ID
|
public_holiday_id | True | string |
要分配的公共假日日历的 ID。 |
|
生日
|
birthday | string |
成员的生日。 |
|
|
自定义 ID
|
custom_id | string |
成员的自定义标识符。 |
返回
受邀成员的 ID。
- response
- string
触发器
| 休假请求状态更改时 |
当休假请求的状态更改（已批准、拒绝或取消）时触发。 使用此方式通知员工、更新 HR 系统或同步日历条目。 |
| 创建休假请求时 |
在组织中任何员工提交新的休假或缺勤请求时触发。 使用此选项可以启动审批工作流、发送通知或更新外部日历。 |
休假请求状态更改时
当休假请求的状态更改（已批准、拒绝或取消）时触发。 使用此方式通知员工、更新 HR 系统或同步日历条目。
返回
包含离开请求数据的 Webhook 有效负载。
- 请求 Webhook 有效负载
- RequestWebhookPayloadV2
创建休假请求时
在组织中任何员工提交新的休假或缺勤请求时触发。 使用此选项可以启动审批工作流、发送通知或更新外部日历。
返回
包含离开请求数据的 Webhook 有效负载。
- 请求 Webhook 有效负载
- RequestWebhookPayloadV2
定义
RequestWebhookPayloadV2
包含离开请求数据的 Webhook 有效负载。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
事件类型
|
event_type | string |
触发此 Webhook 的事件的类型。 |
|
请求主体
|
body | RequestBodyV2 |
休假请求详细信息。 |
RequestBodyV2
休假请求详细信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
请求编号
|
id | string |
离开请求的唯一标识符。 |
|
创建时间
|
createdAt | string |
创建请求时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新请求时的时间戳。 |
|
开始日期
|
start | string |
休假请求的开始日期。 |
|
开始时间
|
start_at | string |
休假开始的时间。 |
|
结束日期
|
end | string |
休假请求的结束日期。 |
|
结束时间
|
end_at | string |
休假结束的一天中的时间。 |
|
离开单位
|
leave_unit | string |
用于测量休假持续时间的单位。 |
|
状态
|
status | string |
休假请求的当前状态。 |
|
原因
|
reason | string |
为休假请求提供的原因。 |
|
审批流程
|
approval_process | string |
此请求的审批流程类型。 |
|
取消原因
|
cancel_reason | string |
取消请求的原因。 |
|
已取消日期
|
canceld_date | string |
取消请求的日期。 |
|
成员
|
canceld_by_member | MemberReference |
对成员的引用。 |
|
工作日工期
|
workday_absence_duration | float |
工作日缺勤的持续时间。 |
|
总持续时间
|
duration | float |
休假请求的总持续时间。 |
|
从津贴中获取
|
take_from_allowance | boolean |
是否从津贴中扣除此休假。 |
|
成员
|
request_creator_member | MemberReference |
对成员的引用。 |
|
成员
|
requester_member | MemberReference |
对成员的引用。 |
|
休假类型
|
leave_type | LeaveTypeV2 |
有关离开类型的信息。 |
|
津贴类型
|
allowance_type | AllowanceTypeV2 |
有关津贴类型的信息。 |
|
请求审批者
|
request_approvers | array of RequestApproverV2 |
此请求的审批者列表。 |
MemberReference
对成员的引用。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
成员 ID
|
id | string |
成员的唯一标识符。 |
|
自定义 ID
|
custom_id | string |
成员的自定义标识符。 |
|
Name
|
name | string |
成员的名称。 |
|
Email
|
string |
成员的电子邮件地址。 |
LeaveTypeV2
有关离开类型的信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
保留类型 ID
|
id | string |
离开类型的唯一标识符。 |
|
保留类型名称
|
name | string |
离开类型的名称。 |
|
离开单位
|
leave_unit | string |
离开类型的单位。 |
AllowanceTypeV2
有关津贴类型的信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
津贴类型 ID
|
id | string |
津贴类型的唯一标识符。 |
|
津贴类型名称
|
name | string |
津贴类型的名称。 |
|
忽略限制
|
ignore_allowance_limit | boolean |
是否应忽略限额限制。 |
|
津贴单位
|
allowance_unit | string |
津贴单位。 |
RequestApproverV2
有关请求审批者的信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
审批者状态
|
status | string |
当前审批状态。 |
|
审批者原因
|
reason | string |
审批者提供的原因。 |
|
状态更改日期
|
status_changed_date | string |
审批状态更改的日期。 |
|
成员
|
status_changed_by_member | MemberReference |
对成员的引用。 |
|
成员
|
approver_member | MemberReference |
对成员的引用。 |
成员
工作区中的成员。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
成员 ID
|
id | string |
成员的唯一标识符。 |
|
自定义 ID
|
custom_id | string |
成员的自定义标识符。 |
|
Name
|
name | string |
成员的名称。 |
|
Email
|
string |
成员的电子邮件地址。 |
|
|
创建时间
|
createdAt | string |
创建成员时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新成员时的时间戳。 |
|
状态
|
status | string |
成员的当前状态。 |
|
生日
|
birthday | string |
成员的生日。 |
|
就业开始日期
|
employment_start_date | string |
成员的就业开始日期。 |
|
就业结束日期
|
employment_end_date | string |
成员的就业结束日期。 |
|
是管理员
|
is_admin | boolean |
成员是否为管理员。 |
|
审批流程
|
approval_process | string |
此成员的审批流程类型。 |
|
部门
|
departments | array of MemberDepartment |
成员所属的部门。 |
|
津贴
|
allowances | array of MemberAllowance |
成员的津贴。 |
MemberDetail
包括计划在内的详细成员信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
成员 ID
|
id | string |
成员的唯一标识符。 |
|
自定义 ID
|
custom_id | string |
成员的自定义标识符。 |
|
Name
|
name | string |
成员的名称。 |
|
Email
|
string |
成员的电子邮件地址。 |
|
|
创建时间
|
createdAt | string |
创建成员时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新成员时的时间戳。 |
|
状态
|
status | string |
成员的当前状态。 |
|
生日
|
birthday | string |
成员的生日。 |
|
就业开始日期
|
employment_start_date | string |
成员的就业开始日期。 |
|
就业结束日期
|
employment_end_date | string |
成员的就业结束日期。 |
|
是管理员
|
is_admin | boolean |
成员是否为管理员。 |
|
审批流程
|
approval_process | string |
此成员的审批流程类型。 |
|
部门
|
departments | array of MemberDepartment |
成员所属的部门。 |
|
津贴
|
allowances | array of MemberAllowance |
成员的津贴。 |
|
审批者
|
has_approvers | array of ApproverInfo |
此成员的审批者列表。 |
|
附表
|
schedules | array of Schedule |
成员的工作日程。 |
MemberDepartment
成员的部门分配。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
部门 ID
|
id | string |
部门的唯一标识符。 |
|
部门名称
|
name | string |
部门的名称。 |
|
管理器类型
|
manager_type | string |
该部门成员的角色。 |
MemberAllowance
成员的津贴信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
津贴 ID
|
id | string |
津贴记录的唯一标识符。 |
|
年份
|
year | integer |
此津贴的年份。 |
|
津贴
|
allowance | number |
总津贴金额。 |
|
采取
|
taken | number |
已获取的津贴金额。 |
|
剩余
|
remaining | number |
剩余津贴金额。 |
|
提出
|
brought_forward | number |
从上一年调来的津贴。 |
|
补偿休假
|
compensatory_time_off | number |
补充休假补充说。 |
|
津贴类型
|
allowance_type | AllowanceTypeV2 |
有关津贴类型的信息。 |
ApproverInfo
有关审批者的信息。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
成员
|
member | MemberReference |
对成员的引用。 |
时间表
成员的工作日程。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
计划 ID
|
id | string |
计划的唯一标识符。 |
|
起始日期
|
from | string |
此计划的开始日期。 |
|
创建时间
|
createdAt | string |
创建计划时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新计划时的时间戳。 |
Department
工作区中的部门。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
部门 ID
|
id | string |
部门的唯一标识符。 |
|
Name
|
name | string |
部门的名称。 |
|
创建时间
|
createdAt | string |
创建部门时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新部门时的时间戳。 |
LeaveType
工作区中的保留类型。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
保留类型 ID
|
id | string |
离开类型的唯一标识符。 |
|
Name
|
name | string |
离开类型的名称。 |
|
离开单位
|
leave_unit | string |
此离开类型的单位。 |
|
颜色
|
color | string |
此离开类型的颜色代码。 |
|
图标
|
icon | string |
此离开类型的图标。 |
|
创建时间
|
createdAt | string |
创建离开类型时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新离开类型时的时间戳。 |
请求
休假请求。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
请求编号
|
id | string |
请求的唯一标识符。 |
|
创建时间
|
createdAt | string |
创建请求时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新请求时的时间戳。 |
|
开始日期
|
start | string |
请求的开始日期。 |
|
开始时间
|
start_at | string |
休假开始的时间。 |
|
结束日期
|
end | string |
请求的结束日期。 |
|
结束时间
|
end_at | string |
休假结束的一天中的时间。 |
|
状态
|
status | string |
请求的当前状态。 |
|
原因
|
reason | string |
休假请求的原因。 |
|
持续时间
|
duration | number |
休假持续时间。 |
|
工作日工期
|
workday_absence_duration | number |
工作日中的持续时间。 |
|
离开单位
|
leave_unit | string |
此休假单位。 |
|
成员
|
requester_member | MemberReference |
对成员的引用。 |
|
休假类型
|
leave_type | LeaveTypeV2 |
有关离开类型的信息。 |
|
审批者
|
request_approvers | array of RequestApproverV2 |
此请求的审批者列表。 |
PublicHolidayCalendar
公共假日日历。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
日历 ID
|
id | string |
日历的唯一标识符。 |
|
Name
|
name | string |
公共假日日历的名称。 |
|
国家
|
country | string |
公共假日的国家/ 地区。 |
|
创建时间
|
createdAt | string |
创建日历时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新日历时的时间戳。 |
PublicHolidayCalendarDetail
包含假日的详细公共假日日历。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
日历 ID
|
id | string |
日历的唯一标识符。 |
|
Name
|
name | string |
公共假日日历的名称。 |
|
国家
|
country | string |
公共假日的国家/ 地区。 |
|
假期
|
holidays | array of PublicHoliday |
此日历中的假日列表。 |
PublicHoliday
公共假日。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
假日 ID
|
id | string |
假日的唯一标识符。 |
|
Name
|
name | string |
假日的名称。 |
|
日期
|
date | string |
假日日期。 |
|
持续时间
|
duration | number |
假期的持续时间（半天为 0.5，整日为 1）。 |
工作空间
工作区设置和配置。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
工作区 ID
|
id | string |
工作区的唯一标识符。 |
|
Name
|
name | string |
工作区的名称。 |
|
创建时间
|
createdAt | string |
创建工作区时的时间戳。 |
|
已更新时间
|
updatedAt | string |
上次更新工作区时的时间戳。 |
休假
缺席条目。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
缺席 ID
|
id | string |
缺失的唯一标识符。 |
|
日期
|
date | string |
缺席日期。 |
|
持续时间
|
duration | number |
缺席的持续时间。 |
|
成员
|
member | MemberReference |
对成员的引用。 |
|
休假类型
|
leave_type | LeaveTypeV2 |
有关离开类型的信息。 |
|
请求编号
|
request_id | string |
关联的休假请求的 ID。 |
字符串
这是基本数据类型“string”。