कस्टम फ़ील्ड के लिए डेटा आकार, अपरिवर्तनीयताएँ, कुंजियाँ, संबंध, जीवनचक्र, और चयन मानदंड परिभाषित करता है। यह संदर्भ अपनाने की सीमा, विफलता व्यवहार, और प्रेक्षणीय साक्ष्य को तय करता है जबकि पर्यावरण-विशिष्ट सीमाओं को कॉन्फ़िगर करने योग्य छोड़ता है।
पैकेज स्थिति: संदर्भ संदर्भ मानव समीक्षा के लिए तैयार। अनुबंध और परीक्षण परिदृश्य पूर्ण हैं, लेकिन यह दावा नहीं किया जाता कि किसी अपनाने वाली कार्यान्वयन ने उन्हें पारित किया है।
निर्णय
कस्टम फ़ील्ड के लिए, डेटाबेस प्रतिबंधों के साथ एक लेन-देन डोमेन लेखन पथ अपनाएं। पहुँच पैटर्न और अपरिवर्तनीयताओं से मॉडल चुनें, जिसमें कैनोनिकल पहचान, जीवनचक्र, लेन-देन, माइग्रेशन, और विलोपन नियम शामिल हों। यह डेटा ब्लॉक विशेष रूप से मॉडलिंग निर्णय पर केंद्रित है। यह पैकेज एक संदर्भ अनुबंध है: अपनाने वाली टीम को अपने पर्यावरण में साक्ष्य से संख्यात्मक सीमाएँ, प्रदाता, अधिकार क्षेत्र, और परिचालन मालिक चुनने होंगे।
दायरा
- कस्टम फ़ील्ड के अभिनेता, इनपुट, आउटपुट, अवस्थाएँ, नीति या स्कीमा संस्करण, और बाहरी रूप से दिखाई देने वाले परिणाम जो इस डेटा ब्लॉक के मॉडलिंग निर्णय फोकस के लिए आवश्यक हैं।
- प्राथमिक और वैकल्पिक इंटरफेस, पृष्ठभूमि कार्य, कैश, एकीकरण, समर्थन पथ, और साक्ष्य जो समान सीमा का अभ्यास कर सकते हैं।
- संदर्भ को सुरक्षित रूप से लागू करने के लिए आवश्यक अपनाने-विशिष्ट कॉन्फ़िगरेशन, रोलआउट, पुनर्प्राप्ति, और सत्यापन जिम्मेदारियाँ।
इस ब्लॉक के बाहर
- हर अपनाने वाले के लिए एक सार्वभौमिक विक्रेता, फ्रेमवर्क, अधिकार क्षेत्र, संख्यात्मक सीमा, प्रतिधारण अवधि, या सेवा-स्तर उद्देश्य चुनना।
- यह दावा करना कि पैकेज किए गए परिदृश्य ने डाउनस्ट्रीम कार्यान्वयन के खिलाफ चलाए गए हैं या यह संदर्भ कानूनी, सुरक्षा, या पहुंच प्रमाणन प्रदान करता है।
अनुबंध
- स्थिर अपरिवर्तनीयताओं को टाइप, कुंजी, विशिष्टता, विदेशी कुंजी, और जांच के साथ एन्कोड करें, केवल कॉलर कन्वेंशन पर निर्भर न रहें।
- लेन-देन और समवर्ती सीमाओं को परिभाषित करें, जिसमें यह शामिल है कि पुरानी लिखावटें, डुप्लिकेट कमांड, और आंशिक विफलताएँ कैसे सुलझती हैं।
- विनाशकारी परिवर्तनों से पहले संवर्धक स्कीमा और द्वैध-संगत कोड रोल आउट करें; बैकफिल्स पुनः आरंभ करने योग्य और प्रेक्षणीय हैं।
- प्रत्येक सामग्री रिकॉर्ड या संबंध के लिए स्वामित्व, प्रतिधारण, विलोपन, बैकअप, पुनर्स्थापना, और सूचकांक प्रभावों का दस्तावेजीकरण करें।
- अनुपस्थिति, अज्ञात, खाली, लंबित, ऐतिहासिक, और विलोपित अवस्थाओं को स्पष्ट रूप से प्रदर्शित करें जब उनका व्यावसायिक व्यवहार भिन्न हो।
- विरोधाभासी लिखावटों के बाद सफाई के बजाय एक कैनोनिकल कुंजी और प्रतिबंध के साथ डुप्लिकेट तार्किक संबंधों को रोकें।
- फ़ील्ड परिभाषाओं को मानों से अलग-अलग संस्करणित करें और प्रत्येक मान को परिभाषा प्रकार, दायरा, सत्यापन, दृश्यता, और जीवनचक्र से बाँधें।
- प्रकार परिवर्तन पूर्वावलोकित माइग्रेशन का उपयोग करते हैं जिसमें अमान्य मान हैंडलिंग शामिल है; रीडर तब तक संगत रहते हैं जब तक बैकफिल और रोलबैक विंडो बंद न हो जाए।
- मॉडलिंग निर्णय संस्करण के लिए, इस घोषित सीमा को लागू करें: कस्टम फ़ील्ड के लिए डेटा आकार, अपरिवर्तनीयताएँ, कुंजियाँ, संबंध, जीवनचक्र, और चयन मानदंड परिभाषित करता है।
कार्यान्वयन मार्गदर्शन
- प्रतिनिधि पढ़ने, लिखने, बल्क ऑपरेशंस, प्रतिधारण, ऑडिट, और पुनर्स्थापना के खिलाफ मॉडल को मान्य करें इससे पहले कि संग्रहण विवरणों को प्रतिबद्ध करें।
- फ्रेमवर्क या विक्रेता विवरण चुनने से पहले कस्टम फ़ील्ड के इनपुट, आउटपुट, अभिनेता, अवस्थाएँ, अपरिवर्तनीयताएँ, पार्श्व प्रभाव, और साक्ष्य मॉडल करें।
- लागू कस्टम फ़ील्ड अनुबंध या नीति संस्करण को सामग्री स्थिति के साथ संग्रहीत करें ताकि माइग्रेशन, पुनःप्रदर्शन, और समर्थन निर्णय उत्तरदायी बने रहें।
- नियंत्रित रोलआउट के पीछे पथ प्रस्तुत करें, अपेक्षित और प्रेक्षित परिणामों की तुलना करें, और अपनाने के साक्ष्य पूर्ण होने तक एक परीक्षण पुनर्प्राप्ति मार्ग बनाए रखें।
विफलता प्रबंधन और सुरक्षा उपाय
- प्रतिबंध या माइग्रेशन विफलता अंतिम मान्य स्थिति को संरक्षित करती है और पुनः आरंभ करने योग्य, ऑपरेटर-स्वामित्व वाले पुनर्प्राप्ति बिंदु को उजागर करती है।
- अमान्य या विरोधाभासी कस्टम फ़ील्ड स्थिति को अस्वीकार या क्वारंटीन किया जाता है; कार्यान्वयन कभी भी ऐसा मान अनुमानित नहीं करता जो अधिकार को बढ़ाए या प्रभाव को डुप्लिकेट करे।
- पुनः प्रयास सीमित होते हैं और टिकाऊ पहचान का उपयोग करते हैं; समाप्ति के बाद, कार्य निरीक्षणीय अंतिम स्थिति तक पहुँचता है जिसमें एक जवाबदेह मालिक होता है।
सत्यापन और संचालन
- प्रतिबंधों और समवर्ती संक्रमणों का सीधे परीक्षण करें, फिर बैकअप पुनर्स्थापित करें और पुनर्प्राप्त डेटा पर अपरिवर्तनीय जांच पुनः चलाएं।
- कस्टम फ़ील्ड सफलता, अस्वीकृति, सत्यापन विफलता, निर्भरता विफलता, पुनः प्रयास समाप्ति, और अनुबंध संस्करण द्वारा पुनर्प्राप्ति की निगरानी करें बिना संवेदनशील पेलोड आयामों के।
- नीति, स्कीमा, निर्भरता, माइग्रेशन, या सीमा परिवर्तनों के बाद युग्मित सकारात्मक और नकारात्मक फ़िक्स्चर पुनः चलाएं और परिणामी साक्ष्य संरक्षित करें।
अपनाने की धारणाएँ
- उदाहरण में नाम और मान एक ठोस फ़िक्स्चर हैं, सार्वभौमिक डिफ़ॉल्ट नहीं; अपनाने वाले इन्हें प्रलेखित साक्ष्य और स्वामित्व के माध्यम से बदलते हैं।
- अपनाने वाली प्रणाली प्रमाणीकृत पहचान, टिकाऊ संचालन या रिकॉर्ड संस्करण, सीमित टेलीमेट्री, और परिवर्तन के लिए नियंत्रित पथ प्रदान कर सकती है।
इस पैकेज में निष्पादन-समान उदाहरण फ़िक्स्चर और स्वीकृति अनुबंध हैं। संरचना और मेटाडेटा की जांच के लिए संग्रह सत्यापक चलाएं, फिर लक्षित रिपॉजिटरी में परिदृश्यों का अनुवाद और निष्पादन करें और कार्यान्वयन साक्ष्य रिकॉर्ड करें।