Schedules
Defines the overarching containers used in Teams Shifts for organizing shifts, time-off requests, and schedule groups.
テーブル固有の情報
Select
チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでSchedules テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのスケジュールアイテムのみ返されます。組織の全グループのチームからスケジュールを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 connector は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでconnector 内部で処理されます。
- TeamId は、'=' およびIN 演算子をサポートします。
例えば、次のクエリはサーバーサイドで処理されます。
SELECT * FROM Schedules WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'
Update
スケジュールのレコードを更新するには、WHERE 句にId とTeamId が必要です。
UPDATE Schedules SET timeZone = 'Africa/Casablanca', enabled = true WHERE Id = '4729c5e5-f923-4435-8a41-44423d42ea79' AND TeamId = '4729c5e5-f923-4435-8a41-44423d42ea79'
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | String | False |
A unique identifier representing the schedule instance within Microsoft Teams. |
| TeamId [KEY] | String | False |
The identifier of the Microsoft Team that this schedule is associated with. |
| Enabled | Bool | False |
Specifies whether the schedule is currently active and usable by the associated team. |
| OfferShiftRequestsEnabled | Bool | False |
Indicates whether team members are allowed to offer their scheduled shifts to others. |
| OpenShiftsEnabled | Bool | False |
Indicates whether open shifts are supported, allowing managers to post available shifts for pickup. |
| ProvisionStatus | String | False |
Shows the current state of schedule provisioning. Valid values include notStarted, running, completed, and failed. |
| ProvisionStatusCode | String | False |
Provides additional details explaining why the schedule provisioning could have failed. |
| SwapShiftsRequestsEnabled | Bool | False |
Indicates whether team members are permitted to request a shift swap with another member. |
| TimeClockEnabled | Bool | False |
Specifies whether the time clock feature is enabled, allowing users to clock in and out through Teams. |
| TimeOffRequestsEnabled | Bool | False |
Indicates whether team members are allowed to submit time off requests through the schedule. |
| TimeZone | String | False |
Defines the time zone for the schedule, using IANA tz database format (for example, America/New_York). |
| WorkforceIntegrationIds | String | False |
A comma-separated list of integration identifiers linked to external workforce systems that sync with this schedule. |