इकाई मेटाडाटा रैपर
निकाय एपीआई कुछ रैपर कक्षाएं प्रदान करता है जिनका उपयोग आप संस्थाओं के साथ आसानी से निपटने और प्रदान की गई इकाई संपत्ति सूचना मॉड्यूल का लाभ उठाने के लिए कर सकते हैं। रैपर की मदद से आप संपत्ति की जानकारी तक पहुंच सकते हैं, ज्ञात गुणों पर लूप कर सकते हैं, या केवल वर्णित डेटा मान प्राप्त कर सकते हैं / सेट कर सकते हैं, आदि।
ये कुछ सरल उपयोग उदाहरण हैं जो README में पाए जाते हैं:
इस जानकारी (मेटाडेटा) के उपयोग के लिए मॉड्यूल कुछ रैपर कक्षाएं प्रदान करता है जो मूल्यों को प्राप्त करने और स्थापित करने में आसानी करते हैं। रैपर इकाई गुणों के रैपर को प्राप्त करने के लिए जंजीर के उपयोग का समर्थन करता है, उदाहरण के लिए एक नोड लेखक का मेल पता जिसे वह उपयोग कर सकता है:
$wrapper = entity_metadata_wrapper('node', $node);
$wrapper->author->mail->value();
उपयोगकर्ता के मेल पते को अपडेट करने के लिए कोई भी उपयोग कर सकता है
$wrapper->author->mail->set('sepp@example.com');
या
$wrapper->author->mail = 'sepp@example.com';
रैपर हमेशा संपत्ति की जानकारी में वर्णित डेटा लौटाते हैं, जिसे सीधे यूनिट_गेट_प्रोपर_इनफो () या रैपर के माध्यम से प्राप्त किया जा सकता है:
$mail_info = $wrapper->author->mail->info();
आदेश में उत्पादन के लिए एक पाठ मूल्य का उपयोग करने के लिए मजबूर कर सकता है, जैसे
$wrapper->title->value(array('sanitize' => TRUE));
सैनिटाइज्ड नोड टाइटल पाने के लिए। जब कोई प्रॉपर्टी पहले ही डिफॉल्ट रूप से सैनिटाइज्ड हो जाती है, तो नोड बॉडी की तरह, एक संभवत: नहीं-सैनिटाइज्ड डेटा प्राप्त करना चाहता है क्योंकि यह अन्य उपयोग के मामलों के लिए एक ब्राउज़र में दिखाई देगा। ऐसा करने के लिए कोई भी 'डीकोड' विकल्प को सक्षम कर सकता है, जो किसी भी स्वच्छता डेटा के लिए सुनिश्चित करता है कि टैग छीन लिए गए हैं और संपत्ति लौटाने से पहले एचटीएमएल इकाइयां डीकोड की गई हैं:
$wrapper->body->value->value(array('decode' => TRUE));
इस तरह एक हमेशा डेटा प्राप्त होता है जैसा कि उपयोगकर्ता को दिखाया गया है। हालाँकि यदि आप वास्तव में कच्चे, असंसाधित मूल्य प्राप्त करना चाहते हैं, यहां तक कि स्वच्छता संबंधी पाठ्य डेटा के लिए भी, तो आप ऐसा कर सकते हैं:
$wrapper->body->value->raw();
और ज्यादा उदाहरण:
$wrapper->body->set(array('value' => "content"));
$wrapper->field_text[0] = 'the text';
$wrapper->field_text[0]->set(array('value' => "content"));
$wrapper->field_text2->summary = 'the summary';
$wrapper->field_text2->value = 'the text';
$wrapper->save();
$wrapper->delete();
अधिक डॉक्स : http://drupal.org/node/1021556