Sharepoint सूचियों में डेटा अपलोड करें

SharePoint समाधान विकसित करते समय, कार्य अक्सर साइट संरचना (फ़ील्ड, सामग्री प्रकार, सूचियाँ) को स्वचालित रूप से विस्तारित करने के अलावा, इसे मूल सामग्री से भी भर देता है। इन्हें मुख्य रूप से संदर्भ जानकारी के साथ सूचीबद्ध किया जा सकता है। लेकिन, इसके अलावा, लोड सहित परीक्षण के समाधान के लिए कुछ परीक्षण डेटा के साथ उन्हें भरने की आवश्यकता उत्पन्न हो सकती है।

XML फ़ाइल में ListInstance को इंगित करके डेटा के साथ सूचियों को पॉप्युलेट करने का एक तरीका है। लेकिन यह दृष्टिकोण लेख में विचार से कम सुविधाजनक है। सूची बनाने के लिए उपयोग करने के लिए ListDefinitions हमेशा व्यावहारिक नहीं होते हैं, इसके अलावा, उन सूचियों को आबाद करना आवश्यक हो सकता है जो पहले से ही साइट पर मौजूद हैं, बजाय समाधान से तैनात किए जाने के।

तो, विचार निम्नलिखित तर्क है:

एक्सेल में डेटा के साथ टेबल बनाना,
एक्सेल से XML में डेटा निर्यात करें,
Visual Studio प्रोजेक्ट के लिए XML फ़ाइलें जोड़ना
फ़ाइलों की XML सामग्री को पार्स करना और सक्रियण के लिए रिसीवर सुविधाओं में सूचियों में डेटा जोड़ना।
एक्सेल का उपयोग करना बहुत सुविधाजनक है। सबसे पहले, वहाँ डेटा भरना आसान है; आप उन्हें माउस से बस खींचकर विभिन्न लाइनों की प्रतियां बना सकते हैं; परीक्षण उद्देश्यों के लिए यादृच्छिकता मान देने के लिए विभिन्न सूत्र लिखे जा सकते हैं। और सबसे महत्वपूर्ण बात - यह इस रूप में है कि ग्राहक आमतौर पर संदर्भ जानकारी भेजता है, अर्थात, एक्सेल में आपके अनुरोध पर जानकारी तैयार करना उसके लिए बहुत आसान होगा।

क्रियाओं का क्रम:

1. एक अलग शीट पर एक एक्सेल वर्कबुक में एक डेटा टेबल बनाएं।

2. .xsd फ़ाइल बनाएँ जो इस प्रारूप में डेटा स्कीमा का प्रतिनिधित्व करेगी:

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Currencies">
<xs:complexType>
<xs:sequence>
<xs:element ref="Currency" minOccurs="0" maxOccurs="unbounded"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Currency">
<xs:complexType>
<xs:sequence>
<xs:element name="Title" type="xs:string"/>
<xs:element name="Currency_IsNational" type="xs:string"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

सुविधा के लिए, साइट पर अपनी सूची के रूप में रूट तत्व को नाम दें (या इसके पते के मुख्य भाग के रूप में)। मैंने इस तत्व को मुद्राओं कहा है। XML को पार्स करते समय, आप वांछित सूची तक पहुंचने के लिए तुरंत इस नाम का उपयोग कर सकते हैं।

इच्छित सूची में फ़ील्ड के आंतरिक नाम के अनुसार फ़ील्ड नामों को इंगित करें (ऊपर दिए गए उदाहरण में, यह शीर्षक और Currency_IsNational है)।

इसके अलावा, शर्मिंदा नहीं होना चाहिए कि मूल्य प्रकार "xs: string" के लायक है। XML को पार्स करते समय, आपको अभी भी स्ट्रिंग मान प्राप्त होंगे, जब SPListItem ऑब्जेक्ट पर लिखा जाता है, तो खुद को वांछित प्रकार में बदल दिया जाएगा।

यदि आपको अधिक जटिल प्रकारों का उपयोग करने की आवश्यकता है, जैसे उपयोगकर्ता, तो निर्दिष्ट करें, उदाहरण के लिए, एक्सेल तालिका में लॉगिन नाम, और कोड में SPFieldUserValue के लिए अतिरिक्त रूपांतरण करें। बाद में इसका प्रदर्शन किया जाएगा।

3. एक्सेल में "डेवलपर" टैब को सक्रिय करें।

4. इस टैब पर, "स्रोत" बटन पर क्लिक करें:

5. दिखाई देने वाले पैनल में, XML मैप्स बटन पर क्लिक करें:

6. "जोड़ें" बटन पर क्लिक करें और पहले से बनाई गई .xsd फ़ाइल जोड़ें:

7. स्कीमा जोड़ने के बाद, एक्सेल में टेबल हेडिंग चुनें और दाईं ओर पैनल में "एसोसिएट एलीमेंट" डेटा ट्री पर क्लिक करें:

इस प्रकार, आप अपनी तालिका को डेटा स्कीमा में मैप करते हैं। अब इसे एक्सएमएल में एक्सपोर्ट किया जा सकता है।

8. निर्यात पर क्लिक करें और .xml फ़ाइल सहेजें:

निर्यात की गई फ़ाइल कुछ इस तरह दिखाई देगी:

9. उन सभी तालिकाओं के लिए उपरोक्त संचालन करें जो आप साइट पर अपलोड करने जा रहे हैं।

10. अपने विजुअल स्टूडियो प्रोजेक्ट में एक मॉड्यूल बनाएं और उसमें इस तरह से बनाए गए डेटा के साथ सभी .xml फाइलें जोड़ें। इसे नाम दें उदाहरण के लिए InitialData।

मॉड्यूल को फीचर में शामिल करना न भूलें।

11. जब सुविधा सक्रिय हो जाती है, तो साइट पर InitialData नामक एक फ़ोल्डर बनाया जाएगा, जहां .xml फाइलें जोड़ी जाएंगी।

12. अगला, सुविधा सक्रियण रिसीवर में, इन xml फ़ाइलों को पार्स करने और इच्छित सूचियों में आइटम बनाने के लिए तर्क जोड़ें।

जब तक ये क्रियाएं पूरी नहीं हो जाती हैं, तब तक सूची पहले से ही सभी आवश्यक फ़ील्ड के साथ साइट पर मौजूद होनी चाहिए। उसी समय, आप उन डेटा के साथ सूचियों को भर सकते हैं जिनमें पहले से ही अन्य डेटा है।

नीचे दी गई विधि InitialData फ़ोल्डर में सभी xml फ़ाइलों के माध्यम से जाती है और प्रत्येक के लिए ImportToSPList विधि को कॉल करती है।

public void Import()
{
// _siteUrl -
using (SPSite site = new SPSite(_siteUrl))
{
SPWeb web = site.RootWeb;
// _initialDataFolderName - (, )
SPFolder initialDataFolder = web.RootFolder.SubFolders[_initialDataFolderName];

foreach (SPFile file in initialDataFolder.Files)
{
if (file.Name.EndsWith(".xml", StringComparison.CurrentCultureIgnoreCase))
{
using (MemoryStream inStream = new MemoryStream(file.OpenBinary()))
{
using (XmlTextReader reader = new XmlTextReader(inStream))
{
XmlDocument xd = new XmlDocument();
xd.Load(reader);

ImportToSPList(web, xd);
}
}
}
}
}
}

ImportToSPList xml, . , , , SPListItem, SPListItem'.

private void ImportToSPList(SPWeb web, XmlDocument xd)
{
XmlElement root = xd.DocumentElement;
// .
string rootName = root.LocalName;
string listUrl = String.Format("Lists/{0}/AllItems.aspx", rootName);
SPList list = web.GetListFromUrl(listUrl);

foreach (XmlNode item in root.ChildNodes)
{
SPListItem spListItem = list.AddItem();
//
foreach (XmlNode field in item.ChildNodes)
{
//
DataImportSpecialRule specialRule =
_diSpecialRules.FirstOrDefault(x => x.ListUrl == listUrl && x.FieldName == field.LocalName);
if (specialRule == null)
{
// ,
spListItem[field.LocalName] = field.InnerText;
}
else
{
// -
spListItem[field.LocalName] = specialRule.Converter(web, field.InnerText);
}
}
//
spListItem.Update();
}
}

हेल्पर क्लास DataImportSpecialRule पर भी ध्यान दें, जो कि आवश्यक होने पर स्ट्रिंग मानों को xml से अधिक जटिल प्रकार में बदलने के लिए आवश्यक है।

यहां खुद DataImportSpecialRule क्लास है, जो सूची का पता, फ़ील्ड का नाम और फ़ंक्शन का विवरण संग्रहीत करता है:

public delegate object GetTypedValue(SPWeb web, string value);

class DataImportSpecialRule
{
public string ListUrl { get; set; }
public string FieldName { get; set; }
public GetTypedValue Converter { get; set; }
}
फ़ंक्शन में GetTypedValue प्रतिनिधि में वर्णित हस्ताक्षर हैं। इनपुट पर, यह SPWeb और एक स्ट्रिंग मान लेता है, और एक ऑब्जेक्ट देता है जिसे SPListItem फ़ील्ड में लिखा जाना चाहिए।

प्रारंभ में, आप सभी नियमों का वर्णन कर सकते हैं जो आपके सभी निर्देशिकाओं पर लागू होने चाहिए, जैसा कि उदाहरण में दिखाया गया है:

_diSpecialRules = new List()
{
new DataImportSpecialRule()
{
ListUrl = "Lists/BusinessBlocks/AllItems.aspx",
FieldName = "BusinessBlock_Group",
Converter = (SPWeb web, string value) =>
{
SPGroup group = web.SiteGroups[value];
return new SPFieldUserValue(web, group.ID, group.Name);
}
}
//
};

, , xml , , SPListItem .

. . , - .

private SPFieldMultiChoiceValue MultiChoiceConverter(SPWeb web, string value)
{
SPFieldMultiChoiceValue fValue = new SPFieldMultiChoiceValue();
foreach (string choice in value.Split(';')) fValue.Add(choice.Trim());
return fValue;
}

, . , .

:

, -, . , , xml , , .
.

SharePoint Channel _diSpecialRules = new List()
{
new DataImportSpecialRule()
{
ListUrl = "Lists/BusinessBlocks/AllItems.aspx",
FieldName = "BusinessBlock_Group",
Converter = (SPWeb web, string value) =>
{
SPGroup group = web.SiteGroups[value];
return new SPFieldUserValue(web, group.ID, group.Name);
}
}
//
};

, , xml , , SPListItem .

. . , - .

private SPFieldMultiChoiceValue MultiChoiceConverter(SPWeb web, string value)
{
SPFieldMultiChoiceValue fValue = new SPFieldMultiChoiceValue();
foreach (string choice in value.Split(';')) fValue.Add(choice.Trim());
return fValue;
}

, . , .

:

, -, . , , xml , , .
.

SharePoint Channel