API интерфейстерін қолдану арқылы жұмыс уақытының күнтізбелерін өңдеу
Ұйымдар көбінесе өз ресурстарының күнтізбелерінде жұмыс уақытын бағдарламалық түрде жасау, өңдеу немесе жою қажет болады. Күнтізбелерде жұмыс уақыты жоспарланған кезде ресурстардың қолжетімділігін анықтайтын жұмыс уақыты, демалыс күндері және үзілістер көрсетіледі. Бұл ресурстар белгілі бір уақыт белдеулерінде жоспарлануы керек, қызмет етпейтін күндерді ескеруі немесе ескермеуі мүмкін және сондай-ақ өзгермелі сыйымдылыққа ие болуы мүмкін. Field Service қолданбасында жұмыс уақытын анықтау туралы ақпарат алу үшін Брондалатын ресурсқа жұмыс уақытын қосу бөліміне өтіңіз.
Field Service бағдарламасын пайдаланудан басқа, таңдалған жазба түрлері үшін күнтізбе ережелерін өзгерту үшін келесі API интерфейстерін пайдалануға болады:
- Save Calendar API (
msdyn_SaveCalendar) сұрау ретінде жіберілген енгізулер негізінде таңдалған нысанда күнтізбе жазбаларын жасайды немесе жаңартады. - Күнтізбені жою API (
msdyn_DeleteCalendar) сұрау ретінде жіберілген енгізулер негізінде таңдалған нысандағы күнтізбенің барлық ішкі күнтізбе ережелерін жойды. - Күнтізбені сақтау/жою API V2 (msdyn_SaveCalendar/msdyn_DeleteCalendar, UseV2 өту жалауы) қабаттасатын ережелердің логикасын өзгерту арқылы бір уақытта бірнеше жұмыс сағатының қайталануына мүмкіндік береді. Қосымша ақпарат алу үшін Қайталанатын ережелер болса не болады? бөлімін қараңыз.
Бұл мақалада әрбір API кірісі (сұранысы) және шығысы (жауап) және мысалдармен олардың қолданылуы туралы мәліметтер бар.
Алғышарттар
- 9.2.21055 немесе одан жоғары платформа нұсқасы 3.12.45.7 әмбебап ресурстарды жоспарлау нұсқасымен.
- Төмендегі жазба түрлерінің бірін пайдалану:
- Тапсыруға болатын ресурс (bookableresource)
- Ресурс талабы (msdyn_resourcerequirement)
- Жұмыс уақыты үлгісі (msdyn_workhourtemplate)
- Жоба (msdyn_project)
Күнтізбе оқиғасының түрлері
Күнтізбені жасағанда, жұмыс сағатының түрі қанша рет болатынын анықтайсыз—бір рет, күні бойы, апта сайын немесе күнде немесе реттелетін қайталануды жасай аласыз. . Осы күнтізбе оқиғалары туралы қосымша ақпарат алу үшін осы мақаланың кейінгі мысалдарына өтіңіз.
Оқиға
Жұмыс уақыты түрі нысанның күнтізбесінде бір рет кездессе, ол кездесу деп аталады.
Мысалы, 2021 жылдың 26 мамырында 5:00-ден 10:00‑ге дейін жұмыс істейтін ресурсты қарастырайық. Бұл API интерфейстер тек бір күнде басталатын және аяқталатын оқиғаның осындай түріне қолдау көрсетеді. Басқа мысал үшін, 2021 жылдың 26 мамырында 20:00-ден бастап 2021 жылдың 27 мамырында 10:00‑ге дейін жұмыс істейтін ресурсты қарастырайық. Бұл оқиғаны msdyn_SaveCalendar API бір ғана шақыруын пайдалану арқылы жасай алмайсыз; орнына екі қоңырау шалу керек.
Күні бойғы оқиға
Жұмыс уақыты түрі бір немесе бірнеше толық күн ішінде, басталу күнінің түн ортасынан (12:00) басталатын болса, бұл күн бойына болады. Күні бойғы оқиғаның максималды ұзақтығы — бес жыл.
Мысалы, ресурс 2021 жылдың 26 мамырынан бастап 2021 жылдың 30 мамырына дейін күні бойы жұмыс істейді. Бұл бес күнге созылатын күні бойғы оқиға болып табылады.
Апта сайынғы қайталану
Жұмыс уақыты түрі әр аптаның таңдалған күндерінде бір уақытта орын алса, ол апталық қайталану деп аталады.
Мысалы, ресурс әр дүйсенбі, сейсенбі және сәрсенбі күндері 5:00-ден 10:00-ге дейін жұмыс істейді.
Күнделікті қайталану
Жұмыс уақыты түрі күн сайын бір уақытта орын алса, ол күнделікті қайталану деп аталады.
Мысалы, ресурс аптаның әр күні 5:00-ден 10:00-ге дейін жұмыс істейді.
Реттелетін қайталану
Жұмыс уақыты түрі аптаның белгілі бір күндерінде белгілі бір уақытта орын алса, бірақ әр түрлі күндерде уақыт әртүрлі болса, арнаулы қайталану жасауға болады.
Мысалы, ресурс әр дүйсенбі сайын 5:00-ден 10:00-ге дейін, әр сәрсенбі сайын сағат 12:00-ден 15:00-ге дейін жұмыс істейді.
Жұмыс уақытының түрлері
Бұл API интерфейстері келесі жұмыс уақытының түрлері үшін операцияларды жасауға, жаңартуға және жоюға қолдау көрсетеді:
Жұмыс сағаттары
Жұмыс уақыты — бұл нысан жұмысты орындауға қолжетімді болатын уақыт.
Осы API интерфейстерін қолдану арқылы келесі әрекеттерді орындауға болады:
- Жұмыс уақытының оқиғасын жасау, өңдеу немесе жою.
- Жұмыс уақытының күнделікті қайталануын жасау, өңдеу немесе жою.
- Жұмыс уақытының апта сайынғы қайталануын жасау, өңдеу немесе жою.
- Жұмыс уақытының реттелетін қайталануын жасау, өңдеу немесе жою.
- Күні бойғы жұмыс уақытын жасау, өңдеу немесе жою.
- Жұмыс уақытында сыйымдылықты жасау немесе өңдеу.
- Қайталанудағы бір жұмыс уақытының оқиғасын өңдеу.
- Осы және келесі оқиғаларды қайталануда өңдеу.
- Жұмыс уақытының оқиғасын қайталануға өзгерту.
- Күнтізбе ережесінің уақыт белдеуін өзгерту.
Осы API интерфейсін қолдану арқылы келесі әрекеттерді орындау мүмкін емес:
- Қайталанудан бір жұмыс уақытының оқиғасын жою.
- 24 сағатқа созылатын, бірақ түн ортасында басталып және аяқталмайтын оқиға жасау (00:00).
- Күні бойғы қайталануды жасау, өңдеу немесе жою.
Жұмыс емес сағат
Бұл уақыт аралығында нысан белгісіз себептерге байланысты жұмыс істей алмайды.
Осы API интерфейстерін қолдану арқылы келесі әрекеттерді орындауға болады:
- Күні бойы жұмыс істемейтін сағаттарды жасаңыз немесе өңдеңіз.
- Жұмыс істемейтін сағат оқиғасын жасаңыз немесе өңдеңіз.
- Күнтізбе ережесінің уақыт белдеуін өзгерту.
Осы API интерфейстерін қолдану арқылы сіз келесі әрекеттерді орындай алмайсыз:
- Жұмыс істемейтін сағат қайталануын жасаңыз немесе өңдеңіз.
Үзілім
Бұл нысан жұмыс уақытында үзілісте болатын және жұмыс үшін қолжетімсіз болатын уақыт болып табылады. Үзіліс жұмыс уақытынсыз бола алмайды; олар күніне екі жұмыс уақыты арасында болуы керек. Үзілістер жұмыс уақытымен қабаттаса алмайды.
Осы API интерфейстерін қолдану арқылы келесі әрекеттерді орындауға болады:
- Жұмыс уақытында үзілістер жасау немесе өңдеу.
Осы API интерфейстерін қолдану арқылы сіз келесі әрекеттерді орындай алмайсыз:
- Тек жұмыс уақытының оқиғасынан немесе қайталануынан үзілістерді жойыңыз.
Демалыс күндері
Бұл уақыт аралығында нысан демалысқа байланысты жұмыс үшін қолжетімсіз болады. Демалыстың себебін көрсетуге болады.
Осы API интерфейстерін қолдану арқылы келесі әрекеттерді орындауға болады:
- Белгісі бар жұмыс уақытын жасаңыз немесе өңдеңіз.
- Күнтізбе ережесінің уақыт белдеуін өзгерту.
Осы API интерфейстерін қолдану арқылы сіз келесі әрекеттерді орындай алмайсыз:
- Демалыс уақыт қайталануын жасау немесе жою.
Қызмет етпейтін күндер
Сіз бизнестің жабылу уақытын анықтайтын бизнесті жабу нысандарын жасай аласыз. msdyn_SaveCalendar API пайдалану арқылы қосымша ObserveClosure пернесін пайдалану арқылы ұйымның бизнесті жабу уақытын бақылайтын немесе елемеуі үшін әрбір нысанды орнатуға болады. Олар осы жабылуларды бақылайтын болса, нысандар жұмыс істей алмайды.
Күнтізбені сақтау API интерфейсі
Кіріс
Сұрауда тек бір төлсипат бар —CalendarEventInfo, ол Жол түрі. Ол осы жолға ендірілген бірнеше басқа төлсипаттарды қамтиды.
Ескертпе
Келесі кестеде Түр сәтті сұрау жасау үшін күтілетін пішімді көрсетеді. Алайда бүкіл сұрау бір жол ретінде талданады.
CalendarEventInfo
| Атауы | Түрі | Міндетті | Сипаттама |
|---|---|---|---|
| EntityLogicalName | String | Иә | Бұл кілт API шақырылатын нысанды сипаттайды. Осы нысанның күнтізбесі жасалуы немесе өңделуі керек. |
| Күнтізбе идентификаторы | GUID | Иә | Бұл кілтте жоғарыда сипатталған нысанға қатысты күнтізбе идентификаторы бар. Осы нысандардың кез келгенін жасаған кезде күнтізбе жазбасы да автоматты түрде жасалады. Бұл API интерфейстері ережелер қосу немесе бұрыннан бар ережелерді өңдеу арқылы сол күнтізбе жазбасын өңдейді. |
| RulesAndRecurrences | RulesAndRecurrences | Иә | Бұл кілт массив болып табылады және әрбір элемент келесі бөлімдегі кестеде көрсетілген бірнеше төлсипаттан тұрады. Массивтің өлшемі кемінде бір болуы керек. |
| IsVaried | Boolean | No | Бұл кілт реттелетін қайталану сценарийлері үшін true деп орнатылуы керек. |
| IsEdit | Boolean | No | Бұл кілт бар ережелерді өңдеу үшін true деп орнатылуы керек. |
| TimeZoneCode | Бүтін сан | No | Бұл кілт күнтізбе ережелеріне арналған уақыт белдеуіне сәйкес келетін бүтін санды қабылдайды. Карталау үшін осы мақаланың кейінгі жағындағы Уақыт белдеуі кодтары бөліміне өтіңіз. Әдепкі мән — пайдаланушының уақыт белдеуі. |
| InnerCalendarDescription | String | No | Бұл кілт күнтізбе ережесі демалысқа арналған болса ғана қажет. Онда демалыстың себебі көрсетілуі керек. |
| ObserveClosure | Boolean | No | Бұл кілт қайталануларға арналған. Ол true күйіне орнатылса, ұйым бизнестің жабылуын бақылайды. |
| RecurrenceEndDate | Күн уақыты | No | Бұл кілт қайталануларға арналған. Онда қайталанудың аяқталу күні көрсетілген. Егер уақыт белгісі 08:00:00 немесе одан ертерек болса, қайталанудың аяқталу күні көрсетілген күннен бір күн бұрын болады. Егер уақыт белгісі 08:00:01 немесе одан кеш болса, онда күн сол күйінде сақталады. Қайталанулардың әдепкі мәні нөлге тең. Қайталанулардың әдепкі мәні 9999 жылғы 30 желтоқсан, 23:59:59 сағат, UTC. |
| RecurrenceSplit | Boolean | No | Бұл кілт қайталануларға арналған. Ол қайталанудың "Осы және келесі оқиғаларын" өңдеу үшін true деп орнатылған. |
| ResourceId | GUID | No | Бұл кілтте SystemUserId немесе ResourceId бар және тек осы қоңыраумен байланыстырылған нысан: SystemUser түріндегі тапсырыс берілетін ресурс. Бұл Қызметті басқару қойындысында OwnCalendar артықшылықтарын тексеру үшін қажет. |
| V2 пайдаланыңыз | Жалауша | No | Бұл жалаушаны өткізу жұмыс уақыты күнтізбесінің V2 нұсқасын қосады және бірнеше қайталануларға мүмкіндік беретін жақсартылған қабаттасу ережелер логикасы бар. Қосымша ақпарат алу үшін Қайталанатын ережелер болса не болады? бөлімін қараңыз. |
RulesAndRecurrences
| Аты | Түр | Талап етіледі | Сипаттама |
|---|---|---|---|
| Ережелер | Ережелер | Иә | Бұл кілт массив болып табылады және әрбір элемент келесі бөлімдегі кестеде көрсетілген бірнеше төлсипаттан тұрады. Массивтің өлшемі кемінде бір болуы керек. |
| RecurrencePattern | String | No | Бұл кілт қайталануларға арналған. Біз қазір тек мына үлгіні қолдаймыз: FREQ=WEEKLY;INTERVAL=1;BYDAY=SU,MO,TU,WE,TH,FR,SA. BYDAY аз күндерді қосу үшін өзгертуге болады; дегенмен, FREQ және INTERVAL өзгерту мүмкін емес. |
| InnerCalendarId | GUID | No | Бұл кілт өңдеуге арналған. Ереже өңделіп жатса, InnerCalendarId осы жерде өту керек. Егер InnerCalendarId өткізілмесе, API жаңа ереже жасайды, тіпті IsEdit пернесі орнатылған болса да шындыққа. |
| Әрекет | Бүтін сан | No | Бұл кілт реттелетін қайталануларға арналған. Егер реттелетін қайталану жасалса немесе өңделсе, келесі нөмірлердің бірін енгізу керек:
|
Ережелер
| Атауы | Түр | Қажетті | Сипаттамасы |
|---|---|---|---|
| StartTime | Күн уақыты | Иә | Бұл кілтте ISO пішіміндегі күн уақыты жазбасы бар. Мысалы, \"2021-05-15T12:00:00.000Z\". Уақыт бөлігі бұрын көрсетілген уақыт белдеуіндегі жұмыс уақытының басталу уақытын анықтайды. Күн бөлігі жұмыс уақытының басталу күнін анықтайды. Мұнда 2021 жылдың 15 мамыры — оқиғаның күні немесе қайталанудың басталатын күні. Үлгі BYDAY=TU,WE болса, бірақ 15 мамыр (сенбі) күн болса, API 15 мамырдан кейінгі барлық сейсенбі және сәрсенбі үшін ережелерді автоматты түрде жасайды немесе өңдейді. Бұл жағдайда ережеде күнге сәйкес келетін күн болмаса да болады. |
| EndTime | Күн уақыты | Иә | Онда ISO пішіміндегі күн-уақыт жазбасы бар. Мысалы, \"2021-05-15T12:00:00.000Z\". Уақыт бөлігі бұрын көрсетілген уақыт белдеуіндегі жұмыс уақытының аяқталу уақытын анықтайды. Күн бөлігі Бастау уақыты күн бөлігімен бірдей күнді қамтуы керек. Жалғыз ерекшеліктер:
|
| WorkHourType | Бүтін сан | Иә | Бұл кілт келесі опциялардың біріне сәйкес келетін санды қамтиды:
|
| Әсер | Бүтін сан | No | Бұл кілт нысанның сыйымдылығын анықтайды. Бұл бүтін сан болуы қажет. Әдепкі мән - 1. |
Шығыс
Бұл POST API интерфейсі таңдалған нысан үшін күнтізбе ережесі жазбаларын жасайды немесе өзгертеді. Ол сондай-ақ келесі нәтиже береді.
| Атауы | Түрі | Сипаттама |
|---|---|---|
| InnerCalendarIds | String | POST әрекетінің нәтижесі болып табылатын InnerCalendarIds GUID массиві. |
Күнтізбені жою API интерфейсі
Кіріс
| Атауы | Түрі | Міндетті | Сипаттама |
|---|---|---|---|
| EntityLogicalName | String | Иә | Бұл өріс күнтізбе ережелерін жаю керек нысанды сипаттайды. |
| InnerCalendarId | GUID | Иә | Бұл өріс жойылуы қажет InnerCalendarId идентификаторын сипаттайды. Бір ережемен байланыстырылған бірнеше InnerCalendarIds болса, мұнда кез келген бір идентификатор жеткілікті. Ішкі және сыртқы күнтізбелер туралы қосымша ақпарат: Күнтізбе нысандары |
| Күнтізбе идентификаторы | GUID | Иә | Бұл өріс нысанның CalendarId сын сипаттайды. |
| IsVaried | Boolean | No | Бұл өріс қайталануларға тән және теңшелетін қайталану ережесі жойылса yes деп орнатылады. |
| V2 пайдаланыңыз | Жалауша | No | Бұл жалаушаны өткізу жұмыс уақыты күнтізбесінің V2 нұсқасын қосады және бірнеше қайталануларға мүмкіндік беретін жақсартылған қабаттасу ережелер логикасы бар. Қосымша ақпарат алу үшін Қайталанатын ережелер болса не болады? бөлімін қараңыз. |
Шығыс
Бұл POST API интерфейсі таңдалған нысан үшін күнтізбе ережесі жазбаларын жояды. Сондай-ақ ол келесі нәтиже береді.
| Атауы | Түр | Сипаттамасы |
|---|---|---|
| InnerCalendarIds | String | POST әрекетінің нәтижесі болып табылатын InnerCalendarIds GUID массиві. |
Күнтізбе API жүктеңіз
Кіріс
Атауы: msdyn_LoadCalendars
Түрі: әрекет
Сипаттама: Берілген LoadCalendarsInput үшін күнтізбелерді қайтарады.
Атауы: msdyn_LoadCalendars.LoadCalendarsInput
Түрі: Параметр
Сипаттама: Келесі JSON пішіміндегі жол:
{
StartDate: string,
EndDate: string,
CalendarIds: string[]
}
Атауы: msdyn_LoadCalendarsResponse
Түрі: ComplexType
Сипаттама: msdyn_loadCalendars әрекетіндегі жауап бар.
Атауы: msdyn_LoadCalendarsResponse.CalendarEvents
Түрі: Меншік
Сипаттама: Келесі JSON пішіміндегі жол:
{
"calendarId": CalendarEventSlot[]
}
Бұл жерде calendarId күнтізбенің нұсқаулығын көрсететін дұрыс нұсқаулық және CalendarEventSlot келесі пішімдегі нысан болып табылады:
{
CalendarId: string,
InnerCalendarId: string,
Start: string,
End: string,
Effort: double
}
API интерфейстерін шақыру жолы
Бұл API интерфейсін браузердің көмегімен шақыруға болады.
- Осы күнтізбе өзгерістерін енгізу қажет браузерді және ұйымды ашыңыз.
- Әзірлеуші құралдарын ашыңыз ( ішінде+Ctrl+Shift I Microsoft Edge таңдаңыз, F12 Google Chrome жүйесінде).
- Консольде [org-name] сөзін ұйым мәліметтерімен ауыстырғаннан кейін келесі функцияны енгізіңіз (мысалы,
http://your_org.crm.dynamics.com):
function CalendarAction(action, data) {
let req = new XMLHttpRequest();
req.open("POST", "**[org-name]**/api/data/v9.0/" + action, true);
req.setRequestHeader("OData-MaxVersion", "4.0");
req.setRequestHeader("OData-Version", "4.0");
req.setRequestHeader("Accept", "application/json");
req.setRequestHeader("Content-Type", "application/json; charset=utf-8");
req.setRequestHeader("Prefer", 'odata.include-annotations="*"');
req.onreadystatechange = function () {
if (this.readyState === 4) {
req.onreadystatechange = null;
if(this.status == 200) {
console.log(JSON.parse(this.response));
} else {
console.error(JSON.parse(this.response));
}
}
};
req.send(JSON.stringify(data));
}
- Бұл функция анықталғаннан кейін оны API интерфейсін пайдалану арқылы күнтізбелерді жасау, өңдеу немесе жою үшін шақыруға болады. Күнтізбені сақтау үшін келесі қоңырауды енгізіңіз:
CalendarAction("msdyn_SaveCalendar",{
"CalendarEventInfo":"{
\"CalendarId\":\"df0857c4-50f5-4576-8e89-f236670ad2d5\",
\"EntityLogicalName\":\"bookableresource\",
\"TimeZoneCode\":92,\"StartDate\":\"2021-04-25T00:00:00.000Z\",
\"IsVaried\":false,
\"RulesAndRecurrences\":[{
\"Rules\":[{
\"StartTime\":\"2021-04-25T08:00:00.000Z\",
\"EndTime\":\"2021-04-25T17:00:00.000Z\",
\"Duration\":540,
\"Effort\":1
}]
}]
}"
})
Күнтізбені жою үшін келесі қоңырауды енгізіңіз:
CalendarAction("msdyn_DeleteCalendar", {
"CalendarEventInfo":"{
\"CalendarId\":\"8390358c-77d0-430f-b176-f27adadac8eb\",
\"EntityLogicalName\":\"bookableresource\",
\"InnerCalendarId\":\"cf508c2c-5c55-485c-be1e-d2ebcb385441\"
}"
})
Сіздің қажеттіліктеріңізге байланысты әртүрлі қоңырау мысалдары үшін келесі бөлімді қараңыз. қадам 3 ішіндегі функция шақыруының action сын msdyn_SaveCalendar немесе msdyn_DeleteCalendar деп ауыстырыңыз және data тиісті CalendarEventInfo-мен ауыстырыңыз.
Сондай-ақ Power Automate әрекетке msdyn_SaveCalendar шақыру үшін келесі скриншотты қараңыз: 
API интерфейсін пайдаланудың мысал сценарийлері
Осы API интерфейстерін қолдануға болатын сценарийлерді қарастырайық.
Боб пен Тим — Вашингтон штатының Белвью қаласындағы Contoso Enterprises компаниясы жүк көлігінің жүргізушілері. Олардың диспетчері Дебби олардың жұмыс уақытының күнтізбелеріне өзгерістер енгізуге жауапты. Дебби бұл өзгерістерді msdyn_SaveCalendar және msdyn_DeleteCalendar API пайдалану арқылы жасайды.
Жұмыс уақыты оқиғасын жасау.
Боб 2021 жылдың 15 мамырында 9:00-ден 17:00-ге дейін сәлемдемелерді жеткізу үшін жолда болады. Дебби msdyn_SaveCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-15T09:00:00.000Z\",\"EndTime\":\"2021-05-15T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}]}]}"
}
Жауап
{
"InnerCalendarIds": "[\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақыты оқиғасын өңдеу.
Содан кейін Бобтың кестесі 2021 жылы 15 мамырда сағат 10:00-де басталатын болып өзгереді. Дебби msdyn_SaveCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"IsEdit\":\"true\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-15T10:00:00.000Z\",\"EndTime\":\"2021-05-15T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}], \"InnerCalendarId\":\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақыты оқиғасын жою.
Отбасылық төтенше жағдай туындады және Боб жұмыс күнінен бас тартуы керек. Дебби msdyn_DeleteCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"InnerCalendarId\":\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"}"
}
Жауап
{
"InnerCalendarIds": "[\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақытының күнделікті қайталануын жасау
2021 жылдың 20 мамырынан бастап Боб Контосомен апта бойы таңғы сағат 8:00-ден 17:00-ге дейін жұмыс істеуді шешеді және 2021 жылдың 15 шілдесінде ол жерде жұмысын тоқтатады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RecurrenceEndDate\":\"2021-07-15T00:00:00.000Z\",\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-20T08:00:00.000Z\",\"EndTime\":\"2021-05-20T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=SU,MO,TU,WE,TH,FR,SA\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"20f6cfa7-cfbe-eb11-a81d-000d3a6e4359\"]"
}
Сыйымдылығы арттырылған жұмыс уақытының күнделікті қайталануын өңдеу
Боб үзіліс алу үшін 2021 жылдың 15 маусымынан бастап бүкіл апта бойы жұмысын тоқтатуға шешім қабылдады. Осы уақытқа дейін Боб бұрын келісілгендей апталық кестені жалғастырады. Дебби бұл өзгерістерді msdyn_SaveCalendar API арқылы жасайды.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RecurrenceEndDate\":\"2021-06-15T00:00:00.000Z\",\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-20T08:00:00.000Z\",\"EndTime\":\"2021-05-20T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"InnerCalendarId\":\"20f6cfa7-cfbe-eb11-a81d-000d3a6e4359\",\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=SU,MO,TU,WE,TH,FR,SA\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"867a2461-cdbe-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақытының апта сайынғы қайталануын жасау
2021 жылдың 16 маусымынан бастап Боб сәрсенбі және жұма күндері таңғы 8:00-ден 17:00-ге дейін жұмыс істейді және түскі ас үшін 12:00-ден 12:30-ға дейін үзіліс жасайды. Дебби msdyn_SaveCalendar API пайдаланады, бірақ қате жібереді және үзілісті 12:00-ден 13:00-ге дейін жоспарлайды.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-06-16T08:00:00.000Z\",\"EndTime\":\"2021-06-16T12:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}, {\"StartTime\":\"2021-06-16T12:00:00.000Z\",\"EndTime\":\"2021-06-16T13:00:00.000Z\",\"Effort\":null,\"WorkHourType\":1}, {\"StartTime\":\"2021-06-16T13:00:00.000Z\",\"EndTime\":\"2021-06-16T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=WE,TH,FR\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"1f894441-d0be-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақытының апта сайынғы қайталануынан үзілісті өңдеу
Содан кейін Дебби қатені түзетеді және msdyn_SaveCalendar API арқылы үзіліс уақытын 12:00-ден 12:30-ға дейін өзгертеді.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"IsEdit\":\"true\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-06-15T08:00:00.000Z\",\"EndTime\":\"2021-06-15T12:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}, {\"StartTime\":\"2021-06-15T12:00:00.000Z\",\"EndTime\":\"2021-06-15T12:30:00.000Z\",\"Effort\":null,\"WorkHourType\":1}, {\"StartTime\":\"2021-06-15T12:30:00.000Z\",\"EndTime\":\"2021-06-15T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"InnerCalendarId\":\"1f894441-d0be-eb11-a81d-000d3a6e4359\",\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=WE,TH,FR\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"1f894441-d0be-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақытының реттелетін қайталануын жасау
Тим Contoso компаниясында дүйсенбі күні 8:00-ден 17:00-ге дейін, сәрсенбі күні 11:00-ден 15:00-ге дейін жұмыс істейді. Тим Contoso компаниясында 2021 жылдың 16 мамырында жұмыс істей бастады. Дебби Тимнің жұмыс уақытын жасау үшін msdyn_SaveCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"a68245c9-ba2e-4496-9c18-3bee75fda396\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"IsVaried\":true,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-16T08:00:00.000Z\",\"EndTime\":\"2021-05-16T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"Action\":1,\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=MO\"},{\"Rules\":[{\"StartTime\":\"2021-05-16T11:00:00.000Z\",\"EndTime\":\"2021-05-16T15:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"Action\":1,\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=WE\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"9fb8c199-d1be-eb11-a81d-000d3a6e4359\", \"a2b8c199-d1be-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақытының реттелетін қайталануын өңдеу
Содан кейін Тимнің кестесі сәрсенбі күні сағат 17:00-ден 20:00-ге дейін және бейсенбі күні 10:00-ден 12:00-ге дейін жұмыс уақытына өзгереді. Дүйсенбі Тимнің кестесінен алынып тасталды. Дебби бұған қол жеткізу үшін msdyn_SaveCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"a68245c9-ba2e-4496-9c18-3bee75fda396\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"IsVaried\":true,\"IsEdit\":true,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-16T08:00:00.000Z\",\"EndTime\":\"2021-05-16T17:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"Action\":2,\"InnerCalendarId\":\"9fb8c199-d1be-eb11-a81d-000d3a6e4359\",\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=MO\"},{\"Rules\":[{\"StartTime\":\"2021-05-16T17:00:00.000Z\",\"EndTime\":\"2021-05-16T20:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"Action\":3,\"InnerCalendarId\":\"a2b8c199-d1be-eb11-a81d-000d3a6e4359\",\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=WE\"}, {\"Rules\":[{\"StartTime\":\"2021-05-16T10:00:00.000Z\",\"EndTime\":\"2021-05-16T12:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}],\"Action\":1,\"InnerCalendarId\":null,\"RecurrencePattern\":\"FREQ=WEEKLY;INTERVAL=1;BYDAY=TH\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"a2b8c199-d1be-eb11-a81d-000d3a6e4359\", \"942bda0f-d3be-eb11-a81d-000d3a6e4359\"]"
}
Қайталанудағы жұмыс уақытының оқиғасын өңдеу
2021 жылы 26 мамырда Тим тек 13.00-ден 19.00-ге дейін жұмыс істей алады. Дебби мұнда msdyn_SaveCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"a68245c9-ba2e-4496-9c18-3bee75fda396\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-26T13:00:00.000Z\",\"EndTime\":\"2021-05-26T19:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}], \"InnerCalendarId\":\"a2b8c199-d1be-eb11-a81d-000d3a6e4359\"}]}"
}
Жауап
{
"InnerCalendarIds": "[\"a2b8c199-d1be-eb11-a81d-000d3a6e4359\"]"
}
Жұмыс уақытының реттелетін қайталануын жою
Тим компаниядан кетуге шешім қабылдады және олардың барлық кестесін жоюға мәжбүр болды. Дебби мұнда msdyn_DeleteCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"a68245c9-ba2e-4496-9c18-3bee75fda396\",\"EntityLogicalName\":\"bookableresource\",\"InnerCalendarId\":\"34d2210c-9fb6-eb11-a820-000d3afb1dba\",\"IsVaried\":true}"
}
Жауап
{
"InnerCalendarIds": "[\"a2b8c199-d1be-eb11-a81d-000d3a6e4359\", \"942bda0f-d3be-eb11-a81d-000d3a6e4359\"]"
}
Демалыс күн жасау
Тим 2021 жылдың 9 маусымынан бастап отбасылық сапар үшін үш күн демалыс алады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"a68245c9-ba2e-4496-9c18-3bee75fda396\",\"InnerCalendarDescription\":\"Family Vacation\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-06-15T00:00:00.000Z\",\"EndTime\":\"2021-06-17T00:00:00.000Z\",\"Effort\":1,\"WorkHourType\":3}]}]}"
}
Жауап
{
"InnerCalendarIds": "[\"266c434e-d5be-eb11-a81d-000d3a6e4359\"]"
}
Күні бойғы жұмыс уақытын жасау
Тимде 2021 жылдың 20 мамырынан бастап 72 сағаттық ауысым бар. Дебби Тимнің жұмыс уақытын жасау үшін msdyn_SaveCalendar API пайдаланады.
Сұрау
{
"CalendarEventInfo": "{\"CalendarId\":\"a68245c9-ba2e-4496-9c18-3bee75fda396\",\"EntityLogicalName\":\"bookableresource\",\"TimeZoneCode\":5,\"RulesAndRecurrences\":[{\"Rules\":[{\"StartTime\":\"2021-05-20T00:00:00.000Z\",\"EndTime\":\"2021-05-22T00:00:00.000Z\",\"Effort\":1,\"WorkHourType\":0}]}]}"
}
Жауап
{
"InnerCalendarIds": "[\"6e160a8e-d5be-eb11-a81d-000d3a6e4359\"]"
}
ЖҚС
Мен «Бастау уақыты аяқталу уақытынан үлкен немесе тең болуы мүмкін емес» деген қатені аламын.
Әртүрлі күнтізбе ережелерінің уақыт аралықтарында қабаттасулар жоқтығына көз жеткізіңіз. Бастау уақытыАяқтау уақытынан кеш емес екеніне көз жеткізу үшін күндерді тексеріңіз. Сондай-ақ уақыттың 24 сағаттық пішімге сәйкес келетіндігін тексеріңіз.
API интерфейстерін "Жұмыс уақыты үлгілері" нысанын жаңарту үшін пайдалануға болады ма?
Иә, бұл API интерфейсін ресурстық жұмыс сағаттарына қосымша ретінде жұмыс уақыты үлгілерін жасау және жаңарту үшін пайдалануға болады.
Мен қатені аламын: "Microsoft.Dynamics.UCICalendar.Plugins.SaveCalendarContract+CalendarEventInfo түріндегі нысанды сериядан шығару қатесі орын алды. Кіріс көзі дұрыс пішімделмеген.
немесе
Күтілетін "Элемент" күйі.. '' аты бар 'Мәтін', аттар кеңістігі '' кездесті."
Жолдың дұрыс талданғанына көз жеткізіңіз. Жетіспейтін жақшалар, үтірлер немесе нүктелі үтірлер болуы мүмкін.
Мен қатені аламын: «Қайталану үлгісі жарамсыз. Қолдау көрсетілетін үлгілер үшін құжаттаманы қараңыз."
Біз қазір тек осы үлгіні қолдаймыз: FREQ=DAILY;INTERVAL=1;BYDAY=SU,MO,TU,WE,TH,FR,SA. BYDAY аз күндерді қосу үшін өзгертуге болады; дегенмен, FREQ және INTERVAL өзгерту мүмкін емес. Үлгіде бос орын жоқ екеніне көз жеткізіңіз.
Ресурстың CalendarId және InnerCalendarId ақпаратын қалай аламыз?
CalendarId ресурс атрибуттарынан шығарып алуға болады. Осы ақпаратты алу үшін осы қоңырауды жасаңыз: [org-url]/api/data/v9.1/bookableresources([bookableresourceGUID]).
Алдыңғы қоңыраудың мысалы [org-url]/api/data/v9.1/bookableresources(7bb0224b-6712-ec11-94f9-000d3a6d888e) болады.
InnerCalendarId күнтізбе атрибуттарынан шығарып алуға болады. Мына ақпаратты алу үшін мына қоңырауды жасаңыз: [org-url]/api/data/v9.1/calendars([calendar-id-from-above-call])?$expand=calendar_calendar_rules.
Алдыңғы қоңыраудың мысалы [org-url]/api/data/v9.1/calendars(02481736-1b6a-4d49-9ebd-a5bd041c1c99)?$expand=calendar_calendar_rules болып табылады.
Ережелер қайталанса не болады?
Ережеге сәйкес келетін бірнеше дәреже бар:
- 1-дәреже - күнделікті пайда болу (жұмыс істейтін/жұмыс істемейтін), және демалыс уақыты.
- Дәреже 0 - апта сайынғы қайталану (жұмыс істейтін/жұмыс істемейтін).
V2 қайталанатын ережелер
- 1 дәрежелі ережелер 0 дәрежелі ережелерге қарағанда басымдыққа ие. егер бір күнде екі ереже (әр дәреженің біреуі) болса, апта сайынғы қайталанудан гөрі күнделікті оқиға немесе үзіліс оқиғасы басымдыққа ие болады.
- Бір күн аралығында бірнеше 0 дәрежелі ережелер болған кезде:
- Уақыттар қиылыспаса, екеуі де күнтізбеде қалады.
- Уақыттар қиылыса, ең соңғы жасалған/өзгертілген ереже ресурс күнтізбесі үшін қарастырылатын ереже болып табылады. Күндер ауқымындағы барлық басқа қиылысатын ережелер жойылады. Кейбір 0 дәрежелі ережелердің кейбір күндерде қиылысулары болса, басқаларында болмаса, қиылысатын бөліктер жойылған кезде қиылыспайтын бөлімдерді сақтау үшін ереже біріктіріледі.
V2 күнтізбе әрекетінің мысалдары:
1-мысал - Қайталанатын жұмыс уақыты: қайталанатын күндер/уақыттар жоқ қайталанатын күндер
Берілген күн аралығы үшін техник таңертең, түстен кейін немесе түнгі ауысымда әртүрлі күндерде жұмыс істейді.
Берілген күндер ауқымы үшін бірінші қайталанатын күнтізбе ережесін жасаңыз. Мысалы: Дүйсенбі, сейсенбі; 1.1-4.1; 8:00-17:00 ET.
Жұмыс уақытының алдыңғы күндермен немесе уақыттармен қиылыспауын қамтамасыз ете отырып, қиылысатын күндер ауқымы үшін екінші қайталанатын күнтізбе ережесін жасаңыз. Мысалы: Қайталау Ср, Бс; 1.1-4.1; 8:00-17:00 ET немесе Қайталау дүйсенбі, сейсенбі; 1.1-4.1; 17:00-20:00 ET.
Нәтиже: екі күнтізбе ережесі де қалады және бір-бірімен қатар өмір сүреді.
2-мысал - Қайталанатын жұмыс сағаттары: барлық қайталанатын күндер және екінші ереже бірінші ережеге дейін немесе кейін басталады/аяқталатын кейбір қайталанатын күндер
Техник ескі кестенің бірнеше аптасын ауыстыратын жаңа жұмыс кестесін алады. Келісімшарт бойынша олар апта сайын бірдей күндерде жұмыс істейді.
Берілген күндер ауқымы үшін бірінші қайталанатын күнтізбе ережесін жасаңыз. Мысалы: Дүйсенбі, сейсенбі; 2.1-4.1; 8:00-17:00 ET.
Барлық күндерде қайталанатын жұмыс уақыты болатын қайталанатын күндер ауқымы үшін екінші қайталанатын күнтізбе ережесін жасаңыз. Бірінші ереженің басталу/аяқталу күнінен бұрын немесе одан кейінгі осы жаңа ереженің басталу/аяқталу күндерін таңдаңыз. Мысалы: Дүйсенбі, сейсенбі; 3.1-5.1; 13:00-20:00 ET.
Нәтиже: бірінші ереже екінші ереженің басталу/аяқталу күнін орналастыру үшін қысқартылады. Мысалы: Дүйсенбі, сейсенбі; 2.1-2.28; 8am-5pm ET AND Қайталау дүйсенбі, сейсенбі; 3.1-5.1; 13:00-20:00 ET.
3-мысал - Қайталанатын жұмыс сағаттары: барлық қайталанатын күндер, кейбір қайталанатын күндер/уақыттар
Техникалық қызметкер 2 айлық мерзімге келісімшарт бойынша жұмыс істейді. Олар бірнеше күн қосымша жұмыс істеуге келісті. Олар сейсенбідегі жұмыс уақытын ерте/кешірек уақытқа ауыстырғысы келеді.
Берілген күндер ауқымы үшін бірнеше қайталанатын күнтізбе ережелерін жасаңыз. Мысалы: Дүйсенбі, сейсенбі; 2.1-4.1; 8:00-12pm ET AND Қайталау сей, сәрсенбі; 2.1-4.1, 13:00-17:00 ET.
Бірдей күндер ауқымы үшін жаңа қайталанатын күнтізбе ережесін жасаңыз. Бастапқы ережелермен ішінара сәйкес келетін күндерді/уақыттарды таңдаңыз. Мысалы: Қайталау Сейсенбі, Бейсенбі ; 2.1-4.1; 10:00-14:00 ET.
Нәтиже: Жаңа ереже қабаттасулар бар жерде ескінің үстінен жазады, ал қалғандарын өзгеріссіз қалдырады. Мысалы: Қайталау дүйсенбі; 2.1-4.1; 8:00-12pm ET AND Қайталау сәрсенбі; 2.1-4.1; 13:00-17:00 ET AND Қайталау Сейсенбі, Бейсенбі ; 2.1-4.1; 10:00-14:00 ET.
4-мысал - Қайталанатын жұмыс сағаттары: ескі ережеде қамтылған жаңа ереже күндері, кейбір қайталанатын күндер/уақыттар
Техник апта сайын дүйсенбіден жұмаға дейін таңғы 8-ден 17-ге дейін жұмыс істейді. Небәрі екі апта бойы олар әр дүйсенбіден сәрсенбіге дейін әр түрлі жұмыс уақыты таңғы 6.00-ден 18.00-ге дейін арнайы төтенше жобамен айналысады.
Берілген күндер ауқымы үшін бірінші қайталанатын күнтізбе ережесін жасаңыз. Мысалы: Қайталау дүйсенбі, сейсенбі, сәрсенбі, пс, жұма; 1.1-Аяқтау күні жоқ; 8:00-17:00 ET.
Жоғарыда көрсетілген күндер ауқымында қамтылған екінші қайталанатын күнтізбе ережесін жасаңыз, кейбір күндерде қабаттасатын жұмыс уақытын таңдаңыз. Мысалы: Қайталау дүйсенбі, сейсенбі, сәрсенбі; 5.1-5.14; 6:00-18:00 ET.
Нәтиже: Осы жаттығудың соңында күнтізбеде төрт қайталанатын ереже болуы керек:
- бірінші ережені екінші ереженің басталу күніне дейін қысқартыңыз
- екінші күнтізбелік ереже
- бірінші ережеге ұқсас, бірақ қайталанбайтын күндер үшін екінші ереженің күндерімен жаңа ереже жасаңыз
- аяқталу күні жоқ екінші ереженің аяқталу күнінен бастау үшін бірінші ережені қысқартыңыз
Мысалы: Repeat Mon, Tue, Wed, Thu, Fri; 1,1–4,30; 8:00-17:00 ET AND Қайталау дүйсенбі, сейсенбі, сәрсенбі; 5.1-5.14; 6.00-18.00 ET ЖӘНЕ Қайталау Бсен, Жұма, 5.1-5.14; 8:00-17:00 ET ЖӘНЕ Қайталау дүйсенбі, сейсенбі, сәрсенбі, бейсенбі, жұма; 5.15 – Аяқталу күні жоқ; 8:00-17:00 ET
5-мысал - Қайталанбайтын жұмыс уақыты (болу, 1-разряд ережесі)
Техникте бір күннің барлық басқа жұмыс уақыты үлгілерінен басым болатын бірнеше топтық бірігу күндері болады.
Берілген күндер ауқымы үшін қайталанатын күнтізбе ережесін жасаңыз. Мысалы: Қайталау дүйсенбі, сейсенбі, сәрсенбі, пс, жұма; 1.1-Аяқтау күні жоқ; 8:00-17:00 ET.
Жоғарыда көрсетілген күндер ауқымында қайталанбайтын күнтізбе ережесін жасаңыз. Кейбір күндері сәйкес келетін жұмыс уақытын таңдаңыз. Мысалы: Қайталанбау; 6,21; 7:00-13pm ET.
Нәтиже: Күнтізбеде жаттығудың соңына қарай 1 қайталанбайтын ереже (оқиға) болуы керек. Қайталанбау ережесі бүкіл күн үшін қайталанатын қайталанатын оқиғаны жоққа шығарады. Мысалы: Repeat Mon, Tue, Wed, Thu, Fri; 1.1-Аяқтау күні жоқ6.21 қоспағанда; қайталанбау; 6,21; 7:00-13:00 ET.
V1 қабаттасатын ережелер
- 1 дәрежелі ережелер 0 дәрежелі ережелерге қарағанда басымдыққа ие. Сонымен, егер бір күнде екі ереже (әр дәреженің біреуі) болса, апта сайынғы қайталанудан гөрі күнделікті оқиға немесе үзіліс оқиғасы басымдыққа ие болады.
- Егер бір дәреженің екі ережесі болса, соңғы рет жасалған/өзгертілген ереже ресурс күнтізбесінде қарастырылатын болады.
- Күні бойғы оқиғалар 1-ші дәрежеге сәйкес келеді, сондықтан сіз жұмыс уақытын қосу және оларды есепке алу үшін оны апта сайынғы қайталануға өзгертуді қарастырғыңыз келуі мүмкін.
- Егер жұмыс уақыты бар болса және онымен қабаттасатын үзіліс пайда болса, ережелер демалыс уақытының сақталуын қамтамасыз ететін етіп бөлінеді, ал қалған кез келген жұмыс уақыты сол күйінде қалады. Мысалы, егер 21 қыркүйекте 8:00-ден 17:00-ге дейін жұмыс уақыты болса және 21 қыркүйекте 15:00-ден 19:00-ге дейін үзіліс уақыты қосылса, бұл жұмыс уақыты 20:00-ден 15:00-ге дейін және демалыс 15:00-ден 19:00 -ге дейін болып шешіледі. Алайда, егер ережелер уақыт аралықтарына қарамастан қарама-қарсы ретпен жасалса (алдымен демалыс, содан кейін жұмыс уақыты жасалса), тек жұмыс уақыты қайта таңдалады. Демалыс уақыты қайта есептелетін еді.
Уақыт белдеуінің кодтары
| Санау | Уақыт белдеуі |
|---|---|
| 0 | (GMT-12:00) Халықаралық күн сызығының батысы |
| 1-көше | (GMT+13:00) Самоа |
| 2-көше | (GMT-10:00) Гавайи |
| 3-көше | (GMT-09:00) Аляска |
| 4 | (GMT-08:00) Тынық мұхиты уақыты (АҚШ және Канада) |
| 5 | (GMT-08:00) Баджа Калифорния |
| 6 | (GMT-11:00) Реттелген әмбебап уақыт-11 |
| 7 | (GMT-10:00) Алеут аралдары |
| 8 | (GMT-09:30) Маракиз аралдары |
| 9 | (GMT-09:00) Әлемдік координацияланған уақыт-09 |
| 10 | (GMT-07:00) Тау уақыты (АҚШ және Канада) |
| 11 | (GMT-08:00) Әлемдік координацияланған уақыт-08 |
| 12 | (GMT-07:00) Чихуахуа, Ла-Пас, Мазатлан |
| 15 | (GMT-07:00) Аризона |
| 20 | (GMT-06:00) Орталық уақыт (АҚШ және Канада) |
| 25 | (GMT-06:00) Саскачеван |
| 29 | (GMT-06:00) Гвадалахара, Мехико, Монтеррей |
| 33 | (GMT-06:00) Орталық Америка |
| 34 | (GMT-06:00) Пасха аралы |
| 35 | (GMT-05:00) Шығыс уақыты (АҚШ және Канада) |
| 40 | (GMT-05:00) Индиана (шығыс) |
| 43 | (GMT-05:00) Гаити |
| 44 | (GMT-05:00) Гавана |
| 45 | (GMT-05:00) Богота, Лима, Кито, Рио-Бранко |
| 47 | (GMT-04:00) Каракас |
| 50 | (GMT-04:00) Атлант уақыты (Канада) |
| 51 | (GMT-05:00) Теркс және Кайкос |
| 55 | (GMT-04:00) Джорджтаун, Ла-Пас, Сан-Хуан |
| 56 | (GMT-04:00) Сантьяго |
| 58 | (GMT-04:00) Куяба |
| 59 | (GMT-04:00) Асунсьон |
| 60 | (GMT-03:30) Ньюфаундленд |
| 65 | (GMT-03:00) Бразилия |
| 69 | (GMT-03:00) Буэнос-Айрес |
| 70 | (GMT-03:00) Кайенна, Форталеза |
| 71 | (GMT-03:00) Сальвадор |
| 72 | (GMT-03:00) Сен-Пьер және Микелон |
| 73 | (GMT-03:00) Гренландия |
| 74 | (GMT-03:00) Mонтевидео |
| 75 | (GMT-02:00) Орталық Атлантикалық |
| 76 | (GMT-02:00) Әлемдік координацияланған уақыт-02 |
| 77 | (GMT-03:00) Арагуаяна |
| 80 | (GMT-01:00) Азор аралдары |
| 83 | (GMT-01:00) Кабо-Верде аралы |
| 84 | (GMT+01:00) Касабланка |
| 85 | (GMT+00:00) Дублин, Эдинбург, Лиссабон, Лондон |
| 90 | (GMT+00:00) Монровия, Рейкьявик |
| 92 | (GMT) Әмбебап ғаламдық уақыт |
| 95 | (GMT+01:00) Белград, Братислава, Будапешт, Любляна, Прага |
| 100 | (GMT+01:00) Сараево, Скопье, Варшава, Загреб |
| 105 | (GMT+01:00) Брюссель, Копенгаген, Мадрид, Париж |
| 110 | (GMT+01:00) Aмстердам, Берлин, Берн, Рим, Стокгольм, Вена |
| 113 | (GMT+01:00) Батыс Орталық Африка |
| 115 | (GMT+02:00) Кишинев |
| 120 | (GMT+02:00) Каир |
| 125 | (GMT+02:00) Хельсинки, Kиев, Рига, София, Таллин, Вильнюс |
| 129 | (GMT+02:00) Амман |
| 130 | (GMT+02:00) Афин, Бухарест |
| 131 | (GMT+02:00) Бейрут |
| 133 | (GMT+02:00) Дамаск |
| 134 | (GMT+03:00) Стамбул |
| 135 | (GMT+02:00) Иерусалим |
| 140 | (GMT+02:00) Хараре, Претория |
| 141 | (GMT+02:00) Виндхук |
| 142 | (GMT+02:00) Газа, Хеврон |
| 145 | (GMT+03:00) Мәскеу, Санкт-Петербург |
| 150 | (GMT+03:00) Кувейт, Эр-Рияд |
| 151 | (GMT+03:00) Минск |
| 155 | (GMT+03:00) Найроби |
| 158 | (GMT+03:00) Бағдад |
| 159 | (GMT+02:00) Калининград |
| 160 | (GMT+03:30) Тегеран |
| 165 | (GMT+04:00) Абу-Даби, Мускат |
| 169 | (GMT+04:00) Баку |
| 170 | (GMT+04:00) Ереван |
| 172 | (GMT+04:00) Порт-Луи |
| 173 | (GMT+04:00) Tбилиси |
| 174 | (GMT+04:00) Ижевск, Самара |
| 175 | (GMT+04:30) Kабул |
| 176 | (GMT+04:00) Астрахан, Ульяновск |
| 180 | (GMT+05:00) Екатеринбург |
| 184 | (GMT+05:00) Исламабад, Карачи |
| 185 | (GMT+05:00) Taшкент |
| 190 | (GMT+05:30) Ченнай, Колката, Мумбай, Нью-Дели |
| 193 | (GMT+05:45) Катманду |
| 195 | (GMT+06:00) Aстана |
| 196 | (GMT+06:00) Дакка |
| 197 | (GMT+06:00) Омск |
| 200 | (GMT+05:30) Шри-Джаяварденепура |
| 201 | (GMT+07:00) Новосибирск |
| 203 | (GMT+06:30) Янгон (Рангун) |
| 205 | (GMT+07:00) Бангкок, Ханой, Джакарта |
| 207 | (GMT+07:00) Красноярск |
| 208 | (GMT+07:00) Барнаул, Горно-Алтайск |
| 209 | (GMT+07:00) Ховд |
| 210 | (GMT+08:00) Пекин, Чунцин, Сянган, Үрімші |
| 211 | (GMT+07:00) Томск |
| 215 | (GMT+08:00) Куала-Лумпур, Сингапур |
| 220 | (GMT+08:00) Тайпей |
| 225 | (GMT+08:00) Перт |
| 227 | (GMT+08:00) Иркутск |
| 228 | (GMT+08:00) Улаанбаатар |
| 229 | (GMT+09:00) Пхеньян |
| 230 | (GMT+09:00) Сеул |
| 231 | (GMT+08:45) Евкла |
| 235 | (GMT+09:00) Осака, Саппоро, Токио |
| 240 | (GMT+09:00) Якутск |
| 241 | (GMT+09:00) Чита |
| 245 | (GMT+09:30) Дарвин |
| 250 | (GMT+09:30) Аделаида |
| 255 | (GMT+10:00) Канберра, Мельбурн, Сидней |
| 260 | (GMT+10:00) Брисбейн |
| 265 | (GMT+10:00) Хобарт |
| 270 | (GMT+10:00) Владивосток |
| 274 | (GMT+10:30) Лорд-Хау аралы |
| 275 | (GMT+10:00) Гуам, Порт-Морсби |
| 276 | (GMT+11:00) Бугенвиль аралы |
| 277 | (GMT+11:00) Норфолк аралы |
| 278 | (GMT+11:00) Сахалин |
| 279 | (GMT+11:00) Чокурдах |
| 280 | (GMT+11:00) Соломон аралдары, Жаңа Каледония |
| 281 | (GMT+11:00) Магадан |
| 284 | (GMT+12:00) Әлемдік координацияланған уақыт+12 |
| 285 | (GMT+12:00) Фиджи |
| 290 | (GMT+12:00) Окленд, Веллингтон |
| 295 | (GMT+12:00) Анадырь, Петропавловск-Камчатский |
| 299 | (GMT+12:45) Чатем аралдары |
| 300 | (GMT+13:00) Нукуалофа |
| 301 | (GMT-05:00) Четумаль |
| 302 | (UTC+02:00) Хартум |
| 303 | (GMT-03:00) Пунта-Аренас |
| 304 | (GMT+04:00) Волгоград |
| 305 | (GMT-07:00) Юкон |