SchedulingGroups
Segments users into groups within a Teams schedule to streamline shift assignments and reporting.
テーブル固有の情報
Select
チームからすべてを取得するか、TeamId を'=' とIN 演算子で指定することでSchedulingGroups テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームのスケジュールグループのみ返されます。組織の全グループのチームからスケジュールグループを取得するには、IncludeAllGroups プロパティをtrue に設定してください。 connector は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドでconnector 内部で処理されます。
- TeamId は、'=' およびIN 演算子をサポートします。
- Id は、'=' 演算子をサポートします。
例えば、次のクエリはサーバーサイドで処理されます。
SELECT * FROM SchedulingGroups WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511' AND Id = 'TAG_357350ce-2fa2-498d-9967-494296509c32'
Insert
チームにスケジュールグループを挿入するには、TeamId と最低でもDisplayName、IsActive、iconType の内1つのフィールドを指定する必要があります。
INSERT INTO SchedulingGroups (TeamId, DisplayName, IsActive) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', 'Cashiers', 'true')
Update
スケジュールグループを更新するには、WHERE 句にId とTeamId が必要です。DisplayName およびIsActive フィールドは更新できます。
UPDATE SchedulingGroups SET DisplayName = 'Supervisors' WHERE Id = 'TAG_357350ce-2fa2-498d-9967-494296509c32' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'
Delete
スケジュールグループを削除するには、WHERE 句にId とTeamId が必要です。
DELETE FROM SchedulingGroups WHERE TeamId = 'acabe397-8370-4c31-aeb7-2d7ae6b8cda1' AND Id = 'TAG_101f11df-e7c0-49f2-8d5c-a9ad085c97aa'
Columns
| Name | Type | ReadOnly | Description |
| Id [KEY] | String | False |
The unique identifier for the scheduling group within the team. |
| TeamId | String | False |
The identifier of the Microsoft Team to which this scheduling group belongs. |
| CreatedDateTime | Datetime | False |
The date and time when the scheduling group was initially created. |
| LastModifiedBy_application_displayName | String | False |
The display name of the application that most recently modified the scheduling group. |
| LastModifiedBy_application_id | String | False |
The application ID of the app that last updated the scheduling group. |
| LastModifiedDateTime | Datetime | False |
The date and time when the scheduling group was last modified. |
| DisplayName | String | False |
The name displayed for the scheduling group in Microsoft Teams. |
| IsActive | Bool | False |
Indicates whether the scheduling group is currently active and available for use when creating or modifying shifts and schedules. |
| UserIds | String | False |
A comma-separated list of user IDs who are members of this scheduling group. Each ID represents a user assigned to this group. |