TimesOff

Logs time-off entries requested by users through the Microsoft Teams Shifts interface, with reason codes and date ranges.

テーブル固有の情報

Select

チームからすべてを取得するか、TeamId を指定することでTimesOff テーブルをクエリします。デフォルトでは、自身がメンバーであるグループのチームの休暇のみ返されます。組織の全グループのチームから休暇を取得するには、IncludeAllGroups プロパティをtrue に設定してください。本製品は Microsoft Teams API を使用して、以下のカラムと演算子で作成されたWHERE 句条件を処理します。その他のフィルタはクライアントサイドで本製品内部で処理されます。

TeamId は、IN および'=' 演算子をサポートします。
Id は、'=' 演算子をサポートします。

例えば、次のクエリはサーバーサイドで処理されます。

SELECT * FROM TimesOff WHERE TeamId IN ('da838338-4e77-4c05-82a6-79d9f0274511', 'da834568-4df7-4c05-82a6-79d9f0274515')
SELECT * FROM TimesOff WHERE TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Insert

チームスケジュールに休暇を挿入するには、TeamId とこの休暇が付与される人のUserId に加えて、休暇のstartDateTime、endDateTime およびtimeOff_ReasonId を含むDraftTimeOff またはSharedTimeOff の情報の、どちらかを含む必要があります。

INSERT INTO TimesOff (TeamId, UserId, sharedTimeOff_startDateTime, sharedTimeOff_endDateTime, SharedTimeOff_TimeOffReasonId) VALUES ('da838338-4e77-4c05-82a6-79d9f0274511', '0409f710-2aa9-4f05-8944-ef382160f1d1', '2019-03-11T07:00:00Z', '2019-03-12T07:00:00Z', 'TOR_97de5f58-462b-4bde-8a95-038b4073bffb')

Update

休暇のレコードを更新するには、WHERE 句にId とTeamId が必要です。TeamId、Id、CreatedDateTime 以外のすべてのフィールドを更新できます。

UPDATE Timesoff SET draftTimeOff_timeOffReasonId = 'TOR_97de5f58-462b-4bde-8a95-038b4073bffb' WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Delete

休暇のレコードを削除するには、WHERE 句にId とTeamId が必要です。

DELETE FROM TimesOff WHERE Id = 'SHFT_dd50b99a-e2d8-44ad-a445-53ad58bfc37b' AND TeamId = 'da838338-4e77-4c05-82a6-79d9f0274511'

Columns


Name	Type	ReadOnly	Description
Id [KEY]	String	False	A unique identifier for the time off entry.
UserId	String	False	The unique identifier of the user who submitted or was assigned this time off request.
TeamId	String	False	The identifier of the Microsoft Team associated with the time off request.
CreatedDateTime	Datetime	False	The date and time when the time off request was first created.
IsStagedForDeletion	Bool	False	Indicates whether the time off entry is marked for deletion but has not yet been removed.
LastModifiedBy_application_displayName	String	False	The name of the application that most recently modified the time off entry.
LastModifiedBy_application_id	String	False	The unique application ID of the system or service that last modified the entry.
LastModifiedDateTime	Datetime	False	The date and time when the time off entry was last updated.
DraftTimeOff_timeOffReasonId	String	False	The identifier for the reason associated with the draft version of the time off request.
SharedTimeOff_timeOffReasonId	String	False	The identifier for the reason associated with the shared (published) version of the time off request.
DraftTimeOff_StartDateTime	Datetime	False	The scheduled start date and time for the draft version of the time off.
DraftTimeOff_EndDateTime	Datetime	False	The scheduled end date and time for the draft version of the time off.
SharedTimeOff_StartDateTime	Datetime	False	The scheduled start date and time for the published version of the time off.
SharedTimeOfft_EndDateTime	Datetime	False	The scheduled end date and time for the published version of the time off.