API का उपयोग करके कार्य घंटे कैलेंडर को संपादित करें

संगठनों को अक्सर अपने संसाधनों के कैलेंडर पर कार्यक्रमात्मक रूप से कार्य घंटे बनाने, संपादित करने या हटाने की आवश्यकता होती है. कैलेंडर, कार्य घंटे, समय समाप्ति और विराम को दिखाते हैं जो काम शेड्यूल होने पर संसाधन की उपलब्धता निर्धारित करते हैं. उन संसाधनों को विशिष्ट टाइम ज़ोन में शेड्यूल किया जाना चाहिए, जिनमें व्यवसाय के खुले होने या बंद होने को देखा जा सकता है और उनमें परिवर्तनशील क्षमता हो सकती है. Field Service ऐप में कार्य घंटे निर्धारित करने के बारे में जानकारी के लिए, बुक करने योग्य संसाधन में कार्य घंटे जोड़ें पर जाएँ.

Field Service अनुप्रयोग का उपयोग करने के अलावा, आप चयनित रिकॉर्ड प्रकारों के लिए कैलेंडर नियमों को संशोधित करने के लिए निम्न API का उपयोग कर सकते हैं:

• कैलेंडर सहेजें 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)

कैलेंडर इवेंट प्रकार

जब आप कैलेंडर बनाते हैं, तो आप यह परिभाषित करते हैं कि कार्य घंटे का प्रकार कितनी बार घटित होगा - एक बार, पूरे दिन, हर सप्ताह या हर दिन, या आप एक कस्टम पुनरावृत्ति बना सकते हैं। इन कैलेंडर ईवेंट के बारे में अधिक जानकारी के लिए, इस आलेख में बाद में दिए गए उदाहरणों पर जाएँ।

आवृत्ति

जब कोई कार्य घंटे का प्रकार इकाई के कैलेंडर में केवल एक बार आता है, तो उसे घटना कहा जाता है।

उदाहरण के लिए, 26 मई, 2021 को सुबह 5:00 बजे से सुबह 10:00 बजे तक काम करने वाले संसाधन पर विचार करें. ये API केवल इस प्रकार की उपस्थिति का समर्थन करते हैं, जो एक ही दिन में शुरू और समाप्त होती है. एक अन्य उदाहरण के लिए, 26 मई, 2021 को रात 8:00 बजे से 27 मई, 2021 को सुबह 10:00 बजे तक काम कर रहे संसाधन पर विचार करें. आप msdyn_SaveCalendar API के केवल एक कॉल का उपयोग करके यह घटना नहीं बना सकते; इसके बजाय आपको दो कॉल करने होंगे।

दिन भर की उपस्थिति

जब कोई कार्य घंटे का प्रकार प्रारंभ तिथि की मध्य रात्रि (12:00 AM) से शुरू होकर एक या अधिक पूरे दिनों के लिए होता है, तो यह एक पूरे दिन की घटना होती है। पूरे दिन की उपस्थिति की अधिकतम अवधि पांच वर्ष है.

उदाहरण के लिए, एक संसाधन 26 मई, 2021 से 30 मई, 2021 को दिन के अंत तक पूरे दिन काम करता है. यह एक पूरे दिन की उपस्थिति है जो पांच दिनों तक चलती है.

साप्ताहिक पुनरावृत्ति

जब एक कार्य घंटे का प्रकार हर सप्ताह के चयनित दिनों में एक ही समय पर होता है, तो इसे साप्ताहिक पुनरावृत्ति कहा जाता है।

उदाहरण के लिए, एक संसाधन प्रत्येक सोमवार, मंगलवार और बुधवार को सुबह 5:00 बजे से 10:00 पूर्वाह्न तक काम करता है.

दैनिक पुनरावृत्ति

जब एक कार्य घंटे का प्रकार हर दिन एक ही समय पर होता है, तो इसे दैनिक पुनरावृत्ति कहा जाता है।

उदाहरण के लिए, एक संसाधन सप्ताह के प्रत्येक दिन सुबह 5:00 बजे से 10:00 पूर्वाह्न तक काम करता है.

अभ्यास पुनरावृत्ति

जब कोई कार्य घंटे का प्रकार सप्ताह के कुछ दिनों में कुछ निश्चित समय पर होता है, लेकिन अलग-अलग दिनों में समय अलग-अलग होता है, तो आप एक कस्टम पुनरावृत्ति बना सकते हैं।

उदाहरण के लिए, एक संसाधन हर सोमवार को सुबह 5:00 बजे से 10:00 बजे तक और हर बुधवार को दोपहर 12:00 बजे से दोपहर 3:00 बजे तक काम करता है.

कार्य घंटे के प्रकार

ये API निम्न कार्य घंटे के प्रकारों के लिए संचालन बनाने, अद्यतन करने और हटाने का समर्थन करते हैं:

• कार्य के घंटे
• गैर-कार्य घंटे
• ब्रेक
• काम या अध्ययन से इतर समय
• व्यवसाय बंद करना

कार्य घंटे

कार्य करने के घंटे ऐसे समय होते हैं जिस दौरान कोई निकाय कार्य करने के लिए उपलब्ध होता है.

इन API का उपयोग करके, आप निम्न कार्य कर सकते हैं:

• कार्य करने के घंटे की उपस्थिति बनाएं, संपादित करें या हटाएं.
• कार्य करने के घंटे की दैनिक पुनरावृत्ति बनाएं, संपादित करें या हटाएं.
• कार्य करने के घंटे की साप्ताहिक पुनरावृति बनाएं, संपादित करें या हटाएं.
• कार्य करने के घंटे की कस्टम पुनरावृत्ति बनाएं, संपादित करें या हटाएं.
• पूरे दिन के कार्य करने के घंटे बनाएं, संपादित करें या हटाएं.
• कार्य करने के घंटों पर क्षमता बनाएं या संपादित करें.
• पुनरावृत्ति में एकल कार्य घंटे की उपस्थिति को संपादित करें.
• पुनरावृत्ति में यह और निम्न घटनाएँ संपादित करें।
• कार्य करने के घंटे की उपस्थिति को पुनरावृत्ति में बदलें.
• कैलेंडर नियम का समय क्षेत्र बदलें.

इस API का उपयोग करके, आप निम्न कार्य नहीं कर सकते:

• पुनरावृत्ति से एकल कार्य करने के घंटे की घटना हटाना.
• एक उपस्थिति बनाना जो 24 घंटे तक चलती है लेकिन मध्यरात्रि (12:00 AM) पर शुरू और समाप्त नहीं होती है.
• पूरे दिन की पुनरावृत्ति बनाना, संपादित करना या हटाना.

गैर-कार्य घंटे

ये ऐसे समय होते हैं जिसके दौरान निकाय अनिर्दिष्ट कारण से काम करने के लिए अनुपलब्ध होता है.

इन API का उपयोग करके, आप निम्न कार्य कर सकते हैं:

• पूरे दिन के गैर-कार्य घंटे बनाएं या संपादित करें.
• गैर-कार्य घंटे की घटना बनाएँ या संपादित करें.
• कैलेंडर नियम का समय क्षेत्र बदलें.

इन API का उपयोग करके, आप निम्न कार्य नहीं कर सकते:

• गैर-कार्य घंटे पुनरावृत्ति बनाएँ या संपादित करें.

विराम

ये कार्य दिवस में ऐसे समय होते हैं, जिसके दौरान एक निकाय विराम ले रहा होता है और काम के लिए अनुपलब्ध होता है. कार्य घंटों के बिना विराम मौजूद नहीं हो सकते; उन्हें एक दिन में दो कार्य घंटों के बीच होना होता है. विराम काम के घंटों के साथ अतिव्यापित नहीं हो सकता.

इन API का उपयोग करके, आप निम्न कार्य कर सकते हैं:

• कार्य घंटों के दौरान विराम बनाएं करें या संपादित करें.

इन API का उपयोग करके, आप निम्न कार्य नहीं कर सकते:

• कार्य घंटों की उपस्थिति या पुनरावृत्ति से केवल विराम हटाएं.

टाइम ऑफ़

ये ऐसे समय होते हैं जब एक निकाय अवकाश के कारण काम करने के लिए अनुपलब्ध होता है. समय समाप्ति का कारण बताया जा सकता है.

इन API का उपयोग करके, आप निम्न कार्य कर सकते हैं:

• एक लेबल के साथ समय समाप्ति बनाएं या संपादित करें.
• कैलेंडर नियम का समय क्षेत्र बदलें.

इन API का उपयोग करके, आप निम्न कार्य नहीं कर सकते:

• समय समाप्ति के घंटे की पुनरावृत्ति बनाएँ या संपादित करें.

व्यवसाय समापन

आप व्यवसाय बंद करने वाली इकाइयाँ बना सकते हैं जो व्यवसाय बंद होने के समय को परिभाषित करती हैं। msdyn_SaveCalendar API का उपयोग करके, आप वैकल्पिक ObserveClosure कुंजी का उपयोग करके प्रत्येक इकाई को संगठन के व्यवसाय बंद होने के समय का पालन करने या अनदेखा करने के लिए सेट कर सकते हैं। जब उन्हें इन बंदियों का पालन करने के लिए सेट किया जाता है, तो संस्थाएं काम के लिए उपलब्ध नहीं होती हैं।

कैलेंडर API सहेजें

इनपुट

अनुरोध में केवल एक विशेषता है—CalendarEventInfo, जो कि एक String प्रकार है। इसमें कई अन्य एट्रिब्यूट शामिल हैं जो सभी इस स्ट्रिंग में अंतर्निहित हैं.

नोट

निम्न तालिका में, प्रकार सफल अनुरोध करने के लिए अपेक्षित प्रारूप को दर्शाता है। हालांकि, पूरे अनुरोध की, एक स्ट्रिंग के रूप में पद व्याख्या की जाती है.

CalendarEventInfo

नाम	प्रकार	आवश्यक	विवरण
EntityLogicalName	String	हाँ	यह कुंजी उस निकाय का वर्णन करती है जिससे API को निर्देशित किया जा रहा है. इस निकाय का कैलेंडर बनाया या संपादित किया जाना है.
CalendarId	मार्गदर्शक	हाँ	इस कुंजी में ऊपर वर्णित इकाई से संबंधित कैलेंडर ID है. जब इनमें से कोई भी निकाय बनाया जाता है, तो एक कैलेंडर रिकॉर्ड भी स्वचालित रूप से बन जाता है. ये API, नियम जोड़कर या मौजूदा नियमों को संपादित करके उस कैलेंडर रिकॉर्ड को संपादित करते हैं.
RulesAndRecurrences	RulesAndRecurrences	हाँ	यह कुंजी एक सारणी है, और प्रत्येक तत्व में निम्नलिखित सेक्शन में तालिका में सूचीबद्ध कई एट्रिब्यूट हैं. सारणी का आकार कम से कम एक होना चाहिए.
IsVaried	Boolean	No	कस्टम पुनरावृत्ति परिदृश्यों के लिए इस कुंजी को true पर सेट किया जाना चाहिए.
IsEdit	Boolean	No	मौजूदा नियमों को संपादित करने के लिए इस कुंजी को true पर सेट किया जाना चाहिए।
TimeZoneCode	Integer	No	यह कुंजी कैलेंडर नियमों के लिए समय क्षेत्र के अनुरूप एक पूर्णांक मान लेती है. मैपिंग के लिए, इस लेख में आगे दिए गए समय क्षेत्र कोड पर जाएं। डिफ़ॉल्ट मान उपयोगकर्ता का समय क्षेत्र है.
InnerCalendarDescription	String	No	यह कुंजी केवल तभी आवश्यक है जब कैलेंडर नियम समय समाप्ति के लिए बंद हो. इसमें समय समाप्ति का कारण होना चाहिए.
ObserveClosure	Boolean	No	यह कुंजी पुनरावृत्तियों के लिए विशिष्ट है. यदि इसे true पर सेट किया जाता है, तो इकाई व्यवसाय बंद कर देती है।
RecurrenceEndDate	तिथिसमय	No	यह कुंजी पुनरावृत्तियों के लिए विशिष्ट है. इसमें पुनरावृत्ति के लिए अंतिम तिथि शामिल है. यदि टाइमस्टैम्प 08:00:00 या इससे पहले का है, तो पुनरावृत्ति समाप्ति तिथि निर्दिष्ट तिथि से एक दिन पहले की है. यदि टाइमस्टैम्प 08:00:01 या इसके बाद का है, तो तारीख को उसी रूप में माना जाता है. उपस्थितियों के लिए डिफ़ॉल्ट मान शून्य है. पुनरावृत्ति के लिए डिफ़ॉल्ट मान 30 दिसंबर 9999, 23:59:59 घंटे, UTC है।
RecurrenceSplit	Boolean	No	यह कुंजी पुनरावृत्तियों के लिए विशिष्ट है. इसे पुनरावृत्ति की "यह और इसके बाद की घटनाएं" संपादित करने के लिए true पर सेट किया गया है।
ResourceId	मार्गदर्शक	No	इस कुंजी में SystemUserId या ResourceId शामिल है और इसे केवल तभी पास किया जाना चाहिए जब इस कॉल से संबद्ध निकाय SystemUser प्रकार का बुक करने योग्य संसाधन हो। सेवा प्रबंधन टैब पर OwnCalendar विशेषाधिकारों की जांच करने के लिए यह आवश्यक है।
उपयोगV2	फ्लैग	No	इस ध्वज को पारित करने से कार्य घंटे कैलेंडर का V2 संस्करण सक्षम हो जाता है, जिसमें एक उन्नत ओवरलैपिंग नियम तर्क होता है जो एकाधिक पुनरावृत्तियों की अनुमति देता है। अधिक जानकारी के लिए देखें यदि नियम एक दूसरे से ओवरलैप हो जाएं तो क्या होगा?

RulesAndRecurrences

Name	प्रकार	आवश्य	विवरण
नियम	नियम	हाँ	यह कुंजी एक सारणी है, और प्रत्येक तत्व में निम्नलिखित सेक्शन में तालिका में सूचीबद्ध कई एट्रिब्यूट हैं. सारणी का आकार कम से कम एक होना चाहिए.
RecurrencePattern	String	No	यह कुंजी पुनरावृत्तियों के लिए विशिष्ट है. हम वर्तमान में केवल इस पैटर्न का समर्थन करते हैं: FREQ=WEEKLY;INTERVAL=1;BYDAY=SU,MO,TU,WE,TH,FR,SA. BYDAY कम दिनों को शामिल करने के लिए इसे बदला जा सकता है; हालाँकि, FREQ और INTERVAL को बदला नहीं जा सकता।
InnerCalendarId	मार्गदर्शक	No	यह कुंजी संपादन के लिए विशिष्ट है. यदि कोई नियम संपादित किया जा रहा है, तो InnerCalendarId को यहां पास करना होगा. यदि InnerCalendarId पास नहीं किया जाता है, तो API एक नया नियम बनाता है, भले ही IsEdit कुंजी को true पर सेट किया गया हो।
कार्यवाही	Integer	No	यह कुंजी कस्टम पुनरावृत्तियों के लिए विशिष्ट है. यदि कोई कस्टम पुनरावृत्ति बनाई या संपादित की जा रही है, तो निम्न में से एक संख्या दर्ज की जानी चाहिए: (1) पुनरावृत्ति में एक दिन जोड़ना (2) पुनरावृत्ति से एक दिन हटाना (3) केवल प्रारंभ या समाप्ति तिथि या समय, या संपादन क्षमता संपादित करना (4) (3) में उल्लिखित कुंजियों के अलावा कुछ भी संपादित करना

नियम

नाम	प्रकार	आवश्यक	विवरण
StartTime	दिनांक और समय	हाँ	इस कुंजी में ISO प्रारूप में दिनांक-समय प्रविष्टि होती है। उदाहरण के लिए, \"2021-05-15T12:00:00.000Z\". समय भाग पहले निर्दिष्ट किए गए समय क्षेत्र में कार्य घंटे के प्रारंभ होने के समय को निर्धारित करता है. तिथि भाग कार्य घंटे की प्रारंभ तिथि निर्धारित करता है. यहां, 15 मई, 2021 उपस्थिति की तिथि या पुनरावृत्ति की प्रारंभिक तिथि है. यदि पैटर्न BYDAY=TU,WE था, लेकिन तिथि 15 मई (शनिवार) है, तो API स्वचालित रूप से 15 मई के बाद आने वाले सभी मंगलवार और बुधवार के लिए नियम बनाएगा या संपादित करेगा। यह वह स्थिति है जहां नियम में दिन के अनुरूप तिथि होना आवश्यक नहीं है.
EndTime	दिनांक और समय	हाँ	इसमें ISO प्रारूप में दिनांक-समय प्रविष्टि शामिल है। उदाहरण के लिए, \"2021-05-15T12:00:00.000Z\". समय भाग पहले निर्दिष्ट किए गए समय क्षेत्र में कार्य घंटे का समाप्ति समय निर्धारित करता है. दिनांक भाग में वही दिनांक होनी चाहिए जो StartTime के दिनांक भाग में है। केवल अपवाद हैं: अगर यह पूरे दिन की उपस्थिति है. इस मामले में, तिथि भाग को पूरे दिन की उपस्थिति की समाप्ति तिथि को प्रतिबिंबित करना चाहिए. उपस्थिति दिन के अंत में समाप्त होती है, यानी अगले दिन के 12:00 AM पर. इस स्थिति में, दिनांक \"2021-05-16T00:00:00.000Z\" होनी चाहिए। पुनरावृत्ति की समाप्ति तिथि निर्दिष्ट करने के लिए, RecurrenceEndDate विशेषता को संशोधित करें.
WorkHourType	Integer	हाँ	इस कुंजी में निम्न विकल्पों में से किसी एक के अनुरूप संख्या होती है: (0) कार्यरत (1) विराम (2) गैर-कार्यशील (3) समय समाप्त
प्रयास	Integer	No	यह कुंजी निकाय की क्षमता निर्धारित करती है. यह एक पूर्णांक होना चाहिए. डिफ़ॉल्ट मान 1 है.

आउटपुट

यह POST API चयनित निकाय के लिए कैलेंडर नियम रिकॉर्ड बनाता या संशोधित करता है. यह निम्नलिखित आउटपुट भी देता है.

नाम	प्रकार	विवरण
InnerCalendarIds	String	InnerCalendarIds GUIDs की एक सरणी जो POST ऑपरेशन का परिणाम है।

कैलेंडर API हटाएं

इनपुट

नाम	प्रकार	आवश्यक	विवरण
EntityLogicalName	String	हाँ	यह फ़ील्ड उस निकाय का वर्णन करती है जिसके कैलेंडर नियमों को हटाया जाना है.
InnerCalendarId	मार्गदर्शक	हाँ	यह फ़ील्ड उस InnerCalendarId की ID का वर्णन करती है जिसे हटाया जाना आवश्यक है। यदि एक ही नियम के साथ अनेक InnerCalendarIds संबद्ध हैं, तो यहां कोई भी एक ID पर्याप्त है। आंतरिक और बाहरी कैलेंडर के बारे में अधिक जानकारी: कैलेंडर इकाइयाँ
CalendarId	मार्गदर्शक	हाँ	यह फ़ील्ड इकाई के CalendarId का वर्णन करती है.
IsVaried	Boolean	No	यह फ़ील्ड पुनरावृत्तियों के लिए विशिष्ट है, और यदि कोई कस्टम पुनरावृत्ति नियम हटाया जा रहा है, तो इसे yes पर सेट किया जाता है.
उपयोगV2	फ्लैग	No	इस ध्वज को पारित करने से कार्य घंटे कैलेंडर का V2 संस्करण सक्षम हो जाता है, जिसमें एक उन्नत ओवरलैपिंग नियम तर्क होता है जो एकाधिक पुनरावृत्तियों की अनुमति देता है। अधिक जानकारी के लिए देखें यदि नियम एक दूसरे से ओवरलैप हो जाएं तो क्या होगा?

आउटपुट

यह POST API चयनित निकाय के लिए कैलेंडर नियम रिकॉर्ड हटा देता है. इसके अतिरिक्त, यह निम्नलिखित आउटपुट देता है.

नाम	प्रकार	विवरण
InnerCalendarIds	String	InnerCalendarIds GUIDs की एक सरणी जो POST ऑपरेशन का परिणाम है।

कैलेंडर API लोड करें

इनपुट

नाम: msdyn_LoadCalendars
प्रकार: एक्शन
विवरण: दिए गए LoadCalendarsInput के लिए कैलेंडर लौटाता है।

नाम: msdyn_LoadCalendars.LoadCalendarsInput
प्रकार: पैरामीटर
विवरण: निम्नलिखित JSON प्रारूप में स्ट्रिंग:

{
   StartDate: string,
   EndDate: string,
   CalendarIds: string[]
}

नाम: msdyn_LoadCalendarsResponse
प्रकार: जटिल प्रकार
विवरण: msdyn_loadCalendars क्रिया से प्रत्युत्तर सम्मिलित है।

नाम: msdyn_LoadCalendarsResponse.CalendarEvents
प्रकार: संपत्ति
विवरण: निम्नलिखित JSON प्रारूप में स्ट्रिंग:

{
"calendarId": CalendarEventSlot[]
}

जहां कैलेंडरआईडी कैलेंडर के गाइड का प्रतिनिधित्व करने वाला एक उचित गाइड है और कैलेंडरइवेंटस्लॉट निम्नलिखित प्रारूप का एक ऑब्जेक्ट है:

{
  CalendarId: string,
  InnerCalendarId: string,
  Start: string,
  End: string,
  Effort: double
}

API को कैसे निर्देशित करें

इन API को ब्राउज़र का उपयोग करके निर्देशित किया जा सकता है.

1. वह ब्राउज़र और org खोलें जिसमें आपको ये कैलेंडर परिवर्तन करने हैं.
2. डेवलपर टूल खोलें (Google Chrome में Ctrl+Shift+I in Microsoft Edge चुनें, F12 चुनें).
3. कंसोल में, [org-name] को org details से बदलने के बाद, निम्नलिखित फ़ंक्शन दर्ज करें (उदाहरण के लिए, 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));
       }

4. इस फंक्शन के परिभाषित होने के बाद, आप इसे 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 एपीआई का उपयोग करके करती है।

एक कार्य करने के घंटे की उपस्थिति का निर्माण करें.

बॉब 15 मई, 2021 को सुबह 9:00 बजे से शाम 5:00 बजे तक पैकेज देने के लिए ड्राइव करने वाला है. डेबी msdyn_SaveCalendar एपीआई का उपयोग करती है।

अनुरोध

{
 "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\"]"
}

कार्य घंटे की उपस्थिति को संपादित करें.

इसके बाद बॉब का शेड्यूल बदल कर 15 मई, 2021 को सुबह 10:00 बजे शुरू होगा. डेबी msdyn_SaveCalendar एपीआई का उपयोग करती है।

अनुरोध

{
 "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 एपीआई का उपयोग करती है।

अनुरोध

{
 "CalendarEventInfo": "{\"CalendarId\":\"d33263c7-c16b-4e3e-a56a-20f7a66cafc1\",\"EntityLogicalName\":\"bookableresource\",\"InnerCalendarId\":\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"}"
}

प्रतिसाद

{
  "InnerCalendarIds": "[\"f76cc333-cbbe-eb11-a81d-000d3a6e4359\"]"
}

दैनिक पुनरावर्ती कार्य करने के घंटे बनाएं

20 मई, 2021 से बॉब ने पूरे सप्ताह सुबह 8:00 बजे से शाम 5:00 बजे तक कॉन्टोसो के साथ काम करने का फैसला किया है और 15 जुलाई, 2021 को वह वहां काम करना बंद कर देंगे।

अनुरोध

{
 "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\"]"
}

बढ़ी हुई क्षमता के साथ दैनिक पुनरावर्ती कार्य करने के घंटे संपादित करें

बॉब ने 15 जून 2021 के पूरे सप्ताह के लिए काम बंद करके छुट्टी लेने का फैसला किया है। तब तक, बॉब पूर्व सहमति के अनुसार पूरे सप्ताह का कार्यक्रम जारी रखेंगे। डेबी ये परिवर्तन msdyn_SaveCalendar एपीआई का उपयोग करके करती है।

अनुरोध

{
 "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\"]"
}

साप्ताहिक पुनरावर्ती कार्य करने के घंटे बनाएं

16 जून 2021 से बॉब बुधवार और शुक्रवार को सुबह 8:00 बजे से शाम 5:00 बजे तक काम करेंगे और दोपहर 12:00 बजे से 12:30 बजे तक लंच के लिए ब्रेक लेंगे। डेबी एपीआई का उपयोग करती है, लेकिन गलती कर देती है, और ब्रेक का समय दोपहर 12:00 बजे से 1:00 बजे तक निर्धारित कर देती है। msdyn_SaveCalendar

अनुरोध

{
  "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 एपीआई का उपयोग करके ब्रेक का समय दोपहर 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 बजे से शाम 5:00 बजे तक और बुधवार को सुबह 11:00 बजे से दोपहर 3:00 बजे तक काम करता है. टिम ने 16 मई 2021 को कॉन्टोसो के लिए काम करना शुरू किया। डेबी टिम के कार्य घंटे बनाने के लिए msdyn_SaveCalendar एपीआई का उपयोग करती है।

अनुरोध

{
"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\"]"
}

एक कार्य करने के घंटे कस्टम पुनरावृत्ति संपादित करें

इसके बाद टिम का कार्य समय बदल कर बुधवार को शाम 5:00 बजे से रात 8:00 बजे तक तथा गुरूवार को सुबह 10:00 बजे से दोपहर 12:00 बजे तक हो जाता है। सोमवार को टिम के शेड्यूल से हटा दिया गया है। डेबी इसे प्राप्त करने के लिए msdyn_SaveCalendar एपीआई का उपयोग करती है।

अनुरोध

{
"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\"]"
}

पुनरावृत्ति में कार्य करने के घंटे की उपस्थिति संपादित करें

26 मई, 2021 को, टिम केवल दोपहर 1:00 बजे से शाम 7:00 बजे तक काम कर पा रहे हैं. डेबी यहां एपीआई का उपयोग करता है msdyn_SaveCalendar ।

अनुरोध

{
 "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 ।

अनुरोध

{
 "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\"]"
}

समय समाप्ति बनाएं

टिम 9 जून, 2021 से परिवार के संग समय बिताने के लिए के लिए तीन दिन की छुट्टी लेंगे.

अनुरोध

{
 "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\"]"
}

पूरे दिन के कार्य के घंटे बनाएं

20 मई, 2021 से टिम की 72 घंटे की शिफ्ट है. डेबी टिम के कार्य घंटे बनाने के लिए msdyn_SaveCalendar एपीआई का उपयोग करती है।

अनुरोध

{
 "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\"]"
}

संबंधी सामान्य प्रश्न

मुझे त्रुटि मिल रही है, "स्टार्टटाइम एंडटाइम से अधिक या बराबर नहीं हो सकता है।

सुनिश्चित करें कि विभिन्न कैलेंडर नियमों के समय निर्धारण में कोई ओवरलैप नहीं है. यह सुनिश्चित करने के लिए तिथियों की जाँच करें कि StartTime EndTime से बाद में नहीं है। साथ ही, सत्यापित करें कि समय 24 घंटे के प्रारूप का पालन करता है.

क्या API का उपयोग "कार्य घंटे टेम्पलेट" निकाय को अपडेट करने के लिए किया जा सकता है?

हां, आप इस API का उपयोग संसाधन कार्य घंटों के अतिरिक्त कार्य घंटे टेम्प्लेट बनाने और अपडेट करने के लिए कर सकते हैं.

मुझे त्रुटि मिल रही है, "Microsoft.Dynamics.UCICalendar.Plugins.SaveCalendarContract+CalendarEventInfo प्रकार के ऑब्जेक्ट को deserializing करने में कोई त्रुटि थी। इनपुट स्रोत सही रूप से स्वरूपित नहीं है.
or
राज्य 'तत्व' की अपेक्षा .. नाम '', नामस्थान '' के साथ 'टेक्स्ट' का सामना करना पड़ा।

सुनिश्चित करें कि स्ट्रिंग को सही ढंग से पार्स किया गया है. कोष्ठक, अल्पविराम, या अर्धविराम अनुपलब्ध हो सकते हैं.

मुझे त्रुटि मिल रही है, "अमान्य पुनरावृत्ति पैटर्न। समर्थित पैटर्न के लिए दस्तावेज़ीकरण देखें।

वर्तमान में हम केवल इस पैटर्न का समर्थन करते हैं: 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.1-4.1; 8am-5pm ET।

2. किसी प्रतिच्छेदन दिनांक सीमा के लिए दोहराए जाने वाला दूसरा दोहराए जाने वाला कैलेंडर नियम बनाएँ, साथ ही यह सुनिश्चित करें कि कार्य घंटे पिछले दिनों या समय से प्रतिच्छेद न करें. उदाहरण के लिए: बुध, गुरु दोहराएं; 1.1-4.1; 8am-5pm ET या सोम, मंगल; 1.1-4.1; 5pm-8pm ET।

परिणाम: कैलेंडर नियम दोनों एक दूसरे के साथ बने रहते हैं और सह-अस्तित्व में रहते हैं।

उदाहरण 2 - दोहराए जाने वाले कार्य घंटे: कुछ अतिव्यापी दिनांक, जिनमें सभी अतिव्यापी दिन और दूसरा नियम पहले नियम के पहले या बाद में प्रारंभ/समाप्त होता है

एक तकनीशियन को एक नया कार्य अनुसूची मिलता है, जो उनके पुराने कार्यक्रम के कुछ हफ्तों को बदल देता है। अनुबंध के अनुसार, वे हमेशा हर हफ्ते एक ही दिन काम करते हैं।

1. किसी दी गई दिनांक सीमा के लिए पहला दोहराए जाने वाला कैलेंडर नियम बनाएँ. उदाहरण के लिए: सोम, मंगल; 2.1-4.1; 8am-5pm ET दोहराएं।

2. ओवरलैप दिनांक सीमा के लिए दोहराए जाने वाला दूसरा दोहराए जाने वाला कैलेंडर नियम बनाएँ, जहाँ सभी दिनों में कार्य के घंटे ओवरलैप होते हैं. इस नए नियम के लिए प्रारंभ/समाप्ति दिनांक चुनें जो मुट्ठी नियम के प्रारंभ/समाप्ति दिनांक से पहले या बाद में हों। उदाहरण के लिए: सोम, मंगल दोहराएं; 3.1-5.1; 1 बजे -8 बजे ईटी।

परिणाम: दूसरे नियम के प्रारंभ/समाप्ति दिनांक को समायोजित करने के लिए पहला नियम छोटा हो जाता है। उदाहरण के लिए: सोम, मंगल दोहराएं; 2.1-2.28; 8 am-5pm ET और सोम, मंगल; 3.1-5.1; 1pm-8pm ET।

उदाहरण 3 - कार्य के घंटों को दोहराना: सभी अतिव्यापी तिथियां, कुछ अतिव्यापी दिनों/समय के साथ

तकनीशियन एक निश्चित 2 महीने की अवधि के लिए एक अनुबंध कार्यकर्ता है। वे कुछ दिनों में अतिरिक्त काम करने के लिए सहमत हुए हैं। वे मंगलवार के काम के घंटों को पहले/बाद के समय में स्थानांतरित करना चाहते हैं।

1. किसी दी गई दिनांक सीमा के लिए दोहराए जाने वाले कैलेंडर नियम बनाएँ. उदाहरण के लिए: सोम, मंगल दोहराएं; 2.1-4.1; 8 am-12pm ET और दोहराएँ मंगल, बुध; 2.1-4.1, 1pm-5pm ET।

2. समान दिनांक सीमा के लिए दोहराए जाने वाला नया कैलेंडर नियम बनाएं. ऐसे दिन/समय चुनें जो मूल नियमों के साथ आंशिक रूप से ओवरलैप हों। उदाहरण के लिए: मंगल, गुरुवार दोहराएं; 2.1-4.1; 10am-2pm ET।

परिणाम: नया नियम पुराने को अधिलेखित करता है जहां ओवरलैप होते हैं, और दूसरों को अपरिवर्तित छोड़ देता है। उदाहरण के लिए: सोम दोहराएं; 2.1-4.1; 8 am-12pm ET और रिपीट वेड; 2.1-4.1; 1pm-5pm ET और रिपीट Tue, गुरुवार; 2.1-4.1; 10am-2pm ET।

उदाहरण 4 - दोहराए जाने वाले कार्य घंटे: पुराने नियम में शामिल नए नियम दिनांक, कुछ अतिव्यापी दिन/समय

एक तकनीशियन हर हफ्ते सुबह 8 बजे से शाम 5 बजे तक, सोम-शुक्र काम करता है। बस दो सप्ताह के लिए, वे हर सोम-बुध को अलग-अलग काम के घंटों के साथ एक विशेष आपातकालीन परियोजना को संभालेंगे 6am-6pm.

1. किसी दी गई दिनांक सीमा के लिए पहला दोहराए जाने वाला कैलेंडर नियम बनाएँ. उदाहरण के लिए: सोम, मंगल, बुध, गुरु, शुक्र दोहराएं; 1.1-कोई समाप्ति तिथि नहीं; 8 पूर्वाह्न 5 बजे ईटी।

2. उपरोक्त दिनांक सीमा के भीतर निहित दूसरा दोहराए जाने वाला कैलेंडर नियम बनाएं, कुछ दिनों में ओवरलैप होने वाले कार्य घंटे चुनें। उदाहरण के लिए: सोम, मंगल, बुध दोहराएं; 5.1-5.14; 6 am-6pm ET।

परिणाम: कैलेंडर में इस अभ्यास के अंत तक चार दोहराए जाने वाले नियम होने चाहिए:

• पहले नियम को दूसरे नियम के प्रारंभ दिनांक तक छोटा करें
• दूसरा कैलेंडर नियम
• पहले नियम के समान एक नया नियम बनाएं लेकिन गैर-अतिव्यापी दिनों के लिए दूसरे नियम की तारीखों के साथ
• पहले नियम को दूसरे नियम की समाप्ति दिनांक से प्रारंभ करने के लिए छोटा करें, जिसमें कोई समाप्ति दिनांक न हो

उदाहरण के लिए: सोम, मंगल, बुध, गुरु, शुक्र; 1.1–4.30; 8am-5pm ET और सोम, मंगल, बुध दोहराएं; 5.1-5.14; 6am-6pm ET और Thu, Fri, 5.1-5.14; 8am-5pm ET दोहराएं और सोम, मंगल, बुध, गुरु, शुक्र; 5.15-कोई समाप्ति तिथि नहीं; 8am-5pm ET

उदाहरण 5 - गैर-दोहराए जाने वाले कार्य घंटे (घटना, रैंक 1 नियम)

एक तकनीशियन के पास कई टीम सामंजस्य दिन होते हैं, जो दिन के लिए अन्य सभी कार्य घंटे के उदाहरणों पर पूर्वता लेते हैं।

1. किसी दी गई दिनांक सीमा के लिए दोहराए जाने वाला कैलेंडर नियम बनाएँ. उदाहरण के लिए: सोम, मंगल, बुध, गुरु, शुक्र दोहराएं; 1.1-कोई समाप्ति तिथि नहीं; 8 पूर्वाह्न 5 बजे ईटी।

2. उपरोक्त दिनांक सीमा के भीतर शामिल एक गैर-दोहराव कैलेंडर नियम बनाएं। काम के घंटे चुनें जो कुछ दिनों में ओवरलैप होते हैं। उदाहरण के लिए: नॉन-रिपीट; 6.21; 7am-1pm ET।

परिणाम: कैलेंडर अभ्यास के अंत तक 1 गैर-दोहराव नियम (घटना) होना चाहिए। गैर-दोहराव नियम पूरे दिन के लिए अतिव्यापी दोहराने की घटना को ओवरराइड करता है। उदाहरण के लिए: सोम, मंगल, बुध, गुरु, शुक्र दोहराएं; 1.1-6.21 को छोड़कर कोई समाप्ति तिथि नहीं; गैर-दोहराना; 6.21; 7am-1pm ET।

V1 ओवरलैपिंग नियम

• रैंक 1 के नियमों की रैंक 0 के नियमों की तुलना में उच्च प्राथमिकता है. इसलिए यदि एक ही दिन में दो नियम (प्रत्येक रैंक में से एक) थे, तो दैनिक घटना या टाइम-ऑफ घटना साप्ताहिक पुनरावृत्ति पर प्राथमिकता लेती है।
• यदि एक ही रैंक के दो नियम हैं, तो जो नियम सबसे हाल ही में बनाया/संशोधित किया गया था, वह वही वाला होगा जिसे संसाधन के कैलेंडर के लिए माना जाता है.
• ध्यान रखें कि पूरे दिन की घटनाएं रैंक 1 की होती हैं, इसलिए आप इसे साप्ताहिक पुनरावृत्ति में बदलने पर विचार कर सकते हैं, ताकि आप घटना के काम के घंटे जोड़ सकें और उनको स्वीकारा जा सके.
• जब एक कार्य समय मौजूद होता है और एक टाइम ऑफ घटना को ओवरलैप करते हुए बनाया जाता है, तो नियम इस तरह से विभाजित होते हैं, जो सुनिश्चित करता है कि समय को स्वीकारा जाता है और काम के घंटे के रूप में कोई भी शेष समय यथावत रहेगा. उदाहरण के लिए, यदि 21 सितंबर को सुबह 8 बजे से शाम 5 बजे तक काम करने का समय है और 21 सितंबर को दोपहर 3 बजे से शाम 7 बजे तक एक टाइम-ऑफ घटना जोड़ दी जाती है, तो इसे 8 बजे से दोपहर 3 बजे तक काम के घंटे के रूप में और दोपहर 3 बजे से शाम 7 बजे तक टाइम ऑफ के रूप में हल किया जाएगा. हालांकि, यदि नियमों को विपरीत क्रम में बनाया गया था (टाइम ऑफ पहले बनाया गया था और फिर काम के घंटे बनाए गए थे) समय-सारिणी की परवाह किए बिना, केवल काम के घंटे को फिर से चुना जाएगा. टाइम ऑफ का समय ओवरराइड हो जाएगा.

समय क्षेत्र कोड

इनम	समय क्षेत्र
12	(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) मोंटेवीडियो
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) एम्सटरडम, बर्लिन, बर्न, रोम, स्टॉकहोम, वियेना
113	(GMT+01:00) पश्चिमी मध्य अफ्रीका
115	(GMT+02:00) किसिनौ
120	(GMT+02:00) कायरो
125	(GMT+02:00) हेलसिंकी,कीव, रिगा, सोफिया, तालीन, विनियस
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) त्बिल्सी
174	(GMT+04:00) इज़्हेव्स्क, समारा
175	(GMT+04:30) काबुल
176	(GMT+04:00) अस्त्रखान, उल्यानोव्स्क
180	(GMT+05:00) एकतेरिनबर्ग
184	(GMT+05:00) इस्लामाबाद, कराची
185	(GMT+05:00) ताशकंत
190	(GMT+05:30) चेन्नई, कोलकाता, मुंबई, नई दिल्ली
193	(GMT+05:45) काठमांडू
195	(GMT+06:00) अस्टाना
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) यूकोन